@logosdx/hooks 1.0.0-beta.0

package/dist/esm/index.mjs

@@ -0,0 +1,830 @@
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function _assert_this_initialized(self) {
+    if (self === void 0) {
+        throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
+    }
+    return self;
+}
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _call_super(_this, derived, args) {
+    derived = _get_prototype_of(derived);
+    return _possible_constructor_return(_this, _is_native_reflect_construct() ? Reflect.construct(derived, args || [], _get_prototype_of(_this).constructor) : derived.apply(_this, args));
+}
+function _check_private_redeclaration(obj, privateCollection) {
+    if (privateCollection.has(obj)) {
+        throw new TypeError("Cannot initialize the same private elements twice on an object");
+    }
+}
+function _class_apply_descriptor_get(receiver, descriptor) {
+    if (descriptor.get) {
+        return descriptor.get.call(receiver);
+    }
+    return descriptor.value;
+}
+function _class_apply_descriptor_set(receiver, descriptor, value) {
+    if (descriptor.set) {
+        descriptor.set.call(receiver, value);
+    } else {
+        if (!descriptor.writable) {
+            throw new TypeError("attempted to set read only private field");
+        }
+        descriptor.value = value;
+    }
+}
+function _class_call_check(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+function _class_extract_field_descriptor(receiver, privateMap, action) {
+    if (!privateMap.has(receiver)) {
+        throw new TypeError("attempted to " + action + " private field on non-instance");
+    }
+    return privateMap.get(receiver);
+}
+function _class_private_field_get(receiver, privateMap) {
+    var descriptor = _class_extract_field_descriptor(receiver, privateMap, "get");
+    return _class_apply_descriptor_get(receiver, descriptor);
+}
+function _class_private_field_init(obj, privateMap, value) {
+    _check_private_redeclaration(obj, privateMap);
+    privateMap.set(obj, value);
+}
+function _class_private_field_set(receiver, privateMap, value) {
+    var descriptor = _class_extract_field_descriptor(receiver, privateMap, "set");
+    _class_apply_descriptor_set(receiver, descriptor, value);
+    return value;
+}
+function _construct(Parent, args, Class) {
+    if (_is_native_reflect_construct()) {
+        _construct = Reflect.construct;
+    } else {
+        _construct = function construct(Parent, args, Class) {
+            var a = [
+                null
+            ];
+            a.push.apply(a, args);
+            var Constructor = Function.bind.apply(Parent, a);
+            var instance = new Constructor();
+            if (Class) _set_prototype_of(instance, Class.prototype);
+            return instance;
+        };
+    }
+    return _construct.apply(null, arguments);
+}
+function _defineProperties(target, props) {
+    for(var i = 0; i < props.length; i++){
+        var descriptor = props[i];
+        descriptor.enumerable = descriptor.enumerable || false;
+        descriptor.configurable = true;
+        if ("value" in descriptor) descriptor.writable = true;
+        Object.defineProperty(target, descriptor.key, descriptor);
+    }
+}
+function _create_class(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+    if (staticProps) _defineProperties(Constructor, staticProps);
+    return Constructor;
+}
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _get_prototype_of(o) {
+    _get_prototype_of = Object.setPrototypeOf ? Object.getPrototypeOf : function getPrototypeOf(o) {
+        return o.__proto__ || Object.getPrototypeOf(o);
+    };
+    return _get_prototype_of(o);
+}
+function _inherits(subClass, superClass) {
+    if (typeof superClass !== "function" && superClass !== null) {
+        throw new TypeError("Super expression must either be null or a function");
+    }
+    subClass.prototype = Object.create(superClass && superClass.prototype, {
+        constructor: {
+            value: subClass,
+            writable: true,
+            configurable: true
+        }
+    });
+    if (superClass) _set_prototype_of(subClass, superClass);
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _is_native_function(fn) {
+    return Function.toString.call(fn).indexOf("[native code]") !== -1;
+}
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function _possible_constructor_return(self, call) {
+    if (call && (_type_of(call) === "object" || typeof call === "function")) {
+        return call;
+    }
+    return _assert_this_initialized(self);
+}
+function _set_prototype_of(o, p) {
+    _set_prototype_of = Object.setPrototypeOf || function setPrototypeOf(o, p) {
+        o.__proto__ = p;
+        return o;
+    };
+    return _set_prototype_of(o, p);
+}
+function _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+function _wrap_native_super(Class) {
+    var _cache = typeof Map === "function" ? new Map() : undefined;
+    _wrap_native_super = function wrapNativeSuper(Class) {
+        if (Class === null || !_is_native_function(Class)) return Class;
+        if (typeof Class !== "function") {
+            throw new TypeError("Super expression must either be null or a function");
+        }
+        if (typeof _cache !== "undefined") {
+            if (_cache.has(Class)) return _cache.get(Class);
+            _cache.set(Class, Wrapper);
+        }
+        function Wrapper() {
+            return _construct(Class, arguments, _get_prototype_of(this).constructor);
+        }
+        Wrapper.prototype = Object.create(Class.prototype, {
+            constructor: {
+                value: Wrapper,
+                enumerable: false,
+                writable: true,
+                configurable: true
+            }
+        });
+        return _set_prototype_of(Wrapper, Class);
+    };
+    return _wrap_native_super(Class);
+}
+function _is_native_reflect_construct() {
+    try {
+        var result = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function() {}));
+    } catch (_) {}
+    return (_is_native_reflect_construct = function() {
+        return !!result;
+    })();
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() {
+        return this;
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+function _ts_values(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function() {
+            if (o && i >= o.length) o = void 0;
+            return {
+                value: o && o[i++],
+                done: !o
+            };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+}
+import { assert, attempt, isFunction, isObject } from '@logosdx/utils';
+/**
+ * Error thrown when a hook extension calls `fail()` or when hook execution fails.
+ *
+ * @example
+ *     engine.extend('save', 'before', async (ctx) => {
+ *         if (!ctx.args[0].isValid) {
+ *             ctx.fail('Validation failed');
+ *         }
+ *     });
+ *
+ *     const [, err] = await attempt(() => app.save(data));
+ *     if (isHookError(err)) {
+ *         console.log(err.hookName);  // 'save'
+ *         console.log(err.extPoint);  // 'before'
+ *     }
+ */ export var HookError = /*#__PURE__*/ function(Error1) {
+    "use strict";
+    _inherits(HookError, Error1);
+    function HookError(message) {
+        _class_call_check(this, HookError);
+        var _this;
+        _this = _call_super(this, HookError, [
+            message
+        ]), /** Name of the hook where the error occurred */ _define_property(_this, "hookName", void 0), /** Extension point where the error occurred: 'before', 'after', or 'error' */ _define_property(_this, "extPoint", void 0), /** Original error if `fail()` was called with an Error instance */ _define_property(_this, "originalError", void 0), /** Whether the hook was explicitly aborted via `fail()` */ _define_property(_this, "aborted", false);
+        return _this;
+    }
+    return HookError;
+}(_wrap_native_super(Error));
+/**
+ * Type guard to check if an error is a HookError.
+ *
+ * @example
+ *     const [result, err] = await attempt(() => app.save(data));
+ *     if (isHookError(err)) {
+ *         console.log(`Hook "${err.hookName}" failed at "${err.extPoint}"`);
+ *     }
+ */ export var isHookError = function(error) {
+    var _error_constructor;
+    return (error === null || error === void 0 ? void 0 : (_error_constructor = error.constructor) === null || _error_constructor === void 0 ? void 0 : _error_constructor.name) === HookError.name;
+};
+var Hook = function Hook() {
+    "use strict";
+    _class_call_check(this, Hook);
+    _define_property(this, "before", new Set());
+    _define_property(this, "after", new Set());
+    _define_property(this, "error", new Set());
+};
+var allowedExtPoints = new Set([
+    'before',
+    'after',
+    'error'
+]);
+var _registered = /*#__PURE__*/ new WeakMap(), _hooks = /*#__PURE__*/ new WeakMap(), _hookFnOpts = /*#__PURE__*/ new WeakMap(), _wrapped = /*#__PURE__*/ new WeakMap();
+/**
+ * A lightweight, type-safe hook system for extending function behavior.
+ *
+ * HookEngine allows you to wrap functions and add extensions that run
+ * before, after, or on error. Extensions can modify arguments, change
+ * results, or abort execution entirely.
+ *
+ * @example
+ *     interface MyApp {
+ *         save(data: Data): Promise<Result>;
+ *         load(id: string): Promise<Data>;
+ *     }
+ *
+ *     const app = new MyAppImpl();
+ *     const hooks = new HookEngine<MyApp>();
+ *
+ *     // Wrap a method to make it hookable
+ *     hooks.wrap(app, 'save');
+ *
+ *     // Add a validation extension
+ *     hooks.extend('save', 'before', async (ctx) => {
+ *         if (!ctx.args[0].isValid) {
+ *             ctx.fail('Validation failed');
+ *         }
+ *     });
+ *
+ *     // Add logging extension
+ *     hooks.extend('save', 'after', async (ctx) => {
+ *         console.log('Saved:', ctx.results);
+ *     });
+ *
+ * @typeParam Shape - Interface defining the hookable functions
+ */ export var HookEngine = /*#__PURE__*/ function() {
+    "use strict";
+    function HookEngine() {
+        _class_call_check(this, HookEngine);
+        _class_private_field_init(this, _registered, {
+            writable: true,
+            value: new Set()
+        });
+        _class_private_field_init(this, _hooks, {
+            writable: true,
+            value: new Map()
+        });
+        _class_private_field_init(this, _hookFnOpts, {
+            writable: true,
+            value: new WeakMap()
+        });
+        _class_private_field_init(this, _wrapped, {
+            writable: true,
+            value: new WeakMap()
+        });
+    }
+    _create_class(HookEngine, [
+        {
+            /**
+     * Add an extension to a registered hook.
+     *
+     * Extensions run at specific points in the hook lifecycle:
+     * - `before`: Runs before the original function. Can modify args or return early.
+     * - `after`: Runs after successful execution. Can modify the result.
+     * - `error`: Runs when the original function throws. Can handle or transform errors.
+     *
+     * @param name - Name of the registered hook to extend
+     * @param extensionPoint - When to run: 'before', 'after', or 'error'
+     * @param cbOrOpts - Extension callback or options object
+     * @returns Cleanup function to remove the extension
+     *
+     * @example
+     *     // Simple callback
+     *     const cleanup = hooks.extend('save', 'before', async (ctx) => {
+     *         console.log('About to save:', ctx.args);
+     *     });
+     *
+     *     // With options
+     *     hooks.extend('save', 'after', {
+     *         callback: async (ctx) => { console.log('Saved!'); },
+     *         once: true,           // Remove after first run
+     *         ignoreOnFail: true    // Don't throw if this extension fails
+     *     });
+     *
+     *     // Later: remove the extension
+     *     cleanup();
+     */ key: "extend",
+            value: function extend(name, extensionPoint, cbOrOpts) {
+                var callback = typeof cbOrOpts === 'function' ? cbOrOpts : cbOrOpts === null || cbOrOpts === void 0 ? void 0 : cbOrOpts.callback;
+                var opts = typeof cbOrOpts === 'function' ? {} : cbOrOpts;
+                assert(typeof name === 'string', '"name" must be a string');
+                assert(_class_private_field_get(this, _registered).has(name), "'".concat(name.toString(), "' is not a registered hook"));
+                assert(typeof extensionPoint === 'string', '"extensionPoint" must be a string');
+                assert(allowedExtPoints.has(extensionPoint), "'".concat(extensionPoint, "' is not a valid extension point"));
+                assert(isFunction(callback) || isObject(cbOrOpts), '"cbOrOpts" must be a extension callback or options');
+                assert(isFunction(callback), 'callback must be a function');
+                var _class_private_field_get_get;
+                var hook = (_class_private_field_get_get = _class_private_field_get(this, _hooks).get(name)) !== null && _class_private_field_get_get !== void 0 ? _class_private_field_get_get : new Hook();
+                hook[extensionPoint].add(callback);
+                _class_private_field_get(this, _hooks).set(name, hook);
+                _class_private_field_get(this, _hookFnOpts).set(callback, opts);
+                /**
+         * Removes the registered hook extension
+         */ return function() {
+                    hook[extensionPoint].delete(callback);
+                };
+            }
+        },
+        {
+            /**
+     * Register a function as a hookable and return the wrapped version.
+     *
+     * The wrapped function behaves identically to the original but allows
+     * extensions to be added via `extend()`. Use `wrap()` for a simpler API
+     * when working with object methods.
+     *
+     * @param name - Unique name for this hook (must match a key in Shape)
+     * @param cb - The original function to wrap
+     * @param opts - Options for the wrapped function
+     * @returns Wrapped function with hook support
+     *
+     * @example
+     *     const hooks = new HookEngine<{ fetch: typeof fetch }>();
+     *
+     *     const hookedFetch = hooks.make('fetch', fetch);
+     *
+     *     hooks.extend('fetch', 'before', async (ctx) => {
+     *         console.log('Fetching:', ctx.args[0]);
+     *     });
+     *
+     *     await hookedFetch('/api/data');
+     */ key: "make",
+            value: function make(name, cb) {
+                var opts = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : {};
+                var _this = this;
+                assert(typeof name === 'string', '"name" must be a string');
+                assert(!_class_private_field_get(this, _registered).has(name), "'".concat(name.toString(), "' hook is already registered"));
+                assert(isFunction(cb), '"cb" must be a function');
+                assert(isObject(opts), '"opts" must be an object');
+                _class_private_field_get(this, _registered).add(name);
+                if (_class_private_field_get(this, _wrapped).has(cb)) {
+                    return _class_private_field_get(this, _wrapped).get(cb);
+                }
+                var callback = function() {
+                    for(var _len = arguments.length, origArgs = new Array(_len), _key = 0; _key < _len; _key++){
+                        origArgs[_key] = arguments[_key];
+                    }
+                    return _async_to_generator(function() {
+                        var _this, returnEarly, hook, context, _ref, before, after, errorFns, handleSet, _ref1, res, err;
+                        return _ts_generator(this, function(_state) {
+                            switch(_state.label){
+                                case 0:
+                                    _this = this;
+                                    returnEarly = false;
+                                    hook = _class_private_field_get(this, _hooks).get(name);
+                                    context = {
+                                        args: origArgs,
+                                        point: 'before',
+                                        removeHook: function removeHook() {},
+                                        returnEarly: function returnEarly1() {
+                                            returnEarly = true;
+                                        },
+                                        setArgs: function setArgs(next) {
+                                            assert(Array.isArray(next), "setArgs: next args for '".concat(context.point, "' '").concat(name.toString(), "' must be an array of arguments"));
+                                            context.args = next;
+                                        },
+                                        setResult: function setResult(next) {
+                                            context.results = next;
+                                        },
+                                        fail: function fail(reason) {
+                                            var error = new HookError("Hook Aborted: ".concat(reason !== null && reason !== void 0 ? reason : 'unknown'));
+                                            if (_instanceof(reason, Error)) {
+                                                error.originalError = reason;
+                                            }
+                                            error.extPoint = context.point;
+                                            error.hookName = name;
+                                            throw error;
+                                        }
+                                    };
+                                    _ref = hook !== null && hook !== void 0 ? hook : new Hook(), before = _ref.before, after = _ref.after, errorFns = _ref.error;
+                                    handleSet = function(which, point) {
+                                        return _async_to_generator(function() {
+                                            var _iteratorNormalCompletion, _didIteratorError, _iteratorError, _this, _loop, _iterator, _step, _ret, err;
+                                            return _ts_generator(this, function(_state) {
+                                                switch(_state.label){
+                                                    case 0:
+                                                        context.point = point;
+                                                        _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                                                        _state.label = 1;
+                                                    case 1:
+                                                        _state.trys.push([
+                                                            1,
+                                                            6,
+                                                            7,
+                                                            8
+                                                        ]);
+                                                        _loop = function() {
+                                                            var fn, opts, _ref, _$err;
+                                                            return _ts_generator(this, function(_state) {
+                                                                switch(_state.label){
+                                                                    case 0:
+                                                                        fn = _step.value;
+                                                                        context.removeHook = function() {
+                                                                            return which.delete(fn);
+                                                                        };
+                                                                        opts = _class_private_field_get(_this, _hookFnOpts).get(fn);
+                                                                        return [
+                                                                            4,
+                                                                            attempt(function() {
+                                                                                return fn(_object_spread({}, context));
+                                                                            })
+                                                                        ];
+                                                                    case 1:
+                                                                        _ref = _sliced_to_array.apply(void 0, [
+                                                                            _state.sent(),
+                                                                            2
+                                                                        ]), _$err = _ref[1];
+                                                                        if (opts.once) context.removeHook();
+                                                                        if (_$err && opts.ignoreOnFail !== true) {
+                                                                            throw _$err;
+                                                                        }
+                                                                        if (returnEarly) return [
+                                                                            2,
+                                                                            "break"
+                                                                        ];
+                                                                        return [
+                                                                            2
+                                                                        ];
+                                                                }
+                                                            });
+                                                        };
+                                                        _iterator = which[Symbol.iterator]();
+                                                        _state.label = 2;
+                                                    case 2:
+                                                        if (!!(_iteratorNormalCompletion = (_step = _iterator.next()).done)) return [
+                                                            3,
+                                                            5
+                                                        ];
+                                                        _this = this;
+                                                        return [
+                                                            5,
+                                                            _ts_values(_loop())
+                                                        ];
+                                                    case 3:
+                                                        _ret = _state.sent();
+                                                        if (_ret === "break") return [
+                                                            3,
+                                                            5
+                                                        ];
+                                                        _state.label = 4;
+                                                    case 4:
+                                                        _iteratorNormalCompletion = true;
+                                                        return [
+                                                            3,
+                                                            2
+                                                        ];
+                                                    case 5:
+                                                        return [
+                                                            3,
+                                                            8
+                                                        ];
+                                                    case 6:
+                                                        err = _state.sent();
+                                                        _didIteratorError = true;
+                                                        _iteratorError = err;
+                                                        return [
+                                                            3,
+                                                            8
+                                                        ];
+                                                    case 7:
+                                                        try {
+                                                            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                                                _iterator.return();
+                                                            }
+                                                        } finally{
+                                                            if (_didIteratorError) {
+                                                                throw _iteratorError;
+                                                            }
+                                                        }
+                                                        return [
+                                                            7
+                                                        ];
+                                                    case 8:
+                                                        return [
+                                                            2
+                                                        ];
+                                                }
+                                            });
+                                        }).call(_this);
+                                    };
+                                    return [
+                                        4,
+                                        handleSet(before, 'before')
+                                    ];
+                                case 1:
+                                    _state.sent();
+                                    if (returnEarly) return [
+                                        2,
+                                        context.results
+                                    ];
+                                    return [
+                                        4,
+                                        attempt(function() {
+                                            return cb.apply((opts === null || opts === void 0 ? void 0 : opts.bindTo) || cb, context.args);
+                                        })
+                                    ];
+                                case 2:
+                                    _ref1 = _sliced_to_array.apply(void 0, [
+                                        _state.sent(),
+                                        2
+                                    ]), res = _ref1[0], err = _ref1[1];
+                                    context.results = res;
+                                    context.error = err;
+                                    if (!err) return [
+                                        3,
+                                        4
+                                    ];
+                                    context.point = 'error';
+                                    return [
+                                        4,
+                                        handleSet(errorFns, 'error')
+                                    ];
+                                case 3:
+                                    _state.sent();
+                                    throw err;
+                                case 4:
+                                    return [
+                                        4,
+                                        handleSet(after, 'after')
+                                    ];
+                                case 5:
+                                    _state.sent();
+                                    return [
+                                        2,
+                                        context.results
+                                    ];
+                            }
+                        });
+                    }).call(_this);
+                };
+                return callback;
+            }
+        },
+        {
+            /**
+     * Wrap an object method in-place to make it hookable.
+     *
+     * This is a convenience method that combines `make()` with automatic
+     * binding and reassignment. The method is replaced on the instance
+     * with the wrapped version.
+     *
+     * @param instance - Object containing the method to wrap
+     * @param name - Name of the method to wrap
+     * @param opts - Additional options
+     *
+     * @example
+     *     class UserService {
+     *         async save(user: User) { ... }
+     *     }
+     *
+     *     const service = new UserService();
+     *     const hooks = new HookEngine<UserService>();
+     *
+     *     hooks.wrap(service, 'save');
+     *
+     *     // Now service.save() is hookable
+     *     hooks.extend('save', 'before', async (ctx) => {
+     *         console.log('Saving user:', ctx.args[0]);
+     *     });
+     */ key: "wrap",
+            value: function wrap(instance, name, opts) {
+                assert(isObject(instance), '"instance" must be an object');
+                var wrapped = this.make(name, instance[name], _object_spread({
+                    bindTo: instance
+                }, opts));
+                _class_private_field_get(this, _wrapped).set(wrapped, instance[name]);
+                instance[name] = wrapped;
+            }
+        },
+        {
+            /**
+     * Clear all registered hooks and extensions.
+     *
+     * After calling this method, all hooks are unregistered and all
+     * extensions are removed. Previously wrapped functions will continue
+     * to work but without any extensions.
+     *
+     * @example
+     *     hooks.wrap(app, 'save');
+     *     hooks.extend('save', 'before', validator);
+     *
+     *     // Reset for testing
+     *     hooks.clear();
+     *
+     *     // app.save() still works, but validator no longer runs
+     */ key: "clear",
+            value: function clear() {
+                _class_private_field_get(this, _registered).clear();
+                _class_private_field_get(this, _hooks).clear();
+                _class_private_field_set(this, _hookFnOpts, new WeakMap());
+            }
+        }
+    ]);
+    return HookEngine;
+}();