typia 9.2.0 → 9.3.0-dev.20250511

package/src/internal/_assertGuard.ts

@@ -1,13 +1,13 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-export const _assertGuard = (
-  exceptionable: boolean,
-  props: TypeGuardError.IProps,
-  factory?: (props: TypeGuardError.IProps) => Error,
-): false => {
-  if (exceptionable === true) {
-    if (factory) throw factory(props);
-    else throw new TypeGuardError(props);
-  }
-  return false;
-};
+import { TypeGuardError } from "../TypeGuardError";
+
+export const _assertGuard = (
+  exceptionable: boolean,
+  props: TypeGuardError.IProps,
+  factory?: (props: TypeGuardError.IProps) => Error,
+): false => {
+  if (exceptionable === true) {
+    if (factory) throw factory(props);
+    else throw new TypeGuardError(props);
+  }
+  return false;
+};

package/src/internal/_createStandardSchema.ts

@@ -1,134 +1,134 @@
-import { StandardSchemaV1 } from "@standard-schema/spec";
-
-import { IValidation } from "../IValidation";
-
-export const _createStandardSchema = <T>(
-  fn: (input: unknown) => IValidation<T>,
-): ((input: unknown) => IValidation<T>) & StandardSchemaV1<unknown, T> =>
-  Object.assign(fn, {
-    "~standard": {
-      version: 1,
-      vendor: "typia",
-      validate: (input: unknown): StandardSchemaV1.Result<T> => {
-        const result = fn(input);
-        if (result.success) {
-          return {
-            value: result.data,
-          } satisfies StandardSchemaV1.SuccessResult<T>;
-        } else {
-          return {
-            issues: result.errors.map((error) => ({
-              message: `expected ${error.expected}, got ${error.value}`,
-              path: typiaPathToStandardSchemaPath(error.path),
-            })),
-          } satisfies StandardSchemaV1.FailureResult;
-        }
-      },
-    },
-  } satisfies StandardSchemaV1<unknown, T>);
-
-enum PathParserState {
-  // Start of a new segment
-  // When the parser is in this state,
-  // the pointer must point `.` or `[` or equal to length of the path
-  Start,
-  // Parsing a property key (`.hoge`)
-  Property,
-  // Parsing a string key (`["fuga"]`)
-  StringKey,
-  // Parsing a number key (`[42]`)
-  NumberKey,
-}
-
-const typiaPathToStandardSchemaPath = (
-  path: string,
-): ReadonlyArray<StandardSchemaV1.PathSegment> => {
-  if (!path.startsWith("$input")) {
-    throw new Error(`Invalid path: ${JSON.stringify(path)}`);
-  }
-
-  const segments: StandardSchemaV1.PathSegment[] = [];
-  let currentSegment = "";
-  let state: PathParserState = PathParserState.Start;
-  let index = "$input".length - 1;
-  while (index < path.length - 1) {
-    index++;
-    const char = path[index];
-
-    if (state === PathParserState.Property) {
-      if (char === "." || char === "[") {
-        // End of property
-        segments.push({
-          key: currentSegment,
-        });
-        state = PathParserState.Start;
-      } else if (index === path.length - 1) {
-        // End of path
-        currentSegment += char;
-        segments.push({
-          key: currentSegment,
-        });
-        index++;
-        state = PathParserState.Start;
-      } else {
-        currentSegment += char;
-      }
-    } else if (state === PathParserState.StringKey) {
-      if (char === '"') {
-        // End of string key
-        segments.push({
-          key: JSON.parse(currentSegment + char),
-        });
-        // Skip `"` and `]`
-        index += 2;
-        state = PathParserState.Start;
-      } else if (char === "\\") {
-        // Skip the next character from parsing
-        currentSegment += path[index];
-        index++;
-        currentSegment += path[index];
-      } else {
-        currentSegment += char;
-      }
-    } else if (state === PathParserState.NumberKey) {
-      if (char === "]") {
-        // End of number key
-        segments.push({
-          key: Number.parseInt(currentSegment),
-        });
-        index++;
-        state = PathParserState.Start;
-      } else {
-        currentSegment += char;
-      }
-    }
-
-    if (state === PathParserState.Start && index < path.length - 1) {
-      const newChar = path[index];
-      currentSegment = "";
-      if (newChar === "[") {
-        if (path[index + 1] === '"') {
-          // Start of string key
-          // NOTE: Typia uses JSON.stringify for this kind of keys, so `'` will not used as a string delimiter
-          state = PathParserState.StringKey;
-          index++;
-          currentSegment = '"';
-        } else {
-          // Start of number key
-          state = PathParserState.NumberKey;
-        }
-      } else if (newChar === ".") {
-        // Start of property
-        state = PathParserState.Property;
-      } else {
-        throw new Error("Unreachable: pointer points invalid character");
-      }
-    }
-  }
-
-  if (state !== PathParserState.Start) {
-    throw new Error(`Failed to parse path: ${JSON.stringify(path)}`);
-  }
-
-  return segments;
-};
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+import { IValidation } from "../IValidation";
+
+export const _createStandardSchema = <T>(
+  fn: (input: unknown) => IValidation<T>,
+): ((input: unknown) => IValidation<T>) & StandardSchemaV1<unknown, T> =>
+  Object.assign(fn, {
+    "~standard": {
+      version: 1,
+      vendor: "typia",
+      validate: (input: unknown): StandardSchemaV1.Result<T> => {
+        const result = fn(input);
+        if (result.success) {
+          return {
+            value: result.data,
+          } satisfies StandardSchemaV1.SuccessResult<T>;
+        } else {
+          return {
+            issues: result.errors.map((error) => ({
+              message: `expected ${error.expected}, got ${error.value}`,
+              path: typiaPathToStandardSchemaPath(error.path),
+            })),
+          } satisfies StandardSchemaV1.FailureResult;
+        }
+      },
+    },
+  } satisfies StandardSchemaV1<unknown, T>);
+
+enum PathParserState {
+  // Start of a new segment
+  // When the parser is in this state,
+  // the pointer must point `.` or `[` or equal to length of the path
+  Start,
+  // Parsing a property key (`.hoge`)
+  Property,
+  // Parsing a string key (`["fuga"]`)
+  StringKey,
+  // Parsing a number key (`[42]`)
+  NumberKey,
+}
+
+const typiaPathToStandardSchemaPath = (
+  path: string,
+): ReadonlyArray<StandardSchemaV1.PathSegment> => {
+  if (!path.startsWith("$input")) {
+    throw new Error(`Invalid path: ${JSON.stringify(path)}`);
+  }
+
+  const segments: StandardSchemaV1.PathSegment[] = [];
+  let currentSegment = "";
+  let state: PathParserState = PathParserState.Start;
+  let index = "$input".length - 1;
+  while (index < path.length - 1) {
+    index++;
+    const char = path[index];
+
+    if (state === PathParserState.Property) {
+      if (char === "." || char === "[") {
+        // End of property
+        segments.push({
+          key: currentSegment,
+        });
+        state = PathParserState.Start;
+      } else if (index === path.length - 1) {
+        // End of path
+        currentSegment += char;
+        segments.push({
+          key: currentSegment,
+        });
+        index++;
+        state = PathParserState.Start;
+      } else {
+        currentSegment += char;
+      }
+    } else if (state === PathParserState.StringKey) {
+      if (char === '"') {
+        // End of string key
+        segments.push({
+          key: JSON.parse(currentSegment + char),
+        });
+        // Skip `"` and `]`
+        index += 2;
+        state = PathParserState.Start;
+      } else if (char === "\\") {
+        // Skip the next character from parsing
+        currentSegment += path[index];
+        index++;
+        currentSegment += path[index];
+      } else {
+        currentSegment += char;
+      }
+    } else if (state === PathParserState.NumberKey) {
+      if (char === "]") {
+        // End of number key
+        segments.push({
+          key: Number.parseInt(currentSegment),
+        });
+        index++;
+        state = PathParserState.Start;
+      } else {
+        currentSegment += char;
+      }
+    }
+
+    if (state === PathParserState.Start && index < path.length - 1) {
+      const newChar = path[index];
+      currentSegment = "";
+      if (newChar === "[") {
+        if (path[index + 1] === '"') {
+          // Start of string key
+          // NOTE: Typia uses JSON.stringify for this kind of keys, so `'` will not used as a string delimiter
+          state = PathParserState.StringKey;
+          index++;
+          currentSegment = '"';
+        } else {
+          // Start of number key
+          state = PathParserState.NumberKey;
+        }
+      } else if (newChar === ".") {
+        // Start of property
+        state = PathParserState.Property;
+      } else {
+        throw new Error("Unreachable: pointer points invalid character");
+      }
+    }
+  }
+
+  if (state !== PathParserState.Start) {
+    throw new Error(`Failed to parse path: ${JSON.stringify(path)}`);
+  }
+
+  return segments;
+};

package/src/internal/_functionalTypeGuardErrorFactory.ts

@@ -1,4 +1,4 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-export const _functionalTypeGuardErrorFactory = (p: TypeGuardError.IProps) =>
-  new TypeGuardError(p);
+import { TypeGuardError } from "../TypeGuardError";
+
+export const _functionalTypeGuardErrorFactory = (p: TypeGuardError.IProps) =>
+  new TypeGuardError(p);

package/src/internal/_httpFormDataReadArray.ts

@@ -1,4 +1,4 @@
-export const _httpFormDataReadArray = (
-  input: any[],
-  alternative: null | undefined,
-) => (input.length ? input : alternative);
+export const _httpFormDataReadArray = (
+  input: any[],
+  alternative: null | undefined,
+) => (input.length ? input : alternative);

package/src/internal/_httpFormDataReadBigint.ts

@@ -1,18 +1,18 @@
-export const _httpFormDataReadBigint = (
-  input: string | File | null,
-): bigint | null | undefined =>
-  input instanceof File
-    ? (input as any)
-    : !!input?.length
-      ? input === "null"
-        ? null
-        : (toBigint(input) as any)
-      : undefined;
-
-const toBigint = (str: string): bigint | string => {
-  try {
-    return BigInt(str);
-  } catch {
-    return str;
-  }
-};
+export const _httpFormDataReadBigint = (
+  input: string | File | null,
+): bigint | null | undefined =>
+  input instanceof File
+    ? (input as any)
+    : !!input?.length
+      ? input === "null"
+        ? null
+        : (toBigint(input) as any)
+      : undefined;
+
+const toBigint = (str: string): bigint | string => {
+  try {
+    return BigInt(str);
+  } catch {
+    return str;
+  }
+};

package/src/internal/_httpFormDataReadBlob.ts

@@ -1,10 +1,10 @@
-export const _httpFormDataReadBlob = (
-  input: string | Blob | null,
-): Blob | null | undefined =>
-  input instanceof Blob
-    ? input
-    : input === null
-      ? undefined
-      : input === "null"
-        ? null
-        : (input as any);
+export const _httpFormDataReadBlob = (
+  input: string | Blob | null,
+): Blob | null | undefined =>
+  input instanceof Blob
+    ? input
+    : input === null
+      ? undefined
+      : input === "null"
+        ? null
+        : (input as any);

package/src/internal/_httpFormDataReadBoolean.ts

@@ -1,16 +1,16 @@
-export const _httpFormDataReadBoolean = (
-  input: string | File | null,
-): boolean | null | undefined =>
-  input instanceof File
-    ? (input as any)
-    : input === null
-      ? undefined
-      : input === "null"
-        ? null
-        : input.length === 0
-          ? true
-          : input === "true" || input === "1"
-            ? true
-            : input === "false" || input === "0"
-              ? false
-              : (input as any); // wrong type
+export const _httpFormDataReadBoolean = (
+  input: string | File | null,
+): boolean | null | undefined =>
+  input instanceof File
+    ? (input as any)
+    : input === null
+      ? undefined
+      : input === "null"
+        ? null
+        : input.length === 0
+          ? true
+          : input === "true" || input === "1"
+            ? true
+            : input === "false" || input === "0"
+              ? false
+              : (input as any); // wrong type

package/src/internal/_httpFormDataReadFile.ts

@@ -1,10 +1,10 @@
-export const _httpFormDataReadFile = (
-  input: string | File | null,
-): File | null | undefined =>
-  input instanceof File
-    ? input
-    : input === null
-      ? undefined
-      : input === "null"
-        ? null
-        : (input as any);
+export const _httpFormDataReadFile = (
+  input: string | File | null,
+): File | null | undefined =>
+  input instanceof File
+    ? input
+    : input === null
+      ? undefined
+      : input === "null"
+        ? null
+        : (input as any);

package/src/internal/_httpFormDataReadNumber.ts

@@ -1,15 +1,15 @@
-export const _httpFormDataReadNumber = (
-  input: string | File | null,
-): number | null | undefined =>
-  input instanceof File
-    ? (input as any)
-    : !!input?.length
-      ? input === "null"
-        ? null
-        : (toNumber(input) as any)
-      : undefined;
-
-const toNumber = (str: string): number | string => {
-  const value: number = Number(str);
-  return isNaN(value) ? str : value;
-};
+export const _httpFormDataReadNumber = (
+  input: string | File | null,
+): number | null | undefined =>
+  input instanceof File
+    ? (input as any)
+    : !!input?.length
+      ? input === "null"
+        ? null
+        : (toNumber(input) as any)
+      : undefined;
+
+const toNumber = (str: string): number | string => {
+  const value: number = Number(str);
+  return isNaN(value) ? str : value;
+};

package/src/internal/_httpFormDataReadString.ts

@@ -1,10 +1,10 @@
-export const _httpFormDataReadString = (
-  input: string | File | null,
-): string | null | undefined =>
-  input instanceof File
-    ? (input as any)
-    : input === null
-      ? undefined
-      : input === "null"
-        ? null
-        : input;
+export const _httpFormDataReadString = (
+  input: string | File | null,
+): string | null | undefined =>
+  input instanceof File
+    ? (input as any)
+    : input === null
+      ? undefined
+      : input === "null"
+        ? null
+        : input;

package/src/internal/_httpHeaderReadBigint.ts

@@ -1,10 +1,10 @@
-export const _httpHeaderReadBigint = (value: string | undefined) =>
-  value !== undefined ? toBigint(value) : undefined;
-
-const toBigint = (str: string): bigint | string => {
-  try {
-    return BigInt(str);
-  } catch {
-    return str;
-  }
-};
+export const _httpHeaderReadBigint = (value: string | undefined) =>
+  value !== undefined ? toBigint(value) : undefined;
+
+const toBigint = (str: string): bigint | string => {
+  try {
+    return BigInt(str);
+  } catch {
+    return str;
+  }
+};

package/src/internal/_httpHeaderReadBoolean.ts

@@ -1,8 +1,8 @@
-export const _httpHeaderReadBoolean = (value: string | undefined) =>
-  value !== undefined
-    ? value === "true"
-      ? true
-      : value === "false"
-        ? false
-        : value
-    : undefined;
+export const _httpHeaderReadBoolean = (value: string | undefined) =>
+  value !== undefined
+    ? value === "true"
+      ? true
+      : value === "false"
+        ? false
+        : value
+    : undefined;

package/src/internal/_httpHeaderReadNumber.ts

@@ -1,7 +1,7 @@
-export const _httpHeaderReadNumber = (value: string | undefined) =>
-  value !== undefined ? toNumber(value) : undefined;
-
-const toNumber = (str: string): number | string => {
-  const value: number = Number(str);
-  return isNaN(value) ? str : value;
-};
+export const _httpHeaderReadNumber = (value: string | undefined) =>
+  value !== undefined ? toNumber(value) : undefined;
+
+const toNumber = (str: string): number | string => {
+  const value: number = Number(str);
+  return isNaN(value) ? str : value;
+};

package/src/internal/_httpParameterReadBigint.ts

@@ -1,10 +1,10 @@
-export const _httpParameterReadBigint = (value: string) =>
-  value !== "null" ? toBigint(value) : null;
-
-const toBigint = (str: string): bigint | string => {
-  try {
-    return BigInt(str);
-  } catch {
-    return str;
-  }
-};
+export const _httpParameterReadBigint = (value: string) =>
+  value !== "null" ? toBigint(value) : null;
+
+const toBigint = (str: string): bigint | string => {
+  try {
+    return BigInt(str);
+  } catch {
+    return str;
+  }
+};

package/src/internal/_httpParameterReadBoolean.ts

@@ -1,8 +1,8 @@
-export const _httpParameterReadBoolean = (value: string) =>
-  value !== "null"
-    ? value === "true" || value === "1"
-      ? true
-      : value === "false" || value === "0"
-        ? false
-        : value
-    : null;
+export const _httpParameterReadBoolean = (value: string) =>
+  value !== "null"
+    ? value === "true" || value === "1"
+      ? true
+      : value === "false" || value === "0"
+        ? false
+        : value
+    : null;

package/src/internal/_httpParameterReadNumber.ts

@@ -1,7 +1,7 @@
-export const _httpParameterReadNumber = (value: string) =>
-  value !== "null" ? toNumber(value) : null;
-
-const toNumber = (str: string): number | string => {
-  const value: number = Number(str);
-  return isNaN(value) ? str : value;
-};
+export const _httpParameterReadNumber = (value: string) =>
+  value !== "null" ? toNumber(value) : null;
+
+const toNumber = (str: string): number | string => {
+  const value: number = Number(str);
+  return isNaN(value) ? str : value;
+};

package/src/internal/_httpParameterReadString.ts

@@ -1,2 +1,2 @@
-export const _httpParameterReadString = (value: string) =>
-  value !== "null" ? value : null;
+export const _httpParameterReadString = (value: string) =>
+  value !== "null" ? value : null;

package/src/internal/_httpQueryParseURLSearchParams.ts

@@ -1,12 +1,12 @@
-import { IReadableURLSearchParams } from "../IReadableURLSearchParams";
-
-export const _httpQueryParseURLSearchParams = (
-  input: string | IReadableURLSearchParams,
-): IReadableURLSearchParams => {
-  if (typeof input === "string") {
-    const index: number = input.indexOf("?");
-    input = index === -1 ? "" : input.substring(index + 1);
-    return new URLSearchParams(input);
-  }
-  return input;
-};
+import { IReadableURLSearchParams } from "../IReadableURLSearchParams";
+
+export const _httpQueryParseURLSearchParams = (
+  input: string | IReadableURLSearchParams,
+): IReadableURLSearchParams => {
+  if (typeof input === "string") {
+    const index: number = input.indexOf("?");
+    input = index === -1 ? "" : input.substring(index + 1);
+    return new URLSearchParams(input);
+  }
+  return input;
+};

package/src/internal/_httpQueryReadArray.ts

@@ -1,4 +1,4 @@
-export const _httpQueryReadArray = (
-  input: any[],
-  alternative: null | undefined,
-) => (input.length ? input : alternative);
+export const _httpQueryReadArray = (
+  input: any[],
+  alternative: null | undefined,
+) => (input.length ? input : alternative);

package/src/internal/_httpQueryReadBigint.ts

@@ -1,12 +1,12 @@
-export const _httpQueryReadBigint = (
-  str: string | null,
-): bigint | null | undefined =>
-  !!str?.length ? (str === "null" ? null : (toBigint(str) as any)) : undefined;
-
-const toBigint = (str: string): bigint | string => {
-  try {
-    return BigInt(str);
-  } catch {
-    return str;
-  }
-};
+export const _httpQueryReadBigint = (
+  str: string | null,
+): bigint | null | undefined =>
+  !!str?.length ? (str === "null" ? null : (toBigint(str) as any)) : undefined;
+
+const toBigint = (str: string): bigint | string => {
+  try {
+    return BigInt(str);
+  } catch {
+    return str;
+  }
+};