@lukoweb/apitogo 0.2.23 → 0.2.24

package/src/lib/plugins/openapi/state.ts

@@ -1,36 +1,36 @@
-import { useMemo } from "react";
-import { create } from "zustand";
-import { persist } from "zustand/middleware";
-
-interface SelectedServerState {
-  selectedServer?: string;
-  setSelectedServer: (newServer: string) => void;
-}
-
-export const useSelectedServerStore = create<SelectedServerState>()(
-  persist(
-    (set) => ({
-      selectedServer: undefined,
-      setSelectedServer: (newServer: string) =>
-        set({ selectedServer: newServer }),
-    }),
-    { name: "zudoku-selected-server" },
-  ),
-);
-
-/**
- * Simple wrapper for `useSelectedServerStore` to fall back to first of the provided servers
- */
-export const useSelectedServer = (servers: Array<{ url: string }>) => {
-  const { selectedServer, setSelectedServer } = useSelectedServerStore();
-
-  const finalSelectedServer = useMemo(
-    () =>
-      selectedServer && servers.some((s) => s.url === selectedServer)
-        ? selectedServer
-        : (servers.at(0)?.url ?? ""),
-    [selectedServer, servers],
-  );
-
-  return { selectedServer: finalSelectedServer, setSelectedServer };
-};
+import { useMemo } from "react";
+import { create } from "zustand";
+import { persist } from "zustand/middleware";
+
+interface SelectedServerState {
+  selectedServer?: string;
+  setSelectedServer: (newServer: string) => void;
+}
+
+export const useSelectedServerStore = create<SelectedServerState>()(
+  persist(
+    (set) => ({
+      selectedServer: undefined,
+      setSelectedServer: (newServer: string) =>
+        set({ selectedServer: newServer }),
+    }),
+    { name: "zudoku-selected-server" },
+  ),
+);
+
+/**
+ * Simple wrapper for `useSelectedServerStore` to fall back to first of the provided servers
+ */
+export const useSelectedServer = (servers: Array<{ url: string }>) => {
+  const { selectedServer, setSelectedServer } = useSelectedServerStore();
+
+  const finalSelectedServer = useMemo(
+    () =>
+      selectedServer && servers.some((s) => s.url === selectedServer)
+        ? selectedServer
+        : (servers.at(0)?.url ?? ""),
+    [selectedServer, servers],
+  );
+
+  return { selectedServer: finalSelectedServer, setSelectedServer };
+};

package/src/lib/plugins/openapi/util/buildTagCategories.ts

@@ -1,54 +1,54 @@
-import type { NavigationItem } from "../../../../config/validators/NavigationSchema.js";
-
-type TagGroup = { name: string; tags: string[] };
-
-type BuildTagCategoriesOptions = {
-  tagCategories: Map<string, NavigationItem>;
-  tagGroups: TagGroup[];
-  expandAllTags?: boolean;
-};
-
-// Merges tags and x-tagGroups with the same name into a single sidebar
-// category (mimics OpenAPI 3.2.0 "Enhanced tags" behaviour).
-export const buildTagCategories = ({
-  tagCategories,
-  tagGroups,
-  expandAllTags,
-}: BuildTagCategoriesOptions): NavigationItem[] => {
-  const consumedTags = new Set<string>();
-
-  const groupedCategories = tagGroups.flatMap<NavigationItem>((group) => {
-    // Use a same-named tag as base so its operations appear first
-    const matchingTag = tagCategories.get(group.name);
-    const base = matchingTag?.type === "category" ? matchingTag : undefined;
-
-    if (base) consumedTags.add(group.name);
-
-    // Exclude group's own name to avoid nesting a tag inside itself
-    const childTags = group.tags.flatMap((name) => {
-      if (name === group.name) return [];
-      const tag = tagCategories.get(name);
-      if (!tag) return [];
-      consumedTags.add(name);
-      return tag;
-    });
-
-    if (!base && childTags.length === 0) return [];
-
-    return {
-      ...base,
-      type: "category",
-      label: base?.label ?? group.name,
-      items: [...(base?.items ?? []), ...childTags],
-      collapsible: base?.collapsible ?? true,
-      collapsed: base?.collapsed ?? !expandAllTags,
-    };
-  });
-
-  // Tags not claimed by any group appear as standalone entries
-  const ungroupedCategories = Array.from(tagCategories.entries())
-    .filter(([name]) => !consumedTags.has(name))
-    .map(([, cat]) => cat);
-
-  return [...groupedCategories, ...ungroupedCategories];
-};
+import type { NavigationItem } from "../../../../config/validators/NavigationSchema.js";
+
+type TagGroup = { name: string; tags: string[] };
+
+type BuildTagCategoriesOptions = {
+  tagCategories: Map<string, NavigationItem>;
+  tagGroups: TagGroup[];
+  expandAllTags?: boolean;
+};
+
+// Merges tags and x-tagGroups with the same name into a single sidebar
+// category (mimics OpenAPI 3.2.0 "Enhanced tags" behaviour).
+export const buildTagCategories = ({
+  tagCategories,
+  tagGroups,
+  expandAllTags,
+}: BuildTagCategoriesOptions): NavigationItem[] => {
+  const consumedTags = new Set<string>();
+
+  const groupedCategories = tagGroups.flatMap<NavigationItem>((group) => {
+    // Use a same-named tag as base so its operations appear first
+    const matchingTag = tagCategories.get(group.name);
+    const base = matchingTag?.type === "category" ? matchingTag : undefined;
+
+    if (base) consumedTags.add(group.name);
+
+    // Exclude group's own name to avoid nesting a tag inside itself
+    const childTags = group.tags.flatMap((name) => {
+      if (name === group.name) return [];
+      const tag = tagCategories.get(name);
+      if (!tag) return [];
+      consumedTags.add(name);
+      return tag;
+    });
+
+    if (!base && childTags.length === 0) return [];
+
+    return {
+      ...base,
+      type: "category",
+      label: base?.label ?? group.name,
+      items: [...(base?.items ?? []), ...childTags],
+      collapsible: base?.collapsible ?? true,
+      collapsed: base?.collapsed ?? !expandAllTags,
+    };
+  });
+
+  // Tags not claimed by any group appear as standalone entries
+  const ungroupedCategories = Array.from(tagCategories.entries())
+    .filter(([name]) => !consumedTags.has(name))
+    .map(([, cat]) => cat);
+
+  return [...groupedCategories, ...ungroupedCategories];
+};

package/src/lib/plugins/openapi/util/createHttpSnippet.ts

@@ -1,135 +1,135 @@
-import { HTTPSnippet } from "@zudoku/httpsnippet";
-import type { OperationsFragmentFragment } from "../graphql/graphql.js";
-
-const toFormDataParams = (text?: string) => {
-  const stringify = (v: unknown) =>
-    typeof v === "string" ? v : JSON.stringify(v);
-
-  try {
-    const obj = text && JSON.parse(text);
-    if (typeof obj !== "object" || !obj) return [];
-
-    return Object.entries(obj).flatMap(([name, value]) => {
-      const values = Array.isArray(value) ? value : [value];
-      return values.map((v) => ({ name, value: stringify(v) }));
-    });
-  } catch {
-    return [];
-  }
-};
-
-export const createHttpSnippet = ({
-  operation,
-  selectedServer,
-  exampleBody,
-}: {
-  operation: OperationsFragmentFragment;
-  selectedServer: string;
-  exampleBody: {
-    mimeType: string;
-    text?: string;
-  };
-}) => {
-  const isMultipart =
-    exampleBody.mimeType === "multipart/form-data" ||
-    exampleBody.mimeType === "application/x-www-form-urlencoded";
-
-  const postData = isMultipart
-    ? {
-        mimeType: exampleBody.mimeType,
-        params: toFormDataParams(exampleBody.text),
-      }
-    : exampleBody;
-
-  return new HTTPSnippet({
-    method: operation.method.toUpperCase(),
-    url:
-      selectedServer + operation.path.replaceAll("{", ":").replaceAll("}", ""),
-    postData,
-    headers: [
-      ...(exampleBody.text
-        ? [{ name: "Content-Type", value: exampleBody.mimeType }]
-        : []),
-      ...(operation.parameters
-        ?.filter((p) => p.in === "header" && p.required === true)
-        .map((p) => ({
-          name: p.name,
-          value:
-            p.schema?.default ??
-            p.examples?.find((x) => x.value)?.value ??
-            (p.schema?.type === "string"
-              ? "<string>"
-              : p.schema?.type === "number" || p.schema?.type === "integer"
-                ? "<number>"
-                : p.schema?.type === "boolean"
-                  ? "<bool>"
-                  : "<value>"),
-        })) ?? []),
-    ],
-    queryString:
-      operation.parameters
-        ?.filter((p) => p.in === "query" && p.required === true)
-        .map((p) => ({
-          name: p.name,
-          value:
-            p.schema?.default ??
-            p.examples?.find((x) => x.value)?.value ??
-            (p.schema?.type === "string"
-              ? "<string>"
-              : p.schema?.type === "number" || p.schema?.type === "integer"
-                ? "<number>"
-                : p.schema?.type === "boolean"
-                  ? "<bool>"
-                  : "<value>"),
-        })) ?? [],
-    httpVersion: "",
-    cookies: [],
-    headersSize: 0,
-    bodySize: 0,
-  });
-};
-
-export const getConverted = (snippet: HTTPSnippet, option: string) => {
-  // biome-ignore lint/suspicious/noExplicitAny: Allow any type
-  let converted: any;
-  switch (option) {
-    case "shell":
-      converted = snippet.convert("shell", "curl");
-      break;
-    case "js":
-      converted = snippet.convert("javascript", "fetch");
-      break;
-    case "python":
-      converted = snippet.convert("python", "requests");
-      break;
-    case "java":
-      converted = snippet.convert("java", "okhttp");
-      break;
-    case "go":
-      converted = snippet.convert("go", "native");
-      break;
-    case "csharp":
-      converted = snippet.convert("csharp", "httpclient");
-      break;
-    case "kotlin":
-      converted = snippet.convert("kotlin", "okhttp");
-      break;
-    case "objc":
-      converted = snippet.convert("objc", "nsurlsession");
-      break;
-    case "php":
-      converted = snippet.convert("php", "http2");
-      break;
-    case "ruby":
-      converted = snippet.convert("ruby");
-      break;
-    case "swift":
-      converted = snippet.convert("swift");
-      break;
-    default:
-      converted = snippet.convert("shell");
-      break;
-  }
-
-  return converted ? converted[0] : "";
-};
+import { HTTPSnippet } from "@zudoku/httpsnippet";
+import type { OperationsFragmentFragment } from "../graphql/graphql.js";
+
+const toFormDataParams = (text?: string) => {
+  const stringify = (v: unknown) =>
+    typeof v === "string" ? v : JSON.stringify(v);
+
+  try {
+    const obj = text && JSON.parse(text);
+    if (typeof obj !== "object" || !obj) return [];
+
+    return Object.entries(obj).flatMap(([name, value]) => {
+      const values = Array.isArray(value) ? value : [value];
+      return values.map((v) => ({ name, value: stringify(v) }));
+    });
+  } catch {
+    return [];
+  }
+};
+
+export const createHttpSnippet = ({
+  operation,
+  selectedServer,
+  exampleBody,
+}: {
+  operation: OperationsFragmentFragment;
+  selectedServer: string;
+  exampleBody: {
+    mimeType: string;
+    text?: string;
+  };
+}) => {
+  const isMultipart =
+    exampleBody.mimeType === "multipart/form-data" ||
+    exampleBody.mimeType === "application/x-www-form-urlencoded";
+
+  const postData = isMultipart
+    ? {
+        mimeType: exampleBody.mimeType,
+        params: toFormDataParams(exampleBody.text),
+      }
+    : exampleBody;
+
+  return new HTTPSnippet({
+    method: operation.method.toUpperCase(),
+    url:
+      selectedServer + operation.path.replaceAll("{", ":").replaceAll("}", ""),
+    postData,
+    headers: [
+      ...(exampleBody.text
+        ? [{ name: "Content-Type", value: exampleBody.mimeType }]
+        : []),
+      ...(operation.parameters
+        ?.filter((p) => p.in === "header" && p.required === true)
+        .map((p) => ({
+          name: p.name,
+          value:
+            p.schema?.default ??
+            p.examples?.find((x) => x.value)?.value ??
+            (p.schema?.type === "string"
+              ? "<string>"
+              : p.schema?.type === "number" || p.schema?.type === "integer"
+                ? "<number>"
+                : p.schema?.type === "boolean"
+                  ? "<bool>"
+                  : "<value>"),
+        })) ?? []),
+    ],
+    queryString:
+      operation.parameters
+        ?.filter((p) => p.in === "query" && p.required === true)
+        .map((p) => ({
+          name: p.name,
+          value:
+            p.schema?.default ??
+            p.examples?.find((x) => x.value)?.value ??
+            (p.schema?.type === "string"
+              ? "<string>"
+              : p.schema?.type === "number" || p.schema?.type === "integer"
+                ? "<number>"
+                : p.schema?.type === "boolean"
+                  ? "<bool>"
+                  : "<value>"),
+        })) ?? [],
+    httpVersion: "",
+    cookies: [],
+    headersSize: 0,
+    bodySize: 0,
+  });
+};
+
+export const getConverted = (snippet: HTTPSnippet, option: string) => {
+  // biome-ignore lint/suspicious/noExplicitAny: Allow any type
+  let converted: any;
+  switch (option) {
+    case "shell":
+      converted = snippet.convert("shell", "curl");
+      break;
+    case "js":
+      converted = snippet.convert("javascript", "fetch");
+      break;
+    case "python":
+      converted = snippet.convert("python", "requests");
+      break;
+    case "java":
+      converted = snippet.convert("java", "okhttp");
+      break;
+    case "go":
+      converted = snippet.convert("go", "native");
+      break;
+    case "csharp":
+      converted = snippet.convert("csharp", "httpclient");
+      break;
+    case "kotlin":
+      converted = snippet.convert("kotlin", "okhttp");
+      break;
+    case "objc":
+      converted = snippet.convert("objc", "nsurlsession");
+      break;
+    case "php":
+      converted = snippet.convert("php", "http2");
+      break;
+    case "ruby":
+      converted = snippet.convert("ruby");
+      break;
+    case "swift":
+      converted = snippet.convert("swift");
+      break;
+    default:
+      converted = snippet.convert("shell");
+      break;
+  }
+
+  return converted ? converted[0] : "";
+};

package/src/lib/plugins/openapi/util/createNavigationCategory.tsx

@@ -1,39 +1,39 @@
-import type { NavigationItem } from "../../../../config/validators/NavigationSchema.js";
-import type { OperationResult } from "../index.js";
-import { MethodColorMap } from "./methodColorMap.js";
-
-export const createNavigationCategory = ({
-  label,
-  path,
-  operations,
-  collapsible,
-  collapsed,
-}: {
-  label: string;
-  path: string;
-  operations: OperationResult[];
-  collapsible?: boolean;
-  collapsed?: boolean;
-}): NavigationItem => ({
-  type: "category",
-  label,
-  link: {
-    type: "doc" as const,
-    path,
-    file: path,
-    label,
-  },
-  collapsible,
-  collapsed,
-  items: operations.map((operation) => ({
-    type: "link" as const,
-    label: operation.summary ?? operation.path,
-    to: `${path}#${operation.slug}`,
-    badge: {
-      label: operation.method,
-      // biome-ignore lint/style/noNonNullAssertion: is guaranteed to be defined
-      color: MethodColorMap[operation.method.toLowerCase()]!,
-      invert: true,
-    },
-  })),
-});
+import type { NavigationItem } from "../../../../config/validators/NavigationSchema.js";
+import type { OperationResult } from "../index.js";
+import { MethodColorMap } from "./methodColorMap.js";
+
+export const createNavigationCategory = ({
+  label,
+  path,
+  operations,
+  collapsible,
+  collapsed,
+}: {
+  label: string;
+  path: string;
+  operations: OperationResult[];
+  collapsible?: boolean;
+  collapsed?: boolean;
+}): NavigationItem => ({
+  type: "category",
+  label,
+  link: {
+    type: "doc" as const,
+    path,
+    file: path,
+    label,
+  },
+  collapsible,
+  collapsed,
+  items: operations.map((operation) => ({
+    type: "link" as const,
+    label: operation.summary ?? operation.path,
+    to: `${path}#${operation.slug}`,
+    badge: {
+      label: operation.method,
+      // biome-ignore lint/style/noNonNullAssertion: is guaranteed to be defined
+      color: MethodColorMap[operation.method.toLowerCase()]!,
+      invert: true,
+    },
+  })),
+});