@nimrobo/wand-web 0.1.0

package/dist/server/storage.js

@@ -0,0 +1,73 @@
+import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+export class WandStorage {
+    root;
+    contextDir;
+    queueDir;
+    tmpDir;
+    constructor(projectRoot) {
+        this.root = path.join(projectRoot, ".wand");
+        this.contextDir = path.join(this.root, "contexts");
+        this.queueDir = path.join(this.root, "queue");
+        this.tmpDir = path.join(this.root, "tmp");
+    }
+    async ensure() {
+        await Promise.all([
+            mkdir(this.contextDir, { recursive: true }),
+            mkdir(this.queueDir, { recursive: true }),
+            mkdir(this.tmpDir, { recursive: true }),
+        ]);
+    }
+    async persistCapture(capture) {
+        await this.ensure();
+        const elementHtmlPath = path.join(this.contextDir, `${capture.id}.html`);
+        const viewportScreenshotPath = path.join(this.tmpDir, `${capture.id}-viewport.png`);
+        const elementScreenshotPath = path.join(this.tmpDir, `${capture.id}-element.png`);
+        await Promise.all([
+            writeFile(elementHtmlPath, capture.elementHtml, "utf8"),
+            writeFile(viewportScreenshotPath, dataUrlToBuffer(capture.viewportDataUrl)),
+            writeFile(elementScreenshotPath, dataUrlToBuffer(capture.elementDataUrl)),
+        ]);
+        const persisted = {
+            ...capture,
+            contextPath: path.join(this.contextDir, `${capture.id}.json`),
+            elementHtmlPath,
+            viewportScreenshotPath,
+            elementScreenshotPath,
+        };
+        delete persisted.elementHtml;
+        delete persisted.viewportDataUrl;
+        delete persisted.elementDataUrl;
+        await writeFile(persisted.contextPath, `${JSON.stringify(persisted, null, 2)}\n`, "utf8");
+        return persisted;
+    }
+    async queue(prompt, context) {
+        await this.ensure();
+        const request = {
+            id: context.id,
+            createdAt: new Date().toISOString(),
+            prompt,
+            context,
+        };
+        await writeFile(path.join(this.queueDir, `${request.id}.json`), `${JSON.stringify(request, null, 2)}\n`, "utf8");
+        return request;
+    }
+    async listQueue() {
+        await this.ensure();
+        const entries = (await readdir(this.queueDir)).filter((entry) => entry.endsWith(".json"));
+        const items = await Promise.all(entries.map(async (entry) => {
+            const raw = await readFile(path.join(this.queueDir, entry), "utf8");
+            return JSON.parse(raw);
+        }));
+        return items.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    }
+    async removeQueued(id) {
+        await rm(path.join(this.queueDir, `${id}.json`), { force: true });
+    }
+}
+function dataUrlToBuffer(dataUrl) {
+    const match = dataUrl.match(/^data:image\/png;base64,(.+)$/);
+    if (!match)
+        throw new Error("Expected a PNG data URL.");
+    return Buffer.from(match[1], "base64");
+}

package/dist/server/types.d.ts

@@ -0,0 +1,50 @@
+import type { AdapterKind } from "@nimrobo/superconnector";
+export type Rect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type ReactOwnerHint = {
+    name: string | null;
+    key: string | null;
+    source: string | null;
+};
+export type SelectionCapture = {
+    id: string;
+    createdAt: string;
+    url: string;
+    route: string;
+    title: string;
+    selector: string;
+    domPath: string[];
+    tagName: string;
+    text: string;
+    attributes: Record<string, string>;
+    rect: Rect;
+    reactOwnerHints: ReactOwnerHint[];
+    elementHtml: string;
+    viewportDataUrl: string;
+    elementDataUrl: string;
+};
+export type PersistedSelectionCapture = Omit<SelectionCapture, "elementHtml" | "viewportDataUrl" | "elementDataUrl"> & {
+    contextPath: string;
+    elementHtmlPath: string;
+    viewportScreenshotPath: string;
+    elementScreenshotPath: string;
+};
+export type QueuedRequest = {
+    id: string;
+    createdAt: string;
+    prompt: string;
+    context: PersistedSelectionCapture;
+};
+export type ActiveAgentRun = {
+    id: string;
+    createdAt: string;
+    prompt: string;
+    context: PersistedSelectionCapture;
+    adapter?: AdapterKind;
+    sessionId: string | null;
+    latestMessage: unknown | null;
+};

package/dist/server/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@nimrobo/wand-web",
+  "version": "0.1.0",
+  "description": "Framework-native dev inspector for web apps.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js"
+    }
+  },
+  "bin": {
+    "wand": "./dist/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/build-client.mjs",
+    "prepublishOnly": "npm run build",
+    "test": "npm run build && node --import tsx --test test/**/*.test.ts",
+    "test:next-production": "npm run build && node scripts/check-next-production.mjs"
+  },
+  "dependencies": {
+    "@nimrobo/superconnector": "^0.1.0",
+    "html-to-image": "^1.11.13"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.18",
+    "esbuild": "^0.28.0",
+    "jsdom": "^26.1.0",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "nextjs",
+    "dev-tool",
+    "inspector",
+    "overlay",
+    "wand"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nimrobo/wand-web.git"
+  },
+  "homepage": "https://github.com/Nimrobo/wand-web#readme",
+  "bugs": {
+    "url": "https://github.com/Nimrobo/wand-web/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "Apache-2.0"
+}