@esuyo/coding-container 1.0.10 → 1.0.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esuyo/coding-container",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "CLI to build, publish and deploy SSH-accessible coding containers on k3s",
   "type": "module",
   "bin": {

package/src/commands/build.js

@@ -1,5 +1,5 @@
 import fs from "node:fs";
-import { dockerExec, run } from "../utils/exec.js";
+import { dockerExec, ensureDockerAvailable, run } from "../utils/exec.js";
 import { imageRef } from "../config.js";
 
 /**
@@ -27,8 +27,21 @@ export async function buildImage(cfg) {
   }
   args.push(cfg.image.contextPath);
   console.log(`Building image ${ref} ...`);
+  try {
+    ensureDockerAvailable();
+  } catch (err) {
+    throw new Error(
+      `${err.message}\n(Build of ${ref} did not start — no image was built.)`
+    );
+  }
   const { cmd, opts } = dockerExec();
-  await run(cmd, args, opts);
+  try {
+    await run(cmd, args, opts);
+  } catch (err) {
+    throw new Error(
+      `${err.message}\n(Build of ${ref} failed. If the output above mentions the Docker API, npipe, or daemon, Docker isn't running — start Docker Desktop (or the Docker daemon) and try again.)`
+    );
+  }
   console.log(`Built ${ref}`);
 }
 

package/src/commands/push.js

@@ -1,4 +1,4 @@
-import { dockerExec, run } from "../utils/exec.js";
+import { dockerExec, ensureDockerAvailable, run } from "../utils/exec.js";
 import { imageRef } from "../config.js";
 
 /**
@@ -9,12 +9,19 @@ import { imageRef } from "../config.js";
 export async function pushImage(cfg) {
   const ref = imageRef(cfg);
   console.log(`Pushing ${ref} to ${cfg.image.registry} ...`);
+  try {
+    ensureDockerAvailable();
+  } catch (err) {
+    throw new Error(
+      `${err.message}\n(Push of ${ref} did not start — nothing was pushed.)`
+    );
+  }
   const { cmd, opts } = dockerExec();
   try {
     await run(cmd, ["push", ref], opts);
   } catch (err) {
     throw new Error(
-      `Push failed for ${ref}. Make sure you are logged in to ${cfg.image.registry} (docker login ${cfg.image.registry}).\n${err.message}`
+      `Push failed for ${ref}. Make sure you are logged in to ${cfg.image.registry} (docker login ${cfg.image.registry}). If the output above mentions the Docker API, npipe, or daemon, Docker isn't running — start Docker Desktop (or the Docker daemon) and try again.\n${err.message}`
     );
   }
   console.log(`Pushed ${ref}`);

package/src/utils/exec.js

@@ -12,6 +12,53 @@ export function dockerExec() {
   return { cmd, opts };
 }
 
+/**
+ * True when a docker failure looks like the daemon isn't reachable
+ * (Docker Desktop stopped, engine pipe missing, connection refused).
+ */
+export function isDockerDaemonError(text) {
+  const s = String(text ?? "");
+  return (
+    /failed to connect to the docker api/i.test(s) ||
+    /cannot connect to the docker daemon/i.test(s) ||
+    /docker.*daemon.*(not running|unreachable|refused)/i.test(s) ||
+    /npipe/i.test(s) ||
+    /dockerDesktopLinuxEngine/i.test(s) ||
+    /\/\/\.\/pipe\/docker/i.test(s) ||
+    /open \/\/\.\/pipe\/docker/i.test(s) ||
+    /The system cannot find the file specified/i.test(s) ||
+    /error during connect/i.test(s)
+  );
+}
+
+/**
+ * Friendly wrapper for docker-daemon failures. Keeps the original detail
+ * so the underlying cause isn't lost, but leads with what to do.
+ */
+export function dockerUnavailableMessage(cause) {
+  const detail = String(cause?.message ?? cause ?? "").trim();
+  const lines = [
+    "Docker isn't running or can't be reached.",
+    "Start Docker Desktop (Windows/macOS) or start the Docker daemon (Linux), wait until it reports healthy, then try again.",
+  ];
+  if (detail) lines.push(`Details: ${detail}`);
+  return lines.join("\n");
+}
+
+/**
+ * Pre-flight check: fail fast with an actionable message when the docker
+ * daemon isn't reachable, instead of a raw `docker build` API error.
+ * Throws with a "Docker isn't running" message; resolves otherwise.
+ */
+export function ensureDockerAvailable() {
+  const { cmd, opts } = dockerExec();
+  try {
+    exec(cmd, ["info"], opts);
+  } catch (err) {
+    throw new Error(dockerUnavailableMessage(err.message ?? err));
+  }
+}
+
 /**
  * Run a command and return its stdout (trimmed). Throws on non-zero exit.
  */