@solcreek/cli 0.4.5 → 0.4.6

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @solcreek/cli
 
+## 0.4.6
+
+### Features
+
+- **`creek deploy gh:owner/repo` shorthand** — a shorter alias for
+  `https://github.com/owner/repo`. Matches the GitHub CLI convention.
+  `gh:`, `gl:` (GitLab), and `bb:` (Bitbucket) are now all registered
+  alongside the longer `github:` / `gitlab:` / `bitbucket:` forms.
+  Example: `npx creek deploy gh:jiseeeh/serene-ink`.
+
+### Fixes / DX
+
+- **Install size cut from ~170MB to ~25MB** by moving `miniflare` out of
+  runtime dependencies entirely. Miniflare plus its transitive deps
+  (workerd, sharp) was adding ~146MB to every `npm install creek` — a
+  pure penalty on the `creek deploy` flow, which never touches
+  miniflare. `miniflare` is now listed in `devDependencies` only, so
+  the published package is free of it. First-time `npx creek deploy`
+  goes from ~20s install to ~3–5s, and the postinstall warnings that
+  used to appear on systems without build tools (sharp's node-gyp
+  fallback) are gone entirely.
+
+- **`creek dev` loads miniflare from multiple locations** via
+  `createRequire` — the user's current project (`npm install --save-dev
+  miniflare`), a creek-managed cache directory at `~/.creek/deps`, or
+  the global npm root (`npm install -g miniflare`). If none of those
+  have it, a jargon-free error explains what to install and where.
+  Users who only want to deploy never see this error because
+  `creek deploy` doesn't load the local runtime at all.
+
 ## 0.4.5
 
 ### Features

package/dist/dev/worker-runner.d.ts

@@ -1,4 +1,14 @@
 import type { BindingDeclaration } from "@solcreek/sdk";
+/**
+ * Thrown by `creek dev` when no local runtime package can be resolved from
+ * the user's project, global npm root, or creek's dep cache. The message
+ * is deliberately jargon-free: it talks about "a local runtime" instead of
+ * naming miniflare in the explanation, and only mentions the package name
+ * as part of the exact npm command the user needs to run.
+ */
+export declare class MiniflareNotInstalledError extends Error {
+    constructor();
+}
 export interface WorkerRunnerOptions {
     /** User's worker entry point (e.g. "worker/index.ts"). */
     entryPoint: string;

package/dist/dev/worker-runner.js

@@ -1,11 +1,93 @@
-// Worker execution for `creek dev` — bundles user code and runs it via Miniflare.
+// Worker execution for `creek dev` — bundles user code and runs it via
+// Miniflare for local D1 / KV / R2 / Queues / Durable Objects simulation.
 //
-// Uses esbuild watch mode for hot reload and Miniflare for D1/KV/R2 simulation.
+// `miniflare` is intentionally NOT in @solcreek/cli's runtime dependencies —
+// it (plus its transitive deps workerd and sharp) adds ~146MB to every
+// install of `creek`. Since `creek deploy` never touches miniflare, it's
+// a pure penalty on the aha-moment flow: paste a command, see a live URL.
+//
+// Instead, `creek dev` resolves miniflare at runtime from the caller's
+// project (npm install --save-dev miniflare in their own package.json),
+// the global npm root, or a creek-managed cache dir. If none of those
+// have miniflare, we throw a zero-jargon error that tells the user
+// exactly one command to run.
 import { writeFileSync, mkdirSync } from "node:fs";
 import { join, resolve } from "node:path";
+import { createRequire } from "node:module";
+import { homedir } from "node:os";
+import { execSync } from "node:child_process";
 import { context } from "esbuild";
-import { Miniflare } from "miniflare";
 import { generateWorkerWrapper } from "../utils/worker-bundle.js";
+/**
+ * Thrown by `creek dev` when no local runtime package can be resolved from
+ * the user's project, global npm root, or creek's dep cache. The message
+ * is deliberately jargon-free: it talks about "a local runtime" instead of
+ * naming miniflare in the explanation, and only mentions the package name
+ * as part of the exact npm command the user needs to run.
+ */
+export class MiniflareNotInstalledError extends Error {
+    constructor() {
+        super([
+            "`creek dev` needs a local runtime to simulate the edge environment,",
+            "and it isn't installed yet.",
+            "",
+            "  One-time setup — run this in your project directory:",
+            "    npm install --save-dev miniflare",
+            "",
+            "  This downloads ~150MB but only needs to happen once per project.",
+            "  `creek deploy` already works without it — you can skip this step",
+            "  entirely if you only want to deploy.",
+        ].join("\n"));
+        this.name = "MiniflareNotInstalledError";
+    }
+}
+/**
+ * Try to load miniflare from several plausible locations, in order of
+ * preference:
+ *
+ *   1. The user's current project (npm install --save-dev miniflare)
+ *   2. Creek-managed dep cache at ~/.creek/deps/miniflare (for future
+ *      auto-install support — not wired up yet but already searched here
+ *      so a future `creek dev install` command can drop files there)
+ *   3. Global npm root (for users who `npm install -g miniflare`)
+ *
+ * Each location is attempted with a fresh `createRequire` rooted at a
+ * dummy file in that directory, then `require.resolve("miniflare")` is
+ * used to find the package. If all three fail, throws
+ * MiniflareNotInstalledError with a zero-jargon explanation.
+ */
+async function loadMiniflare() {
+    const searchRoots = [];
+    // 1. User's current project
+    searchRoots.push(process.cwd());
+    // 2. Creek-managed cache
+    searchRoots.push(join(homedir(), ".creek", "deps"));
+    // 3. Global npm root (best-effort — may be slow on first call)
+    try {
+        const globalRoot = execSync("npm root -g", {
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        if (globalRoot)
+            searchRoots.push(globalRoot);
+    }
+    catch {
+        // No npm on PATH, or command failed — skip this search path silently.
+    }
+    for (const root of searchRoots) {
+        try {
+            // createRequire needs a file path — use a dummy file inside the root
+            // (the file doesn't have to exist for node_modules lookup to work).
+            const req = createRequire(join(root, "__creek_resolver__.js"));
+            const resolved = req.resolve("miniflare");
+            return (await import(resolved));
+        }
+        catch {
+            // Try the next root.
+        }
+    }
+    throw new MiniflareNotInstalledError();
+}
 const NODE_BUILTINS = [
     "node:async_hooks",
     "node:stream",
@@ -52,9 +134,14 @@ export class WorkerRunner {
         writeFileSync(wrapperPath, wrapper);
         // 2. Initial bundle with esbuild
         const bundledScript = await this.bundle(wrapperPath);
-        // 3. Start Miniflare
+        // 3. Start Miniflare — loaded from the user's project / cache / global
+        //    so `creek deploy` can ship without miniflare in @solcreek/cli's
+        //    runtime dependencies. See loadMiniflare() above for the search
+        //    order and the MiniflareNotInstalledError message.
+        const miniflareModule = await loadMiniflare();
+        const MiniflareCtor = miniflareModule.Miniflare;
         this.mfOptions = this.buildMiniflareOptions(bundledScript, persistDir);
-        this.mf = new Miniflare(this.mfOptions);
+        this.mf = new MiniflareCtor(this.mfOptions);
         // Wait for Miniflare to be ready and get the port
         const readyUrl = await this.mf.ready;
         // mf.ready returns a URL object

package/dist/utils/repo-url.d.ts

@@ -28,8 +28,11 @@ export declare function isRepoUrl(input: string): boolean;
  *   https://github.com/owner/repo.git
  *   https://github.com/owner/repo#branch
  *   https://github.com/owner/repo/tree/branch
- *   github:owner/repo
- *   github:owner/repo#branch
+ *   github:owner/repo           (long-form shorthand)
+ *   gh:owner/repo               (short alias — matches gh CLI convention)
+ *   gh:owner/repo#branch
+ *   gitlab:owner/repo           gl:owner/repo
+ *   bitbucket:owner/repo        bb:owner/repo
  */
 export declare function parseRepoUrl(input: string): ParsedRepoUrl;
 /**

package/dist/utils/repo-url.js

@@ -17,10 +17,17 @@ const PROVIDER_HOSTS = {
     "bitbucket.org": "bitbucket",
     "www.bitbucket.org": "bitbucket",
 };
+// Shorthand prefixes. Short aliases (gh:/gl:/bb:) match the conventions
+// established by the GitHub CLI, GitLab CLI, and other tooling — they're
+// the shortest safe way to reference a repo without colliding with local
+// path syntax (local paths never have ':' before any '/').
 const SHORTHAND_PREFIXES = {
     "github:": "github",
+    "gh:": "github",
     "gitlab:": "gitlab",
+    "gl:": "gitlab",
     "bitbucket:": "bitbucket",
+    "bb:": "bitbucket",
 };
 // Strict character set for owner and repo names
 const SAFE_NAME = /^[a-zA-Z0-9._-]+$/;
@@ -53,8 +60,11 @@ export function isRepoUrl(input) {
  *   https://github.com/owner/repo.git
  *   https://github.com/owner/repo#branch
  *   https://github.com/owner/repo/tree/branch
- *   github:owner/repo
- *   github:owner/repo#branch
+ *   github:owner/repo           (long-form shorthand)
+ *   gh:owner/repo               (short alias — matches gh CLI convention)
+ *   gh:owner/repo#branch
+ *   gitlab:owner/repo           gl:owner/repo
+ *   bitbucket:owner/repo        bb:owner/repo
  */
 export function parseRepoUrl(input) {
     if (!input || typeof input !== "string") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solcreek/cli",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "CLI for the Creek deployment platform",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,7 +31,6 @@
     "citty": "^0.1.6",
     "consola": "^3.4.2",
     "esbuild": "^0.25.0",
-    "miniflare": "^4.20260317.3",
     "smol-toml": "^1.3.1",
     "ws": "^8.20.0",
     "@solcreek/sdk": "0.4.2"
@@ -44,6 +43,7 @@
     "@types/ws": "^8.18.1",
     "hono": "^4.7.4",
     "jsdom": "^29.0.1",
+    "miniflare": "^4.20260317.3",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "typescript": "^5.8.2",