arcadible 1.0.0 → 1.0.2

package/bin/arc-deploy.js

@@ -19,6 +19,7 @@ const cfgpackage = require("../src/config/package");
 const cfgproduct = require("../src/config/product");
 const deploy = require("../src/cli/deploy");
 const error = require("../src/util/error");
+const links = require("../src/util/links");
 const log = require("../src/util/log");
 const output = require("../src/util/output");
 const pack = require("../src/cli/pack");
@@ -250,6 +251,9 @@ const start = function (argv) {
   // the game's account, when Arcadible could say: a git deploy's owner waits
   // among their own releases.
   let owner = null;
+  // whether the handle rules held the handle back from this release, so the
+  // game's links are by id.
+  let held = false;
   // the project, parsed once and given to each step. A build can write files
   // the manifest reads, such as art, so it's parsed again after one runs.
   let parsed = null;
@@ -309,6 +313,7 @@ const start = function (argv) {
     .then(([current, predeployed]) => {
       sw.stop(true);
       owner = predeployed.owner ?? null;
+      held = predeployed.held ?? false;
       sw = new SpinnerWheel("Building... %s");
       sw.start(git || json || quiet);
       return Promise.all([
@@ -378,7 +383,12 @@ const start = function (argv) {
         pb.stop();
       }
       // the game and release are for waiting, not printing.
-      const shown = { ...deployed };
+      const shown = {
+        ...deployed,
+        ...(held
+          ? links.published({ id: deployed.game, version: deployed.version.to })
+          : {}),
+      };
       delete shown.game;
       delete shown.release;
       const result = { ...(git ? shown : { built, ...shown }), warnings };

package/package.json

@@ -65,5 +65,5 @@
   "scripts": {
     "test": "node --test \"test/**/*.test.js\""
   },
-  "version": "1.0.0"
+  "version": "1.0.2"
 }

package/src/action/predeploy/ac.js

@@ -5,6 +5,7 @@
 const api = require("../../api");
 const cfgcode = require("../../config/code");
 const error = require("../../util/error");
+const links = require("../../util/links");
 const phrase = require("../../phrase");
 const published = require("./published");
 
@@ -38,30 +39,58 @@ const ensureOwned = function (current, id) {
 
 // [function]
 
-// fails when the handle is another game's, whoever owns it. A game without a
-// handle has none to check.
-const ensureHandle = function ({ handle, id }) {
+// fails when the handle is taken: another game's, held for another account,
+// or reserved. When the handle rules keep it from this release (the limit on
+// unreleased games' handles, or one that lapsed from this account), it warns
+// and deploys anyway, as the game keeps the handle it has, or none, and
+// resolves with true. A game without a handle has none to check.
+const ensureHandle = function (current, { handle, id, version }, handler) {
   if ((handle ?? null) === null) {
     return Promise.resolve(null);
   }
-  return api.discoverGame(handle).then((game) => {
-    if (game.id !== id) {
-      throw new ArcError(
-        cfgcode.GAME_HANDLE_TAKEN,
-        phrase.gameHandleTaken(handle),
-      );
+  const warn = (code, message) => {
+    if (handler?.onWarning) {
+      handler.onWarning({ code, message });
     }
-  }, ignoreMissing);
+  };
+  return api
+    .gameHandle(
+      id,
+      handle,
+      { channel: links.channel(version) },
+      api.auth(current?.session?.access_token),
+    )
+    .then(({ status }) => {
+      if (status === "taken") {
+        throw new ArcError(
+          cfgcode.GAME_HANDLE_TAKEN,
+          phrase.gameHandleTaken(handle),
+        );
+      }
+      if (status === "limit") {
+        warn(cfgcode.WARNING.GAME_HANDLE_LIMIT, phrase.gameHandleLimit(handle));
+        return true;
+      }
+      if (status === "lapsed") {
+        warn(
+          cfgcode.WARNING.GAME_HANDLE_LAPSED,
+          phrase.gameHandleLapsed(handle),
+        );
+        return true;
+      }
+      return false;
+    }, ignoreMissing);
 };
 
 // [function]
 
-// resolves with the game once its id, and its handle if it has one, are
-// free or already its own.
-const ensureId = function (current, game) {
+// resolves with the game once its id is free or already its own, and its
+// handle, if it has one, isn't taken; `held` when the rules hold the handle
+// back from this release, so its links are by id.
+const ensureId = function (current, game, handler) {
   return ensureOwned(current, game.id)
-    .then(() => ensureHandle(game))
-    .then(() => game);
+    .then(() => ensureHandle(current, game, handler))
+    .then((held) => ({ ...game, held: Boolean(held) }));
 };
 
 // [function]

package/src/action/predeploy/tool.js

@@ -12,14 +12,14 @@ const ensureUnpublished = ac.ensureUnpublished;
 
 // [function]
 
-const main = function (current, conf, { onPredeployBegin }) {
+const main = function (current, conf, { onPredeployBegin, ...handler }) {
   if (onPredeployBegin) {
     onPredeployBegin({ root: conf.root });
   }
   return given(conf)
-    .then(({ game }) => ensureId(current, game))
+    .then(({ game }) => ensureId(current, game, handler))
     .then((game) => ensureUnpublished(current, game))
-    .then((game) => ({ to: game.version }));
+    .then((game) => ({ held: game.held, to: game.version }));
 };
 
 // [export]

package/src/api.js

@@ -109,6 +109,17 @@ const gameBuild = function (id, version, params, headers) {
 
 // [function]
 
+// whether the caller's game could take a handle on a deploy to `channel`:
+// its status is available, taken, limit, or lapsed.
+const gameHandle = function (id, handle, params, headers) {
+  return request.get(
+    endpoint(`/games/${id}/handles/${handle}`, params),
+    headers,
+  );
+};
+
+// [function]
+
 const release = function (id, params, headers) {
   return request.get(endpoint(`/releases/${id}`, params), headers);
 };
@@ -131,6 +142,7 @@ module.exports = {
   discoverGameRepo,
   flow,
   gameBuild,
+  gameHandle,
   postAuthRefresh,
   postFlow,
   postUpload,

package/src/config/code.js

@@ -104,6 +104,8 @@ const ISSUE = {
 const WARNING = {
   DEPLOY_DIR_NOT_BUILT: "deploy_dir_not_built",
   FIELD_UNKNOWN: "field_unknown",
+  GAME_HANDLE_LAPSED: "game_handle_lapsed",
+  GAME_HANDLE_LIMIT: "game_handle_limit",
   VERSION_UNCHECKED: "version_unchecked",
 };
 // every error code, for checking one exists.

package/src/phrase.js

@@ -207,6 +207,18 @@ const gameHandleTaken = function (handle) {
 
 // [function]
 
+const gameHandleLapsed = function (handle) {
+  return `Handle ${handle} lapsed: it comes back with a production release, so deploying without it.`;
+};
+
+// [function]
+
+const gameHandleLimit = function (handle) {
+  return `Handle ${handle} not applied: your unreleased games already hold 5 handles, so deploying without it.`;
+};
+
+// [function]
+
 const gameNotDeployed = function (game) {
   return blocks(`${game} isn't on ${TITLE} yet.`, [
     `Deploy it once with ${cmdDeploy()}.`,
@@ -1020,6 +1032,8 @@ module.exports = {
   docMediaType,
   docTagUnallowed,
   errorCode,
+  gameHandleLapsed,
+  gameHandleLimit,
   gameHandleTaken,
   gameIdMissing,
   gameNotDeployed,

package/src/serve/page.js

@@ -57,7 +57,7 @@ const html = function (game) {
 <html lang="en">
   <head>
     <meta charset="utf-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no, viewport-fit=cover">
+    <meta name="viewport" content="width=device-width,initial-scale=1,maximum-scale=1,user-scalable=no,viewport-fit=cover">
     <title>${escapeHtml(game.title)}</title>
     <style>html,body{margin:0;height:100%;overflow:hidden;background:#000}iframe{display:block;width:100%;height:100%;border:0;visibility:hidden}</style>
   </head>