@sdk-it/spec 0.44.0 → 0.46.0

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

@@ -1 +1 @@
-{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/lib/pagination/pagination.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,EAAE,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAG5D,wBAAgB,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,cAAc,EAAE,oBAAoB,OAwB1E"}
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/lib/pagination/pagination.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,EAAE,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAG5D,wBAAgB,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,cAAc,EAAE,oBAAoB,OAgC1E"}

package/dist/lib/pagination/pagination.js

@@ -1,14 +1,15 @@
 import { followRef, isRef } from "@sdk-it/core/ref.js";
+import { isSuccessStatusCode } from "../is.js";
 import { guessPagination } from "./guess-pagination.js";
 function toPagination(spec, tunedOperation) {
   if (tunedOperation["x-pagination"]) {
     return tunedOperation["x-pagination"];
   }
-  const schema = getResponseContentSchema(
-    spec,
-    tunedOperation.responses["200"],
-    "application/json"
+  const successResponse = Object.entries(tunedOperation.responses).find(
+    ([status]) => isSuccessStatusCode(status) && Number.isInteger(Number(status))
   );
+  const statusCode = successResponse ? Number(successResponse[0]) : void 0;
+  const schema = successResponse ? getResponseContentSchema(spec, successResponse[1], "application/json") : void 0;
   const pagination = guessPagination(
     tunedOperation,
     tunedOperation.requestBody ? getRequestContentSchema(
@@ -18,8 +19,8 @@ function toPagination(spec, tunedOperation) {
     ) : void 0,
     schema
   );
-  if (pagination && pagination.type !== "none" && schema) {
-    return { ...pagination, statusCode: 200 };
+  if (pagination && pagination.type !== "none" && schema && statusCode !== void 0) {
+    return { ...pagination, statusCode };
   }
   return void 0;
 }

package/dist/lib/pagination/pagination.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/pagination/pagination.ts"],
-  "sourcesContent": ["import type {\n  RequestBodyObject,\n  ResponseObject,\n  SchemaObject,\n} from 'openapi3-ts/oas31';\n\nimport { followRef, isRef } from '@sdk-it/core/ref.js';\n\nimport type { IR, TunedOperationObject } from '../types.js';\nimport { guessPagination } from './guess-pagination.js';\n\nexport function toPagination(spec: IR, tunedOperation: TunedOperationObject) {\n  if (tunedOperation['x-pagination']) {\n    return tunedOperation['x-pagination'];\n  }\n  const schema = getResponseContentSchema(\n    spec,\n    tunedOperation.responses['200'],\n    'application/json',\n  );\n  const pagination = guessPagination(\n    tunedOperation,\n    tunedOperation.requestBody\n      ? getRequestContentSchema(\n          spec,\n          tunedOperation.requestBody,\n          'application/json',\n        )\n      : undefined,\n    schema,\n  );\n  if (pagination && pagination.type !== 'none' && schema) {\n    return { ...pagination, statusCode: 200 };\n  }\n  return undefined;\n}\n\nfunction getResponseContentSchema(\n  spec: IR,\n  response: ResponseObject,\n  type: string,\n) {\n  if (!response) {\n    return undefined;\n  }\n  const content = response.content;\n  if (!content) {\n    return undefined;\n  }\n  for (const contentType in content) {\n    if (contentType.toLowerCase() === type.toLowerCase()) {\n      return isRef(content[contentType].schema)\n        ? followRef<SchemaObject>(spec, content[contentType].schema.$ref)\n        : content[contentType].schema;\n    }\n  }\n  return undefined;\n}\n\nfunction getRequestContentSchema(\n  spec: IR,\n  requestBody: RequestBodyObject,\n  type: string,\n) {\n  const content = requestBody.content;\n  if (!content) {\n    return undefined;\n  }\n  for (const contentType in content) {\n    if (contentType.toLowerCase() === type.toLowerCase()) {\n      return isRef(content[contentType].schema)\n        ? followRef<SchemaObject>(spec, content[contentType].schema.$ref)\n        : content[contentType].schema;\n    }\n  }\n  return undefined;\n}\n"],
-  "mappings": "AAMA,SAAS,WAAW,aAAa;AAGjC,SAAS,uBAAuB;AAEzB,SAAS,aAAa,MAAU,gBAAsC;AAC3E,MAAI,eAAe,cAAc,GAAG;AAClC,WAAO,eAAe,cAAc;AAAA,EACtC;AACA,QAAM,SAAS;AAAA,IACb;AAAA,IACA,eAAe,UAAU,KAAK;AAAA,IAC9B;AAAA,EACF;AACA,QAAM,aAAa;AAAA,IACjB;AAAA,IACA,eAAe,cACX;AAAA,MACE;AAAA,MACA,eAAe;AAAA,MACf;AAAA,IACF,IACA;AAAA,IACJ;AAAA,EACF;AACA,MAAI,cAAc,WAAW,SAAS,UAAU,QAAQ;AACtD,WAAO,EAAE,GAAG,YAAY,YAAY,IAAI;AAAA,EAC1C;AACA,SAAO;AACT;AAEA,SAAS,yBACP,MACA,UACA,MACA;AACA,MAAI,CAAC,UAAU;AACb,WAAO;AAAA,EACT;AACA,QAAM,UAAU,SAAS;AACzB,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AACA,aAAW,eAAe,SAAS;AACjC,QAAI,YAAY,YAAY,MAAM,KAAK,YAAY,GAAG;AACpD,aAAO,MAAM,QAAQ,WAAW,EAAE,MAAM,IACpC,UAAwB,MAAM,QAAQ,WAAW,EAAE,OAAO,IAAI,IAC9D,QAAQ,WAAW,EAAE;AAAA,IAC3B;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,wBACP,MACA,aACA,MACA;AACA,QAAM,UAAU,YAAY;AAC5B,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AACA,aAAW,eAAe,SAAS;AACjC,QAAI,YAAY,YAAY,MAAM,KAAK,YAAY,GAAG;AACpD,aAAO,MAAM,QAAQ,WAAW,EAAE,MAAM,IACpC,UAAwB,MAAM,QAAQ,WAAW,EAAE,OAAO,IAAI,IAC9D,QAAQ,WAAW,EAAE;AAAA,IAC3B;AAAA,EACF;AACA,SAAO;AACT;",
+  "sourcesContent": ["import type {\n  RequestBodyObject,\n  ResponseObject,\n  SchemaObject,\n} from 'openapi3-ts/oas31';\n\nimport { followRef, isRef } from '@sdk-it/core/ref.js';\n\nimport { isSuccessStatusCode } from '../is.js';\nimport type { IR, TunedOperationObject } from '../types.js';\nimport { guessPagination } from './guess-pagination.js';\n\nexport function toPagination(spec: IR, tunedOperation: TunedOperationObject) {\n  if (tunedOperation['x-pagination']) {\n    return tunedOperation['x-pagination'];\n  }\n  const successResponse = Object.entries(tunedOperation.responses).find(\n    ([status]) =>\n      isSuccessStatusCode(status) && Number.isInteger(Number(status)),\n  );\n  const statusCode = successResponse ? Number(successResponse[0]) : undefined;\n  const schema = successResponse\n    ? getResponseContentSchema(spec, successResponse[1], 'application/json')\n    : undefined;\n  const pagination = guessPagination(\n    tunedOperation,\n    tunedOperation.requestBody\n      ? getRequestContentSchema(\n          spec,\n          tunedOperation.requestBody,\n          'application/json',\n        )\n      : undefined,\n    schema,\n  );\n  if (\n    pagination &&\n    pagination.type !== 'none' &&\n    schema &&\n    statusCode !== undefined\n  ) {\n    return { ...pagination, statusCode };\n  }\n  return undefined;\n}\n\nfunction getResponseContentSchema(\n  spec: IR,\n  response: ResponseObject,\n  type: string,\n) {\n  if (!response) {\n    return undefined;\n  }\n  const content = response.content;\n  if (!content) {\n    return undefined;\n  }\n  for (const contentType in content) {\n    if (contentType.toLowerCase() === type.toLowerCase()) {\n      return isRef(content[contentType].schema)\n        ? followRef<SchemaObject>(spec, content[contentType].schema.$ref)\n        : content[contentType].schema;\n    }\n  }\n  return undefined;\n}\n\nfunction getRequestContentSchema(\n  spec: IR,\n  requestBody: RequestBodyObject,\n  type: string,\n) {\n  const content = requestBody.content;\n  if (!content) {\n    return undefined;\n  }\n  for (const contentType in content) {\n    if (contentType.toLowerCase() === type.toLowerCase()) {\n      return isRef(content[contentType].schema)\n        ? followRef<SchemaObject>(spec, content[contentType].schema.$ref)\n        : content[contentType].schema;\n    }\n  }\n  return undefined;\n}\n"],
+  "mappings": "AAMA,SAAS,WAAW,aAAa;AAEjC,SAAS,2BAA2B;AAEpC,SAAS,uBAAuB;AAEzB,SAAS,aAAa,MAAU,gBAAsC;AAC3E,MAAI,eAAe,cAAc,GAAG;AAClC,WAAO,eAAe,cAAc;AAAA,EACtC;AACA,QAAM,kBAAkB,OAAO,QAAQ,eAAe,SAAS,EAAE;AAAA,IAC/D,CAAC,CAAC,MAAM,MACN,oBAAoB,MAAM,KAAK,OAAO,UAAU,OAAO,MAAM,CAAC;AAAA,EAClE;AACA,QAAM,aAAa,kBAAkB,OAAO,gBAAgB,CAAC,CAAC,IAAI;AAClE,QAAM,SAAS,kBACX,yBAAyB,MAAM,gBAAgB,CAAC,GAAG,kBAAkB,IACrE;AACJ,QAAM,aAAa;AAAA,IACjB;AAAA,IACA,eAAe,cACX;AAAA,MACE;AAAA,MACA,eAAe;AAAA,MACf;AAAA,IACF,IACA;AAAA,IACJ;AAAA,EACF;AACA,MACE,cACA,WAAW,SAAS,UACpB,UACA,eAAe,QACf;AACA,WAAO,EAAE,GAAG,YAAY,WAAW;AAAA,EACrC;AACA,SAAO;AACT;AAEA,SAAS,yBACP,MACA,UACA,MACA;AACA,MAAI,CAAC,UAAU;AACb,WAAO;AAAA,EACT;AACA,QAAM,UAAU,SAAS;AACzB,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AACA,aAAW,eAAe,SAAS;AACjC,QAAI,YAAY,YAAY,MAAM,KAAK,YAAY,GAAG;AACpD,aAAO,MAAM,QAAQ,WAAW,EAAE,MAAM,IACpC,UAAwB,MAAM,QAAQ,WAAW,EAAE,OAAO,IAAI,IAC9D,QAAQ,WAAW,EAAE;AAAA,IAC3B;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,wBACP,MACA,aACA,MACA;AACA,QAAM,UAAU,YAAY;AAC5B,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AACA,aAAW,eAAe,SAAS;AACjC,QAAI,YAAY,YAAY,MAAM,KAAK,YAAY,GAAG;AACpD,aAAO,MAAM,QAAQ,WAAW,EAAE,MAAM,IACpC,UAAwB,MAAM,QAAQ,WAAW,EAAE,OAAO,IAAI,IAC9D,QAAQ,WAAW,EAAE;AAAA,IAC3B;AAAA,EACF;AACA,SAAO;AACT;",
   "names": []
 }

package/dist/lib/processing-plugins/canonicalize-spec.d.ts

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

package/dist/lib/processing-plugins/canonicalize-spec.d.ts.map

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

package/dist/lib/processing-plugins/canonicalize-spec.js

@@ -0,0 +1,29 @@
+import { walkSchemas } from "../walk-schemas.js";
+function sortRecord(record) {
+  return Object.fromEntries(
+    Object.entries(record).sort(
+      ([left], [right]) => left < right ? -1 : left > right ? 1 : 0
+    )
+  );
+}
+function canonicalizeSpec() {
+  return {
+    name: "canonicalize-spec",
+    process({ spec }) {
+      spec.components.schemas = sortRecord(spec.components.schemas);
+      for (const { schema } of walkSchemas(spec)) {
+        if (schema.properties) {
+          schema.properties = sortRecord(schema.properties);
+        }
+        const extraProperties = schema["x-properties"];
+        if (extraProperties) {
+          schema["x-properties"] = sortRecord(extraProperties);
+        }
+      }
+    }
+  };
+}
+export {
+  canonicalizeSpec
+};
+//# sourceMappingURL=canonicalize-spec.js.map

package/dist/lib/processing-plugins/canonicalize-spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/processing-plugins/canonicalize-spec.ts"],
+  "sourcesContent": ["import type { SchemaObject } from 'openapi3-ts/oas31';\n\nimport type { ProcessingPlugin } from '../processing.js';\nimport { walkSchemas } from '../walk-schemas.js';\n\nfunction sortRecord<T>(record: Record<string, T>): Record<string, T> {\n  return Object.fromEntries(\n    Object.entries(record).sort(([left], [right]) =>\n      left < right ? -1 : left > right ? 1 : 0,\n    ),\n  );\n}\n\nexport function canonicalizeSpec(): ProcessingPlugin {\n  return {\n    name: 'canonicalize-spec',\n    process({ spec }) {\n      spec.components.schemas = sortRecord(spec.components.schemas);\n      for (const { schema } of walkSchemas(spec)) {\n        if (schema.properties) {\n          schema.properties = sortRecord(schema.properties);\n        }\n        const extraProperties = schema['x-properties'] as\n          Record<string, SchemaObject> | undefined;\n        if (extraProperties) {\n          schema['x-properties'] = sortRecord(extraProperties);\n        }\n      }\n    },\n  };\n}\n"],
+  "mappings": "AAGA,SAAS,mBAAmB;AAE5B,SAAS,WAAc,QAA8C;AACnE,SAAO,OAAO;AAAA,IACZ,OAAO,QAAQ,MAAM,EAAE;AAAA,MAAK,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,MACzC,OAAO,QAAQ,KAAK,OAAO,QAAQ,IAAI;AAAA,IACzC;AAAA,EACF;AACF;AAEO,SAAS,mBAAqC;AACnD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,EAAE,KAAK,GAAG;AAChB,WAAK,WAAW,UAAU,WAAW,KAAK,WAAW,OAAO;AAC5D,iBAAW,EAAE,OAAO,KAAK,YAAY,IAAI,GAAG;AAC1C,YAAI,OAAO,YAAY;AACrB,iBAAO,aAAa,WAAW,OAAO,UAAU;AAAA,QAClD;AACA,cAAM,kBAAkB,OAAO,cAAc;AAE7C,YAAI,iBAAiB;AACnB,iBAAO,cAAc,IAAI,WAAW,eAAe;AAAA,QACrD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/processing-plugins/create-default-processing-plugins.d.ts

@@ -0,0 +1,5 @@
+import type { ProcessingPlugin } from '../processing.js';
+export declare function createDefaultProcessingPlugins(options?: {
+    verbose?: boolean;
+}): ProcessingPlugin[];
+//# sourceMappingURL=create-default-processing-plugins.d.ts.map

package/dist/lib/processing-plugins/create-default-processing-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-default-processing-plugins.d.ts","sourceRoot":"","sources":["../../../src/lib/processing-plugins/create-default-processing-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAazD,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,gBAAgB,EAAE,CAcpB"}

package/dist/lib/processing-plugins/create-default-processing-plugins.js

@@ -0,0 +1,30 @@
+import { canonicalizeSpec } from "./canonicalize-spec.js";
+import { extractInlineSchemas } from "./extract-inline-schemas.js";
+import { extractOverviewDocsPlugin } from "./extract-overview-docs.js";
+import { inferPagination } from "./infer-pagination.js";
+import { normalizeOperationIds } from "./normalize-operation-ids.js";
+import { normalizeParameters } from "./normalize-parameters.js";
+import { normalizePaths } from "./normalize-paths.js";
+import { normalizeRequestBodies } from "./normalize-request-bodies.js";
+import { normalizeResponses } from "./normalize-responses.js";
+import { normalizeSchemas } from "./normalize-schemas.js";
+import { normalizeTags } from "./normalize-tags.js";
+function createDefaultProcessingPlugins(options = {}) {
+  return [
+    normalizePaths(),
+    normalizeOperationIds(),
+    normalizeTags(),
+    normalizeParameters(),
+    normalizeResponses(),
+    normalizeRequestBodies(),
+    inferPagination(),
+    normalizeSchemas(),
+    ...options.verbose ? [extractInlineSchemas()] : [],
+    extractOverviewDocsPlugin(),
+    canonicalizeSpec()
+  ];
+}
+export {
+  createDefaultProcessingPlugins
+};
+//# sourceMappingURL=create-default-processing-plugins.js.map

package/dist/lib/processing-plugins/create-default-processing-plugins.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/processing-plugins/create-default-processing-plugins.ts"],
+  "sourcesContent": ["import type { ProcessingPlugin } from '../processing.js';\nimport { canonicalizeSpec } from './canonicalize-spec.js';\nimport { extractInlineSchemas } from './extract-inline-schemas.js';\nimport { extractOverviewDocsPlugin } from './extract-overview-docs.js';\nimport { inferPagination } from './infer-pagination.js';\nimport { normalizeOperationIds } from './normalize-operation-ids.js';\nimport { normalizeParameters } from './normalize-parameters.js';\nimport { normalizePaths } from './normalize-paths.js';\nimport { normalizeRequestBodies } from './normalize-request-bodies.js';\nimport { normalizeResponses } from './normalize-responses.js';\nimport { normalizeSchemas } from './normalize-schemas.js';\nimport { normalizeTags } from './normalize-tags.js';\n\nexport function createDefaultProcessingPlugins(\n  options: { verbose?: boolean } = {},\n): ProcessingPlugin[] {\n  return [\n    normalizePaths(),\n    normalizeOperationIds(),\n    normalizeTags(),\n    normalizeParameters(),\n    normalizeResponses(),\n    normalizeRequestBodies(),\n    inferPagination(),\n    normalizeSchemas(),\n    ...(options.verbose ? [extractInlineSchemas()] : []),\n    extractOverviewDocsPlugin(),\n    canonicalizeSpec(),\n  ];\n}\n"],
+  "mappings": "AACA,SAAS,wBAAwB;AACjC,SAAS,4BAA4B;AACrC,SAAS,iCAAiC;AAC1C,SAAS,uBAAuB;AAChC,SAAS,6BAA6B;AACtC,SAAS,2BAA2B;AACpC,SAAS,sBAAsB;AAC/B,SAAS,8BAA8B;AACvC,SAAS,0BAA0B;AACnC,SAAS,wBAAwB;AACjC,SAAS,qBAAqB;AAEvB,SAAS,+BACd,UAAiC,CAAC,GACd;AACpB,SAAO;AAAA,IACL,eAAe;AAAA,IACf,sBAAsB;AAAA,IACtB,cAAc;AAAA,IACd,oBAAoB;AAAA,IACpB,mBAAmB;AAAA,IACnB,uBAAuB;AAAA,IACvB,gBAAgB;AAAA,IAChB,iBAAiB;AAAA,IACjB,GAAI,QAAQ,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC;AAAA,IAClD,0BAA0B;AAAA,IAC1B,iBAAiB;AAAA,EACnB;AACF;",
+  "names": []
+}

package/dist/lib/processing-plugins/enrich-examples.d.ts

@@ -0,0 +1,25 @@
+import type { OperationObject, SchemaObject } from 'openapi3-ts/oas31';
+import type { ProcessingPlugin } from '../processing.js';
+import type { IR } from '../types.js';
+export interface ExampleEnrichmentInput {
+    spec: IR;
+    operation: OperationObject;
+    method: string;
+    path: string;
+    direction: 'request' | 'response';
+    mediaType: string;
+    schema: SchemaObject;
+    statusCode?: string;
+    signal?: AbortSignal;
+}
+export interface ExampleValidationInput extends ExampleEnrichmentInput {
+    value: unknown;
+}
+export interface ExampleEnrichmentOptions {
+    name?: string;
+    overwrite?: boolean;
+    generate(input: ExampleEnrichmentInput): unknown | Promise<unknown>;
+    validate(input: ExampleValidationInput): boolean | Promise<boolean>;
+}
+export declare function enrichExamples(options: ExampleEnrichmentOptions): ProcessingPlugin;
+//# sourceMappingURL=enrich-examples.d.ts.map

package/dist/lib/processing-plugins/enrich-examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich-examples.d.ts","sourceRoot":"","sources":["../../../src/lib/processing-plugins/enrich-examples.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,eAAe,EAGf,YAAY,EACb,MAAM,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAwB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,EAAE,CAAC;IACT,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,GAAG,UAAU,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,QAAQ,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE;AAgDD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,wBAAwB,GAChC,gBAAgB,CAyDlB"}

package/dist/lib/processing-plugins/enrich-examples.js

@@ -0,0 +1,93 @@
+import { resolveRef } from "@sdk-it/core/ref.js";
+import { iterateOperations } from "../for-each-operation.js";
+function hasAuthoredExample(media) {
+  return Object.prototype.hasOwnProperty.call(media, "example") || Object.keys(media.examples ?? {}).length > 0;
+}
+async function enrichMediaType(input, options, report) {
+  const { media, ...target } = input;
+  if (!media.schema || !options.overwrite && hasAuthoredExample(media)) {
+    return;
+  }
+  target.signal?.throwIfAborted();
+  const schema = resolveRef(target.spec, media.schema);
+  const enrichmentInput = { ...target, schema };
+  const value = await options.generate(enrichmentInput);
+  target.signal?.throwIfAborted();
+  if (!await options.validate({ ...enrichmentInput, value })) {
+    report({
+      severity: "warning",
+      code: "generated-example-invalid",
+      message: `Discarded an invalid generated ${target.direction} example`,
+      path: `${target.method.toUpperCase()} ${target.path}`
+    });
+    return;
+  }
+  media.example = value;
+  report({
+    severity: "info",
+    code: "example-generated",
+    message: `Generated a schema-valid ${target.direction} example`,
+    path: `${target.method.toUpperCase()} ${target.path}`
+  });
+}
+function enrichExamples(options) {
+  return {
+    name: options.name ?? "enrich-examples",
+    async process({ spec, report, signal }) {
+      for (const { entry, operation } of iterateOperations(spec)) {
+        if (operation.requestBody) {
+          const requestBody = resolveRef(
+            spec,
+            operation.requestBody
+          );
+          for (const [mediaType, media] of Object.entries(
+            requestBody.content
+          )) {
+            await enrichMediaType(
+              {
+                spec,
+                operation,
+                method: entry.method,
+                path: entry.path,
+                direction: "request",
+                mediaType,
+                media,
+                signal
+              },
+              options,
+              report
+            );
+          }
+        }
+        for (const [statusCode, responseOrRef] of Object.entries(
+          operation.responses ?? {}
+        )) {
+          const response = resolveRef(spec, responseOrRef);
+          for (const [mediaType, media] of Object.entries(
+            response.content ?? {}
+          )) {
+            await enrichMediaType(
+              {
+                spec,
+                operation,
+                method: entry.method,
+                path: entry.path,
+                direction: "response",
+                statusCode,
+                mediaType,
+                media,
+                signal
+              },
+              options,
+              report
+            );
+          }
+        }
+      }
+    }
+  };
+}
+export {
+  enrichExamples
+};
+//# sourceMappingURL=enrich-examples.js.map

package/dist/lib/processing-plugins/enrich-examples.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/processing-plugins/enrich-examples.ts"],
+  "sourcesContent": ["import type {\n  MediaTypeObject,\n  OperationObject,\n  RequestBodyObject,\n  ResponseObject,\n  SchemaObject,\n} from 'openapi3-ts/oas31';\n\nimport { resolveRef } from '@sdk-it/core/ref.js';\n\nimport { iterateOperations } from '../for-each-operation.js';\nimport type { ProcessingDiagnostic, ProcessingPlugin } from '../processing.js';\nimport type { IR } from '../types.js';\n\nexport interface ExampleEnrichmentInput {\n  spec: IR;\n  operation: OperationObject;\n  method: string;\n  path: string;\n  direction: 'request' | 'response';\n  mediaType: string;\n  schema: SchemaObject;\n  statusCode?: string;\n  signal?: AbortSignal;\n}\n\nexport interface ExampleValidationInput extends ExampleEnrichmentInput {\n  value: unknown;\n}\n\nexport interface ExampleEnrichmentOptions {\n  name?: string;\n  overwrite?: boolean;\n  generate(input: ExampleEnrichmentInput): unknown | Promise<unknown>;\n  validate(input: ExampleValidationInput): boolean | Promise<boolean>;\n}\n\nfunction hasAuthoredExample(media: MediaTypeObject): boolean {\n  return (\n    Object.prototype.hasOwnProperty.call(media, 'example') ||\n    Object.keys(media.examples ?? {}).length > 0\n  );\n}\n\nasync function enrichMediaType(\n  input: Omit<ExampleEnrichmentInput, 'schema'> & {\n    media: MediaTypeObject;\n  },\n  options: ExampleEnrichmentOptions,\n  report: (\n    diagnostic: Omit<ProcessingDiagnostic, 'plugin'>,\n  ) => ProcessingDiagnostic,\n) {\n  const { media, ...target } = input;\n  if (!media.schema || (!options.overwrite && hasAuthoredExample(media))) {\n    return;\n  }\n\n  target.signal?.throwIfAborted();\n  const schema = resolveRef<SchemaObject>(target.spec, media.schema);\n  const enrichmentInput = { ...target, schema };\n  const value = await options.generate(enrichmentInput);\n  target.signal?.throwIfAborted();\n\n  if (!(await options.validate({ ...enrichmentInput, value }))) {\n    report({\n      severity: 'warning',\n      code: 'generated-example-invalid',\n      message: `Discarded an invalid generated ${target.direction} example`,\n      path: `${target.method.toUpperCase()} ${target.path}`,\n    });\n    return;\n  }\n\n  media.example = value;\n  report({\n    severity: 'info',\n    code: 'example-generated',\n    message: `Generated a schema-valid ${target.direction} example`,\n    path: `${target.method.toUpperCase()} ${target.path}`,\n  });\n}\n\nexport function enrichExamples(\n  options: ExampleEnrichmentOptions,\n): ProcessingPlugin {\n  return {\n    name: options.name ?? 'enrich-examples',\n    async process({ spec, report, signal }) {\n      for (const { entry, operation } of iterateOperations(spec)) {\n        if (operation.requestBody) {\n          const requestBody = resolveRef<RequestBodyObject>(\n            spec,\n            operation.requestBody,\n          );\n          for (const [mediaType, media] of Object.entries(\n            requestBody.content,\n          )) {\n            await enrichMediaType(\n              {\n                spec,\n                operation,\n                method: entry.method,\n                path: entry.path,\n                direction: 'request',\n                mediaType,\n                media,\n                signal,\n              },\n              options,\n              report,\n            );\n          }\n        }\n\n        for (const [statusCode, responseOrRef] of Object.entries(\n          operation.responses ?? {},\n        )) {\n          const response = resolveRef<ResponseObject>(spec, responseOrRef);\n          for (const [mediaType, media] of Object.entries(\n            response.content ?? {},\n          )) {\n            await enrichMediaType(\n              {\n                spec,\n                operation,\n                method: entry.method,\n                path: entry.path,\n                direction: 'response',\n                statusCode,\n                mediaType,\n                media,\n                signal,\n              },\n              options,\n              report,\n            );\n          }\n        }\n      }\n    },\n  };\n}\n"],
+  "mappings": "AAQA,SAAS,kBAAkB;AAE3B,SAAS,yBAAyB;AA2BlC,SAAS,mBAAmB,OAAiC;AAC3D,SACE,OAAO,UAAU,eAAe,KAAK,OAAO,SAAS,KACrD,OAAO,KAAK,MAAM,YAAY,CAAC,CAAC,EAAE,SAAS;AAE/C;AAEA,eAAe,gBACb,OAGA,SACA,QAGA;AACA,QAAM,EAAE,OAAO,GAAG,OAAO,IAAI;AAC7B,MAAI,CAAC,MAAM,UAAW,CAAC,QAAQ,aAAa,mBAAmB,KAAK,GAAI;AACtE;AAAA,EACF;AAEA,SAAO,QAAQ,eAAe;AAC9B,QAAM,SAAS,WAAyB,OAAO,MAAM,MAAM,MAAM;AACjE,QAAM,kBAAkB,EAAE,GAAG,QAAQ,OAAO;AAC5C,QAAM,QAAQ,MAAM,QAAQ,SAAS,eAAe;AACpD,SAAO,QAAQ,eAAe;AAE9B,MAAI,CAAE,MAAM,QAAQ,SAAS,EAAE,GAAG,iBAAiB,MAAM,CAAC,GAAI;AAC5D,WAAO;AAAA,MACL,UAAU;AAAA,MACV,MAAM;AAAA,MACN,SAAS,kCAAkC,OAAO,SAAS;AAAA,MAC3D,MAAM,GAAG,OAAO,OAAO,YAAY,CAAC,IAAI,OAAO,IAAI;AAAA,IACrD,CAAC;AACD;AAAA,EACF;AAEA,QAAM,UAAU;AAChB,SAAO;AAAA,IACL,UAAU;AAAA,IACV,MAAM;AAAA,IACN,SAAS,4BAA4B,OAAO,SAAS;AAAA,IACrD,MAAM,GAAG,OAAO,OAAO,YAAY,CAAC,IAAI,OAAO,IAAI;AAAA,EACrD,CAAC;AACH;AAEO,SAAS,eACd,SACkB;AAClB,SAAO;AAAA,IACL,MAAM,QAAQ,QAAQ;AAAA,IACtB,MAAM,QAAQ,EAAE,MAAM,QAAQ,OAAO,GAAG;AACtC,iBAAW,EAAE,OAAO,UAAU,KAAK,kBAAkB,IAAI,GAAG;AAC1D,YAAI,UAAU,aAAa;AACzB,gBAAM,cAAc;AAAA,YAClB;AAAA,YACA,UAAU;AAAA,UACZ;AACA,qBAAW,CAAC,WAAW,KAAK,KAAK,OAAO;AAAA,YACtC,YAAY;AAAA,UACd,GAAG;AACD,kBAAM;AAAA,cACJ;AAAA,gBACE;AAAA,gBACA;AAAA,gBACA,QAAQ,MAAM;AAAA,gBACd,MAAM,MAAM;AAAA,gBACZ,WAAW;AAAA,gBACX;AAAA,gBACA;AAAA,gBACA;AAAA,cACF;AAAA,cACA;AAAA,cACA;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAEA,mBAAW,CAAC,YAAY,aAAa,KAAK,OAAO;AAAA,UAC/C,UAAU,aAAa,CAAC;AAAA,QAC1B,GAAG;AACD,gBAAM,WAAW,WAA2B,MAAM,aAAa;AAC/D,qBAAW,CAAC,WAAW,KAAK,KAAK,OAAO;AAAA,YACtC,SAAS,WAAW,CAAC;AAAA,UACvB,GAAG;AACD,kBAAM;AAAA,cACJ;AAAA,gBACE;AAAA,gBACA;AAAA,gBACA,QAAQ,MAAM;AAAA,gBACd,MAAM,MAAM;AAAA,gBACZ,WAAW;AAAA,gBACX;AAAA,gBACA;AAAA,gBACA;AAAA,gBACA;AAAA,cACF;AAAA,cACA;AAAA,cACA;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/processing-plugins/extract-inline-schemas.d.ts

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

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

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

package/dist/lib/processing-plugins/extract-inline-schemas.js

@@ -0,0 +1,14 @@
+import { expandSpec } from "../tune.js";
+function extractInlineSchemas() {
+  return {
+    name: "extract-inline-schemas",
+    process({ spec }) {
+      const refs = [];
+      expandSpec(spec, spec.components.schemas, refs);
+    }
+  };
+}
+export {
+  extractInlineSchemas
+};
+//# sourceMappingURL=extract-inline-schemas.js.map

package/dist/lib/processing-plugins/extract-inline-schemas.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/processing-plugins/extract-inline-schemas.ts"],
+  "sourcesContent": ["import type { SchemaObject } from 'openapi3-ts/oas31';\n\nimport type { ProcessingPlugin } from '../processing.js';\nimport { expandSpec } from '../tune.js';\n\nexport function extractInlineSchemas(): ProcessingPlugin {\n  return {\n    name: 'extract-inline-schemas',\n    process({ spec }) {\n      const refs: { name: string; value: SchemaObject }[] = [];\n      expandSpec(spec, spec.components.schemas, refs);\n    },\n  };\n}\n"],
+  "mappings": "AAGA,SAAS,kBAAkB;AAEpB,SAAS,uBAAyC;AACvD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,EAAE,KAAK,GAAG;AAChB,YAAM,OAAgD,CAAC;AACvD,iBAAW,MAAM,KAAK,WAAW,SAAS,IAAI;AAAA,IAChD;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/processing-plugins/extract-overview-docs.d.ts

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

package/dist/lib/processing-plugins/extract-overview-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-overview-docs.d.ts","sourceRoot":"","sources":["../../../src/lib/processing-plugins/extract-overview-docs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,wBAAgB,yBAAyB,IAAI,gBAAgB,CAO5D"}

package/dist/lib/processing-plugins/extract-overview-docs.js

@@ -0,0 +1,13 @@
+import { extractOverviewDocs } from "../overview-docs/overview-docs.js";
+function extractOverviewDocsPlugin() {
+  return {
+    name: "extract-overview-docs",
+    process({ spec }) {
+      spec["x-docs"] = extractOverviewDocs(spec);
+    }
+  };
+}
+export {
+  extractOverviewDocsPlugin
+};
+//# sourceMappingURL=extract-overview-docs.js.map

package/dist/lib/processing-plugins/extract-overview-docs.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/processing-plugins/extract-overview-docs.ts"],
+  "sourcesContent": ["import { extractOverviewDocs } from '../overview-docs/overview-docs.js';\nimport type { ProcessingPlugin } from '../processing.js';\n\nexport function extractOverviewDocsPlugin(): ProcessingPlugin {\n  return {\n    name: 'extract-overview-docs',\n    process({ spec }) {\n      spec['x-docs'] = extractOverviewDocs(spec);\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,2BAA2B;AAG7B,SAAS,4BAA8C;AAC5D,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,EAAE,KAAK,GAAG;AAChB,WAAK,QAAQ,IAAI,oBAAoB,IAAI;AAAA,IAC3C;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/processing-plugins/index.d.ts

@@ -0,0 +1,14 @@
+export * from './canonicalize-spec.js';
+export * from './create-default-processing-plugins.js';
+export * from './enrich-examples.js';
+export * from './extract-inline-schemas.js';
+export * from './extract-overview-docs.js';
+export * from './infer-pagination.js';
+export * from './normalize-operation-ids.js';
+export * from './normalize-parameters.js';
+export * from './normalize-paths.js';
+export * from './normalize-request-bodies.js';
+export * from './normalize-responses.js';
+export * from './normalize-schemas.js';
+export * from './normalize-tags.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/processing-plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/processing-plugins/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wCAAwC,CAAC;AACvD,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC"}

package/dist/lib/processing-plugins/index.js

@@ -0,0 +1,14 @@
+export * from "./canonicalize-spec.js";
+export * from "./create-default-processing-plugins.js";
+export * from "./enrich-examples.js";
+export * from "./extract-inline-schemas.js";
+export * from "./extract-overview-docs.js";
+export * from "./infer-pagination.js";
+export * from "./normalize-operation-ids.js";
+export * from "./normalize-parameters.js";
+export * from "./normalize-paths.js";
+export * from "./normalize-request-bodies.js";
+export * from "./normalize-responses.js";
+export * from "./normalize-schemas.js";
+export * from "./normalize-tags.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/processing-plugins/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/processing-plugins/index.ts"],
+  "sourcesContent": ["export * from './canonicalize-spec.js';\nexport * from './create-default-processing-plugins.js';\nexport * from './enrich-examples.js';\nexport * from './extract-inline-schemas.js';\nexport * from './extract-overview-docs.js';\nexport * from './infer-pagination.js';\nexport * from './normalize-operation-ids.js';\nexport * from './normalize-parameters.js';\nexport * from './normalize-paths.js';\nexport * from './normalize-request-bodies.js';\nexport * from './normalize-responses.js';\nexport * from './normalize-schemas.js';\nexport * from './normalize-tags.js';\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/lib/processing-plugins/infer-pagination.d.ts

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

package/dist/lib/processing-plugins/infer-pagination.d.ts.map

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

package/dist/lib/processing-plugins/infer-pagination.js

@@ -0,0 +1,21 @@
+import { iterateOperations } from "../for-each-operation.js";
+import { toPagination } from "../pagination/pagination.js";
+function inferPagination() {
+  return {
+    name: "infer-pagination",
+    process({ spec, options }) {
+      for (const { operation } of iterateOperations(spec)) {
+        const tunedOperation = operation;
+        if (options.pagination.enabled && options.pagination.guess) {
+          tunedOperation["x-pagination"] = toPagination(spec, tunedOperation);
+        } else {
+          delete tunedOperation["x-pagination"];
+        }
+      }
+    }
+  };
+}
+export {
+  inferPagination
+};
+//# sourceMappingURL=infer-pagination.js.map

package/dist/lib/processing-plugins/infer-pagination.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/processing-plugins/infer-pagination.ts"],
+  "sourcesContent": ["import { iterateOperations } from '../for-each-operation.js';\nimport { toPagination } from '../pagination/pagination.js';\nimport type { ProcessingPlugin } from '../processing.js';\nimport type { TunedOperationObject } from '../types.js';\n\nexport function inferPagination(): ProcessingPlugin {\n  return {\n    name: 'infer-pagination',\n    process({ spec, options }) {\n      for (const { operation } of iterateOperations(spec)) {\n        const tunedOperation = operation as TunedOperationObject;\n        if (options.pagination.enabled && options.pagination.guess) {\n          tunedOperation['x-pagination'] = toPagination(spec, tunedOperation);\n        } else {\n          delete tunedOperation['x-pagination'];\n        }\n      }\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,yBAAyB;AAClC,SAAS,oBAAoB;AAItB,SAAS,kBAAoC;AAClD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,EAAE,MAAM,QAAQ,GAAG;AACzB,iBAAW,EAAE,UAAU,KAAK,kBAAkB,IAAI,GAAG;AACnD,cAAM,iBAAiB;AACvB,YAAI,QAAQ,WAAW,WAAW,QAAQ,WAAW,OAAO;AAC1D,yBAAe,cAAc,IAAI,aAAa,MAAM,cAAc;AAAA,QACpE,OAAO;AACL,iBAAO,eAAe,cAAc;AAAA,QACtC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/processing-plugins/normalize-operation-ids.d.ts

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

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

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

package/dist/lib/processing-plugins/normalize-operation-ids.js

@@ -0,0 +1,74 @@
+import { iterateOperations } from "../for-each-operation.js";
+import { toResource } from "../guess/guess-resource.js";
+function findUniqueOperationId(usedOperationIds, initialId, choices, formatter) {
+  let counter = 1;
+  let uniqueOperationId = formatter(initialId);
+  while (usedOperationIds.has(uniqueOperationId)) {
+    const prependIndex = Math.min(counter - 1, choices.length - 1);
+    const prefix = choices[prependIndex];
+    uniqueOperationId = formatter(
+      prependIndex < choices.length - 1 ? `${prefix}${initialId.charAt(0).toUpperCase() + initialId.slice(1)}` : `${prefix}${initialId.charAt(0).toUpperCase() + initialId.slice(1)}${counter - choices.length + 1}`
+    );
+    counter++;
+  }
+  return uniqueOperationId;
+}
+function normalizeOperationIdentifier(value) {
+  const normalized = value.trim().replace(/[^A-Za-z0-9]+/g, " ").replace(
+    /(?:^|\s+)([A-Za-z0-9])/g,
+    (_, character) => character.toUpperCase()
+  ).replace(/^([A-Z])/, (character) => character.toLowerCase());
+  if (!normalized) {
+    return "operation";
+  }
+  if (/^[A-Za-z]/.test(normalized)) {
+    return normalized;
+  }
+  return `operation${normalized.charAt(0).toUpperCase()}${normalized.slice(1)}`;
+}
+function normalizeOperationIds() {
+  return {
+    name: "normalize-operation-ids",
+    process({ spec, options, report }) {
+      const usedOperationIds = /* @__PURE__ */ new Set();
+      for (const { entry, operation } of iterateOperations(spec)) {
+        const originalOperationId = operation.operationId;
+        const { name } = toResource(operation, entry.path, entry.method);
+        const operationTag = options.tag(operation, entry.path);
+        const operationId = findUniqueOperationId(
+          usedOperationIds,
+          normalizeOperationIdentifier(
+            options.operationId(operation, entry.path, entry.method)
+          ),
+          [
+            operationTag,
+            entry.method,
+            entry.path.split("/").filter(Boolean).join("")
+          ],
+          (candidate) => normalizeOperationIdentifier(
+            options.operationId(
+              { ...operation, operationId: candidate },
+              entry.path,
+              entry.method
+            )
+          )
+        );
+        usedOperationIds.add(operationId);
+        operation.operationId = operationId;
+        operation["x-fn-name"] = name;
+        if (operationId !== originalOperationId) {
+          report({
+            severity: "info",
+            code: "operation-id-normalized",
+            message: `Normalized operation ID ${originalOperationId ?? "<missing>"} to ${operationId}`,
+            path: `${entry.method.toUpperCase()} ${entry.path}`
+          });
+        }
+      }
+    }
+  };
+}
+export {
+  normalizeOperationIds
+};
+//# sourceMappingURL=normalize-operation-ids.js.map

package/dist/lib/processing-plugins/normalize-operation-ids.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/processing-plugins/normalize-operation-ids.ts"],
+  "sourcesContent": ["import { iterateOperations } from '../for-each-operation.js';\nimport { toResource } from '../guess/guess-resource.js';\nimport type { ProcessingPlugin } from '../processing.js';\n\nfunction findUniqueOperationId(\n  usedOperationIds: Set<string>,\n  initialId: string,\n  choices: string[],\n  formatter: (id: string) => string,\n) {\n  let counter = 1;\n  let uniqueOperationId = formatter(initialId);\n\n  while (usedOperationIds.has(uniqueOperationId)) {\n    const prependIndex = Math.min(counter - 1, choices.length - 1);\n    const prefix = choices[prependIndex];\n    uniqueOperationId = formatter(\n      prependIndex < choices.length - 1\n        ? `${prefix}${initialId.charAt(0).toUpperCase() + initialId.slice(1)}`\n        : `${prefix}${initialId.charAt(0).toUpperCase() + initialId.slice(1)}${counter - choices.length + 1}`,\n    );\n    counter++;\n  }\n\n  return uniqueOperationId;\n}\n\nfunction normalizeOperationIdentifier(value: string): string {\n  const normalized = value\n    .trim()\n    .replace(/[^A-Za-z0-9]+/g, ' ')\n    .replace(/(?:^|\\s+)([A-Za-z0-9])/g, (_, character: string) =>\n      character.toUpperCase(),\n    )\n    .replace(/^([A-Z])/, (character) => character.toLowerCase());\n\n  if (!normalized) {\n    return 'operation';\n  }\n  if (/^[A-Za-z]/.test(normalized)) {\n    return normalized;\n  }\n  return `operation${normalized.charAt(0).toUpperCase()}${normalized.slice(1)}`;\n}\n\nexport function normalizeOperationIds(): ProcessingPlugin {\n  return {\n    name: 'normalize-operation-ids',\n    process({ spec, options, report }) {\n      const usedOperationIds = new Set<string>();\n      for (const { entry, operation } of iterateOperations(spec)) {\n        const originalOperationId = operation.operationId;\n        const { name } = toResource(operation, entry.path, entry.method);\n        const operationTag = options.tag(operation, entry.path);\n        const operationId = findUniqueOperationId(\n          usedOperationIds,\n          normalizeOperationIdentifier(\n            options.operationId(operation, entry.path, entry.method),\n          ),\n          [\n            operationTag,\n            entry.method,\n            entry.path.split('/').filter(Boolean).join(''),\n          ],\n          (candidate) =>\n            normalizeOperationIdentifier(\n              options.operationId(\n                { ...operation, operationId: candidate },\n                entry.path,\n                entry.method,\n              ),\n            ),\n        );\n        usedOperationIds.add(operationId);\n        operation.operationId = operationId;\n        operation['x-fn-name'] = name;\n        if (operationId !== originalOperationId) {\n          report({\n            severity: 'info',\n            code: 'operation-id-normalized',\n            message: `Normalized operation ID ${originalOperationId ?? '<missing>'} to ${operationId}`,\n            path: `${entry.method.toUpperCase()} ${entry.path}`,\n          });\n        }\n      }\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,yBAAyB;AAClC,SAAS,kBAAkB;AAG3B,SAAS,sBACP,kBACA,WACA,SACA,WACA;AACA,MAAI,UAAU;AACd,MAAI,oBAAoB,UAAU,SAAS;AAE3C,SAAO,iBAAiB,IAAI,iBAAiB,GAAG;AAC9C,UAAM,eAAe,KAAK,IAAI,UAAU,GAAG,QAAQ,SAAS,CAAC;AAC7D,UAAM,SAAS,QAAQ,YAAY;AACnC,wBAAoB;AAAA,MAClB,eAAe,QAAQ,SAAS,IAC5B,GAAG,MAAM,GAAG,UAAU,OAAO,CAAC,EAAE,YAAY,IAAI,UAAU,MAAM,CAAC,CAAC,KAClE,GAAG,MAAM,GAAG,UAAU,OAAO,CAAC,EAAE,YAAY,IAAI,UAAU,MAAM,CAAC,CAAC,GAAG,UAAU,QAAQ,SAAS,CAAC;AAAA,IACvG;AACA;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,6BAA6B,OAAuB;AAC3D,QAAM,aAAa,MAChB,KAAK,EACL,QAAQ,kBAAkB,GAAG,EAC7B;AAAA,IAAQ;AAAA,IAA2B,CAAC,GAAG,cACtC,UAAU,YAAY;AAAA,EACxB,EACC,QAAQ,YAAY,CAAC,cAAc,UAAU,YAAY,CAAC;AAE7D,MAAI,CAAC,YAAY;AACf,WAAO;AAAA,EACT;AACA,MAAI,YAAY,KAAK,UAAU,GAAG;AAChC,WAAO;AAAA,EACT;AACA,SAAO,YAAY,WAAW,OAAO,CAAC,EAAE,YAAY,CAAC,GAAG,WAAW,MAAM,CAAC,CAAC;AAC7E;AAEO,SAAS,wBAA0C;AACxD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,EAAE,MAAM,SAAS,OAAO,GAAG;AACjC,YAAM,mBAAmB,oBAAI,IAAY;AACzC,iBAAW,EAAE,OAAO,UAAU,KAAK,kBAAkB,IAAI,GAAG;AAC1D,cAAM,sBAAsB,UAAU;AACtC,cAAM,EAAE,KAAK,IAAI,WAAW,WAAW,MAAM,MAAM,MAAM,MAAM;AAC/D,cAAM,eAAe,QAAQ,IAAI,WAAW,MAAM,IAAI;AACtD,cAAM,cAAc;AAAA,UAClB;AAAA,UACA;AAAA,YACE,QAAQ,YAAY,WAAW,MAAM,MAAM,MAAM,MAAM;AAAA,UACzD;AAAA,UACA;AAAA,YACE;AAAA,YACA,MAAM;AAAA,YACN,MAAM,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO,EAAE,KAAK,EAAE;AAAA,UAC/C;AAAA,UACA,CAAC,cACC;AAAA,YACE,QAAQ;AAAA,cACN,EAAE,GAAG,WAAW,aAAa,UAAU;AAAA,cACvC,MAAM;AAAA,cACN,MAAM;AAAA,YACR;AAAA,UACF;AAAA,QACJ;AACA,yBAAiB,IAAI,WAAW;AAChC,kBAAU,cAAc;AACxB,kBAAU,WAAW,IAAI;AACzB,YAAI,gBAAgB,qBAAqB;AACvC,iBAAO;AAAA,YACL,UAAU;AAAA,YACV,MAAM;AAAA,YACN,SAAS,2BAA2B,uBAAuB,WAAW,OAAO,WAAW;AAAA,YACxF,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-parameters.d.ts

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

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

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

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

@@ -0,0 +1,29 @@
+import { resolveRef } from "@sdk-it/core/ref.js";
+import { iterateOperations } from "../for-each-operation.js";
+function normalizeParameters() {
+  return {
+    name: "normalize-parameters",
+    process({ spec }) {
+      const pathItems = /* @__PURE__ */ new Set();
+      for (const { operation, pathItem } of iterateOperations(spec)) {
+        pathItems.add(pathItem);
+        const parameters = /* @__PURE__ */ new Map();
+        for (const parameterOrRef of [
+          ...pathItem.parameters ?? [],
+          ...operation.parameters ?? []
+        ]) {
+          const parameter = resolveRef(spec, parameterOrRef);
+          parameters.set(`${parameter.in}:${parameter.name}`, parameter);
+        }
+        operation.parameters = [...parameters.values()];
+      }
+      for (const pathItem of pathItems) {
+        delete pathItem.parameters;
+      }
+    }
+  };
+}
+export {
+  normalizeParameters
+};
+//# sourceMappingURL=normalize-parameters.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/processing-plugins/normalize-parameters.ts"],
+  "sourcesContent": ["import type { ParameterObject, PathItemObject } 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';\n\nexport function normalizeParameters(): ProcessingPlugin {\n  return {\n    name: 'normalize-parameters',\n    process({ spec }) {\n      const pathItems = new Set<PathItemObject>();\n      for (const { operation, pathItem } of iterateOperations(spec)) {\n        pathItems.add(pathItem);\n        const parameters = new Map<string, ParameterObject>();\n        for (const parameterOrRef of [\n          ...(pathItem.parameters ?? []),\n          ...(operation.parameters ?? []),\n        ]) {\n          const parameter = resolveRef<ParameterObject>(spec, parameterOrRef);\n          parameters.set(`${parameter.in}:${parameter.name}`, parameter);\n        }\n        operation.parameters = [...parameters.values()];\n      }\n      for (const pathItem of pathItems) {\n        delete pathItem.parameters;\n      }\n    },\n  };\n}\n"],
+  "mappings": "AAEA,SAAS,kBAAkB;AAE3B,SAAS,yBAAyB;AAG3B,SAAS,sBAAwC;AACtD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,EAAE,KAAK,GAAG;AAChB,YAAM,YAAY,oBAAI,IAAoB;AAC1C,iBAAW,EAAE,WAAW,SAAS,KAAK,kBAAkB,IAAI,GAAG;AAC7D,kBAAU,IAAI,QAAQ;AACtB,cAAM,aAAa,oBAAI,IAA6B;AACpD,mBAAW,kBAAkB;AAAA,UAC3B,GAAI,SAAS,cAAc,CAAC;AAAA,UAC5B,GAAI,UAAU,cAAc,CAAC;AAAA,QAC/B,GAAG;AACD,gBAAM,YAAY,WAA4B,MAAM,cAAc;AAClE,qBAAW,IAAI,GAAG,UAAU,EAAE,IAAI,UAAU,IAAI,IAAI,SAAS;AAAA,QAC/D;AACA,kBAAU,aAAa,CAAC,GAAG,WAAW,OAAO,CAAC;AAAA,MAChD;AACA,iBAAW,YAAY,WAAW;AAChC,eAAO,SAAS;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

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

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

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

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