storymaps 1.4.2 → 1.4.3

package/README.md

@@ -455,7 +455,7 @@ npm test
 
 `npm test` runs the unit tests in `test/unit` with Node's built-in test runner (Node 22 or later). They cover the YAML format, the API client, the change summary, and how a target resolves to a map, with no server needed. CI runs them on Node 22 and 24 for every push to `main` and every pull request.
 
-To try a change against a local storymaps.io server, run the CLI from the repo, for example `node bin/storymaps.js pull localhost/<map-id>`.
+To try a change against a local storymaps.io server, run the CLI from the repo, for example `node bin/storymaps.js pull localhost:3000/<map-id>`.
 
 ### Releasing
 

package/bin/storymaps.js

@@ -36,7 +36,7 @@ const DIR_HELP = 'the project folder (default: storymaps)';
 program
     .command('init')
     .description('Create a new storymap.yml in the current directory')
-    .option('-s, --site <site>', 'target site (e.g. localhost, storymaps.io)')
+    .option('-s, --site <site>', 'target site (e.g. storymaps.io, localhost:3000 or http://192.168.0.20:8080)')
     .action(initCommand);
 
 program
@@ -158,7 +158,7 @@ project
     .argument('[files...]', 'map files to start the project from; they are left as they are')
     .option('--name <name>', 'the project name (default: Untitled project)')
     .option('--dir <folder>', DIR_HELP)
-    .option('-s, --site <site>', 'target site (e.g. localhost, storymaps.io)')
+    .option('-s, --site <site>', 'target site (e.g. storymaps.io, localhost:3000 or http://192.168.0.20:8080)')
     .action(projectInitCommand);
 
 project

package/lib/util/identity.js

@@ -8,9 +8,12 @@ const DEFAULT_SITE = 'storymaps.io';
 
 function siteToBaseUrl(site) {
     if (!site) return `https://${DEFAULT_SITE}`;
-    if (site === 'localhost') return 'http://localhost:3000';
-    // A local server on another port says so, such as localhost:3312
-    if (/^(localhost|127\.0\.0\.1)(:\d+)?$/.test(site)) return `http://${site}`;
+    // Written out in full, such as http://localhost:80, it's used as it is
+    if (/^https?:\/\//i.test(site)) return new URL(site).origin;
+    // A server on this computer always names its port, such as localhost:3000, so no port is
+    // ever assumed
+    if (/^(localhost|127\.0\.0\.1)$/.test(site)) throw new Error(`The site ${site} needs its port, such as ${site}:3000.`);
+    if (/^(localhost|127\.0\.0\.1):\d+$/.test(site)) return `http://${site}`;
     return `https://${site}`;
 }
 
@@ -25,7 +28,8 @@ function parseLink(arg) {
     }
     if (arg.includes('/') && !/\.(ya?ml|json)$/i.test(arg)) {
         const url = new URL(`https://${arg}`);
-        return { url, baseUrl: siteToBaseUrl(url.hostname) };
+        // The host keeps its port, such as localhost:3312/abc12345
+        return { url, baseUrl: siteToBaseUrl(url.host) };
     }
     return null;
 }

package/lib/util/project.js

@@ -127,10 +127,17 @@ export function setSiteKey(content, site) {
     return `site: ${site}\n${content}`;
 }
 
-// The site a server's address stands for in a map file, such as storymaps.io or localhost:3312
+// The site a server's address stands for in a map file. The short form, such as storymaps.io or
+// localhost:3000, is used only where it reads back as the same address: https for a server on the
+// web, http with its port for one on this computer. Anything else is written out in full, such as
+// http://localhost:80 or https://localhost:8443, so no protocol or port is ever guessed.
 export const siteOfBaseUrl = (baseUrl) => {
     const url = new URL(baseUrl);
-    return url.host === 'localhost:3000' ? 'localhost' : url.host;
+    const local = /^(localhost|127\.0\.0\.1)$/.test(url.hostname);
+    const port = url.port || (url.protocol === 'https:' ? '443' : '80');
+    if (!local && url.protocol === 'https:') return url.host;
+    if (local && url.protocol === 'http:' && url.port) return url.host;
+    return `${url.protocol}//${url.hostname}:${port}`;
 };
 
 // Sets locked: true or false in a map file after the CLI locks or unlocks its map, so the file

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "storymaps",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "CLI tool for storymaps.io - import, export, validate, and manage user story maps from the terminal",
   "type": "module",
   "bin": {