@backifydev/cli 0.2.0 → 0.2.1

package/README.md

@@ -1,13 +1,18 @@
-# @backifydev/cli
-
-Set up and check a Backify application repository.
-
-```sh
-npx @backifydev/cli init --app app_xxxxx
+# @backifydev/cli
+
+Set up and check a Backify application repository.
+
+```sh
+npx @backifydev/cli init --app app_xxxxx
 npx @backifydev/cli doctor
 npx @backifydev/cli sync
+npx @backifydev/cli login
 ```
 
+`login` opens the Backify portal in your browser. Sign in and select an organization; the portal returns the organization and access token to the CLI through a random, short-lived callback bound to `127.0.0.1`. The CLI stores them in `~/.backify.json`. Set `portalUrl` in that file to use another portal, or `BACKIFY_PORTAL_URL` in the environment. `login <token> [organizationId]` remains available for scripted development.
+
 `init` installs `@backifydev/sdk`, writes `backify.json`, and maintains the Backify blocks in `AGENTS.md`, `CLAUDE.md`, and `.github/copilot-instructions.md`. It preserves other instructions in those files.
 
-See the [agent setup guide](https://docs.backify.dev/setup).
+You can start from an empty folder without a Git repository. `init` creates a minimal private `package.json` before installing the SDK, without choosing a framework. Add the application's framework and development/build scripts afterward. Existing manifests are preserved; in a non-empty application or monorepo, run `init` from the appropriate JavaScript/TypeScript package directory.
+
+See the [agent setup guide](https://docs.backify.dev/setup).

package/dist/index.js

@@ -4,10 +4,13 @@
 import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync2, rmSync } from "node:fs";
 import { homedir } from "node:os";
 import { join as join2 } from "node:path";
+import { randomBytes } from "node:crypto";
+import { createServer } from "node:http";
+import { spawn } from "node:child_process";
 
 // src/setup.ts
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
 import { spawnSync } from "node:child_process";
 
 // ../platform/dist/index.js
@@ -111,9 +114,17 @@ function installSdk(root = process.cwd()) {
   const manager = detectPackageManager(root), args2 = manager === "npm" ? ["install", SDK_PACKAGE] : ["add", SDK_PACKAGE], result = spawnSync(manager, args2, { cwd: root, stdio: "inherit", shell: process.platform === "win32" });
   if (result.status !== 0) throw new Error(`Could not install ${SDK_PACKAGE} with ${manager}`);
 }
+function ensurePackageManifest(root) {
+  const path = join(root, "package.json");
+  if (existsSync(path)) return;
+  const setupFiles = /* @__PURE__ */ new Set([".git", ".gitignore", ".github", "AGENTS.md", "CLAUDE.md", "README.md", "LICENSE", "backify.json"]);
+  if (readdirSync(root).some((file) => !setupFiles.has(file))) throw new Error("package.json is missing. Run backify init from the existing application's JavaScript/TypeScript package directory, or start in an empty folder. See https://docs.backify.dev/setup");
+  const name = basename(resolve(root)).toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "") || "backify-app";
+  writeFileSync(path, JSON.stringify({ name, version: "0.0.0", private: true, type: "module" }, null, 2) + "\n", { flag: "wx" });
+}
 function initialize(appId, root = process.cwd(), install = true) {
   if (!/^app_[A-Za-z0-9_-]+$/.test(appId)) throw new Error("Provide an application ID using --app app_xxxxx");
-  if (!existsSync(join(root, "package.json"))) throw new Error("Run backify init in a JavaScript/TypeScript repository containing package.json");
+  ensurePackageManifest(root);
   if (install) installSdk(root);
   writeConfig(appId, root);
   updateInstructions(root);
@@ -160,6 +171,67 @@ var option = (name) => {
   const index = args.indexOf(name);
   return index >= 0 ? args[index + 1] : void 0;
 };
+function openBrowser(url) {
+  const command2 = process.platform === "win32" ? "cmd" : process.platform === "darwin" ? "open" : "xdg-open", args2 = process.platform === "win32" ? ["/c", "start", "", '"' + url + '"'] : [url];
+  const child = spawn(command2, args2, { stdio: "ignore", detached: true, shell: process.platform === "win32" });
+  child.unref();
+}
+async function browserLogin() {
+  const state = randomBytes(24).toString("base64url"), server = createServer((req, res) => {
+    if (req.method === "OPTIONS") {
+      res.writeHead(204, { "access-control-allow-origin": "*", "access-control-allow-methods": "POST, OPTIONS", "access-control-allow-headers": "content-type" });
+      return res.end();
+    }
+    if (req.method !== "POST" || req.url !== "/callback") {
+      res.writeHead(404);
+      return res.end();
+    }
+    let raw = "";
+    req.setEncoding("utf8");
+    req.on("data", (part) => raw += part);
+    req.on("end", () => {
+      try {
+        const value = JSON.parse(raw);
+        if (value.state !== state || typeof value.token !== "string" || typeof value.organizationId !== "string") throw new Error("Invalid callback");
+        res.writeHead(200, { "access-control-allow-origin": "*", "content-type": "text/plain" });
+        res.end("Backify CLI connected. You can close this tab.");
+        userConfig.token = value.token;
+        userConfig.organizationId = value.organizationId;
+        writeFileSync2(configPath, JSON.stringify(userConfig, null, 2));
+        server.close();
+        resolveLogin();
+      } catch {
+        res.writeHead(400, { "access-control-allow-origin": "*" });
+        res.end("Invalid or expired Backify CLI login.");
+      }
+    });
+  });
+  let resolveLogin = () => {
+  };
+  const completed = new Promise((resolve2) => resolveLogin = resolve2);
+  server.listen(0, "127.0.0.1", () => {
+    const address = server.address();
+    if (!address || typeof address === "string") throw new Error("Could not start local login callback");
+    const callback = `http://127.0.0.1:${address.port}/callback`;
+    const portal = new URL(process.env.BACKIFY_PORTAL_URL ?? userConfig.portalUrl ?? "https://backify.dev");
+    portal.searchParams.set("cli_callback", callback);
+    portal.searchParams.set("cli_state", state);
+    console.log(`Opening ${portal.origin} to sign in to Backify\u2026`);
+    openBrowser(portal.toString());
+  });
+  const timeout = setTimeout(() => {
+    server.close();
+    rejectLogin(new Error("Backify login timed out. Run backify login to try again."));
+  }, 5 * 6e4);
+  let rejectLogin = () => {
+  };
+  const failed = new Promise((_, reject) => rejectLogin = reject);
+  try {
+    await Promise.race([completed, failed]);
+  } finally {
+    clearTimeout(timeout);
+  }
+}
 async function main() {
   switch (command) {
     case "init":
@@ -186,10 +258,16 @@ async function main() {
       break;
     }
     case "login":
-      userConfig.token = args[0] ?? "development";
-      userConfig.organizationId = args[1] ?? userConfig.organizationId;
-      writeFileSync2(configPath, JSON.stringify(userConfig, null, 2));
-      console.log("Logged in to Backify");
+      if (args[0]) {
+        userConfig.token = args[0];
+        userConfig.organizationId = args[1] ?? userConfig.organizationId;
+        writeFileSync2(configPath, JSON.stringify(userConfig, null, 2));
+        console.log("Logged in to Backify");
+      } else {
+        await browserLogin();
+        console.log("Logged in to Backify");
+      }
+      ;
       break;
     case "logout":
       rmSync(configPath, { force: true });

package/package.json

@@ -1,29 +1,29 @@
-{
-  "name": "@backifydev/cli",
-  "version": "0.2.0",
-  "description": "Command-line setup and diagnostics for Backify applications",
-  "type": "module",
-  "bin": { "backify": "./dist/index.js" },
-  "files": ["dist/index.js", "README.md"],
-  "scripts": {
-    "prebuild": "npm run build --workspace @backify/platform",
-    "build": "esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js",
-    "prepack": "npm run build",
-    "pretypecheck": "npm run build --workspace @backify/platform",
-    "typecheck": "tsc --noEmit",
-    "pretest": "npm run build --workspace @backify/platform",
-    "test": "vitest run"
-  },
-  "publishConfig": { "access": "public" },
-  "repository": { "type": "git", "url": "git+https://github.com/frejnorling/backify.git", "directory": "packages/cli" },
-  "homepage": "https://docs.backify.dev/setup",
-  "license": "MIT",
-  "engines": { "node": ">=20" },
-  "devDependencies": {
-    "@backify/platform": "*",
-    "@types/node": "^24.3.1",
-    "esbuild": "^0.25.10",
-    "typescript": "^5.9.2",
-    "vitest": "^3.2.4"
-  }
-}
+{
+  "name": "@backifydev/cli",
+  "version": "0.2.1",
+  "description": "Command-line setup and diagnostics for Backify applications",
+  "type": "module",
+  "bin": { "backify": "dist/index.js" },
+  "files": ["dist/index.js", "README.md"],
+  "scripts": {
+    "prebuild": "npm run build --workspace @backify/platform",
+    "build": "esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js",
+    "prepack": "npm run build",
+    "pretypecheck": "npm run build --workspace @backify/platform",
+    "typecheck": "tsc --noEmit",
+    "pretest": "npm run build --workspace @backify/platform",
+    "test": "vitest run"
+  },
+  "publishConfig": { "access": "public" },
+  "repository": { "type": "git", "url": "git+https://github.com/frejnorling/backify.git", "directory": "packages/cli" },
+  "homepage": "https://docs.backify.dev/setup",
+  "license": "MIT",
+  "engines": { "node": ">=20" },
+  "devDependencies": {
+    "@backify/platform": "*",
+    "@types/node": "^24.3.1",
+    "esbuild": "^0.25.10",
+    "typescript": "^5.9.2",
+    "vitest": "^4.1.11"
+  }
+}