dsh-plugin-toolkit 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.3.3
+
+- `mount` on a path that is missing, or that is a directory, now says what to pass instead of raising `ENOENT: no such file or directory, open '…'`. Found by running the three commands in a clean HOME with a fresh clone.
+
 ## 0.3.2
 
 - `expectSnapshot(html, dir, name)`: the assertion form of `compare`, so a baseline test reads like a test and fails with the element that moved.

package/README.md

@@ -108,6 +108,10 @@ The host already swaps a rebuilt bundle without a page reload: it watches each p
 npx dsh-plugin dev . --host http://127.0.0.1:54133
 ```
 
+![dsh-plugin dev printing the revision the app reported](docs/dev.gif)
+
+*Recorded from a real run against the running app: the last line is the revision the app sent back on `/plugins/events`, not a message the tool printed on faith.*
+
 ```
 demo-aiignore: /work/plugin/client.js -> ~/.dsh/profiles/desktop/node_modules/dsh-aiignore/client.js
 initial: copied 163647 bytes at 1:18:43 AM

package/lib/testkit/load.mjs

@@ -8,6 +8,23 @@
  */
 import fs from 'node:fs';
 
+/**
+ * Read the bundle, or say what is wrong with the path in the caller's words.
+ *
+ * A raw ENOENT is technically true and practically useless: the usual mistake is
+ * passing the plugin folder, or a path relative to the wrong directory.
+ */
+function readBundleSource(file) {
+  const resolved = String(file);
+  if (fs.existsSync(resolved) === false) {
+    throw new Error(`no such file: ${resolved} (mount takes the client bundle, e.g. ./client.js)`);
+  }
+  if (fs.statSync(resolved).isDirectory() === true) {
+    throw new Error(`${resolved} is a directory (mount takes the client bundle inside it, e.g. ${resolved}/client.js)`);
+  }
+  return fs.readFileSync(resolved, 'utf8');
+}
+
 export function createModuleLoader({ require: provide, onLoad } = {}) {
   const loaded = [];
   const loader = {
@@ -27,7 +44,7 @@ export function createModuleLoader({ require: provide, onLoad } = {}) {
 }
 
 export function loadBundle(file, options = {}) {
-  const source = fs.readFileSync(file, 'utf8');
+  const source = readBundleSource(file);
   const loader = createModuleLoader(options);
   const context = { window: { __ModuleLoader__: loader }, __ModuleLoader__: loader, ...(options.globals ?? {}) };
   // The bundle is an IIFE or a top-level statement list; the browser would run it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-toolkit",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Preflight, release and test DeepSeek Harness plugins: checks what the host needs, waits for npm to actually serve the version, and keeps the market index honest.",
   "type": "module",
   "bin": {