@wwkit/opm 1.0.3 → 1.0.4

package/src/tools/share/index.js

@@ -0,0 +1,735 @@
+/**
+ * opm share 命令组 — 文本分享服务
+ *
+ * 命令：upload / zip / get / view / open / list / delete / clear / config / serve / help
+ * 服务地址由 config.share.server.active 解析（不支持命令行 -s 参数）。
+ * 需要服务调用的命令执行前先 ping 验证可达性；
+ * 若 active=local 且服务未启动，自动后台启动后再执行。
+ * serve 子命令：start（后台启动）/ stop（停止）/ status（查询状态）。
+ * zip 上传文件/文件夹（压缩为 zip 后 base64 上传），get -d 下载并解压。
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import { spawn, spawnSync } from 'node:child_process'
+import { parseFlags } from '../../cli/helpers/args.js'
+import { getConfig, getSection, getUserConfigDir } from '../../config.js'
+import { output } from '../../formatter.js'
+import { getShareServer, pingServer, uploadShare, getShare, getLatestShare, getHtmlUrl, listShares, deleteShare, clearShares } from './client.js'
+import { startServer } from './server.js'
+
+const DEFAULT_PASSWORD = '0000'
+const ZIP_TMP_PREFIX = 'opm-share-'
+
+/**
+ * 生成默认标题（内容前 30 字符折叠空白 + ...，≤30 用原文）
+ * @param {string} content
+ * @returns {string}
+ */
+function defaultTitle(content) {
+  const folded = content.replace(/\s+/g, ' ').trim()
+  if (folded.length <= 30) return folded
+  return folded.slice(0, 30) + '...'
+}
+
+/**
+ * 展开 ~ 路径
+ * @param {string} p
+ * @returns {string}
+ */
+function expandTilde(p) {
+  if (p && p.startsWith('~/')) {
+    return path.join(os.homedir(), p.slice(2))
+  }
+  return p
+}
+
+/**
+ * 浏览器打开 URL
+ * @param {string} url
+ */
+function openBrowser(url) {
+  const platform = process.platform
+  let cmd
+  if (platform === 'darwin') {
+    cmd = `open "${url}"`
+  } else if (platform === 'win32') {
+    cmd = `start "" "${url}"`
+  } else {
+    cmd = `xdg-open "${url}"`
+  }
+  try {
+    spawnSync(cmd, { shell: true, stdio: 'ignore' })
+  } catch {}
+}
+
+/**
+ * 获取 serve 状态文件路径
+ * @returns {string}
+ */
+function getServePidFile() {
+  return path.join(getUserConfigDir(), 'share', 'serve.pid')
+}
+
+/**
+ * 读取 serve PID 文件
+ * @returns {{pid: number, url: string, host: string, port: number, dataDir: string, started: string}|null}
+ */
+function readServePid() {
+  const pidFile = getServePidFile()
+  if (!fs.existsSync(pidFile)) return null
+  try {
+    return JSON.parse(fs.readFileSync(pidFile, 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+/**
+ * 检查进程是否存活
+ * @param {number} pid
+ * @returns {boolean}
+ */
+function isProcessAlive(pid) {
+  if (!pid) return false
+  try {
+    process.kill(pid, 0)
+    return true
+  } catch {
+    return false
+  }
+}
+
+const ACTIONS = {
+  upload: { desc: 'Upload text content (positional, -f file, or stdin; -i for custom id)' },
+  zip:    { desc: 'Upload file/folder as compressed zip (get -d to extract; -i for custom id)' },
+  get:    { desc: 'Get shared content (id optional; defaults to latest; -d to extract zip)' },
+  view:   { desc: 'View shared content (id optional; defaults to latest)' },
+  open:   { desc: 'Open shared content in browser (id optional; defaults to latest)' },
+  list:   { desc: 'List recent shares (-n count, default 10)' },
+  delete: { desc: 'Delete a share by id' },
+  clear:  { desc: 'Clean up shares by days and/or keep count' },
+  config: { desc: 'Show current share config section' },
+  serve:  { desc: 'Manage local server (start/stop/status)' },
+  help:   { desc: 'Show this help' },
+}
+
+export class ShareGroup {
+  constructor() {
+    this.name = 'share'
+    this.desc = 'Text sharing service (upload/get/open/list/serve)'
+  }
+
+  async run(argv) {
+    const [action, ...rest] = argv
+
+    if (!action || action === '-h' || action === '--help' || action === 'help') {
+      this.printHelp()
+      return
+    }
+
+    const parsed = parseFlags(rest)
+
+    switch (action) {
+      case 'upload':
+        return this._upload(parsed)
+      case 'zip':
+        return this._zip(parsed)
+      case 'get':
+        return this._get(parsed)
+      case 'view':
+        return this._view(parsed)
+      case 'open':
+        return this._open(parsed)
+      case 'list':
+        return this._list(parsed)
+      case 'delete':
+        return this._delete(parsed)
+      case 'clear':
+        return this._clear(parsed)
+      case 'config':
+        return this._config(parsed)
+      case 'serve':
+        return this._serve(parsed)
+      default:
+        return this._upload(parseFlags([action, ...rest]))
+    }
+  }
+
+  _getShareConfig() {
+    return getSection(getConfig(), 'share') || {}
+  }
+
+  _getServerUrl() {
+    return getShareServer(this._getShareConfig())
+  }
+
+  _isLocalActive() {
+    const cfg = this._getShareConfig()
+    const server = cfg.server || {}
+    return server.active === 'local'
+  }
+
+  _getServeOpts() {
+    const cfg = this._getShareConfig()
+    const serve = cfg.serve || {}
+    return {
+      host: serve.host || '0.0.0.0',
+      port: serve.port || 8787,
+      dataDir: expandTilde(serve.dataDir || '~/.config/opm/share/data'),
+    }
+  }
+
+  /**
+   * 解析密码：-p/--password 参数 > 配置 share.password > 位置参数（get/open）> 默认 0000
+   * @param {object} parsed - parseFlags 结果
+   * @param {string} [positional] - 位置参数密码（get/open 的第二个位置参数）
+   * @returns {string}
+   */
+  _resolvePassword(parsed, positional = '') {
+    const flag = parsed.flags.p || parsed.flags.password || ''
+    if (flag && flag !== 'true') return flag
+    const cfgPassword = this._getShareConfig().password
+    if (cfgPassword) return cfgPassword
+    return positional || DEFAULT_PASSWORD
+  }
+
+  /**
+   * 确保服务可达：ping 不通且 active=local 时自动后台启动
+   * @returns {Promise<string>} baseUrl
+   */
+  async _ensureReachable() {
+    const baseUrl = this._getServerUrl()
+    if (!baseUrl) {
+      console.error('[opm share] No server configured. Run "opm share config" to check.')
+      process.exit(1)
+    }
+
+    const result = await pingServer(baseUrl)
+    if (result.reachable) return baseUrl
+
+    if (!this._isLocalActive()) {
+      console.error(`[opm share] Server unreachable: ${baseUrl}`)
+      console.error(`[opm share] ${result.message}`)
+      console.error('[opm share] Run "opm share config" to check.')
+      process.exit(1)
+    }
+
+    console.error('[opm share] Local server not running, starting...')
+    this._startBackground()
+
+    for (let i = 0; i < 10; i++) {
+      await new Promise((r) => setTimeout(r, 300))
+      const recheck = await pingServer(baseUrl)
+      if (recheck.reachable) {
+        console.error('[opm share] Server started.')
+        return baseUrl
+      }
+    }
+
+    console.error(`[opm share] Failed to start local server. Run "opm share serve status" to check.`)
+    process.exit(1)
+  }
+
+  async _upload(parsed) {
+    const title = parsed.flags.t || parsed.flags.title || ''
+    const file = parsed.flags.f || parsed.flags.file || ''
+    const id = parsed.flags.i || parsed.flags.id || ''
+    const password = this._resolvePassword(parsed)
+
+    let content = ''
+
+    if (file) {
+      const resolved = path.resolve(file)
+      if (!fs.existsSync(resolved)) {
+        console.error(`File not found: ${resolved}`)
+        process.exit(1)
+      }
+      content = fs.readFileSync(resolved, 'utf8')
+    } else if (parsed.positional.length > 0) {
+      content = parsed.positional.join(' ')
+    } else if (!process.stdin.isTTY) {
+      content = fs.readFileSync(0, 'utf8')
+    }
+
+    if (!content) {
+      console.error('Usage: opm share upload "<content>" [-t title] [-f file] [-i id] [-p password]')
+      console.error('  Or: echo "..." | opm share upload [-t title] [-i id] [-p password]')
+      console.error('  Or: opm share "<content>" [-t title] [-i id] [-p password]  (shorthand without "upload")')
+      process.exit(1)
+    }
+
+    const baseUrl = await this._ensureReachable()
+    const result = await uploadShare(baseUrl, {
+      title: title || defaultTitle(content),
+      content,
+      password,
+      ...(id ? { id } : {}),
+    })
+    output(result)
+  }
+
+  async _zip(parsed) {
+    const inputPath = parsed.positional[0] || parsed.flags.f || parsed.flags.file || ''
+    const title = parsed.flags.t || parsed.flags.title || ''
+    const id = parsed.flags.i || parsed.flags.id || ''
+    const password = this._resolvePassword(parsed)
+
+    if (!inputPath) {
+      console.error('Usage: opm share zip <path> [-t title] [-i id] [-p password]')
+      process.exit(1)
+    }
+
+    const resolved = path.resolve(inputPath)
+    if (!fs.existsSync(resolved)) {
+      console.error(`Path not found: ${resolved}`)
+      process.exit(1)
+    }
+
+    const stat = fs.statSync(resolved)
+    const isDir = stat.isDirectory()
+    if (isDir) {
+      const entries = fs.readdirSync(resolved)
+      if (entries.length === 0) {
+        console.error(`Directory is empty: ${resolved}`)
+        process.exit(1)
+      }
+    }
+
+    const baseName = path.basename(resolved)
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), ZIP_TMP_PREFIX))
+    const zipPath = path.join(tmpDir, `${baseName}.zip`)
+
+    const zipArgs = isDir ? ['-r', zipPath, baseName] : [zipPath, baseName]
+    const zipResult = spawnSync('zip', zipArgs, {
+      cwd: path.dirname(resolved),
+      stdio: ['pipe', 'pipe', 'pipe'],
+    })
+
+    if (zipResult.status !== 0) {
+      const stderr = zipResult.stderr ? zipResult.stderr.toString().trim() : 'unknown error'
+      console.error(`Zip failed: ${stderr}`)
+      fs.rmSync(tmpDir, { recursive: true, force: true })
+      process.exit(1)
+    }
+
+    const zipBuffer = fs.readFileSync(zipPath)
+    const content = zipBuffer.toString('base64')
+
+    fs.rmSync(tmpDir, { recursive: true, force: true })
+
+    const baseUrl = await this._ensureReachable()
+    const result = await uploadShare(baseUrl, {
+      title: title || `${baseName}.zip`,
+      content,
+      password,
+      type: 'zip',
+      filename: `${baseName}.zip`,
+      ...(id ? { id } : {}),
+    })
+    output(result)
+  }
+
+  async _get(parsed) {
+    const id = parsed.positional[0] || ''
+    const password = this._resolvePassword(parsed, parsed.positional[1] || '')
+    const extractDir = parsed.flags.d || parsed.flags.dir || ''
+
+    const baseUrl = await this._ensureReachable()
+    const result = id
+      ? await getShare(baseUrl, id, password)
+      : await getLatestShare(baseUrl, password)
+
+    if (result.type === 'zip' && extractDir) {
+      await this._extractZip(result, extractDir)
+      return
+    }
+
+    output(result)
+  }
+
+  async _extractZip(result, dir) {
+    const resolvedDir = path.resolve(dir)
+    fs.mkdirSync(resolvedDir, { recursive: true })
+
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), ZIP_TMP_PREFIX))
+    const zipPath = path.join(tmpDir, result.filename || `${result.id}.zip`)
+
+    try {
+      const buf = Buffer.from(result.content, 'base64')
+      fs.writeFileSync(zipPath, buf)
+
+      const { default: extractZip } = await import('extract-zip')
+      await extractZip(zipPath, { dir: resolvedDir })
+
+      const files = this._listTopLevel(resolvedDir)
+      output({
+        id: result.id,
+        title: result.title,
+        type: 'zip',
+        filename: result.filename,
+        created: result.created,
+        extracted: true,
+        dir: resolvedDir,
+        files,
+      })
+    } catch (err) {
+      console.error(`Extract failed: ${err.message}`)
+      process.exit(1)
+    } finally {
+      fs.rmSync(tmpDir, { recursive: true, force: true })
+    }
+  }
+
+  /**
+   * 列出目录一级文件清单
+   * @param {string} dir
+   * @returns {Array<{name: string, type: string}>}
+   */
+  _listTopLevel(dir) {
+    try {
+      return fs.readdirSync(dir, { withFileTypes: true }).map((e) => ({
+        name: e.name,
+        type: e.isDirectory() ? 'dir' : 'file',
+      }))
+    } catch {
+      return []
+    }
+  }
+
+  async _view(parsed) {
+    const id = parsed.positional[0] || ''
+    const password = this._resolvePassword(parsed, parsed.positional[1] || '')
+
+    const baseUrl = await this._ensureReachable()
+    const result = id
+      ? await getShare(baseUrl, id, password)
+      : await getLatestShare(baseUrl, password)
+
+    if (result.type === 'zip') {
+      const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), ZIP_TMP_PREFIX))
+      try {
+        const zipPath = path.join(tmpDir, result.filename || `${result.id}.zip`)
+        const buf = Buffer.from(result.content, 'base64')
+        fs.writeFileSync(zipPath, buf)
+
+        const { default: extractZip } = await import('extract-zip')
+        await extractZip(zipPath, { dir: tmpDir })
+
+        fs.unlinkSync(zipPath)
+
+        const files = this._listTopLevel(tmpDir)
+        for (const f of files) {
+          console.log(`${f.type === 'dir' ? 'd' : 'f'}  ${f.name}`)
+        }
+      } catch (err) {
+        console.error(`View zip failed: ${err.message}`)
+        process.exit(1)
+      } finally {
+        fs.rmSync(tmpDir, { recursive: true, force: true })
+      }
+      return
+    }
+
+    process.stdout.write(result.content || '')
+    if (!(result.content || '').endsWith('\n')) {
+      process.stdout.write('\n')
+    }
+  }
+
+  async _open(parsed) {
+    const id = parsed.positional[0] || ''
+    const password = this._resolvePassword(parsed, parsed.positional[1] || '')
+
+    const baseUrl = await this._ensureReachable()
+
+    if (id) {
+      const htmlUrl = getHtmlUrl(baseUrl, id, password)
+      openBrowser(htmlUrl)
+      output({ opened: true, url: htmlUrl })
+    } else {
+      const result = await getLatestShare(baseUrl, password)
+      const htmlUrl = getHtmlUrl(baseUrl, result.id, password)
+      openBrowser(htmlUrl)
+      output({ opened: true, id: result.id, url: htmlUrl })
+    }
+  }
+
+  async _list(parsed) {
+    const n = parseInt(parsed.flags.n || parsed.flags.count || '10', 10) || 10
+
+    const baseUrl = await this._ensureReachable()
+    const result = await listShares(baseUrl, n)
+    output(result)
+  }
+
+  async _delete(parsed) {
+    const id = parsed.positional[0]
+    if (!id) {
+      console.error('Usage: opm share delete <id>')
+      process.exit(1)
+    }
+
+    const baseUrl = await this._ensureReachable()
+    const result = await deleteShare(baseUrl, id)
+    output(result)
+  }
+
+  async _clear(parsed) {
+    const days = parseInt(parsed.flags.days || '0', 10) || 0
+    const keep = parseInt(parsed.flags.keep || parsed.flags.n || '0', 10) || 0
+
+    if (!days && !keep) {
+      console.error('Usage: opm share clear [--days <n>] [--keep <n>]')
+      console.error('  --days <n>  Delete shares older than n days')
+      console.error('  --keep <n>  Keep only the most recent n shares')
+      console.error('  Both can be combined: clear --days 7 --keep 50')
+      process.exit(1)
+    }
+
+    const baseUrl = await this._ensureReachable()
+    const result = await clearShares(baseUrl, { days, keep })
+    output(result)
+  }
+
+  _config() {
+    const cfg = this._getShareConfig()
+    output(cfg)
+  }
+
+  async _serve(parsed) {
+    const [sub] = parsed.positional
+
+    if (sub === 'start') {
+      return this._serveStart()
+    }
+    if (sub === 'stop') {
+      return this._serveStop()
+    }
+    if (sub === 'status' || !sub) {
+      return this._serveStatus()
+    }
+    if (sub === 'help' || sub === '-h' || sub === '--help') {
+      this._serveHelp()
+      return
+    }
+
+    console.error(`Unknown serve subcommand: ${sub}`)
+    console.error('Usage: opm share serve [start|stop|status|help]')
+    process.exit(1)
+  }
+
+  _serveHelp() {
+    console.log(`
+Usage: opm share serve <subcommand>
+
+Subcommands:
+  start     Start local server (background, reads host/port/dataDir from config)
+  stop      Stop local server
+  status    Check if server is running
+  help      Show this help
+
+Local development:
+  opm share serve start                Start in background (reads config)
+  opm share serve status               Check status
+  opm share serve stop                 Stop server
+  opm share config                     Show current config (host/port/dataDir)
+
+  # Or run server.js directly (foreground):
+  node src/tools/share/server.js
+  OPM_SHARE_HOST=0.0.0.0 OPM_SHARE_PORT=9000 node src/tools/share/server.js
+
+Deploy to server:
+  # 1. Install @wwkit/opm on the server
+  npm install -g @wwkit/opm
+
+  # 2. Configure share.server.active to the server's URL
+  #    Edit ~/.config/opm/config.json5:
+  #    share.server.active = "official"  # or a custom URL
+
+  # 3. Start the server (foreground or via process manager)
+  opm share serve start
+  # Or with custom env:
+  OPM_SHARE_HOST=0.0.0.0 OPM_SHARE_PORT=80 OPM_SHARE_DATA_DIR=/var/lib/opm/share node src/tools/share/server.js
+
+  # 4. Use systemd / pm2 / docker for production:
+  #    pm2 start src/tools/share/server.js --name opm-share
+  #    pm2 save && pm2 startup
+
+  # 5. Update client config to point to the server:
+  #    opm share config  # verify active points to the right URL
+
+API endpoints:
+  POST /share                          Upload share
+    Body: {title?, content, password?, type?, filename?}
+    Response: {id, url, htmlUrl}
+
+  GET  /share/<id>                     Browser -> HTML page; Accept: application/json -> JSON
+  GET  /share/<id>/<password>          Same with password
+
+  GET  /share/html/<id>                Always returns HTML page
+  GET  /share/html/<id>/<password>     Same with password
+
+  GET  /share/list?n=10                List recent shares (default 10)
+    Response: {count, items: [{id, title, created}]}
+
+  POST /share/delete/<id>              Delete a share by id
+    Response: {deleted: true, id}
+
+  POST /share/clear?days=7&keep=10    Clean up by age and/or count
+    Response: {deleted: number, ids: [string]}
+
+Environment variables (for server.js direct execution):
+  OPM_SHARE_HOST       Listen host (default: 127.0.0.1)
+  OPM_SHARE_PORT       Listen port (default: 8787)
+  OPM_SHARE_DATA_DIR   Data directory (default: ~/.config/opm/share/data)
+`)
+  }
+
+  _serveStart() {
+    const existing = readServePid()
+    if (existing && isProcessAlive(existing.pid)) {
+      output({ running: true, pid: existing.pid, url: existing.url, host: existing.host, port: existing.port, dataDir: existing.dataDir, started: existing.started, message: 'Server already running' })
+      return
+    }
+
+    this._startBackground()
+    output({ started: true, message: 'Server started in background. Run "opm share serve status" to check.' })
+  }
+
+  _startBackground() {
+    const opts = this._getServeOpts()
+    const pidFile = getServePidFile()
+    fs.mkdirSync(path.dirname(pidFile), { recursive: true })
+
+    const logFile = path.join(path.dirname(pidFile), 'serve.log')
+    const logFd = fs.openSync(logFile, 'a')
+    const child = spawn(process.execPath, [path.join(path.dirname(new URL(import.meta.url).pathname), 'server.js')], {
+      detached: true,
+      stdio: ['ignore', logFd, logFd],
+      env: {
+        ...process.env,
+        OPM_SHARE_HOST: opts.host,
+        OPM_SHARE_PORT: String(opts.port),
+        OPM_SHARE_DATA_DIR: opts.dataDir,
+      },
+    })
+    child.unref()
+
+    const pidInfo = {
+      pid: child.pid,
+      url: `http://${opts.host}:${opts.port}`,
+      host: opts.host,
+      port: opts.port,
+      dataDir: opts.dataDir,
+      started: new Date().toISOString(),
+    }
+    fs.writeFileSync(pidFile, JSON.stringify(pidInfo, null, 2), 'utf8')
+  }
+
+  _serveStop() {
+    const pidInfo = readServePid()
+    if (!pidInfo) {
+      output({ stopped: true, message: 'No serve process found (pid file missing)' })
+      return
+    }
+
+    if (!isProcessAlive(pidInfo.pid)) {
+      fs.unlinkSync(getServePidFile())
+      output({ stopped: true, message: 'Process was not running (cleaned stale pid file)' })
+      return
+    }
+
+    try {
+      process.kill(pidInfo.pid, 'SIGTERM')
+    } catch {}
+
+    const pidFile = getServePidFile()
+    if (fs.existsSync(pidFile)) fs.unlinkSync(pidFile)
+    output({ stopped: true, pid: pidInfo.pid, url: pidInfo.url, message: 'Server stopped' })
+  }
+
+  _serveStatus() {
+    const pidInfo = readServePid()
+    if (!pidInfo) {
+      output({ running: false, message: 'No serve process found' })
+      return
+    }
+
+    if (!isProcessAlive(pidInfo.pid)) {
+      const pidFile = getServePidFile()
+      if (fs.existsSync(pidFile)) fs.unlinkSync(pidFile)
+      output({ running: false, pid: pidInfo.pid, message: 'Process was not running (cleaned stale pid file)' })
+      return
+    }
+
+    output({ running: true, ...pidInfo })
+  }
+
+  printHelp() {
+    const actionLines = Object.entries(ACTIONS)
+      .map(([sig, { desc }]) => `  ${sig.padEnd(12)} ${desc}`)
+      .join('\n')
+
+    console.log(`
+Usage: opm share <action> [args] [options]
+
+Actions:
+${actionLines}
+
+Serve subcommands:
+  serve start                  Start local server (background)
+  serve stop                   Stop local server
+  serve status                 Check local server status
+
+Shorthand:
+  opm share "<content>" [-t title]     Upload (without "upload" keyword)
+  opm share -f <file>                  Upload file content (title auto-generated)
+  echo "..." | opm share [-t title]    Upload from stdin
+
+Options:
+  -t, --title <title>                  Title (default: first 30 chars of content)
+  -f, --file <path>                    Read content from file
+  -i, --id <id>                        Custom share id (upload/zip; easier to remember)
+  -p, --password <password>            Password (default: config share.password, fallback 0000)
+  -n, --count <n>                      Number of items (list, default: 10)
+  -d, --dir <dir>                      Extract zip to this directory (get)
+  -h, --help                           Show this help
+
+Server config (config.json5):
+  share.password                      Default password for share operations
+  share.server.active                 Active server (preset key or URL)
+  share.serve.host / .port / .dataDir  Local serve parameters
+
+Examples:
+  opm share config                     Show current share config
+  opm share serve start                Start local server (background)
+  opm share serve status               Check if server is running
+  opm share serve stop                 Stop local server
+  opm share "hello world" -t test      Upload text
+  opm share "hello world" -i myid      Upload text with custom id "myid"
+  opm share "hello world" -p 1234      Upload text with password override
+  opm share -f doc.md                  Upload file (title auto from content)
+  opm share -f doc.md -t "README"      Upload file with custom title
+  echo "hello" | opm share             Upload from stdin
+  opm share zip ./src                  Upload folder as zip
+  opm share zip ./config.json5         Upload file as zip
+  opm share get                        Get the latest share (JSON)
+  opm share get myid                   Get share by custom id
+  opm share get abc12345               Get share by random id
+  opm share get abc12345 -p 1234       Get with password override
+  opm share get abc12345 -d ./out      Download and extract zip to ./out
+  opm share view                       View the latest share content
+  opm share view myid                  View share by custom id
+  opm share open                       Open the latest share in browser
+  opm share open myid                  Open share by custom id in browser
+  opm share list                       List recent 10 shares
+  opm share list -n 5                  List recent 5 shares
+  opm share delete abc12345            Delete a share by id
+  opm share clear --days 7             Delete shares older than 7 days
+  opm share clear --keep 50            Keep only the most recent 50 shares
+  opm share clear --days 7 --keep 50   Both combined
+`)
+  }
+}