@helipod/cli 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,42 @@
+# @helipod/cli
+
+The `helipod` command-line tool: run, deploy, and build Helipod apps — a local dev server with hot reload, a production server, push-based live deploys, single-binary compiles, data import/export, and typed codegen.
+
+Most users should install the umbrella package [`helipod`](https://www.npmjs.com/package/helipod) instead — it bundles this CLI (the `helipod` bin ships inside it) along with the server function helpers, the client SDK, and the React hooks.
+
+```sh
+bun add helipod   # or: npm install helipod
+```
+
+## Usage
+
+```sh
+# local development: watch helipod/, hot-reload functions, serve the sync
+# WebSocket + HTTP API + dashboard on one port
+bunx helipod dev
+
+# production: requires HELIPOD_ADMIN_KEY, binds 0.0.0.0, no codegen at boot
+HELIPOD_ADMIN_KEY=... bunx helipod serve
+```
+
+## Commands
+
+- `helipod dev` — run the engine locally with hot reload and the dashboard.
+- `helipod serve` — run the production server (requires `HELIPOD_ADMIN_KEY`, graceful shutdown on SIGTERM/SIGINT).
+- `helipod deploy` — deploy the app: `--target <serve|cloudflare|docker|railway|fly|aws>`, `--env <name>`, with `--dry-run` and `--check` modes. Deploying to a running `serve` hot-swaps functions and additive schema changes with no restart.
+- `helipod build` — compile the app and its components into a single self-contained executable (via `bun build --compile`), with cross-compile targets for Linux, macOS, and Windows.
+- `helipod migrate` — convert an existing project from another backend into a Helipod project (rewrites imports, emits a divergence report). `migrate export` / `migrate import` move app data as a portable JSON dump between deployments.
+- `helipod codegen` — regenerate the typed `_generated/` output (typed `api`, `Doc`/`Id` types, `mintId`) for your functions directory.
+
+Common options: `--port <n>`, `--ip <addr>`, `--dir <functionsDir>`, `--data <dbPath>`, `--database-url <url>` (Postgres; SQLite is the zero-config default).
+
+## Features
+
+- One-command local dev: functions, reactive sync, HTTP API, and dashboard on a single port.
+- SQLite by default, Postgres via `--database-url` — no app-schema migrations either way.
+- Live deploys to a running server (`serve --allow-deploy`), rejected if the schema change is destructive.
+- Single-binary output that embeds the runtime, your functions, and the dashboard.
+
+Part of [Helipod](https://github.com/helipod-sh/helipod) — docs at https://helipod-six.vercel.app/docs
+
+License: FSL-1.1-Apache-2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helipod/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "license": "FSL-1.1-Apache-2.0",
   "bin": {
@@ -21,6 +21,9 @@
     "./project": {
       "types": "./dist/project.d.ts",
       "default": "./dist/project.js"
+    },
+    "./bin": {
+      "default": "./dist/bin.js"
     }
   },
   "files": [
@@ -34,44 +37,44 @@
     "clean": "rm -rf dist .turbo"
   },
   "dependencies": {
-    "@helipod/admin": "0.1.0",
-    "@helipod/blobstore": "0.1.0",
-    "@helipod/blobstore-fs": "0.1.0",
-    "@helipod/blobstore-s3": "0.1.0",
-    "@helipod/codegen": "0.1.0",
-    "@helipod/component": "0.1.0",
-    "@helipod/deploy": "0.1.0",
-    "@helipod/docstore": "0.1.0",
-    "@helipod/docstore-postgres": "0.1.0",
-    "@helipod/docstore-sqlite": "0.1.0",
-    "@helipod/errors": "0.1.0",
-    "@helipod/executor": "0.1.0",
-    "@helipod/id-codec": "0.1.0",
-    "@helipod/objectstore": "0.1.0",
-    "@helipod/objectstore-fs": "0.1.0",
-    "@helipod/objectstore-s3": "0.1.0",
-    "@helipod/query-engine": "0.1.0",
-    "@helipod/receipts": "0.1.0",
-    "@helipod/runtime-embedded": "0.1.0",
-    "@helipod/storage": "0.1.0",
-    "@helipod/sync": "0.1.0",
-    "@helipod/values": "0.1.0",
+    "@helipod/admin": "0.1.2",
+    "@helipod/blobstore": "0.1.2",
+    "@helipod/blobstore-fs": "0.1.2",
+    "@helipod/blobstore-s3": "0.1.2",
+    "@helipod/codegen": "0.1.2",
+    "@helipod/component": "0.1.2",
+    "@helipod/deploy": "0.1.2",
+    "@helipod/docstore": "0.1.2",
+    "@helipod/docstore-postgres": "0.1.2",
+    "@helipod/docstore-sqlite": "0.1.2",
+    "@helipod/errors": "0.1.2",
+    "@helipod/executor": "0.1.2",
+    "@helipod/id-codec": "0.1.2",
+    "@helipod/objectstore": "0.1.2",
+    "@helipod/objectstore-fs": "0.1.2",
+    "@helipod/objectstore-s3": "0.1.2",
+    "@helipod/query-engine": "0.1.2",
+    "@helipod/receipts": "0.1.2",
+    "@helipod/runtime-embedded": "0.1.2",
+    "@helipod/storage": "0.1.2",
+    "@helipod/sync": "0.1.2",
+    "@helipod/values": "0.1.2",
     "esbuild": "^0.27.0",
     "ws": "^8.18.0",
-    "@helipod/dashboard": "0.1.0"
+    "@helipod/dashboard": "0.1.2"
   },
   "devDependencies": {
     "@electric-sql/pglite": "^0.2.17",
     "@levischuck/tiny-cbor": "0.2.11",
     "@simplewebauthn/server": "13.3.2",
-    "@helipod/auth": "0.1.0",
-    "@helipod/client": "0.1.0",
-    "@helipod/fleet": "0.0.0",
-    "@helipod/notifications": "0.1.0",
-    "@helipod/objectstore-substrate": "0.0.0",
-    "@helipod/scheduler": "0.1.0",
-    "@helipod/triggers": "0.1.0",
-    "@helipod/workflow": "0.1.0",
+    "@helipod/auth": "0.1.2",
+    "@helipod/client": "0.1.2",
+    "@helipod/fleet": "0.1.2",
+    "@helipod/notifications": "0.1.2",
+    "@helipod/objectstore-substrate": "0.1.2",
+    "@helipod/scheduler": "0.1.2",
+    "@helipod/triggers": "0.1.2",
+    "@helipod/workflow": "0.1.2",
     "@types/node": "^22.10.5",
     "@types/ws": "^8.5.13",
     "fake-indexeddb": "^6.0.0",