infraflow 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,38 @@
-# Temporary Holding Version
+# infraflow
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The [InfraFlow](https://infraflow.app) command line.
+
+```sh
+npm install -g infraflow     # or: npx infraflow <command>
+```
+
+No token is needed to install it. What you sign in with depends on what you
+want to do, and the two are independent:
+
+| To… | Sign in with | Command |
+| --- | --- | --- |
+| deploy, read logs, open a shell, change variables | an API token (Settings, then API tokens) | `infraflow auth <token>` |
+| expose services of this machine through tunnels | a machine token (Tunnels, then Add a machine) | `infraflow login <token>` |
+
+```sh
+infraflow auth ifl_…
+infraflow up api                 # send this folder, build it, deploy it
+infraflow link api               # this folder is `api` from now on
+infraflow run -- npm run dev     # run locally with the service's variables
+infraflow logs --follow
+infraflow shell
+```
+
+The program is a single native file. This package fetches the one for your
+system the first time it runs, from `https://infraflow.app/dl/`. Set
+`INFRAFLOW_ORIGIN` to use another InfraFlow platform, and `INFRAFLOW_REFETCH=1`
+to fetch it again.
+
+Without Node.js:
+
+```sh
+curl -fsSL https://infraflow.app/install.sh | sh          # Linux, macOS
+irm https://infraflow.app/install.ps1 | iex               # Windows
+```
+
+Documentation: <https://infraflow.app/docs/cli>

package/bin/infraflow.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+// Runs the InfraFlow program. The program itself is a single native file:
+// it is fetched the first time, for this system, from the platform that
+// publishes it, and kept beside this script.
+//
+// Fetching at first run rather than at install means it also works with
+// package managers that do not run install scripts.
+
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+
+const ORIGIN = (
+  process.env.INFRAFLOW_ORIGIN || "https://infraflow.app"
+).replace(/\/+$/, "");
+
+const SYSTEMS = { darwin: "darwin", linux: "linux", win32: "windows" };
+const PROCESSORS = { x64: "x86_64", arm64: "aarch64" };
+
+function asset() {
+  const system = SYSTEMS[process.platform];
+  const processor = PROCESSORS[process.arch];
+  if (
+    !system ||
+    !processor ||
+    (system === "windows" && processor !== "x86_64")
+  ) {
+    throw new Error(
+      `no InfraFlow build exists for ${process.platform} on ${process.arch}`,
+    );
+  }
+  return `infraflow-${system}-${processor}${system === "windows" ? ".exe" : ""}`;
+}
+
+/** Where the program is kept: beside this script, or the user's cache when
+ * the package's folder cannot be written to (a global install as root). */
+function home(name) {
+  const beside = path.join(__dirname, name);
+  try {
+    fs.accessSync(__dirname, fs.constants.W_OK);
+    return beside;
+  } catch {
+    const cache = path.join(os.homedir(), ".cache", "infraflow");
+    fs.mkdirSync(cache, { recursive: true });
+    return path.join(cache, name);
+  }
+}
+
+async function fetched(name, target) {
+  const url = `${ORIGIN}/dl/${name}`;
+  process.stderr.write(`Fetching ${url}\n`);
+  const response = await fetch(url, { redirect: "follow" });
+  if (!response.ok) {
+    throw new Error(
+      `${url} answered ${response.status}: no build is published for this system`,
+    );
+  }
+  const bytes = Buffer.from(await response.arrayBuffer());
+  // Written aside, then moved: a download cut short is never run.
+  const partial = `${target}.${process.pid}.part`;
+  fs.writeFileSync(partial, bytes, { mode: 0o755 });
+  fs.renameSync(partial, target);
+}
+
+async function main() {
+  const name = asset();
+  const target = home(name);
+  if (!fs.existsSync(target) || process.env.INFRAFLOW_REFETCH) {
+    await fetched(name, target);
+  }
+  const ran = spawnSync(target, process.argv.slice(2), { stdio: "inherit" });
+  if (ran.error) throw ran.error;
+  process.exit(ran.status ?? 1);
+}
+
+main().catch((error) => {
+  process.stderr.write(`infraflow: ${error.message}\n`);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "infraflow",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "The InfraFlow command line: deploy a folder, follow logs, open a shell, expose local services through tunnels.",
+  "license": "MIT",
+  "homepage": "https://infraflow.app/docs/cli",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/plumsydev/infraflow.git",
+    "directory": "packages/cli-npm"
+  },
+  "keywords": [
+    "infraflow",
+    "deploy",
+    "tunnel",
+    "cli"
+  ],
+  "bin": {
+    "infraflow": "bin/infraflow.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}