supabase-worker-previews 0.1.0 → 0.1.1

package/README.md

@@ -58,14 +58,14 @@ You need a Worker deployed by Workers Builds from a GitHub repo, wrangler 4.135.
 
 ```bash
 npm install --save-dev supabase-worker-previews
-npx swp init --project-ref <production project ref>
+npx supabase-worker-previews init --project-ref <production project ref>
 ```
 
 `init` writes `swp.config.json`, a grants migration and the PR workflow, and prints the rest. Then:
 
 1. Connect the Supabase GitHub integration (automatic branching on, deploy to production off).
 2. Add a `previews` block to your wrangler config.
-3. `npx swp shared` creates the shared Preview database and prints its `previews.vars`.
+3. `npx supabase-worker-previews shared` creates the shared Preview database and prints its `previews.vars`.
 4. Wrap the Worker:
 
    ```ts
@@ -77,7 +77,7 @@ npx swp init --project-ref <production project ref>
 
    and create the browser client from `readPublicConfig()`.
 
-5. Turn on Preview builds in Workers Builds, add three Actions secrets, run `npx swp doctor`, and open a PR.
+5. Turn on Preview builds in Workers Builds, add three Actions secrets, run `npx supabase-worker-previews doctor`, and open a PR.
 
 The **[full quickstart](docs/quickstart.md)** walks through every step with the dashboard settings and the output to expect. For a complete working project, see [`examples/hono-notes`](examples/hono-notes).
 
@@ -94,6 +94,8 @@ The **[full quickstart](docs/quickstart.md)** walks through every step with the
 | **In CI**      | `swp pr`     | All of the above for a `pull_request` workflow, plus the PR comment and deployment   |
 |                | `swp prune`  | List leftovers of deleted branches and closed PRs; delete them with `--yes`          |
 
+`swp` is the short name once the package is installed; the full name `supabase-worker-previews` runs the same CLI. With `npx`, always use the full name: `npx swp` on a machine without this package installed downloads [an unrelated npm package named `swp`](https://www.npmjs.com/package/swp) that deletes dependency and build folders.
+
 `swp <command> --help` shows one command's flags and examples, and `swp --version` prints the version. Flags, environment variables, every `swp.config.json` field and the GitHub Action inputs are in the [configuration reference](docs/configuration.md).
 
 ## Safety

package/dist/commands/init.js

@@ -104,7 +104,7 @@ export function init(options = {}, cwd = process.cwd()) {
         log(`+ ${WORKFLOW}`);
         log(options.action
             ? "  It uses the published action, mattruby/supabase-worker-previews@v0."
-            : "  It runs the installed swp (npx swp pr); `swp init --action` writes one that uses the published action.");
+            : "  It runs `npx supabase-worker-previews pr`; `npx supabase-worker-previews init --action` writes one that uses the published action instead.");
     }
     const steps = [
         ...(needsRef
@@ -119,13 +119,13 @@ export function init(options = {}, cwd = process.cwd()) {
             : [`Add a "previews" block to ${wrangler.file}, redeclaring every binding the Worker uses.`]),
         "Put SUPABASE_ACCESS_TOKEN, CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID in .env.swp\n" +
             `(git-ignore it; scopes: ${TOKENS_URL}),\n` +
-            "then run `npx swp shared` and paste the previews.vars it prints.",
+            "then run `npx supabase-worker-previews shared` and paste the previews.vars it prints.",
         "Wrap the Worker's default export:\n" +
             '  import { withSupabasePreviews } from "supabase-worker-previews";\n' +
             "  export default withSupabasePreviews(app);",
         "Workers Builds: turn on non-production branch builds, deploy command `npx wrangler preview`.",
         "GitHub repo, Settings, Secrets and variables, Actions: add the same three tokens.",
-        "Run `npx swp doctor` until it passes, then commit and open a PR.",
+        "Run `npx supabase-worker-previews doctor` until it passes, then commit and open a PR.",
     ];
     log(`\nNext, by hand (the full guide: ${QUICKSTART_URL}):`);
     steps.forEach((step, i) => log(`  ${i + 1}. ${step.replace(/\n/g, "\n     ")}`));

package/dist/usage.js

@@ -37,7 +37,10 @@ export const COMMANDS = [
                 value: "<branch>",
                 help: "Branch the shared database tracks (default: origin/HEAD, else main)",
             },
-            { name: "action", help: "Write a workflow that uses the published GitHub Action instead of npx swp" },
+            {
+                name: "action",
+                help: "Write a workflow that uses the published GitHub Action instead of npx supabase-worker-previews",
+            },
             { ...DRY_RUN, help: "Print what it would write; write nothing" },
         ],
         env: [],
@@ -185,9 +188,9 @@ export function mainHelp(s = makeStyle(false)) {
         `  Where to get them: ${TOKENS_URL}`,
         "",
         s.bold("Examples"),
-        "  npx swp init --project-ref abcdefghijklmnopqrst",
-        "  npx swp doctor",
-        "  npx swp shared --dry-run",
+        "  npx supabase-worker-previews init --project-ref abcdefghijklmnopqrst",
+        "  npx supabase-worker-previews doctor",
+        "  npx supabase-worker-previews shared --dry-run",
         "",
         `Run ${s.cyan("swp <command> --help")} for one command. Docs: ${DOCS_URL}`,
     ].join("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supabase-worker-previews",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Branch previews for Cloudflare Workers on Supabase branching: every git branch gets a Worker Preview, and every PR that changes the schema gets its own Supabase database.",
   "license": "MIT",
   "author": "Matt Ruby",
@@ -34,7 +34,8 @@
     "node": ">=22.0.0"
   },
   "bin": {
-    "swp": "dist/cli.js"
+    "swp": "dist/cli.js",
+    "supabase-worker-previews": "dist/cli.js"
   },
   "main": "./dist/runtime.js",
   "types": "./dist/runtime.d.ts",

package/templates/supabase-previews.yml

@@ -30,7 +30,7 @@ jobs:
           node-version: 24
           cache: npm
       - run: npm ci --no-audit --no-fund
-      - run: npx swp pr
+      - run: npx supabase-worker-previews pr
         env:
           GITHUB_TOKEN: ${{ github.token }}
           SUPABASE_ACCESS_TOKEN: ${{ secrets.SUPABASE_ACCESS_TOKEN }}