@opengsd/gsd-cloud 1.7.0

package/README.md

@@ -0,0 +1,34 @@
+# @opengsd/gsd-cloud
+
+Connect a local GSD runtime to [GSD Cloud](https://cloud.opengsd.net) so you can
+monitor and control your GSD projects from any browser.
+
+This is a thin wrapper over `@opengsd/daemon`'s cloud runtime commands. Its only
+added behavior is defaulting the gateway to `https://cloud.opengsd.net` for the
+`login` and `pair` commands, so you never have to type `--gateway`. All
+device-flow, pairing, and connection logic is provided by the daemon.
+
+## Usage
+
+```bash
+# Browser-based pairing against GSD Cloud (recommended). Opens an approval URL,
+# polls for authorization, then auto-connects. No --gateway needed.
+npx @opengsd/gsd-cloud login
+
+# Show current cloud runtime configuration and connection status.
+npx @opengsd/gsd-cloud status
+
+# Start the daemon using a previously paired device token.
+npx @opengsd/gsd-cloud connect
+
+# Remove cloud runtime configuration from the local config file.
+npx @opengsd/gsd-cloud disconnect
+```
+
+`login` (and `pair`) default to `https://cloud.opengsd.net`. To target a
+different gateway, pass `--gateway <url>` explicitly — the explicit flag always
+wins. The `status`, `connect`, and `disconnect` commands do not use a gateway.
+
+## Requirements
+
+- Node.js >= 22

package/bin/gsd-cloud.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+// Project/App: Open GSD
+// File Purpose: gsd-cloud CLI entry — inject the default gateway then delegate to the daemon.
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const binDir = dirname(fileURLToPath(import.meta.url));
+const target = join(binDir, '..', 'dist', 'inject-gateway.js');
+
+if (!existsSync(target)) {
+  process.stderr.write('gsd-cloud: build output missing. Run `pnpm --filter @opengsd/gsd-cloud run build`.\n');
+  process.exit(1);
+}
+
+const { injectDefaultGateway } = await import('../dist/inject-gateway.js');
+const { handleCloudRuntimeCommand } = await import('@opengsd/daemon');
+
+const argv = injectDefaultGateway(process.argv.slice(2));
+
+try {
+  await handleCloudRuntimeCommand(argv, { binaryName: 'gsd-cloud' });
+} catch (err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  process.stderr.write(`gsd-cloud: fatal: ${msg}\n`);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@opengsd/gsd-cloud",
+  "version": "1.7.0",
+  "description": "Thin CLI wrapper that connects a local GSD runtime to GSD Cloud (cloud.opengsd.net)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/open-gsd/gsd-pi.git",
+    "directory": "packages/gsd-cloud"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "gsd-cloud": "./bin/gsd-cloud.js"
+  },
+  "scripts": {
+    "build": "node ../../scripts/clean-package-dist.cjs && tsc",
+    "test": "pnpm run build && node --test dist/inject-gateway.test.js"
+  },
+  "dependencies": {
+    "@opengsd/daemon": "^1.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.12.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "files": [
+    "README.md",
+    "bin",
+    "dist",
+    "!dist/**/*.test.*"
+  ]
+}