@bigrandall/rrangler 0.1.0 → 0.2.0

package/README.md

@@ -55,6 +55,7 @@ Mirrors wrangler — `publish` aliases to `deploy`, `kv:namespace` works too.
 | `tail <slug>` | stream runtime logs |
 | `worker env set <slug> K=V …` / `delete` | env vars (`--secret` to mask) |
 | `worker builds <slug>` / `build <slug> [--branch]` / `build-log <slug> <id>` | git builds |
+| `worker git get \| set \| disconnect <slug>` | connect a repo (see [Git connect](#git-connect)) |
 | `worker cron <slug> [--dlq]` / `cron replay <slug> <runId>` | cron runs + DLQ replay |
 | `secret put <KEY> --worker <slug>` | set a secret (value from `--value` or stdin) |
 | `secret list \| delete` | manage secrets |
@@ -72,6 +73,7 @@ Mirrors wrangler — `publish` aliases to `deploy`, `kv:namespace` works too.
 | `r2 object put <bucket> <key> <file>` / `get` / `delete` | R2 objects |
 | `pages list` / `get <slug>` | Pages projects |
 | `pages env set\|delete` / `builds` / `build [--branch]` / `build-log` / `tail` | Pages ops |
+| `pages git get \| set \| disconnect <slug>` | connect a repo (see [Git connect](#git-connect)) |
 | `api <METHOD> <path> [--data '<json>']` | raw API passthrough |
 
 Global flags: `--json` (machine-readable stdout), `--api`, `--token`.
@@ -93,6 +95,45 @@ Global flags: `--json` (machine-readable stdout), `--api`, `--token`.
 to it). `files` is optional — omit it to send just `main`. A `wrangler.toml`
 with `name` / `main` is read as a fallback for drop-in compatibility.
 
+## Git connect
+
+Beyond wrangler: point a worker or Pages project at a GitHub repo so it
+auto-builds on push. This is server-side (the edge build runner clones + builds)
+— distinct from `deploy`, which uploads your local files directly.
+
+```sh
+# connect a repo, monorepo subdirectory + build command
+rrangler worker git set my-api \
+  --repo https://github.com/me/monorepo.git \
+  --branch main \
+  --root-dir apps/api \
+  --build-command 'npm ci && npm run build' \
+  --output-file dist/index.js
+
+rrangler worker git get my-api          # inspect current config
+rrangler worker git disconnect my-api   # back to editor/upload mode
+
+# Pages is the same, minus the worker-only output-file/entry flags
+rrangler pages git set my-site --repo … --root-dir apps/site --output-dir dist
+```
+
+Flags (all optional; only the ones you pass change — it's a partial update):
+
+| flag | meaning |
+| --- | --- |
+| `--repo <url>` | HTTPS clone URL (empty to clear) |
+| `--branch <b>` | production branch (default `main`) |
+| `--root-dir <path>` | **monorepo**: subdir the project lives in; build runs there, output paths are relative to it |
+| `--build-command '<cmd>'` | shell build (blank = zero-config) |
+| `--output-dir <d>` | build output dir |
+| `--output-file <f>` / `--output-entry <e>` | worker-only: single-bundle file / entry |
+| `--git-token <t>` | PAT for private repos (`-` to clear; omit to keep) |
+| `--use-app-auth` / `--no-app-auth` | use the GitHub App for clones instead of a PAT |
+| `--build-env '<json>'` | build-time env vars, as a JSON object |
+
+Setting git config doesn't trigger a build — run one with
+`rrangler worker build <slug>` / `pages build <slug>` afterwards.
+
 ## Beyond wrangler
 
 - `doctor` — one-shot health + capability probe (what your token can actually do).

package/bin/rrangler.mjs

@@ -29,6 +29,9 @@ const ROUTES = {
   "worker build-log": cmd.workerBuildLog,
   "worker env set": cmd.workerEnvSet,
   "worker env delete": cmd.workerEnvDelete,
+  "worker git get": cmd.workerGitGet,
+  "worker git set": cmd.workerGitSet,
+  "worker git disconnect": cmd.workerGitDisconnect,
   "worker cron": cmd.workerCron,
   "worker cron replay": cmd.workerCronReplay,
 
@@ -68,6 +71,9 @@ const ROUTES = {
   "pages get": cmd.pagesGet,
   "pages env set": cmd.pagesEnvSet,
   "pages env delete": cmd.pagesEnvDelete,
+  "pages git get": cmd.pagesGitGet,
+  "pages git set": cmd.pagesGitSet,
+  "pages git disconnect": cmd.pagesGitDisconnect,
   "pages builds": cmd.pagesBuilds,
   "pages build": cmd.pagesBuild,
   "pages build-log": cmd.pagesBuildLog,
@@ -132,6 +138,11 @@ ${style.bold("workers")}
   rrangler worker builds <slug>
   rrangler worker build <slug> [--branch b]        trigger a git build
   rrangler worker build-log <slug> <buildId> [--tail N]
+  rrangler worker git get <slug>                   show git-connect config
+  rrangler worker git set <slug> [--repo url] [--branch b] [--root-dir path]
+       [--build-command '…'] [--output-file f | --output-dir d] [--output-entry e]
+       [--git-token t|-] [--use-app-auth|--no-app-auth] [--build-env '<json>']
+  rrangler worker git disconnect <slug>
   rrangler worker cron <slug> [--dlq] [--limit N]
   rrangler worker cron replay <slug> <runId>
   rrangler secret put <KEY> --worker <slug> [--value v]
@@ -171,6 +182,11 @@ ${style.bold("pages")}
   rrangler pages build <slug> [--branch b]
   rrangler pages build-log <slug> <buildId>
   rrangler pages tail <slug>
+  rrangler pages git get <slug>                    show git-connect config
+  rrangler pages git set <slug> [--repo url] [--branch b] [--root-dir path]
+       [--build-command '…'] [--output-dir d] [--git-token t|-]
+       [--use-app-auth|--no-app-auth] [--build-env '<json>']
+  rrangler pages git disconnect <slug>
 
 ${style.bold("power")}
   rrangler api <METHOD> <path> [--data '<json>']   raw API call
@@ -185,7 +201,7 @@ async function main() {
     return;
   }
   if (argv[0] === "--version" || argv[0] === "-v" || argv[0] === "version") {
-    process.stdout.write("rrangler 0.1.0\n");
+    process.stdout.write("rrangler 0.2.0\n");
     return;
   }
 

package/commands/index.mjs

@@ -190,6 +190,118 @@ export async function workerEnvDelete({ pos }) {
   ok(`deleted ${del.join(", ")} from ${w.slug}`);
 }
 
+// ── git connect (workers + pages share the same shape) ─────────────
+
+// Flag → API-body key. `kind` adds the worker-only output-file/entry.
+function gitBodyFromFlags(flags, kind) {
+  const map = {
+    repo: "repoUrl",
+    "repo-url": "repoUrl",
+    branch: "branch",
+    root: "rootDir",
+    "root-dir": "rootDir",
+    "build-command": "buildCommand",
+    "output-dir": "outputDir",
+    // NB: not `--token` — that's the global API-auth override flag.
+    "git-token": "token",
+    pat: "token",
+  };
+  if (kind === "worker") {
+    map["output-file"] = "outputFile";
+    map["output-entry"] = "outputEntry";
+  }
+  const body = {};
+  for (const [flag, key] of Object.entries(map)) {
+    if (flag in flags) body[key] = flags[flag] === true ? "" : String(flags[flag]);
+  }
+  // --use-app-auth / --no-app-auth toggle GitHub-App clone auth.
+  if ("use-app-auth" in flags) body.useAppAuth = flags["use-app-auth"] !== "false";
+  if ("no-app-auth" in flags) body.useAppAuth = false;
+  if ("build-env" in flags) {
+    try {
+      body.buildEnv = JSON.parse(String(flags["build-env"]));
+    } catch {
+      throw new Error("--build-env must be a valid JSON object string");
+    }
+  }
+  return body;
+}
+
+function printGit(g) {
+  if (!g) return;
+  const rows = [
+    ["repo", g.repoUrl || "—"],
+    ["branch", g.branch || "(default: main)"],
+    ["root / subdir", g.rootDir || "(repo root)"],
+    ["build command", g.buildCommand || "(none — zero-config)"],
+  ];
+  if ("outputFile" in g) rows.push(["output file", g.outputFile || "—"]);
+  rows.push(["output dir", g.outputDir || "—"]);
+  if ("outputEntry" in g) rows.push(["output entry", g.outputEntry || "—"]);
+  rows.push(["github app auth", g.useAppAuth ? "yes" : "no"]);
+  rows.push(["token", g.hasToken ? "set" : "—"]);
+  rows.push(["last built", g.lastBuiltCommit || "—"]);
+  table(["field", "value"], rows);
+}
+
+const GIT_SET_USAGE =
+  "[--repo url] [--branch b] [--root-dir path] [--build-command '…'] " +
+  "[--output-dir d] [--git-token t|-] [--use-app-auth|--no-app-auth] [--build-env '<json>']";
+
+export async function workerGitGet({ pos, flags }) {
+  const w = await resolveWorker(pos[0]);
+  const res = await api("GET", `workers/${w.id}/git`);
+  if (asJson(flags)) return printJson(res);
+  printGit(res.git);
+}
+
+export async function workerGitSet({ pos, flags }) {
+  const body = gitBodyFromFlags(flags, "worker");
+  if (Object.keys(body).length === 0) {
+    throw new Error(
+      `usage: rrangler worker git set <slug> ${GIT_SET_USAGE} [--output-file f] [--output-entry e]`,
+    );
+  }
+  const w = await resolveWorker(pos[0]);
+  const res = await api("POST", `workers/${w.id}/git`, { json: body });
+  if (asJson(flags)) return printJson(res);
+  ok(`git config updated on ${w.slug}`);
+  printGit(res.git);
+}
+
+export async function workerGitDisconnect({ pos, flags }) {
+  const w = await resolveWorker(pos[0]);
+  const res = await api("DELETE", `workers/${w.id}/git`);
+  if (asJson(flags)) return printJson(res);
+  ok(`disconnected ${w.slug} from git`);
+}
+
+export async function pagesGitGet({ pos, flags }) {
+  const p = await resolvePages(pos[0]);
+  const res = await api("GET", `pages/${p.id}/git`);
+  if (asJson(flags)) return printJson(res);
+  printGit(res.git);
+}
+
+export async function pagesGitSet({ pos, flags }) {
+  const body = gitBodyFromFlags(flags, "pages");
+  if (Object.keys(body).length === 0) {
+    throw new Error(`usage: rrangler pages git set <slug> ${GIT_SET_USAGE}`);
+  }
+  const p = await resolvePages(pos[0]);
+  const res = await api("POST", `pages/${p.id}/git`, { json: body });
+  if (asJson(flags)) return printJson(res);
+  ok(`git config updated on ${p.slug}`);
+  printGit(res.git);
+}
+
+export async function pagesGitDisconnect({ pos, flags }) {
+  const p = await resolvePages(pos[0]);
+  const res = await api("DELETE", `pages/${p.id}/git`);
+  if (asJson(flags)) return printJson(res);
+  ok(`disconnected ${p.slug} from git`);
+}
+
 export async function workerCron({ pos, flags }) {
   const w = await resolveWorker(pos[0]);
   const out = await api("GET", `workers/${w.id}/cron-runs`, { query: { dlq: flags.dlq ? 1 : undefined, limit: flags.limit } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bigrandall/rrangler",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "wrangler-compatible CLI for RandallFlare — the self-hosted Cloudflare-Workers edge platform in bigrandall.io. Deploy workers, manage D1/KV/R2, tail logs, run locally on workerd.",
   "type": "module",
   "bin": {