@agentica/core 0.36.2 → 0.36.3

package/lib/utils/stringifyValidateFailure.js

@@ -1,201 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.stringifyValidateFailure = stringifyValidateFailure;
-const Escaper_1 = require("typia/lib/utils/Escaper");
-function stringifyValidateFailure(failure) {
-    return stringify({
-        value: failure.data,
-        errors: failure.errors,
-        path: "$input",
-        tab: 0,
-        inArray: false,
-        inToJson: false,
-    });
-}
-function stringify(props) {
-    var _a;
-    const { value, errors, path, tab, inArray, inToJson } = props;
-    const indent = "  ".repeat(tab);
-    const errorComment = getErrorComment(path, errors);
-    // Handle undefined in arrays
-    if (inArray && value === undefined) {
-        return `${indent}undefined${errorComment}`;
-    }
-    // Array
-    if (Array.isArray(value)) {
-        if (value.length === 0) {
-            return `${indent}[]${errorComment}`;
-        }
-        const lines = [];
-        lines.push(`${indent}[${errorComment}`);
-        value.forEach((item, index) => {
-            const itemPath = `${path}[${index}]`;
-            let itemStr = stringify({
-                value: item,
-                errors,
-                path: itemPath,
-                tab: tab + 1,
-                inArray: true,
-                inToJson: false,
-            });
-            // Add comma before the error comment if not the last element
-            if (index < value.length - 1) {
-                const itemLines = itemStr.split("\n");
-                const lastLine = itemLines[itemLines.length - 1];
-                const commentIndex = lastLine.indexOf(" //");
-                if (commentIndex !== -1) {
-                    itemLines[itemLines.length - 1]
-                        = `${lastLine.slice(0, commentIndex)},${lastLine.slice(commentIndex)}`;
-                }
-                else {
-                    itemLines[itemLines.length - 1] += ",";
-                }
-                itemStr = itemLines.join("\n");
-            }
-            lines.push(itemStr);
-        });
-        lines.push(`${indent}]`);
-        return lines.join("\n");
-    }
-    // Object
-    if (typeof value === "object" && value !== null) {
-        // Check for toJSON method
-        if (!inToJson && typeof value.toJSON === "function") {
-            const jsonValue = value.toJSON();
-            return stringify({
-                value: jsonValue,
-                errors,
-                path,
-                tab,
-                inArray,
-                inToJson: true,
-            });
-        }
-        // Get existing entries (filter out undefined values from actual data)
-        const existingEntries = Object.entries(value).filter(([_, val]) => val !== undefined);
-        // Find missing properties that have validation errors
-        const missingKeys = getMissingProperties(path, value, errors);
-        // Combine existing and missing properties
-        const allKeys = [
-            ...existingEntries.map(([key]) => key),
-            ...missingKeys,
-        ];
-        if (allKeys.length === 0) {
-            return `${indent}{}${errorComment}`;
-        }
-        const lines = [];
-        lines.push(`${indent}{${errorComment}`);
-        allKeys.forEach((key, index, array) => {
-            const propPath = Escaper_1.Escaper.variable(key)
-                ? `${path}.${key}`
-                : `${path}[${JSON.stringify(key)}]`;
-            const propIndent = "  ".repeat(tab + 1);
-            // Get the value (undefined for missing properties)
-            const val = missingKeys.includes(key) ? undefined : value[key];
-            // Primitive property value (including undefined for missing properties)
-            if (val === undefined
-                || val === null
-                || typeof val === "boolean"
-                || typeof val === "number"
-                || typeof val === "string") {
-                const propErrorComment = getErrorComment(propPath, errors);
-                const valueStr = val === undefined
-                    ? `${propIndent}"${key}": undefined`
-                    : `${propIndent}"${key}": ${JSON.stringify(val)}`;
-                const withComma = index < array.length - 1 ? `${valueStr},` : valueStr;
-                const line = withComma + propErrorComment;
-                lines.push(line);
-            }
-            // Complex property value (object or array)
-            else {
-                const keyLine = `${propIndent}"${key}": `;
-                let valStr = stringify({
-                    value: val,
-                    errors,
-                    path: propPath,
-                    tab: tab + 1,
-                    inArray: false,
-                    inToJson: false,
-                });
-                const valStrWithoutIndent = valStr.trimStart();
-                // Add comma before the error comment if not the last property
-                if (index < array.length - 1) {
-                    const valLines = valStrWithoutIndent.split("\n");
-                    const lastLine = valLines[valLines.length - 1];
-                    const commentIndex = lastLine.indexOf(" //");
-                    if (commentIndex !== -1) {
-                        valLines[valLines.length - 1]
-                            = `${lastLine.slice(0, commentIndex)},${lastLine.slice(commentIndex)}`;
-                    }
-                    else {
-                        valLines[valLines.length - 1] += ",";
-                    }
-                    valStr = valLines.join("\n");
-                }
-                else {
-                    valStr = valStrWithoutIndent;
-                }
-                const combined = keyLine + valStr;
-                lines.push(combined);
-            }
-        });
-        lines.push(`${indent}}`);
-        return lines.join("\n");
-    }
-    // Primitive types (null, boolean, number, string, undefined, etc.)
-    const valStr = value === undefined
-        ? "undefined"
-        : ((_a = JSON.stringify(value)) !== null && _a !== void 0 ? _a : String(value));
-    return `${indent}${valStr}${errorComment}`;
-}
-/** Get error comment for a given path */
-function getErrorComment(path, errors) {
-    const pathErrors = errors.filter((e) => e.path === path);
-    if (pathErrors.length === 0) {
-        return "";
-    }
-    return ` // ❌ ${JSON.stringify(pathErrors.map(e => ({
-        path: e.path,
-        expected: e.expected,
-        description: e.description,
-    })))}`;
-}
-/**
- * Find missing properties that have validation errors but don't exist in the data
- * Returns array of property keys that should be displayed as undefined
- */
-function getMissingProperties(path, value, errors) {
-    const missingKeys = new Set();
-    for (const e of errors) {
-        // Check if error.path is a direct child of current path
-        const childKey = extractDirectChildKey(path, e.path);
-        if (childKey !== null) {
-            // Check if this property actually exists in the value
-            if (!(childKey in value)) {
-                missingKeys.add(childKey);
-            }
-        }
-    }
-    return Array.from(missingKeys);
-}
-/**
- * Extract direct child property key if errorPath is a direct child of parentPath
- * Returns null if not a direct child
- *
- * Examples:
- * - extractDirectChildKey("$input", "$input.email") => "email"
- * - extractDirectChildKey("$input", "$input.user.email") => null (grandchild)
- * - extractDirectChildKey("$input.user", "$input.user.email") => "email"
- * - extractDirectChildKey("$input", "$input[0]") => null (array index, not object property)
- */
-function extractDirectChildKey(parentPath, errorPath) {
-    if (!errorPath.startsWith(parentPath)) {
-        return null;
-    }
-    const suffix = errorPath.slice(parentPath.length);
-    // Match ".propertyName" pattern (direct child property)
-    // Should not contain additional dots or brackets after the property name
-    const match = suffix.match(/^\.([^.[\]]+)$/);
-    return match !== null ? match[1] : null;
-}
-//# sourceMappingURL=stringifyValidateFailure.js.map

package/lib/utils/stringifyValidateFailure.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stringifyValidateFailure.js","sourceRoot":"","sources":["../../src/utils/stringifyValidateFailure.ts"],"names":[],"mappings":"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"}

package/src/utils/JsonUtil.spec.ts

@@ -1,190 +0,0 @@
-import { JsonUtil } from "./JsonUtil";
-
-describe("jsonUtil", () => {
-  describe("parse", () => {
-    describe("normal Operations", () => {
-      it("should parse standard valid JSON", () => {
-        const jsonString = "{\"normal\": \"json\"}";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual({ normal: "json" });
-      });
-
-      it("should handle object with '{}' prefix", () => {
-        const jsonString = "{}{\"name\": \"test\", \"value\": 42}";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual({ name: "test", value: 42 });
-      });
-
-      it("should handle array with '{}' prefix", () => {
-        const jsonString = "{}[1, 2, 3, \"test\"]";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual([1, 2, 3, "test"]);
-      });
-
-      it("should handle primitive values with '{}' prefix", () => {
-        expect(JsonUtil.parse("{}42")).toBe(42);
-        expect(JsonUtil.parse("{}\"hello\"")).toBe("hello");
-        expect(JsonUtil.parse("{}true")).toBe(true);
-        expect(JsonUtil.parse("{}null")).toBeNull();
-      });
-
-      it("should remove trailing comma in object", () => {
-        const jsonString = "{\"name\": \"test\", \"value\": 42,}";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual({ name: "test", value: 42 });
-      });
-
-      it("should remove trailing comma in array", () => {
-        const jsonString = "[1, 2, 3, \"test\",]";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual([1, 2, 3, "test"]);
-      });
-
-      it("should add missing closing brace in object", () => {
-        const jsonString = "{\"name\": \"test\", \"value\": 42";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual({ name: "test", value: 42 });
-      });
-
-      it("should add missing closing bracket in array", () => {
-        const jsonString = "[1, 2, 3, \"test\"";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual([1, 2, 3, "test"]);
-      });
-    });
-
-    describe("combined Features", () => {
-      it("should handle '{}' prefix and missing closing brace together", () => {
-        const jsonString = "{}{\"name\": \"test\", \"value\": 42";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual({ name: "test", value: 42 });
-      });
-
-      it("should handle '{}' prefix and missing closing bracket together", () => {
-        const jsonString = "{}[1, 2, 3, \"test\"";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual([1, 2, 3, "test"]);
-      });
-
-      it("should handle trailing comma in nested objects", () => {
-        const jsonString = "{\"user\": {\"id\": 1, \"name\": \"John\",}, \"active\": true,}";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual({
-          user: { id: 1, name: "John" },
-          active: true,
-        });
-      });
-
-      it("should handle missing closing brace in nested objects", () => {
-        const jsonString = "{\"user\": {\"id\": 1, \"name\": \"John\"}";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual({
-          user: { id: 1, name: "John" },
-        });
-      });
-
-      it("should handle missing closing brace in complex nested structure", () => {
-        const jsonString = "{\"users\": [{\"id\": 1, \"name\": \"John\"}, {\"id\": 2, \"name\": \"Jane\"}], \"count\": 2";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual({
-          users: [
-            { id: 1, name: "John" },
-            { id: 2, name: "Jane" },
-          ],
-          count: 2,
-        });
-      });
-
-      it("should apply all correction features together", () => {
-        const jsonString = "{}{\"name\": \"test\", \"items\": [1, 2, 3,], \"user\": {\"id\": 1, \"name\": \"John\",}";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual({
-          name: "test",
-          items: [1, 2, 3],
-          user: { id: 1, name: "John" },
-        });
-      });
-
-      it("should handle all issues simultaneously in complex nested structure", () => {
-        const jsonString = "{}{\"data\": {\"users\": [{\"id\": 1, \"name\": \"John\",}, {\"id\": 2, \"name\": \"Jane\",}], \"meta\": {\"total\": 2, \"page\": 1,}}, \"status\": \"ok\",";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual({
-          data: {
-            users: [
-              { id: 1, name: "John" },
-              { id: 2, name: "Jane" },
-            ],
-            meta: { total: 2, page: 1 },
-          },
-          status: "ok",
-        });
-      });
-    });
-
-    describe("edge Cases", () => {
-      it("should handle empty object with '{}' prefix", () => {
-        const jsonString = "{}{}";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual({});
-      });
-
-      it("should handle empty array with '{}' prefix", () => {
-        const jsonString = "{}[]";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual([]);
-      });
-
-      it("should handle nested object with '{}' prefix", () => {
-        const jsonString = "{}{\"user\": {\"id\": 1, \"name\": \"John\"}}";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual({
-          user: { id: 1, name: "John" },
-        });
-      });
-
-      it("should handle multiple trailing commas", () => {
-        const jsonString = "{\"items\": [1, 2, 3,,,], \"count\": 3,,,}";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual({
-          items: [1, 2, 3],
-          count: 3,
-        });
-      });
-
-      it("should handle JSON with whitespace and formatting issues", () => {
-        const jsonString = "{} { \"name\" : \"test\" , \"value\" : 42 , } ";
-        const result = JsonUtil.parse(jsonString);
-
-        expect(result).toEqual({ name: "test", value: 42 });
-      });
-
-      it("should throw error for completely invalid JSON", () => {
-        const invalidJson = "{invalid: json without quotes}";
-
-        expect(() => JsonUtil.parse(invalidJson)).toThrow();
-      });
-
-      it("should throw error for empty string", () => {
-        expect(() => JsonUtil.parse("")).toThrow();
-      });
-    });
-  });
-});

package/src/utils/stringifyValidateFailure.ts

@@ -1,251 +0,0 @@
-import type { IValidation } from "typia";
-
-import { Escaper } from "typia/lib/utils/Escaper";
-
-export function stringifyValidateFailure(
-  failure: IValidation.IFailure,
-): string {
-  return stringify({
-    value: failure.data,
-    errors: failure.errors,
-    path: "$input",
-    tab: 0,
-    inArray: false,
-    inToJson: false,
-  });
-}
-
-function stringify(props: {
-  value: unknown;
-  errors: IValidation.IError[];
-  path: string;
-  tab: number;
-  inArray: boolean;
-  inToJson: boolean;
-}): string {
-  const { value, errors, path, tab, inArray, inToJson } = props;
-  const indent: string = "  ".repeat(tab);
-  const errorComment: string = getErrorComment(path, errors);
-
-  // Handle undefined in arrays
-  if (inArray && value === undefined) {
-    return `${indent}undefined${errorComment}`;
-  }
-
-  // Array
-  if (Array.isArray(value)) {
-    if (value.length === 0) {
-      return `${indent}[]${errorComment}`;
-    }
-
-    const lines: string[] = [];
-    lines.push(`${indent}[${errorComment}`);
-
-    value.forEach((item: unknown, index: number) => {
-      const itemPath: string = `${path}[${index}]`;
-      let itemStr: string = stringify({
-        value: item,
-        errors,
-        path: itemPath,
-        tab: tab + 1,
-        inArray: true,
-        inToJson: false,
-      });
-      // Add comma before the error comment if not the last element
-      if (index < value.length - 1) {
-        const itemLines: string[] = itemStr.split("\n");
-        const lastLine: string = itemLines[itemLines.length - 1]!;
-        const commentIndex: number = lastLine.indexOf(" //");
-        if (commentIndex !== -1) {
-          itemLines[itemLines.length - 1]
-            = `${lastLine.slice(0, commentIndex)
-            },${
-              lastLine.slice(commentIndex)}`;
-        }
-        else {
-          itemLines[itemLines.length - 1] += ",";
-        }
-        itemStr = itemLines.join("\n");
-      }
-      lines.push(itemStr);
-    });
-
-    lines.push(`${indent}]`);
-    return lines.join("\n");
-  }
-
-  // Object
-  if (typeof value === "object" && value !== null) {
-    // Check for toJSON method
-    if (!inToJson && typeof (value as any).toJSON === "function") {
-      const jsonValue: unknown = (value as any).toJSON();
-      return stringify({
-        value: jsonValue,
-        errors,
-        path,
-        tab,
-        inArray,
-        inToJson: true,
-      });
-    }
-
-    // Get existing entries (filter out undefined values from actual data)
-    const existingEntries: [string, unknown][] = Object.entries(value).filter(
-      ([_, val]) => val !== undefined,
-    );
-
-    // Find missing properties that have validation errors
-    const missingKeys: string[] = getMissingProperties(path, value, errors);
-
-    // Combine existing and missing properties
-    const allKeys: string[] = [
-      ...existingEntries.map(([key]) => key),
-      ...missingKeys,
-    ];
-
-    if (allKeys.length === 0) {
-      return `${indent}{}${errorComment}`;
-    }
-
-    const lines: string[] = [];
-    lines.push(`${indent}{${errorComment}`);
-
-    allKeys.forEach((key, index, array) => {
-      const propPath: string = Escaper.variable(key)
-        ? `${path}.${key}`
-        : `${path}[${JSON.stringify(key)}]`;
-      const propIndent: string = "  ".repeat(tab + 1);
-
-      // Get the value (undefined for missing properties)
-      const val: unknown = missingKeys.includes(key) ? undefined : (value as any)[key];
-
-      // Primitive property value (including undefined for missing properties)
-      if (
-        val === undefined
-        || val === null
-        || typeof val === "boolean"
-        || typeof val === "number"
-        || typeof val === "string"
-      ) {
-        const propErrorComment: string = getErrorComment(propPath, errors);
-        const valueStr: string = val === undefined
-          ? `${propIndent}"${key}": undefined`
-          : `${propIndent}"${key}": ${JSON.stringify(val)}`;
-        const withComma: string
-          = index < array.length - 1 ? `${valueStr},` : valueStr;
-        const line: string = withComma + propErrorComment;
-        lines.push(line);
-      }
-      // Complex property value (object or array)
-      else {
-        const keyLine: string = `${propIndent}"${key}": `;
-        let valStr: string = stringify({
-          value: val,
-          errors,
-          path: propPath,
-          tab: tab + 1,
-          inArray: false,
-          inToJson: false,
-        });
-        const valStrWithoutIndent: string = valStr.trimStart();
-        // Add comma before the error comment if not the last property
-        if (index < array.length - 1) {
-          const valLines: string[] = valStrWithoutIndent.split("\n");
-          const lastLine: string = valLines[valLines.length - 1]!;
-          const commentIndex: number = lastLine.indexOf(" //");
-          if (commentIndex !== -1) {
-            valLines[valLines.length - 1]
-              = `${lastLine.slice(0, commentIndex)
-              },${
-                lastLine.slice(commentIndex)}`;
-          }
-          else {
-            valLines[valLines.length - 1] += ",";
-          }
-          valStr = valLines.join("\n");
-        }
-        else {
-          valStr = valStrWithoutIndent;
-        }
-        const combined: string = keyLine + valStr;
-        lines.push(combined);
-      }
-    });
-
-    lines.push(`${indent}}`);
-    return lines.join("\n");
-  }
-
-  // Primitive types (null, boolean, number, string, undefined, etc.)
-  const valStr: string
-    = value === undefined
-      ? "undefined"
-      : (JSON.stringify(value) ?? String(value));
-  return `${indent}${valStr}${errorComment}`;
-}
-
-/** Get error comment for a given path */
-function getErrorComment(path: string, errors: IValidation.IError[]): string {
-  const pathErrors: IValidation.IError[] = errors.filter(
-    (e: IValidation.IError) => e.path === path,
-  );
-  if (pathErrors.length === 0) {
-    return "";
-  }
-
-  return ` // ❌ ${JSON.stringify(
-    pathErrors.map(e => ({
-      path: e.path,
-      expected: e.expected,
-      description: e.description,
-    })),
-  )}`;
-}
-
-/**
- * Find missing properties that have validation errors but don't exist in the data
- * Returns array of property keys that should be displayed as undefined
- */
-function getMissingProperties(
-  path: string,
-  value: object,
-  errors: IValidation.IError[],
-): string[] {
-  const missingKeys: Set<string> = new Set();
-
-  for (const e of errors) {
-    // Check if error.path is a direct child of current path
-    const childKey = extractDirectChildKey(path, e.path);
-    if (childKey !== null) {
-      // Check if this property actually exists in the value
-      if (!(childKey in value)) {
-        missingKeys.add(childKey);
-      }
-    }
-  }
-
-  return Array.from(missingKeys);
-}
-
-/**
- * Extract direct child property key if errorPath is a direct child of parentPath
- * Returns null if not a direct child
- *
- * Examples:
- * - extractDirectChildKey("$input", "$input.email") => "email"
- * - extractDirectChildKey("$input", "$input.user.email") => null (grandchild)
- * - extractDirectChildKey("$input.user", "$input.user.email") => "email"
- * - extractDirectChildKey("$input", "$input[0]") => null (array index, not object property)
- */
-function extractDirectChildKey(parentPath: string, errorPath: string): string | null {
-  if (!errorPath.startsWith(parentPath)) {
-    return null;
-  }
-
-  const suffix = errorPath.slice(parentPath.length);
-
-  // Match ".propertyName" pattern (direct child property)
-  // Should not contain additional dots or brackets after the property name
-  const match = suffix.match(/^\.([^.[\]]+)$/);
-  return match !== null ? match[1]! : null;
-}