@kubb/core 4.23.0 → 4.24.1

package/dist/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","names":["#buffer","dns","#items","#orderItems","#addParams","camelCase","item","path","timeout"],"sources":["../src/utils/buildJSDoc.ts","../src/utils/Cache.ts","../src/utils/checkOnlineStatus.ts","../src/utils/FunctionParams.ts","../src/utils/getNestedAccessor.ts","../src/utils/promise.ts","../src/utils/renderTemplate.ts","../src/utils/resolveModuleSource.ts","../src/utils/serializePluginOptions.ts","../src/utils/timeout.ts"],"sourcesContent":["/**\n * Builds a JSDoc comment block with custom indentation.\n * @param comments - Array of comment strings to include in the JSDoc block\n * @param options - Configuration options for formatting\n * @returns Formatted JSDoc string or fallback string if no comments\n */\nexport function buildJSDoc(\n  comments: Array<string>,\n  options: {\n    /**\n     * String to use for indenting each line of the JSDoc comment\n     * @default '   * ' (3 spaces + asterisk + space)\n     */\n    indent?: string\n    /**\n     * String to append after the closing JSDoc tag\n     * @default '\\n  ' (newline + 2 spaces)\n     */\n    suffix?: string\n    /**\n     * String to return when there are no comments\n     * @default '  ' (2 spaces)\n     */\n    fallback?: string\n  } = {},\n): string {\n  const { indent = '   * ', suffix = '\\n  ', fallback = '  ' } = options\n\n  if (comments.length === 0) {\n    return fallback\n  }\n\n  return `/**\\n${comments.map((c) => `${indent}${c}`).join('\\n')}\\n   */${suffix}`\n}\n","export class Cache<T> {\n  #buffer = new Map<string, T>()\n\n  async get(key: string): Promise<T | null> {\n    return this.#buffer.get(key) ?? null\n  }\n\n  async set(key: string, value: T): Promise<void> {\n    this.#buffer.set(key, value)\n  }\n\n  async delete(key: string): Promise<void> {\n    this.#buffer.delete(key)\n  }\n\n  async clear(): Promise<void> {\n    this.#buffer.clear()\n  }\n\n  async keys(): Promise<string[]> {\n    return [...this.#buffer.keys()]\n  }\n\n  async values(): Promise<T[]> {\n    return [...this.#buffer.values()]\n  }\n\n  async flush(): Promise<void> {\n    // No-op for base cache\n  }\n}\n","import dns from 'node:dns'\n\n/**\n * Check if the system has internet connectivity\n * Uses DNS lookup to well-known stable domains as a lightweight connectivity test\n */\nexport async function isOnline(): Promise<boolean> {\n  const testDomains = [\n    'dns.google.com', // Google Public DNS\n    'cloudflare.com', // Cloudflare\n    'one.one.one.one', // Cloudflare DNS\n  ]\n\n  for (const domain of testDomains) {\n    try {\n      await dns.promises.resolve(domain)\n      return true\n    } catch {\n      // Try next domain\n    }\n  }\n\n  return false\n}\n\n/**\n * Execute a function only if online, otherwise silently skip\n */\nexport async function executeIfOnline<T>(fn: () => Promise<T>): Promise<T | null> {\n  const online = await isOnline()\n  if (!online) {\n    return null\n  }\n\n  try {\n    return await fn()\n  } catch {\n    return null\n  }\n}\n","import { orderBy } from 'natural-orderby'\n\nimport { camelCase } from '../transformers/casing.ts'\n\ntype FunctionParamsASTWithoutType = {\n  name?: string\n  type?: string\n  /**\n   * @default true\n   */\n  required?: boolean\n  /**\n   * @default true\n   */\n  enabled?: boolean\n  default?: string\n}\n\ntype FunctionParamsASTWithType = {\n  name?: never\n  type: string\n  /**\n   * @default true\n   */\n  required?: boolean\n  /**\n   * @default true\n   */\n  enabled?: boolean\n  default?: string\n}\n/**\n * @deprecated\n */\nexport type FunctionParamsAST = FunctionParamsASTWithoutType | FunctionParamsASTWithType\n\n/**\n * @deprecated\n */\nexport class FunctionParams {\n  #items: Array<FunctionParamsAST | FunctionParamsAST[]> = []\n  constructor() {\n    return this\n  }\n\n  get items(): FunctionParamsAST[] {\n    return this.#items.flat()\n  }\n\n  add(item: FunctionParamsAST | Array<FunctionParamsAST | FunctionParamsAST[] | undefined> | undefined): FunctionParams {\n    if (!item) {\n      return this\n    }\n\n    if (Array.isArray(item)) {\n      item.filter(Boolean).forEach((it) => {\n        this.#items.push(it)\n      })\n      return this\n    }\n    this.#items.push(item)\n\n    return this\n  }\n  static #orderItems(items: Array<FunctionParamsAST | FunctionParamsAST[]>) {\n    return orderBy(\n      items.filter(Boolean),\n      [\n        (v) => {\n          if (Array.isArray(v)) {\n            return undefined\n          }\n          return !v.default\n        },\n        (v) => {\n          if (Array.isArray(v)) {\n            return undefined\n          }\n          return v.required ?? true\n        },\n      ],\n      ['desc', 'desc'],\n    )\n  }\n\n  static #addParams(acc: string[], item: FunctionParamsAST) {\n    const { enabled = true, name, type, required = true, ...rest } = item\n\n    if (!enabled) {\n      return acc\n    }\n\n    if (!name) {\n      // when name is not se we uses TypeScript generics\n      acc.push(`${type}${rest.default ? ` = ${rest.default}` : ''}`)\n\n      return acc\n    }\n    // TODO check whey we still need the camelcase here\n    const parameterName = name.startsWith('{') ? name : camelCase(name)\n\n    if (type) {\n      if (required) {\n        acc.push(`${parameterName}: ${type}${rest.default ? ` = ${rest.default}` : ''}`)\n      } else {\n        acc.push(`${parameterName}?: ${type}`)\n      }\n    } else {\n      acc.push(`${parameterName}`)\n    }\n\n    return acc\n  }\n\n  static toObject(items: FunctionParamsAST[]): FunctionParamsAST {\n    let type: string[] = []\n    let name: string[] = []\n\n    const enabled = items.every((item) => item.enabled) ? items.at(0)?.enabled : true\n    const required = items.every((item) => item.required) ?? true\n\n    items.forEach((item) => {\n      name = FunctionParams.#addParams(name, { ...item, type: undefined })\n      if (items.some((item) => item.type)) {\n        type = FunctionParams.#addParams(type, item)\n      }\n    })\n\n    return {\n      name: `{ ${name.join(', ')} }`,\n      type: type.length ? `{ ${type.join('; ')} }` : undefined,\n      enabled,\n      required,\n    }\n  }\n\n  toObject(): FunctionParamsAST {\n    const items = FunctionParams.#orderItems(this.#items).flat()\n\n    return FunctionParams.toObject(items)\n  }\n\n  static toString(items: (FunctionParamsAST | FunctionParamsAST[])[]): string {\n    const sortedData = FunctionParams.#orderItems(items)\n\n    return sortedData\n      .reduce((acc, item) => {\n        if (Array.isArray(item)) {\n          if (item.length <= 0) {\n            return acc\n          }\n          const subItems = FunctionParams.#orderItems(item) as FunctionParamsAST[]\n          const objectItem = FunctionParams.toObject(subItems)\n\n          return FunctionParams.#addParams(acc, objectItem)\n        }\n\n        return FunctionParams.#addParams(acc, item)\n      }, [] as string[])\n      .join(', ')\n  }\n\n  toString(): string {\n    const items = FunctionParams.#orderItems(this.#items)\n\n    return FunctionParams.toString(items)\n  }\n}\n","/**\n * Converts a param path (string with dot notation or array of strings) to a JavaScript accessor expression.\n * @param param - The param path, e.g., 'pagination.next.id' or ['pagination', 'next', 'id']\n * @param accessor - The base accessor, e.g., 'lastPage' or 'firstPage'\n * @returns A JavaScript accessor expression, e.g., \"lastPage?.['pagination']?.['next']?.['id']\", or undefined if param is empty\n *\n * @example\n * ```ts\n * getNestedAccessor('pagination.next.id', 'lastPage')\n * // returns: \"lastPage?.['pagination']?.['next']?.['id']\"\n *\n * getNestedAccessor(['pagination', 'next', 'id'], 'lastPage')\n * // returns: \"lastPage?.['pagination']?.['next']?.['id']\"\n *\n * getNestedAccessor('', 'lastPage')\n * // returns: undefined\n * ```\n */\nexport function getNestedAccessor(param: string | string[], accessor: string): string | undefined {\n  const parts = Array.isArray(param) ? param : param.split('.')\n  if (parts.length === 0 || (parts.length === 1 && parts[0] === '')) {\n    return undefined\n  }\n  return parts.reduce((acc, part) => `${acc}?.['${part}']`, accessor)\n}\n","import type { PossiblePromise } from './types.ts'\n\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n  return !!result && typeof (result as Promise<unknown>)?.then === 'function'\n}\n\nexport function isPromiseFulfilledResult<T = unknown>(result: PromiseSettledResult<unknown>): result is PromiseFulfilledResult<T> {\n  return result.status === 'fulfilled'\n}\n\nexport function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & { reason: T } {\n  return result.status === 'rejected'\n}\n","export function renderTemplate<TData extends Record<string, unknown> = Record<string, unknown>>(template: string, data: TData | undefined = undefined): string {\n  if (!data || !Object.keys(data).length) {\n    return template.replace(/{{(.*?)}}/g, '')\n  }\n\n  const matches = template.match(/{{(.*?)}}/g)\n\n  return (\n    matches?.reduce((prev, curr) => {\n      const index = curr.split(/{{|}}/).filter(Boolean)[0]?.trim()\n      if (index === undefined) {\n        return prev\n      }\n      const value = data[index]\n\n      if (value === undefined) {\n        return prev\n      }\n\n      return prev\n        .replace(curr, () => {\n          if (typeof value === 'boolean') {\n            return `${value.toString()}` || 'false'\n          }\n\n          return (value as string) || ''\n        })\n        .trim()\n    }, template) || ''\n  )\n}\n","import { readFileSync } from 'node:fs'\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport createJiti from 'jiti'\n\nexport function resolveModuleSource(pkgName: string) {\n  const parentURL = import.meta.url\n  const jiti = createJiti(parentURL)\n\n  const resolved = jiti.esmResolve(pkgName, parentURL)\n  const filePath = resolved.startsWith('file:') ? fileURLToPath(resolved) : resolved\n  const source = readFileSync(filePath, { encoding: 'utf-8' })\n  const ext = path.extname(filePath)\n  return { path: filePath, source, ext } as const\n}\n","/**\n * Serialize plugin options for safe JSON transport.\n * Strips functions, symbols, and undefined values recursively.\n */\nexport function serializePluginOptions(options: unknown): unknown {\n  if (options === null || options === undefined) {\n    return {}\n  }\n  if (typeof options !== 'object') {\n    return options\n  }\n  if (Array.isArray(options)) {\n    return options.map(serializePluginOptions)\n  }\n\n  const serialized: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(options)) {\n    if (typeof value === 'function' || typeof value === 'symbol' || value === undefined) {\n      continue\n    }\n    if (typeof value === 'object' && value !== null) {\n      serialized[key] = serializePluginOptions(value)\n    } else {\n      serialized[key] = value\n    }\n  }\n  return serialized\n}\n","export async function timeout(ms: number): Promise<unknown> {\n  return new Promise((resolve) => {\n    const timeout = setTimeout(() => {\n      resolve(timeout)\n    }, ms)\n  }).then((timeout) => {\n    clearTimeout(timeout as NodeJS.Timeout)\n\n    return true\n  })\n}\n"],"mappings":"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"}

package/dist/utils.d.cts

@@ -1,3 +1,226 @@
-import { A as AsyncEventEmitter } from "./types-ulibr7zw.cjs";
-import { C as buildJSDoc, S as Cache, _ as getElapsedMs, a as timeout, b as executeIfOnline, c as renderTemplate, d as isPromiseRejectedResult, f as getNestedAccessor, g as formatMs, h as formatHrtime, i as URLPath, l as isPromise, m as getBarrelFiles, n as setUniqueName, o as serializePluginOptions, r as URLObject, s as resolveModuleSource, t as getUniqueName, u as isPromiseFulfilledResult, v as FunctionParams, x as isOnline, y as FunctionParamsAST } from "./index-BfAwjQCB.cjs";
-export { AsyncEventEmitter, Cache, FunctionParams, FunctionParamsAST, URLObject, URLPath, buildJSDoc, executeIfOnline, formatHrtime, formatMs, getBarrelFiles, getElapsedMs, getNestedAccessor, getUniqueName, isOnline, isPromise, isPromiseFulfilledResult, isPromiseRejectedResult, renderTemplate, resolveModuleSource, serializePluginOptions, setUniqueName, timeout };
+import { t as __name } from "./chunk-DlpkT3g-.cjs";
+import { A as AsyncEventEmitter, E as PossiblePromise } from "./types-ulibr7zw.cjs";
+import { n as getBarrelFiles } from "./getBarrelFiles-D9yKoizv.cjs";
+
+//#region src/utils/buildJSDoc.d.ts
+
+/**
+ * Builds a JSDoc comment block with custom indentation.
+ * @param comments - Array of comment strings to include in the JSDoc block
+ * @param options - Configuration options for formatting
+ * @returns Formatted JSDoc string or fallback string if no comments
+ */
+declare function buildJSDoc(comments: Array<string>, options?: {
+  /**
+   * String to use for indenting each line of the JSDoc comment
+   * @default '   * ' (3 spaces + asterisk + space)
+   */
+  indent?: string;
+  /**
+   * String to append after the closing JSDoc tag
+   * @default '\n  ' (newline + 2 spaces)
+   */
+  suffix?: string;
+  /**
+   * String to return when there are no comments
+   * @default '  ' (2 spaces)
+   */
+  fallback?: string;
+}): string;
+//#endregion
+//#region src/utils/Cache.d.ts
+declare class Cache<T> {
+  #private;
+  get(key: string): Promise<T | null>;
+  set(key: string, value: T): Promise<void>;
+  delete(key: string): Promise<void>;
+  clear(): Promise<void>;
+  keys(): Promise<string[]>;
+  values(): Promise<T[]>;
+  flush(): Promise<void>;
+}
+//#endregion
+//#region src/utils/checkOnlineStatus.d.ts
+/**
+ * Check if the system has internet connectivity
+ * Uses DNS lookup to well-known stable domains as a lightweight connectivity test
+ */
+declare function isOnline(): Promise<boolean>;
+/**
+ * Execute a function only if online, otherwise silently skip
+ */
+declare function executeIfOnline<T>(fn: () => Promise<T>): Promise<T | null>;
+//#endregion
+//#region src/utils/FunctionParams.d.ts
+type FunctionParamsASTWithoutType = {
+  name?: string;
+  type?: string;
+  /**
+   * @default true
+   */
+  required?: boolean;
+  /**
+   * @default true
+   */
+  enabled?: boolean;
+  default?: string;
+};
+type FunctionParamsASTWithType = {
+  name?: never;
+  type: string;
+  /**
+   * @default true
+   */
+  required?: boolean;
+  /**
+   * @default true
+   */
+  enabled?: boolean;
+  default?: string;
+};
+/**
+ * @deprecated
+ */
+type FunctionParamsAST = FunctionParamsASTWithoutType | FunctionParamsASTWithType;
+/**
+ * @deprecated
+ */
+declare class FunctionParams {
+  #private;
+  constructor();
+  get items(): FunctionParamsAST[];
+  add(item: FunctionParamsAST | Array<FunctionParamsAST | FunctionParamsAST[] | undefined> | undefined): FunctionParams;
+  static toObject(items: FunctionParamsAST[]): FunctionParamsAST;
+  toObject(): FunctionParamsAST;
+  static toString(items: (FunctionParamsAST | FunctionParamsAST[])[]): string;
+  toString(): string;
+}
+//#endregion
+//#region src/utils/formatHrtime.d.ts
+/**
+ * Calculates elapsed time in milliseconds from a high-resolution start time.
+ * Rounds to 2 decimal places to provide sub-millisecond precision without noise.
+ */
+declare function getElapsedMs(hrStart: [number, number]): number;
+/**
+ * Converts a millisecond duration into a human-readable string.
+ * Adjusts units (ms, s, m s) based on the magnitude of the duration.
+ */
+declare function formatMs(ms: number): string;
+/**
+ * Convenience helper to get and format elapsed time in one step.
+ */
+declare function formatHrtime(hrStart: [number, number]): string;
+//#endregion
+//#region src/utils/getNestedAccessor.d.ts
+/**
+ * Converts a param path (string with dot notation or array of strings) to a JavaScript accessor expression.
+ * @param param - The param path, e.g., 'pagination.next.id' or ['pagination', 'next', 'id']
+ * @param accessor - The base accessor, e.g., 'lastPage' or 'firstPage'
+ * @returns A JavaScript accessor expression, e.g., "lastPage?.['pagination']?.['next']?.['id']", or undefined if param is empty
+ *
+ * @example
+ * ```ts
+ * getNestedAccessor('pagination.next.id', 'lastPage')
+ * // returns: "lastPage?.['pagination']?.['next']?.['id']"
+ *
+ * getNestedAccessor(['pagination', 'next', 'id'], 'lastPage')
+ * // returns: "lastPage?.['pagination']?.['next']?.['id']"
+ *
+ * getNestedAccessor('', 'lastPage')
+ * // returns: undefined
+ * ```
+ */
+declare function getNestedAccessor(param: string | string[], accessor: string): string | undefined;
+//#endregion
+//#region src/utils/promise.d.ts
+declare function isPromise<T>(result: PossiblePromise<T>): result is Promise<T>;
+declare function isPromiseFulfilledResult<T = unknown>(result: PromiseSettledResult<unknown>): result is PromiseFulfilledResult<T>;
+declare function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & {
+  reason: T;
+};
+//#endregion
+//#region src/utils/renderTemplate.d.ts
+declare function renderTemplate<TData extends Record<string, unknown> = Record<string, unknown>>(template: string, data?: TData | undefined): string;
+//#endregion
+//#region src/utils/resolveModuleSource.d.ts
+declare function resolveModuleSource(pkgName: string): {
+  readonly path: string;
+  readonly source: string;
+  readonly ext: string;
+};
+//#endregion
+//#region src/utils/serializePluginOptions.d.ts
+/**
+ * Serialize plugin options for safe JSON transport.
+ * Strips functions, symbols, and undefined values recursively.
+ */
+declare function serializePluginOptions(options: unknown): unknown;
+//#endregion
+//#region src/utils/timeout.d.ts
+declare function timeout(ms: number): Promise<unknown>;
+//#endregion
+//#region src/utils/URLPath.d.ts
+type URLObject = {
+  url: string;
+  params?: Record<string, string>;
+};
+type ObjectOptions = {
+  type?: 'path' | 'template';
+  replacer?: (pathParam: string) => string;
+  stringify?: boolean;
+};
+type Options = {
+  casing?: 'camelcase';
+};
+declare class URLPath {
+  #private;
+  path: string;
+  constructor(path: string, options?: Options);
+  /**
+   * Convert Swagger path to URLPath(syntax of Express)
+   * @example /pet/{petId} => /pet/:petId
+   */
+  get URL(): string;
+  get isURL(): boolean;
+  /**
+   * Convert Swagger path to template literals/ template strings(camelcase)
+   * @example /pet/{petId} => `/pet/${petId}`
+   * @example /account/monetary-accountID => `/account/${monetaryAccountId}`
+   * @example /account/userID => `/account/${userId}`
+   */
+  get template(): string;
+  get object(): URLObject | string;
+  get params(): Record<string, string> | undefined;
+  toObject({
+    type,
+    replacer,
+    stringify
+  }?: ObjectOptions): URLObject | string;
+  /**
+   * Convert Swagger path to template literals/ template strings(camelcase)
+   * @example /pet/{petId} => `/pet/${petId}`
+   * @example /account/monetary-accountID => `/account/${monetaryAccountId}`
+   * @example /account/userID => `/account/${userId}`
+   */
+  toTemplateString({
+    prefix,
+    replacer
+  }?: {
+    prefix?: string;
+    replacer?: (pathParam: string) => string;
+  }): string;
+  getParams(replacer?: (pathParam: string) => string): Record<string, string> | undefined;
+  /**
+   * Convert Swagger path to URLPath(syntax of Express)
+   * @example /pet/{petId} => /pet/:petId
+   */
+  toURLPath(): string;
+}
+//#endregion
+//#region src/utils/uniqueName.d.ts
+declare function getUniqueName(originalName: string, data: Record<string, number>): string;
+declare function setUniqueName(originalName: string, data: Record<string, number>): string;
+//#endregion
+export { AsyncEventEmitter, Cache, FunctionParams, type FunctionParamsAST, type URLObject, URLPath, buildJSDoc, executeIfOnline, formatHrtime, formatMs, getBarrelFiles, getElapsedMs, getNestedAccessor, getUniqueName, isOnline, isPromise, isPromiseFulfilledResult, isPromiseRejectedResult, renderTemplate, resolveModuleSource, serializePluginOptions, setUniqueName, timeout };
+//# sourceMappingURL=utils.d.cts.map

package/dist/utils.d.ts

@@ -1,3 +1,226 @@
-import { A as AsyncEventEmitter } from "./types-Cn3Gwsf3.js";
-import { C as buildJSDoc, S as Cache, _ as getElapsedMs, a as timeout, b as executeIfOnline, c as renderTemplate, d as isPromiseRejectedResult, f as getNestedAccessor, g as formatMs, h as formatHrtime, i as URLPath, l as isPromise, m as getBarrelFiles, n as setUniqueName, o as serializePluginOptions, r as URLObject, s as resolveModuleSource, t as getUniqueName, u as isPromiseFulfilledResult, v as FunctionParams, x as isOnline, y as FunctionParamsAST } from "./index-C0nP9vjm.js";
-export { AsyncEventEmitter, Cache, FunctionParams, FunctionParamsAST, URLObject, URLPath, buildJSDoc, executeIfOnline, formatHrtime, formatMs, getBarrelFiles, getElapsedMs, getNestedAccessor, getUniqueName, isOnline, isPromise, isPromiseFulfilledResult, isPromiseRejectedResult, renderTemplate, resolveModuleSource, serializePluginOptions, setUniqueName, timeout };
+import { t as __name } from "./chunk-iVr_oF3V.js";
+import { A as AsyncEventEmitter, E as PossiblePromise } from "./types-Cn3Gwsf3.js";
+import { n as getBarrelFiles } from "./getBarrelFiles-CvaEQ7z_.js";
+
+//#region src/utils/buildJSDoc.d.ts
+
+/**
+ * Builds a JSDoc comment block with custom indentation.
+ * @param comments - Array of comment strings to include in the JSDoc block
+ * @param options - Configuration options for formatting
+ * @returns Formatted JSDoc string or fallback string if no comments
+ */
+declare function buildJSDoc(comments: Array<string>, options?: {
+  /**
+   * String to use for indenting each line of the JSDoc comment
+   * @default '   * ' (3 spaces + asterisk + space)
+   */
+  indent?: string;
+  /**
+   * String to append after the closing JSDoc tag
+   * @default '\n  ' (newline + 2 spaces)
+   */
+  suffix?: string;
+  /**
+   * String to return when there are no comments
+   * @default '  ' (2 spaces)
+   */
+  fallback?: string;
+}): string;
+//#endregion
+//#region src/utils/Cache.d.ts
+declare class Cache<T> {
+  #private;
+  get(key: string): Promise<T | null>;
+  set(key: string, value: T): Promise<void>;
+  delete(key: string): Promise<void>;
+  clear(): Promise<void>;
+  keys(): Promise<string[]>;
+  values(): Promise<T[]>;
+  flush(): Promise<void>;
+}
+//#endregion
+//#region src/utils/checkOnlineStatus.d.ts
+/**
+ * Check if the system has internet connectivity
+ * Uses DNS lookup to well-known stable domains as a lightweight connectivity test
+ */
+declare function isOnline(): Promise<boolean>;
+/**
+ * Execute a function only if online, otherwise silently skip
+ */
+declare function executeIfOnline<T>(fn: () => Promise<T>): Promise<T | null>;
+//#endregion
+//#region src/utils/FunctionParams.d.ts
+type FunctionParamsASTWithoutType = {
+  name?: string;
+  type?: string;
+  /**
+   * @default true
+   */
+  required?: boolean;
+  /**
+   * @default true
+   */
+  enabled?: boolean;
+  default?: string;
+};
+type FunctionParamsASTWithType = {
+  name?: never;
+  type: string;
+  /**
+   * @default true
+   */
+  required?: boolean;
+  /**
+   * @default true
+   */
+  enabled?: boolean;
+  default?: string;
+};
+/**
+ * @deprecated
+ */
+type FunctionParamsAST = FunctionParamsASTWithoutType | FunctionParamsASTWithType;
+/**
+ * @deprecated
+ */
+declare class FunctionParams {
+  #private;
+  constructor();
+  get items(): FunctionParamsAST[];
+  add(item: FunctionParamsAST | Array<FunctionParamsAST | FunctionParamsAST[] | undefined> | undefined): FunctionParams;
+  static toObject(items: FunctionParamsAST[]): FunctionParamsAST;
+  toObject(): FunctionParamsAST;
+  static toString(items: (FunctionParamsAST | FunctionParamsAST[])[]): string;
+  toString(): string;
+}
+//#endregion
+//#region src/utils/formatHrtime.d.ts
+/**
+ * Calculates elapsed time in milliseconds from a high-resolution start time.
+ * Rounds to 2 decimal places to provide sub-millisecond precision without noise.
+ */
+declare function getElapsedMs(hrStart: [number, number]): number;
+/**
+ * Converts a millisecond duration into a human-readable string.
+ * Adjusts units (ms, s, m s) based on the magnitude of the duration.
+ */
+declare function formatMs(ms: number): string;
+/**
+ * Convenience helper to get and format elapsed time in one step.
+ */
+declare function formatHrtime(hrStart: [number, number]): string;
+//#endregion
+//#region src/utils/getNestedAccessor.d.ts
+/**
+ * Converts a param path (string with dot notation or array of strings) to a JavaScript accessor expression.
+ * @param param - The param path, e.g., 'pagination.next.id' or ['pagination', 'next', 'id']
+ * @param accessor - The base accessor, e.g., 'lastPage' or 'firstPage'
+ * @returns A JavaScript accessor expression, e.g., "lastPage?.['pagination']?.['next']?.['id']", or undefined if param is empty
+ *
+ * @example
+ * ```ts
+ * getNestedAccessor('pagination.next.id', 'lastPage')
+ * // returns: "lastPage?.['pagination']?.['next']?.['id']"
+ *
+ * getNestedAccessor(['pagination', 'next', 'id'], 'lastPage')
+ * // returns: "lastPage?.['pagination']?.['next']?.['id']"
+ *
+ * getNestedAccessor('', 'lastPage')
+ * // returns: undefined
+ * ```
+ */
+declare function getNestedAccessor(param: string | string[], accessor: string): string | undefined;
+//#endregion
+//#region src/utils/promise.d.ts
+declare function isPromise<T>(result: PossiblePromise<T>): result is Promise<T>;
+declare function isPromiseFulfilledResult<T = unknown>(result: PromiseSettledResult<unknown>): result is PromiseFulfilledResult<T>;
+declare function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & {
+  reason: T;
+};
+//#endregion
+//#region src/utils/renderTemplate.d.ts
+declare function renderTemplate<TData extends Record<string, unknown> = Record<string, unknown>>(template: string, data?: TData | undefined): string;
+//#endregion
+//#region src/utils/resolveModuleSource.d.ts
+declare function resolveModuleSource(pkgName: string): {
+  readonly path: string;
+  readonly source: string;
+  readonly ext: string;
+};
+//#endregion
+//#region src/utils/serializePluginOptions.d.ts
+/**
+ * Serialize plugin options for safe JSON transport.
+ * Strips functions, symbols, and undefined values recursively.
+ */
+declare function serializePluginOptions(options: unknown): unknown;
+//#endregion
+//#region src/utils/timeout.d.ts
+declare function timeout(ms: number): Promise<unknown>;
+//#endregion
+//#region src/utils/URLPath.d.ts
+type URLObject = {
+  url: string;
+  params?: Record<string, string>;
+};
+type ObjectOptions = {
+  type?: 'path' | 'template';
+  replacer?: (pathParam: string) => string;
+  stringify?: boolean;
+};
+type Options = {
+  casing?: 'camelcase';
+};
+declare class URLPath {
+  #private;
+  path: string;
+  constructor(path: string, options?: Options);
+  /**
+   * Convert Swagger path to URLPath(syntax of Express)
+   * @example /pet/{petId} => /pet/:petId
+   */
+  get URL(): string;
+  get isURL(): boolean;
+  /**
+   * Convert Swagger path to template literals/ template strings(camelcase)
+   * @example /pet/{petId} => `/pet/${petId}`
+   * @example /account/monetary-accountID => `/account/${monetaryAccountId}`
+   * @example /account/userID => `/account/${userId}`
+   */
+  get template(): string;
+  get object(): URLObject | string;
+  get params(): Record<string, string> | undefined;
+  toObject({
+    type,
+    replacer,
+    stringify
+  }?: ObjectOptions): URLObject | string;
+  /**
+   * Convert Swagger path to template literals/ template strings(camelcase)
+   * @example /pet/{petId} => `/pet/${petId}`
+   * @example /account/monetary-accountID => `/account/${monetaryAccountId}`
+   * @example /account/userID => `/account/${userId}`
+   */
+  toTemplateString({
+    prefix,
+    replacer
+  }?: {
+    prefix?: string;
+    replacer?: (pathParam: string) => string;
+  }): string;
+  getParams(replacer?: (pathParam: string) => string): Record<string, string> | undefined;
+  /**
+   * Convert Swagger path to URLPath(syntax of Express)
+   * @example /pet/{petId} => /pet/:petId
+   */
+  toURLPath(): string;
+}
+//#endregion
+//#region src/utils/uniqueName.d.ts
+declare function getUniqueName(originalName: string, data: Record<string, number>): string;
+declare function setUniqueName(originalName: string, data: Record<string, number>): string;
+//#endregion
+export { AsyncEventEmitter, Cache, FunctionParams, type FunctionParamsAST, type URLObject, URLPath, buildJSDoc, executeIfOnline, formatHrtime, formatMs, getBarrelFiles, getElapsedMs, getNestedAccessor, getUniqueName, isOnline, isPromise, isPromiseFulfilledResult, isPromiseRejectedResult, renderTemplate, resolveModuleSource, serializePluginOptions, setUniqueName, timeout };
+//# sourceMappingURL=utils.d.ts.map