@vforsh/argus 0.1.2 → 0.1.4

package/dist/watchers/requestWatcher.d.ts

@@ -0,0 +1,42 @@
+import type { WatcherRecord } from '@vforsh/argus-core';
+import type { Output } from '../output/io.js';
+import type { HttpOptions } from '../httpClient.js';
+/** Input for a one-shot watcher request. */
+export type WatcherRequestInput = {
+    id?: string;
+    path: string;
+    query?: URLSearchParams;
+    method?: HttpOptions['method'];
+    body?: unknown;
+    timeoutMs?: number;
+    returnErrorResponse?: boolean;
+};
+/** Successful watcher request. */
+export type WatcherRequestSuccess<T> = {
+    ok: true;
+    watcher: WatcherRecord;
+    data: T;
+};
+/** Failed watcher request (resolve failure or transport error). */
+export type WatcherRequestError = {
+    ok: false;
+    watcher?: WatcherRecord;
+    exitCode: number;
+    message: string;
+    candidates?: WatcherRecord[];
+};
+export type WatcherRequestResult<T> = WatcherRequestSuccess<T> | WatcherRequestError;
+/**
+ * Resolve a watcher, build a URL, and fetch JSON in one call.
+ * Handles resolve failures and transport errors uniformly.
+ */
+export declare function requestWatcherJson<T>(input: WatcherRequestInput): Promise<WatcherRequestResult<T>>;
+/** Resolve a watcher or write error + candidates to output and set exitCode. Returns the watcher or `null`. */
+export declare function resolveWatcherOrExit(input: {
+    id?: string;
+}, output: Output): Promise<{
+    watcher: WatcherRecord;
+} | null>;
+/** Write a request error (including any watcher candidates) to output and set process.exitCode. */
+export declare function writeRequestError(result: WatcherRequestError, output: Output): void;
+//# sourceMappingURL=requestWatcher.d.ts.map

package/dist/watchers/requestWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestWatcher.d.ts","sourceRoot":"","sources":["../../src/watchers/requestWatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAUnD,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,GAAG;IACjC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC7B,CAAA;AAED,kCAAkC;AAClC,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;IACtC,EAAE,EAAE,IAAI,CAAA;IACR,OAAO,EAAE,aAAa,CAAA;IACtB,IAAI,EAAE,CAAC,CAAA;CACP,CAAA;AAED,mEAAmE;AACnE,MAAM,MAAM,mBAAmB,GAAG;IACjC,EAAE,EAAE,KAAK,CAAA;IACT,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,aAAa,EAAE,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAA;AAEpF;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CA+BxG;AAMD,+GAA+G;AAC/G,wBAAsB,oBAAoB,CAAC,KAAK,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,CAAA;CAAE,GAAG,IAAI,CAAC,CAO7H;AAMD,mGAAmG;AACnG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CASnF"}

package/dist/watchers/requestWatcher.js

@@ -0,0 +1,77 @@
+import { fetchJson } from '../httpClient.js';
+import { formatError } from '../cli/parse.js';
+import { formatWatcherLine } from '../output/format.js';
+import { resolveWatcher } from './resolveWatcher.js';
+/**
+ * Resolve a watcher, build a URL, and fetch JSON in one call.
+ * Handles resolve failures and transport errors uniformly.
+ */
+export async function requestWatcherJson(input) {
+    const resolved = await resolveWatcher({ id: input.id });
+    if (!resolved.ok) {
+        return {
+            ok: false,
+            exitCode: resolved.exitCode,
+            message: resolved.error,
+            candidates: resolved.candidates,
+        };
+    }
+    const { watcher } = resolved;
+    const qs = input.query?.toString();
+    const url = `http://${watcher.host}:${watcher.port}${input.path}${qs ? `?${qs}` : ''}`;
+    try {
+        const data = await fetchJson(url, {
+            method: input.method,
+            body: input.body,
+            timeoutMs: input.timeoutMs,
+            returnErrorResponse: input.returnErrorResponse,
+        });
+        return { ok: true, watcher, data };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            watcher,
+            exitCode: 1,
+            message: `${watcher.id}: failed to reach watcher (${formatError(error)})`,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Resolve-only helper (for streaming / loop commands)
+// ---------------------------------------------------------------------------
+/** Resolve a watcher or write error + candidates to output and set exitCode. Returns the watcher or `null`. */
+export async function resolveWatcherOrExit(input, output) {
+    const resolved = await resolveWatcher(input);
+    if (!resolved.ok) {
+        writeResolveError(resolved, output);
+        return null;
+    }
+    return { watcher: resolved.watcher };
+}
+// ---------------------------------------------------------------------------
+// Error output
+// ---------------------------------------------------------------------------
+/** Write a request error (including any watcher candidates) to output and set process.exitCode. */
+export function writeRequestError(result, output) {
+    output.writeWarn(result.message);
+    if (result.candidates && result.candidates.length > 0) {
+        for (const watcher of result.candidates) {
+            output.writeWarn(formatWatcherLine(watcher));
+        }
+        output.writeWarn('Hint: run `argus list` to see all watchers.');
+    }
+    process.exitCode = result.exitCode;
+}
+/** Write resolve-watcher error output. */
+function writeResolveError(resolved, output) {
+    output.writeWarn(resolved.error);
+    if (resolved.candidates && resolved.candidates.length > 0) {
+        for (const watcher of resolved.candidates) {
+            output.writeWarn(formatWatcherLine(watcher));
+        }
+        output.writeWarn('Hint: run `argus list` to see all watchers.');
+    }
+    process.exitCode = resolved.exitCode;
+}
+//# sourceMappingURL=requestWatcher.js.map

package/dist/watchers/requestWatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestWatcher.js","sourceRoot":"","sources":["../../src/watchers/requestWatcher.ts"],"names":[],"mappings":"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"}

package/dist/watchers/resolveWatcher.d.ts

@@ -0,0 +1,16 @@
+import type { RegistryV1, WatcherRecord } from '@vforsh/argus-core';
+export type ResolveWatcherInput = {
+    id?: string;
+};
+export type ResolveWatcherResult = {
+    ok: true;
+    watcher: WatcherRecord;
+    registry: RegistryV1;
+} | {
+    ok: false;
+    error: string;
+    exitCode: 1 | 2;
+    candidates?: WatcherRecord[];
+};
+export declare const resolveWatcher: (input: ResolveWatcherInput) => Promise<ResolveWatcherResult>;
+//# sourceMappingURL=resolveWatcher.d.ts.map

package/dist/watchers/resolveWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveWatcher.d.ts","sourceRoot":"","sources":["../../src/watchers/resolveWatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAKnE,MAAM,MAAM,mBAAmB,GAAG;IACjC,EAAE,CAAC,EAAE,MAAM,CAAA;CACX,CAAA;AAED,MAAM,MAAM,oBAAoB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,GAC1D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAAC,UAAU,CAAC,EAAE,aAAa,EAAE,CAAA;CAAE,CAAA;AAE9E,eAAO,MAAM,cAAc,GAAU,OAAO,mBAAmB,KAAG,OAAO,CAAC,oBAAoB,CA4C7F,CAAA"}

package/dist/watchers/resolveWatcher.js

@@ -0,0 +1,50 @@
+import { fetchJson } from '../httpClient.js';
+import { pruneRegistry } from '../registry.js';
+export const resolveWatcher = async (input) => {
+    let registry;
+    try {
+        registry = await pruneRegistry();
+    }
+    catch (error) {
+        return { ok: false, error: `Failed to load registry: ${error instanceof Error ? error.message : error}`, exitCode: 1 };
+    }
+    const watchers = Object.values(registry.watchers);
+    if (input.id) {
+        const watcher = registry.watchers[input.id];
+        if (!watcher) {
+            return { ok: false, error: `Watcher not found: ${input.id}`, exitCode: 2, candidates: watchers };
+        }
+        return { ok: true, watcher, registry };
+    }
+    if (watchers.length === 0) {
+        return { ok: false, error: 'Watcher id required.', exitCode: 2 };
+    }
+    const cwd = process.cwd();
+    const cwdMatches = watchers.filter((watcher) => watcher.cwd === cwd);
+    if (cwdMatches.length === 1) {
+        return { ok: true, watcher: cwdMatches[0], registry };
+    }
+    if (cwdMatches.length > 1) {
+        return { ok: false, error: 'Watcher id required.', exitCode: 2, candidates: cwdMatches };
+    }
+    const reachability = await Promise.all(watchers.map(async (watcher) => ({
+        watcher,
+        status: await checkWatcherStatus(watcher),
+    })));
+    const reachable = reachability.filter((entry) => entry.status.ok);
+    if (reachable.length === 1) {
+        return { ok: true, watcher: reachable[0].watcher, registry };
+    }
+    return { ok: false, error: 'Watcher id required.', exitCode: 2, candidates: watchers };
+};
+const checkWatcherStatus = async (watcher) => {
+    const url = `http://${watcher.host}:${watcher.port}/status`;
+    try {
+        const status = await fetchJson(url, { timeoutMs: 1_500 });
+        return { ok: true, status };
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    }
+};
+//# sourceMappingURL=resolveWatcher.js.map

package/dist/watchers/resolveWatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveWatcher.js","sourceRoot":"","sources":["../../src/watchers/resolveWatcher.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vforsh/argus",
-	"version": "0.1.2",
+	"version": "0.1.4",
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/vforsh/argus.git",
@@ -8,28 +8,27 @@
 	},
 	"type": "module",
 	"bin": {
-		"argus": "dist/bin.js"
-	},
-	"main": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"default": "./dist/index.js"
-		}
+		"argus": "dist/argus.js"
 	},
 	"files": [
-		"dist"
+		"dist",
+		"schemas"
 	],
 	"publishConfig": {
 		"access": "public"
 	},
 	"dependencies": {
-		"@vforsh/argus-core": "0.1.2",
 		"commander": "14.0.2"
 	},
+	"devDependencies": {
+		"@vforsh/argus-client": "workspace:*",
+		"@vforsh/argus-core": "workspace:*",
+		"@vforsh/argus-watcher": "workspace:*"
+	},
 	"scripts": {
-		"build": "tsc -b",
-		"typecheck": "tsc -b --pretty false"
+		"build": "tsc -b && bun run bundle",
+		"bundle": "bun build dist/bin.js --outfile dist/argus.js --target bun",
+		"typecheck": "tsc -b --pretty false",
+		"chrome:start": "bun src/bin.ts chrome start"
 	}
 }

package/schemas/argus.config.schema.json

@@ -0,0 +1,131 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Argus config",
+	"type": "object",
+	"additionalProperties": false,
+	"properties": {
+		"$schema": {
+			"type": "string",
+			"description": "Path or URL to the Argus config schema."
+		},
+		"chrome": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"start": {
+					"type": "object",
+					"additionalProperties": false,
+					"description": "Defaults for `argus chrome start`.",
+					"properties": {
+						"url": {
+							"type": "string",
+							"description": "URL to open in Chrome."
+						},
+						"watcherId": {
+							"type": "string",
+							"description": "Use match.url from the watcher registry."
+						},
+						"profile": {
+							"type": "string",
+							"enum": ["temp", "default-full", "default-medium", "default-lite"],
+							"description": "Profile mode: temp, default-full, default-medium, or default-lite."
+						},
+						"devTools": {
+							"type": "boolean",
+							"description": "Auto-open DevTools for new tabs."
+						}
+					},
+					"allOf": [
+						{
+							"not": {
+								"required": ["url", "watcherId"]
+							}
+						}
+					]
+				}
+			}
+		},
+		"watcher": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"start": {
+					"type": "object",
+					"additionalProperties": false,
+					"description": "Defaults for `argus watcher start`.",
+					"properties": {
+						"id": {
+							"type": "string",
+							"description": "Watcher id to announce in the registry."
+						},
+						"url": {
+							"type": "string",
+							"description": "URL pattern to match for capturing logs."
+						},
+						"chromeHost": {
+							"type": "string",
+							"description": "Chrome CDP host."
+						},
+						"chromePort": {
+							"type": "integer",
+							"minimum": 1,
+							"maximum": 65535,
+							"description": "Chrome CDP port."
+						},
+						"artifacts": {
+							"type": "string",
+							"description": "Artifacts base directory, resolved relative to the config file."
+						},
+						"pageIndicator": {
+							"type": "boolean",
+							"description": "Enable the in-page watcher indicator badge."
+						},
+						"pageConsoleLogging": {
+							"type": "string",
+							"enum": ["none", "minimal", "full"],
+							"description": "Write watcher logs to the attached page console. Default: minimal."
+						},
+						"inject": {
+							"type": "object",
+							"additionalProperties": false,
+							"description": "JavaScript injection on watcher attach.",
+							"properties": {
+								"file": {
+									"type": "string",
+									"description": "Path to JavaScript file to inject, resolved relative to config file."
+								},
+								"exposeArgus": {
+									"type": "boolean",
+									"description": "Set window.__ARGUS__ metadata before running script. Default: true."
+								}
+							},
+							"required": ["file"]
+						}
+					}
+				}
+			}
+		}
+	},
+	"examples": [
+		{
+			"$schema": "../schemas/argus.config.schema.json",
+			"chrome": {
+				"start": {
+					"url": "http://localhost:3000",
+					"profile": "default-lite",
+					"devTools": true
+				}
+			},
+			"watcher": {
+				"start": {
+					"id": "app",
+					"url": "localhost:3000",
+					"chromeHost": "127.0.0.1",
+					"chromePort": 9222,
+					"artifacts": "./artifacts",
+					"pageIndicator": true
+				}
+			}
+		}
+	]
+}