@devkitvault/recall 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) devkitvault
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# @devkitvault/recall
+
+**Install the recall CLI from npm** — on first run, this package downloads the official native binary for your OS from [GitHub Releases](https://github.com/devkitvault/recall/releases) into `~/.local/bin`, then runs it. Later runs reuse the same binary.
+
+recall is a **cloud-synced command vault**: save shell commands, templates, snippets, env sets, and aliases — same account as [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+** (only for this installer wrapper)
+- **Supported platforms** (prebuilt binaries): macOS (Apple Silicon + Intel), Linux x64, Windows x64
+
+Other architectures: use the [curl / PowerShell installers](https://devkitvault.com) or build from source in `packages/cli`.
+
+## Install
+
+```sh
+npm install -g @devkitvault/recall
+```
+
+Ensure `~/.local/bin` is on your `PATH` (the installer places `recall` there). On Windows, that path is `%USERPROFILE%\.local\bin`.
+
+## Use
+
+```sh
+recall --help
+recall auth login
+recall save "docker compose up -d" -n "start stack"
+recall search docker
+```
+
+## Re-download the binary
+
+If a release was updated or your download was corrupted:
+
+```sh
+RECALL_REINSTALL=1 recall --version
+```
+
+## Release tag vs npm version
+
+Downloads use a Git **tag** on `devkitvault/recall` (default: `v` + `version` from this package’s `package.json`). If you ship an npm **patch** without a matching GitHub tag, set either:
+
+- `recall.releaseTag` in `package.json`, or  
+- environment variable `RECALL_RELEASE_TAG` (e.g. `v1.0.0`)
+
+before running `recall`, so the wrapper points at an existing release.
+
+Maintainers: after [Release CLI](https://github.com/devkitvault/recall/blob/master/.github/workflows/release.yml) publishes assets for `vX.Y.Z`, publish this npm package with the same `version` **or** set `recall.releaseTag` accordingly.
+
+## License
+
+MIT © [devkitvault](https://devkitvault.com)

package/bin/recall.js

@@ -0,0 +1,169 @@
+#!/usr/bin/env node
+/**
+ * @devkitvault/recall — thin installer for the native recall CLI.
+ * First run downloads the matching GitHub release binary into ~/.local/bin, then execs it.
+ * @see https://github.com/devkitvault/recall/releases
+ */
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+const os = require('os')
+const https = require('https')
+const http = require('http')
+const { spawnSync } = require('child_process')
+
+const BINARY_MAP = {
+    'darwin-arm64': 'recall-macos-arm64',
+    'darwin-x64': 'recall-macos-x64',
+    'linux-x64': 'recall-linux-x64',
+    'win32-x64': 'recall-windows-x64.exe',
+}
+
+const USER_AGENT = 'devkitvault-recall-npm/1.0 (+https://www.npmjs.com/package/@devkitvault/recall)'
+
+function platformKey() {
+    return `${process.platform}-${process.arch}`
+}
+
+function binaryAssetName() {
+    const key = platformKey()
+    const name = BINARY_MAP[key]
+    if (!name) {
+        console.error(
+            `recall: no prebuilt binary for "${key}".\n` +
+                `Supported: ${Object.keys(BINARY_MAP).join(', ')}\n` +
+                'Install from https://devkitvault.com or build from source (packages/cli).',
+        )
+        process.exit(1)
+    }
+    return name
+}
+
+function readPkg() {
+    return require(path.join(__dirname, '..', 'package.json'))
+}
+
+function releaseTag(pkg) {
+    if (process.env.RECALL_RELEASE_TAG) {
+        const t = process.env.RECALL_RELEASE_TAG.trim()
+        return t.startsWith('v') ? t : `v${t}`
+    }
+    const t = pkg.recall && pkg.recall.releaseTag
+    if (typeof t === 'string' && t.length) return t.startsWith('v') ? t : `v${t}`
+    return `v${pkg.version}`
+}
+
+function binPaths() {
+    const binDir = path.join(os.homedir(), '.local', 'bin')
+    const binName = process.platform === 'win32' ? 'recall.exe' : 'recall'
+    return { binDir, binPath: path.join(binDir, binName) }
+}
+
+function httpGet(url, redirectsLeft) {
+    return new Promise((resolve, reject) => {
+        if (redirectsLeft <= 0) return reject(new Error('Too many redirects'))
+        const lib = url.startsWith('https:') ? https : http
+        const req = lib.get(
+            url,
+            {
+                headers: { 'User-Agent': USER_AGENT },
+            },
+            (res) => {
+                const loc = res.headers.location
+                if (loc && res.statusCode >= 300 && res.statusCode < 400) {
+                    res.resume()
+                    const next = new URL(loc, url).href
+                    return httpGet(next, redirectsLeft - 1).then(resolve).catch(reject)
+                }
+                if (res.statusCode !== 200) {
+                    res.resume()
+                    return reject(new Error(`HTTP ${res.statusCode} GET ${url}`))
+                }
+                resolve(res)
+            },
+        )
+        req.on('error', reject)
+    })
+}
+
+function streamToFile(readable, destPath) {
+    return fs.promises.mkdir(path.dirname(destPath), { recursive: true }).then(() => {
+        const tmp = `${destPath}.${process.pid}.${Date.now()}.part`
+        return new Promise((resolve, reject) => {
+            const w = fs.createWriteStream(tmp, { mode: 0o644 })
+            readable.pipe(w)
+            w.on('finish', () => w.close((err) => (err ? reject(err) : resolve(tmp))))
+            w.on('error', reject)
+            readable.on('error', reject)
+        }).then(async (tmpPath) => {
+            try {
+                await fs.promises.rename(tmpPath, destPath)
+            } catch (e) {
+                try {
+                    await fs.promises.unlink(tmpPath)
+                } catch { /* ignore */ }
+                throw e
+            }
+        })
+    })
+}
+
+async function ensureBinary(binPath, tag, assetName) {
+    const url = `https://github.com/devkitvault/recall/releases/download/${tag}/${assetName}`
+    process.stderr.write(`recall: downloading ${assetName} (${tag}) …\n`)
+    const res = await httpGet(url, 16)
+    await streamToFile(res, binPath)
+    if (process.platform !== 'win32') {
+        await fs.promises.chmod(binPath, 0o755)
+    }
+}
+
+async function main() {
+    const pkg = readPkg()
+    const tag = releaseTag(pkg)
+    const assetName = binaryAssetName()
+    const { binPath } = binPaths()
+
+    const reinstall =
+        process.env.RECALL_REINSTALL === '1' ||
+        process.env.FORCE_RECALL_REINSTALL === '1'
+
+    if (reinstall) {
+        try {
+            await fs.promises.unlink(binPath)
+        } catch { /* missing is fine */ }
+    }
+
+    let exists = false
+    try {
+        const st = await fs.promises.stat(binPath)
+        exists = st.isFile() && st.size > 0
+    } catch {
+        exists = false
+    }
+
+    if (!exists) {
+        try {
+            await ensureBinary(binPath, tag, assetName)
+        } catch (err) {
+            const msg = err instanceof Error ? err.message : String(err)
+            console.error(`recall: install failed: ${msg}`)
+            console.error(`Expected release assets at: https://github.com/devkitvault/recall/releases/tag/${tag}`)
+            console.error('Tip: set RECALL_RELEASE_TAG=vX.Y.Z if your npm version differs from the CLI release tag.')
+            process.exit(1)
+        }
+    }
+
+    const result = spawnSync(binPath, process.argv.slice(2), { stdio: 'inherit' })
+    if (result.error) {
+        console.error(result.error.message || result.error)
+        process.exit(1)
+    }
+    process.exit(result.status === null ? 1 : result.status)
+}
+
+main().catch((e) => {
+    console.error(e instanceof Error ? e.message : e)
+    process.exit(1)
+})

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@devkitvault/recall",
+  "version": "1.0.0",
+  "description": "recall CLI installer — cloud-synced shell command vault (downloads native binary from GitHub releases)",
+  "keywords": [
+    "cli",
+    "shell",
+    "commands",
+    "devtools",
+    "recall",
+    "vault",
+    "sync",
+    "kubernetes",
+    "docker",
+    "terminal",
+    "devkitvault"
+  ],
+  "author": "devkitvault",
+  "license": "MIT",
+  "homepage": "https://recall.devkitvault.com",
+  "bugs": {
+    "url": "https://github.com/devkitvault/recall/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devkitvault/recall.git",
+    "directory": "packages/npm-cli"
+  },
+  "bin": {
+    "recall": "bin/recall.js"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prepublishOnly": "node --check bin/recall.js"
+  },
+  "recall": {
+    "releaseTag": "v1.0.0"
+  }
+}