@goodfoot/claude-code-hooks 1.0.10 → 1.0.15

package/dist/outputs.js

@@ -20,12 +20,12 @@
  * | 2 | Block | Handler throws OR `stopReason` set | Blocking, stderr shown to Claude |
  */
 export const EXIT_CODES = {
-  /** Handler completed successfully. Claude Code parses stdout as JSON. */
-  SUCCESS: 0,
-  /** Non-blocking error occurred (e.g., invalid input). stderr shown to user only. */
-  ERROR: 1,
-  /** Handler threw exception OR blocking action requested. stderr shown to Claude. */
-  BLOCK: 2
+    /** Handler completed successfully. Claude Code parses stdout as JSON. */
+    SUCCESS: 0,
+    /** Non-blocking error occurred (e.g., invalid input). stderr shown to user only. */
+    ERROR: 1,
+    /** Handler threw exception OR blocking action requested. stderr shown to Claude. */
+    BLOCK: 2,
 };
 // ============================================================================
 // Output Builder Factories
@@ -37,14 +37,13 @@ export const EXIT_CODES = {
  * @internal
  */
 function createHookSpecificOutputBuilder(hookType) {
-  return (options = {}) => {
-    const { hookSpecificOutput, ...rest } = options;
-    const stdout =
-      hookSpecificOutput !== undefined
-        ? { ...rest, hookSpecificOutput: { hookEventName: hookType, ...hookSpecificOutput } }
-        : rest;
-    return { _type: hookType, stdout };
-  };
+    return (options = {}) => {
+        const { hookSpecificOutput, ...rest } = options;
+        const stdout = hookSpecificOutput !== undefined
+            ? { ...rest, hookSpecificOutput: { hookEventName: hookType, ...hookSpecificOutput } }
+            : rest;
+        return { _type: hookType, stdout };
+    };
 }
 /**
  * Factory for hooks that only use CommonOptions (simple passthrough).
@@ -53,10 +52,10 @@ function createHookSpecificOutputBuilder(hookType) {
  * @internal
  */
 function createSimpleOutputBuilder(hookType) {
-  return (options = {}) => ({
-    _type: hookType,
-    stdout: options
-  });
+    return (options = {}) => ({
+        _type: hookType,
+        stdout: options,
+    });
 }
 /**
  * Factory for hooks that use decision-based options (Stop, SubagentStop).
@@ -65,10 +64,10 @@ function createSimpleOutputBuilder(hookType) {
  * @internal
  */
 function createDecisionOutputBuilder(hookType) {
-  return (options = {}) => ({
-    _type: hookType,
-    stdout: options
-  });
+    return (options = {}) => ({
+        _type: hookType,
+        stdout: options,
+    });
 }
 /**
  * Creates an output for PreToolUse hooks.
@@ -98,7 +97,7 @@ function createDecisionOutputBuilder(hookType) {
  * });
  * ```
  */
-export const preToolUseOutput = /* @__PURE__ */ createHookSpecificOutputBuilder('PreToolUse');
+export const preToolUseOutput = /* @__PURE__ */ createHookSpecificOutputBuilder("PreToolUse");
 /**
  * Creates an output for PostToolUse hooks.
  * @param options - Configuration options for the hook output
@@ -113,7 +112,7 @@ export const preToolUseOutput = /* @__PURE__ */ createHookSpecificOutputBuilder(
  * });
  * ```
  */
-export const postToolUseOutput = /* @__PURE__ */ createHookSpecificOutputBuilder('PostToolUse');
+export const postToolUseOutput = /* @__PURE__ */ createHookSpecificOutputBuilder("PostToolUse");
 /**
  * Creates an output for PostToolUseFailure hooks.
  * @param options - Configuration options for the hook output
@@ -127,7 +126,7 @@ export const postToolUseOutput = /* @__PURE__ */ createHookSpecificOutputBuilder
  * });
  * ```
  */
-export const postToolUseFailureOutput = /* @__PURE__ */ createHookSpecificOutputBuilder('PostToolUseFailure');
+export const postToolUseFailureOutput = /* @__PURE__ */ createHookSpecificOutputBuilder("PostToolUseFailure");
 /**
  * Creates an output for UserPromptSubmit hooks.
  * @param options - Configuration options for the hook output
@@ -141,7 +140,7 @@ export const postToolUseFailureOutput = /* @__PURE__ */ createHookSpecificOutput
  * });
  * ```
  */
-export const userPromptSubmitOutput = /* @__PURE__ */ createHookSpecificOutputBuilder('UserPromptSubmit');
+export const userPromptSubmitOutput = /* @__PURE__ */ createHookSpecificOutputBuilder("UserPromptSubmit");
 /**
  * Creates an output for SessionStart hooks.
  * @param options - Configuration options for the hook output
@@ -155,7 +154,7 @@ export const userPromptSubmitOutput = /* @__PURE__ */ createHookSpecificOutputBu
  * });
  * ```
  */
-export const sessionStartOutput = /* @__PURE__ */ createHookSpecificOutputBuilder('SessionStart');
+export const sessionStartOutput = /* @__PURE__ */ createHookSpecificOutputBuilder("SessionStart");
 /**
  * Creates an output for SessionEnd hooks.
  * @param options - Configuration options for the hook output
@@ -165,7 +164,7 @@ export const sessionStartOutput = /* @__PURE__ */ createHookSpecificOutputBuilde
  * sessionEndOutput({});
  * ```
  */
-export const sessionEndOutput = /* @__PURE__ */ createSimpleOutputBuilder('SessionEnd');
+export const sessionEndOutput = /* @__PURE__ */ createSimpleOutputBuilder("SessionEnd");
 /**
  * Creates an output for Stop hooks.
  * @param options - Configuration options for the hook output
@@ -182,7 +181,7 @@ export const sessionEndOutput = /* @__PURE__ */ createSimpleOutputBuilder('Sessi
  * });
  * ```
  */
-export const stopOutput = /* @__PURE__ */ createDecisionOutputBuilder('Stop');
+export const stopOutput = /* @__PURE__ */ createDecisionOutputBuilder("Stop");
 /**
  * Creates an output for SubagentStart hooks.
  * @param options - Configuration options for the hook output
@@ -196,7 +195,7 @@ export const stopOutput = /* @__PURE__ */ createDecisionOutputBuilder('Stop');
  * });
  * ```
  */
-export const subagentStartOutput = /* @__PURE__ */ createHookSpecificOutputBuilder('SubagentStart');
+export const subagentStartOutput = /* @__PURE__ */ createHookSpecificOutputBuilder("SubagentStart");
 /**
  * Creates an output for SubagentStop hooks.
  * @param options - Configuration options for the hook output
@@ -210,7 +209,7 @@ export const subagentStartOutput = /* @__PURE__ */ createHookSpecificOutputBuild
  * });
  * ```
  */
-export const subagentStopOutput = /* @__PURE__ */ createDecisionOutputBuilder('SubagentStop');
+export const subagentStopOutput = /* @__PURE__ */ createDecisionOutputBuilder("SubagentStop");
 /**
  * Creates an output for Notification hooks.
  * @param options - Configuration options for the hook output
@@ -228,7 +227,7 @@ export const subagentStopOutput = /* @__PURE__ */ createDecisionOutputBuilder('S
  * notificationOutput({ suppressOutput: true });
  * ```
  */
-export const notificationOutput = /* @__PURE__ */ createHookSpecificOutputBuilder('Notification');
+export const notificationOutput = /* @__PURE__ */ createHookSpecificOutputBuilder("Notification");
 /**
  * Creates an output for PreCompact hooks.
  * @param options - Configuration options for the hook output
@@ -240,7 +239,7 @@ export const notificationOutput = /* @__PURE__ */ createHookSpecificOutputBuilde
  * });
  * ```
  */
-export const preCompactOutput = /* @__PURE__ */ createSimpleOutputBuilder('PreCompact');
+export const preCompactOutput = /* @__PURE__ */ createSimpleOutputBuilder("PreCompact");
 /**
  * Creates an output for PermissionRequest hooks.
  * @param options - Configuration options for the hook output
@@ -279,4 +278,22 @@ export const preCompactOutput = /* @__PURE__ */ createSimpleOutputBuilder('PreCo
  * permissionRequestOutput({});
  * ```
  */
-export const permissionRequestOutput = /* @__PURE__ */ createHookSpecificOutputBuilder('PermissionRequest');
+export const permissionRequestOutput = /* @__PURE__ */ createHookSpecificOutputBuilder("PermissionRequest");
+/**
+ * Creates an output for Setup hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A SetupOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * // Add context during setup
+ * setupOutput({
+ *   hookSpecificOutput: {
+ *     additionalContext: 'Project initialized with custom settings'
+ *   }
+ * });
+ *
+ * // Simple passthrough
+ * setupOutput({});
+ * ```
+ */
+export const setupOutput = /* @__PURE__ */ createHookSpecificOutputBuilder("Setup");

package/dist/runtime.js

@@ -18,9 +18,9 @@
  * ```
  * @see https://code.claude.com/docs/en/hooks
  */
-import { persistEnvVar, persistEnvVars } from './env.js';
-import { logger } from './logger.js';
-import { EXIT_CODES } from './outputs.js';
+import { persistEnvVar, persistEnvVars } from "./env.js";
+import { logger } from "./logger.js";
+import { EXIT_CODES } from "./outputs.js";
 // ============================================================================
 // Stdin/Stdout Handling
 // ============================================================================
@@ -29,20 +29,20 @@ import { EXIT_CODES } from './outputs.js';
  * @returns Promise resolving to the complete stdin content
  */
 async function readStdin() {
-  return new Promise((resolve, reject) => {
-    const chunks = [];
-    // Set encoding first to ensure data events receive strings
-    process.stdin.setEncoding('utf-8');
-    process.stdin.on('data', (chunk) => {
-      chunks.push(chunk);
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        // Set encoding first to ensure data events receive strings
+        process.stdin.setEncoding("utf-8");
+        process.stdin.on("data", (chunk) => {
+            chunks.push(chunk);
+        });
+        process.stdin.on("end", () => {
+            resolve(chunks.join(""));
+        });
+        process.stdin.on("error", (error) => {
+            reject(error);
+        });
     });
-    process.stdin.on('end', () => {
-      resolve(chunks.join(''));
-    });
-    process.stdin.on('error', (error) => {
-      reject(error);
-    });
-  });
 }
 /**
  * Parses stdin JSON input.
@@ -51,9 +51,9 @@ async function readStdin() {
  * @throws Error if JSON is malformed
  */
 function parseStdinInput(stdinContent) {
-  // Parse JSON - input uses wire format (snake_case) directly
-  const rawInput = JSON.parse(stdinContent);
-  return rawInput;
+    // Parse JSON - input uses wire format (snake_case) directly
+    const rawInput = JSON.parse(stdinContent);
+    return rawInput;
 }
 /**
  * Writes hook output to stdout.
@@ -63,8 +63,8 @@ function parseStdinInput(stdinContent) {
  * @see https://code.claude.com/docs/en/hooks#hook-output-structure
  */
 function writeStdout(output) {
-  // Output uses camelCase - no transformation needed
-  process.stdout.write(JSON.stringify(output));
+    // Output uses camelCase - no transformation needed
+    process.stdout.write(JSON.stringify(output));
 }
 // ============================================================================
 // Error Handling
@@ -75,8 +75,8 @@ function writeStdout(output) {
  * @returns HookOutput with empty stdout
  */
 function createMalformedInputOutput(error) {
-  logger.error(`Invalid JSON input: ${error instanceof Error ? error.message : String(error)}`);
-  return { stdout: {} };
+    logger.error(`Invalid JSON input: ${error instanceof Error ? error.message : String(error)}`);
+    return { stdout: {} };
 }
 /**
  * Writes handler error stacktrace to stderr and exits with code 2.
@@ -88,19 +88,20 @@ function createMalformedInputOutput(error) {
  * @param error - The error thrown by the handler
  */
 function handleHandlerError(error) {
-  // Write stack trace to stderr (sourcemaps are applied automatically by Node.js)
-  if (error instanceof Error) {
-    process.stderr.write(`${error.stack ?? error.message}\n`);
-  } else {
-    process.stderr.write(`${String(error)}\n`);
-  }
-  // Log to file if configured
-  logger.error(`Hook handler error: ${error instanceof Error ? error.message : String(error)}`);
-  // Clear logger context and close
-  logger.clearContext();
-  logger.close();
-  // Exit with code 2 (BLOCK) - no JSON output
-  process.exit(EXIT_CODES.BLOCK);
+    // Write stack trace to stderr (sourcemaps are applied automatically by Node.js)
+    if (error instanceof Error) {
+        process.stderr.write(`${error.stack ?? error.message}\n`);
+    }
+    else {
+        process.stderr.write(`${String(error)}\n`);
+    }
+    // Log to file if configured
+    logger.error(`Hook handler error: ${error instanceof Error ? error.message : String(error)}`);
+    // Clear logger context and close
+    logger.clearContext();
+    logger.close();
+    // Exit with code 2 (BLOCK) - no JSON output
+    process.exit(EXIT_CODES.BLOCK);
 }
 /**
  * Converts a SpecificHookOutput to HookOutput for wire format.
@@ -121,7 +122,7 @@ function handleHandlerError(error) {
  * ```
  */
 export function convertToHookOutput(specificOutput) {
-  return { stdout: specificOutput.stdout };
+    return { stdout: specificOutput.stdout };
 }
 // ============================================================================
 // Execute Function
@@ -157,66 +158,68 @@ export function convertToHookOutput(specificOutput) {
  * @see https://code.claude.com/docs/en/hooks
  */
 export async function execute(hookFn) {
-  let output;
-  try {
-    // Check for log file configuration conflicts
-    // CLAUDE_CODE_HOOKS_CLI_LOG_FILE is injected by the CLI --log parameter
-    // CLAUDE_CODE_HOOKS_LOG_FILE is the user's environment variable
-    const cliLogFile = process.env['CLAUDE_CODE_HOOKS_CLI_LOG_FILE'];
-    const envLogFile = process.env['CLAUDE_CODE_HOOKS_LOG_FILE'];
-    if (cliLogFile !== undefined && envLogFile !== undefined && cliLogFile !== envLogFile) {
-      // Write error to stderr and exit with error code
-      process.stderr.write(
-        `Log file configuration conflict: CLI --log="${cliLogFile}" vs CLAUDE_CODE_HOOKS_LOG_FILE="${envLogFile}". ` +
-          'Use only one method to configure hook logging.\n'
-      );
-      process.exit(EXIT_CODES.ERROR);
-    }
-    // If CLI log file is set, configure the logger
-    if (cliLogFile !== undefined) {
-      logger.setLogFile(cliLogFile);
-    }
-    // Read and parse stdin
-    let stdinContent;
-    try {
-      stdinContent = await readStdin();
-    } catch (error) {
-      logger.logError(error, 'Failed to read stdin');
-      output = createMalformedInputOutput(error);
-      return;
-    }
-    // Parse and transform input
-    let input;
+    let output;
     try {
-      input = parseStdinInput(stdinContent);
-    } catch (error) {
-      logger.logError(error, 'Failed to parse stdin JSON');
-      output = createMalformedInputOutput(error);
-      return;
+        // Check for log file configuration conflicts
+        // CLAUDE_CODE_HOOKS_CLI_LOG_FILE is injected by the CLI --log parameter
+        // CLAUDE_CODE_HOOKS_LOG_FILE is the user's environment variable
+        const cliLogFile = process.env.CLAUDE_CODE_HOOKS_CLI_LOG_FILE;
+        const envLogFile = process.env.CLAUDE_CODE_HOOKS_LOG_FILE;
+        if (cliLogFile !== undefined && envLogFile !== undefined && cliLogFile !== envLogFile) {
+            // Write error to stderr and exit with error code
+            process.stderr.write(`Log file configuration conflict: CLI --log="${cliLogFile}" vs CLAUDE_CODE_HOOKS_LOG_FILE="${envLogFile}". ` +
+                "Use only one method to configure hook logging.\n");
+            process.exit(EXIT_CODES.ERROR);
+        }
+        // If CLI log file is set, configure the logger
+        if (cliLogFile !== undefined) {
+            logger.setLogFile(cliLogFile);
+        }
+        // Read and parse stdin
+        let stdinContent;
+        try {
+            stdinContent = await readStdin();
+        }
+        catch (error) {
+            logger.logError(error, "Failed to read stdin");
+            output = createMalformedInputOutput(error);
+            return;
+        }
+        // Parse and transform input
+        let input;
+        try {
+            input = parseStdinInput(stdinContent);
+        }
+        catch (error) {
+            logger.logError(error, "Failed to parse stdin JSON");
+            output = createMalformedInputOutput(error);
+            return;
+        }
+        // Set logger context
+        const hookEventName = hookFn.hookEventName;
+        logger.setContext(hookEventName, input);
+        // Build context - SessionStart hooks get extended context with persistEnvVar
+        const context = hookEventName === "SessionStart" ? { logger, persistEnvVar, persistEnvVars } : { logger };
+        // Execute handler
+        try {
+            const specificOutput = await hookFn(input, context);
+            output = convertToHookOutput(specificOutput);
+        }
+        catch (error) {
+            // Handler threw - output stacktrace to stderr and exit with code 2
+            // This call never returns (process.exit)
+            handleHandlerError(error);
+        }
     }
-    // Set logger context
-    const hookEventName = hookFn.hookEventName;
-    logger.setContext(hookEventName, input);
-    // Build context - SessionStart hooks get extended context with persistEnvVar
-    const context = hookEventName === 'SessionStart' ? { logger, persistEnvVar, persistEnvVars } : { logger };
-    // Execute handler
-    try {
-      const specificOutput = await hookFn(input, context);
-      output = convertToHookOutput(specificOutput);
-    } catch (error) {
-      // Handler threw - output stacktrace to stderr and exit with code 2
-      // This call never returns (process.exit)
-      handleHandlerError(error);
+    finally {
+        // Write output if we have it
+        if (output !== undefined) {
+            writeStdout(output.stdout);
+        }
+        // Clear logger context
+        logger.clearContext();
+        logger.close();
+        // Exit with success (handler errors exit via handleHandlerError with code 2)
+        process.exit(EXIT_CODES.SUCCESS);
     }
-  } finally {
-    // Write output if we have it
-    if (output !== undefined) {
-      writeStdout(output.stdout);
-    }
-    // Clear logger context
-    logger.clearContext();
-    logger.close();
-    // Exit with success (handler errors exit via handleHandlerError with code 2)
-    process.exit(EXIT_CODES.SUCCESS);
-  }
 }