@lukoweb/apitogo 0.1.23 → 0.1.37

package/src/lib/util/hastToJsx.tsx

@@ -1,67 +1,67 @@
-import { useMDXComponents } from "@mdx-js/react";
-import type { RootContent } from "hast";
-import { toJsxRuntime } from "hast-util-to-jsx-runtime";
-import type {
-  MdxJsxFlowElementHast,
-  MdxJsxTextElementHast,
-} from "mdast-util-mdx-jsx";
-import type { MDXComponents } from "mdx/types.js";
-import { createElement, Fragment, type ReactNode } from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
-
-type MdxJsxElement = MdxJsxFlowElementHast | MdxJsxTextElementHast;
-
-const isMdxJsxElement = (node: RootContent): node is MdxJsxElement =>
-  node.type === "mdxJsxTextElement" || node.type === "mdxJsxFlowElement";
-
-const convertNode = (
-  node: RootContent,
-  components: MDXComponents,
-): ReactNode => {
-  if (isMdxJsxElement(node)) {
-    // Fragment if no name, otherwise look up component or use name as HTML tag
-    const Component = node.name
-      ? (components[node.name] ?? node.name)
-      : Fragment;
-
-    const props = Object.fromEntries(
-      node.attributes.flatMap((attr): [string, unknown][] => {
-        if (attr.type !== "mdxJsxAttribute") return [];
-        const { name, value } = attr;
-
-        if (value == null) return [[name, true]];
-
-        if (["string", "number", "boolean"].includes(typeof value)) {
-          return [[name, value]];
-        }
-
-        return [];
-      }),
-    );
-
-    const children = node.children.map((child) =>
-      convertNode(child, components),
-    );
-
-    return createElement(Component, props, ...children);
-  }
-
-  return toJsxRuntime(node, { Fragment, jsx, jsxs, components });
-};
-
-const HastRichText = ({
-  children,
-  overrides,
-}: {
-  children: RootContent[];
-  overrides?: MDXComponents;
-}) => {
-  const components = useMDXComponents(overrides);
-
-  return children.map((node, i) => (
-    // biome-ignore lint/suspicious/noArrayIndexKey: Stable content from markdown AST
-    <Fragment key={i}>{convertNode(node, components)}</Fragment>
-  ));
-};
-
-export default HastRichText;
+import { useMDXComponents } from "@mdx-js/react";
+import type { RootContent } from "hast";
+import { toJsxRuntime } from "hast-util-to-jsx-runtime";
+import type {
+  MdxJsxFlowElementHast,
+  MdxJsxTextElementHast,
+} from "mdast-util-mdx-jsx";
+import type { MDXComponents } from "mdx/types.js";
+import { createElement, Fragment, type ReactNode } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+type MdxJsxElement = MdxJsxFlowElementHast | MdxJsxTextElementHast;
+
+const isMdxJsxElement = (node: RootContent): node is MdxJsxElement =>
+  node.type === "mdxJsxTextElement" || node.type === "mdxJsxFlowElement";
+
+const convertNode = (
+  node: RootContent,
+  components: MDXComponents,
+): ReactNode => {
+  if (isMdxJsxElement(node)) {
+    // Fragment if no name, otherwise look up component or use name as HTML tag
+    const Component = node.name
+      ? (components[node.name] ?? node.name)
+      : Fragment;
+
+    const props = Object.fromEntries(
+      node.attributes.flatMap((attr): [string, unknown][] => {
+        if (attr.type !== "mdxJsxAttribute") return [];
+        const { name, value } = attr;
+
+        if (value == null) return [[name, true]];
+
+        if (["string", "number", "boolean"].includes(typeof value)) {
+          return [[name, value]];
+        }
+
+        return [];
+      }),
+    );
+
+    const children = node.children.map((child) =>
+      convertNode(child, components),
+    );
+
+    return createElement(Component, props, ...children);
+  }
+
+  return toJsxRuntime(node, { Fragment, jsx, jsxs, components });
+};
+
+const HastRichText = ({
+  children,
+  overrides,
+}: {
+  children: RootContent[];
+  overrides?: MDXComponents;
+}) => {
+  const components = useMDXComponents(overrides);
+
+  return children.map((node, i) => (
+    // biome-ignore lint/suspicious/noArrayIndexKey: Stable content from markdown AST
+    <Fragment key={i}>{convertNode(node, components)}</Fragment>
+  ));
+};
+
+export default HastRichText;

package/src/lib/util/humanFileSize.ts

@@ -1,15 +1,15 @@
-/**
- * Converts a number of bytes to a human-readable file size string
- * @param bytes - The number of bytes (defaults to 0)
- * @returns A formatted string like "1.23 MB" or "456 B"
- */
-export const humanFileSize = (bytes = 0) => {
-  if (bytes === 0) {
-    return "0 B";
-  }
-
-  const exponent = Math.floor(Math.log(bytes) / Math.log(1000.0));
-  const decimal = (bytes / 1000.0 ** exponent).toFixed(exponent ? 2 : 0);
-
-  return `${decimal} ${exponent ? `${"kMGTPEZY"[exponent - 1]}B` : "B"}`;
-};
+/**
+ * Converts a number of bytes to a human-readable file size string
+ * @param bytes - The number of bytes (defaults to 0)
+ * @returns A formatted string like "1.23 MB" or "456 B"
+ */
+export const humanFileSize = (bytes = 0) => {
+  if (bytes === 0) {
+    return "0 B";
+  }
+
+  const exponent = Math.floor(Math.log(bytes) / Math.log(1000.0));
+  const decimal = (bytes / 1000.0 ** exponent).toFixed(exponent ? 2 : 0);
+
+  return `${decimal} ${exponent ? `${"kMGTPEZY"[exponent - 1]}B` : "B"}`;
+};

package/src/lib/util/invariant.ts

@@ -1,52 +1,52 @@
-export default function invariant(
-  // biome-ignore lint/suspicious/noExplicitAny: Allow any type
-  condition: any,
-  // Not providing an inline default argument for message as the result is smaller
-  /**
-   * Can provide a string, or a function that returns a string for cases where
-   * the message takes a fair amount of effort to compute
-   */
-  message?: string | (() => string),
-  options?: ApitogoErrorOptions,
-): asserts condition {
-  if (condition) {
-    return;
-  }
-  // Condition not passed
-
-  const provided: string | undefined =
-    typeof message === "function" ? message() : message;
-
-  throw new ApitogoError(provided ?? "Invariant failed", options);
-}
-
-export type ApitogoErrorOptions = {
-  developerHint?: string;
-  title?: string;
-  cause?: Error;
-};
-
-/**
- * @deprecated Use {@link ApitogoErrorOptions} instead.
- */
-export type ZudokuErrorOptions = ApitogoErrorOptions;
-
-export class ApitogoError extends Error {
-  public developerHint: string | undefined;
-  public title: string | undefined;
-
-  constructor(
-    message: string,
-    { developerHint, title, cause }: ApitogoErrorOptions = {},
-  ) {
-    super(message, { cause });
-    this.name = "ApitogoError";
-    this.title = title;
-    this.developerHint = developerHint;
-  }
-}
-
-/**
- * @deprecated Use {@link ApitogoError} instead.
- */
-export const ZudokuError = ApitogoError;
+export default function invariant(
+  // biome-ignore lint/suspicious/noExplicitAny: Allow any type
+  condition: any,
+  // Not providing an inline default argument for message as the result is smaller
+  /**
+   * Can provide a string, or a function that returns a string for cases where
+   * the message takes a fair amount of effort to compute
+   */
+  message?: string | (() => string),
+  options?: ApitogoErrorOptions,
+): asserts condition {
+  if (condition) {
+    return;
+  }
+  // Condition not passed
+
+  const provided: string | undefined =
+    typeof message === "function" ? message() : message;
+
+  throw new ApitogoError(provided ?? "Invariant failed", options);
+}
+
+export type ApitogoErrorOptions = {
+  developerHint?: string;
+  title?: string;
+  cause?: Error;
+};
+
+/**
+ * @deprecated Use {@link ApitogoErrorOptions} instead.
+ */
+export type ZudokuErrorOptions = ApitogoErrorOptions;
+
+export class ApitogoError extends Error {
+  public developerHint: string | undefined;
+  public title: string | undefined;
+
+  constructor(
+    message: string,
+    { developerHint, title, cause }: ApitogoErrorOptions = {},
+  ) {
+    super(message, { cause });
+    this.name = "ApitogoError";
+    this.title = title;
+    this.developerHint = developerHint;
+  }
+}
+
+/**
+ * @deprecated Use {@link ApitogoError} instead.
+ */
+export const ZudokuError = ApitogoError;

package/src/lib/util/joinUrl.ts

@@ -1,60 +1,60 @@
-// Mostly adapted from https://github.com/moxystudio/js-proper-url-join
-const defaultUrlRegExp = /^(\w+:\/\/[^/?]+)?([^?]*)(\?.*)?$/;
-
-const normalizeParts = (
-  parts: (string | number | null | undefined | false)[],
-): string[] =>
-  parts
-    .filter(
-      (part): part is string | number =>
-        part !== null &&
-        part !== undefined &&
-        part !== false &&
-        (typeof part === "string" || typeof part === "number"),
-    )
-    .map((part) => `${part}`)
-    .filter((part) => part);
-
-interface ParsedParts {
-  prefix: string;
-  pathname: string[];
-  query: string;
-}
-
-const parseParts = (parts: string[]): ParsedParts => {
-  const partsStr = parts.join("/");
-  const [, prefix = "", pathname = "", query = ""] =
-    partsStr.match(defaultUrlRegExp) ?? [];
-
-  return {
-    prefix,
-    pathname: pathname.split("/").filter((part) => part !== ""),
-    query,
-  };
-};
-
-const buildUrl = (parsedParts: ParsedParts): string => {
-  const { prefix, pathname, query } = parsedParts;
-  let url = prefix;
-
-  if (pathname.length > 0) {
-    if (url) {
-      url += "/";
-    } else {
-      url = "/";
-    }
-    url += pathname.join("/");
-  } else if (!url) {
-    url = "/";
-  }
-
-  return url + query;
-};
-
-export const joinUrl = (
-  ...parts: Array<string | number | null | undefined | false>
-): string => {
-  const normalizedParts = normalizeParts(parts);
-  const parsedParts = parseParts(normalizedParts);
-  return buildUrl(parsedParts);
-};
+// Mostly adapted from https://github.com/moxystudio/js-proper-url-join
+const defaultUrlRegExp = /^(\w+:\/\/[^/?]+)?([^?]*)(\?.*)?$/;
+
+const normalizeParts = (
+  parts: (string | number | null | undefined | false)[],
+): string[] =>
+  parts
+    .filter(
+      (part): part is string | number =>
+        part !== null &&
+        part !== undefined &&
+        part !== false &&
+        (typeof part === "string" || typeof part === "number"),
+    )
+    .map((part) => `${part}`)
+    .filter((part) => part);
+
+interface ParsedParts {
+  prefix: string;
+  pathname: string[];
+  query: string;
+}
+
+const parseParts = (parts: string[]): ParsedParts => {
+  const partsStr = parts.join("/");
+  const [, prefix = "", pathname = "", query = ""] =
+    partsStr.match(defaultUrlRegExp) ?? [];
+
+  return {
+    prefix,
+    pathname: pathname.split("/").filter((part) => part !== ""),
+    query,
+  };
+};
+
+const buildUrl = (parsedParts: ParsedParts): string => {
+  const { prefix, pathname, query } = parsedParts;
+  let url = prefix;
+
+  if (pathname.length > 0) {
+    if (url) {
+      url += "/";
+    } else {
+      url = "/";
+    }
+    url += pathname.join("/");
+  } else if (!url) {
+    url = "/";
+  }
+
+  return url + query;
+};
+
+export const joinUrl = (
+  ...parts: Array<string | number | null | undefined | false>
+): string => {
+  const normalizedParts = normalizeParts(parts);
+  const parsedParts = parseParts(normalizedParts);
+  return buildUrl(parsedParts);
+};

package/src/lib/util/logInit.ts

@@ -1,9 +1,9 @@
-import log from "loglevel";
-
-log.setDefaultLevel("silent");
-
-if (import.meta.env.DEV) {
-  log.setLevel("debug");
-} else if (localStorage.getItem("ENABLE_DEBUG_LOGS")) {
-  log.setLevel("debug");
-}
+import log from "loglevel";
+
+log.setDefaultLevel("silent");
+
+if (import.meta.env.DEV) {
+  log.setLevel("debug");
+} else if (localStorage.getItem("ENABLE_DEBUG_LOGS")) {
+  log.setLevel("debug");
+}

package/src/lib/util/objectEntries.ts

@@ -1,5 +1,5 @@
-type ValueOf<T> = T[keyof T];
-type Entries<T> = [keyof T, ValueOf<T>][];
-
-export const objectEntries = <T extends object>(obj: T): Entries<T> =>
-  Object.entries(obj) as Entries<T>;
+type ValueOf<T> = T[keyof T];
+type Entries<T> = [keyof T, ValueOf<T>][];
+
+export const objectEntries = <T extends object>(obj: T): Entries<T> =>
+  Object.entries(obj) as Entries<T>;

package/src/lib/util/os.ts

@@ -1,18 +1,18 @@
-export function getOS(): "apple" | "linux" | "unix" | "windows" | undefined {
-  const notFound = -1;
-  const userAgent = navigator.userAgent.toLowerCase();
-  if (userAgent.indexOf("win") !== notFound) {
-    return "windows";
-  } else if (userAgent.indexOf("mac") !== notFound) {
-    return "apple";
-  } else if (userAgent.indexOf("linux") !== notFound) {
-    return "linux";
-  } else if (userAgent.indexOf("x11") !== notFound) {
-    return "unix";
-  }
-  return;
-}
-
-export function isAppleDevice(): boolean {
-  return getOS() === "apple";
-}
+export function getOS(): "apple" | "linux" | "unix" | "windows" | undefined {
+  const notFound = -1;
+  const userAgent = navigator.userAgent.toLowerCase();
+  if (userAgent.indexOf("win") !== notFound) {
+    return "windows";
+  } else if (userAgent.indexOf("mac") !== notFound) {
+    return "apple";
+  } else if (userAgent.indexOf("linux") !== notFound) {
+    return "linux";
+  } else if (userAgent.indexOf("x11") !== notFound) {
+    return "unix";
+  }
+  return;
+}
+
+export function isAppleDevice(): boolean {
+  return getOS() === "apple";
+}

package/src/lib/util/pastellize.ts

@@ -1,25 +1,25 @@
-const c2n = (c: string) =>
-  Math.abs(
-    Number.isNaN(Number(c))
-      ? c.toLowerCase().charCodeAt(0) - 96
-      : Number.isNaN(Number(c))
-        ? 0
-        : Number(c),
-  );
-const s2n = (s: string) =>
-  s.length > 1
-    ? Number(s.split("").reduce((a, c) => `${c2n(a) + c2n(c)}`))
-    : c2n(s);
-
-export const pastellize = (
-  s: string,
-  options: {
-    saturation?: number;
-    lightness?: number;
-  } = {},
-) => {
-  const hue = (3 * s2n(s) + 2 * s2n(s) + s2n(s)) % 360;
-  const { saturation = 75, lightness = 60 } = options;
-
-  return `${hue}deg ${saturation}% ${lightness}%`;
-};
+const c2n = (c: string) =>
+  Math.abs(
+    Number.isNaN(Number(c))
+      ? c.toLowerCase().charCodeAt(0) - 96
+      : Number.isNaN(Number(c))
+        ? 0
+        : Number(c),
+  );
+const s2n = (s: string) =>
+  s.length > 1
+    ? Number(s.split("").reduce((a, c) => `${c2n(a) + c2n(c)}`))
+    : c2n(s);
+
+export const pastellize = (
+  s: string,
+  options: {
+    saturation?: number;
+    lightness?: number;
+  } = {},
+) => {
+  const hue = (3 * s2n(s) + 2 * s2n(s) + s2n(s)) % 360;
+  const { saturation = 75, lightness = 60 } = options;
+
+  return `${hue}deg ${saturation}% ${lightness}%`;
+};

package/src/lib/util/problemJson.ts

@@ -1,63 +1,63 @@
-/**
- * RFC 9457 - Problem Details for HTTP APIs
- * https://www.rfc-editor.org/rfc/rfc9457.html
- */
-
-const PROBLEM_JSON_CONTENT_TYPE = "application/problem+json";
-const DEFAULT_TYPE = "about:blank";
-
-export type ProblemJson = {
-  type: string;
-  title?: string;
-  status?: number;
-  detail?: string;
-  instance?: string;
-  [extension: string]: unknown;
-};
-
-const parseJsonSafe = async (response: Response) => {
-  try {
-    return await response.json();
-  } catch {
-    return;
-  }
-};
-
-const isProblemJsonContentType = (response: Response) => {
-  const contentType = response.headers.get("content-type");
-  return contentType?.includes(PROBLEM_JSON_CONTENT_TYPE) ?? false;
-};
-
-const normalizeProblemJson = (data: unknown): ProblemJson | undefined => {
-  if (typeof data !== "object" || data === null || Array.isArray(data)) {
-    return;
-  }
-
-  const record = data as Record<string, unknown>;
-
-  return {
-    ...record,
-    type: typeof record.type === "string" ? record.type : DEFAULT_TYPE,
-  } as ProblemJson;
-};
-
-export const getProblemJson = async (
-  response: Response,
-): Promise<ProblemJson | undefined> => {
-  if (!isProblemJsonContentType(response)) {
-    return;
-  }
-
-  const data = await parseJsonSafe(response);
-
-  return normalizeProblemJson(data);
-};
-
-export const throwIfProblemJson = async (response: Response) => {
-  if (!response.ok) {
-    const problem = await getProblemJson(response);
-    if (problem) {
-      throw new Error(problem.detail ?? problem.title ?? "Unknown error");
-    }
-  }
-};
+/**
+ * RFC 9457 - Problem Details for HTTP APIs
+ * https://www.rfc-editor.org/rfc/rfc9457.html
+ */
+
+const PROBLEM_JSON_CONTENT_TYPE = "application/problem+json";
+const DEFAULT_TYPE = "about:blank";
+
+export type ProblemJson = {
+  type: string;
+  title?: string;
+  status?: number;
+  detail?: string;
+  instance?: string;
+  [extension: string]: unknown;
+};
+
+const parseJsonSafe = async (response: Response) => {
+  try {
+    return await response.json();
+  } catch {
+    return;
+  }
+};
+
+const isProblemJsonContentType = (response: Response) => {
+  const contentType = response.headers.get("content-type");
+  return contentType?.includes(PROBLEM_JSON_CONTENT_TYPE) ?? false;
+};
+
+const normalizeProblemJson = (data: unknown): ProblemJson | undefined => {
+  if (typeof data !== "object" || data === null || Array.isArray(data)) {
+    return;
+  }
+
+  const record = data as Record<string, unknown>;
+
+  return {
+    ...record,
+    type: typeof record.type === "string" ? record.type : DEFAULT_TYPE,
+  } as ProblemJson;
+};
+
+export const getProblemJson = async (
+  response: Response,
+): Promise<ProblemJson | undefined> => {
+  if (!isProblemJsonContentType(response)) {
+    return;
+  }
+
+  const data = await parseJsonSafe(response);
+
+  return normalizeProblemJson(data);
+};
+
+export const throwIfProblemJson = async (response: Response) => {
+  if (!response.ok) {
+    const problem = await getProblemJson(response);
+    if (problem) {
+      throw new Error(problem.detail ?? problem.title ?? "Unknown error");
+    }
+  }
+};

package/src/lib/util/readFrontmatter.ts

@@ -1,14 +1,14 @@
-import { readFile } from "node:fs/promises";
-import matter from "gray-matter";
-import { parse, stringify } from "yaml";
-
-export const yaml = {
-  parse: (input: string) => parse(input) ?? {},
-  stringify: (obj: object) => stringify(obj),
-};
-
-export const readFrontmatter = async (filePath: string) => {
-  const content = await readFile(filePath, "utf-8");
-  const normalizedContent = content.replace(/\r\n/g, "\n");
-  return matter(normalizedContent, { engines: { yaml } });
-};
+import { readFile } from "node:fs/promises";
+import matter from "gray-matter";
+import { parse, stringify } from "yaml";
+
+export const yaml = {
+  parse: (input: string) => parse(input) ?? {},
+  stringify: (obj: object) => stringify(obj),
+};
+
+export const readFrontmatter = async (filePath: string) => {
+  const content = await readFile(filePath, "utf-8");
+  const normalizedContent = content.replace(/\r\n/g, "\n");
+  return matter(normalizedContent, { engines: { yaml } });
+};