@vorionsys/a3i 0.1.0

package/dist/hooks/manager.js

@@ -0,0 +1,267 @@
+/**
+ * Hook Manager - High-level API for the hook system
+ *
+ * Provides a unified interface for registering and executing hooks.
+ */
+import { HookPhase, } from './types.js';
+import { createHookRegistry, } from './registry.js';
+import { createHookExecutor, successResult, abortResult, errorResult, } from './executor.js';
+/**
+ * HookManager - High-level hook management API
+ */
+export class HookManager {
+    registry;
+    executor;
+    config;
+    constructor(config = {}) {
+        this.registry = config.registry ?? createHookRegistry();
+        this.executor = createHookExecutor(this.registry);
+        this.config = {
+            registry: this.registry,
+            defaultExecutionOptions: config.defaultExecutionOptions ?? {},
+            enableLogging: config.enableLogging ?? false,
+        };
+    }
+    // ============================================================
+    // Hook Registration - Type-safe methods for each phase
+    // ============================================================
+    /**
+     * Register a pre-authorize hook
+     */
+    onPreAuthorize(name, handler, options) {
+        return this.registry.register({
+            name,
+            phase: HookPhase.PRE_AUTHORIZE,
+            handler,
+            ...options,
+        });
+    }
+    /**
+     * Register a post-authorize hook
+     */
+    onPostAuthorize(name, handler, options) {
+        return this.registry.register({
+            name,
+            phase: HookPhase.POST_AUTHORIZE,
+            handler,
+            ...options,
+        });
+    }
+    /**
+     * Register a pre-execute hook
+     */
+    onPreExecute(name, handler, options) {
+        return this.registry.register({
+            name,
+            phase: HookPhase.PRE_EXECUTE,
+            handler,
+            ...options,
+        });
+    }
+    /**
+     * Register a post-execute hook
+     */
+    onPostExecute(name, handler, options) {
+        return this.registry.register({
+            name,
+            phase: HookPhase.POST_EXECUTE,
+            handler,
+            ...options,
+        });
+    }
+    /**
+     * Register an execution-failed hook
+     */
+    onExecutionFailed(name, handler, options) {
+        return this.registry.register({
+            name,
+            phase: HookPhase.EXECUTION_FAILED,
+            handler,
+            ...options,
+        });
+    }
+    /**
+     * Register a trust-change hook
+     */
+    onTrustChange(name, handler, options) {
+        return this.registry.register({
+            name,
+            phase: HookPhase.TRUST_CHANGE,
+            handler,
+            ...options,
+        });
+    }
+    /**
+     * Register a trust-violation hook
+     */
+    onTrustViolation(name, handler, options) {
+        return this.registry.register({
+            name,
+            phase: HookPhase.TRUST_VIOLATION,
+            handler,
+            ...options,
+        });
+    }
+    /**
+     * Register an event-emitted hook
+     */
+    onEventEmitted(name, handler, options) {
+        return this.registry.register({
+            name,
+            phase: HookPhase.EVENT_EMITTED,
+            handler,
+            ...options,
+        });
+    }
+    /**
+     * Register a hook with full options
+     */
+    register(options) {
+        return this.registry.register(options);
+    }
+    // ============================================================
+    // Hook Execution
+    // ============================================================
+    /**
+     * Execute pre-authorize hooks
+     */
+    async executePreAuthorize(context, options) {
+        return this.execute(HookPhase.PRE_AUTHORIZE, context, options);
+    }
+    /**
+     * Execute post-authorize hooks
+     */
+    async executePostAuthorize(context, options) {
+        return this.execute(HookPhase.POST_AUTHORIZE, context, options);
+    }
+    /**
+     * Execute pre-execute hooks
+     */
+    async executePreExecute(context, options) {
+        return this.execute(HookPhase.PRE_EXECUTE, context, options);
+    }
+    /**
+     * Execute post-execute hooks
+     */
+    async executePostExecute(context, options) {
+        return this.execute(HookPhase.POST_EXECUTE, context, options);
+    }
+    /**
+     * Execute execution-failed hooks
+     */
+    async executeExecutionFailed(context, options) {
+        return this.execute(HookPhase.EXECUTION_FAILED, context, options);
+    }
+    /**
+     * Execute trust-change hooks
+     */
+    async executeTrustChange(context, options) {
+        return this.execute(HookPhase.TRUST_CHANGE, context, options);
+    }
+    /**
+     * Execute trust-violation hooks
+     */
+    async executeTrustViolation(context, options) {
+        return this.execute(HookPhase.TRUST_VIOLATION, context, options);
+    }
+    /**
+     * Execute event-emitted hooks
+     */
+    async executeEventEmitted(context, options) {
+        return this.execute(HookPhase.EVENT_EMITTED, context, options);
+    }
+    /**
+     * Execute hooks for a phase
+     */
+    async execute(phase, context, options) {
+        const mergedOptions = { ...this.config.defaultExecutionOptions, ...options };
+        const summary = await this.executor.execute(phase, context, mergedOptions);
+        if (this.config.enableLogging) {
+            this.logSummary(summary);
+        }
+        return summary;
+    }
+    // ============================================================
+    // Hook Management
+    // ============================================================
+    /**
+     * Unregister a hook
+     */
+    unregister(hookId) {
+        return this.registry.unregister(hookId);
+    }
+    /**
+     * Enable a hook
+     */
+    enable(hookId) {
+        return this.registry.enable(hookId);
+    }
+    /**
+     * Disable a hook
+     */
+    disable(hookId) {
+        return this.registry.disable(hookId);
+    }
+    /**
+     * Get a hook by ID
+     */
+    getHook(hookId) {
+        return this.registry.get(hookId);
+    }
+    /**
+     * Get all hooks for a phase
+     */
+    getHooksForPhase(phase) {
+        return this.registry.getByPhase(phase);
+    }
+    /**
+     * Get hook statistics
+     */
+    getStats() {
+        return this.registry.getStats();
+    }
+    /**
+     * Clear all hooks
+     */
+    clear() {
+        this.registry.clear();
+    }
+    /**
+     * Get the underlying registry
+     */
+    getRegistry() {
+        return this.registry;
+    }
+    /**
+     * Get the underlying executor
+     */
+    getExecutor() {
+        return this.executor;
+    }
+    // ============================================================
+    // Private Methods
+    // ============================================================
+    logSummary(summary) {
+        const status = summary.aborted ? 'ABORTED' : summary.failed > 0 ? 'FAILED' : 'OK';
+        console.log(`[Hooks] ${summary.phase}: ${status} - ` +
+            `${summary.succeeded}/${summary.hooksExecuted} succeeded ` +
+            `(${summary.totalDurationMs}ms)`);
+        if (summary.aborted && summary.abortReason) {
+            console.log(`[Hooks] Abort reason: ${summary.abortReason}`);
+        }
+        for (const result of summary.results) {
+            if (!result.result.success) {
+                console.log(`[Hooks] ${result.hookName} failed: ${result.result.error?.message}`);
+            }
+        }
+    }
+}
+/**
+ * Create a hook manager
+ */
+export function createHookManager(config) {
+    return new HookManager(config);
+}
+// Re-export utility functions
+export { successResult, abortResult, errorResult };
+//# sourceMappingURL=manager.js.map

package/dist/hooks/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/hooks/manager.ts"],"names":[],"mappings":"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"}

package/dist/hooks/registry.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Hook Registry - Central registry for hook management
+ *
+ * Manages registration, retrieval, and lifecycle of hooks.
+ */
+import { HookPhase, HookPriority, type HookDefinition, type HookHandler, type AnyHookContext } from './types.js';
+/**
+ * Options for registering a hook
+ */
+export interface RegisterHookOptions<T extends AnyHookContext = AnyHookContext> {
+    /** Unique hook ID (auto-generated if not provided) */
+    id?: string;
+    /** Hook name */
+    name: string;
+    /** Hook phase */
+    phase: HookPhase;
+    /** The handler function */
+    handler: HookHandler<T>;
+    /** Execution priority (default: NORMAL) */
+    priority?: HookPriority;
+    /** Whether enabled (default: true) */
+    enabled?: boolean;
+    /** Timeout in ms (default: 5000) */
+    timeoutMs?: number;
+    /** Continue on error (default: false) */
+    continueOnError?: boolean;
+    /** Filter function */
+    filter?: (context: T) => boolean;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Hook registry error
+ */
+export declare class HookRegistryError extends Error {
+    readonly code: HookRegistryErrorCode;
+    readonly hookId?: string | undefined;
+    constructor(message: string, code: HookRegistryErrorCode, hookId?: string | undefined);
+}
+/**
+ * Error codes for hook registry
+ */
+export declare enum HookRegistryErrorCode {
+    DUPLICATE_HOOK = "DUPLICATE_HOOK",
+    HOOK_NOT_FOUND = "HOOK_NOT_FOUND",
+    INVALID_HOOK = "INVALID_HOOK"
+}
+/**
+ * HookRegistry - Manages hook registration and retrieval
+ */
+export declare class HookRegistry {
+    private hooks;
+    private hooksByPhase;
+    constructor();
+    /**
+     * Register a new hook
+     */
+    register<T extends AnyHookContext>(options: RegisterHookOptions<T>): HookDefinition<T>;
+    /**
+     * Unregister a hook
+     */
+    unregister(hookId: string): boolean;
+    /**
+     * Get a hook by ID
+     */
+    get<T extends AnyHookContext>(hookId: string): HookDefinition<T> | undefined;
+    /**
+     * Get all hooks for a phase, sorted by priority
+     */
+    getByPhase<T extends AnyHookContext>(phase: HookPhase): HookDefinition<T>[];
+    /**
+     * Get enabled hooks for a phase, sorted by priority
+     */
+    getEnabledByPhase<T extends AnyHookContext>(phase: HookPhase): HookDefinition<T>[];
+    /**
+     * Enable a hook
+     */
+    enable(hookId: string): boolean;
+    /**
+     * Disable a hook
+     */
+    disable(hookId: string): boolean;
+    /**
+     * Check if a hook exists
+     */
+    has(hookId: string): boolean;
+    /**
+     * Get the count of hooks
+     */
+    count(phase?: HookPhase): number;
+    /**
+     * Get all hook IDs
+     */
+    getIds(): string[];
+    /**
+     * Get all hooks
+     */
+    getAll(): HookDefinition[];
+    /**
+     * Clear all hooks
+     */
+    clear(): void;
+    /**
+     * Clear hooks for a specific phase
+     */
+    clearPhase(phase: HookPhase): void;
+    /**
+     * Get statistics about registered hooks
+     */
+    getStats(): {
+        totalHooks: number;
+        enabledHooks: number;
+        disabledHooks: number;
+        byPhase: Record<string, number>;
+        byPriority: Record<string, number>;
+    };
+}
+/**
+ * Create a new hook registry
+ */
+export declare function createHookRegistry(): HookRegistry;
+/**
+ * Get or create the global hook registry
+ */
+export declare function getGlobalHookRegistry(): HookRegistry;
+/**
+ * Reset the global hook registry (for testing)
+ */
+export declare function resetGlobalHookRegistry(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/hooks/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/hooks/registry.ts"],"names":[],"mappings":"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"}

package/dist/hooks/registry.js

@@ -0,0 +1,238 @@
+/**
+ * Hook Registry - Central registry for hook management
+ *
+ * Manages registration, retrieval, and lifecycle of hooks.
+ */
+import { HookPhase, HookPriority, } from './types.js';
+/**
+ * Hook registry error
+ */
+export class HookRegistryError extends Error {
+    code;
+    hookId;
+    constructor(message, code, hookId) {
+        super(message);
+        this.code = code;
+        this.hookId = hookId;
+        this.name = 'HookRegistryError';
+    }
+}
+/**
+ * Error codes for hook registry
+ */
+export var HookRegistryErrorCode;
+(function (HookRegistryErrorCode) {
+    HookRegistryErrorCode["DUPLICATE_HOOK"] = "DUPLICATE_HOOK";
+    HookRegistryErrorCode["HOOK_NOT_FOUND"] = "HOOK_NOT_FOUND";
+    HookRegistryErrorCode["INVALID_HOOK"] = "INVALID_HOOK";
+})(HookRegistryErrorCode || (HookRegistryErrorCode = {}));
+/**
+ * Counter for generating unique hook IDs
+ */
+let hookIdCounter = 0;
+/**
+ * Generate a unique hook ID
+ */
+function generateHookId(phase) {
+    hookIdCounter++;
+    return `${phase}-${hookIdCounter}-${Date.now().toString(36)}`;
+}
+/**
+ * HookRegistry - Manages hook registration and retrieval
+ */
+export class HookRegistry {
+    hooks = new Map();
+    hooksByPhase = new Map();
+    constructor() {
+        // Initialize phase sets
+        for (const phase of Object.values(HookPhase)) {
+            this.hooksByPhase.set(phase, new Set());
+        }
+    }
+    /**
+     * Register a new hook
+     */
+    register(options) {
+        const id = options.id ?? generateHookId(options.phase);
+        if (this.hooks.has(id)) {
+            throw new HookRegistryError(`Hook with ID '${id}' already exists`, HookRegistryErrorCode.DUPLICATE_HOOK, id);
+        }
+        const hook = {
+            id,
+            name: options.name,
+            phase: options.phase,
+            priority: options.priority ?? HookPriority.NORMAL,
+            handler: options.handler,
+            enabled: options.enabled ?? true,
+            timeoutMs: options.timeoutMs ?? 5000,
+            continueOnError: options.continueOnError ?? false,
+            filter: options.filter,
+            metadata: options.metadata,
+        };
+        this.hooks.set(id, hook);
+        this.hooksByPhase.get(options.phase).add(id);
+        return hook;
+    }
+    /**
+     * Unregister a hook
+     */
+    unregister(hookId) {
+        const hook = this.hooks.get(hookId);
+        if (!hook) {
+            return false;
+        }
+        this.hooks.delete(hookId);
+        this.hooksByPhase.get(hook.phase).delete(hookId);
+        return true;
+    }
+    /**
+     * Get a hook by ID
+     */
+    get(hookId) {
+        return this.hooks.get(hookId);
+    }
+    /**
+     * Get all hooks for a phase, sorted by priority
+     */
+    getByPhase(phase) {
+        const hookIds = this.hooksByPhase.get(phase) ?? new Set();
+        const hooks = [];
+        for (const id of hookIds) {
+            const hook = this.hooks.get(id);
+            if (hook) {
+                hooks.push(hook);
+            }
+        }
+        // Sort by priority (lower number = higher priority)
+        return hooks.sort((a, b) => a.priority - b.priority);
+    }
+    /**
+     * Get enabled hooks for a phase, sorted by priority
+     */
+    getEnabledByPhase(phase) {
+        return this.getByPhase(phase).filter(h => h.enabled);
+    }
+    /**
+     * Enable a hook
+     */
+    enable(hookId) {
+        const hook = this.hooks.get(hookId);
+        if (!hook) {
+            return false;
+        }
+        hook.enabled = true;
+        return true;
+    }
+    /**
+     * Disable a hook
+     */
+    disable(hookId) {
+        const hook = this.hooks.get(hookId);
+        if (!hook) {
+            return false;
+        }
+        hook.enabled = false;
+        return true;
+    }
+    /**
+     * Check if a hook exists
+     */
+    has(hookId) {
+        return this.hooks.has(hookId);
+    }
+    /**
+     * Get the count of hooks
+     */
+    count(phase) {
+        if (phase) {
+            return this.hooksByPhase.get(phase)?.size ?? 0;
+        }
+        return this.hooks.size;
+    }
+    /**
+     * Get all hook IDs
+     */
+    getIds() {
+        return Array.from(this.hooks.keys());
+    }
+    /**
+     * Get all hooks
+     */
+    getAll() {
+        return Array.from(this.hooks.values());
+    }
+    /**
+     * Clear all hooks
+     */
+    clear() {
+        this.hooks.clear();
+        for (const phase of Object.values(HookPhase)) {
+            this.hooksByPhase.set(phase, new Set());
+        }
+    }
+    /**
+     * Clear hooks for a specific phase
+     */
+    clearPhase(phase) {
+        const hookIds = this.hooksByPhase.get(phase) ?? new Set();
+        for (const id of hookIds) {
+            this.hooks.delete(id);
+        }
+        this.hooksByPhase.set(phase, new Set());
+    }
+    /**
+     * Get statistics about registered hooks
+     */
+    getStats() {
+        const byPhase = {};
+        const byPriority = {};
+        let enabledCount = 0;
+        let disabledCount = 0;
+        for (const [phase, ids] of this.hooksByPhase) {
+            byPhase[phase] = ids.size;
+        }
+        for (const hook of this.hooks.values()) {
+            if (hook.enabled) {
+                enabledCount++;
+            }
+            else {
+                disabledCount++;
+            }
+            const priorityName = HookPriority[hook.priority] ?? String(hook.priority);
+            byPriority[priorityName] = (byPriority[priorityName] ?? 0) + 1;
+        }
+        return {
+            totalHooks: this.hooks.size,
+            enabledHooks: enabledCount,
+            disabledHooks: disabledCount,
+            byPhase,
+            byPriority,
+        };
+    }
+}
+/**
+ * Create a new hook registry
+ */
+export function createHookRegistry() {
+    return new HookRegistry();
+}
+/**
+ * Global hook registry singleton
+ */
+let globalRegistry = null;
+/**
+ * Get or create the global hook registry
+ */
+export function getGlobalHookRegistry() {
+    if (!globalRegistry) {
+        globalRegistry = createHookRegistry();
+    }
+    return globalRegistry;
+}
+/**
+ * Reset the global hook registry (for testing)
+ */
+export function resetGlobalHookRegistry() {
+    globalRegistry = null;
+}
+//# sourceMappingURL=registry.js.map

package/dist/hooks/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/hooks/registry.ts"],"names":[],"mappings":"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"}