@sdk-it/spec 0.21.0 → 0.22.0

package/dist/lib/sidebar.js

@@ -1,81 +0,0 @@
-import { camelcase } from "stringcase";
-import { forEachOperation } from "./operation";
-function createOAIMeta(spec) {
-  spec.paths ??= {};
-  const navigationGroups = {
-    default: { id: "default", title: "General" }
-  };
-  const groups = {};
-  forEachOperation({ spec }, (entry, operation) => {
-    const tag = entry.tag;
-    groups[tag] ??= {
-      id: tag,
-      title: tag,
-      description: spec.tags?.find((t) => t.name === tag)?.description,
-      navigationGroup: "default",
-      sections: []
-    };
-    groups[tag].sections.push({
-      type: "endpoint",
-      key: operation.operationId,
-      path: entry.path
-    });
-  });
-  return {
-    groups: Object.values(groups),
-    navigationGroups: Object.values(navigationGroups)
-  };
-}
-function getOperationById(spec, operationId) {
-  let operation;
-  forEachOperation({ spec }, (entry, op) => {
-    if (op.operationId === operationId) {
-      operation = op;
-    }
-  });
-  return operation;
-}
-function toSidebar(spec) {
-  const openapi = spec;
-  const sidebar = [];
-  const oaiMeta = openapi["x-oaiMeta"] ?? createOAIMeta(spec);
-  for (const navGroup of oaiMeta.navigationGroups) {
-    const group = oaiMeta.groups.filter(
-      (group2) => group2.navigationGroup === navGroup.id
-    );
-    if (group.length === 0)
-      continue;
-    const groupItems = [];
-    for (const item of group) {
-      const subitems = (item.sections ?? []).filter((it) => it.type === "endpoint").map((section) => {
-        const operation = getOperationById(spec, section.key);
-        const title = operation?.["x-oaiMeta"]?.name || operation?.summary || section.key;
-        return {
-          id: section.key,
-          title,
-          url: `${item.id}/${camelcase(section.key)}`
-        };
-      });
-      if (subitems.length === 0)
-        continue;
-      groupItems.push({
-        id: item.id,
-        title: item.title,
-        url: `/${item.id}`,
-        description: item.description,
-        items: subitems
-      });
-    }
-    if (groupItems.length === 0)
-      continue;
-    sidebar.push({
-      category: navGroup.title,
-      items: groupItems
-    });
-  }
-  return sidebar;
-}
-export {
-  toSidebar
-};
-//# sourceMappingURL=sidebar.js.map

package/dist/lib/sidebar.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/lib/sidebar.ts"],
-  "sourcesContent": ["import type { OpenAPIObject, OperationObject } from 'openapi3-ts/oas31';\nimport { camelcase } from 'stringcase';\n\nimport { type TunedOperationObject, forEachOperation } from './operation';\n\nexport type ChildNavItem = {\n  id: string;\n  title: string;\n  url: string;\n};\n\nexport type NavItem = {\n  id: string;\n  title: string;\n  description?: string;\n  url: string;\n  items?: ChildNavItem[];\n};\n\nexport type CategoryItem = {\n  category: string;\n  description?: string;\n  items: NavItem[];\n};\n\nexport type SidebarData = CategoryItem[];\n\nfunction createOAIMeta(spec: OpenAPIObject): XOaiMeta {\n  spec.paths ??= {};\n  const navigationGroups: Record<string, NavigationGroup> = {\n    default: { id: 'default', title: 'General' },\n  };\n  const groups: Record<string, Group> = {};\n\n  forEachOperation({ spec }, (entry, operation) => {\n    const tag = entry.tag;\n    groups[tag] ??= {\n      id: tag,\n      title: tag,\n      description: spec.tags?.find((t) => t.name === tag)?.description,\n      navigationGroup: 'default',\n      sections: [],\n    };\n    groups[tag].sections.push({\n      type: 'endpoint',\n      key: operation.operationId,\n      path: entry.path,\n    });\n  });\n\n  return {\n    groups: Object.values(groups),\n    navigationGroups: Object.values(navigationGroups),\n  };\n}\n\nfunction getOperationById(spec: OpenAPIObject, operationId: string) {\n  let operation: TunedOperationObject | undefined;\n  forEachOperation({ spec }, (entry, op) => {\n    if (op.operationId === operationId) {\n      operation = op;\n    }\n  });\n  return operation;\n}\n\nexport function toSidebar(spec: OpenAPIObject) {\n  const openapi: OpenAPIObject & { 'x-oaiMeta': XOaiMeta } = spec as any;\n  const sidebar: SidebarData = [];\n  const oaiMeta = openapi['x-oaiMeta'] ?? createOAIMeta(spec);\n  for (const navGroup of oaiMeta.navigationGroups) {\n    const group = oaiMeta.groups.filter(\n      (group) => group.navigationGroup === navGroup.id,\n    );\n    if (group.length === 0) continue;\n    const groupItems: NavItem[] = [];\n    for (const item of group) {\n      const subitems: ChildNavItem[] = (item.sections ?? [])\n        .filter((it) => it.type === 'endpoint')\n        .map((section) => {\n          const operation = getOperationById(spec, section.key);\n          const title =\n            operation?.['x-oaiMeta']?.name || operation?.summary || section.key;\n          return {\n            id: section.key,\n            title,\n            url: `${item.id}/${camelcase(section.key)}`,\n          };\n        });\n      if (subitems.length === 0) continue;\n      groupItems.push({\n        id: item.id,\n        title: item.title,\n        url: `/${item.id}`,\n        description: item.description,\n        items: subitems,\n      });\n    }\n    if (groupItems.length === 0) continue;\n    sidebar.push({\n      category: navGroup.title,\n      items: groupItems,\n    });\n  }\n  return sidebar;\n}\n\nexport interface XOaiMeta {\n  navigationGroups: NavigationGroup[];\n  groups: Group[];\n}\n\nexport interface Group {\n  id: string;\n  title: string;\n  description?: string;\n  navigationGroup: string;\n  sections: Section[];\n  beta?: boolean;\n  legacy?: boolean;\n}\n\nexport interface Section {\n  type: 'endpoint' | 'object';\n  key: string;\n  path: string;\n}\n\nexport interface NavigationGroup {\n  id: string;\n  title: string;\n  beta?: boolean;\n}\n"],
-  "mappings": "AACA,SAAS,iBAAiB;AAE1B,SAAoC,wBAAwB;AAwB5D,SAAS,cAAc,MAA+B;AACpD,OAAK,UAAU,CAAC;AAChB,QAAM,mBAAoD;AAAA,IACxD,SAAS,EAAE,IAAI,WAAW,OAAO,UAAU;AAAA,EAC7C;AACA,QAAM,SAAgC,CAAC;AAEvC,mBAAiB,EAAE,KAAK,GAAG,CAAC,OAAO,cAAc;AAC/C,UAAM,MAAM,MAAM;AAClB,WAAO,GAAG,MAAM;AAAA,MACd,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,aAAa,KAAK,MAAM,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,GAAG;AAAA,MACrD,iBAAiB;AAAA,MACjB,UAAU,CAAC;AAAA,IACb;AACA,WAAO,GAAG,EAAE,SAAS,KAAK;AAAA,MACxB,MAAM;AAAA,MACN,KAAK,UAAU;AAAA,MACf,MAAM,MAAM;AAAA,IACd,CAAC;AAAA,EACH,CAAC;AAED,SAAO;AAAA,IACL,QAAQ,OAAO,OAAO,MAAM;AAAA,IAC5B,kBAAkB,OAAO,OAAO,gBAAgB;AAAA,EAClD;AACF;AAEA,SAAS,iBAAiB,MAAqB,aAAqB;AAClE,MAAI;AACJ,mBAAiB,EAAE,KAAK,GAAG,CAAC,OAAO,OAAO;AACxC,QAAI,GAAG,gBAAgB,aAAa;AAClC,kBAAY;AAAA,IACd;AAAA,EACF,CAAC;AACD,SAAO;AACT;AAEO,SAAS,UAAU,MAAqB;AAC7C,QAAM,UAAqD;AAC3D,QAAM,UAAuB,CAAC;AAC9B,QAAM,UAAU,QAAQ,WAAW,KAAK,cAAc,IAAI;AAC1D,aAAW,YAAY,QAAQ,kBAAkB;AAC/C,UAAM,QAAQ,QAAQ,OAAO;AAAA,MAC3B,CAACA,WAAUA,OAAM,oBAAoB,SAAS;AAAA,IAChD;AACA,QAAI,MAAM,WAAW;AAAG;AACxB,UAAM,aAAwB,CAAC;AAC/B,eAAW,QAAQ,OAAO;AACxB,YAAM,YAA4B,KAAK,YAAY,CAAC,GACjD,OAAO,CAAC,OAAO,GAAG,SAAS,UAAU,EACrC,IAAI,CAAC,YAAY;AAChB,cAAM,YAAY,iBAAiB,MAAM,QAAQ,GAAG;AACpD,cAAM,QACJ,YAAY,WAAW,GAAG,QAAQ,WAAW,WAAW,QAAQ;AAClE,eAAO;AAAA,UACL,IAAI,QAAQ;AAAA,UACZ;AAAA,UACA,KAAK,GAAG,KAAK,EAAE,IAAI,UAAU,QAAQ,GAAG,CAAC;AAAA,QAC3C;AAAA,MACF,CAAC;AACH,UAAI,SAAS,WAAW;AAAG;AAC3B,iBAAW,KAAK;AAAA,QACd,IAAI,KAAK;AAAA,QACT,OAAO,KAAK;AAAA,QACZ,KAAK,IAAI,KAAK,EAAE;AAAA,QAChB,aAAa,KAAK;AAAA,QAClB,OAAO;AAAA,MACT,CAAC;AAAA,IACH;AACA,QAAI,WAAW,WAAW;AAAG;AAC7B,YAAQ,KAAK;AAAA,MACX,UAAU,SAAS;AAAA,MACnB,OAAO;AAAA,IACT,CAAC;AAAA,EACH;AACA,SAAO;AACT;",
-  "names": ["group"]
-}