@vorionsys/a3i 0.1.0

package/dist/hooks/executor.js

@@ -0,0 +1,217 @@
+/**
+ * Hook Executor - Executes hooks in the proper order
+ *
+ * Handles timeout, error recovery, filtering, and abort logic.
+ */
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * Default execution options
+ */
+const DEFAULT_OPTIONS = {
+    stopOnAbort: true,
+    stopOnError: true,
+    timeoutMs: 5000,
+    parallel: false,
+};
+/**
+ * Create a success hook result
+ */
+export function successResult(durationMs, modified) {
+    return {
+        success: true,
+        durationMs,
+        modified,
+    };
+}
+/**
+ * Create an abort hook result
+ */
+export function abortResult(reason, durationMs) {
+    return {
+        success: true,
+        abort: true,
+        abortReason: reason,
+        durationMs,
+    };
+}
+/**
+ * Create an error hook result
+ */
+export function errorResult(error, durationMs) {
+    return {
+        success: false,
+        error,
+        durationMs,
+    };
+}
+/**
+ * Execute a single hook with timeout
+ */
+async function executeHookWithTimeout(hook, context, timeoutMs) {
+    const startTime = Date.now();
+    return new Promise((resolve) => {
+        const timeoutId = setTimeout(() => {
+            resolve({
+                success: false,
+                error: new Error(`Hook '${hook.name}' timed out after ${timeoutMs}ms`),
+                durationMs: Date.now() - startTime,
+            });
+        }, timeoutMs);
+        Promise.resolve()
+            .then(() => hook.handler(context))
+            .then((result) => {
+            clearTimeout(timeoutId);
+            resolve(result);
+        })
+            .catch((error) => {
+            clearTimeout(timeoutId);
+            resolve({
+                success: false,
+                error: error instanceof Error ? error : new Error(String(error)),
+                durationMs: Date.now() - startTime,
+            });
+        });
+    });
+}
+/**
+ * HookExecutor - Executes hooks from a registry
+ */
+export class HookExecutor {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Execute all hooks for a phase
+     */
+    async execute(phase, context, options = {}) {
+        const opts = { ...DEFAULT_OPTIONS, ...options };
+        const startTime = Date.now();
+        // Get enabled hooks for this phase
+        const hooks = this.registry.getEnabledByPhase(phase);
+        // Build full context
+        const fullContext = {
+            executionId: uuidv4(),
+            correlationId: context.correlationId ?? uuidv4(),
+            startedAt: new Date(),
+            metadata: {},
+            ...context,
+        };
+        const results = [];
+        let succeeded = 0;
+        let failed = 0;
+        let skipped = 0;
+        let aborted = false;
+        let abortReason;
+        if (opts.parallel) {
+            // Execute hooks in parallel
+            const promises = hooks.map(async (hook) => {
+                // Check filter
+                if (hook.filter && !hook.filter(fullContext)) {
+                    skipped++;
+                    return { hookId: hook.id, hookName: hook.name, skipped: true };
+                }
+                const timeout = opts.timeoutMs ?? hook.timeoutMs ?? 5000;
+                const result = await executeHookWithTimeout(hook, fullContext, timeout);
+                return { hookId: hook.id, hookName: hook.name, result };
+            });
+            const hookResults = await Promise.all(promises);
+            for (const hr of hookResults) {
+                if ('skipped' in hr && hr.skipped) {
+                    continue;
+                }
+                const { hookId, hookName, result } = hr;
+                results.push({ hookId, hookName, result });
+                if (result.success) {
+                    succeeded++;
+                    if (result.abort && !aborted) {
+                        aborted = true;
+                        abortReason = result.abortReason;
+                    }
+                }
+                else {
+                    failed++;
+                }
+            }
+        }
+        else {
+            // Execute hooks sequentially
+            for (const hook of hooks) {
+                // Check filter
+                if (hook.filter && !hook.filter(fullContext)) {
+                    skipped++;
+                    continue;
+                }
+                const timeout = opts.timeoutMs ?? hook.timeoutMs ?? 5000;
+                const result = await executeHookWithTimeout(hook, fullContext, timeout);
+                results.push({
+                    hookId: hook.id,
+                    hookName: hook.name,
+                    result,
+                });
+                if (result.success) {
+                    succeeded++;
+                    if (result.abort) {
+                        aborted = true;
+                        abortReason = result.abortReason;
+                        if (opts.stopOnAbort) {
+                            break;
+                        }
+                    }
+                }
+                else {
+                    failed++;
+                    if (!hook.continueOnError && opts.stopOnError) {
+                        break;
+                    }
+                }
+            }
+        }
+        return {
+            phase,
+            hooksExecuted: succeeded + failed,
+            succeeded,
+            failed,
+            skipped,
+            aborted,
+            abortReason,
+            totalDurationMs: Date.now() - startTime,
+            results,
+        };
+    }
+    /**
+     * Execute a specific hook by ID
+     */
+    async executeById(hookId, context, timeoutMs) {
+        const hook = this.registry.get(hookId);
+        if (!hook || !hook.enabled) {
+            return null;
+        }
+        const fullContext = {
+            executionId: uuidv4(),
+            correlationId: context.correlationId ?? uuidv4(),
+            startedAt: new Date(),
+            metadata: {},
+            ...context,
+        };
+        // Check filter
+        if (hook.filter && !hook.filter(fullContext)) {
+            return null;
+        }
+        const timeout = timeoutMs ?? hook.timeoutMs ?? 5000;
+        return executeHookWithTimeout(hook, fullContext, timeout);
+    }
+    /**
+     * Get the registry
+     */
+    getRegistry() {
+        return this.registry;
+    }
+}
+/**
+ * Create a hook executor
+ */
+export function createHookExecutor(registry) {
+    return new HookExecutor(registry);
+}
+//# sourceMappingURL=executor.js.map

package/dist/hooks/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/hooks/executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAyBpC;;GAEG;AACH,MAAM,eAAe,GAAkC;IACrD,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,KAAK;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,UAAkB,EAClB,QAAkB;IAElB,OAAO;QACL,OAAO,EAAE,IAAI;QACb,UAAU;QACV,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,UAAkB;IAElB,OAAO;QACL,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,MAAM;QACnB,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,KAAY,EACZ,UAAkB;IAElB,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK;QACL,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,sBAAsB,CACnC,IAAuB,EACvB,OAAU,EACV,SAAiB;IAEjB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,EAAE;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,OAAO,CAAC;gBACN,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,IAAI,qBAAqB,SAAS,IAAI,CAAC;gBACtE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACnC,CAAC,CAAC;QACL,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,OAAO,CAAC,OAAO,EAAE;aACd,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;aACjC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,OAAO,CAAC;gBACN,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACnC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IACN,QAAQ,CAAe;IAExC,YAAY,QAAsB;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAAgB,EAChB,OAAmC,EACnC,UAA+B,EAAE;QAEjC,MAAM,IAAI,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,mCAAmC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAI,KAAK,CAAC,CAAC;QAExD,qBAAqB;QACrB,MAAM,WAAW,GAAM;YACrB,WAAW,EAAE,MAAM,EAAE;YACrB,aAAa,EAAG,OAAmC,CAAC,aAAuB,IAAI,MAAM,EAAE;YACvF,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ,EAAE,EAAE;YACZ,GAAG,OAAO;SACN,CAAC;QAEP,MAAM,OAAO,GAAoC,EAAE,CAAC;QACpD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,WAA+B,CAAC;QAEpC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,4BAA4B;YAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;gBACxC,eAAe;gBACf,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC7C,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBACjE,CAAC;gBAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;gBACzD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;gBAExE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YAC1D,CAAC,CAAC,CAAC;YAEH,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAEhD,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;gBAC7B,IAAI,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;oBAClC,SAAS;gBACX,CAAC;gBAED,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAIpC,CAAC;gBAEF,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;gBAE3C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,SAAS,EAAE,CAAC;oBACZ,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;wBAC7B,OAAO,GAAG,IAAI,CAAC;wBACf,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;oBACnC,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,EAAE,CAAC;gBACX,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,6BAA6B;YAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,eAAe;gBACf,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC7C,OAAO,EAAE,CAAC;oBACV,SAAS;gBACX,CAAC;gBAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;gBACzD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;gBAExE,OAAO,CAAC,IAAI,CAAC;oBACX,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,MAAM;iBACP,CAAC,CAAC;gBAEH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,SAAS,EAAE,CAAC;oBAEZ,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;wBACjB,OAAO,GAAG,IAAI,CAAC;wBACf,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;wBAEjC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;4BACrB,MAAM;wBACR,CAAC;oBACH,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,EAAE,CAAC;oBAET,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;wBAC9C,MAAM;oBACR,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK;YACL,aAAa,EAAE,SAAS,GAAG,MAAM;YACjC,SAAS;YACT,MAAM;YACN,OAAO;YACP,OAAO;YACP,WAAW;YACX,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YACvC,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,MAAc,EACd,OAAmC,EACnC,SAAkB;QAElB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAI,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,WAAW,GAAM;YACrB,WAAW,EAAE,MAAM,EAAE;YACrB,aAAa,EAAG,OAAmC,CAAC,aAAuB,IAAI,MAAM,EAAE;YACvF,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ,EAAE,EAAE;YACZ,GAAG,OAAO;SACN,CAAC;QAEP,eAAe;QACf,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,SAAS,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;QACpD,OAAO,sBAAsB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAsB;IACvD,OAAO,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Hooks module - Extensibility system for Vorion platform
+ *
+ * @example
+ * ```typescript
+ * import { createHookManager, HookPhase, HookPriority } from '@vorion/a3i/hooks';
+ *
+ * const hooks = createHookManager();
+ *
+ * // Register a pre-authorize hook
+ * hooks.onPreAuthorize('audit-logger', async (ctx) => {
+ *   console.log(`Authorizing intent ${ctx.intent.intentId}`);
+ *   return { success: true, durationMs: 0 };
+ * }, { priority: HookPriority.MONITOR });
+ *
+ * // Register a hook that can abort
+ * hooks.onPreAuthorize('rate-limiter', async (ctx) => {
+ *   if (isRateLimited(ctx.intent.agentId)) {
+ *     return {
+ *       success: true,
+ *       abort: true,
+ *       abortReason: 'Rate limit exceeded',
+ *       durationMs: 1,
+ *     };
+ *   }
+ *   return { success: true, durationMs: 1 };
+ * }, { priority: HookPriority.HIGH });
+ *
+ * // Execute hooks
+ * const summary = await hooks.executePreAuthorize({
+ *   correlationId: 'xxx',
+ *   intent: myIntent,
+ *   profile: agentProfile,
+ * });
+ *
+ * if (summary.aborted) {
+ *   console.log(`Authorization aborted: ${summary.abortReason}`);
+ * }
+ * ```
+ */
+export { HookPhase, HookPriority, type HookResult, type HookContext, type PreAuthorizeContext, type PostAuthorizeContext, type PreExecuteContext, type PostExecuteContext, type ExecutionFailedContext, type TrustChangeContext, type TrustViolationContext, type EventEmittedContext, type AnyHookContext, type HookHandler, type HookDefinition, type HookExecutionSummary, } from './types.js';
+export { HookRegistry, createHookRegistry, getGlobalHookRegistry, resetGlobalHookRegistry, HookRegistryError, HookRegistryErrorCode, type RegisterHookOptions, } from './registry.js';
+export { HookExecutor, createHookExecutor, type ExecuteHooksOptions, } from './executor.js';
+export { HookManager, createHookManager, successResult, abortResult, errorResult, type HookManagerConfig, type SimpleHookOptions, } from './manager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,EACL,SAAS,EACT,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,49 @@
+/**
+ * Hooks module - Extensibility system for Vorion platform
+ *
+ * @example
+ * ```typescript
+ * import { createHookManager, HookPhase, HookPriority } from '@vorion/a3i/hooks';
+ *
+ * const hooks = createHookManager();
+ *
+ * // Register a pre-authorize hook
+ * hooks.onPreAuthorize('audit-logger', async (ctx) => {
+ *   console.log(`Authorizing intent ${ctx.intent.intentId}`);
+ *   return { success: true, durationMs: 0 };
+ * }, { priority: HookPriority.MONITOR });
+ *
+ * // Register a hook that can abort
+ * hooks.onPreAuthorize('rate-limiter', async (ctx) => {
+ *   if (isRateLimited(ctx.intent.agentId)) {
+ *     return {
+ *       success: true,
+ *       abort: true,
+ *       abortReason: 'Rate limit exceeded',
+ *       durationMs: 1,
+ *     };
+ *   }
+ *   return { success: true, durationMs: 1 };
+ * }, { priority: HookPriority.HIGH });
+ *
+ * // Execute hooks
+ * const summary = await hooks.executePreAuthorize({
+ *   correlationId: 'xxx',
+ *   intent: myIntent,
+ *   profile: agentProfile,
+ * });
+ *
+ * if (summary.aborted) {
+ *   console.log(`Authorization aborted: ${summary.abortReason}`);
+ * }
+ * ```
+ */
+// Types
+export { HookPhase, HookPriority, } from './types.js';
+// Registry
+export { HookRegistry, createHookRegistry, getGlobalHookRegistry, resetGlobalHookRegistry, HookRegistryError, HookRegistryErrorCode, } from './registry.js';
+// Executor
+export { HookExecutor, createHookExecutor, } from './executor.js';
+// Manager
+export { HookManager, createHookManager, successResult, abortResult, errorResult, } from './manager.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,QAAQ;AACR,OAAO,EACL,SAAS,EACT,YAAY,GAeb,MAAM,YAAY,CAAC;AAEpB,WAAW;AACX,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,GAEtB,MAAM,eAAe,CAAC;AAEvB,WAAW;AACX,OAAO,EACL,YAAY,EACZ,kBAAkB,GAEnB,MAAM,eAAe,CAAC;AAEvB,UAAU;AACV,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,WAAW,GAGZ,MAAM,cAAc,CAAC"}

package/dist/hooks/manager.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Hook Manager - High-level API for the hook system
+ *
+ * Provides a unified interface for registering and executing hooks.
+ */
+import { HookPhase, HookPriority, type HookHandler, type HookExecutionSummary, type PreAuthorizeContext, type PostAuthorizeContext, type PreExecuteContext, type PostExecuteContext, type ExecutionFailedContext, type TrustChangeContext, type TrustViolationContext, type EventEmittedContext, type AnyHookContext, type HookDefinition } from './types.js';
+import { HookRegistry, type RegisterHookOptions } from './registry.js';
+import { HookExecutor, type ExecuteHooksOptions, successResult, abortResult, errorResult } from './executor.js';
+/**
+ * Configuration for the hook manager
+ */
+export interface HookManagerConfig {
+    /** Custom registry (creates new if not provided) */
+    registry?: HookRegistry;
+    /** Default execution options */
+    defaultExecutionOptions?: ExecuteHooksOptions;
+    /** Enable hook execution logging */
+    enableLogging?: boolean;
+}
+/**
+ * Simplified hook registration options
+ */
+export interface SimpleHookOptions {
+    /** Hook priority */
+    priority?: HookPriority;
+    /** Timeout in ms */
+    timeoutMs?: number;
+    /** Continue on error */
+    continueOnError?: boolean;
+    /** Whether enabled */
+    enabled?: boolean;
+}
+/**
+ * HookManager - High-level hook management API
+ */
+export declare class HookManager {
+    private readonly registry;
+    private readonly executor;
+    private readonly config;
+    constructor(config?: HookManagerConfig);
+    /**
+     * Register a pre-authorize hook
+     */
+    onPreAuthorize(name: string, handler: HookHandler<PreAuthorizeContext>, options?: SimpleHookOptions): HookDefinition<PreAuthorizeContext>;
+    /**
+     * Register a post-authorize hook
+     */
+    onPostAuthorize(name: string, handler: HookHandler<PostAuthorizeContext>, options?: SimpleHookOptions): HookDefinition<PostAuthorizeContext>;
+    /**
+     * Register a pre-execute hook
+     */
+    onPreExecute(name: string, handler: HookHandler<PreExecuteContext>, options?: SimpleHookOptions): HookDefinition<PreExecuteContext>;
+    /**
+     * Register a post-execute hook
+     */
+    onPostExecute(name: string, handler: HookHandler<PostExecuteContext>, options?: SimpleHookOptions): HookDefinition<PostExecuteContext>;
+    /**
+     * Register an execution-failed hook
+     */
+    onExecutionFailed(name: string, handler: HookHandler<ExecutionFailedContext>, options?: SimpleHookOptions): HookDefinition<ExecutionFailedContext>;
+    /**
+     * Register a trust-change hook
+     */
+    onTrustChange(name: string, handler: HookHandler<TrustChangeContext>, options?: SimpleHookOptions): HookDefinition<TrustChangeContext>;
+    /**
+     * Register a trust-violation hook
+     */
+    onTrustViolation(name: string, handler: HookHandler<TrustViolationContext>, options?: SimpleHookOptions): HookDefinition<TrustViolationContext>;
+    /**
+     * Register an event-emitted hook
+     */
+    onEventEmitted(name: string, handler: HookHandler<EventEmittedContext>, options?: SimpleHookOptions): HookDefinition<EventEmittedContext>;
+    /**
+     * Register a hook with full options
+     */
+    register<T extends AnyHookContext>(options: RegisterHookOptions<T>): HookDefinition<T>;
+    /**
+     * Execute pre-authorize hooks
+     */
+    executePreAuthorize(context: Omit<PreAuthorizeContext, 'executionId' | 'startedAt' | 'metadata'>, options?: ExecuteHooksOptions): Promise<HookExecutionSummary>;
+    /**
+     * Execute post-authorize hooks
+     */
+    executePostAuthorize(context: Omit<PostAuthorizeContext, 'executionId' | 'startedAt' | 'metadata'>, options?: ExecuteHooksOptions): Promise<HookExecutionSummary>;
+    /**
+     * Execute pre-execute hooks
+     */
+    executePreExecute(context: Omit<PreExecuteContext, 'executionId' | 'startedAt' | 'metadata'>, options?: ExecuteHooksOptions): Promise<HookExecutionSummary>;
+    /**
+     * Execute post-execute hooks
+     */
+    executePostExecute(context: Omit<PostExecuteContext, 'executionId' | 'startedAt' | 'metadata'>, options?: ExecuteHooksOptions): Promise<HookExecutionSummary>;
+    /**
+     * Execute execution-failed hooks
+     */
+    executeExecutionFailed(context: Omit<ExecutionFailedContext, 'executionId' | 'startedAt' | 'metadata'>, options?: ExecuteHooksOptions): Promise<HookExecutionSummary>;
+    /**
+     * Execute trust-change hooks
+     */
+    executeTrustChange(context: Omit<TrustChangeContext, 'executionId' | 'startedAt' | 'metadata'>, options?: ExecuteHooksOptions): Promise<HookExecutionSummary>;
+    /**
+     * Execute trust-violation hooks
+     */
+    executeTrustViolation(context: Omit<TrustViolationContext, 'executionId' | 'startedAt' | 'metadata'>, options?: ExecuteHooksOptions): Promise<HookExecutionSummary>;
+    /**
+     * Execute event-emitted hooks
+     */
+    executeEventEmitted(context: Omit<EventEmittedContext, 'executionId' | 'startedAt' | 'metadata'>, options?: ExecuteHooksOptions): Promise<HookExecutionSummary>;
+    /**
+     * Execute hooks for a phase
+     */
+    execute(phase: HookPhase, context: Record<string, unknown>, options?: ExecuteHooksOptions): Promise<HookExecutionSummary>;
+    /**
+     * Unregister a hook
+     */
+    unregister(hookId: string): boolean;
+    /**
+     * Enable a hook
+     */
+    enable(hookId: string): boolean;
+    /**
+     * Disable a hook
+     */
+    disable(hookId: string): boolean;
+    /**
+     * Get a hook by ID
+     */
+    getHook<T extends AnyHookContext>(hookId: string): HookDefinition<T> | undefined;
+    /**
+     * Get all hooks for a phase
+     */
+    getHooksForPhase<T extends AnyHookContext>(phase: HookPhase): HookDefinition<T>[];
+    /**
+     * Get hook statistics
+     */
+    getStats(): ReturnType<HookRegistry['getStats']>;
+    /**
+     * Clear all hooks
+     */
+    clear(): void;
+    /**
+     * Get the underlying registry
+     */
+    getRegistry(): HookRegistry;
+    /**
+     * Get the underlying executor
+     */
+    getExecutor(): HookExecutor;
+    private logSummary;
+}
+/**
+ * Create a hook manager
+ */
+export declare function createHookManager(config?: HookManagerConfig): HookManager;
+export { successResult, abortResult, errorResult };
+//# sourceMappingURL=manager.d.ts.map

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

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