@devkitvault/recall 1.0.2 → 1.0.4

package/README.md

@@ -1,10 +1,12 @@
 # @devkitvault/recall
 
-Global **recall** CLI for **Node.js 18+**. Same vault as [recall.devkitvault.com](https://recall.devkitvault.com) and the [VS Code extension](https://marketplace.visualstudio.com/items?itemName=devkitvault.recall-cmd).
+**recall** is a cloud-synced CLI command vault — save terminal commands once, search and run them from any machine.
+
+Works with [recall.devkitvault.com](https://recall.devkitvault.com) and the [VS Code extension](https://marketplace.visualstudio.com/items?itemName=devkitvault.recall-cmd).
 
 ## Requirements
 
-- **Node.js 18+**
+- [Node.js](https://nodejs.org/) **18 or newer**
 
 ## Install
 
@@ -12,30 +14,68 @@ Global **recall** CLI for **Node.js 18+**. Same vault as [recall.devkitvault.com
 npm install -g @devkitvault/recall
 ```
 
-## Use
+Verify the install:
+
+```sh
+recall --version
+recall doctor
+```
+
+## Quick start
 
 ```sh
-recall --help
 recall auth login
-recall save "docker compose up -d" -n "start stack"
+recall save "docker compose up -d" --name start-stack --tags docker
 recall search docker
+recall list
+recall run start-stack
 ```
 
-## Native binary (no Node)
+Run `recall --help` for the full command list.
+
+## Authentication
+
+After `recall auth login`, your session is stored locally so you stay signed in between runs.
+
+```sh
+recall auth login      # sign in (browser or email/password)
+recall auth logout     # sign out on this machine
+recall auth whoami     # show the signed-in account
+```
 
-[Install from devkitvault.com](https://devkitvault.com) — standalone executable for Windows, macOS, and Linux.
+## Prefer a standalone binary?
 
-## Publishing (maintainers)
+If you do not want Node.js, use the native installer instead — same commands, no runtime required:
 
-From the **monorepo root**, with `pnpm` installed:
+- **macOS / Linux:** `curl -fsSL https://devkitvault.com/recall/install.sh | sh`
+- **Windows:** `irm https://devkitvault.com/recall/install.ps1 | iex`
 
-```powershell
-cd packages/npm-cli
-npm publish
+See [devkitvault.com/recall](https://devkitvault.com/recall) for downloads and docs.
+
+## Update
+
+```sh
+npm update -g @devkitvault/recall
 ```
 
-`prepublishOnly` runs **`pnpm --filter @recall/cli run build`** and copies **`packages/cli/dist`** into **`packages/npm-cli/dist`**. Ensure the CLI compiles before publishing.
+## Troubleshooting
+
+```sh
+recall doctor          # check install, auth, and API connectivity
+recall auth whoami     # confirm you are signed in
+```
+
+If something still fails, open an issue on [GitHub](https://github.com/devkitvault/recall/issues) or visit [recall.devkitvault.com](https://recall.devkitvault.com).
+
+## Links
+
+| | |
+| --- | --- |
+| Website | [devkitvault.com/recall](https://devkitvault.com/recall) |
+| Dashboard | [recall.devkitvault.com](https://recall.devkitvault.com) |
+| VS Code | [Marketplace](https://marketplace.visualstudio.com/items?itemName=devkitvault.recall-cmd) |
+| Issues | [github.com/devkitvault/recall](https://github.com/devkitvault/recall/issues) |
 
 ## License
 
-MIT © [devkitvault](https://devkitvault.com)
+MIT — see [LICENSE](./LICENSE). © [devkitvault](https://devkitvault.com)

package/dist/commands/auth/login.js

@@ -83,10 +83,14 @@ async function loginWithBrowser() {
     const open = (await Promise.resolve().then(() => __importStar(require('open')))).default;
     const state = crypto.randomBytes(16).toString('hex');
     const spinner = (0, ora_1.default)('Opening browser...').start();
+    const closeHeaders = { Connection: 'close' };
     const { token, username } = await new Promise((resolve, reject) => {
+        let settled = false;
+        const timeoutMs = 5 * 60 * 1000;
         const server = http.createServer((req, res) => {
             const url = new URL(req.url, 'http://localhost:9876');
             if (url.pathname !== '/callback') {
+                res.writeHead(404, closeHeaders);
                 res.end();
                 return;
             }
@@ -94,13 +98,23 @@ async function loginWithBrowser() {
             const returnedToken = url.searchParams.get('token');
             const returnedUser = url.searchParams.get('username') ?? '';
             if (returnedState !== state || !returnedToken) {
-                res.writeHead(400);
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(timeoutId);
+                }
+                res.writeHead(400, closeHeaders);
                 res.end('Invalid callback.');
-                reject(new Error('Invalid state'));
+                const srv = server;
+                srv.closeAllConnections?.();
+                server.close(() => reject(new Error('Invalid state')));
                 return;
             }
-            // Return simple response — browser already shows success UI
-            res.writeHead(200, { 'Content-Type': 'text/html' });
+            if (!settled) {
+                settled = true;
+                clearTimeout(timeoutId);
+            }
+            // Loopback callback: tell the browser to close the socket so server.close() can finish promptly.
+            res.writeHead(200, { 'Content-Type': 'text/html', ...closeHeaders });
             res.end(`<!DOCTYPE html>
 <html>
   <head><meta charset="utf-8"></head>
@@ -109,18 +123,23 @@ async function loginWithBrowser() {
     <p style="color:#6b7e94;font-family:monospace;">You can close this tab and return to your terminal.</p>
   </body>
 </html>`);
-            server.close();
-            resolve({ token: returnedToken, username: returnedUser });
+            const srv = server;
+            srv.closeAllConnections?.();
+            server.close(() => resolve({ token: returnedToken, username: returnedUser }));
         });
+        const timeoutId = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            const to = server;
+            to.closeAllConnections?.();
+            server.close(() => reject(new Error('Timed out after 5 minutes')));
+        }, timeoutMs);
         server.listen(9876, () => {
             const authUrl = `https://recall.devkitvault.com/cli-login?state=${state}&redirect=http://localhost:9876/callback`;
             open(authUrl);
             spinner.text = 'Waiting for browser authentication...';
         });
-        setTimeout(() => {
-            server.close();
-            reject(new Error('Timed out after 5 minutes'));
-        }, 5 * 60 * 1000);
     });
     await (0, auth_1.setToken)(token);
     (0, config_1.saveConfig)({ username });
@@ -138,7 +157,7 @@ exports.loginCommand = new commander_1.Command('login')
             message: 'How would you like to log in?',
             choices: [
                 { name: 'Login with credentials  (username + password)', value: 'credentials' },
-                { name: 'Login with browser       (opens devkitvault.com)', value: 'browser' },
+                { name: 'Login with browser       (opens recall.devkitvault.com, then localhost)', value: 'browser' },
             ],
         },
     ]);

package/dist/lib/config.js

@@ -11,7 +11,7 @@ const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const CONFIG_DIR = path_1.default.join(os_1.default.homedir(), '.recall');
 const CONFIG_FILE = path_1.default.join(CONFIG_DIR, 'config.json');
-exports.APP_VERSION = "1.0.0";
+exports.APP_VERSION = "1.0.1";
 exports.ENVIRONMENTS = {
     production: 'https://api.devkitvault.com',
     local: 'http://127.0.0.1:3001',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devkitvault/recall",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "recall CLI — cloud-synced command vault (JavaScript build for npm; no bundled native binary)",
   "keywords": [
     "cli",
@@ -41,7 +41,9 @@
     "access": "public"
   },
   "scripts": {
-    "prepublishOnly": "node scripts/prepublish.cjs && node --check dist/index.js"
+    "prepublishOnly": "node scripts/prepublish.cjs && node --check dist/index.js",
+    "check:registry": "npm view @devkitvault/recall version",
+    "try:published": "npx --yes --package=@devkitvault/recall@latest recall --version"
   },
   "dependencies": {
     "chalk": "^4.1.2",