v8scli 0.2.1 → 0.3.0

package/bin/v8s.js

@@ -9,14 +9,22 @@ import { deps } from '../src/commands/deps.js';
 import { pull } from '../src/commands/pull.js';
 import { search } from '../src/commands/search.js';
 import { add, remove, update } from '../src/commands/add.js';
+import { create, edit, icon, cover, submit, release, whoami } from '../src/commands/mod.js';
 
 const [, , command, ...args] = process.argv;
 
-const commands = { init, build, login, upload, status, deps, pull, search, add, remove, update };
+const commands = { init, build, login, upload, status, deps, pull, search, add, remove, update,
+  create, edit, icon, cover, submit, release, whoami };
 
 const usage = `v8scli <command>
 
   init <slug> [--local]  scaffold a new mod in ./<slug> (--local: SDK/CLI from checkouts)
+  create [--library]  register the mod from ./mod.json on the portal
+  edit <flags>  change name/description/visibility (--name, --description, --full <file>, --visibility)
+  icon <file>   upload the square icon      cover <file>  upload the 16:9 cover
+  submit        send the latest uploaded version to dev review
+  release "notes"  publish the latest version to prod (admin approves)
+  whoami        show whose token is in use
   build         bundle the mod locally (self-check, dist/<slug>.js)
   login         save portal URL and API token (~/.config/v8s/config.json)
   upload        pack sources and upload a new version to the portal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "v8scli",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "CLI for building and publishing V8 point_script mods (companion of v8_scripting)",
   "license": "MIT",
   "type": "module",

package/src/commands/mod.js

@@ -0,0 +1,168 @@
+import { readFile } from 'node:fs/promises';
+import { basename, extname } from 'node:path';
+import { api, readConfig, readManifest } from '../common.js';
+
+/**
+ * Жизненный цикл мода из CLI: создать, описать, дать картинки, отправить.
+ *
+ * До этого создание и оформление жили только в веб-панели, и написать мод
+ * целиком из редактора было нельзя — приходилось прерываться на браузер.
+ * Все команды работают по API-токену.
+ */
+
+/** modId по slug из mod.json; вызывающему нужен и сам манифест */
+async function resolveMod(config, manifest) {
+  const { mods } = await api(config, '/api/mods/my');
+  const mod = mods.find((m) => m.slug === manifest.slug);
+  if (!mod) throw new Error(`mod "${manifest.slug}" not found on the portal — run \`v8scli create\` first`);
+  return mod;
+}
+
+/** Последняя версия мода — с ней работают submit и release */
+async function latestVersion(config, modId) {
+  const { versions } = await api(config, `/api/mods/${modId}`);
+  if (!versions?.length) throw new Error('no versions uploaded yet — run `v8scli upload` first');
+  return versions[0];
+}
+
+const MIME = { '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.webp': 'image/webp' };
+
+async function uploadImage(config, modId, path, kind) {
+  const body = await readFile(path);
+  const type = MIME[extname(path).toLowerCase()];
+  if (!type) throw new Error(`unsupported image type: ${extname(path)} (png, jpg, webp)`);
+
+  const form = new FormData();
+  form.append('file', new Blob([body], { type }), basename(path));
+
+  const { mod } = await api(config, `/api/mods/${modId}/${kind}`, { method: 'POST', body: form });
+  console.log(`${kind}: ${kind === 'icon' ? mod.iconUrl : mod.coverUrl}`);
+}
+
+/** v8scli create — заводит мод на портале по mod.json текущей папки */
+export async function create(args) {
+  const config = await readConfig();
+  const manifest = await readManifest();
+
+  const isLibrary = args.includes('--library') || Boolean(manifest.library);
+
+  const { mod } = await api(config, '/api/mods/create', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      slug: manifest.slug,
+      name: typeof manifest.name === 'string' ? manifest.name : manifest.slug,
+      description: typeof manifest.description === 'string' ? manifest.description : '',
+      isLibrary,
+    }),
+  });
+
+  console.log(`created: ${mod.slug} (#${mod.id})${isLibrary ? ' [library]' : ''}`);
+  console.log('next: v8scli upload');
+}
+
+/** v8scli edit --name … --description … --full FILE --visibility … */
+export async function edit(args) {
+  const config = await readConfig();
+  const manifest = await readManifest();
+  const mod = await resolveMod(config, manifest);
+
+  const value = (flag) => {
+    const at = args.indexOf(flag);
+    return at >= 0 ? args[at + 1] : undefined;
+  };
+
+  const body = {};
+  if (value('--name')) body.name = value('--name');
+  if (value('--description')) body.description = value('--description');
+  if (value('--visibility')) body.visibility = value('--visibility');
+  if (value('--full')) body.descriptionFull = await readFile(value('--full'), 'utf-8');
+
+  if (!Object.keys(body).length)
+    throw new Error('nothing to change: --name, --description, --full <file>, --visibility <public|whitelist|private>');
+
+  const { mod: updated } = await api(config, `/api/mods/${mod.id}/update`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(body),
+  });
+
+  console.log(`updated: ${updated.slug} — ${Object.keys(body).join(', ')}`);
+}
+
+/** v8scli icon <file> / v8scli cover <file> */
+export async function icon(args) {
+  const config = await readConfig();
+  const mod = await resolveMod(config, await readManifest());
+  if (!args[0]) throw new Error('usage: v8scli icon <file.png>');
+  await uploadImage(config, mod.id, args[0], 'icon');
+}
+
+export async function cover(args) {
+  const config = await readConfig();
+  const mod = await resolveMod(config, await readManifest());
+  if (!args[0]) throw new Error('usage: v8scli cover <file.png>');
+  await uploadImage(config, mod.id, args[0], 'cover');
+}
+
+/** v8scli submit — последнюю загруженную версию на дев-проверку */
+export async function submit() {
+  const config = await readConfig();
+  const mod = await resolveMod(config, await readManifest());
+  const version = await latestVersion(config, mod.id);
+
+  // У разработчиков команды загрузка сразу даёт dev_ready — отправлять нечего,
+  // и это нормальный исход, а не ошибка: сценарий «залил и тестирую» не ломается
+  if (version.status === 'dev_ready') {
+    console.log(`${version.version}: already dev_ready — ready to test in your lobby`);
+    return;
+  }
+
+  if (version.status !== 'draft')
+    throw new Error(`version ${version.version} is ${version.status}, nothing to submit`);
+
+  const { version: moved } = await api(config, `/api/mods/${mod.id}/versions/${version.id}/action`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ action: 'submit_dev' }),
+  });
+
+  // У разработчиков команды дев-ревью пропускается, и версия сразу dev_ready
+  console.log(`${moved.version}: ${moved.status}`);
+  console.log(moved.status === 'dev_ready'
+    ? 'ready to test in your lobby'
+    : 'sent to review');
+}
+
+/** v8scli release "заметки к релизу" — публикация версии в прод */
+export async function release(args) {
+  const config = await readConfig();
+  const mod = await resolveMod(config, await readManifest());
+  const version = await latestVersion(config, mod.id);
+
+  const notes = args.join(' ').trim();
+  if (notes.length < 10)
+    throw new Error('release notes are required (10 characters or more): v8scli release "what changed"');
+
+  if (version.status === 'draft')
+    throw new Error(`version ${version.version} is still a draft — run \`v8scli submit\` first`);
+
+  const { version: moved } = await api(config, `/api/mods/${mod.id}/versions/${version.id}/action`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ action: 'submit_release', changelog: notes }),
+  });
+
+  console.log(`${moved.version}: ${moved.status} — waiting for an admin to publish it`);
+}
+
+/** v8scli whoami — чей это токен и можно ли им работать */
+export async function whoami() {
+  const config = await readConfig();
+  const { developer } = await api(config, '/api/developers/me');
+
+  if (!developer) throw new Error('token is valid but the account is not a developer yet');
+
+  console.log(`${developer.nickname} (${developer.accountId}) — ${developer.status}`);
+  console.log(`portal: ${config.portalUrl.replace(/\/\/[^@]*@/, '//')}`);
+}

package/src/commands/upload.js

@@ -45,7 +45,7 @@ export async function upload() {
   const { mods } = await api(config, '/api/mods/my');
   const mod = mods.find((m) => m.slug === manifest.slug);
   if (!mod)
-    throw new Error(`mod "${manifest.slug}" not found on the portal — create it in the web UI first`);
+    throw new Error(`mod "${manifest.slug}" not found on the portal — run \`v8scli create\` first`);
 
   for (let attempt = 0; attempt < 2; attempt++) {
     const archive = await packSources(manifest);
@@ -59,7 +59,7 @@ export async function upload() {
         body: form,
       });
       console.log(`uploaded: ${manifest.slug}@${version.version} status=${version.status}`);
-      console.log('next: submit it for review from the web UI or wait for CLI action support');
+      console.log('next: v8scli submit');
       return;
     } catch (error) {
       const match = String(error?.message ?? '').match(/version_not_incremented: last is (\d+\.\d+\.\d+)/);

package/templates/package.json

@@ -7,7 +7,7 @@
     "upload": "v8scli upload"
   },
   "devDependencies": {
-    "v8_scripting": "^0.2.1",
+    "v8_scripting": "^0.3.0",
     "v8scli": "^0.2.0",
     "typescript": "^5.9.2"
   }