@nestia/migrate 6.0.5 → 7.0.0-dev.20250605

package/src/utils/OpenApiTypeChecker.ts

@@ -1,73 +1,73 @@
-import { OpenApi } from "@samchon/openapi";
-
-export namespace OpenApiTypeChecker {
-  export const isOneOf = (
-    schema: OpenApi.IJsonSchema,
-  ): schema is OpenApi.IJsonSchema.IOneOf =>
-    (schema as any).oneOf !== undefined;
-
-  export const isNull = (
-    schema: OpenApi.IJsonSchema,
-  ): schema is OpenApi.IJsonSchema.INull =>
-    (schema as OpenApi.IJsonSchema.INull).type === "null";
-
-  export const isConstant = (
-    schema: OpenApi.IJsonSchema,
-  ): schema is OpenApi.IJsonSchema.IConstant =>
-    (schema as OpenApi.IJsonSchema.IConstant).const !== undefined;
-
-  export const isBoolean = (
-    schema: OpenApi.IJsonSchema,
-  ): schema is OpenApi.IJsonSchema.IBoolean =>
-    (schema as OpenApi.IJsonSchema.IBoolean).type === "boolean";
-
-  export const isInteger = (
-    schema: OpenApi.IJsonSchema,
-  ): schema is OpenApi.IJsonSchema.IInteger =>
-    (schema as OpenApi.IJsonSchema.IInteger).type === "integer";
-
-  export const isNumber = (
-    schema: OpenApi.IJsonSchema,
-  ): schema is OpenApi.IJsonSchema.INumber =>
-    (schema as OpenApi.IJsonSchema.INumber).type === "number";
-
-  export const isString = (
-    schema: OpenApi.IJsonSchema,
-  ): schema is OpenApi.IJsonSchema.IString =>
-    (schema as OpenApi.IJsonSchema.IString).type === "string";
-
-  export const isArray = (
-    schema: OpenApi.IJsonSchema,
-  ): schema is OpenApi.IJsonSchema.IArray =>
-    (schema as OpenApi.IJsonSchema.IArray).type === "array" &&
-    (schema as OpenApi.IJsonSchema.IArray).items !== undefined;
-
-  export const isTuple = (
-    schema: OpenApi.IJsonSchema,
-  ): schema is OpenApi.IJsonSchema.ITuple =>
-    (schema as OpenApi.IJsonSchema.ITuple).type === "array" &&
-    (schema as OpenApi.IJsonSchema.ITuple).prefixItems !== undefined;
-
-  export const isObject = (
-    schema: OpenApi.IJsonSchema,
-  ): schema is OpenApi.IJsonSchema.IObject =>
-    (schema as OpenApi.IJsonSchema.IObject).type === "object";
-
-  export const isReference = (
-    schema: OpenApi.IJsonSchema,
-  ): schema is OpenApi.IJsonSchema.IReference =>
-    (schema as OpenApi.IJsonSchema.IReference).$ref !== undefined;
-
-  export const isUnknown = (
-    schema: OpenApi.IJsonSchema,
-  ): schema is OpenApi.IJsonSchema.IUnknown =>
-    (schema as OpenApi.IJsonSchema.__ISignificant<any>).type === undefined &&
-    !isOneOf(schema) &&
-    !isReference(schema) &&
-    !isConstant(schema);
-
-  // export const isNullable = (schema: OpenApi.IJsonSchema): boolean =>
-  //   SwaggerTypeChecker.isOneOf(schema)
-  //     ? schema.oneOf.some(isNullable)
-  //     : (schema as OpenApi.IJsonSchema.INullOnly).type === "null";
-}
+import { OpenApi } from "@samchon/openapi";
+
+export namespace OpenApiTypeChecker {
+  export const isOneOf = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IOneOf =>
+    (schema as any).oneOf !== undefined;
+
+  export const isNull = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.INull =>
+    (schema as OpenApi.IJsonSchema.INull).type === "null";
+
+  export const isConstant = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IConstant =>
+    (schema as OpenApi.IJsonSchema.IConstant).const !== undefined;
+
+  export const isBoolean = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IBoolean =>
+    (schema as OpenApi.IJsonSchema.IBoolean).type === "boolean";
+
+  export const isInteger = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IInteger =>
+    (schema as OpenApi.IJsonSchema.IInteger).type === "integer";
+
+  export const isNumber = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.INumber =>
+    (schema as OpenApi.IJsonSchema.INumber).type === "number";
+
+  export const isString = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IString =>
+    (schema as OpenApi.IJsonSchema.IString).type === "string";
+
+  export const isArray = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IArray =>
+    (schema as OpenApi.IJsonSchema.IArray).type === "array" &&
+    (schema as OpenApi.IJsonSchema.IArray).items !== undefined;
+
+  export const isTuple = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.ITuple =>
+    (schema as OpenApi.IJsonSchema.ITuple).type === "array" &&
+    (schema as OpenApi.IJsonSchema.ITuple).prefixItems !== undefined;
+
+  export const isObject = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IObject =>
+    (schema as OpenApi.IJsonSchema.IObject).type === "object";
+
+  export const isReference = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IReference =>
+    (schema as OpenApi.IJsonSchema.IReference).$ref !== undefined;
+
+  export const isUnknown = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IUnknown =>
+    (schema as OpenApi.IJsonSchema.__ISignificant<any>).type === undefined &&
+    !isOneOf(schema) &&
+    !isReference(schema) &&
+    !isConstant(schema);
+
+  // export const isNullable = (schema: OpenApi.IJsonSchema): boolean =>
+  //   SwaggerTypeChecker.isOneOf(schema)
+  //     ? schema.oneOf.some(isNullable)
+  //     : (schema as OpenApi.IJsonSchema.INullOnly).type === "null";
+}

package/src/utils/SetupWizard.ts

@@ -1,12 +1,12 @@
-import cp from "child_process";
-
-export namespace SetupWizard {
-  export const setup = (output: string) => {
-    execute(output)("npm install");
-  };
-
-  const execute = (cwd: string) => (command: string, fake?: string) => {
-    console.log(fake ?? command);
-    cp.execSync(command, { cwd, stdio: "inherit" });
-  };
-}
+import cp from "child_process";
+
+export namespace SetupWizard {
+  export const setup = (output: string) => {
+    execute(output)("npm install");
+  };
+
+  const execute = (cwd: string) => (command: string, fake?: string) => {
+    console.log(fake ?? command);
+    cp.execSync(command, { cwd, stdio: "inherit" });
+  };
+}

package/src/utils/StringUtil.ts

@@ -1,113 +1,113 @@
-export namespace StringUtil {
-  export const capitalize = (str: string) =>
-    str[0].toUpperCase() + str.slice(1).toLowerCase();
-
-  export const splitWithNormalization = (path: string) =>
-    path
-      .split("/")
-      .map((str) => normalize(str.trim()))
-      .filter((str) => !!str.length);
-
-  export const escapeDuplicate =
-    (keep: string[]) =>
-    (change: string): string =>
-      keep.includes(change) ? escapeDuplicate(keep)(`_${change}`) : change;
-
-  export const escapeNonVariable = (str: string): string => {
-    str = escape(str);
-    for (const [before, after] of VARIABLE_REPLACERS)
-      str = str.split(before).join(after);
-    for (let i: number = 0; i <= 9; ++i)
-      if (str[0] === i.toString()) {
-        str = "_" + str;
-        break;
-      }
-    if (str === "") return "_empty_";
-    return str;
-  };
-}
-
-const escape = (str: string): string => {
-  str = str.trim();
-  if (RESERVED.has(str)) return `_${str}`;
-  else if (str.length !== 0 && "0" <= str[0] && str[0] <= "9") str = `_${str}`;
-  return str;
-};
-
-const normalize = (str: string): string =>
-  escape(str.split(".").join("_").split("-").join("_"));
-
-const RESERVED: Set<string> = new Set([
-  "break",
-  "case",
-  "catch",
-  "class",
-  "const",
-  "continue",
-  "debugger",
-  "default",
-  "delete",
-  "do",
-  "else",
-  "enum",
-  "export",
-  "extends",
-  "false",
-  "finally",
-  "for",
-  "function",
-  "if",
-  "import",
-  "in",
-  "instanceof",
-  "module",
-  "new",
-  "null",
-  "package",
-  "public",
-  "private",
-  "protected",
-  "return",
-  "super",
-  "switch",
-  "this",
-  "throw",
-  "true",
-  "try",
-  "typeof",
-  "var",
-  "void",
-  "while",
-  "with",
-]);
-
-const VARIABLE_REPLACERS: [string, string][] = [
-  ["`", "_backquote_"],
-  ["!", "_exclamation_"],
-  ["@", "_at_"],
-  ["#", "_hash_"],
-  ["$", "_dollar_"],
-  ["%", "_percent_"],
-  ["^", "_caret_"],
-  ["&", "_and_"],
-  ["*", "_star_"],
-  ["(", "_lparen_"],
-  [")", "_rparen_"],
-  ["-", "_"],
-  ["+", "_plus_"],
-  ["|", "_or_"],
-  ["{", "_blt_"],
-  ["}", "_bgt_"],
-  ["<", "_lt_"],
-  [">", "_gt_"],
-  ["[", "_alt_"],
-  ["]", "_agt_"],
-  [",", "_comma_"],
-  ["'", "_singlequote_"],
-  ['"', "_doublequote_"],
-  [" ", "_space_"],
-  ["?", "_question_"],
-  [":", "_colon_"],
-  [";", "_semicolon_"],
-  ["...", "_rest_"],
-];
+export namespace StringUtil {
+  export const capitalize = (str: string) =>
+    str[0].toUpperCase() + str.slice(1).toLowerCase();
+
+  export const splitWithNormalization = (path: string) =>
+    path
+      .split("/")
+      .map((str) => normalize(str.trim()))
+      .filter((str) => !!str.length);
+
+  export const escapeDuplicate =
+    (keep: string[]) =>
+    (change: string): string =>
+      keep.includes(change) ? escapeDuplicate(keep)(`_${change}`) : change;
+
+  export const escapeNonVariable = (str: string): string => {
+    str = escape(str);
+    for (const [before, after] of VARIABLE_REPLACERS)
+      str = str.split(before).join(after);
+    for (let i: number = 0; i <= 9; ++i)
+      if (str[0] === i.toString()) {
+        str = "_" + str;
+        break;
+      }
+    if (str === "") return "_empty_";
+    return str;
+  };
+}
+
+const escape = (str: string): string => {
+  str = str.trim();
+  if (RESERVED.has(str)) return `_${str}`;
+  else if (str.length !== 0 && "0" <= str[0] && str[0] <= "9") str = `_${str}`;
+  return str;
+};
+
+const normalize = (str: string): string =>
+  escape(str.split(".").join("_").split("-").join("_"));
+
+const RESERVED: Set<string> = new Set([
+  "break",
+  "case",
+  "catch",
+  "class",
+  "const",
+  "continue",
+  "debugger",
+  "default",
+  "delete",
+  "do",
+  "else",
+  "enum",
+  "export",
+  "extends",
+  "false",
+  "finally",
+  "for",
+  "function",
+  "if",
+  "import",
+  "in",
+  "instanceof",
+  "module",
+  "new",
+  "null",
+  "package",
+  "public",
+  "private",
+  "protected",
+  "return",
+  "super",
+  "switch",
+  "this",
+  "throw",
+  "true",
+  "try",
+  "typeof",
+  "var",
+  "void",
+  "while",
+  "with",
+]);
+
+const VARIABLE_REPLACERS: [string, string][] = [
+  ["`", "_backquote_"],
+  ["!", "_exclamation_"],
+  ["@", "_at_"],
+  ["#", "_hash_"],
+  ["$", "_dollar_"],
+  ["%", "_percent_"],
+  ["^", "_caret_"],
+  ["&", "_and_"],
+  ["*", "_star_"],
+  ["(", "_lparen_"],
+  [")", "_rparen_"],
+  ["-", "_"],
+  ["+", "_plus_"],
+  ["|", "_or_"],
+  ["{", "_blt_"],
+  ["}", "_bgt_"],
+  ["<", "_lt_"],
+  [">", "_gt_"],
+  ["[", "_alt_"],
+  ["]", "_agt_"],
+  [",", "_comma_"],
+  ["'", "_singlequote_"],
+  ['"', "_doublequote_"],
+  [" ", "_space_"],
+  ["?", "_question_"],
+  [":", "_colon_"],
+  [";", "_semicolon_"],
+  ["...", "_rest_"],
+];

package/src/utils/openapi-down-convert/RefVisitor.ts

@@ -1,139 +1,139 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
-
-/**
- * Recursively walk a JSON object and invoke a callback function
- * on each `{ "$ref" : "path" }` object found
- */
-
-/**
- * Represents a JSON Reference object, such as
- * `{"$ref": "#/components/schemas/problemResponse" }`
- */
-export interface RefObject {
-  $ref: string;
-}
-
-/**
- * JsonNode represents a node within the OpenAPI object
- */
-export type JsonNode = object | [] | string | boolean | null | number;
-
-/** A JSON Schema object in an API def */
-export type SchemaObject = object;
-
-/**
- * Function signature for the visitRefObjects callback
- */
-export type RefVisitor = (node: RefObject) => JsonNode;
-/**
- * Function signature for the visitSchemaObjects callback
- */
-export type SchemaVisitor = (node: SchemaObject) => SchemaObject;
-
-/**
-/**
- * Function signature for the walkObject callback
- */
-export type ObjectVisitor = (node: object) => JsonNode;
-
-/**
- * Test if a JSON node is a `{ $ref: "uri" }` object
- */
-export function isRef(node: any): boolean {
-  return (
-    node !== null &&
-    typeof node === "object" &&
-    node.hasOwnProperty("$ref") &&
-    typeof node["$ref"] === "string"
-  );
-}
-
-/**
- * Walk a JSON object and apply `schemaCallback` when a JSON schema is found.
- * JSON Schema objects are items in components/schemas or in an item named `schema`
- * @param node a node in the OpenAPI document
- * @param schemaCallback the function to call on JSON schema objects
- * @return the modified (annotated) node
- */
-export function visitSchemaObjects(
-  node: any,
-  schemaCallback: SchemaVisitor,
-): any {
-  const objectVisitor = (node: any): JsonNode => {
-    if (node.hasOwnProperty("schema")) {
-      const schema = node["schema"];
-      if (schema != null && typeof schema === "object") {
-        node["schema"] = schemaCallback(schema);
-      }
-    } else if (node.hasOwnProperty("schemas")) {
-      const schemas = node["schemas"];
-      if (schemas != null && typeof schemas === "object") {
-        for (const schemaName in schemas) {
-          const schema = schemas[schemaName];
-          const newSchema = schemaCallback(schema);
-          schemas[schemaName] = newSchema;
-        }
-      }
-    }
-    return node;
-  };
-  return walkObject(node, objectVisitor);
-}
-
-/**
- * Walk a JSON object and apply `refCallback` when a JSON `{$ref: url }` is found
- * @param node a node in the OpenAPI document
- * @param refCallback the function to call on JSON `$ref` objects
- * @return the modified (annotated) node
- */
-export function visitRefObjects(node: any, refCallback: RefVisitor): any {
-  const objectVisitor = (node: object): JsonNode => {
-    if (isRef(node)) {
-      return refCallback(node as RefObject);
-    }
-    return node;
-  };
-  return walkObject(node, objectVisitor);
-}
-
-/**
- * Walk a JSON object or array and apply objectCallback when a JSON object is found
- * @param node a node in the OpenAPI document
- * @param objectCallback the function to call on JSON objects
- * @param nav tracks where we are in the original document
- * @return the modified (annotated) node
- */
-export function walkObject(
-  node: object,
-  objectCallback: ObjectVisitor,
-): JsonNode {
-  return walkObj(node);
-
-  function walkObj(node: any): JsonNode {
-    const object = objectCallback(node);
-    if (object !== null && typeof object === "object") {
-      const keys = [...Object.keys(node)]; // make copy since this code may re-enter objects
-      for (const key of keys) {
-        const val = node[key];
-        if (Array.isArray(val)) {
-          node[key] = walkArray(val as []);
-        } else if (val !== null && typeof val === "object") {
-          node[key] = walkObj(val);
-        }
-      }
-    }
-    return object;
-  }
-
-  function walkArray(array: JsonNode[]): JsonNode[] {
-    for (let index = 0; index < array.length; index += 1) {
-      const val = array[index] as JsonNode;
-      if (val !== null && typeof val === "object") {
-        array[index] = walkObj(val) as object;
-      } else if (Array.isArray(val)) {
-        array[index] = walkArray(val as JsonNode[]) as [];
-      }
-    }
-    return array;
-  }
-}
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+/**
+ * Recursively walk a JSON object and invoke a callback function
+ * on each `{ "$ref" : "path" }` object found
+ */
+
+/**
+ * Represents a JSON Reference object, such as
+ * `{"$ref": "#/components/schemas/problemResponse" }`
+ */
+export interface RefObject {
+  $ref: string;
+}
+
+/**
+ * JsonNode represents a node within the OpenAPI object
+ */
+export type JsonNode = object | [] | string | boolean | null | number;
+
+/** A JSON Schema object in an API def */
+export type SchemaObject = object;
+
+/**
+ * Function signature for the visitRefObjects callback
+ */
+export type RefVisitor = (node: RefObject) => JsonNode;
+/**
+ * Function signature for the visitSchemaObjects callback
+ */
+export type SchemaVisitor = (node: SchemaObject) => SchemaObject;
+
+/**
+/**
+ * Function signature for the walkObject callback
+ */
+export type ObjectVisitor = (node: object) => JsonNode;
+
+/**
+ * Test if a JSON node is a `{ $ref: "uri" }` object
+ */
+export function isRef(node: any): boolean {
+  return (
+    node !== null &&
+    typeof node === "object" &&
+    node.hasOwnProperty("$ref") &&
+    typeof node["$ref"] === "string"
+  );
+}
+
+/**
+ * Walk a JSON object and apply `schemaCallback` when a JSON schema is found.
+ * JSON Schema objects are items in components/schemas or in an item named `schema`
+ * @param node a node in the OpenAPI document
+ * @param schemaCallback the function to call on JSON schema objects
+ * @return the modified (annotated) node
+ */
+export function visitSchemaObjects(
+  node: any,
+  schemaCallback: SchemaVisitor,
+): any {
+  const objectVisitor = (node: any): JsonNode => {
+    if (node.hasOwnProperty("schema")) {
+      const schema = node["schema"];
+      if (schema != null && typeof schema === "object") {
+        node["schema"] = schemaCallback(schema);
+      }
+    } else if (node.hasOwnProperty("schemas")) {
+      const schemas = node["schemas"];
+      if (schemas != null && typeof schemas === "object") {
+        for (const schemaName in schemas) {
+          const schema = schemas[schemaName];
+          const newSchema = schemaCallback(schema);
+          schemas[schemaName] = newSchema;
+        }
+      }
+    }
+    return node;
+  };
+  return walkObject(node, objectVisitor);
+}
+
+/**
+ * Walk a JSON object and apply `refCallback` when a JSON `{$ref: url }` is found
+ * @param node a node in the OpenAPI document
+ * @param refCallback the function to call on JSON `$ref` objects
+ * @return the modified (annotated) node
+ */
+export function visitRefObjects(node: any, refCallback: RefVisitor): any {
+  const objectVisitor = (node: object): JsonNode => {
+    if (isRef(node)) {
+      return refCallback(node as RefObject);
+    }
+    return node;
+  };
+  return walkObject(node, objectVisitor);
+}
+
+/**
+ * Walk a JSON object or array and apply objectCallback when a JSON object is found
+ * @param node a node in the OpenAPI document
+ * @param objectCallback the function to call on JSON objects
+ * @param nav tracks where we are in the original document
+ * @return the modified (annotated) node
+ */
+export function walkObject(
+  node: object,
+  objectCallback: ObjectVisitor,
+): JsonNode {
+  return walkObj(node);
+
+  function walkObj(node: any): JsonNode {
+    const object = objectCallback(node);
+    if (object !== null && typeof object === "object") {
+      const keys = [...Object.keys(node)]; // make copy since this code may re-enter objects
+      for (const key of keys) {
+        const val = node[key];
+        if (Array.isArray(val)) {
+          node[key] = walkArray(val as []);
+        } else if (val !== null && typeof val === "object") {
+          node[key] = walkObj(val);
+        }
+      }
+    }
+    return object;
+  }
+
+  function walkArray(array: JsonNode[]): JsonNode[] {
+    for (let index = 0; index < array.length; index += 1) {
+      const val = array[index] as JsonNode;
+      if (val !== null && typeof val === "object") {
+        array[index] = walkObj(val) as object;
+      } else if (Array.isArray(val)) {
+        array[index] = walkArray(val as JsonNode[]) as [];
+      }
+    }
+    return array;
+  }
+}