@premierstudio/ai-hooks 1.1.6 → 1.1.7

package/dist/adapters/all.d.ts

@@ -1,2 +1,120 @@
+import { a as HookEventType, H as HookDefinition } from '../hooks-CMnWrmJU.js';
 
-export {  }
+/**
+ * Capability flags indicating what a tool adapter supports.
+ * Used by the runtime to determine which hooks can be installed.
+ */
+type AdapterCapabilities = {
+    /** Tool supports native pre-execution hooks (can block). */
+    beforeHooks: boolean;
+    /** Tool supports native post-execution hooks (observe). */
+    afterHooks: boolean;
+    /** Tool supports MCP servers (fallback enforcement). */
+    mcp: boolean;
+    /** Tool supports config file generation. */
+    configFile: boolean;
+    /** Specific event types this adapter can handle. */
+    supportedEvents: HookEventType[];
+    /** Events that can be blocked (subset of supportedEvents). */
+    blockableEvents: HookEventType[];
+};
+/**
+ * The output format for a tool's native configuration.
+ * Each adapter produces this, and the CLI writes it to disk.
+ */
+type GeneratedConfig = {
+    /** Relative path where the config should be written. */
+    path: string;
+    /** File content (JSON string, TOML, YAML, etc.). */
+    content: string;
+    /** File format for display purposes. */
+    format: "json" | "toml" | "yaml" | "jsonc" | "js" | "ts";
+    /** Whether this file should be gitignored. */
+    gitignore?: boolean;
+};
+/**
+ * The adapter interface that every tool-specific package implements.
+ *
+ * Adapters translate between ai-hooks universal events and the
+ * tool's native hook/plugin system.
+ */
+interface Adapter {
+    /** Unique identifier (e.g., "claude-code", "codex", "gemini-cli"). */
+    readonly id: string;
+    /** Human-readable tool name. */
+    readonly name: string;
+    /** Tool version this adapter targets. */
+    readonly version: string;
+    /** What this adapter can do. */
+    readonly capabilities: AdapterCapabilities;
+    /**
+     * Detect if this tool is installed/available in the current environment.
+     */
+    detect(): Promise<boolean>;
+    /**
+     * Generate the tool's native config files from universal hook definitions.
+     * Returns one or more files to write to disk.
+     */
+    generate(hooks: HookDefinition[]): Promise<GeneratedConfig[]>;
+    /**
+     * Install/apply generated configs to the tool.
+     * May copy files, update settings, register MCP servers, etc.
+     */
+    install(configs: GeneratedConfig[]): Promise<void>;
+    /**
+     * Remove all ai-hooks configuration from this tool.
+     */
+    uninstall(): Promise<void>;
+    /**
+     * Map a universal event type to the tool's native event name(s).
+     */
+    mapEvent(event: HookEventType): string[];
+    /**
+     * Map a tool's native event name back to universal event type(s).
+     */
+    mapNativeEvent(nativeEvent: string): HookEventType[];
+}
+/**
+ * Factory function signature for creating an adapter.
+ */
+type AdapterFactory = (options?: Record<string, unknown>) => Adapter;
+
+/**
+ * Global adapter registry.
+ * Adapters register themselves when imported, or can be manually added.
+ */
+declare class AdapterRegistry {
+    private adapters;
+    private factories;
+    /**
+     * Register an adapter instance.
+     */
+    register(adapter: Adapter): void;
+    /**
+     * Register an adapter factory for lazy instantiation.
+     */
+    registerFactory(id: string, factory: AdapterFactory): void;
+    /**
+     * Get a registered adapter by ID.
+     */
+    get(id: string): Adapter | undefined;
+    /**
+     * Get all registered adapter IDs.
+     */
+    list(): string[];
+    /**
+     * Detect which tools are available in the current environment.
+     * Returns adapters that successfully detect their tool.
+     */
+    detectAll(): Promise<Adapter[]>;
+    /**
+     * Clear the registry. Useful for testing.
+     */
+    clear(): void;
+}
+declare global {
+    var __premierstudio_ai_hooks_registry: AdapterRegistry | undefined;
+}
+declare const registry: AdapterRegistry;
+
+export { type Adapter as A, type GeneratedConfig as G, type AdapterCapabilities as a, type AdapterFactory as b, registry as r };

package/dist/adapters/all.js

@@ -1,4 +1,4 @@
-import '../chunk-ZOWUSGNF.js';
-import '../chunk-FHFRGMW6.js';
+import '../chunk-CUPA3Z37.js';
+import '../chunk-S37FJXIJ.js';
 //# sourceMappingURL=all.js.map
 //# sourceMappingURL=all.js.map

package/dist/adapters/index.d.ts

@@ -1,2 +1,36 @@
-export { B as BaseAdapter, r as registry } from '../index-bRA_mZA5.js';
-import '../hooks-CMnWrmJU.js';
+import { A as Adapter, a as AdapterCapabilities, G as GeneratedConfig } from './all.js';
+export { r as registry } from './all.js';
+import { H as HookDefinition, a as HookEventType } from '../hooks-CMnWrmJU.js';
+
+/**
+ * Base adapter class with shared utilities.
+ * Tool-specific adapters extend this and implement the abstract methods.
+ */
+declare abstract class BaseAdapter implements Adapter {
+    abstract readonly id: string;
+    abstract readonly name: string;
+    abstract readonly version: string;
+    abstract readonly capabilities: AdapterCapabilities;
+    abstract detect(): Promise<boolean>;
+    abstract generate(hooks: HookDefinition[]): Promise<GeneratedConfig[]>;
+    abstract mapEvent(event: HookEventType): string[];
+    abstract mapNativeEvent(nativeEvent: string): HookEventType[];
+    /**
+     * Default install: write generated configs to disk.
+     */
+    install(configs: GeneratedConfig[]): Promise<void>;
+    /**
+     * Default uninstall: remove generated config files.
+     */
+    uninstall(): Promise<void>;
+    protected fileExists(path: string): Promise<boolean>;
+    protected readJsonFile<T>(path: string): Promise<T | null>;
+    protected writeJsonFile(path: string, data: unknown): Promise<void>;
+    protected removeFile(path: string): Promise<void>;
+    /**
+     * Check if a CLI command exists on PATH.
+     */
+    protected commandExists(command: string): Promise<boolean>;
+}
+
+export { BaseAdapter };

package/dist/adapters/index.js

@@ -1,3 +1,3 @@
-export { BaseAdapter, registry } from '../chunk-FHFRGMW6.js';
+export { BaseAdapter, registry } from '../chunk-S37FJXIJ.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{chunk-ZOWUSGNF.js → chunk-CUPA3Z37.js}

@@ -1,4 +1,4 @@
-import { registry, BaseAdapter } from './chunk-FHFRGMW6.js';
+import { registry, BaseAdapter } from './chunk-S37FJXIJ.js';
 import { existsSync } from 'fs';
 import { resolve } from 'path';
 import { readFile } from 'fs/promises';
@@ -1941,5 +1941,5 @@ ${hookEntries}
 };
 var adapter9 = new OpenCodeAdapter();
 registry.register(adapter9);
-//# sourceMappingURL=chunk-ZOWUSGNF.js.map
-//# sourceMappingURL=chunk-ZOWUSGNF.js.map
+//# sourceMappingURL=chunk-CUPA3Z37.js.map
+//# sourceMappingURL=chunk-CUPA3Z37.js.map