dewctl 0.5.0 → 0.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dewctl",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Build and publish three.js games on Dewdrop.",
   "license": "MIT",
   "type": "module",

package/src/client.js

@@ -47,6 +47,7 @@ export class Client {
   async api(path,options={}){return this.request(path,{...options,token:this.session().token});}
   game(game,signal){return this.api(`/v1/games/${game}`,{signal});}
   releases(game){return this.api(`/v1/games/${game}/releases`);}
+  deleteRelease(game,release){return this.api(`/v1/games/${game}/releases/${release}`,{method:'DELETE'});}
   // Makes the game this developer's if it is new, and confirms it is theirs if not: asked before anything is built, so
   // a name someone else has, or a sign-in that has ended, is known at once.
   async claim(game,signal) {

package/src/main.js

@@ -18,22 +18,25 @@ const HELP=`${RUN} — make three.js games on Dewdrop
   login                                    Sign in: prints a link to open in your browser and approve
   logout                                   Sign this computer out
   dev [--watch] [--release ID]             Build, upload and play the dev version; --watch repeats this on every
-                                           save, --release plays an earlier upload without building
-  stop                                     Stop the dev version and disconnect its players; uploads are kept
+                                           save, --release plays a kept upload without building
+  stop                                     Stop the dev version and disconnect its players
   publish [--release ID]                   Publish the dev version, or an earlier upload, for players; uploads
                                            the thumbnail dewdrop.json names when it has changed
   unpublish                                Take the game down for players
   share EMAIL                              Let another developer play and update the dev version
   unshare EMAIL                            Take that back
   status                                   Show the dev and published versions and where to play them
-  releases                                 List your uploads; any id, or its first 8 characters, feeds --release
+  releases                                 List the uploads Dewdrop keeps: every published version, the dev version
+                                           and each member's latest upload; any id, or its first 8 characters,
+                                           feeds --release and delete
+  delete ID                                Delete a published version nothing runs, freeing its space (owner only)
   --version                                Show this CLI's version
 
   Run the commands in your game's folder: they read the game from its dewdrop.json.
   Docs: ${DEWDROP}/docs
 `;
-// Each command's flags; share and unshare also take one address. Anything else on the line is refused.
-const COMMANDS={init:['--game'],login:[],logout:[],dev:['--watch','--release'],stop:[],publish:['--release'],unpublish:[],share:[],unshare:[],status:[],releases:[]};
+// Each command's flags; share and unshare also take one address, and delete one release. Anything else on the line is refused.
+const COMMANDS={init:['--game'],login:[],logout:[],dev:['--watch','--release'],stop:[],publish:['--release'],unpublish:[],share:[],unshare:[],status:[],releases:[],delete:[]};
 const VALUED=['--game','--release'];
 function options(command,args) {
   const out={};
@@ -44,9 +47,10 @@ function options(command,args) {
       else if(!args[i+1]||args[i+1].startsWith('--'))throw new Error(`${key} needs a value.`);
       else out[key.slice(2)]=args[++i];
     } else if(['share','unshare'].includes(command)&&!key.startsWith('-')&&out.email===undefined)out.email=key;
+    else if(command==='delete'&&!key.startsWith('-')&&out.release===undefined)out.release=key;
     else throw new Error(`${command} doesn't take ${key}. Run ${RUN} --help to see what it takes.`);
   }
-  if(out.release!==undefined&&!/^[a-f0-9]{8,64}$/.test(out.release))throw new Error(`--release takes a release id, or its first 8 or more characters, from ${RUN} releases.`);
+  if(out.release!==undefined&&!/^[a-f0-9]{8,64}$/.test(out.release))throw new Error(`${command==='delete'?'delete':'--release'} takes a release id, or its first 8 or more characters, from ${RUN} releases.`);
   if(out.watch&&out.release)throw new Error('Choose --watch or --release, not both.');
   return out;
 }
@@ -135,11 +139,19 @@ async function main() {
     return;
   }
   if(command==='releases'){
-    const {releases}=await client.releases(game);
+    const [{releases},state]=await Promise.all([client.releases(game),client.game(game)]);
     if(!releases.length){console.log(`No uploads of ${game} yet. Run ${RUN} dev to make one.`);return;}
-    console.log(columns([['RELEASE','UPLOADED (UTC)','SIZE','BY'],...releases.map(release=>[release.sha256.slice(0,12),new Date(release.created).toISOString().slice(0,16).replace('T',' '),size(release.bytes),release.email])]));
+    // What each release is to the game, the reason Dewdrop keeps it.
+    const status=release=>[release.sha256===state.dev.release&&'dev',release.sha256===state.live.release&&'published'].filter(Boolean).join(', ')||(release.published?'published before':'latest upload');
+    console.log(columns([['RELEASE','UPLOADED (UTC)','SIZE','STATUS','BY'],...releases.map(release=>[release.sha256.slice(0,12),new Date(release.created).toISOString().slice(0,16).replace('T',' '),size(release.bytes),status(release),release.email])]));
     return;
   }
+  if(command==='delete'){
+    if(!flags.release)throw new Error(`delete needs a release id from ${RUN} releases.`);
+    const release=await releaseId(client,game,flags.release);
+    await client.deleteRelease(game,release);
+    console.log(`Deleted ${release.slice(0,12)} from ${game}.`);return;
+  }
   if(['share','unshare'].includes(command)) {
     if(!flags.email)throw new Error(`${command} needs the developer's email address.`);
     await client.member(game,flags.email,command==='share');
@@ -148,13 +160,13 @@ async function main() {
   }
   if(command==='stop'){
     await client.stop(game,signal);
-    console.log(`Stopped ${game}'s dev version. Its uploads are kept; run ${RUN} dev to start it again.`);return;
+    console.log(`Stopped ${game}'s dev version. Run ${RUN} dev to start it again.`);return;
   }
   if(command==='unpublish'){await client.publish(game,null,signal);console.log(`Unpublished ${game}. Players can no longer open it.`);return;}
   if(command==='publish') {
     const current=await client.game(game,signal);
     const release=flags.release?await releaseId(client,game,flags.release):current.dev.release;
-    if(!release)throw new Error(`${game} has no dev version to publish. Run ${RUN} dev first, or publish an earlier upload with --release (see ${RUN} releases).`);
+    if(!release)throw new Error(`${game} has no dev version to publish. Run ${RUN} dev first, or publish a kept upload with --release (see ${RUN} releases).`);
     // The thumbnail goes first, so an image Dewdrop refuses stops the publish before anything changes for players.
     if(project.thumbnail&&await syncThumbnail(project,client,current,signal))console.log(`Uploaded the thumbnail, ${project.thumbnail}.`);
     const state=await client.publish(game,release,signal);

package/src/project.js

@@ -158,7 +158,7 @@ export async function build(project, signal) {
 // dewdrop.json alone, so nothing of it is touched and no starter is left half written.
 const STARTER_FILES=['package.json','src','index.html','vite.config.js'];
 // The SDK a new game depends on, and this CLI, at its own version.
-const SDK_RANGE='^0.3.1';
+const SDK_RANGE='^0.4.0';
 const CLI_RANGE=`^${JSON.parse(readFileSync(new URL('../package.json',import.meta.url),'utf8')).version}`;
 // A game name from the project directory, or a random one when the directory name yields nothing usable.
 function gameNameFrom(root) {