typia 9.1.1 → 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

@@ -0,0 +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;
+};

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;
+  }
+};

package/src/internal/_httpQueryReadBoolean.ts

@@ -1,14 +1,14 @@
-export const _httpQueryReadBoolean = (
-  str: string | null,
-): boolean | null | undefined =>
-  str === null
-    ? undefined
-    : str === "null"
-      ? null
-      : str.length === 0
-        ? true
-        : str === "true" || str === "1"
-          ? true
-          : str === "false" || str === "0"
-            ? false
-            : (str as any); // wrong type
+export const _httpQueryReadBoolean = (
+  str: string | null,
+): boolean | null | undefined =>
+  str === null
+    ? undefined
+    : str === "null"
+      ? null
+      : str.length === 0
+        ? true
+        : str === "true" || str === "1"
+          ? true
+          : str === "false" || str === "0"
+            ? false
+            : (str as any); // wrong type

package/src/internal/_httpQueryReadNumber.ts

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

package/src/internal/_httpQueryReadString.ts

@@ -1,4 +1,4 @@
-export const _httpQueryReadString = (
-  str: string | null,
-): string | null | undefined =>
-  str === null ? undefined : str === "null" ? null : str;
+export const _httpQueryReadString = (
+  str: string | null,
+): string | null | undefined =>
+  str === null ? undefined : str === "null" ? null : str;

package/src/internal/_isBetween.ts

@@ -1,2 +1,2 @@
-export const _isBetween = (value: number, minimum: number, maximum: number) =>
-  minimum <= value && value <= maximum;
+export const _isBetween = (value: number, minimum: number, maximum: number) =>
+  minimum <= value && value <= maximum;

package/src/internal/_isBigintString.ts

@@ -1,8 +1,8 @@
-export const _isBigintString = (str: string): boolean => {
-  try {
-    BigInt(str);
-    return true;
-  } catch {
-    return false;
-  }
-};
+export const _isBigintString = (str: string): boolean => {
+  try {
+    BigInt(str);
+    return true;
+  } catch {
+    return false;
+  }
+};

package/src/internal/_isFormatByte.ts

@@ -1,7 +1,7 @@
-export const _isFormatByte = (str: string): boolean => {
-  PATTERN.lastIndex = 0;
-  return PATTERN.test(str);
-};
-
-const PATTERN =
-  /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/gm;
+export const _isFormatByte = (str: string): boolean => {
+  PATTERN.lastIndex = 0;
+  return PATTERN.test(str);
+};
+
+const PATTERN =
+  /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/gm;

package/src/internal/_isFormatDate.ts

@@ -1,3 +1,3 @@
-export const _isFormatDate = (str: string): boolean => FORMAT.test(str);
-
-const FORMAT = /^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$/;
+export const _isFormatDate = (str: string): boolean => FORMAT.test(str);
+
+const FORMAT = /^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$/;

package/src/internal/_isFormatDateTime.ts

@@ -1,4 +1,4 @@
-export const _isFormatDateTime = (str: string): boolean => PATTERN.test(str);
-
-const PATTERN =
-  /^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])(T|\s)([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.[0-9]{1,9})?(Z|[+-]([01][0-9]|2[0-3]):[0-5][0-9])$/i;
+export const _isFormatDateTime = (str: string): boolean => PATTERN.test(str);
+
+const PATTERN =
+  /^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])(T|\s)([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.[0-9]{1,9})?(Z|[+-]([01][0-9]|2[0-3]):[0-5][0-9])$/i;

package/src/internal/_isFormatDuration.ts

@@ -1,4 +1,4 @@
-export const _isFormatDuration = (str: string): boolean => PATTERN.test(str);
-
-const PATTERN =
-  /^P(?!$)((\d+Y)?(\d+M)?(\d+D)?(T(?=\d)(\d+H)?(\d+M)?(\d+S)?)?|(\d+W)?)$/;
+export const _isFormatDuration = (str: string): boolean => PATTERN.test(str);
+
+const PATTERN =
+  /^P(?!$)((\d+Y)?(\d+M)?(\d+D)?(T(?=\d)(\d+H)?(\d+M)?(\d+S)?)?|(\d+W)?)$/;