@sdk-it/spec 0.46.11 → 0.47.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (176) hide show
  1. package/README.md +8 -4
  2. package/dist/index.d.ts +2 -1
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +2 -1
  5. package/dist/index.js.map +2 -2
  6. package/dist/lib/external-documents.d.ts +4 -1
  7. package/dist/lib/external-documents.d.ts.map +1 -1
  8. package/dist/lib/external-documents.js +27 -20
  9. package/dist/lib/external-documents.js.map +2 -2
  10. package/dist/lib/finalize-operations.d.ts +8 -0
  11. package/dist/lib/finalize-operations.d.ts.map +1 -0
  12. package/dist/lib/finalize-operations.js +134 -0
  13. package/dist/lib/finalize-operations.js.map +7 -0
  14. package/dist/lib/find-polymorphic-varients.d.ts.map +1 -1
  15. package/dist/lib/find-polymorphic-varients.js +3 -2
  16. package/dist/lib/find-polymorphic-varients.js.map +2 -2
  17. package/dist/lib/find-unique-schema-name.d.ts.map +1 -1
  18. package/dist/lib/for-each-operation.d.ts +3 -2
  19. package/dist/lib/for-each-operation.d.ts.map +1 -1
  20. package/dist/lib/for-each-operation.js +9 -4
  21. package/dist/lib/for-each-operation.js.map +2 -2
  22. package/dist/lib/format-name.d.ts.map +1 -1
  23. package/dist/lib/get-ref-usage.d.ts.map +1 -1
  24. package/dist/lib/get-ref-usage.js +1 -2
  25. package/dist/lib/get-ref-usage.js.map +2 -2
  26. package/dist/lib/guess/guess-resource.d.ts.map +1 -1
  27. package/dist/lib/guess/guess-resource.js +4 -4
  28. package/dist/lib/guess/guess-resource.js.map +2 -2
  29. package/dist/lib/ir.d.ts +2 -2
  30. package/dist/lib/ir.d.ts.map +1 -1
  31. package/dist/lib/ir.js +5 -3
  32. package/dist/lib/ir.js.map +2 -2
  33. package/dist/lib/is-primitive-schema.d.ts +12 -0
  34. package/dist/lib/is-primitive-schema.d.ts.map +1 -1
  35. package/dist/lib/is-primitive-schema.js +34 -1
  36. package/dist/lib/is-primitive-schema.js.map +2 -2
  37. package/dist/lib/is.d.ts +10 -1
  38. package/dist/lib/is.d.ts.map +1 -1
  39. package/dist/lib/is.js +20 -9
  40. package/dist/lib/is.js.map +2 -2
  41. package/dist/lib/loaders/load-spec.d.ts +9 -2
  42. package/dist/lib/loaders/load-spec.d.ts.map +1 -1
  43. package/dist/lib/loaders/load-spec.js +15 -20
  44. package/dist/lib/loaders/load-spec.js.map +2 -2
  45. package/dist/lib/loaders/local-loader.d.ts.map +1 -1
  46. package/dist/lib/loaders/postman/postman-converter.d.ts +1 -1
  47. package/dist/lib/loaders/postman/postman-converter.d.ts.map +1 -1
  48. package/dist/lib/loaders/postman/postman-converter.js +2 -3
  49. package/dist/lib/loaders/postman/postman-converter.js.map +2 -2
  50. package/dist/lib/loaders/postman/spec-types.d.ts.map +1 -1
  51. package/dist/lib/loaders/remote-loader.d.ts.map +1 -1
  52. package/dist/lib/loaders/remote-loader.js +4 -3
  53. package/dist/lib/loaders/remote-loader.js.map +2 -2
  54. package/dist/lib/metadata.d.ts +3 -9
  55. package/dist/lib/metadata.d.ts.map +1 -1
  56. package/dist/lib/metadata.js +22 -17
  57. package/dist/lib/metadata.js.map +2 -2
  58. package/dist/lib/operation-input.d.ts +33 -0
  59. package/dist/lib/operation-input.d.ts.map +1 -0
  60. package/dist/lib/operation-input.js +189 -0
  61. package/dist/lib/operation-input.js.map +7 -0
  62. package/dist/lib/options.d.ts +5 -6
  63. package/dist/lib/options.d.ts.map +1 -1
  64. package/dist/lib/options.js +0 -6
  65. package/dist/lib/options.js.map +2 -2
  66. package/dist/lib/overview-docs/doc-text-utils.d.ts +13 -13
  67. package/dist/lib/overview-docs/doc-text-utils.d.ts.map +1 -1
  68. package/dist/lib/overview-docs/overview-auth.d.ts.map +1 -1
  69. package/dist/lib/overview-docs/overview-auth.js.map +2 -2
  70. package/dist/lib/overview-docs/overview-docs.d.ts.map +1 -1
  71. package/dist/lib/overview-docs/overview-errors.d.ts.map +1 -1
  72. package/dist/lib/overview-docs/overview-errors.js +8 -5
  73. package/dist/lib/overview-docs/overview-errors.js.map +2 -2
  74. package/dist/lib/overview-docs/overview-page.d.ts.map +1 -1
  75. package/dist/lib/overview-docs/overview-page.js +2 -3
  76. package/dist/lib/overview-docs/overview-page.js.map +2 -2
  77. package/dist/lib/overview-docs/overview-pagination.d.ts.map +1 -1
  78. package/dist/lib/overview-docs/overview-sdks.d.ts.map +1 -1
  79. package/dist/lib/overview-docs/overview-sdks.js +2 -1
  80. package/dist/lib/overview-docs/overview-sdks.js.map +2 -2
  81. package/dist/lib/overview-docs/types.d.ts.map +1 -1
  82. package/dist/lib/overview-docs/types.js +1 -1
  83. package/dist/lib/overview-docs/types.js.map +2 -2
  84. package/dist/lib/pagination/guess-pagination.d.ts.map +1 -1
  85. package/dist/lib/pagination/guess-pagination.js.map +2 -2
  86. package/dist/lib/pagination/pagination-result.d.ts +3 -3
  87. package/dist/lib/pagination/pagination-result.d.ts.map +1 -1
  88. package/dist/lib/pagination/pagination-result.js +6 -3
  89. package/dist/lib/pagination/pagination-result.js.map +2 -2
  90. package/dist/lib/pagination/pagination.d.ts +31 -1
  91. package/dist/lib/pagination/pagination.d.ts.map +1 -1
  92. package/dist/lib/pagination/pagination.js +30 -11
  93. package/dist/lib/pagination/pagination.js.map +2 -2
  94. package/dist/lib/processing-plugins/bundle-external-refs.d.ts +13 -6
  95. package/dist/lib/processing-plugins/bundle-external-refs.d.ts.map +1 -1
  96. package/dist/lib/processing-plugins/bundle-external-refs.js +33 -18
  97. package/dist/lib/processing-plugins/bundle-external-refs.js.map +2 -2
  98. package/dist/lib/processing-plugins/canonicalize-spec.d.ts +2 -2
  99. package/dist/lib/processing-plugins/canonicalize-spec.d.ts.map +1 -1
  100. package/dist/lib/processing-plugins/canonicalize-spec.js.map +2 -2
  101. package/dist/lib/processing-plugins/create-default-processing-plugins.d.ts +4 -3
  102. package/dist/lib/processing-plugins/create-default-processing-plugins.d.ts.map +1 -1
  103. package/dist/lib/processing-plugins/create-default-processing-plugins.js +8 -3
  104. package/dist/lib/processing-plugins/create-default-processing-plugins.js.map +2 -2
  105. package/dist/lib/processing-plugins/enrich-examples.d.ts +4 -4
  106. package/dist/lib/processing-plugins/enrich-examples.d.ts.map +1 -1
  107. package/dist/lib/processing-plugins/enrich-examples.js +1 -1
  108. package/dist/lib/processing-plugins/enrich-examples.js.map +2 -2
  109. package/dist/lib/processing-plugins/extract-inline-schemas.d.ts +2 -2
  110. package/dist/lib/processing-plugins/extract-inline-schemas.d.ts.map +1 -1
  111. package/dist/lib/processing-plugins/extract-inline-schemas.js.map +2 -2
  112. package/dist/lib/processing-plugins/extract-overview-docs.d.ts +2 -2
  113. package/dist/lib/processing-plugins/extract-overview-docs.d.ts.map +1 -1
  114. package/dist/lib/processing-plugins/extract-overview-docs.js +4 -1
  115. package/dist/lib/processing-plugins/extract-overview-docs.js.map +2 -2
  116. package/dist/lib/processing-plugins/index.d.ts.map +1 -1
  117. package/dist/lib/processing-plugins/infer-pagination.d.ts +2 -2
  118. package/dist/lib/processing-plugins/infer-pagination.d.ts.map +1 -1
  119. package/dist/lib/processing-plugins/infer-pagination.js +5 -6
  120. package/dist/lib/processing-plugins/infer-pagination.js.map +2 -2
  121. package/dist/lib/processing-plugins/normalize-operation-ids.d.ts +2 -2
  122. package/dist/lib/processing-plugins/normalize-operation-ids.d.ts.map +1 -1
  123. package/dist/lib/processing-plugins/normalize-operation-ids.js.map +2 -2
  124. package/dist/lib/processing-plugins/normalize-parameters.d.ts +2 -2
  125. package/dist/lib/processing-plugins/normalize-parameters.d.ts.map +1 -1
  126. package/dist/lib/processing-plugins/normalize-parameters.js.map +2 -2
  127. package/dist/lib/processing-plugins/normalize-paths.d.ts +2 -2
  128. package/dist/lib/processing-plugins/normalize-paths.d.ts.map +1 -1
  129. package/dist/lib/processing-plugins/normalize-paths.js.map +2 -2
  130. package/dist/lib/processing-plugins/normalize-request-bodies.d.ts +9 -3
  131. package/dist/lib/processing-plugins/normalize-request-bodies.d.ts.map +1 -1
  132. package/dist/lib/processing-plugins/normalize-request-bodies.js +36 -15
  133. package/dist/lib/processing-plugins/normalize-request-bodies.js.map +2 -2
  134. package/dist/lib/processing-plugins/normalize-responses.d.ts +2 -2
  135. package/dist/lib/processing-plugins/normalize-responses.d.ts.map +1 -1
  136. package/dist/lib/processing-plugins/normalize-responses.js +11 -15
  137. package/dist/lib/processing-plugins/normalize-responses.js.map +2 -2
  138. package/dist/lib/processing-plugins/normalize-schemas.d.ts +2 -2
  139. package/dist/lib/processing-plugins/normalize-schemas.d.ts.map +1 -1
  140. package/dist/lib/processing-plugins/normalize-schemas.js +14 -4
  141. package/dist/lib/processing-plugins/normalize-schemas.js.map +2 -2
  142. package/dist/lib/processing-plugins/normalize-security.d.ts +2 -2
  143. package/dist/lib/processing-plugins/normalize-security.d.ts.map +1 -1
  144. package/dist/lib/processing-plugins/normalize-security.js +6 -5
  145. package/dist/lib/processing-plugins/normalize-security.js.map +2 -2
  146. package/dist/lib/processing-plugins/normalize-tags.d.ts +8 -2
  147. package/dist/lib/processing-plugins/normalize-tags.d.ts.map +1 -1
  148. package/dist/lib/processing-plugins/normalize-tags.js +35 -1
  149. package/dist/lib/processing-plugins/normalize-tags.js.map +2 -2
  150. package/dist/lib/processing-plugins/resolve-security-scheme-uris.d.ts +13 -2
  151. package/dist/lib/processing-plugins/resolve-security-scheme-uris.d.ts.map +1 -1
  152. package/dist/lib/processing-plugins/resolve-security-scheme-uris.js +58 -38
  153. package/dist/lib/processing-plugins/resolve-security-scheme-uris.js.map +2 -2
  154. package/dist/lib/processing.d.ts +25 -11
  155. package/dist/lib/processing.d.ts.map +1 -1
  156. package/dist/lib/processing.js +53 -16
  157. package/dist/lib/processing.js.map +2 -2
  158. package/dist/lib/reserved-keywords.d.ts.map +1 -1
  159. package/dist/lib/sidebar.d.ts +5 -4
  160. package/dist/lib/sidebar.d.ts.map +1 -1
  161. package/dist/lib/sidebar.js +46 -23
  162. package/dist/lib/sidebar.js.map +2 -2
  163. package/dist/lib/tag.d.ts.map +1 -1
  164. package/dist/lib/types.d.ts +34 -12
  165. package/dist/lib/types.d.ts.map +1 -1
  166. package/dist/lib/types.js +11 -0
  167. package/dist/lib/types.js.map +3 -3
  168. package/dist/lib/walk-schemas.d.ts +4 -2
  169. package/dist/lib/walk-schemas.d.ts.map +1 -1
  170. package/dist/lib/walk-schemas.js +15 -13
  171. package/dist/lib/walk-schemas.js.map +2 -2
  172. package/package.json +17 -6
  173. package/dist/lib/create-operation.d.ts +0 -28
  174. package/dist/lib/create-operation.d.ts.map +0 -1
  175. package/dist/lib/create-operation.js +0 -62
  176. package/dist/lib/create-operation.js.map +0 -7
@@ -14,15 +14,15 @@ const HTTP_METHOD_ACTIONS = {
14
14
  };
15
15
  function extractResourceInfo(path) {
16
16
  const pathSegments = path.split("/").filter(Boolean);
17
- if (pathSegments.length === 0) {
17
+ const lastSegment = pathSegments.at(-1);
18
+ if (lastSegment === void 0) {
18
19
  return {
19
20
  resourceName: "root",
20
21
  isSingleResource: false,
21
22
  resourceHierarchy: ["root"]
22
23
  };
23
24
  }
24
- const lastSegment = pathSegments[pathSegments.length - 1];
25
- const isSingleResource = lastSegment?.startsWith("{") && lastSegment?.endsWith("}");
25
+ const isSingleResource = lastSegment.startsWith("{") && lastSegment.endsWith("}");
26
26
  let resourceName;
27
27
  let resourceHierarchy;
28
28
  if (isSingleResource) {
@@ -45,7 +45,7 @@ function guessOperationName(method, {
45
45
  isSingleResource,
46
46
  resourceHierarchy
47
47
  }) {
48
- const methodAction = HTTP_METHOD_ACTIONS[method.toLowerCase()];
48
+ const methodAction = HTTP_METHOD_ACTIONS[method];
49
49
  if (!methodAction) {
50
50
  const fallbackAction = isSingleResource ? method.toLowerCase() : `${method.toLowerCase()}All`;
51
51
  return {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../src/lib/guess/guess-resource.ts"],
4
- "sourcesContent": ["import type { OperationObject } from 'openapi3-ts/oas31';\nimport { camelcase } from 'stringcase';\n\nimport { type Method } from '@sdk-it/core/paths.js';\n\nimport { cleanOperationId } from '../options.js';\n\nconst HTTP_METHOD_ACTIONS = {\n get: { single: 'get', collection: 'list' },\n post: { single: 'create', collection: 'create' },\n put: { single: 'replace', collection: 'replaceAll' },\n patch: { single: 'update', collection: 'updateMany' },\n delete: { single: 'delete', collection: 'deleteMany' },\n head: { single: 'exists', collection: 'checkList' },\n options: { single: 'options', collection: 'optionsList' },\n trace: { single: 'trace', collection: 'traceList' },\n connect: { single: 'connect', collection: 'connectList' },\n} as const;\n\nfunction extractResourceInfo(path: string): {\n resourceName: string;\n isSingleResource: boolean;\n resourceHierarchy: string[];\n} {\n const pathSegments = path.split('/').filter(Boolean);\n\n if (pathSegments.length === 0) {\n return {\n resourceName: 'root',\n isSingleResource: false,\n resourceHierarchy: ['root'],\n };\n }\n\n const lastSegment = pathSegments[pathSegments.length - 1];\n const isSingleResource =\n lastSegment?.startsWith('{') && lastSegment?.endsWith('}');\n\n // For single resources, use the parent resource name\n // For collections, use the last segment\n let resourceName: string;\n let resourceHierarchy: string[];\n\n if (isSingleResource) {\n // Single resource: /users/{id} -> \"users\"\n const parentSegment = pathSegments[pathSegments.length - 2];\n resourceName = parentSegment || 'item';\n resourceHierarchy = pathSegments\n .filter((segment) => !segment.startsWith('{'))\n .map((segment) => segment.replace(/[{}]/g, ''));\n } else {\n // Collection: /users or /users/active -> \"users\" or \"usersActive\"\n resourceName = lastSegment;\n resourceHierarchy = pathSegments\n .filter((segment) => !segment.startsWith('{'))\n .map((segment) => segment.replace(/[{}]/g, ''));\n }\n\n // Clean and normalize resource name\n const cleanResourceName = resourceName\n .replace(/[{}]/g, '')\n .replace(/[-_]/g, ' ')\n .replace(/[^a-zA-Z0-9\\s]/g, '');\n\n // Generate a hierarchy-based group name for better conflict avoidance\n const hierarchicalName =\n resourceHierarchy.length > 1\n ? resourceHierarchy.join(' ')\n : cleanResourceName;\n\n return {\n resourceName: cleanResourceName || 'resource',\n isSingleResource,\n resourceHierarchy: [hierarchicalName],\n };\n}\n\nfunction guessOperationName(\n method: Method,\n {\n isSingleResource,\n resourceHierarchy,\n }: ReturnType<typeof extractResourceInfo>,\n): { name: string; group: string } {\n const methodAction =\n HTTP_METHOD_ACTIONS[\n method.toLowerCase() as keyof typeof HTTP_METHOD_ACTIONS\n ];\n\n if (!methodAction) {\n // Fallback for unknown HTTP methods\n const fallbackAction = isSingleResource\n ? method.toLowerCase()\n : `${method.toLowerCase()}All`;\n return {\n name: camelcase(fallbackAction),\n group: camelcase(resourceHierarchy[0]),\n };\n }\n\n const actionName = isSingleResource\n ? methodAction.single\n : methodAction.collection;\n\n // Create more descriptive names for complex paths\n const operationName =\n resourceHierarchy.length > 1 && !isSingleResource\n ? `${actionName} ${resourceHierarchy.slice(-1)[0]}` // e.g., \"list activeUsers\"\n : actionName;\n\n return {\n name: camelcase(operationName),\n group: camelcase(resourceHierarchy[0]),\n };\n}\n\nexport function toResource(\n operation: OperationObject,\n path: string,\n method: Method,\n) {\n // Priority 1: Non-guessed operationId\n const resourceInfo = extractResourceInfo(path);\n if (operation.operationId) {\n return {\n name: cleanOperationId(operation.operationId),\n group: camelcase(resourceInfo.resourceName),\n };\n }\n\n // Priority 2: CRUD operation name\n return guessOperationName(method, resourceInfo);\n}\n"],
5
- "mappings": "AACA,SAAS,iBAAiB;AAE1B,eAA4B;AAE5B,SAAS,wBAAwB;AAEjC,MAAM,sBAAsB;AAAA,EAC1B,KAAK,EAAE,QAAQ,OAAO,YAAY,OAAO;AAAA,EACzC,MAAM,EAAE,QAAQ,UAAU,YAAY,SAAS;AAAA,EAC/C,KAAK,EAAE,QAAQ,WAAW,YAAY,aAAa;AAAA,EACnD,OAAO,EAAE,QAAQ,UAAU,YAAY,aAAa;AAAA,EACpD,QAAQ,EAAE,QAAQ,UAAU,YAAY,aAAa;AAAA,EACrD,MAAM,EAAE,QAAQ,UAAU,YAAY,YAAY;AAAA,EAClD,SAAS,EAAE,QAAQ,WAAW,YAAY,cAAc;AAAA,EACxD,OAAO,EAAE,QAAQ,SAAS,YAAY,YAAY;AAAA,EAClD,SAAS,EAAE,QAAQ,WAAW,YAAY,cAAc;AAC1D;AAEA,SAAS,oBAAoB,MAI3B;AACA,QAAM,eAAe,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAEnD,MAAI,aAAa,WAAW,GAAG;AAC7B,WAAO;AAAA,MACL,cAAc;AAAA,MACd,kBAAkB;AAAA,MAClB,mBAAmB,CAAC,MAAM;AAAA,IAC5B;AAAA,EACF;AAEA,QAAM,cAAc,aAAa,aAAa,SAAS,CAAC;AACxD,QAAM,mBACJ,aAAa,WAAW,GAAG,KAAK,aAAa,SAAS,GAAG;AAI3D,MAAI;AACJ,MAAI;AAEJ,MAAI,kBAAkB;AAEpB,UAAM,gBAAgB,aAAa,aAAa,SAAS,CAAC;AAC1D,mBAAe,iBAAiB;AAChC,wBAAoB,aACjB,OAAO,CAAC,YAAY,CAAC,QAAQ,WAAW,GAAG,CAAC,EAC5C,IAAI,CAAC,YAAY,QAAQ,QAAQ,SAAS,EAAE,CAAC;AAAA,EAClD,OAAO;AAEL,mBAAe;AACf,wBAAoB,aACjB,OAAO,CAAC,YAAY,CAAC,QAAQ,WAAW,GAAG,CAAC,EAC5C,IAAI,CAAC,YAAY,QAAQ,QAAQ,SAAS,EAAE,CAAC;AAAA,EAClD;AAGA,QAAM,oBAAoB,aACvB,QAAQ,SAAS,EAAE,EACnB,QAAQ,SAAS,GAAG,EACpB,QAAQ,mBAAmB,EAAE;AAGhC,QAAM,mBACJ,kBAAkB,SAAS,IACvB,kBAAkB,KAAK,GAAG,IAC1B;AAEN,SAAO;AAAA,IACL,cAAc,qBAAqB;AAAA,IACnC;AAAA,IACA,mBAAmB,CAAC,gBAAgB;AAAA,EACtC;AACF;AAEA,SAAS,mBACP,QACA;AAAA,EACE;AAAA,EACA;AACF,GACiC;AACjC,QAAM,eACJ,oBACE,OAAO,YAAY,CACrB;AAEF,MAAI,CAAC,cAAc;AAEjB,UAAM,iBAAiB,mBACnB,OAAO,YAAY,IACnB,GAAG,OAAO,YAAY,CAAC;AAC3B,WAAO;AAAA,MACL,MAAM,UAAU,cAAc;AAAA,MAC9B,OAAO,UAAU,kBAAkB,CAAC,CAAC;AAAA,IACvC;AAAA,EACF;AAEA,QAAM,aAAa,mBACf,aAAa,SACb,aAAa;AAGjB,QAAM,gBACJ,kBAAkB,SAAS,KAAK,CAAC,mBAC7B,GAAG,UAAU,IAAI,kBAAkB,MAAM,EAAE,EAAE,CAAC,CAAC,KAC/C;AAEN,SAAO;AAAA,IACL,MAAM,UAAU,aAAa;AAAA,IAC7B,OAAO,UAAU,kBAAkB,CAAC,CAAC;AAAA,EACvC;AACF;AAEO,SAAS,WACd,WACA,MACA,QACA;AAEA,QAAM,eAAe,oBAAoB,IAAI;AAC7C,MAAI,UAAU,aAAa;AACzB,WAAO;AAAA,MACL,MAAM,iBAAiB,UAAU,WAAW;AAAA,MAC5C,OAAO,UAAU,aAAa,YAAY;AAAA,IAC5C;AAAA,EACF;AAGA,SAAO,mBAAmB,QAAQ,YAAY;AAChD;",
4
+ "sourcesContent": ["import type { OperationObject } from 'openapi3-ts/oas31';\nimport { camelcase } from 'stringcase';\n\nimport { type Method } from '@sdk-it/core/paths.js';\n\nimport { cleanOperationId } from '../options.js';\n\nconst HTTP_METHOD_ACTIONS = {\n get: { single: 'get', collection: 'list' },\n post: { single: 'create', collection: 'create' },\n put: { single: 'replace', collection: 'replaceAll' },\n patch: { single: 'update', collection: 'updateMany' },\n delete: { single: 'delete', collection: 'deleteMany' },\n head: { single: 'exists', collection: 'checkList' },\n options: { single: 'options', collection: 'optionsList' },\n trace: { single: 'trace', collection: 'traceList' },\n connect: { single: 'connect', collection: 'connectList' },\n} as const;\n\nfunction extractResourceInfo(path: string): {\n resourceName: string;\n isSingleResource: boolean;\n resourceHierarchy: string[];\n} {\n const pathSegments = path.split('/').filter(Boolean);\n\n const lastSegment = pathSegments.at(-1);\n\n if (lastSegment === undefined) {\n return {\n resourceName: 'root',\n isSingleResource: false,\n resourceHierarchy: ['root'],\n };\n }\n\n const isSingleResource =\n lastSegment.startsWith('{') && lastSegment.endsWith('}');\n\n // For single resources, use the parent resource name\n // For collections, use the last segment\n let resourceName: string;\n let resourceHierarchy: string[];\n\n if (isSingleResource) {\n // Single resource: /users/{id} -> \"users\"\n const parentSegment = pathSegments[pathSegments.length - 2];\n resourceName = parentSegment || 'item';\n resourceHierarchy = pathSegments\n .filter((segment) => !segment.startsWith('{'))\n .map((segment) => segment.replace(/[{}]/g, ''));\n } else {\n // Collection: /users or /users/active -> \"users\" or \"usersActive\"\n resourceName = lastSegment;\n resourceHierarchy = pathSegments\n .filter((segment) => !segment.startsWith('{'))\n .map((segment) => segment.replace(/[{}]/g, ''));\n }\n\n // Clean and normalize resource name\n const cleanResourceName = resourceName\n .replace(/[{}]/g, '')\n .replace(/[-_]/g, ' ')\n .replace(/[^a-zA-Z0-9\\s]/g, '');\n\n // Generate a hierarchy-based group name for better conflict avoidance\n const hierarchicalName =\n resourceHierarchy.length > 1\n ? resourceHierarchy.join(' ')\n : cleanResourceName;\n\n return {\n resourceName: cleanResourceName || 'resource',\n isSingleResource,\n resourceHierarchy: [hierarchicalName],\n };\n}\n\nfunction guessOperationName(\n method: Method,\n {\n isSingleResource,\n resourceHierarchy,\n }: ReturnType<typeof extractResourceInfo>,\n): { name: string; group: string } {\n const methodAction = HTTP_METHOD_ACTIONS[method];\n\n if (!methodAction) {\n // Fallback for unknown HTTP methods\n const fallbackAction = isSingleResource\n ? method.toLowerCase()\n : `${method.toLowerCase()}All`;\n return {\n name: camelcase(fallbackAction),\n group: camelcase(resourceHierarchy[0]),\n };\n }\n\n const actionName = isSingleResource\n ? methodAction.single\n : methodAction.collection;\n\n // Create more descriptive names for complex paths\n const operationName =\n resourceHierarchy.length > 1 && !isSingleResource\n ? `${actionName} ${resourceHierarchy.slice(-1)[0]}` // e.g., \"list activeUsers\"\n : actionName;\n\n return {\n name: camelcase(operationName),\n group: camelcase(resourceHierarchy[0]),\n };\n}\n\nexport function toResource(\n operation: OperationObject,\n path: string,\n method: Method,\n) {\n // Priority 1: Non-guessed operationId\n const resourceInfo = extractResourceInfo(path);\n if (operation.operationId) {\n return {\n name: cleanOperationId(operation.operationId),\n group: camelcase(resourceInfo.resourceName),\n };\n }\n\n // Priority 2: CRUD operation name\n return guessOperationName(method, resourceInfo);\n}\n"],
5
+ "mappings": "AACA,SAAS,iBAAiB;AAE1B,eAA4B;AAE5B,SAAS,wBAAwB;AAEjC,MAAM,sBAAsB;AAAA,EAC1B,KAAK,EAAE,QAAQ,OAAO,YAAY,OAAO;AAAA,EACzC,MAAM,EAAE,QAAQ,UAAU,YAAY,SAAS;AAAA,EAC/C,KAAK,EAAE,QAAQ,WAAW,YAAY,aAAa;AAAA,EACnD,OAAO,EAAE,QAAQ,UAAU,YAAY,aAAa;AAAA,EACpD,QAAQ,EAAE,QAAQ,UAAU,YAAY,aAAa;AAAA,EACrD,MAAM,EAAE,QAAQ,UAAU,YAAY,YAAY;AAAA,EAClD,SAAS,EAAE,QAAQ,WAAW,YAAY,cAAc;AAAA,EACxD,OAAO,EAAE,QAAQ,SAAS,YAAY,YAAY;AAAA,EAClD,SAAS,EAAE,QAAQ,WAAW,YAAY,cAAc;AAC1D;AAEA,SAAS,oBAAoB,MAI3B;AACA,QAAM,eAAe,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAEnD,QAAM,cAAc,aAAa,GAAG,EAAE;AAEtC,MAAI,gBAAgB,QAAW;AAC7B,WAAO;AAAA,MACL,cAAc;AAAA,MACd,kBAAkB;AAAA,MAClB,mBAAmB,CAAC,MAAM;AAAA,IAC5B;AAAA,EACF;AAEA,QAAM,mBACJ,YAAY,WAAW,GAAG,KAAK,YAAY,SAAS,GAAG;AAIzD,MAAI;AACJ,MAAI;AAEJ,MAAI,kBAAkB;AAEpB,UAAM,gBAAgB,aAAa,aAAa,SAAS,CAAC;AAC1D,mBAAe,iBAAiB;AAChC,wBAAoB,aACjB,OAAO,CAAC,YAAY,CAAC,QAAQ,WAAW,GAAG,CAAC,EAC5C,IAAI,CAAC,YAAY,QAAQ,QAAQ,SAAS,EAAE,CAAC;AAAA,EAClD,OAAO;AAEL,mBAAe;AACf,wBAAoB,aACjB,OAAO,CAAC,YAAY,CAAC,QAAQ,WAAW,GAAG,CAAC,EAC5C,IAAI,CAAC,YAAY,QAAQ,QAAQ,SAAS,EAAE,CAAC;AAAA,EAClD;AAGA,QAAM,oBAAoB,aACvB,QAAQ,SAAS,EAAE,EACnB,QAAQ,SAAS,GAAG,EACpB,QAAQ,mBAAmB,EAAE;AAGhC,QAAM,mBACJ,kBAAkB,SAAS,IACvB,kBAAkB,KAAK,GAAG,IAC1B;AAEN,SAAO;AAAA,IACL,cAAc,qBAAqB;AAAA,IACnC;AAAA,IACA,mBAAmB,CAAC,gBAAgB;AAAA,EACtC;AACF;AAEA,SAAS,mBACP,QACA;AAAA,EACE;AAAA,EACA;AACF,GACiC;AACjC,QAAM,eAAe,oBAAoB,MAAM;AAE/C,MAAI,CAAC,cAAc;AAEjB,UAAM,iBAAiB,mBACnB,OAAO,YAAY,IACnB,GAAG,OAAO,YAAY,CAAC;AAC3B,WAAO;AAAA,MACL,MAAM,UAAU,cAAc;AAAA,MAC9B,OAAO,UAAU,kBAAkB,CAAC,CAAC;AAAA,IACvC;AAAA,EACF;AAEA,QAAM,aAAa,mBACf,aAAa,SACb,aAAa;AAGjB,QAAM,gBACJ,kBAAkB,SAAS,KAAK,CAAC,mBAC7B,GAAG,UAAU,IAAI,kBAAkB,MAAM,EAAE,EAAE,CAAC,CAAC,KAC/C;AAEN,SAAO;AAAA,IACL,MAAM,UAAU,aAAa;AAAA,IAC7B,OAAO,UAAU,kBAAkB,CAAC,CAAC;AAAA,EACvC;AACF;AAEO,SAAS,WACd,WACA,MACA,QACA;AAEA,QAAM,eAAe,oBAAoB,IAAI;AAC7C,MAAI,UAAU,aAAa;AACzB,WAAO;AAAA,MACL,MAAM,iBAAiB,UAAU,WAAW;AAAA,MAC5C,OAAO,UAAU,aAAa,YAAY;AAAA,IAC5C;AAAA,EACF;AAGA,SAAO,mBAAmB,QAAQ,YAAY;AAChD;",
6
6
  "names": []
7
7
  }
package/dist/lib/ir.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import type { GenerateSdkConfig } from './options.js';
1
+ import { type ProcessSpecConfig } from './processing.js';
2
2
  import type { IR } from './types.js';
3
- export declare function toIR(config: GenerateSdkConfig, verbose?: boolean): Promise<IR>;
3
+ export declare function toIR(config: ProcessSpecConfig, verbose?: boolean): Promise<IR>;
4
4
  //# sourceMappingURL=ir.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../../src/lib/ir.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGtD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAErC,wBAAsB,IAAI,CACxB,MAAM,EAAE,iBAAiB,EACzB,OAAO,UAAQ,GACd,OAAO,CAAC,EAAE,CAAC,CAIb"}
1
+ {"version":3,"file":"ir.d.ts","sources":["../../src/lib/ir.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAe,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAErC,wBAAsB,IAAI,CACxB,MAAM,EAAE,iBAAiB,EACzB,OAAO,UAAQ,GACd,OAAO,CAAC,EAAE,CAAC,CAMb"}
package/dist/lib/ir.js CHANGED
@@ -1,8 +1,10 @@
1
- import { createDefaultProcessingPlugins } from "./processing-plugins/index.js";
1
+ import { createDefaultIRPlugins } from "./processing-plugins/create-default-processing-plugins.js";
2
2
  import { processSpec } from "./processing.js";
3
3
  async function toIR(config, verbose = false) {
4
- const plugins = config.plugins ?? createDefaultProcessingPlugins({ verbose });
5
- const result = await processSpec({ ...config, plugins });
4
+ const result = await processSpec({
5
+ ...config,
6
+ irPlugins: config.irPlugins ?? createDefaultIRPlugins({ verbose })
7
+ });
6
8
  return result.spec;
7
9
  }
8
10
  export {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/lib/ir.ts"],
4
- "sourcesContent": ["import type { GenerateSdkConfig } from './options.js';\nimport { createDefaultProcessingPlugins } from './processing-plugins/index.js';\nimport { processSpec } from './processing.js';\nimport type { IR } from './types.js';\n\nexport async function toIR(\n config: GenerateSdkConfig,\n verbose = false,\n): Promise<IR> {\n const plugins = config.plugins ?? createDefaultProcessingPlugins({ verbose });\n const result = await processSpec({ ...config, plugins });\n return result.spec;\n}\n"],
5
- "mappings": "AACA,SAAS,sCAAsC;AAC/C,SAAS,mBAAmB;AAG5B,eAAsB,KACpB,QACA,UAAU,OACG;AACb,QAAM,UAAU,OAAO,WAAW,+BAA+B,EAAE,QAAQ,CAAC;AAC5E,QAAM,SAAS,MAAM,YAAY,EAAE,GAAG,QAAQ,QAAQ,CAAC;AACvD,SAAO,OAAO;AAChB;",
4
+ "sourcesContent": ["import { createDefaultIRPlugins } from './processing-plugins/create-default-processing-plugins.js';\nimport { type ProcessSpecConfig, processSpec } from './processing.js';\nimport type { IR } from './types.js';\n\nexport async function toIR(\n config: ProcessSpecConfig,\n verbose = false,\n): Promise<IR> {\n const result = await processSpec({\n ...config,\n irPlugins: config.irPlugins ?? createDefaultIRPlugins({ verbose }),\n });\n return result.spec;\n}\n"],
5
+ "mappings": "AAAA,SAAS,8BAA8B;AACvC,SAAiC,mBAAmB;AAGpD,eAAsB,KACpB,QACA,UAAU,OACG;AACb,QAAM,SAAS,MAAM,YAAY;AAAA,IAC/B,GAAG;AAAA,IACH,WAAW,OAAO,aAAa,uBAAuB,EAAE,QAAQ,CAAC;AAAA,EACnE,CAAC;AACD,SAAO,OAAO;AAChB;",
6
6
  "names": []
7
7
  }
@@ -1,3 +1,15 @@
1
1
  import type { SchemaObject } from 'openapi3-ts/oas31';
2
+ import type { OpenAPIDocument } from '@sdk-it/core';
2
3
  export declare function isPrimitiveSchema(schema: SchemaObject): boolean;
4
+ /**
5
+ * Whether a generator may write the component `$ref` points at in place
6
+ * instead of naming it: a primitive that does not reach itself through other
7
+ * primitives, since inlining a cycle never ends.
8
+ */
9
+ export declare function isInlinable(spec: OpenAPIDocument, $ref: string): boolean;
10
+ /**
11
+ * Whether the component `$ref` points at refers back to itself through other
12
+ * components, so a generator must defer the reference that closes the cycle.
13
+ */
14
+ export declare function isRecursiveRef(spec: OpenAPIDocument, $ref: string): boolean;
3
15
  //# sourceMappingURL=is-primitive-schema.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"is-primitive-schema.d.ts","sourceRoot":"","sources":["../../src/lib/is-primitive-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,WAMrD"}
1
+ {"version":3,"file":"is-primitive-schema.d.ts","sources":["../../src/lib/is-primitive-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAMpD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,WAMrD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAMxE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ3E"}
@@ -1,4 +1,6 @@
1
+ import { followRef, isRef } from "@sdk-it/core/ref.js";
1
2
  import { coerceTypes } from "./is.js";
3
+ import { subschemas } from "./walk-schemas.js";
2
4
  function isPrimitiveSchema(schema) {
3
5
  const types = coerceTypes(schema, false);
4
6
  if (!types || types.length === 0) {
@@ -6,7 +8,38 @@ function isPrimitiveSchema(schema) {
6
8
  }
7
9
  return types.includes("object") === false;
8
10
  }
11
+ function isInlinable(spec, $ref) {
12
+ const target = followRef(spec, $ref);
13
+ return isPrimitiveSchema(target) && !reaches(spec, target, $ref, /* @__PURE__ */ new Set(), isPrimitiveSchema);
14
+ }
15
+ function isRecursiveRef(spec, $ref) {
16
+ return reaches(
17
+ spec,
18
+ followRef(spec, $ref),
19
+ $ref,
20
+ /* @__PURE__ */ new Set(),
21
+ () => true
22
+ );
23
+ }
24
+ function reaches(spec, schema, $ref, seen, through) {
25
+ for (const [, child] of subschemas(schema)) {
26
+ if (!isRef(child)) {
27
+ if (reaches(spec, child, $ref, seen, through)) return true;
28
+ continue;
29
+ }
30
+ if (child.$ref === $ref) return true;
31
+ if (seen.has(child.$ref)) continue;
32
+ seen.add(child.$ref);
33
+ const target = followRef(spec, child.$ref);
34
+ if (through(target) && reaches(spec, target, $ref, seen, through)) {
35
+ return true;
36
+ }
37
+ }
38
+ return false;
39
+ }
9
40
  export {
10
- isPrimitiveSchema
41
+ isInlinable,
42
+ isPrimitiveSchema,
43
+ isRecursiveRef
11
44
  };
12
45
  //# sourceMappingURL=is-primitive-schema.js.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/lib/is-primitive-schema.ts"],
4
- "sourcesContent": ["import type { SchemaObject } from 'openapi3-ts/oas31';\n\nimport { coerceTypes } from './is.js';\n\nexport function isPrimitiveSchema(schema: SchemaObject) {\n const types = coerceTypes(schema, false);\n if (!types || types.length === 0) {\n return false;\n }\n return types.includes('object') === false;\n}\n"],
5
- "mappings": "AAEA,SAAS,mBAAmB;AAErB,SAAS,kBAAkB,QAAsB;AACtD,QAAM,QAAQ,YAAY,QAAQ,KAAK;AACvC,MAAI,CAAC,SAAS,MAAM,WAAW,GAAG;AAChC,WAAO;AAAA,EACT;AACA,SAAO,MAAM,SAAS,QAAQ,MAAM;AACtC;",
4
+ "sourcesContent": ["import type { SchemaObject } from 'openapi3-ts/oas31';\n\nimport type { OpenAPIDocument } from '@sdk-it/core';\nimport { followRef, isRef } from '@sdk-it/core/ref.js';\n\nimport { coerceTypes } from './is.js';\nimport { subschemas } from './walk-schemas.js';\n\nexport function isPrimitiveSchema(schema: SchemaObject) {\n const types = coerceTypes(schema, false);\n if (!types || types.length === 0) {\n return false;\n }\n return types.includes('object') === false;\n}\n\n/**\n * Whether a generator may write the component `$ref` points at in place\n * instead of naming it: a primitive that does not reach itself through other\n * primitives, since inlining a cycle never ends.\n */\nexport function isInlinable(spec: OpenAPIDocument, $ref: string): boolean {\n const target = followRef<SchemaObject>(spec, $ref);\n return (\n isPrimitiveSchema(target) &&\n !reaches(spec, target, $ref, new Set(), isPrimitiveSchema)\n );\n}\n\n/**\n * Whether the component `$ref` points at refers back to itself through other\n * components, so a generator must defer the reference that closes the cycle.\n */\nexport function isRecursiveRef(spec: OpenAPIDocument, $ref: string): boolean {\n return reaches(\n spec,\n followRef<SchemaObject>(spec, $ref),\n $ref,\n new Set(),\n () => true,\n );\n}\n\n/** Whether `schema` refers to `$ref`, following each component `through` accepts. */\nfunction reaches(\n spec: OpenAPIDocument,\n schema: SchemaObject,\n $ref: string,\n seen: Set<string>,\n through: (component: SchemaObject) => boolean,\n): boolean {\n for (const [, child] of subschemas(schema)) {\n if (!isRef(child)) {\n if (reaches(spec, child, $ref, seen, through)) return true;\n continue;\n }\n if (child.$ref === $ref) return true;\n if (seen.has(child.$ref)) continue;\n seen.add(child.$ref);\n const target = followRef<SchemaObject>(spec, child.$ref);\n if (through(target) && reaches(spec, target, $ref, seen, through)) {\n return true;\n }\n }\n return false;\n}\n"],
5
+ "mappings": "AAGA,SAAS,WAAW,aAAa;AAEjC,SAAS,mBAAmB;AAC5B,SAAS,kBAAkB;AAEpB,SAAS,kBAAkB,QAAsB;AACtD,QAAM,QAAQ,YAAY,QAAQ,KAAK;AACvC,MAAI,CAAC,SAAS,MAAM,WAAW,GAAG;AAChC,WAAO;AAAA,EACT;AACA,SAAO,MAAM,SAAS,QAAQ,MAAM;AACtC;AAOO,SAAS,YAAY,MAAuB,MAAuB;AACxE,QAAM,SAAS,UAAwB,MAAM,IAAI;AACjD,SACE,kBAAkB,MAAM,KACxB,CAAC,QAAQ,MAAM,QAAQ,MAAM,oBAAI,IAAI,GAAG,iBAAiB;AAE7D;AAMO,SAAS,eAAe,MAAuB,MAAuB;AAC3E,SAAO;AAAA,IACL;AAAA,IACA,UAAwB,MAAM,IAAI;AAAA,IAClC;AAAA,IACA,oBAAI,IAAI;AAAA,IACR,MAAM;AAAA,EACR;AACF;AAGA,SAAS,QACP,MACA,QACA,MACA,MACA,SACS;AACT,aAAW,CAAC,EAAE,KAAK,KAAK,WAAW,MAAM,GAAG;AAC1C,QAAI,CAAC,MAAM,KAAK,GAAG;AACjB,UAAI,QAAQ,MAAM,OAAO,MAAM,MAAM,OAAO,EAAG,QAAO;AACtD;AAAA,IACF;AACA,QAAI,MAAM,SAAS,KAAM,QAAO;AAChC,QAAI,KAAK,IAAI,MAAM,IAAI,EAAG;AAC1B,SAAK,IAAI,MAAM,IAAI;AACnB,UAAM,SAAS,UAAwB,MAAM,MAAM,IAAI;AACvD,QAAI,QAAQ,MAAM,KAAK,QAAQ,MAAM,QAAQ,MAAM,MAAM,OAAO,GAAG;AACjE,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;",
6
6
  "names": []
7
7
  }
package/dist/lib/is.d.ts CHANGED
@@ -2,9 +2,18 @@ import type { SchemaObject, SchemaObjectType } from 'openapi3-ts/oas31';
2
2
  export declare function coerceTypes(schema: SchemaObject, excludeNull?: boolean): SchemaObjectType[];
3
3
  export declare function isStreamingContentType(contentType: string | null | undefined): boolean;
4
4
  export declare function isBinaryContentType(contentType: string | null | undefined): boolean;
5
+ /** Whether `contentType` is an XML media type: `*\/xml` or `*\/*+xml`. */
6
+ export declare function isXmlContentType(contentType: string | null | undefined): boolean;
7
+ /** The status ranges an OpenAPI 3.2 Responses Object may declare. */
8
+ export type StatusRange = '1XX' | '2XX' | '3XX' | '4XX' | '5XX';
9
+ /**
10
+ * The range that a Responses Object key declares, or undefined for an explicit
11
+ * code or `default`. OpenAPI 3.2 allows only the uppercase `X` wildcard.
12
+ */
13
+ export declare function statusRange(status: string): StatusRange | undefined;
5
14
  export declare function isSuccessStatusCode(statusCode: number | string): boolean;
6
15
  export declare function isErrorStatusCode(statusCode: number | string): boolean;
7
- export declare function parseJsonContentType(contentType: string | null | undefined): string | null;
16
+ export declare function parseJsonContentType(contentType: string | null | undefined): "json" | null;
8
17
  export declare function isTextContentType(contentType: string | null | undefined): boolean;
9
18
  /**
10
19
  * Checks if a given content type string represents Server-Sent Events (SSE).
@@ -1 +1 @@
1
- {"version":3,"file":"is.d.ts","sourceRoot":"","sources":["../../src/lib/is.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAExE,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,WAAW,UAAO,GACjB,gBAAgB,EAAE,CAOpB;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAET;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAkET;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAMxE;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CActE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,iBAuB1E;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAiBT;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAoBT"}
1
+ {"version":3,"file":"is.d.ts","sources":["../../src/lib/is.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAExE,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,WAAW,UAAO,GACjB,gBAAgB,EAAE,CAOpB;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAET;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CA+DT;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAGT;AAED,qEAAqE;AACrE,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAUhE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEnE;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAMxE;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CActE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,iBAuB1E;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAiBT;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAoBT"}
package/dist/lib/is.js CHANGED
@@ -21,10 +21,7 @@ function isBinaryContentType(contentType) {
21
21
  if (mainType.endsWith("/json") || mainType.endsWith("+json")) {
22
22
  return false;
23
23
  }
24
- if (mainType.endsWith("/xml") || mainType.endsWith("+xml")) {
25
- return false;
26
- }
27
- if (mainType === "application/xml" || mainType === "text/xml") {
24
+ if (isXmlContentType(mainType)) {
28
25
  return false;
29
26
  }
30
27
  if (mainType === "application/x-www-form-urlencoded" || mainType === "multipart/form-data") {
@@ -65,6 +62,20 @@ function isBinaryContentType(contentType) {
65
62
  }
66
63
  return false;
67
64
  }
65
+ function isXmlContentType(contentType) {
66
+ const mainType = contentType?.split(";")[0].trim().toLowerCase();
67
+ return !!mainType && (mainType.endsWith("/xml") || mainType.endsWith("+xml"));
68
+ }
69
+ const statusRanges = [
70
+ "1XX",
71
+ "2XX",
72
+ "3XX",
73
+ "4XX",
74
+ "5XX"
75
+ ];
76
+ function statusRange(status) {
77
+ return statusRanges.find((range) => range === status);
78
+ }
68
79
  function isSuccessStatusCode(statusCode) {
69
80
  if (typeof statusCode === "string") {
70
81
  return /^2(?:\d{2}|xx)$/i.test(statusCode.trim());
@@ -91,10 +102,8 @@ function parseJsonContentType(contentType) {
91
102
  mainType = mainType.substring(0, semicolonIndex).trim();
92
103
  }
93
104
  mainType = mainType.toLowerCase();
94
- if (mainType.endsWith("/json")) {
95
- return mainType.split("/")[1];
96
- } else if (mainType.endsWith("+json")) {
97
- return mainType.split("+")[1];
105
+ if (mainType === "application/json" || mainType.endsWith("+json")) {
106
+ return "json";
98
107
  }
99
108
  return null;
100
109
  }
@@ -130,6 +139,8 @@ export {
130
139
  isStreamingContentType,
131
140
  isSuccessStatusCode,
132
141
  isTextContentType,
133
- parseJsonContentType
142
+ isXmlContentType,
143
+ parseJsonContentType,
144
+ statusRange
134
145
  };
135
146
  //# sourceMappingURL=is.js.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/lib/is.ts"],
4
- "sourcesContent": ["import type { SchemaObject, SchemaObjectType } from 'openapi3-ts/oas31';\n\nexport function coerceTypes(\n schema: SchemaObject,\n excludeNull = true,\n): SchemaObjectType[] {\n const types = Array.isArray(schema.type)\n ? schema.type\n : schema.type\n ? [schema.type]\n : [];\n return excludeNull ? types.filter((type) => type !== 'null') : types;\n}\n\nexport function isStreamingContentType(\n contentType: string | null | undefined,\n): boolean {\n return contentType === 'application/octet-stream';\n}\n\nexport function isBinaryContentType(\n contentType: string | null | undefined,\n): boolean {\n if (!contentType) {\n return false;\n }\n\n let mainType = contentType.trim();\n const semicolonIndex = mainType.indexOf(';');\n if (semicolonIndex !== -1) {\n mainType = mainType.substring(0, semicolonIndex).trim();\n }\n mainType = mainType.toLowerCase();\n\n if (mainType.startsWith('text/')) {\n return false;\n }\n if (mainType.endsWith('/json') || mainType.endsWith('+json')) {\n return false;\n }\n if (mainType.endsWith('/xml') || mainType.endsWith('+xml')) {\n return false;\n }\n if (mainType === 'application/xml' || mainType === 'text/xml') {\n return false;\n }\n if (\n mainType === 'application/x-www-form-urlencoded' ||\n mainType === 'multipart/form-data'\n ) {\n return false;\n }\n\n if (mainType.startsWith('image/')) {\n return true;\n }\n if (mainType.startsWith('audio/')) {\n return true;\n }\n if (mainType.startsWith('video/')) {\n return true;\n }\n if (mainType === 'application/pdf') {\n return true;\n }\n if (mainType === 'application/zip') {\n return true;\n }\n if (mainType === 'application/gzip') {\n return true;\n }\n if (mainType === 'application/x-7z-compressed') {\n return true;\n }\n if (mainType === 'application/x-tar') {\n return true;\n }\n if (mainType.startsWith('application/vnd.openxmlformats-officedocument.')) {\n return true;\n }\n if (mainType.startsWith('application/vnd.ms-')) {\n return true;\n }\n if (mainType === 'application/msword') {\n return true;\n }\n\n return false;\n}\n\nexport function isSuccessStatusCode(statusCode: number | string): boolean {\n if (typeof statusCode === 'string') {\n return /^2(?:\\d{2}|xx)$/i.test(statusCode.trim());\n }\n statusCode = Number(statusCode);\n return statusCode >= 200 && statusCode < 300;\n}\n\nexport function isErrorStatusCode(statusCode: number | string): boolean {\n if (typeof statusCode === 'string') {\n const statusGroup = +statusCode.slice(0, 1);\n const status = Number(statusCode);\n return (\n status < 200 ||\n status >= 300 ||\n statusGroup >= 4 ||\n statusGroup === 0 ||\n statusGroup === 1\n );\n }\n statusCode = Number(statusCode);\n return statusCode < 200 || statusCode >= 300;\n}\n\nexport function parseJsonContentType(contentType: string | null | undefined) {\n if (!contentType) {\n return null;\n }\n\n // 1. Trim whitespace\n let mainType = contentType.trim();\n\n // 2. Remove parameters (anything after the first ';')\n const semicolonIndex = mainType.indexOf(';');\n if (semicolonIndex !== -1) {\n mainType = mainType.substring(0, semicolonIndex).trim(); // Trim potential space before ';'\n }\n\n // 3. Convert to lowercase for case-insensitive comparison\n mainType = mainType.toLowerCase();\n\n if (mainType.endsWith('/json')) {\n return mainType.split('/')[1];\n } else if (mainType.endsWith('+json')) {\n return mainType.split('+')[1];\n }\n return null;\n}\n\nexport function isTextContentType(\n contentType: string | null | undefined,\n): boolean {\n if (!contentType) {\n return false; // Handle null, undefined, or empty string\n }\n\n // 1. Trim whitespace from the input string\n let mainType = contentType.trim();\n // 2. Find the position of the first semicolon (if any) to remove parameters\n const semicolonIndex = mainType.indexOf(';');\n if (semicolonIndex !== -1) {\n // Extract the part before the semicolon and trim potential space\n mainType = mainType.substring(0, semicolonIndex).trim();\n }\n // 3. Convert the main type part to lowercase for case-insensitive comparison\n mainType = mainType.toLowerCase();\n // 4. Compare against the standard text MIME types\n return mainType.startsWith('text/'); // Catch-all for other text/* types\n}\n\n/**\n * Checks if a given content type string represents Server-Sent Events (SSE).\n * Handles case-insensitivity, parameters (like charset), and leading/trailing whitespace.\n *\n * @param contentType The content type string to check (e.g., from a Content-Type header).\n * @returns True if the content type is 'text/event-stream', false otherwise.\n */\nexport function isSseContentType(\n contentType: string | null | undefined,\n): boolean {\n if (!contentType) {\n return false; // Handle null, undefined, or empty string\n }\n\n // 1. Trim whitespace from the input string\n let mainType = contentType.trim();\n\n // 2. Find the position of the first semicolon (if any) to remove parameters\n const semicolonIndex = mainType.indexOf(';');\n if (semicolonIndex !== -1) {\n // Extract the part before the semicolon and trim potential space\n mainType = mainType.substring(0, semicolonIndex).trim();\n }\n\n // 3. Convert the main type part to lowercase for case-insensitive comparison\n mainType = mainType.toLowerCase();\n\n // 4. Compare against the standard SSE MIME type\n return mainType === 'text/event-stream';\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import type { SchemaObject, SchemaObjectType } from 'openapi3-ts/oas31';\n\nexport function coerceTypes(\n schema: SchemaObject,\n excludeNull = true,\n): SchemaObjectType[] {\n const types = Array.isArray(schema.type)\n ? schema.type\n : schema.type\n ? [schema.type]\n : [];\n return excludeNull ? types.filter((type) => type !== 'null') : types;\n}\n\nexport function isStreamingContentType(\n contentType: string | null | undefined,\n): boolean {\n return contentType === 'application/octet-stream';\n}\n\nexport function isBinaryContentType(\n contentType: string | null | undefined,\n): boolean {\n if (!contentType) {\n return false;\n }\n\n let mainType = contentType.trim();\n const semicolonIndex = mainType.indexOf(';');\n if (semicolonIndex !== -1) {\n mainType = mainType.substring(0, semicolonIndex).trim();\n }\n mainType = mainType.toLowerCase();\n\n if (mainType.startsWith('text/')) {\n return false;\n }\n if (mainType.endsWith('/json') || mainType.endsWith('+json')) {\n return false;\n }\n if (isXmlContentType(mainType)) {\n return false;\n }\n if (\n mainType === 'application/x-www-form-urlencoded' ||\n mainType === 'multipart/form-data'\n ) {\n return false;\n }\n\n if (mainType.startsWith('image/')) {\n return true;\n }\n if (mainType.startsWith('audio/')) {\n return true;\n }\n if (mainType.startsWith('video/')) {\n return true;\n }\n if (mainType === 'application/pdf') {\n return true;\n }\n if (mainType === 'application/zip') {\n return true;\n }\n if (mainType === 'application/gzip') {\n return true;\n }\n if (mainType === 'application/x-7z-compressed') {\n return true;\n }\n if (mainType === 'application/x-tar') {\n return true;\n }\n if (mainType.startsWith('application/vnd.openxmlformats-officedocument.')) {\n return true;\n }\n if (mainType.startsWith('application/vnd.ms-')) {\n return true;\n }\n if (mainType === 'application/msword') {\n return true;\n }\n\n return false;\n}\n\n/** Whether `contentType` is an XML media type: `*\\/xml` or `*\\/*+xml`. */\nexport function isXmlContentType(\n contentType: string | null | undefined,\n): boolean {\n const mainType = contentType?.split(';')[0].trim().toLowerCase();\n return !!mainType && (mainType.endsWith('/xml') || mainType.endsWith('+xml'));\n}\n\n/** The status ranges an OpenAPI 3.2 Responses Object may declare. */\nexport type StatusRange = '1XX' | '2XX' | '3XX' | '4XX' | '5XX';\n\nconst statusRanges: readonly StatusRange[] = [\n '1XX',\n '2XX',\n '3XX',\n '4XX',\n '5XX',\n];\n\n/**\n * The range that a Responses Object key declares, or undefined for an explicit\n * code or `default`. OpenAPI 3.2 allows only the uppercase `X` wildcard.\n */\nexport function statusRange(status: string): StatusRange | undefined {\n return statusRanges.find((range) => range === status);\n}\n\nexport function isSuccessStatusCode(statusCode: number | string): boolean {\n if (typeof statusCode === 'string') {\n return /^2(?:\\d{2}|xx)$/i.test(statusCode.trim());\n }\n statusCode = Number(statusCode);\n return statusCode >= 200 && statusCode < 300;\n}\n\nexport function isErrorStatusCode(statusCode: number | string): boolean {\n if (typeof statusCode === 'string') {\n const statusGroup = +statusCode.slice(0, 1);\n const status = Number(statusCode);\n return (\n status < 200 ||\n status >= 300 ||\n statusGroup >= 4 ||\n statusGroup === 0 ||\n statusGroup === 1\n );\n }\n statusCode = Number(statusCode);\n return statusCode < 200 || statusCode >= 300;\n}\n\nexport function parseJsonContentType(contentType: string | null | undefined) {\n if (!contentType) {\n return null;\n }\n\n // 1. Trim whitespace\n let mainType = contentType.trim();\n\n // 2. Remove parameters (anything after the first ';')\n const semicolonIndex = mainType.indexOf(';');\n if (semicolonIndex !== -1) {\n mainType = mainType.substring(0, semicolonIndex).trim(); // Trim potential space before ';'\n }\n\n // 3. Convert to lowercase for case-insensitive comparison\n mainType = mainType.toLowerCase();\n\n // application/json and every media type with the +json suffix (RFC 6839 \u00A73.1)\n // are JSON; text/json and other */json types are not registered as JSON.\n if (mainType === 'application/json' || mainType.endsWith('+json')) {\n return 'json';\n }\n return null;\n}\n\nexport function isTextContentType(\n contentType: string | null | undefined,\n): boolean {\n if (!contentType) {\n return false; // Handle null, undefined, or empty string\n }\n\n // 1. Trim whitespace from the input string\n let mainType = contentType.trim();\n // 2. Find the position of the first semicolon (if any) to remove parameters\n const semicolonIndex = mainType.indexOf(';');\n if (semicolonIndex !== -1) {\n // Extract the part before the semicolon and trim potential space\n mainType = mainType.substring(0, semicolonIndex).trim();\n }\n // 3. Convert the main type part to lowercase for case-insensitive comparison\n mainType = mainType.toLowerCase();\n // 4. Compare against the standard text MIME types\n return mainType.startsWith('text/'); // Catch-all for other text/* types\n}\n\n/**\n * Checks if a given content type string represents Server-Sent Events (SSE).\n * Handles case-insensitivity, parameters (like charset), and leading/trailing whitespace.\n *\n * @param contentType The content type string to check (e.g., from a Content-Type header).\n * @returns True if the content type is 'text/event-stream', false otherwise.\n */\nexport function isSseContentType(\n contentType: string | null | undefined,\n): boolean {\n if (!contentType) {\n return false; // Handle null, undefined, or empty string\n }\n\n // 1. Trim whitespace from the input string\n let mainType = contentType.trim();\n\n // 2. Find the position of the first semicolon (if any) to remove parameters\n const semicolonIndex = mainType.indexOf(';');\n if (semicolonIndex !== -1) {\n // Extract the part before the semicolon and trim potential space\n mainType = mainType.substring(0, semicolonIndex).trim();\n }\n\n // 3. Convert the main type part to lowercase for case-insensitive comparison\n mainType = mainType.toLowerCase();\n\n // 4. Compare against the standard SSE MIME type\n return mainType === 'text/event-stream';\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -1,4 +1,11 @@
1
1
  import type { OpenAPIObject } from 'openapi3-ts/oas31';
2
- export declare function loadSpec(location: string): Promise<OpenAPIObject>;
3
- export declare function loadFile<T>(location: string): Promise<T>;
2
+ /**
3
+ * Loads the document at `location` and every document it references, bundled
4
+ * into one spec whose references are all local. `documents` lists the URI of
5
+ * each document read, `location` first.
6
+ */
7
+ export declare function loadSpec(location: string): Promise<{
8
+ spec: OpenAPIObject;
9
+ documents: string[];
10
+ }>;
4
11
  //# sourceMappingURL=load-spec.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"load-spec.d.ts","sourceRoot":"","sources":["../../../src/lib/loaders/load-spec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAuBvD,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CASvE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAKxD"}
1
+ {"version":3,"file":"load-spec.d.ts","sources":["../../../src/lib/loaders/load-spec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAyBvD;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAiBvD"}
@@ -1,35 +1,30 @@
1
1
  import { resolve } from "node:path";
2
2
  import { pathToFileURL } from "node:url";
3
- import { loadLocal } from "./local-loader.js";
3
+ import { isRemote, loadFile } from "../external-documents.js";
4
+ import { bundleDocument } from "../processing-plugins/bundle-external-refs.js";
5
+ import { registerExternalSecuritySchemes } from "../processing-plugins/resolve-security-scheme-uris.js";
4
6
  import { convertPostmanToOpenAPI } from "./postman/postman-converter.js";
5
- import { loadRemote } from "./remote-loader.js";
6
7
  function isPostman(content) {
7
8
  return typeof content === "object" && content !== null && "info" in content && typeof content.info === "object" && content.info !== null && "item" in content && Array.isArray(content.item) && "schema" in content.info && typeof content.info.schema === "string" && content.info.schema.includes("//schema.getpostman.com/");
8
9
  }
9
10
  async function loadSpec(location) {
10
- let content = await loadFile(location);
11
- if (isPostman(content)) {
12
- content = convertPostmanToOpenAPI(content);
13
- }
14
- const spec = content;
15
- spec.$self ??= documentUri(location);
16
- return spec;
17
- }
18
- function loadFile(location) {
19
- if (isRemote(location)) {
20
- return loadRemote(location);
21
- }
22
- return loadLocal(location);
11
+ const content = await loadFile(location);
12
+ const spec = isPostman(content) ? convertPostmanToOpenAPI(content) : content;
13
+ const document = spec;
14
+ const entry = documentUri(location);
15
+ document.$self ??= entry;
16
+ const documents = /* @__PURE__ */ new Map();
17
+ await bundleDocument(document, documents);
18
+ await registerExternalSecuritySchemes(document, documents);
19
+ return {
20
+ spec,
21
+ documents: [.../* @__PURE__ */ new Set([entry, ...documents.keys()])]
22
+ };
23
23
  }
24
24
  function documentUri(location) {
25
25
  return isRemote(location) || location.startsWith("file:") ? location : pathToFileURL(resolve(location)).href;
26
26
  }
27
- function isRemote(location) {
28
- const [protocol] = location.split(":");
29
- return protocol === "http" || protocol === "https";
30
- }
31
27
  export {
32
- loadFile,
33
28
  loadSpec
34
29
  };
35
30
  //# sourceMappingURL=load-spec.js.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../src/lib/loaders/load-spec.ts"],
4
- "sourcesContent": ["import { resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport type { OpenAPIObject } from 'openapi3-ts/oas31';\n\nimport type { OpenAPIDocument } from '@sdk-it/core';\n\nimport { loadLocal } from './local-loader.js';\nimport { convertPostmanToOpenAPI } from './postman/postman-converter.js';\nimport type { PostmanCollection } from './postman/spec-types.js';\nimport { loadRemote } from './remote-loader.js';\n\nfunction isPostman(content: unknown): content is PostmanCollection {\n return (\n typeof content === 'object' &&\n content !== null &&\n 'info' in content &&\n typeof content.info === 'object' &&\n content.info !== null &&\n 'item' in content &&\n Array.isArray(content.item) &&\n 'schema' in content.info &&\n typeof content.info.schema === 'string' &&\n content.info.schema.includes('//schema.getpostman.com/')\n );\n}\nexport async function loadSpec(location: string): Promise<OpenAPIObject> {\n let content = await loadFile(location);\n if (isPostman(content)) {\n content = convertPostmanToOpenAPI(content);\n }\n const spec = content as OpenAPIDocument;\n // Relative references inside the document resolve against where it came from.\n spec.$self ??= documentUri(location);\n return spec as OpenAPIObject;\n}\n\nexport function loadFile<T>(location: string): Promise<T> {\n if (isRemote(location)) {\n return loadRemote(location);\n }\n return loadLocal(location);\n}\n\nfunction documentUri(location: string) {\n return isRemote(location) || location.startsWith('file:')\n ? location\n : pathToFileURL(resolve(location)).href;\n}\n\nfunction isRemote(location: string) {\n const [protocol] = location.split(':');\n return protocol === 'http' || protocol === 'https';\n}\n"],
5
- "mappings": "AAAA,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAK9B,SAAS,iBAAiB;AAC1B,SAAS,+BAA+B;AAExC,SAAS,kBAAkB;AAE3B,SAAS,UAAU,SAAgD;AACjE,SACE,OAAO,YAAY,YACnB,YAAY,QACZ,UAAU,WACV,OAAO,QAAQ,SAAS,YACxB,QAAQ,SAAS,QACjB,UAAU,WACV,MAAM,QAAQ,QAAQ,IAAI,KAC1B,YAAY,QAAQ,QACpB,OAAO,QAAQ,KAAK,WAAW,YAC/B,QAAQ,KAAK,OAAO,SAAS,0BAA0B;AAE3D;AACA,eAAsB,SAAS,UAA0C;AACvE,MAAI,UAAU,MAAM,SAAS,QAAQ;AACrC,MAAI,UAAU,OAAO,GAAG;AACtB,cAAU,wBAAwB,OAAO;AAAA,EAC3C;AACA,QAAM,OAAO;AAEb,OAAK,UAAU,YAAY,QAAQ;AACnC,SAAO;AACT;AAEO,SAAS,SAAY,UAA8B;AACxD,MAAI,SAAS,QAAQ,GAAG;AACtB,WAAO,WAAW,QAAQ;AAAA,EAC5B;AACA,SAAO,UAAU,QAAQ;AAC3B;AAEA,SAAS,YAAY,UAAkB;AACrC,SAAO,SAAS,QAAQ,KAAK,SAAS,WAAW,OAAO,IACpD,WACA,cAAc,QAAQ,QAAQ,CAAC,EAAE;AACvC;AAEA,SAAS,SAAS,UAAkB;AAClC,QAAM,CAAC,QAAQ,IAAI,SAAS,MAAM,GAAG;AACrC,SAAO,aAAa,UAAU,aAAa;AAC7C;",
4
+ "sourcesContent": ["import { resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport type { OpenAPIObject } from 'openapi3-ts/oas31';\n\nimport type { OpenAPIDocument } from '@sdk-it/core';\n\nimport { type Documents, isRemote, loadFile } from '../external-documents.js';\nimport { bundleDocument } from '../processing-plugins/bundle-external-refs.js';\nimport { registerExternalSecuritySchemes } from '../processing-plugins/resolve-security-scheme-uris.js';\nimport { convertPostmanToOpenAPI } from './postman/postman-converter.js';\nimport type { PostmanCollection } from './postman/spec-types.js';\n\nfunction isPostman(content: unknown): content is PostmanCollection {\n return (\n typeof content === 'object' &&\n content !== null &&\n 'info' in content &&\n typeof content.info === 'object' &&\n content.info !== null &&\n 'item' in content &&\n Array.isArray(content.item) &&\n 'schema' in content.info &&\n typeof content.info.schema === 'string' &&\n content.info.schema.includes('//schema.getpostman.com/')\n );\n}\n\n/**\n * Loads the document at `location` and every document it references, bundled\n * into one spec whose references are all local. `documents` lists the URI of\n * each document read, `location` first.\n */\nexport async function loadSpec(\n location: string,\n): Promise<{ spec: OpenAPIObject; documents: string[] }> {\n const content = await loadFile<OpenAPIObject | PostmanCollection>(location);\n const spec: OpenAPIObject = isPostman(content)\n ? convertPostmanToOpenAPI(content)\n : content;\n const document: OpenAPIDocument = spec;\n const entry = documentUri(location);\n // Relative references inside the document resolve against where it came from.\n document.$self ??= entry;\n const documents: Documents = new Map();\n await bundleDocument(document, documents);\n // A scheme URI that fails stays a URI key; toIR reports it as a diagnostic.\n await registerExternalSecuritySchemes(document, documents);\n return {\n spec,\n documents: [...new Set([entry, ...documents.keys()])],\n };\n}\n\nfunction documentUri(location: string) {\n return isRemote(location) || location.startsWith('file:')\n ? location\n : pathToFileURL(resolve(location)).href;\n}\n"],
5
+ "mappings": "AAAA,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAK9B,SAAyB,UAAU,gBAAgB;AACnD,SAAS,sBAAsB;AAC/B,SAAS,uCAAuC;AAChD,SAAS,+BAA+B;AAGxC,SAAS,UAAU,SAAgD;AACjE,SACE,OAAO,YAAY,YACnB,YAAY,QACZ,UAAU,WACV,OAAO,QAAQ,SAAS,YACxB,QAAQ,SAAS,QACjB,UAAU,WACV,MAAM,QAAQ,QAAQ,IAAI,KAC1B,YAAY,QAAQ,QACpB,OAAO,QAAQ,KAAK,WAAW,YAC/B,QAAQ,KAAK,OAAO,SAAS,0BAA0B;AAE3D;AAOA,eAAsB,SACpB,UACuD;AACvD,QAAM,UAAU,MAAM,SAA4C,QAAQ;AAC1E,QAAM,OAAsB,UAAU,OAAO,IACzC,wBAAwB,OAAO,IAC/B;AACJ,QAAM,WAA4B;AAClC,QAAM,QAAQ,YAAY,QAAQ;AAElC,WAAS,UAAU;AACnB,QAAM,YAAuB,oBAAI,IAAI;AACrC,QAAM,eAAe,UAAU,SAAS;AAExC,QAAM,gCAAgC,UAAU,SAAS;AACzD,SAAO;AAAA,IACL;AAAA,IACA,WAAW,CAAC,GAAG,oBAAI,IAAI,CAAC,OAAO,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC;AAAA,EACtD;AACF;AAEA,SAAS,YAAY,UAAkB;AACrC,SAAO,SAAS,QAAQ,KAAK,SAAS,WAAW,OAAO,IACpD,WACA,cAAc,QAAQ,QAAQ,CAAC,EAAE;AACvC;",
6
6
  "names": []
7
7
  }
@@ -1 +1 @@
1
- {"version":3,"file":"local-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/loaders/local-loader.ts"],"names":[],"mappings":"AAIA,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,gBAY/C"}
1
+ {"version":3,"file":"local-loader.d.ts","sources":["../../../src/lib/loaders/local-loader.ts"],"names":[],"mappings":"AAIA,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,gBAY/C"}
@@ -1,4 +1,4 @@
1
1
  import type { OpenAPIObject } from 'openapi3-ts/oas31';
2
- import type { PostmanCollection } from './spec-types';
2
+ import type { PostmanCollection } from './spec-types.js';
3
3
  export declare function convertPostmanToOpenAPI(collection: PostmanCollection): OpenAPIObject;
4
4
  //# sourceMappingURL=postman-converter.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"postman-converter.d.ts","sourceRoot":"","sources":["../../../../src/lib/loaders/postman/postman-converter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,aAAa,EASd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAQV,iBAAiB,EAOlB,MAAM,cAAc,CAAC;AA2jBtB,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,iBAAiB,GAC5B,aAAa,CA6Bf"}
1
+ {"version":3,"file":"postman-converter.d.ts","sources":["../../../../src/lib/loaders/postman/postman-converter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,aAAa,EASd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAQV,iBAAiB,EAOlB,MAAM,iBAAiB,CAAC;AA0jBzB,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,iBAAiB,GAC5B,aAAa,CA6Bf"}
@@ -1,4 +1,4 @@
1
- import { parse } from "fast-content-type-parse";
1
+ import { MIMEType } from "node:util";
2
2
  function descriptionToText(description) {
3
3
  if (!description) {
4
4
  return void 0;
@@ -299,8 +299,7 @@ function requestToOperation(item, securitySchemes) {
299
299
  (h) => h.key.toLowerCase() === "content-type"
300
300
  );
301
301
  const [contentTypeValue2] = contentTypeIdx2 !== -1 ? headers2.splice(contentTypeIdx2).map((h) => h.value) : [];
302
- let contentType = response.body ? parse(contentTypeValue2 || "application/json")?.type : null;
303
- contentType ??= "application/octet-stream";
302
+ const contentType = response.body ? new MIMEType(contentTypeValue2 || "application/json").essence : "application/octet-stream";
304
303
  return {
305
304
  ...acc,
306
305
  [response.code ?? 200]: {