@hasna/hooks 0.2.20 → 0.3.0

package/dist/lib/installer.d.ts

@@ -2,14 +2,18 @@
  * Hook installer - registers hooks in AI coding agent settings
  *
  * Supports:
- * - Claude Code: ~/.claude/settings.json (PreToolUse, PostToolUse, Stop, Notification)
- * - Gemini CLI: ~/.gemini/settings.json (BeforeTool, AfterTool, AfterAgent, Notification)
+ * - Claude Code: ~/.claude/settings.json (PreToolUse, PostToolUse, Stop, Notification, SessionStart, SessionEnd)
+ * - Gemini CLI: ~/.gemini/settings.json (BeforeTool, AfterTool, AfterAgent, Notification — no session events)
+ * - Codewith: emits TOML fragments by default; direct writes require explicit opt-in
  *
  * Hooks run directly from the globally installed @hasna/hooks package.
  * No files are copied. The settings entry points to `hooks run <name>`.
  */
+import type { HookEvent } from "./registry.js";
 export type Scope = "global" | "project";
-export type Target = "claude" | "gemini" | "all";
+export type Target = "claude" | "gemini" | "codewith" | "all";
+type SingleTarget = Exclude<Target, "all">;
+export type CodewithInstallMode = "fragment" | "write";
 export interface InstallResult {
     hook: string;
     success: boolean;
@@ -17,20 +21,36 @@ export interface InstallResult {
     scope?: Scope;
     target?: Target;
     conflict?: string;
+    fragment?: string;
+    applied?: boolean;
+    note?: string;
+    configPath?: string;
 }
 export interface InstallOptions {
     scope?: Scope;
     overwrite?: boolean;
     target?: Target;
     profile?: string;
+    /**
+     * Codewith installs default to "fragment" so @hasna/hooks does not blindly
+     * mutate managed ~/.codewith/config.toml. Use "write" only with an explicit
+     * config path or in tests/local experiments.
+     */
+    codewithMode?: CodewithInstallMode;
+    /** Explicit Codewith config path for the direct-write mode and tests. */
+    codewithConfigPath?: string;
 }
-export declare function getSettingsPath(scope?: Scope, target?: "claude" | "gemini"): string;
+export declare function getSettingsPath(scope?: Scope, target?: SingleTarget, codewithConfigPath?: string): string;
 export declare function getHookPath(name: string): string;
 export declare function hookExists(name: string): boolean;
+/** Whether a hook's event can be registered for the given target */
+export declare function isEventSupported(internalEvent: HookEvent, target: SingleTarget): boolean;
+export declare function buildCodewithTomlFragment(name: string, profile?: string): string;
 export declare function installHook(name: string, options?: InstallOptions): InstallResult;
 export declare function installHooks(names: string[], options?: InstallOptions): InstallResult[];
-export declare function getRegisteredHooksForTarget(scope?: Scope, target?: "claude" | "gemini"): string[];
+export declare function getRegisteredHooksForTarget(scope?: Scope, target?: SingleTarget): string[];
 export declare function getRegisteredHooks(scope?: Scope): string[];
 /** @deprecated Use getRegisteredHooks instead */
 export declare const getInstalledHooks: typeof getRegisteredHooks;
 export declare function removeHook(name: string, scope?: Scope, target?: Target): boolean;
+export {};

package/dist/lib/registry.d.ts

@@ -1,13 +1,15 @@
 /**
  * Hook registry - metadata about all available hooks
  */
+export type HookEvent = "PreToolUse" | "PostToolUse" | "Stop" | "Notification" | "SessionStart" | "SessionEnd" | "UserPromptSubmit";
+export declare const HOOK_EVENTS: HookEvent[];
 export interface HookMeta {
     name: string;
     displayName: string;
     description: string;
     version: string;
     category: string;
-    event: "PreToolUse" | "PostToolUse" | "Stop" | "Notification";
+    event: HookEvent;
     matcher: string;
     tags: string[];
 }

package/dist/storage.d.ts

@@ -0,0 +1,4 @@
+export { HOOKS_STORAGE_ENV, HOOKS_STORAGE_FALLBACK_ENV, HOOKS_STORAGE_MODE_ENV, HOOKS_STORAGE_MODE_FALLBACK_ENV, HOOKS_STORAGE_TABLES, STORAGE_DATABASE_ENV, STORAGE_MODE_ENV, STORAGE_TABLES, getStorageDatabaseEnv, getStorageDatabaseEnvName, getStorageDatabaseUrl, getStorageMode, getStoragePg, getStorageStatus, getSyncMetaAll, parseStorageTables, resolveTables, runStorageMigrations, storagePull, storagePush, storageSync, } from "./db/storage-sync.js";
+export type { StorageEnv, StorageMode, StorageStatus, SyncMeta, SyncResult } from "./db/storage-sync.js";
+export { PgAdapterAsync } from "./db/remote-storage.js";
+export { PG_MIGRATIONS } from "./db/pg-migrations.js";