cloudhouse-admin-cli 0.3.3

package/src/session.mjs

@@ -0,0 +1,94 @@
+import fs from 'node:fs'
+import crypto from 'node:crypto'
+import path from 'node:path'
+import { configDir } from './config.mjs'
+
+const SESSION_FILE = 'session.json'
+
+function sessionFilePath(env = process.env) {
+  return path.join(configDir(env), SESSION_FILE)
+}
+
+/** 读取磁盘会话；文件不存在/损坏/无 token 时返回 null */
+export function loadSession(env = process.env) {
+  try {
+    const parsed = JSON.parse(fs.readFileSync(sessionFilePath(env), 'utf8'))
+    if (!parsed || typeof parsed.token !== 'string' || !parsed.token) return null
+    return parsed
+  } catch {
+    return null
+  }
+}
+
+/**
+ * 区分「没有会话」与「会话文件读不出来」。
+ * loadSession 一律返回 null 是有意的（调用方要能继续走未登录分支，也有测试钉住它），
+ * 但对用户来说「会话文件坏了」和「从没登录过」是完全不同的处置方式，
+ * 所以坏掉时必须能问出来——否则表现是让人重新登录，而登录又会覆盖坏文件。
+ * @returns {null | {file:string, reason:string}}
+ */
+export function describeSessionDamage(env = process.env) {
+  const file = sessionFilePath(env)
+  let raw
+  try {
+    raw = fs.readFileSync(file, 'utf8')
+  } catch (err) {
+    return err.code === 'ENOENT' ? null : { file, reason: `无法读取（${err.code || err.message}）` }
+  }
+  try {
+    const parsed = JSON.parse(raw)
+    if (!parsed || typeof parsed.token !== 'string' || !parsed.token) return { file, reason: '文件里没有 token' }
+    return null
+  } catch (err) {
+    return { file, reason: `不是合法 JSON（${err.message}）` }
+  }
+}
+
+/**
+ * 写入会话。
+ * token 是敏感凭据：目录 0700、文件 0600，且必须先落临时文件再 rename——
+ * 直接 writeFileSync 覆盖中途崩溃会留下截断的 JSON，而 loadSession 把截断读成 null，
+ * 用户看到的是「未登录」而不是「会话坏了」。
+ * fs.writeFileSync 的 mode 只在创建时生效，所以已存在 0644 的历史文件必须显式 chmod 收紧。
+ */
+export function saveSession(env, session) {
+  const file = sessionFilePath(env)
+  fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 })
+  try {
+    fs.chmodSync(path.dirname(file), 0o700)
+  } catch {
+    /* 目录属主不是自己时保持原样，不阻断命令 */
+  }
+  const tmp = `${file}.${crypto.randomUUID()}.tmp`
+  fs.writeFileSync(tmp, `${JSON.stringify(session, null, 2)}\n`, { mode: 0o600, flag: 'wx' })
+  try { fs.renameSync(tmp, file) }
+  finally { try { fs.unlinkSync(tmp) } catch {} }
+  return file
+}
+
+export function clearSession(env = process.env) {
+  try {
+    fs.unlinkSync(sessionFilePath(env))
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 吸收后端滚动续期下发的新 Token（X-Renewed-Token / X-Token-Expires-At）。
+ * 并发安全：仅当磁盘会话的 token 仍是本次请求发出的 token 时才换存，
+ * 迟到的旧响应不能用旧续期结果覆盖更新的会话（与 admin-web absorbSessionRenewal 同语义）。
+ * @returns {boolean} 是否发生了换存
+ */
+export function absorbRenewal(env, sentToken, renewedToken, expiresAtMs) {
+  if (!sentToken || !renewedToken || renewedToken === sentToken) return false
+  const current = loadSession(env)
+  if (!current || current.token !== sentToken) return false
+  const next = { ...current, token: renewedToken }
+  if (Number.isFinite(expiresAtMs)) next.expiresAt = expiresAtMs
+  saveSession(env, next)
+  return true
+}
+
+export { sessionFilePath }

package/src/time.mjs

@@ -0,0 +1,87 @@
+/**
+ * 时间处理。
+ * - 传统接口：接受 `YYYY-MM-DD HH:mm:ss` 或 ISO，统一输出 `YYYY-MM-DDTHH:mm:ss`（Asia/Shanghai 无偏移，前端原样展示）
+ * - AI Coding 接口：统一输出 `YYYY-MM-DDTHH:mm:ss+08:00`（对齐 admin-web toShanghaiIso）
+ * Asia/Shanghai 自 1991 年起无夏令时，固定 UTC+8。
+ */
+import { usageError } from './errors.mjs'
+
+const SHANGHAI_OFFSET_MINUTES = 8 * 60
+
+function pad2(value) {
+  return String(value).padStart(2, '0')
+}
+
+/**
+ * Date.UTC 会把 13 月、45 日、99 时静默进位成「另一个合法时间」。
+ * 归一化后把六个字段回读逐项比对，对不上就报用法错误——否则排出来的场次
+ * 和调用方写的完全不是一回事，而且全程 exit 0。
+ */
+function assertWallClock(date, expected, input) {
+  const p = shanghaiParts(date)
+  const actual = [p.year, p.month, p.day, p.hour, p.minute, p.second]
+  if (expected.some((want, i) => Number(actual[i]) !== Number(want))) {
+    throw usageError(
+      `时间字段超出范围：${input}（会被归一化成 ${p.year}-${p.month}-${p.day}T${p.hour}:${p.minute}:${p.second}）`,
+      '月份 01-12、日 01-31、时 00-23、分与秒 00-59',
+    )
+  }
+  return date
+}
+
+function parseAny(input) {
+  if (input instanceof Date) {
+    if (Number.isNaN(input.getTime())) throw usageError('无效时间')
+    return input
+  }
+  if (typeof input !== 'string') throw usageError('无效时间')
+  const text = input.trim()
+  if (!text) throw usageError('无效时间')
+  // `YYYY-MM-DD HH:mm:ss`（无时区）按 Asia/Shanghai 解释
+  const naive = text.match(/^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2})(?::(\d{2}))?$/)
+  if (naive) {
+    const [, y, mo, d, h, mi, s = '0'] = naive
+    const date = new Date(Date.UTC(Number(y), Number(mo) - 1, Number(d), Number(h) - SHANGHAI_OFFSET_MINUTES / 60, Number(mi), Number(s)))
+    return assertWallClock(date, [y, mo, d, h, mi, s], text)
+  }
+  const dateOnly = text.match(/^(\d{4})-(\d{2})-(\d{2})$/)
+  if (dateOnly) {
+    const [, y, mo, d] = dateOnly
+    const date = new Date(Date.UTC(Number(y), Number(mo) - 1, Number(d), -SHANGHAI_OFFSET_MINUTES / 60))
+    return assertWallClock(date, [y, mo, d, '0', '0', '0'], text)
+  }
+  const parsed = new Date(text)
+  if (Number.isNaN(parsed.getTime())) throw usageError(`无效时间：${input}`)
+  return parsed
+}
+
+function shanghaiParts(date) {
+  const shifted = new Date(date.getTime() + SHANGHAI_OFFSET_MINUTES * 60 * 1000)
+  return {
+    year: shifted.getUTCFullYear(),
+    month: pad2(shifted.getUTCMonth() + 1),
+    day: pad2(shifted.getUTCDate()),
+    hour: pad2(shifted.getUTCHours()),
+    minute: pad2(shifted.getUTCMinutes()),
+    second: pad2(shifted.getUTCSeconds()),
+  }
+}
+
+/** 传统接口时间：`YYYY-MM-DDTHH:mm:ss` */
+export function normalizeLocalTime(input) {
+  const date = parseAny(input)
+  const p = shanghaiParts(date)
+  return `${p.year}-${p.month}-${p.day}T${p.hour}:${p.minute}:${p.second}`
+}
+
+/** AI Coding 接口时间：`YYYY-MM-DDTHH:mm:ss+08:00` */
+export function toShanghaiOffset(input) {
+  const date = parseAny(input)
+  const p = shanghaiParts(date)
+  return `${p.year}-${p.month}-${p.day}T${p.hour}:${p.minute}:${p.second}+08:00`
+}
+
+/** 解析 `YYYY-MM-DDTHH:mm:ss+08:00` 或本地无偏移时间为 epoch 毫秒（比较用） */
+export function parseToEpochMillis(input) {
+  return parseAny(input).getTime()
+}

package/src/version.mjs

@@ -0,0 +1 @@
+export const VERSION = '0.3.3'