@tuqo/cli 0.1.0

package/README.md

@@ -0,0 +1,38 @@
+# @tuqo/cli
+
+Деплой статических сайтов на [Tuqo](https://tuqo.ru) — content-addressed, с дедупом.
+Файлы грузятся поштучно по sha256: нет лимита на размер тела запроса, а совпадающие
+файлы между деплоями **не перезаливаются** (правка текста не трогает картинки).
+
+## Использование
+
+```bash
+TUQO_KEY=tqk_xxx_yyy npx @tuqo/cli deploy ./dist --site <site_id> --wait
+```
+
+| Опция | |
+|---|---|
+| `--site <id>` | site_id (из панели, `whoami` или `create_site`) — обязателен |
+| `--key <tqk_>` | project API key (или env `TUQO_KEY`) |
+| `--api <url>` | базовый адрес API (по умолчанию `https://api.tuqo.ru`) |
+| `--wait` | дождаться окончания сборки (poll статуса) |
+
+В каталоге должен быть `index.html` в корне. Лимиты: до 2000 файлов, до 200 МБ суммарно,
+до 30 МБ на файл. Для агентов (Claude Code и т.п.): байты читаются с диска и не проходят
+через контекст модели — медиа-сайты деплоятся без расхода токенов на base64.
+
+CLI — тонкая обёртка над публичным REST-API манифест-деплоя
+(`/deploys/check` → `PUT /blobs/{sha256}` → `/deploys/manifest`), документация: https://tuqo.ru/api#uploads
+
+## Публикация в npm (для мейнтейнеров)
+
+Пакет zero-dependency и готов к публикации. Нужен доступ к npm-организации `@tuqo`:
+
+```bash
+cd cli
+npm login                 # под аккаунтом с доступом к @tuqo
+npm publish               # publishConfig.access=public уже задан
+```
+
+До публикации можно гонять локально: `node cli/bin/tuqo.js deploy ./dist --site <id>`.
+

package/bin/tuqo.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+'use strict'
+// Tuqo CLI. Использование:
+//   npx @tuqo/cli deploy <dir> --site <site_id> [--key tqk_...] [--api https://api.tuqo.ru] [--wait]
+// Ключ можно задать через env TUQO_KEY. site_id — из панели или whoami/create_site.
+
+const { deployDir, api } = require('../lib/deploy')
+
+function parseArgs(argv) {
+  const a = { _: [] }
+  for (let i = 0; i < argv.length; i++) {
+    const t = argv[i]
+    if (t.startsWith('--')) {
+      const k = t.slice(2)
+      if (i + 1 < argv.length && !argv[i + 1].startsWith('--')) a[k] = argv[++i]
+      else a[k] = true
+    } else a._.push(t)
+  }
+  return a
+}
+
+const HELP = `Tuqo CLI — деплой статических сайтов (content-addressed, дедуп).
+
+  npx @tuqo/cli deploy <dir> --site <site_id> [опции]
+
+Опции:
+  --site <id>    site_id (обязателен)
+  --key  <tqk_>  project API key (или env TUQO_KEY)
+  --api  <url>   базовый адрес API (по умолчанию https://api.tuqo.ru)
+  --wait         дождаться завершения сборки (poll статуса)
+
+Примеры:
+  TUQO_KEY=tqk_xxx_yyy npx @tuqo/cli deploy ./dist --site 1234... --wait
+`
+
+async function pollStatus(apiBase, key, deployId, log) {
+  for (let i = 0; i < 120; i++) {
+    const d = await api(apiBase, key, 'GET', `/api/v1/deploys/${deployId}`)
+    if (d.status === 'active') { log(`статус: active ✓`); return d }
+    if (d.status === 'failed') { throw new Error(`сборка упала: ${d.error || 'см. логи'}`) }
+    log(`статус: ${d.status}…`)
+    await new Promise((r) => setTimeout(r, d.recommended_poll_ms || 2000))
+  }
+  throw new Error('таймаут ожидания сборки')
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2))
+  const cmd = args._[0]
+  if (!cmd || cmd === 'help' || args.help) { process.stdout.write(HELP); return }
+
+  if (cmd === 'deploy') {
+    const dir = args._[1]
+    const siteId = args.site
+    const key = args.key || process.env.TUQO_KEY
+    const apiBase = (args.api || 'https://api.tuqo.ru').replace(/\/$/, '')
+    if (!dir) throw new Error('укажите каталог: deploy <dir>')
+    if (!siteId) throw new Error('укажите --site <site_id>')
+    if (!key) throw new Error('укажите --key tqk_... или env TUQO_KEY')
+
+    const log = (m) => process.stderr.write(m + '\n')
+    log(`деплой ${dir} → сайт ${siteId}`)
+    const deploy = await deployDir(dir, { apiBase, key, siteId, log })
+    log(`деплой создан: ${deploy.id} (${deploy.status})`)
+    if (args.wait) await pollStatus(apiBase, key, deploy.id, log)
+    // В stdout — машиночитаемый id (для скриптов/агентов).
+    process.stdout.write(deploy.id + '\n')
+    return
+  }
+
+  throw new Error(`неизвестная команда: ${cmd} (см. npx @tuqo/cli help)`)
+}
+
+main().catch((e) => {
+  process.stderr.write(`ошибка: ${e.message}\n`)
+  if (e.data && e.data.missing) process.stderr.write(`не загружено: ${e.data.missing.length} блобов\n`)
+  process.exit(1)
+})

package/lib/deploy.js

@@ -0,0 +1,93 @@
+'use strict'
+// Манифест-деплой: хешируем файлы → узнаём недостающие блобы → грузим их поштучно
+// → создаём деплой. Байты не проходят через контекст модели (читаются с диска),
+// дедуп не перезаливает совпадающие файлы между деплоями. Zero-dep (Node 18+).
+
+const fs = require('fs')
+const path = require('path')
+const crypto = require('crypto')
+
+/** Рекурсивно собирает файлы каталога в [{ rel, abs }] (POSIX-пути, без симлинков). */
+function walk(dir, base = dir, out = []) {
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const abs = path.join(dir, entry.name)
+    if (entry.isDirectory()) walk(abs, base, out)
+    else if (entry.isFile()) {
+      const rel = path.relative(base, abs).split(path.sep).join('/')
+      out.push({ rel, abs })
+    }
+  }
+  return out
+}
+
+function sha256File(abs) {
+  return crypto.createHash('sha256').update(fs.readFileSync(abs)).digest('hex')
+}
+
+async function api(base, key, method, route, { json, body, raw } = {}) {
+  const headers = { Authorization: `Bearer ${key}` }
+  let payload = body
+  if (json !== undefined) {
+    headers['Content-Type'] = 'application/json'
+    payload = JSON.stringify(json)
+  } else if (raw !== undefined) {
+    headers['Content-Type'] = 'application/octet-stream'
+    payload = raw
+  }
+  const res = await fetch(`${base}${route}`, { method, headers, body: payload })
+  const text = await res.text()
+  let data
+  try { data = text ? JSON.parse(text) : {} } catch { data = { raw: text } }
+  if (!res.ok) {
+    const msg = data && (data.error || data.message) ? data.error || data.message : `HTTP ${res.status}`
+    const err = new Error(msg)
+    err.status = res.status
+    err.data = data
+    throw err
+  }
+  return data
+}
+
+/**
+ * Деплой каталога `dir` на сайт `siteId`.
+ * opts: { apiBase, key, siteId, log }
+ * Возвращает объект деплоя (как REST `POST /deploys/manifest`).
+ */
+async function deployDir(dir, { apiBase, key, siteId, log = () => {} }) {
+  const files = walk(dir)
+  if (files.length === 0) throw new Error(`каталог пуст: ${dir}`)
+  if (!files.some((f) => f.rel === 'index.html')) {
+    throw new Error('нужен index.html в корне каталога')
+  }
+  // Манифест: путь → sha256 (+ размер).
+  const manifest = files.map((f) => {
+    const sha256 = sha256File(f.abs)
+    return { path: f.rel, sha256, size: fs.statSync(f.abs).size, abs: f.abs }
+  })
+  log(`файлов: ${manifest.length}, хеширование готово`)
+
+  // 1) Какие блобы серверу не хватает.
+  const wire = manifest.map(({ path, sha256, size }) => ({ path, sha256, size }))
+  const { missing } = await api(apiBase, key, 'POST', `/api/v1/sites/${siteId}/deploys/check`, {
+    json: { files: wire },
+  })
+  log(`к загрузке: ${missing.length} (дедуп переиспользовал ${manifest.length - missing.length})`)
+
+  // 2) Грузим недостающие блобы поштучно (по одному уникальному хешу).
+  const need = new Set(missing)
+  const uploadedHash = new Set()
+  for (const f of manifest) {
+    if (!need.has(f.sha256) || uploadedHash.has(f.sha256)) continue
+    await api(apiBase, key, 'PUT', `/api/v1/blobs/${f.sha256}`, { raw: fs.readFileSync(f.abs) })
+    uploadedHash.add(f.sha256)
+    log(`  загружен ${f.path} (${f.sha256.slice(0, 12)}…)`)
+  }
+
+  // 3) Создаём деплой из манифеста.
+  const deploy = await api(apiBase, key, 'POST', `/api/v1/sites/${siteId}/deploys/manifest`, {
+    json: { files: manifest.map(({ path, sha256 }) => ({ path, sha256 })) },
+  })
+  return deploy
+}
+
+module.exports = { deployDir, api }

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@tuqo/cli",
+  "version": "0.1.0",
+  "description": "Tuqo CLI — деплой статических сайтов (content-addressed, дедуп). npx @tuqo/cli deploy ./dist",
+  "bin": {
+    "tuqo": "bin/tuqo.js"
+  },
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md"
+  ],
+  "keywords": ["tuqo", "deploy", "static", "hosting", "cli"],
+  "license": "MIT",
+  "homepage": "https://tuqo.ru/docs",
+  "publishConfig": {
+    "access": "public"
+  }
+}