@cyt528300/reminders-cli 0.1.0

package/README.md

@@ -0,0 +1,43 @@
+# Reminders CLI
+
+命令行版本的 Reminders 客户端。首次使用需要登录，输入 API 域名和邀请码 code；登录成功后会把配置保存到 `~/.reminders-cli/config.json`。
+
+## 安装
+
+```bash
+npm install -g @cyt528300/reminders-cli
+```
+
+## 使用
+
+```bash
+reminders login
+reminders list
+reminders create --title "买牛奶" --due-date 2026-07-21 --tags life,home
+reminders update --id <id> --completed true
+reminders delete --id <id>
+reminders help create
+```
+
+也可以非交互登录：
+
+```bash
+reminders login --api-url https://your-domain.example --code your-code
+```
+
+## 命令
+
+- `login`: 输入 API 域名和邀请码 code，验证后保存到本地。
+- `list`: 获取提醒事项列表。
+- `create`: 创建提醒事项。
+- `update`: 更新提醒事项。
+- `delete`: 删除提醒事项。
+- `help`: 查看每个函数的用法和返回值含义。
+
+## 发布
+
+```bash
+cd packages/reminders-cli
+npm login
+npm publish --access public
+```

package/bin/reminders.js

@@ -0,0 +1,387 @@
+#!/usr/bin/env node
+
+const fs = require('fs')
+const os = require('os')
+const path = require('path')
+const readline = require('readline')
+
+const DEFAULT_API_URL = process.env.REMINDERS_API_URL || 'http://localhost:3000'
+const CONFIG_DIR = path.join(os.homedir(), '.reminders-cli')
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json')
+
+const HELP = {
+  overview: `
+Reminders CLI
+
+用法:
+  reminders <command> [options]
+
+命令:
+  login       首次登录，输入 API 域名和邀请码 code 并保存到本地
+  list        获取提醒事项列表
+  create      创建提醒事项
+  update      更新提醒事项
+  delete      删除提醒事项
+  help        查看命令帮助和返回值含义
+
+全局选项:
+  --api-url <url>   API 服务地址；login 时可跳过交互输入
+  --json            原样输出 JSON 响应
+
+示例:
+  reminders login
+  reminders list
+  reminders create --title "买牛奶" --due-date 2026-07-21 --tags life,home
+  reminders update --id <id> --completed true
+  reminders delete --id <id>
+  reminders help create
+`,
+  login: `
+login
+
+用法:
+  reminders login [--api-url <url>] [--code <code>]
+
+说明:
+  输入 API 域名和邀请码 code，验证成功后保存到 ${CONFIG_FILE}。
+  之后 list/create/update/delete 会自动读取本地 code。
+
+返回值:
+  success=true 表示登录成功，并保存 apiUrl。
+  401 表示缺少邀请码，403 表示邀请码无效。
+`,
+  list: `
+list
+
+用法:
+  reminders list [--json]
+
+说明:
+  获取最多 1000 条提醒事项。
+
+返回值:
+  success: 是否成功
+  data: Reminder 数组
+  count: 返回条数
+`,
+  create: `
+create
+
+用法:
+  reminders create --title <title> [options]
+
+选项:
+  --title <text>          标题，必填
+  --notes <text>          备注
+  --due-date <iso/date>   到期时间，例如 2026-07-21 或 ISO 时间戳
+  --priority <value>      low | medium | high
+  --tags <a,b,c>          逗号分隔的标签
+  --rank <number>         排序值，默认 0
+  --completed <boolean>   true | false，默认 false
+  --json                  原样输出 JSON 响应
+
+返回值:
+  success: 是否成功
+  data: 新创建的 Reminder
+`,
+  update: `
+update
+
+用法:
+  reminders update --id <id> [options]
+
+选项:
+  --id <id>               提醒事项 ID，必填
+  --title <text>          新标题
+  --notes <text>          新备注
+  --due-date <iso/date>   新到期时间
+  --priority <value>      low | medium | high
+  --tags <a,b,c>          覆盖标签
+  --rank <number>         新排序值
+  --completed <boolean>   true | false
+  --json                  原样输出 JSON 响应
+
+返回值:
+  success: 是否成功
+  data: 更新后的 Reminder
+  400: 缺少 id
+  404: 未找到对应提醒事项
+`,
+  delete: `
+delete
+
+用法:
+  reminders delete --id <id> [--json]
+
+说明:
+  删除指定提醒事项。
+
+返回值:
+  success: 是否成功
+  message: 删除结果说明
+  data.id: 已删除的提醒事项 ID
+  400: 缺少 id
+  404: 未找到对应提醒事项
+`,
+}
+
+function parseArgs(argv) {
+  const args = { _: [] }
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const token = argv[i]
+
+    if (!token.startsWith('--')) {
+      args._.push(token)
+      continue
+    }
+
+    const eqIndex = token.indexOf('=')
+    if (eqIndex !== -1) {
+      args[token.slice(2, eqIndex)] = token.slice(eqIndex + 1)
+      continue
+    }
+
+    const key = token.slice(2)
+    const next = argv[i + 1]
+    if (next && !next.startsWith('--')) {
+      args[key] = next
+      i += 1
+    } else {
+      args[key] = true
+    }
+  }
+
+  return args
+}
+
+function normalizeApiUrl(value) {
+  return String(value || DEFAULT_API_URL).trim().replace(/\/+$/, '')
+}
+
+function readConfig() {
+  if (!fs.existsSync(CONFIG_FILE)) return null
+  return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'))
+}
+
+function writeConfig(config) {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 })
+  fs.writeFileSync(CONFIG_FILE, `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 })
+}
+
+function prompt(question) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  })
+
+  return new Promise(resolve => {
+    rl.question(question, answer => {
+      rl.close()
+      resolve(answer.trim())
+    })
+  })
+}
+
+function toBoolean(value, name) {
+  if (value === undefined) return undefined
+  if (value === true || value === 'true') return true
+  if (value === false || value === 'false') return false
+  throw new Error(`${name} 只支持 true 或 false`)
+}
+
+function toNumber(value, name) {
+  if (value === undefined) return undefined
+  const parsed = Number(value)
+  if (!Number.isFinite(parsed)) throw new Error(`${name} 必须是数字`)
+  return parsed
+}
+
+function parseTags(value) {
+  if (value === undefined) return undefined
+  return String(value)
+    .split(',')
+    .map(tag => tag.trim())
+    .filter(Boolean)
+}
+
+function requireLogin(args) {
+  const config = readConfig()
+  if (!config?.code) {
+    throw new Error('尚未登录，请先运行 reminders login')
+  }
+
+  return {
+    apiUrl: normalizeApiUrl(args['api-url'] || config.apiUrl),
+    code: config.code,
+  }
+}
+
+function buildUrl(apiUrl, pathname, code, params = {}) {
+  const url = new URL(pathname, `${apiUrl}/`)
+  url.searchParams.set('inviteCode', code)
+
+  Object.entries(params).forEach(([key, value]) => {
+    if (value !== undefined && value !== null) {
+      url.searchParams.set(key, String(value))
+    }
+  })
+
+  return url
+}
+
+async function requestJson(url, options = {}) {
+  const response = await fetch(url, options)
+  const text = await response.text()
+  let body
+
+  try {
+    body = text ? JSON.parse(text) : {}
+  } catch (error) {
+    throw new Error(`响应不是有效 JSON: ${text}`)
+  }
+
+  if (!response.ok) {
+    const message = body.details || body.error || response.statusText
+    throw new Error(`HTTP ${response.status}: ${message}`)
+  }
+
+  return body
+}
+
+function printResult(result, rawJson) {
+  if (rawJson) {
+    console.log(JSON.stringify(result, null, 2))
+    return
+  }
+
+  if (Array.isArray(result.data)) {
+    console.log(`成功: ${result.success}`)
+    console.log(`数量: ${result.count}`)
+    result.data.forEach(item => {
+      const status = item.completed ? 'done' : 'todo'
+      const dueDate = item.dueDate ? ` due=${item.dueDate}` : ''
+      const tags = item.tags?.length ? ` tags=${item.tags.join(',')}` : ''
+      console.log(`- ${item.id} [${status}] ${item.title}${dueDate}${tags}`)
+    })
+    return
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+async function login(args) {
+  const apiUrlAnswer = args['api-url'] || await prompt(`请输入 API 域名 [${DEFAULT_API_URL}]: `)
+  const apiUrl = normalizeApiUrl(apiUrlAnswer || DEFAULT_API_URL)
+  const code = args.code || await prompt('请输入邀请码 code: ')
+
+  if (!code) throw new Error('code 不能为空')
+
+  const result = await requestJson(buildUrl(apiUrl, '/api/list', code))
+  writeConfig({ apiUrl, code, loggedInAt: new Date().toISOString() })
+
+  printResult({
+    success: true,
+    apiUrl,
+    message: '登录成功，code 已保存到本地',
+    verify: { count: result.count },
+  }, args.json)
+}
+
+async function list(args) {
+  const { apiUrl, code } = requireLogin(args)
+  const result = await requestJson(buildUrl(apiUrl, '/api/list', code))
+  printResult(result, args.json)
+}
+
+async function create(args) {
+  const { apiUrl, code } = requireLogin(args)
+
+  if (!args.title) throw new Error('create 需要 --title')
+
+  const now = new Date().toISOString()
+  const payload = {
+    title: args.title,
+    notes: args.notes,
+    dueDate: args['due-date'],
+    priority: args.priority,
+    tags: parseTags(args.tags),
+    rank: toNumber(args.rank, '--rank') ?? 0,
+    completed: toBoolean(args.completed, '--completed') ?? false,
+    createdAt: now,
+    updatedAt: now,
+  }
+
+  const result = await requestJson(buildUrl(apiUrl, '/api/insert', code), {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(payload),
+  })
+
+  printResult(result, args.json)
+}
+
+async function update(args) {
+  const { apiUrl, code } = requireLogin(args)
+
+  if (!args.id) throw new Error('update 需要 --id')
+
+  const payload = {
+    id: args.id,
+    title: args.title,
+    notes: args.notes,
+    dueDate: args['due-date'],
+    priority: args.priority,
+    tags: parseTags(args.tags),
+    rank: toNumber(args.rank, '--rank'),
+    completed: toBoolean(args.completed, '--completed'),
+  }
+
+  Object.keys(payload).forEach(key => {
+    if (payload[key] === undefined) delete payload[key]
+  })
+
+  const result = await requestJson(buildUrl(apiUrl, '/api/update', code), {
+    method: 'PUT',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(payload),
+  })
+
+  printResult(result, args.json)
+}
+
+async function remove(args) {
+  const { apiUrl, code } = requireLogin(args)
+
+  if (!args.id) throw new Error('delete 需要 --id')
+
+  const result = await requestJson(buildUrl(apiUrl, '/api/delete', code, { id: args.id }), {
+    method: 'DELETE',
+  })
+
+  printResult(result, args.json)
+}
+
+function help(args) {
+  const topic = args._[1] || 'overview'
+  console.log((HELP[topic] || HELP.overview).trim())
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2))
+  const command = args._[0] || 'help'
+
+  if (command === 'help' || args.help) return help(args)
+  if (command === 'login') return login(args)
+  if (command === 'list') return list(args)
+  if (command === 'create') return create(args)
+  if (command === 'update') return update(args)
+  if (command === 'delete') return remove(args)
+
+  throw new Error(`未知命令: ${command}。运行 reminders help 查看用法。`)
+}
+
+main().catch(error => {
+  console.error(`错误: ${error.message}`)
+  process.exit(1)
+})

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@cyt528300/reminders-cli",
+  "version": "0.1.0",
+  "description": "Command line client for the Reminders app API.",
+  "license": "MIT",
+  "type": "commonjs",
+  "bin": {
+    "reminders": "bin/reminders.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}