feat: manually mirror opencoze's code from bytedance

Change-Id: I09a73aadda978ad9511264a756b2ce51f5761adf

frontend/packages/common/chat-area/utils/src/json-parse.ts

@@ -0,0 +1,66 @@
+/*
+ * Copyright 2025 coze-dev Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+ 
+export const typeSafeJsonParse = (
+  str: string,
+  onParseError: (error: Error) => void,
+): unknown => {
+  try {
+    return JSON.parse(str);
+  } catch (e) {
+    onParseError(e as Error);
+    return null;
+  }
+};
+
+/**
+ * 泛型类型标注可能需要使用 type 声明,
+ * refer: https://github.com/microsoft/TypeScript/issues/15300.
+ */
+export const typeSafeJsonParseEnhanced = <T>({
+  str,
+  onParseError,
+  verifyStruct,
+  onVerifyError,
+}: {
+  str: string;
+  onParseError: (error: Error) => void;
+  /**
+   * 实现一个类型校验,返回是否通过(boolean);实际上还是靠自觉.
+   * 可以单独定义, 也可以写作内联 function, 但是注意返回值标注为 predicate,
+   * refer: https://github.com/microsoft/TypeScript/issues/38390.
+   */
+  verifyStruct: (sth: unknown) => sth is T;
+  /** 错误原因: 校验崩溃; 校验未通过 */
+  onVerifyError: (error: Error) => void;
+}): T | null => {
+  const res = typeSafeJsonParse(str, onParseError);
+
+  function assertStruct(resLocal: unknown): asserts resLocal is T {
+    const ok = verifyStruct(resLocal);
+    if (!ok) {
+      throw new Error('verify struct no pass');
+    }
+  }
+
+  try {
+    assertStruct(res);
+    return res;
+  } catch (e) {
+    onVerifyError(e as Error);
+    return null;
+  }
+};