@goodfoot/claude-code-hooks 1.0.10 → 1.0.15

package/types/cli.d.ts

@@ -14,79 +14,79 @@
  * ```
  * @module
  */
-import type { HookEventName } from './inputs.js';
-import { HOOK_FACTORY_TO_EVENT } from './constants.js';
+import { HOOK_FACTORY_TO_EVENT } from "./constants.js";
+import type { HookEventName } from "./types.js";
 /**
  * Hook context determines how paths are resolved in hooks.json.
  *
  * - `plugin`: Uses `$CLAUDE_PLUGIN_ROOT` for plugin hooks
  * - `agent`: Uses `"$CLAUDE_PROJECT_DIR"` for agent hooks (.claude/hooks/)
  */
-type HookContext = 'plugin' | 'agent';
+type HookContext = "plugin" | "agent";
 /**
  * Command-line arguments parsed from process.argv.
  */
 interface CliArgs {
-  /** Glob pattern for hook source files. */
-  input: string;
-  /** Path for hooks.json output file. */
-  output: string;
-  /** Optional log file path. */
-  log?: string;
-  /** Show help. */
-  help: boolean;
-  /** Show version. */
-  version: boolean;
-  /** Directory path for scaffolding a new hook project. */
-  scaffold?: string;
-  /** Comma-separated list of hook types to generate when scaffolding. */
-  hooks?: string;
-  /** Node executable path to use in command output (default: "node"). */
-  executable?: string;
+    /** Glob pattern for hook source files. */
+    input: string;
+    /** Path for hooks.json output file. */
+    output: string;
+    /** Optional log file path. */
+    log?: string;
+    /** Show help. */
+    help: boolean;
+    /** Show version. */
+    version: boolean;
+    /** Directory path for scaffolding a new hook project. */
+    scaffold?: string;
+    /** Comma-separated list of hook types to generate when scaffolding. */
+    hooks?: string;
+    /** Node executable path to use in command output (default: "node"). */
+    executable?: string;
 }
 /**
  * Metadata extracted from a hook file via TypeScript AST analysis.
  */
 interface HookMetadata {
-  /** The hook event type (PreToolUse, SessionStart, etc.). */
-  hookEventName: HookEventName;
-  /** Optional matcher pattern from hook config. */
-  matcher?: string;
-  /** Optional timeout in milliseconds from hook config. */
-  timeout?: number;
+    /** The hook event type (PreToolUse, SessionStart, etc.). */
+    hookEventName: HookEventName;
+    /** Optional matcher pattern from hook config. */
+    matcher?: string;
+    /** Optional timeout in milliseconds from hook config. */
+    timeout?: number;
 }
 /**
  * A compiled hook with its metadata and output path.
  */
 interface CompiledHook {
-  /** Original source file path. */
-  sourcePath: string;
-  /** Compiled output file path. */
-  outputPath: string;
-  /** Output filename (e.g., "my-hook.abc123de.mjs"). */
-  outputFilename: string;
-  /** Extracted hook metadata. */
-  metadata: HookMetadata;
+    /** Original source file path. */
+    sourcePath: string;
+    /** Compiled output file path. */
+    outputPath: string;
+    /** Output filename (e.g., "my-hook.abc123de.mjs"). */
+    outputFilename: string;
+    /** Extracted hook metadata. */
+    metadata: HookMetadata;
 }
 /**
  * Individual hook configuration within a matcher group.
  */
 interface HookConfig {
-  /** Hook type - always "command" for compiled hooks. */
-  type: 'command';
-  /** Absolute path to compiled hook executable. */
-  command: string;
-  /** Optional timeout in seconds. */
-  timeout?: number;
+    /** Hook type - always "command" for compiled hooks. */
+    type: "command";
+    /** Absolute path to compiled hook executable. */
+    command: string;
+    /** Optional timeout in seconds. */
+    timeout?: number;
 }
 /**
  * Matcher group entry within an event type.
  */
 interface MatcherEntry {
-  /** Matcher pattern (tool name, regex, etc.). Optional for some event types. */
-  matcher?: string;
-  /** Array of hook configurations in this matcher group. */
-  hooks: HookConfig[];
+    /** Matcher pattern (tool name, regex, etc.). Optional for some event types. */
+    matcher?: string;
+    /** Array of hook configurations in this matcher group. */
+    hooks: HookConfig[];
 }
 /**
  * The complete hooks.json structure expected by Claude Code.
@@ -94,15 +94,15 @@ interface MatcherEntry {
  * Format: { hooks: { EventType: [ { matcher?, hooks: [...] } ] } }
  */
 interface HooksJson {
-  /** Object keyed by event type (PreToolUse, SessionStart, etc.). */
-  hooks: Partial<Record<HookEventName, MatcherEntry[]>>;
-  /** Generated file tracking metadata. */
-  __generated: {
-    /** Array of generated filenames. */
-    files: string[];
-    /** ISO timestamp of generation. */
-    timestamp: string;
-  };
+    /** Object keyed by event type (PreToolUse, SessionStart, etc.). */
+    hooks: Partial<Record<HookEventName, MatcherEntry[]>>;
+    /** Generated file tracking metadata. */
+    __generated: {
+        /** Array of generated filenames. */
+        files: string[];
+        /** ISO timestamp of generation. */
+        timestamp: string;
+    };
 }
 /**
  * Parses command-line arguments.
@@ -144,12 +144,12 @@ declare function discoverHookFiles(pattern: string, cwd: string): Promise<string
  * Options for compiling a hook.
  */
 interface CompileHookOptions {
-  /** Absolute path to source file. */
-  sourcePath: string;
-  /** Directory for compiled output. */
-  outputDir: string;
-  /** Optional log file path to inject into compiled hook. */
-  logFilePath?: string;
+    /** Absolute path to source file. */
+    sourcePath: string;
+    /** Directory for compiled output. */
+    outputDir: string;
+    /** Optional log file path to inject into compiled hook. */
+    logFilePath?: string;
 }
 /**
  * Compiles a TypeScript hook file to a self-contained ESM executable.
@@ -171,17 +171,15 @@ declare function generateContentHash(content: string): string;
  * @param compiledHooks - Array of compiled hooks
  * @returns Nested map: EventType -> Matcher -> Hooks
  */
-declare function groupHooksByEventAndMatcher(
-  compiledHooks: CompiledHook[]
-): Map<HookEventName, Map<string | undefined, CompiledHook[]>>;
+declare function groupHooksByEventAndMatcher(compiledHooks: CompiledHook[]): Map<HookEventName, Map<string | undefined, CompiledHook[]>>;
 /**
  * Result of detecting the hook context, including the root directory.
  */
 interface HookContextInfo {
-  /** Hook context type. */
-  context: HookContext;
-  /** Absolute path to the root directory (plugin root or project root). */
-  rootDir: string;
+    /** Hook context type. */
+    context: HookContext;
+    /** Absolute path to the root directory (plugin root or project root). */
+    rootDir: string;
 }
 /**
  * Auto-detects the hook context and root directory based on directory structure.
@@ -208,12 +206,7 @@ declare function detectHookContext(outputPath: string): HookContextInfo;
  * @param executable - Node executable path (default: "node")
  * @returns The command path string
  */
-declare function generateCommandPath(
-  filename: string,
-  buildDir: string,
-  contextInfo: HookContextInfo,
-  executable?: string
-): string;
+declare function generateCommandPath(filename: string, buildDir: string, contextInfo: HookContextInfo, executable?: string): string;
 /**
  * Generates the hooks.json content in Claude Code's expected format.
  *
@@ -224,12 +217,7 @@ declare function generateCommandPath(
  * @param executable - Node executable path (default: "node")
  * @returns The hooks.json structure
  */
-declare function generateHooksJson(
-  compiledHooks: CompiledHook[],
-  buildDir: string,
-  contextInfo: HookContextInfo,
-  executable?: string
-): HooksJson;
+declare function generateHooksJson(compiledHooks: CompiledHook[], buildDir: string, contextInfo: HookContextInfo, executable?: string): HooksJson;
 /**
  * Reads an existing hooks.json file if it exists.
  * @param outputPath - Path to the hooks.json file
@@ -257,25 +245,6 @@ declare function extractPreservedHooks(existingHooksJson: HooksJson): Partial<Re
  * @param preservedHooks - Hooks to preserve from the existing hooks.json
  * @returns Merged HooksJson
  */
-declare function mergeHooksJson(
-  newHooksJson: HooksJson,
-  preservedHooks: Partial<Record<HookEventName, MatcherEntry[]>>
-): HooksJson;
-export {
-  parseArgs,
-  validateArgs,
-  analyzeHookFile,
-  discoverHookFiles,
-  compileHook,
-  generateContentHash,
-  detectHookContext,
-  generateCommandPath,
-  generateHooksJson,
-  groupHooksByEventAndMatcher,
-  readExistingHooksJson,
-  removeOldGeneratedFiles,
-  extractPreservedHooks,
-  mergeHooksJson,
-  HOOK_FACTORY_TO_EVENT
-};
+declare function mergeHooksJson(newHooksJson: HooksJson, preservedHooks: Partial<Record<HookEventName, MatcherEntry[]>>): HooksJson;
+export { parseArgs, validateArgs, analyzeHookFile, discoverHookFiles, compileHook, generateContentHash, detectHookContext, generateCommandPath, generateHooksJson, groupHooksByEventAndMatcher, readExistingHooksJson, removeOldGeneratedFiles, extractPreservedHooks, mergeHooksJson, HOOK_FACTORY_TO_EVENT, };
 export type { CliArgs, HookMetadata, CompiledHook, HookConfig, MatcherEntry, HooksJson };

package/types/constants.d.ts

@@ -2,7 +2,7 @@
  * Shared constants for the CLI and scaffold modules.
  * @module
  */
-import type { HookEventName } from './inputs.js';
+import type { HookEventName } from "./types.js";
 /**
  * Maps hook factory function names to their event names.
  */

package/types/env.d.ts

@@ -38,22 +38,22 @@
  * These are the environment variables that Claude Code sets when running hooks.
  */
 export declare const CLAUDE_ENV_VARS: {
-  /**
-   * Absolute path to the project root directory where Claude Code was started.
-   * Available in all hooks.
-   */
-  readonly PROJECT_DIR: 'CLAUDE_PROJECT_DIR';
-  /**
-   * Path to a file where SessionStart hooks can persist environment variables.
-   * Variables written to this file will be available in all subsequent bash commands.
-   * Only available in SessionStart hooks.
-   */
-  readonly ENV_FILE: 'CLAUDE_ENV_FILE';
-  /**
-   * Set to "true" when running in a remote (web) environment.
-   * Not set or empty when running in local CLI environment.
-   */
-  readonly REMOTE: 'CLAUDE_CODE_REMOTE';
+    /**
+     * Absolute path to the project root directory where Claude Code was started.
+     * Available in all hooks.
+     */
+    readonly PROJECT_DIR: "CLAUDE_PROJECT_DIR";
+    /**
+     * Path to a file where SessionStart hooks can persist environment variables.
+     * Variables written to this file will be available in all subsequent bash commands.
+     * Only available in SessionStart hooks.
+     */
+    readonly ENV_FILE: "CLAUDE_ENV_FILE";
+    /**
+     * Set to "true" when running in a remote (web) environment.
+     * Not set or empty when running in local CLI environment.
+     */
+    readonly REMOTE: "CLAUDE_CODE_REMOTE";
 };
 /**
  * Gets the Claude Code project directory.