@nestia/sdk/src/analyses/AccessorAnalyzer.ts

Nestia SDK and Swagger generator

import { NamingConvention } from "@typia/utils";

import { ITypedHttpRoute } from "../structures/ITypedHttpRoute";
import { ITypedMcpRoute } from "../structures/ITypedMcpRoute";
import { ITypedWebSocketRoute } from "../structures/ITypedWebSocketRoute";

type AnyRoute = ITypedHttpRoute | ITypedWebSocketRoute | ITypedMcpRoute;

export namespace AccessorAnalyzer {
  export const analyze = (routes: Array<AnyRoute>) => {
    shrink(routes);
    variable(routes);
    shrink(routes);
    for (const r of routes) r.name = r.accessor.at(-1) ?? r.name;
  };

  const prepare = (routeList: Array<AnyRoute>): Map<string, number> => {
    const dict: Map<string, number> = new Map();
    for (const route of routeList)
      route.accessor.forEach((_a, i) => {
        const key: string = route.accessor.slice(0, i + 1).join(".");
        dict.set(key, (dict.get(key) ?? 0) + 1);
      });
    return dict;
  };

  const variable = (routeList: Array<AnyRoute>) => {
    const reserved: Set<string> = reserve(routeList);
    const assigned: Map<string, string> = new Map();
    const used: Set<string> = new Set();
    for (const route of routeList) {
      const emended: string[] = [];
      route.accessor.forEach((accessor, i) => {
        const source: string = route.accessor.slice(0, i + 1).join(".");
        const registered: string | undefined = assigned.get(source);
        if (registered !== undefined) {
          emended.push(registered.split(".").at(-1)!);
          return;
        }

        accessor = normalize(accessor);
        while (NamingConvention.variable(accessor) === false)
          accessor = "_" + accessor;
        while (true) {
          const partial: string = [...emended, accessor].join(".");
          if (
            used.has(partial) === false &&
            (reserved.has(partial) === false || partial === source)
          ) {
            assigned.set(source, partial);
            used.add(partial);
            emended.push(accessor);
            break;
          }
          accessor = "_" + accessor;
        }
      });
      route.accessor.splice(0, route.accessor.length, ...emended);
    }
  };

  const reserve = (routeList: Array<AnyRoute>): Set<string> => {
    const output: Set<string> = new Set();
    for (const route of routeList)
      route.accessor.forEach((_a, i) => {
        const partial: string[] = route.accessor.slice(0, i + 1);
        if (partial.every(NamingConvention.variable))
          output.add(partial.join("."));
      });
    return output;
  };

  const normalize = (accessor: string): string => {
    const output: string = accessor.replace(/[^A-Za-z0-9_$]/g, "_");
    return output.length ? output : "_";
  };

  const shrink = (routeList: Array<AnyRoute>) => {
    const dict: Map<string, number> = prepare(routeList);
    for (const route of routeList) {
      if (
        route.accessor.length < 2 ||
        route.accessor.at(-1) !== route.accessor.at(-2)
      )
        continue;

      const cut: string[] = route.accessor.slice(0, -1);
      if ((dict.get(cut.join(".")) ?? 0) > 1) continue;

      route.accessor = cut;
    }
  };
}