@lichidental/saas-cli 0.0.0-stage → 1.0.0

package/commands/auth/login.mjs

@@ -0,0 +1,142 @@
+// commands/auth/login.mjs — 登录:验证 token 并保存到本机
+// 三种用法:
+//   1) saas-cli auth login --token <token>             直接验证并保存
+//   2) ... --token - (或管道)                          从标准输入读取 token 后验证保存
+//   3) saas-cli auth login(无 --token)                引导打开授权页,给出后续操作指引(不阻塞等待)
+import { spawn } from "node:child_process"
+import readline from "node:readline"
+import { CliError, EXIT_CODES } from "../../lib/errors.mjs"
+import { createOutput } from "../../lib/output.mjs"
+import { buildContextWithToken } from "../../lib/context.mjs"
+import { assertValueNotOptionLike } from "../../lib/options.mjs"
+import { setToken, maskToken } from "../../lib/config.mjs"
+import { ENV_BASE_URLS } from "../../lib/http.mjs"
+import { listDoctors } from "../../api/employee.mjs"
+
+/** 授权页地址:默认 <环境地址>/cli-auth,可用 --auth-url 覆盖 */
+function authUrlFor(env, override) {
+  if (override) {
+    if (!/^https?:\/\//i.test(override)) {
+      throw new CliError(`--auth-url 必须是 http/https 地址(收到:${override})`, { exitCode: EXIT_CODES.USAGE })
+    }
+    return override
+  }
+  const base = ENV_BASE_URLS[env]
+  if (!base) {
+    throw new CliError(`未知环境「${env}」,可选:${Object.keys(ENV_BASE_URLS).join(" / ")}`, {
+      exitCode: EXIT_CODES.USAGE,
+    })
+  }
+  return `${base}/cli-auth`
+}
+
+/** 用系统默认浏览器打开 URL(失败静默,不影响主流程) */
+function openBrowser(url) {
+  const [cmd, args] =
+    process.platform === "win32"
+      ? ["cmd", ["/c", "start", "", `"${url}"`]]
+      : process.platform === "darwin"
+        ? ["open", [url]]
+        : ["xdg-open", [url]]
+  try {
+    const p = spawn(cmd, args, { stdio: "ignore", detached: true })
+    p.on("error", () => {})
+    p.unref()
+  } catch {
+    // 打开失败不阻塞:使用者可手动复制链接
+  }
+}
+
+/** 读取标准输入首行(管道场景);超时(10 秒)或无内容返回空串 */
+function readStdinLine() {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin })
+    const timer = setTimeout(() => {
+      rl.close()
+      resolve("")
+    }, 10000)
+    rl.once("line", (line) => {
+      clearTimeout(timer)
+      rl.close()
+      resolve(line.trim())
+    })
+    rl.once("close", () => {
+      clearTimeout(timer)
+      resolve("")
+    })
+  })
+}
+
+/** @param {import("commander").Command} topic */
+export function register(topic) {
+  topic
+    .command("login")
+    .description("登录:验证 token 并保存到本机;不带 --token 时引导打开授权页")
+    .option("--env <env>", "环境:test | pre | prod", "test")
+    .option("--token <token>", "要登录的 token;- 表示从标准输入读取;省略则引导打开授权页")
+    .option("--auth-url <url>", "授权页地址(默认 <环境地址>/cli-auth)")
+    .option("--no-open", "不自动打开浏览器,只打印授权页链接")
+    .option("--json", "输出结构化 JSON(默认输出人读摘要)")
+    .option("--verbose", "打印请求详情(token 脱敏)")
+    .action(async function () {
+      const opts = this.opts()
+      const out = createOutput({ json: Boolean(opts.json), verbose: Boolean(opts.verbose) })
+      let token = typeof opts.token === "string" ? opts.token.trim() : ""
+
+      if (token === "-") {
+        // 显式要求从标准输入读取(脚本/剪贴板管道场景)
+        token = await readStdinLine()
+        if (!token) {
+          throw new CliError("--token - 指定从标准输入读取,但没有读到内容", {
+            exitCode: EXIT_CODES.USAGE,
+            hint: "例:powershell -c Get-Clipboard | saas-cli auth login --token -",
+          })
+        }
+      } else if (token) {
+        assertValueNotOptionLike(opts.token, {
+          option: "--token",
+          hint: `用法:saas-cli auth login --env ${opts.env} --token <token>;或省略 --token 打开授权页按引导操作`,
+        })
+      }
+
+      if (!token) {
+        // 无 token:引导模式(打开授权页 + 指引),不阻塞等待输入
+        const url = authUrlFor(opts.env, opts.authUrl)
+        const interactive = Boolean(process.stdin.isTTY) || Boolean(process.stdout.isTTY)
+        const opened = Boolean(opts.open) && interactive
+        if (opened) openBrowser(url)
+        out.success(
+          "auth login",
+          opts.env,
+          { env: opts.env, authUrl: url, opened, configured: false },
+          [
+            opened ? "已在浏览器打开授权页(未打开则手动复制下面的链接):" : "请在浏览器中打开以下链接:",
+            `  ${url}`,
+            `登录后点击「复制 token」,然后运行:`,
+            `  saas-cli auth login --env ${opts.env} --token <粘贴的token>`,
+            "",
+            `也可以直接用剪贴板管道一步完成(PowerShell):`,
+            `  powershell -c Get-Clipboard | saas-cli auth login --env ${opts.env} --token -`,
+          ].join("\n")
+        )
+        return
+      }
+
+      // 验证 token:调只读接口(医生列表)确认有效性,通过后再保存
+      const { env, http } = buildContextWithToken(this, token)
+      const res = await listDoctors(http)
+      const doctorCount = (res.data ?? []).length
+      const file = setToken(env, token)
+
+      out.success(
+        "auth login",
+        env,
+        { env, token: maskToken(token), verified: true, doctorCount, configFile: file },
+        [
+          `✓ 登录成功(环境:${env})`,
+          `  token 已验证:${maskToken(token)},可访问 ${doctorCount} 名在职员工`,
+          `  已保存到:${file}`,
+        ].join("\n")
+      )
+    })
+}

package/commands/auth/logout.mjs

@@ -0,0 +1,39 @@
+// commands/auth/logout.mjs — 退出登录:删除本机保存的 token
+import { CliError, EXIT_CODES } from "../../lib/errors.mjs"
+import { createOutput } from "../../lib/output.mjs"
+import { removeToken, getConfigPath } from "../../lib/config.mjs"
+import { ENV_BASE_URLS } from "../../lib/http.mjs"
+
+/** @param {import("commander").Command} topic */
+export function register(topic) {
+  topic
+    .command("logout")
+    .description("退出登录:删除本机保存的该环境 token")
+    .option("--env <env>", "环境:test | pre | prod", "test")
+    .option("--json", "输出结构化 JSON(默认输出人读摘要)")
+    .action(async function () {
+      const opts = this.opts()
+      const out = createOutput({ json: Boolean(opts.json) })
+      if (!ENV_BASE_URLS[opts.env]) {
+        throw new CliError(`未知环境「${opts.env}」,可选:${Object.keys(ENV_BASE_URLS).join(" / ")}`, {
+          exitCode: EXIT_CODES.USAGE,
+        })
+      }
+      const file = removeToken(opts.env)
+      if (file) {
+        out.success(
+          "auth logout",
+          opts.env,
+          { env: opts.env, removed: true, configFile: file },
+          [`✓ 已退出登录(环境:${opts.env})`, `  已删除本机保存的该环境 token`].join("\n")
+        )
+      } else {
+        out.success(
+          "auth logout",
+          opts.env,
+          { env: opts.env, removed: false, configFile: getConfigPath() },
+          `环境 ${opts.env} 在本机没有保存 token(无需退出)`
+        )
+      }
+    })
+}

package/commands/auth/status.mjs

@@ -0,0 +1,64 @@
+// commands/auth/status.mjs — 查看登录状态:token 来源/打码值/更新时间;--verify 联网验证
+import { createOutput } from "../../lib/output.mjs"
+import { buildContextWithToken } from "../../lib/context.mjs"
+import { resolveToken, readConfig, maskToken, getConfigPath } from "../../lib/config.mjs"
+import { listDoctors } from "../../api/employee.mjs"
+
+/** @param {import("commander").Command} topic */
+export function register(topic) {
+  topic
+    .command("status")
+    .description("查看登录状态:token 来源、打码值、更新时间;--verify 联网验证有效性")
+    .option("--env <env>", "环境:test | pre | prod", "test")
+    .option("--verify", "联网验证 token 是否有效(默认只显示本地状态,不联网)")
+    .option("--json", "输出结构化 JSON(默认输出人读摘要)")
+    .option("--verbose", "打印请求详情(token 脱敏)")
+    .action(async function () {
+      const opts = this.opts()
+      const out = createOutput({ json: Boolean(opts.json), verbose: Boolean(opts.verbose) })
+      const env = opts.env
+      const { token, source } = resolveToken({ env })
+      const configFile = getConfigPath()
+
+      if (!token) {
+        out.success(
+          "auth status",
+          env,
+          { env, configured: false, configFile },
+          [
+            `环境 ${env}:未登录(本机没有可用 token)`,
+            `  登录方式:saas-cli auth login --env ${env}`,
+            `  (也可用环境变量 SAAS_TOKEN 或命令后加 --token 临时传入)`,
+          ].join("\n")
+        )
+        return
+      }
+
+      const fromConfig = Boolean(source?.startsWith("配置文件"))
+      const updatedAt = fromConfig ? (readConfig()?.profiles?.[env]?.updatedAt ?? null) : null
+
+      let verified = null
+      let doctorCount = null
+      const lines = [
+        `环境 ${env}:已配置`,
+        `  token:${maskToken(token)}(来源:${source}${updatedAt ? `,更新于 ${updatedAt}` : ""})`,
+      ]
+      if (opts.verify) {
+        const { http } = buildContextWithToken(this, token)
+        const res = await listDoctors(http)
+        doctorCount = (res.data ?? []).length
+        verified = true
+        lines.push(`  验证:✓ 有效(可访问 ${doctorCount} 名在职员工)`)
+      } else {
+        lines.push("  (加 --verify 可联网验证 token 是否有效)")
+      }
+      lines.push(`  配置文件:${configFile}`)
+
+      out.success(
+        "auth status",
+        env,
+        { env, configured: true, token: maskToken(token), source, updatedAt, verified, doctorCount, configFile },
+        lines.join("\n")
+      )
+    })
+}

package/commands/config/set-token.mjs

@@ -0,0 +1,39 @@
+// commands/config/set-token.mjs — 保存 token 到本地配置文件
+import { CliError, EXIT_CODES } from "../../lib/errors.mjs"
+import { createOutput } from "../../lib/output.mjs"
+import { setToken, maskToken } from "../../lib/config.mjs"
+import { ENV_BASE_URLS } from "../../lib/http.mjs"
+
+/** @param {import("commander").Command} topic */
+export function register(topic) {
+  topic
+    .command("set-token")
+    .description("保存某环境的 token 到本地配置文件(只需配置一次)")
+    .option("--env <env>", "环境:test | pre | prod", "test")
+    .requiredOption("--token <token>", "要保存的 token")
+    .option("--json", "输出结构化 JSON(默认输出人读摘要)")
+    .action(async function () {
+      const opts = this.opts()
+      const out = createOutput({ json: Boolean(opts.json) })
+      if (!ENV_BASE_URLS[opts.env]) {
+        throw new CliError(`未知环境「${opts.env}」,可选:${Object.keys(ENV_BASE_URLS).join(" / ")}`, {
+          exitCode: EXIT_CODES.USAGE,
+        })
+      }
+      const token = String(opts.token ?? "").trim()
+      // commander 会把紧跟 --token 的下一个选项当作它的值(如 "--token --json" 时 token="--json"),这里拦下,避免错误值被静默写进配置
+      if (!token || token.startsWith("-")) {
+        throw new CliError(!token ? "--token 不能为空" : `--token 的值看起来是另一个选项(「${token}」),不是 token`, {
+          exitCode: EXIT_CODES.USAGE,
+          hint: "用法:saas-cli config set-token --env <环境> --token <token>;--token 后面要紧跟真实 token,不能接其他选项",
+        })
+      }
+      const file = setToken(opts.env, token)
+      out.success(
+        "config set-token",
+        opts.env,
+        { configFile: file, env: opts.env, token: maskToken(token) },
+        `✓ 已保存 ${opts.env} 环境 token(${maskToken(token)})到:\n  ${file}\n  后续命令会自动使用;临时覆盖可用 --token 或环境变量 SAAS_TOKEN`
+      )
+    })
+}

package/commands/config/show.mjs

@@ -0,0 +1,39 @@
+// commands/config/show.mjs — 查看当前配置(配置文件位置、各环境 token 来源)
+import fs from "node:fs"
+import { createOutput } from "../../lib/output.mjs"
+import { getConfigPath, readConfig, maskToken } from "../../lib/config.mjs"
+import { ENV_BASE_URLS } from "../../lib/http.mjs"
+
+/** @param {import("commander").Command} topic */
+export function register(topic) {
+  topic
+    .command("show")
+    .description("查看当前配置:配置文件位置、各环境 token(打码)")
+    .option("--json", "输出结构化 JSON(默认输出人读摘要)")
+    .action(async function () {
+      const opts = this.opts()
+      const out = createOutput({ json: Boolean(opts.json) })
+      const file = getConfigPath()
+      const exists = fs.existsSync(file)
+      const cfg = readConfig()
+      const envVarSet = Boolean(process.env.SAAS_TOKEN)
+
+      const profiles = Object.fromEntries(
+        Object.keys(ENV_BASE_URLS).map((env) => {
+          const p = cfg?.profiles?.[env]
+          return [env, p?.token ? { token: maskToken(p.token), updatedAt: p.updatedAt ?? null } : null]
+        })
+      )
+
+      const lines = [
+        `配置文件:${file}${exists ? "" : "(尚未创建)"}`,
+        `环境变量 SAAS_TOKEN:${envVarSet ? `已设置(${maskToken(process.env.SAAS_TOKEN)})` : "未设置"}`,
+        "各环境 token(优先级:命令行 --token > 环境变量 SAAS_TOKEN > 配置文件):",
+        ...Object.keys(ENV_BASE_URLS).map((env) => {
+          const p = profiles[env]
+          return `  ${env.padEnd(5)} ${p ? `${p.token}(配置文件${p.updatedAt ? ",更新于 " + p.updatedAt : ""})` : "(未配置)"}`
+        }),
+      ]
+      out.success("config show", "all", { configFile: file, configExists: exists, envVarSAAS_TOKEN: envVarSet, profiles }, lines.join("\n"))
+    })
+}

package/commands/reservation/_shared.mjs

@@ -0,0 +1,216 @@
+// commands/reservation/_shared.mjs — reservation 主题内部共用:患者/医生/预约项目解析
+// (文件名以 _ 开头,不会被 cli.mjs 当作命令注册)
+import { CliError, EXIT_CODES } from "../../lib/errors.mjs"
+import { pickOne } from "../../lib/match.mjs"
+import { assertValueNotOptionLike } from "../../lib/options.mjs"
+import { searchPatients } from "../../api/custom.mjs"
+import { listDoctors } from "../../api/employee.mjs"
+import { listTreatItems } from "../../api/treat-item.mjs"
+import { listMarksByRange } from "../../api/custom-mark.mjs"
+
+/**
+ * 解析患者:
+ * - --patient-code:直接指定,支持患者编码(customCode)或病历号(codeNum)——
+ *   先精确搜索识别一次(后端搜索支持病历号、不支持按 customCode 搜),命中用真实信息,未命中按原值当 customCode 直用
+ * - --patient:先搜索(匹配 姓名 / 手机号 / 患者编码 / 病历号,与前端患者搜索框一致),要求唯一命中(重名报错列候选)
+ * 注:按患者查询预约用 customMarkListByCustom(customCode + 时间范围),不依赖姓名/手机号。
+ * @param {import("../../lib/types.mjs").Http} http
+ * @param {{patient?: string, patientCode?: string}} params
+ * @returns {Promise<{customCode: string, customName: string|null, customPhone: string|null, raw?: import("../../lib/types.mjs").Patient}>}
+ */
+export async function resolvePatient(http, { patient, patientCode }) {
+  if (patientCode) {
+    assertValueNotOptionLike(patientCode, {
+      option: "--patient-code",
+      hint: "例:--patient-code YONGCE26073100001;可先用 saas-cli reservation patients --keyword <关键词> 查看编码",
+    })
+    try {
+      const res = await searchPatients(http, { keyword: patientCode })
+      const hit = (res.data?.list ?? []).find(
+        (p) => p.customCode === patientCode || p.codeNum === patientCode
+      )
+      if (hit) {
+        return { customCode: hit.customCode, customName: hit.customName ?? null, customPhone: hit.customPhone || null, raw: hit }
+      }
+    } catch {
+      // 忽略:搜索失败时按原值直用
+    }
+    return { customCode: String(patientCode), customName: null, customPhone: null }
+  }
+  if (!patient) {
+    throw new CliError("缺少患者参数", {
+      exitCode: EXIT_CODES.USAGE,
+      hint: "用 --patient <姓名/手机号/病历号> 或 --patient-code <编码或病历号> 指定患者",
+    })
+  }
+  const res = await searchPatients(http, { keyword: patient })
+  const list = res.data?.list ?? []
+  const hit = pickOne(list, {
+    match: (it) => [it.customName, it.customPhone, it.customCode, it.codeNum],
+    describe: (it) => `${it.customName}  手机:${it.customPhone ?? "-"}  病历号:${it.codeNum ?? "-"}  编码:${it.customCode}`,
+    input: patient,
+    label: "患者",
+    hint: "可改用 --patient-code <编码或病历号> 直接指定;或先运行 saas-cli reservation patients --keyword <关键词> 查看候选",
+  })
+  return {
+    customCode: hit.customCode,
+    customName: hit.customName ?? null,
+    customPhone: hit.customPhone || null,
+    raw: hit,
+  }
+}
+
+/**
+ * 解析医生:--doctor-id 直用;--doctor 从医生列表按姓名匹配
+ * @param {import("../../lib/types.mjs").Http} http
+ * @param {{doctor?: string, doctorId?: string}} params
+ * @returns {Promise<{doctorId: string, doctorName: string, raw?: import("../../lib/types.mjs").Doctor}>}
+ */
+export async function resolveDoctorId(http, { doctor, doctorId }) {
+  if (doctorId) {
+    assertValueNotOptionLike(doctorId, {
+      option: "--doctor-id",
+      hint: "例:--doctor-id 26051131994;可先用 saas-cli reservation doctors 查看 userUid",
+    })
+    return { doctorId: String(doctorId), doctorName: String(doctorId) }
+  }
+  if (!doctor) {
+    throw new CliError("缺少医生参数", {
+      exitCode: EXIT_CODES.USAGE,
+      hint: "用 --doctor <姓名> 或 --doctor-id <userUid> 指定预约医生",
+    })
+  }
+  const res = await listDoctors(http)
+  const list = res.data ?? []
+  const hit = pickOne(list, {
+    match: (it) => [it.storeUserName, it.userName],
+    describe: (it) => `${it.storeUserName ?? it.userName}  userUid:${it.userUid}`,
+    input: doctor,
+    label: "医生",
+    hint: "可改用 --doctor-id <userUid> 直接指定;或先运行 saas-cli reservation doctors 查看列表",
+  })
+  return { doctorId: String(hit.userUid), doctorName: hit.storeUserName ?? hit.userName, raw: hit }
+}
+
+/**
+ * 解析预约项目:
+ * - --items-json 直接使用(仅校验为合法非空 JSON 数组)
+ * - --items "洗牙,补牙" 逐个按名称匹配二级项目,组装为 [{up_id, up_title, id, title}]
+ * @param {import("../../lib/types.mjs").Http} http
+ * @param {{items?: string, itemsJson?: string}} params
+ * @returns {Promise<import("../../lib/types.mjs").TreatItemJsonItem[]>}
+ */
+export async function resolveTreatItems(http, { items, itemsJson }) {
+  if (itemsJson) {
+    let arr
+    try {
+      arr = JSON.parse(itemsJson)
+    } catch (e) {
+      throw new CliError(`--items-json 不是合法 JSON:${e.message}`, {
+        exitCode: EXIT_CODES.USAGE,
+        hint: '期望格式:[{"up_id":13,"up_title":"修复","id":1302,"title":"取模"}]',
+      })
+    }
+    if (!Array.isArray(arr) || arr.length === 0) {
+      throw new CliError("--items-json 必须是非空数组", {
+        exitCode: EXIT_CODES.USAGE,
+        hint: '期望格式:[{"up_id":13,"up_title":"修复","id":1302,"title":"取模"}]',
+      })
+    }
+    return arr
+  }
+  if (!items) {
+    throw new CliError("缺少预约项目参数", {
+      exitCode: EXIT_CODES.USAGE,
+      hint: '用 --items "洗牙,补牙" 指定项目名称(逗号分隔),或 --items-json 直接指定 JSON',
+    })
+  }
+  const res = await listTreatItems(http)
+  const flat = res.data ?? []
+  const level1 = new Map(flat.filter((i) => i.level === 1).map((i) => [i.id, i]))
+  const level2 = flat.filter((i) => i.level === 2)
+  const names = String(items)
+    .split(/[,，]+/)
+    .map((s) => s.trim())
+    .filter(Boolean)
+  return names.map((name) => {
+    const hit = pickOne(level2, {
+      match: (it) => [it.treatItemName],
+      describe: (it) => `${it.treatItemName}(分类:${level1.get(it.upTreatItemId)?.treatItemName ?? "-"})  id:${it.id}`,
+      input: name,
+      label: "预约项目",
+      hint: "可先运行 saas-cli reservation items --keyword <关键词> 查看项目,或用 --items-json 直接指定",
+    })
+    return {
+      up_id: hit.upTreatItemId,
+      up_title: level1.get(hit.upTreatItemId)?.treatItemName ?? "",
+      id: hit.id,
+      title: hit.treatItemName,
+    }
+  })
+}
+
+/**
+ * 预约查询响应里的时间是 ISO 格式("2026-10-15T10:00:00"),统一转成 "2026-10-15 10:00:00" 便于比较与展示
+ * @param {string|undefined|null} s
+ * @returns {string}
+ */
+export function normTime(s) {
+  return String(s ?? "").replace("T", " ")
+}
+
+/**
+ * 预约状态显示名:照前端看板卡片的 statusName 逻辑(主键是 visitStatus,不是 status)
+ * 来源:前端 src/views/reservation/components/board/index.tsx 的状态改写逻辑(2026-10 核对)
+ * @param {import("../../lib/types.mjs").CustomMark} m 预约记录(需含 visitStatus/status)
+ * @returns {string}
+ */
+export function markStatusName(m) {
+  const vs = m?.visitStatus
+  const byVisit = { 1: "预约未到", 2: "待分诊", 3: "治疗中", 4: "待收费", 5: "已完成", 6: "已离店" }
+  let name = byVisit[vs] ?? (vs !== undefined ? `未知状态(${vs})` : "-")
+  if (vs === 1) name = "已确认"
+  if (vs === 1 && m?.status === 1) name = "已预约"
+  if (vs === 2) name = "已到店"
+  if (vs === 3) name = "治疗中"
+  if (vs === 4 && (m?.status === 5 || m?.status === 2)) name = "治疗中"
+  if (vs === 5) name = "治疗完成"
+  if (vs === 6) name = "已离店"
+  return name
+}
+
+/** 解析 treatItemJson 字符串 → 项目名列表(解析失败返回空数组) */
+export function parseItemTitles(treatItemJson) {
+  try {
+    const arr = JSON.parse(treatItemJson || "[]")
+    return Array.isArray(arr) ? arr.map((i) => i?.title).filter(Boolean) : []
+  } catch {
+    return []
+  }
+}
+
+/**
+ * 回查新建的预约,拿完整预约信息(创建响应里虽带 data.id,但没有医生名 / 状态等展示字段)。
+ * 照前端"取当天最近预约"的做法:customMarkListByCustom + 当天时间范围(服务端过滤),
+ * 取开始时间相同的记录;失败返回 null(不影响创建结果)。
+ * @param {import("../../lib/types.mjs").Http} http
+ * @param {{customCode: string, markStartTime: string}} params
+ * @returns {Promise<import("../../lib/types.mjs").CustomMark|null>}
+ */
+export async function findCreatedMark(http, { customCode, markStartTime }) {
+  try {
+    const target = normTime(markStartTime).slice(0, 16)
+    const date = target.slice(0, 10)
+    const res = await listMarksByRange(http, {
+      customCode,
+      startTime: `${date} 00:00:00`,
+      endTime: `${date} 23:59:59`,
+    })
+    const sameTime = (res.data?.cmList ?? []).filter(
+      (m) => normTime(m?.markStartTime).slice(0, 16) === target
+    )
+    return sameTime.sort((a, b) => Number(b?.id ?? 0) - Number(a?.id ?? 0))[0] ?? null
+  } catch {
+    return null
+  }
+}