@nestia/sdk 12.0.0-dev.20260601.1 → 12.0.0-dev.20260612.2

package/src/utils/EmittedJavaScriptPatcher.ts

@@ -1,88 +1,88 @@
-import fs from "fs";
-import path from "path";
-
-export namespace EmittedJavaScriptPatcher {
-  export const importMetaUrl = async (root: string): Promise<void> => {
-    const files: string[] = await collect(root);
-    await Promise.all(files.map(patch));
-  };
-}
-
-const TARGET = "import.meta.url";
-// TypeScript can preserve this token even in CommonJS output. Node 24 then
-// syntax-detects the temporary `.js` file as ESM before require() can load it.
-const REPLACEMENT = 'require("url").pathToFileURL(__filename).href';
-
-const collect = async (location: string): Promise<string[]> => {
-  const entries: fs.Dirent[] = await fs.promises.readdir(location, {
-    withFileTypes: true,
-  });
-  const nested: string[][] = await Promise.all(
-    entries.map(async (entry) => {
-      const next: string = path.join(location, entry.name);
-      if (entry.isDirectory()) return collect(next);
-      if (entry.isFile() && /\.(?:cjs|js)$/i.test(entry.name)) return [next];
-      return [];
-    }),
-  );
-  return nested.flat();
-};
-
-const patch = async (file: string): Promise<void> => {
-  const before: string = await fs.promises.readFile(file, "utf8");
-  if (before.includes(TARGET) === false) return;
-
-  const after: string = replaceImportMetaUrl(before);
-  if (after !== before) await fs.promises.writeFile(file, after, "utf8");
-};
-
-const replaceImportMetaUrl = (input: string): string => {
-  let output: string = "";
-  let cursor: number = 0;
-  for (let i = 0; i < input.length; ) {
-    if (isTarget(input, i)) {
-      output += input.slice(cursor, i);
-      output += REPLACEMENT;
-      i += TARGET.length;
-      cursor = i;
-      continue;
-    }
-
-    const ch: string = input[i]!;
-    const next: string | undefined = input[i + 1];
-    if (ch === '"' || ch === "'") i = skipQuoted(input, i, ch);
-    else if (ch === "/" && next === "/") i = skipLineComment(input, i);
-    else if (ch === "/" && next === "*") i = skipBlockComment(input, i);
-    else ++i;
-  }
-  return output + input.slice(cursor);
-};
-
-const isTarget = (input: string, index: number): boolean =>
-  input.startsWith(TARGET, index) &&
-  isBoundary(input[index - 1]) &&
-  isBoundary(input[index + TARGET.length]);
-
-const isBoundary = (ch: string | undefined): boolean =>
-  ch === undefined || /[^A-Za-z0-9_$]/.test(ch);
-
-const skipQuoted = (input: string, index: number, quote: string): number => {
-  let escaped: boolean = false;
-  for (let i = index + 1; i < input.length; ++i) {
-    const ch: string = input[i]!;
-    if (escaped) escaped = false;
-    else if (ch === "\\") escaped = true;
-    else if (ch === quote) return i + 1;
-  }
-  return input.length;
-};
-
-const skipLineComment = (input: string, index: number): number => {
-  const found: number = input.indexOf("\n", index + 2);
-  return found === -1 ? input.length : found + 1;
-};
-
-const skipBlockComment = (input: string, index: number): number => {
-  const found: number = input.indexOf("*/", index + 2);
-  return found === -1 ? input.length : found + 2;
-};
+import fs from "fs";
+import path from "path";
+
+export namespace EmittedJavaScriptPatcher {
+  export const importMetaUrl = async (root: string): Promise<void> => {
+    const files: string[] = await collect(root);
+    await Promise.all(files.map(patch));
+  };
+}
+
+const TARGET = "import.meta.url";
+// TypeScript can preserve this token even in CommonJS output. Node 24 then
+// syntax-detects the temporary `.js` file as ESM before require() can load it.
+const REPLACEMENT = 'require("url").pathToFileURL(__filename).href';
+
+const collect = async (location: string): Promise<string[]> => {
+  const entries: fs.Dirent[] = await fs.promises.readdir(location, {
+    withFileTypes: true,
+  });
+  const nested: string[][] = await Promise.all(
+    entries.map(async (entry) => {
+      const next: string = path.join(location, entry.name);
+      if (entry.isDirectory()) return collect(next);
+      if (entry.isFile() && /\.(?:cjs|js)$/i.test(entry.name)) return [next];
+      return [];
+    }),
+  );
+  return nested.flat();
+};
+
+const patch = async (file: string): Promise<void> => {
+  const before: string = await fs.promises.readFile(file, "utf8");
+  if (before.includes(TARGET) === false) return;
+
+  const after: string = replaceImportMetaUrl(before);
+  if (after !== before) await fs.promises.writeFile(file, after, "utf8");
+};
+
+const replaceImportMetaUrl = (input: string): string => {
+  let output: string = "";
+  let cursor: number = 0;
+  for (let i = 0; i < input.length; ) {
+    if (isTarget(input, i)) {
+      output += input.slice(cursor, i);
+      output += REPLACEMENT;
+      i += TARGET.length;
+      cursor = i;
+      continue;
+    }
+
+    const ch: string = input[i]!;
+    const next: string | undefined = input[i + 1];
+    if (ch === '"' || ch === "'") i = skipQuoted(input, i, ch);
+    else if (ch === "/" && next === "/") i = skipLineComment(input, i);
+    else if (ch === "/" && next === "*") i = skipBlockComment(input, i);
+    else ++i;
+  }
+  return output + input.slice(cursor);
+};
+
+const isTarget = (input: string, index: number): boolean =>
+  input.startsWith(TARGET, index) &&
+  isBoundary(input[index - 1]) &&
+  isBoundary(input[index + TARGET.length]);
+
+const isBoundary = (ch: string | undefined): boolean =>
+  ch === undefined || /[^A-Za-z0-9_$]/.test(ch);
+
+const skipQuoted = (input: string, index: number, quote: string): number => {
+  let escaped: boolean = false;
+  for (let i = index + 1; i < input.length; ++i) {
+    const ch: string = input[i]!;
+    if (escaped) escaped = false;
+    else if (ch === "\\") escaped = true;
+    else if (ch === quote) return i + 1;
+  }
+  return input.length;
+};
+
+const skipLineComment = (input: string, index: number): number => {
+  const found: number = input.indexOf("\n", index + 2);
+  return found === -1 ? input.length : found + 1;
+};
+
+const skipBlockComment = (input: string, index: number): number => {
+  const found: number = input.indexOf("*/", index + 2);
+  return found === -1 ? input.length : found + 2;
+};

package/src/utils/FileRetriever.ts

@@ -1,22 +1,22 @@
-import fs from "fs";
-import path from "path";
-
-export namespace FileRetriever {
-  export const directory =
-    (name: string) =>
-    (dir: string, depth: number = 0): string | null => {
-      const location: string = path.join(dir, name);
-      if (fs.existsSync(location)) return dir;
-      else if (depth > 2) return null;
-      return directory(name)(path.join(dir, ".."), depth + 1);
-    };
-
-  export const file =
-    (name: string) =>
-    (directory: string, depth: number = 0): string | null => {
-      const location: string = path.join(directory, name);
-      if (fs.existsSync(location)) return location;
-      else if (depth > 2) return null;
-      return file(name)(path.join(directory, ".."), depth + 1);
-    };
-}
+import fs from "fs";
+import path from "path";
+
+export namespace FileRetriever {
+  export const directory =
+    (name: string) =>
+    (dir: string, depth: number = 0): string | null => {
+      const location: string = path.join(dir, name);
+      if (fs.existsSync(location)) return dir;
+      else if (depth > 2) return null;
+      return directory(name)(path.join(dir, ".."), depth + 1);
+    };
+
+  export const file =
+    (name: string) =>
+    (directory: string, depth: number = 0): string | null => {
+      const location: string = path.join(directory, name);
+      if (fs.existsSync(location)) return location;
+      else if (depth > 2) return null;
+      return file(name)(path.join(directory, ".."), depth + 1);
+    };
+}

package/src/utils/HttpResponseContentTypeUtil.ts

@@ -0,0 +1,30 @@
+export namespace HttpResponseContentTypeUtil {
+  export type Response =
+    | "application/json"
+    | "text/plain"
+    | "application/x-www-form-urlencoded"
+    | (string & {})
+    | null;
+
+  export const isSupported = (input: string | null): input is Response =>
+    input === null ||
+    input === "application/json" ||
+    input === "text/plain" ||
+    input === "application/x-www-form-urlencoded" ||
+    isBinary(input);
+
+  export const isBinary = (
+    input: string | null | undefined,
+  ): input is string => {
+    if (typeof input !== "string") return false;
+
+    const value: string = input.split(";")[0]!.trim().toLowerCase();
+    return (
+      value.startsWith("image/") ||
+      value.startsWith("video/") ||
+      value.startsWith("audio/") ||
+      value === "application/octet-stream" ||
+      value === "application/pdf"
+    );
+  };
+}

package/src/utils/MapUtil.ts

@@ -1,14 +1,14 @@
-export namespace MapUtil {
-  export function take<Key, T>(
-    dict: Map<Key, T>,
-    key: Key,
-    generator: () => T,
-  ): T {
-    const oldbie: T | undefined = dict.get(key);
-    if (oldbie) return oldbie;
-
-    const value: T = generator();
-    dict.set(key, value);
-    return value;
-  }
-}
+export namespace MapUtil {
+  export function take<Key, T>(
+    dict: Map<Key, T>,
+    key: Key,
+    generator: () => T,
+  ): T {
+    const oldbie: T | undefined = dict.get(key);
+    if (oldbie) return oldbie;
+
+    const value: T = generator();
+    dict.set(key, value);
+    return value;
+  }
+}

package/src/utils/PathUtil.ts

@@ -1,10 +1,10 @@
-export namespace PathUtil {
-  export const accessors = (path: string) =>
-    path
-      .split("/")
-      .filter((str) => str.length && str[0] !== ":")
-      .map(normalize);
-
-  const normalize = (str: string) =>
-    str.split("-").join("_").split(".").join("_");
-}
+export namespace PathUtil {
+  export const accessors = (path: string) =>
+    path
+      .split("/")
+      .filter((str) => str.length && str[0] !== ":")
+      .map(normalize);
+
+  const normalize = (str: string) =>
+    str.split("-").join("_").split(".").join("_");
+}

package/src/utils/SourceFinder.ts

@@ -1,63 +1,63 @@
-import fs from "fs";
-import { glob } from "glob";
-import path from "path";
-
-export namespace SourceFinder {
-  interface IProps {
-    exclude?: string[];
-    include: string[];
-    filter: (location: string) => Promise<boolean>;
-  }
-
-  export const find = async (props: IProps): Promise<string[]> => {
-    const dict: Set<string> = new Set();
-
-    await emplace(props.filter)(props.include)((str) => dict.add(str));
-    if (props.exclude?.length)
-      await emplace(props.filter)(props.exclude)((str) => dict.delete(str));
-
-    return [...dict];
-  };
-
-  const emplace =
-    (filter: (file: string) => Promise<boolean>) =>
-    (input: string[]) =>
-    async (closure: (location: string) => void): Promise<void> => {
-      for (const pattern of input) {
-        if (_Is_file(pattern)) {
-          closure(path.resolve(pattern));
-          continue;
-        }
-        for (const file of await _Glob(pattern)) {
-          const stats: fs.Stats = await fs.promises.stat(file);
-          if (stats.isDirectory() === true)
-            await iterate(filter)(closure)(file);
-          else if (stats.isFile() && (await filter(file))) closure(file);
-        }
-      }
-    };
-
-  const iterate =
-    (filter: (location: string) => Promise<boolean>) =>
-    (closure: (location: string) => void) =>
-    async (location: string): Promise<void> => {
-      const directory: string[] = await fs.promises.readdir(location);
-      for (const file of directory) {
-        const next: string = path.resolve(`${location}/${file}`);
-        const stats: fs.Stats = await fs.promises.stat(next);
-
-        if (stats.isDirectory() === true) await iterate(filter)(closure)(next);
-        else if (stats.isFile() && (await filter(next))) closure(next);
-      }
-    };
-
-  const _Glob = async (pattern: string): Promise<string[]> => {
-    const matches = await glob(pattern);
-    return matches.map((str) => path.resolve(str));
-  };
-
-  const _Is_file = (pattern: string): boolean =>
-    pattern.endsWith(".ts") &&
-    !pattern.endsWith(".d.ts") &&
-    fs.existsSync(pattern);
-}
+import fs from "fs";
+import { glob } from "glob";
+import path from "path";
+
+export namespace SourceFinder {
+  interface IProps {
+    exclude?: string[];
+    include: string[];
+    filter: (location: string) => Promise<boolean>;
+  }
+
+  export const find = async (props: IProps): Promise<string[]> => {
+    const dict: Set<string> = new Set();
+
+    await emplace(props.filter)(props.include)((str) => dict.add(str));
+    if (props.exclude?.length)
+      await emplace(props.filter)(props.exclude)((str) => dict.delete(str));
+
+    return [...dict];
+  };
+
+  const emplace =
+    (filter: (file: string) => Promise<boolean>) =>
+    (input: string[]) =>
+    async (closure: (location: string) => void): Promise<void> => {
+      for (const pattern of input) {
+        if (_Is_file(pattern)) {
+          closure(path.resolve(pattern));
+          continue;
+        }
+        for (const file of await _Glob(pattern)) {
+          const stats: fs.Stats = await fs.promises.stat(file);
+          if (stats.isDirectory() === true)
+            await iterate(filter)(closure)(file);
+          else if (stats.isFile() && (await filter(file))) closure(file);
+        }
+      }
+    };
+
+  const iterate =
+    (filter: (location: string) => Promise<boolean>) =>
+    (closure: (location: string) => void) =>
+    async (location: string): Promise<void> => {
+      const directory: string[] = await fs.promises.readdir(location);
+      for (const file of directory) {
+        const next: string = path.resolve(`${location}/${file}`);
+        const stats: fs.Stats = await fs.promises.stat(next);
+
+        if (stats.isDirectory() === true) await iterate(filter)(closure)(next);
+        else if (stats.isFile() && (await filter(next))) closure(next);
+      }
+    };
+
+  const _Glob = async (pattern: string): Promise<string[]> => {
+    const matches = await glob(pattern);
+    return matches.map((str) => path.resolve(str));
+  };
+
+  const _Is_file = (pattern: string): boolean =>
+    pattern.endsWith(".ts") &&
+    !pattern.endsWith(".d.ts") &&
+    fs.existsSync(pattern);
+}

package/src/utils/StringUtil.ts

@@ -1,17 +1,17 @@
-export namespace StringUtil {
-  export const capitalize = (text: string): string =>
-    text.charAt(0).toUpperCase() + text.slice(1).toLowerCase();
-
-  export const escapeDuplicate =
-    (keep: string[]) =>
-    (change: string): string =>
-      keep.includes(change) ? escapeDuplicate(keep)(`_${change}`) : change;
-
-  export const isImplicit = (str: string) =>
-    str === "object" ||
-    str === "__type" ||
-    str === "__object" ||
-    str.startsWith("__type.") ||
-    str.startsWith("__object.") ||
-    str.includes("readonly [");
-}
+export namespace StringUtil {
+  export const capitalize = (text: string): string =>
+    text.charAt(0).toUpperCase() + text.slice(1).toLowerCase();
+
+  export const escapeDuplicate =
+    (keep: string[]) =>
+    (change: string): string =>
+      keep.includes(change) ? escapeDuplicate(keep)(`_${change}`) : change;
+
+  export const isImplicit = (str: string) =>
+    str === "object" ||
+    str === "__type" ||
+    str === "__object" ||
+    str.startsWith("__type.") ||
+    str.startsWith("__object.") ||
+    str.includes("readonly [");
+}