typia 7.0.0-dev.20241003 → 7.0.0-dev.20241005

package/src/internal/$ProtobufReader.ts

@@ -0,0 +1,194 @@
+import { ProtobufWire } from "../programmers/helpers/ProtobufWire";
+
+import { Singleton } from "../utils/Singleton";
+
+/// @reference https://github.com/piotr-oles/as-proto/blob/main/packages/as-proto/assembly/internal/FixedReader.ts
+export class $ProtobufReader {
+  /**
+   * Read buffer
+   */
+  private buf: Uint8Array;
+
+  /**
+   * Read buffer pointer.
+   */
+  private ptr: number;
+
+  /**
+   * DataView for buffer.
+   */
+  private view: DataView;
+
+  public constructor(buf: Uint8Array) {
+    this.buf = buf;
+    this.ptr = 0;
+    this.view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+  }
+
+  public index(): number {
+    return this.ptr;
+  }
+
+  public size(): number {
+    return this.buf.length;
+  }
+
+  public uint32(): number {
+    return this.varint32();
+  }
+
+  public int32(): number {
+    return this.varint32();
+  }
+
+  public sint32(): number {
+    const value: number = this.varint32();
+    return (value >>> 1) ^ -(value & 1);
+  }
+
+  public uint64(): bigint {
+    return this.varint64();
+  }
+
+  public int64(): bigint {
+    return this.varint64();
+  }
+
+  public sint64(): bigint {
+    const value = this.varint64();
+    return (value >> BigInt(0x01)) ^ -(value & BigInt(0x01));
+  }
+
+  public bool(): boolean {
+    return this.varint32() !== 0;
+  }
+
+  public float(): number {
+    const value: number = this.view.getFloat32(this.ptr, true);
+    this.ptr += 4;
+    return value;
+  }
+
+  public double(): number {
+    const value: number = this.view.getFloat64(this.ptr, true);
+    this.ptr += 8;
+    return value;
+  }
+
+  public bytes(): Uint8Array {
+    const length: number = this.uint32();
+    const from: number = this.ptr;
+    this.ptr += length;
+    return this.buf.subarray(from, from + length);
+  }
+
+  public string(): string {
+    return utf8.get().decode(this.bytes());
+  }
+
+  public skip(length: number): void {
+    if (length === 0) while (this.u8() & 0x80);
+    else {
+      if (this.index() + length > this.size())
+        throw new Error("Error on typia.protobuf.decode(): buffer overflow.");
+      this.ptr += length;
+    }
+  }
+
+  public skipType(wireType: ProtobufWire): void {
+    switch (wireType) {
+      case ProtobufWire.VARIANT:
+        this.skip(0);
+        break;
+      case ProtobufWire.I64:
+        this.skip(8);
+        break;
+      case ProtobufWire.LEN:
+        this.skip(this.uint32());
+        break;
+      case ProtobufWire.START_GROUP:
+        while ((wireType = this.uint32() & 0x07) !== ProtobufWire.END_GROUP)
+          this.skipType(wireType);
+        break;
+      case ProtobufWire.I32:
+        this.skip(4);
+        break;
+      default:
+        throw new Error(`Invalid wire type ${wireType} at offset ${this.ptr}.`);
+    }
+  }
+
+  private varint32(): number {
+    let loaded: number;
+    let value: number;
+
+    value = (loaded = this.u8()) & 0x7f;
+    if (loaded < 0x80) return value;
+
+    value |= ((loaded = this.u8()) & 0x7f) << 7;
+    if (loaded < 0x80) return value;
+
+    value |= ((loaded = this.u8()) & 0x7f) << 14;
+    if (loaded < 0x80) return value;
+
+    value |= ((loaded = this.u8()) & 0x7f) << 21;
+    if (loaded < 0x80) return value;
+
+    value |= ((loaded = this.u8()) & 0xf) << 28;
+    if (loaded < 0x80) return value;
+
+    // increment position until there is no continuation bit or until we read 10 bytes
+    if (this.u8() < 0x80) return value;
+    if (this.u8() < 0x80) return value;
+    if (this.u8() < 0x80) return value;
+    if (this.u8() < 0x80) return value;
+    if (this.u8() < 0x80) return value;
+
+    return value;
+  }
+
+  private varint64(): bigint {
+    let loaded: bigint;
+    let value: bigint;
+
+    value = (loaded = this.u8n()) & BigInt(0x7f);
+    if (loaded < BigInt(0x80)) return value;
+
+    value |= ((loaded = this.u8n()) & BigInt(0x7f)) << BigInt(7);
+    if (loaded < BigInt(0x80)) return value;
+
+    value |= ((loaded = this.u8n()) & BigInt(0x7f)) << BigInt(14);
+    if (loaded < BigInt(0x80)) return value;
+
+    value |= ((loaded = this.u8n()) & BigInt(0x7f)) << BigInt(21);
+    if (loaded < BigInt(0x80)) return value;
+
+    value |= ((loaded = this.u8n()) & BigInt(0x7f)) << BigInt(28);
+    if (loaded < BigInt(0x80)) return value;
+
+    value |= ((loaded = this.u8n()) & BigInt(0x7f)) << BigInt(35);
+    if (loaded < BigInt(0x80)) return value;
+
+    value |= ((loaded = this.u8n()) & BigInt(0x7f)) << BigInt(42);
+    if (loaded < BigInt(0x80)) return value;
+
+    value |= ((loaded = this.u8n()) & BigInt(0x7f)) << BigInt(49);
+    if (loaded < BigInt(0x80)) return value;
+
+    value |= ((loaded = this.u8n()) & BigInt(0x7f)) << BigInt(56);
+    if (loaded < BigInt(0x80)) return value;
+
+    value |= (this.u8n() & BigInt(0x01)) << BigInt(63);
+    return BigInt.asIntN(64, value);
+  }
+
+  private u8(): number {
+    return this.view.getUint8(this.ptr++);
+  }
+
+  private u8n(): bigint {
+    return BigInt(this.u8());
+  }
+}
+
+const utf8 = /** @__PURE__ */ new Singleton(() => new TextDecoder("utf-8"));

package/src/internal/$ProtobufSizer.ts

@@ -0,0 +1,151 @@
+import { $__IProtobufWriter } from "./private/$__IProtobufWriter";
+
+/// @reference https://github.com/piotr-oles/as-proto/blob/main/packages/as-proto/assembly/internal/FixedSizer.ts
+export class $ProtobufSizer implements $__IProtobufWriter {
+  /**
+   * Total length.
+   */
+  public len: number;
+
+  /**
+   * Position stack.
+   */
+  public readonly pos: Array<number>;
+
+  /**
+   * Variable length list.
+   */
+  public readonly varlen: Array<number>;
+
+  /**
+   * Variable length index stack.
+   */
+  public readonly varlenidx: Array<number>;
+
+  public constructor(length: number = 0) {
+    this.len = length;
+    this.pos = [];
+    this.varlen = [];
+    this.varlenidx = [];
+  }
+
+  public bool(): void {
+    this.len += 1;
+  }
+  public int32(value: number): void {
+    if (value < 0) {
+      // 10 bytes to encode negative number
+      this.len += 10;
+    } else {
+      this.varint32(value);
+    }
+  }
+  public sint32(value: number): void {
+    this.varint32((value << 1) ^ (value >> 31));
+  }
+  public uint32(value: number): void {
+    this.varint32(value);
+  }
+
+  public int64(value: bigint | number): void {
+    this.varint64(typeof value === "number" ? BigInt(value) : value);
+  }
+  public sint64(value: bigint | number): void {
+    if (typeof value === "number") value = BigInt(value);
+    this.varint64((value << BigInt(1)) ^ (value >> BigInt(63)));
+  }
+  public uint64(value: bigint | number): void {
+    this.varint64(typeof value === "number" ? BigInt(value) : value);
+  }
+
+  // public fixed32(_value: number): void {
+  //     this.len += 4;
+  // }
+  // public sfixed32(_value: number): void {
+  //     this.len += 4;
+  // }
+  // public fixed64(_value: number | bigint): void {
+  //     this.len += 8;
+  // }
+  // public sfixed64(_value: number | bigint): void {
+  //     this.len += 8;
+  // }
+  public float(_value: number): void {
+    this.len += 4;
+  }
+  public double(_value: number): void {
+    this.len += 8;
+  }
+
+  public bytes(value: Uint8Array): void {
+    this.uint32(value.byteLength);
+    this.len += value.byteLength;
+  }
+  public string(value: string): void {
+    const len: number = strlen(value);
+    this.varlen.push(len);
+    this.uint32(len);
+    this.len += len;
+  }
+
+  public fork(): void {
+    this.pos.push(this.len); // save current position
+    this.varlenidx.push(this.varlen.length); // save current index in varlen array
+    this.varlen.push(0); // add 0 length to varlen array (to be updated in ldelim())
+  }
+
+  public ldelim(): void {
+    if (!(this.pos.length && this.varlenidx.length))
+      throw new Error(
+        "Error on typia.protobuf.encode(): missing fork() before ldelim() call.",
+      );
+
+    const endPos = this.len; // current position is end position
+    const startPos = this.pos.pop()!; // get start position from stack
+    const idx = this.varlenidx.pop()!; // get varlen index from stack
+    const len = endPos - startPos; // calculate length
+
+    this.varlen[idx] = len; // update variable length
+    this.uint32(len); // add uint32 that should be called in fork()
+  }
+
+  public reset(): void {
+    this.len = 0;
+    // re-use arrays
+    this.pos.length = 0;
+    this.varlen.length = 0;
+    this.varlenidx.length = 0;
+  }
+
+  private varint32(value: number): void {
+    this.len +=
+      value < 0
+        ? 10 // 10 bits with leading 1's
+        : value < 0x80
+          ? 1
+          : value < 0x4000
+            ? 2
+            : value < 0x200000
+              ? 3
+              : value < 0x10000000
+                ? 4
+                : 5;
+  }
+
+  private varint64(val: bigint): void {
+    val = BigInt.asUintN(64, val);
+    while (val > BigInt(0x7f)) {
+      ++this.len;
+      val = val >> BigInt(0x07);
+    }
+    ++this.len;
+  }
+}
+
+const strlen = (s: string): number => {
+  let b: number;
+  let i: number;
+  let c: number;
+  for (b = i = 0; (c = s.charCodeAt(i++)); b += c >> 11 ? 3 : c >> 7 ? 2 : 1);
+  return b;
+};

package/src/internal/$ProtobufWriter.ts

@@ -0,0 +1,145 @@
+import { Singleton } from "../utils/Singleton";
+
+import { $ProtobufSizer } from "./$ProtobufSizer";
+import { $__IProtobufWriter } from "./private/$__IProtobufWriter";
+
+/// @reference https://github.com/piotr-oles/as-proto/blob/main/packages/as-proto/assembly/internal/FixedWriter.ts
+export class $ProtobufWriter implements $__IProtobufWriter {
+  /**
+   * Related sizer
+   */
+  private readonly sizer: $ProtobufSizer;
+
+  /**
+   * Current pointer.
+   */
+  private ptr: number;
+
+  /**
+   * Protobuf buffer.
+   */
+  private buf: Uint8Array;
+
+  /**
+   * DataView for buffer.
+   */
+  private view: DataView;
+
+  /**
+   * Index in varlen array from sizer.
+   */
+  private varlenidx: number;
+
+  constructor(sizer: $ProtobufSizer) {
+    this.sizer = sizer;
+    this.buf = new Uint8Array(sizer.len);
+    this.view = new DataView(this.buf.buffer);
+    this.ptr = 0;
+    this.varlenidx = 0;
+  }
+
+  buffer(): Uint8Array {
+    return this.buf;
+  }
+
+  bool(value: boolean): void {
+    this.byte(value ? 1 : 0);
+  }
+
+  byte(value: number): void {
+    this.buf[this.ptr++] = value & 255;
+  }
+
+  int32(value: number): void {
+    if (value < 0) this.int64(value);
+    else this.variant32(value >>> 0);
+  }
+
+  sint32(value: number): void {
+    this.variant32((value << 1) ^ (value >> 31));
+  }
+
+  uint32(value: number): void {
+    this.variant32(value);
+  }
+
+  sint64(value: number | bigint): void {
+    value = BigInt(value);
+    this.variant64((value << BigInt(0x01)) ^ (value >> BigInt(0x3f)));
+  }
+
+  int64(value: number | bigint): void {
+    this.variant64(BigInt(value));
+  }
+
+  uint64(value: number | bigint): void {
+    this.variant64(BigInt(value));
+  }
+
+  float(val: number): void {
+    this.view.setFloat32(this.ptr, val, true);
+    this.ptr += 4;
+  }
+
+  double(val: number): void {
+    this.view.setFloat64(this.ptr, val, true);
+    this.ptr += 8;
+  }
+
+  bytes(value: Uint8Array): void {
+    this.uint32(value.byteLength);
+    for (let i = 0; i < value.byteLength; i++) this.buf[this.ptr++] = value[i]!;
+  }
+
+  string(value: string): void {
+    const len: number = this.varlen(); // use precomputed length
+    this.uint32(len);
+
+    const binary: Uint8Array = utf8.get().encode(value);
+    for (let i = 0; i < binary.byteLength; i++)
+      this.buf[this.ptr++] = binary[i]!;
+  }
+
+  fork(): void {
+    this.uint32(this.varlen()); // use precomputed length
+  }
+
+  ldelim(): void {
+    // nothing to do - all dirty work done by sizer
+  }
+
+  finish(): Uint8Array {
+    return this.buf;
+  }
+
+  reset(): void {
+    this.buf = new Uint8Array(this.sizer.len);
+    this.view = new DataView(this.buf.buffer);
+    this.ptr = 0;
+    this.varlenidx = 0;
+  }
+
+  private variant32(val: number): void {
+    while (val > 0x7f) {
+      this.buf[this.ptr++] = (val & 0x7f) | 0x80;
+      val = val >>> 7;
+    }
+    this.buf[this.ptr++] = val;
+  }
+
+  private variant64(val: bigint): void {
+    val = BigInt.asUintN(64, val);
+    while (val > BigInt(0x7f)) {
+      this.buf[this.ptr++] = Number((val & BigInt(0x7f)) | BigInt(0x80));
+      val = val >> BigInt(0x07);
+    }
+    this.buf[this.ptr++] = Number(val);
+  }
+
+  private varlen(): number {
+    return this.varlenidx >= this.sizer.varlen.length
+      ? 0
+      : this.sizer.varlen[this.varlenidx++]!;
+  }
+}
+const utf8 = /** @__PURE__ */ new Singleton(() => new TextEncoder());

package/src/internal/$accessExpressionAsString.ts

@@ -0,0 +1,46 @@
+export const $accessExpressionAsString = (str: string): string =>
+  variable(str) ? `.${str}` : `[${JSON.stringify(str)}]`;
+
+const variable = (str: string): boolean =>
+  reserved(str) === false && /^[a-zA-Z_$][a-zA-Z_$0-9]*$/g.test(str);
+
+const reserved = (str: string): boolean => RESERVED.has(str);
+
+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",
+  "new",
+  "null",
+  "return",
+  "super",
+  "switch",
+  "this",
+  "throw",
+  "true",
+  "try",
+  "typeof",
+  "var",
+  "void",
+  "while",
+  "with",
+]);

package/src/internal/$assertGuard.ts

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

package/src/internal/$functionalTypeGuardErrorFactory.ts

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

package/src/internal/$httpFormDataReadArray.ts

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

package/src/internal/$httpFormDataReadBigint.ts

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

package/src/internal/$httpFormDataReadBlob.ts

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

package/src/internal/$httpFormDataReadBoolean.ts

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

package/src/internal/$httpFormDataReadFile.ts

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

package/src/internal/$httpFormDataReadNumber.ts

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

package/src/internal/$httpFormDataReadString.ts

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

package/src/internal/$httpHeaderReadBigint.ts

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

package/src/internal/$httpHeaderReadBoolean.ts

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

package/src/internal/$httpHeaderReadNumber.ts

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

package/src/internal/$httpParameterBigint.ts

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

package/src/internal/$httpParameterBoolean.ts

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