@rnaga/wp-node 1.1.0

package/core/hooks/filters/capabilities.js

@@ -0,0 +1,395 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Capabilities = void 0;
+const constants_1 = require("../../../constants");
+const hooks_1 = require("../../../decorators/hooks");
+const zod_1 = require("zod");
+let Capabilities = class Capabilities {
+    // delete_user
+    async canDeleteUser(...args) {
+        const [capabilities, context, user, targetUserId] = args;
+        capabilities.delete("delete_user");
+        if (!context.config.isMultiSite()) {
+            return capabilities.add("delete_users");
+        }
+        const userLogin = user?.props?.user_login;
+        if (typeof targetUserId !== "number" || !userLogin) {
+            return capabilities.add(constants_1.DO_NOT_ALLOW);
+        }
+        const targetSiteIds = await context.utils.user.getSiteIds(targetUserId);
+        if (targetSiteIds.length > 0) {
+            const [isTrue] = await context.utils.user.checkSuperAdminStatus(user, {
+                siteIds: targetSiteIds,
+            });
+            if (!isTrue) {
+                return capabilities.add(constants_1.DO_NOT_ALLOW);
+            }
+        }
+        return capabilities;
+    }
+    // manage_network_user
+    async canManageNetworkUser(...args) {
+        const [capabilities, context, action, user, targetUserId] = args;
+        if (action !== "manage_network_user") {
+            return capabilities;
+        }
+        capabilities.delete("manage_network_user");
+        if (!context.config.isMultiSite()) {
+            return capabilities.add("edit_users");
+        }
+        const userLogin = user?.props?.user_login;
+        if (typeof targetUserId !== "number" || !userLogin) {
+            return capabilities.add(constants_1.DO_NOT_ALLOW);
+        }
+        const targetSiteIds = await context.utils.user.getSiteIds(targetUserId);
+        if (targetSiteIds.length > 0) {
+            const [isTrue] = await context.utils.user.checkSuperAdminStatus(user, {
+                siteIds: targetSiteIds,
+            });
+            if (!isTrue) {
+                return capabilities.add(constants_1.DO_NOT_ALLOW);
+            }
+        }
+        return capabilities;
+    }
+    // manage_network_users
+    async canManageNetworkUsers(...args) {
+        const [capabilities, context, user, filterArgs] = args;
+        if (!context.config.isMultiSite()) {
+            capabilities.delete("manage_network_users");
+            return capabilities.add("edit_users");
+        }
+        const parsed = zod_1.z.array(zod_1.z.number()).safeParse(filterArgs);
+        if (!parsed.success) {
+            return capabilities;
+        }
+        const blogIds = parsed.data;
+        const siteIds = ((await context.utils.query.blogs((query) => {
+            query.whereIn("blog_id", blogIds);
+        })) ?? []).map((blog) => blog.site_id);
+        if (0 >= siteIds.length) {
+            return capabilities.add(constants_1.DO_NOT_ALLOW);
+        }
+        return await this.canManageSiteUsers(capabilities, context, "manage_site_users", user, siteIds);
+    }
+    // list_blog_users
+    async canListBlogUsers(...args) {
+        const [capabilities, context, action, user, filterArgs] = args;
+        if (action !== "list_blog_users") {
+            return capabilities;
+        }
+        capabilities.delete("list_blog_users");
+        if (!context.config.isMultiSite()) {
+            return capabilities.add("list_users");
+        }
+        let blogIds = [];
+        if (!filterArgs ||
+            !Array.isArray(filterArgs) ||
+            filterArgs.length !==
+                filterArgs.filter((v) => typeof v == "number").length) {
+            if (!context.current.blogId) {
+                return capabilities.add(constants_1.DO_NOT_ALLOW);
+            }
+            blogIds.push(context.current.blogId);
+        }
+        else {
+            blogIds = filterArgs;
+        }
+        if (!(await user.hasCapabilities(["list_users"], {
+            blogIds,
+        }))) {
+            return capabilities.add(constants_1.DO_NOT_ALLOW);
+        }
+        return capabilities;
+    }
+    // manage_blog_users
+    async canManageBlogUsers(...args) {
+        const [capabilities, context, action, user, ...filterArgs] = args;
+        if (action !== "manage_blog_users") {
+            return capabilities;
+        }
+        capabilities.delete("manage_blog_users");
+        const result = await this.canManageNetworkUsers(capabilities, context, user, ...filterArgs);
+        return result;
+    }
+    // manage_site_users
+    async canManageSiteUsers(...args) {
+        const [capabilities, context, action, user, filterArgs] = args;
+        if (action !== "manage_site_users") {
+            return capabilities;
+        }
+        capabilities.delete("manage_site_users");
+        if (!context.config.isMultiSite()) {
+            return capabilities.add("edit_users");
+        }
+        if (!filterArgs ||
+            !Array.isArray(filterArgs) ||
+            filterArgs.length !==
+                filterArgs.filter((v) => typeof v == "number").length) {
+            return capabilities;
+        }
+        const siteIds = filterArgs;
+        const userLogin = user?.props?.user_login;
+        if (!userLogin) {
+            return capabilities.add(constants_1.DO_NOT_ALLOW);
+        }
+        const [isTrue] = await context.utils.user.checkSuperAdminStatus(user, {
+            siteIds,
+        });
+        if (!isTrue) {
+            return capabilities.add(constants_1.DO_NOT_ALLOW);
+        }
+        return capabilities;
+    }
+    // edit_admin_roles
+    // manage_roles
+    async canEditAdminRole(...args) {
+        const [capabilities, context, action, user, filterArgs] = args;
+        if (action !== "edit_admin_roles" && action !== "manage_roles") {
+            return capabilities;
+        }
+        capabilities.delete("edit_admin_roles");
+        capabilities.delete("manage_roles");
+        if (!user.props?.user_login) {
+            return capabilities.add(constants_1.DO_NOT_ALLOW);
+        }
+        if (!context.config.isMultiSite()) {
+            capabilities.add("edit_users");
+            return capabilities;
+        }
+        // Check for superadmin in multisite
+        const blogId = filterArgs ?? context.current.blogId;
+        if (!blogId) {
+            return capabilities.add(constants_1.DO_NOT_ALLOW);
+        }
+        const [isTrue] = await context.utils.user.checkSuperAdminStatus(user, {
+            blogIds: [blogId],
+        });
+        if (!isTrue) {
+            return capabilities.add(constants_1.DO_NOT_ALLOW);
+        }
+        return capabilities;
+    }
+    // manage_network
+    // manage_network_options
+    async canManageNetwork(...args) {
+        const [capabilities, context, action, user, filterArgs] = args;
+        if (action !== "manage_network" && action !== "manage_network_options") {
+            return capabilities;
+        }
+        capabilities.delete("manage_network");
+        capabilities.delete("manage_network_options");
+        if (!context.config.isMultiSite()) {
+            const role = await user.role();
+            if (!role.isAdmin()) {
+                return capabilities.add(constants_1.DO_NOT_ALLOW);
+            }
+            return capabilities;
+        }
+        const parsed = zod_1.z.array(zod_1.z.number()).safeParse(filterArgs);
+        if (!parsed.success) {
+            return capabilities;
+        }
+        const siteIds = parsed.data;
+        const [isTrue] = await context.utils.user.checkSuperAdminStatus(user, {
+            siteIds,
+        });
+        if (!isTrue) {
+            return capabilities.add(constants_1.DO_NOT_ALLOW);
+        }
+        return capabilities;
+    }
+    // edit_user_roles
+    async canEditUserRole(...args) {
+        const [capabilities, context, action, user, filterArgs] = args;
+        if (action !== "edit_user_roles") {
+            return capabilities;
+        }
+        capabilities.delete("edit_user_roles");
+        if (!user?.props?.user_login) {
+            return capabilities.add(constants_1.DO_NOT_ALLOW);
+        }
+        if (!context.config.isMultiSite()) {
+            capabilities.add("promote_users");
+            capabilities.add("remove_users");
+            return capabilities;
+        }
+        const parsed = zod_1.z.array(zod_1.z.number()).safeParse(filterArgs);
+        if (!parsed.success) {
+            capabilities.add("promote_users");
+            capabilities.add("remove_users");
+            return capabilities;
+        }
+        const blogIds = parsed.data;
+        if (!(await user.hasCapabilities(["promote_users", "remove_users"], {
+            blogIds,
+        }))) {
+            return capabilities.add(constants_1.DO_NOT_ALLOW);
+        }
+        return capabilities;
+    }
+    // manage_sites
+    // delete_sites
+    // create_sites
+    // manage_options
+    async canManageBlogs(...args) {
+        const [capabilities, context, action, user, filterArgs] = args;
+        const actions = [
+            "manage_sites",
+            "delete_sites",
+            "create_sites",
+            "manage_options",
+        ];
+        if (!context.config.isMultiSite() || !actions.includes(action)) {
+            return capabilities;
+        }
+        const parsed = zod_1.z.array(zod_1.z.number()).safeParse(filterArgs);
+        if (!parsed.success) {
+            return capabilities;
+        }
+        const blogIds = parsed.data;
+        const [isTrue] = await context.utils.user.checkSuperAdminStatus(user, {
+            blogIds,
+        });
+        if (!isTrue) {
+            return capabilities.add(constants_1.DO_NOT_ALLOW);
+        }
+        capabilities.add(action);
+        return capabilities;
+    }
+    // manage_terms
+    // edit_terms
+    // delete_terms
+    // assign_terms
+    async canManageTerms(...args) {
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        const [capabilities, context, action, user, filterArgs] = args;
+        const actions = [
+            "manage_terms",
+            "edit_terms",
+            "delete_terms",
+            "assign_terms",
+        ];
+        if (!actions.includes(action)) {
+            return capabilities;
+        }
+        capabilities.delete(action);
+        capabilities.add("manage_categories");
+        return capabilities;
+    }
+    // create_users
+    async canCreateUsers(...args) {
+        const [capabilities, context, action, user, filterArgs] = args;
+        if (!context.config.isMultiSite() || action !== "create_users") {
+            return capabilities;
+        }
+        const parsed = zod_1.z.array(zod_1.z.number()).safeParse(filterArgs);
+        if (!parsed.success) {
+            return capabilities;
+        }
+        const siteIds = parsed.data;
+        const [isSuperAdmin] = await context.utils.user.checkSuperAdminStatus(user, {
+            siteIds,
+        });
+        // Check if a site allows admin to add new users
+        if (!isSuperAdmin) {
+            for (const siteId of siteIds) {
+                const canAddNewUser = await context.options.get("add_new_users", {
+                    siteId,
+                });
+                if (1 !== canAddNewUser) {
+                    return capabilities.add(constants_1.DO_NOT_ALLOW);
+                }
+            }
+        }
+        // core/capabilities.ts might've disallowed permission.
+        capabilities.delete(constants_1.DO_NOT_ALLOW);
+        capabilities.add(action);
+        return capabilities;
+    }
+};
+exports.Capabilities = Capabilities;
+__decorate([
+    (0, hooks_1.filter)("core_map_meta_cap_delete_user"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], Capabilities.prototype, "canDeleteUser", null);
+__decorate([
+    (0, hooks_1.filter)("core_map_meta_cap"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], Capabilities.prototype, "canManageNetworkUser", null);
+__decorate([
+    (0, hooks_1.filter)("core_map_meta_cap_manage_network_users"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], Capabilities.prototype, "canManageNetworkUsers", null);
+__decorate([
+    (0, hooks_1.filter)("core_map_meta_cap"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], Capabilities.prototype, "canListBlogUsers", null);
+__decorate([
+    (0, hooks_1.filter)("core_map_meta_cap"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], Capabilities.prototype, "canManageBlogUsers", null);
+__decorate([
+    (0, hooks_1.filter)("core_map_meta_cap"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], Capabilities.prototype, "canManageSiteUsers", null);
+__decorate([
+    (0, hooks_1.filter)("core_map_meta_cap"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], Capabilities.prototype, "canEditAdminRole", null);
+__decorate([
+    (0, hooks_1.filter)("core_map_meta_cap"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], Capabilities.prototype, "canManageNetwork", null);
+__decorate([
+    (0, hooks_1.filter)("core_map_meta_cap"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], Capabilities.prototype, "canEditUserRole", null);
+__decorate([
+    (0, hooks_1.filter)("core_map_meta_cap"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], Capabilities.prototype, "canManageBlogs", null);
+__decorate([
+    (0, hooks_1.filter)("core_map_meta_cap"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], Capabilities.prototype, "canManageTerms", null);
+__decorate([
+    (0, hooks_1.filter)("core_map_meta_cap"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], Capabilities.prototype, "canCreateUsers", null);
+exports.Capabilities = Capabilities = __decorate([
+    (0, hooks_1.hook)("core_filter_capabilities")
+], Capabilities);

package/core/hooks/hooks-command.d.ts

@@ -0,0 +1,9 @@
+import type * as types from "../../types";
+export declare class HooksCommand {
+    #private;
+    static createFilter<T1, T2 = null>(): types.hooks.CommandFilter<T1, T2>;
+    static createNamedFilter<T1 extends keyof types.hooks.Filters>(name: T1): types.hooks.FiltersReturnType<T1> extends Promise<any> ? types.hooks.CommandFilter<Promise<types.hooks.FilterParameters<T1>[0]>, types.hooks.CommandFilterSecondParam<T1>> : types.hooks.CommandFilter<types.hooks.FilterParameters<T1>[0], types.hooks.CommandFilterSecondParam<T1>>;
+    static createAction<P>(): types.hooks.CommandAction<P>;
+    static createNamedAction<T1 extends keyof types.hooks.Actions>(name: T1): types.hooks.CommandAction<types.hooks.ActionParameters<T1>>;
+}
+//# sourceMappingURL=hooks-command.d.ts.map

package/core/hooks/hooks-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-command.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/hooks-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAC;AAE1C,qBAAa,YAAY;;IAIvB,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,KAAK,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC;IAMvE,MAAM,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAGhE,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,SAAS,OAAO,CAAC,GAAG,CAAC,GACvD,KAAK,CAAC,KAAK,CAAC,aAAa,CACvB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAC5C,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CACzC,GACD,KAAK,CAAC,KAAK,CAAC,aAAa,CACvB,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EACnC,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CACzC;IAGP,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;IAMtD,MAAM,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAGhE,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;CAEnE"}

package/core/hooks/hooks-command.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HooksCommand = void 0;
+class HooksCommand {
+    static #idFilter = 0;
+    static #idAction = 0;
+    static createFilter() {
+        return {
+            id: `__command_LmnOp_filter_${this.#idFilter++}`,
+        };
+    }
+    static createNamedFilter(name) {
+        return {
+            id: name,
+        };
+    }
+    static createAction() {
+        return {
+            id: `__command_LmnOp_action_${this.#idAction++}`,
+        };
+    }
+    static createNamedAction(name) {
+        return {
+            id: name,
+        };
+    }
+}
+exports.HooksCommand = HooksCommand;

package/core/hooks/hooks-reflect.d.ts

@@ -0,0 +1,42 @@
+import "reflect-metadata";
+import { Action } from "./action";
+import { Filter } from "./filter";
+import type * as types from "../../types";
+export declare const FILTER: unique symbol;
+export declare const ACTION: unique symbol;
+/**
+ * Represents a class that provides reflection utilities for defining and registering hooks.
+ */
+export declare class HooksReflect {
+    /**
+     * Defines a hook for a given event name with the specified priority.
+     *
+     * @param metakey - The metadata key used for storing hook information.
+     * @param eventName - The name of the event.
+     * @param priority - The priority of the hook.
+     * @param args - The arguments containing the target, propertyKey, and descriptor.
+     */
+    private static define;
+    /**
+     * Defines a filter hook for a given event name with the specified priority.
+     * @param eventName - The name of the event.
+     * @param priority - The priority of the hook.
+     * @param args - The arguments containing the target, propertyKey, and descriptor.
+     */
+    static defineFilter(eventName: string, priority: number, args: [target: any, propertyKey: string, descriptor: PropertyDescriptor]): void;
+    /**
+     * Defines an action hook for a given event name.
+     * @param eventName - The name of the event.
+     * @param args - The arguments containing the target, propertyKey, and descriptor.
+     */
+    static defineAction(eventName: string, args: [target: any, propertyKey: string, descriptor: PropertyDescriptor]): void;
+    /**
+     * Registers the defined hooks for the given hook types, instance, and target.
+     *
+     * @param hookTypes - The hook types to register (filter and action).
+     * @param instance - The instance containing the hook methods.
+     * @param target - The target object to register the hooks on.
+     */
+    static register<TFilters = types.hooks.Filters, TActions = types.hooks.Actions>(hookTypes: [Filter<TFilters>, Action<TActions>], instance: any, target: any): void;
+}
+//# sourceMappingURL=hooks-reflect.d.ts.map

package/core/hooks/hooks-reflect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-reflect.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/hooks-reflect.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAC;AAG1C,eAAO,MAAM,MAAM,eAAkC,CAAC;AACtD,eAAO,MAAM,MAAM,eAAkC,CAAC;AAItD;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,MAAM;IAuBrB;;;;;OAKG;WACW,YAAY,CACxB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,CAAC;IAK1E;;;;OAIG;WACW,YAAY,CACxB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,CAAC;IAK1E;;;;;;OAMG;WACW,QAAQ,CACpB,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,EAC9B,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,EAE9B,SAAS,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,EAC/C,QAAQ,EAAE,GAAG,EACb,MAAM,EAAE,GAAG;CAkBd"}

package/core/hooks/hooks-reflect.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HooksReflect = exports.ACTION = exports.FILTER = void 0;
+require("reflect-metadata");
+const prefix = "__REFLECT_METADATA_KEY_HOOKS_";
+exports.FILTER = Symbol.for(`${prefix}FILTER__`);
+exports.ACTION = Symbol.for(`${prefix}ACTION__`);
+/**
+ * Represents a class that provides reflection utilities for defining and registering hooks.
+ */
+class HooksReflect {
+    /**
+     * Defines a hook for a given event name with the specified priority.
+     *
+     * @param metakey - The metadata key used for storing hook information.
+     * @param eventName - The name of the event.
+     * @param priority - The priority of the hook.
+     * @param args - The arguments containing the target, propertyKey, and descriptor.
+     */
+    static define(metakey, eventName, priority, args) {
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        const [target, propertyKey, descriptor] = args;
+        const hookMap = Reflect.getMetadata(metakey, target.constructor) ?? new Map();
+        const hooks = hookMap.get(eventName) ?? [];
+        if (hooks.includes([priority, propertyKey])) {
+            return;
+        }
+        hookMap.set(eventName, [...hooks, [priority, propertyKey]]);
+        Reflect.defineMetadata(metakey, hookMap, target.constructor);
+    }
+    /**
+     * Defines a filter hook for a given event name with the specified priority.
+     * @param eventName - The name of the event.
+     * @param priority - The priority of the hook.
+     * @param args - The arguments containing the target, propertyKey, and descriptor.
+     */
+    static defineFilter(eventName, priority, args) {
+        HooksReflect.define(exports.FILTER, eventName, priority, args);
+    }
+    /**
+     * Defines an action hook for a given event name.
+     * @param eventName - The name of the event.
+     * @param args - The arguments containing the target, propertyKey, and descriptor.
+     */
+    static defineAction(eventName, args) {
+        HooksReflect.define(exports.ACTION, eventName, 0, args);
+    }
+    /**
+     * Registers the defined hooks for the given hook types, instance, and target.
+     *
+     * @param hookTypes - The hook types to register (filter and action).
+     * @param instance - The instance containing the hook methods.
+     * @param target - The target object to register the hooks on.
+     */
+    static register(hookTypes, instance, target) {
+        const [filter, action] = hookTypes;
+        for (const metakey of [exports.FILTER, exports.ACTION]) {
+            const hookMap = Reflect.getMetadata(metakey, target);
+            for (const [eventName, values] of hookMap ?? []) {
+                values.forEach(([priority, propertyKey]) => {
+                    const listener = instance[propertyKey].bind(instance);
+                    if (metakey === exports.FILTER) {
+                        filter.add(eventName, listener, priority);
+                    }
+                    else if (metakey === exports.ACTION) {
+                        action.add(eventName, listener);
+                    }
+                });
+            }
+        }
+    }
+}
+exports.HooksReflect = HooksReflect;

package/core/hooks/hooks.d.ts

@@ -0,0 +1,61 @@
+import type * as types from "../../types";
+import { Action } from "./action";
+import { Filter } from "./filter";
+/**
+ * Represents a collection of hooks for filtering and actions.
+ *
+ * TFilters - The type of filters.
+ * TActions - The type of actions.
+ */
+export declare class Hooks<TFilters = types.hooks.Filters, TActions = types.hooks.Actions> {
+    #private;
+    hooks: Map<string, types.Constructor>;
+    /**
+     * The map of hooks for each environment.
+     *
+     * @remarks The structure of the map is as follows:
+     * - The key is the environment.
+     * - The value is a map of hooks.
+     *   - The key is the name of the hook which should be unique across all hooks.
+     *   - The value is the hook class where its methods are decorated with `@filter` or `@action`.
+     * @example
+     * ```ts
+     * @hook("example")
+     * class ExampleHook {
+     *    @filter("example_filter")
+     *    async exampleFilter(n: number) {
+     *        return n + 10;
+     *    }
+     * }
+     * ```
+     */
+    static hooksEnvMap: Map<string, Map<string, types.Constructor>>;
+    /**
+     * Retrieves the hook map for the specified environment.
+     *
+     * @param env - The environment for which to retrieve the hook map.
+     * @returns The hook map for the specified environment.
+     */
+    static get(env: string): Map<string, types.Constructor<any>>;
+    /**
+     * Sets the hook map for the specified environment.
+     *
+     * @param env - The environment for which to set the hook map.
+     * @param hookMap - The hook map to set.
+     */
+    static set(env: string, hookMap: Map<string, types.Constructor>): void;
+    action: Action<TActions>;
+    filter: Filter<TFilters>;
+    /**
+     * Creates an instance of Hooks.
+     *
+     * @param hooks - The map of hooks.
+     */
+    constructor(hooks: Map<string, types.Constructor>);
+    /**
+     * Initializes the hooks.
+     * If the hooks have already been initialized, this method does nothing.
+     */
+    init(): void;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/core/hooks/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC;;;;;GAKG;AACH,qBAAa,KAAK,CAChB,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,EAC9B,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO;;IAsDX,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC;IApDxD;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAa;IAE5E;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM;IAMtB;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC;IAK/D,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEzB;;;;OAIG;gBACgB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC;IAKxD;;;OAGG;IACH,IAAI;CAWL"}