aem-ext-daemon 0.3.7 → 0.3.9

package/dist/daemon.js

@@ -17,6 +17,7 @@ import { DaemonConnection } from "./connection.js";
 import { ensureIdentity, getWorkspaceRoot, setWorkspaceRoot } from "./identity.js";
 import { generatePairCode, displayPairCode } from "./pairing.js";
 import { dispatch } from "./dispatcher.js";
+import { getLogFilePath } from "./logger.js";
 // Read version from package.json so it stays in sync automatically
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const pkgPath = path.resolve(__dirname, "..", "package.json");
@@ -57,6 +58,7 @@ export class Daemon {
         if (workspace) {
             console.log(`  Workspace:  ${workspace}`);
         }
+        console.log(`  Log file:   ${getLogFilePath()}`);
         console.log("");
         console.log("  Connecting...");
         this.connection.connect();

package/dist/dispatcher.js

@@ -6,6 +6,7 @@
  */
 import path from "node:path";
 import { getWorkspaceRoot, setWorkspaceRoot } from "./identity.js";
+import { logCommand, logResult, logError } from "./logger.js";
 import * as fsCap from "./capabilities/fs.js";
 import * as gitCap from "./capabilities/git.js";
 import * as shellCap from "./capabilities/shell.js";
@@ -29,6 +30,21 @@ function validatePath(targetPath) {
  * Dispatch a command to the appropriate capability handler.
  */
 export async function dispatch(command, payload, connection) {
+    logCommand(command, payload);
+    const start = Date.now();
+    try {
+        const result = await dispatchInner(command, payload, connection);
+        const resultStr = typeof result === "string" ? result : JSON.stringify(result);
+        logResult(command, resultStr, Date.now() - start);
+        return result;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logError(command, message, Date.now() - start);
+        throw err;
+    }
+}
+async function dispatchInner(command, payload, connection) {
     switch (command) {
         // ─── Filesystem ─────────────────────────────────────
         case "fs:roots": {

package/dist/logger.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Daemon logger — writes timestamped entries to a log file and the terminal.
+ *
+ * Log file: ~/.adobe-ext-builder/daemon.log (always available, regardless of workspace config)
+ */
+/** Log a command being dispatched. */
+export declare function logCommand(command: string, payload: Record<string, unknown>): void;
+/** Log a command result (success). */
+export declare function logResult(command: string, result: string, durationMs: number): void;
+/** Log a command error. */
+export declare function logError(command: string, error: string, durationMs: number): void;
+/** Log a general info message. */
+export declare function logInfo(message: string): void;
+/** Return the log file path for display purposes. */
+export declare function getLogFilePath(): string;

package/dist/logger.js

@@ -0,0 +1,60 @@
+/**
+ * Daemon logger — writes timestamped entries to a log file and the terminal.
+ *
+ * Log file: ~/.adobe-ext-builder/daemon.log (always available, regardless of workspace config)
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const LOG_DIR = path.join(os.homedir(), ".adobe-ext-builder");
+const LOG_PATH = path.join(LOG_DIR, "daemon.log");
+let logStream = null;
+function ensureStream() {
+    if (!logStream) {
+        try {
+            fs.mkdirSync(LOG_DIR, { recursive: true });
+            logStream = fs.createWriteStream(LOG_PATH, { flags: "a" });
+        }
+        catch {
+            return null;
+        }
+    }
+    return logStream;
+}
+function ts() {
+    return new Date().toISOString();
+}
+/** Log a command being dispatched. */
+export function logCommand(command, payload) {
+    const line = `[${ts()}] CMD  ${command}  ${JSON.stringify(payload)}`;
+    const stream = ensureStream();
+    stream?.write(line + "\n");
+    console.log(`  ▶  ${command}`);
+}
+/** Log a command result (success). */
+export function logResult(command, result, durationMs) {
+    const preview = result.length > 500 ? result.slice(0, 500) + "..." : result;
+    const line = `[${ts()}] OK   ${command}  (${durationMs}ms)  ${preview}`;
+    const stream = ensureStream();
+    stream?.write(line + "\n");
+    console.log(`  ✓  ${command} (${durationMs}ms)`);
+}
+/** Log a command error. */
+export function logError(command, error, durationMs) {
+    const line = `[${ts()}] ERR  ${command}  (${durationMs}ms)  ${error}`;
+    const stream = ensureStream();
+    stream?.write(line + "\n");
+    // Print the FULL error to the terminal so users can diagnose issues
+    console.log(`  ✗  ${command} (${durationMs}ms)`);
+    console.log(`     Error: ${error}`);
+}
+/** Log a general info message. */
+export function logInfo(message) {
+    const line = `[${ts()}] INFO ${message}`;
+    const stream = ensureStream();
+    stream?.write(line + "\n");
+}
+/** Return the log file path for display purposes. */
+export function getLogFilePath() {
+    return LOG_PATH;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aem-ext-daemon",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "Local daemon for AEM Extension Builder — connects your machine to the cloud UI",
   "type": "module",
   "bin": {