@asterflow/plugin 1.0.2 → 1.0.4

package/README.md

@@ -4,12 +4,8 @@
 
 ![license-info](https://img.shields.io/github/license/AsterFlow/AsterFlow?style=for-the-badge&colorA=302D41&colorB=f9e2af&logoColor=f9e2af)
 ![stars-info](https://img.shields.io/github/stars/AsterFlow/AsterFlow?colorA=302D41&colorB=f9e2af&style=for-the-badge)
+![last-commit](https://img.shields.io/github/last-commit/AsterFlow/AsterFlow?path=packages%2Fresponse&style=for-the-badge&colorA=302D41&colorB=b4befe)
 
-![last-commit](https://img.shields.io/github/last-commit/AsterFlow/AsterFlow?style=for-the-badge&colorA=302D41&colorB=b4befe)
-![commit-activity](https://img.shields.io/github/commit-activity/y/AsterFlow/AsterFlow?style=for-the-badge&colorA=302D41&colorB=f9e2af)
-![code-size](https://img.shields.io/github/languages/code-size/AsterFlow/AsterFlow?style=for-the-badge&colorA=302D41&colorB=90dceb)
-
-![top-language](https://img.shields.io/github/languages/top/AsterFlow/AsterFlow?style=for-the-badge&colorA=302D41&colorB=90dceb)
 ![bundle-size](https://img.shields.io/bundlejs/size/@asterflow/plugin?style=for-the-badge&colorA=302D41&colorB=3ac97b)
 
 </div>

package/dist/types/controllers/Plugin.d.ts

@@ -1,10 +1,5 @@
 import type { AnyAsterflow, ExtendedAsterflow } from '@asterflow/core';
 import type { PluginHooks, Resolver } from '../types/plugin';
-/**
- * A factory for creating plugins that can be configured and attached to AsterFlow.
- * Plugins are defined with a series of resolvers (`decorate`, `derive`) and lifecycle
- * hooks (`on`) that build up its context and runtime behavior.
- */
 export declare class Plugin<Path extends string, Instance extends AnyAsterflow, Config extends Record<string, any> = {}, Context extends Record<string, any> = {}, Hooks extends PluginHooks<any, Context[], any> = {}, Extension extends Record<string, any> = {}> {
     readonly name: Path;
     private readonly resolvers;
@@ -41,13 +36,13 @@ export declare class Plugin<Path extends string, Instance extends AnyAsterflow,
      *   .on('beforeInitialize', (app, context) => { })
      *   .on('beforeInitialize', (app, context) => { });
      */
-    on<Event extends keyof PluginHooks<ExtendedAsterflow<Instance>, Context & Config, Extension>, Handler extends NonNullable<PluginHooks<ExtendedAsterflow<Instance>, Context & Config, Extension>[Event]> extends (infer F)[] ? F : never>(event: Event, handler: Handler): Plugin<Path, Instance, Config, Context, Omit<Hooks, Event> & { [K in Event]: [...Hooks extends { [k in Event]: any[]; } ? Hooks[K] : [], Handler]; }, Extension>;
+    on<Event extends keyof PluginHooks<ExtendedAsterflow<Instance>, Context & Config, Extension>>(event: Event, handler: NonNullable<PluginHooks<ExtendedAsterflow<Instance>, Context & Config, Extension>[Event]>[number]): Plugin<Path, Instance, Config, Context, Omit<Hooks, Event> & { [K in Event]: [...Hooks extends { [k in Event]: any[]; } ? Hooks[K] : []]; }, Extension>;
     /**
      * Defines new properties or methods to be added to the AsterFlow instance.
      * A função recebe a instância do app e o contexto do plugin, e deve retornar um objeto
      * com as novas propriedades.
      */
-    extends<E extends Record<string, any>>(extensionFn: (app: Instance, context: Context) => E): Plugin<Path, Instance, Config, Context, Hooks, Extension & E>;
+    extends<E extends Record<string, any>>(extensionFn: (app: ExtendedAsterflow<Instance>, context: Context) => E): Plugin<Path, ExtendedAsterflow<Instance>, Config, Context, Hooks, Extension & E>;
     /**
      * Builds the final context and hooks from the provided configuration.
      */

package/dist/types/types/plugin.d.ts

@@ -1,10 +1,14 @@
+import type { Runtime } from '@asterflow/adapter';
 import type { AnyAsterflow, ExtendedAsterflow } from '@asterflow/core';
 import type { Request } from '@asterflow/request';
-import type { Response } from '@asterflow/response';
+import type { AsterResponse } from '@asterflow/response';
 import type { Plugin } from '../controllers/Plugin';
 export type AnyPlugin = Plugin<string, any, any, any, any, any>;
 export type AnyPlugins = Record<string, ResolvedPlugin<AnyPlugin>>;
-export type AnyPluginHooks = PluginHooks<any, any>;
+export type AnyPluginHooks = PluginHooks<any, any, any>;
+export type AnyPluginInstance = ResolvedPlugin<AnyPlugin> & {
+    hooks: AnyPluginHooks;
+};
 export type InferPluginExtension<P> = P extends Plugin<any, any, any, any, any, infer Ext> ? Ext : {};
 export type ResolvedPlugin<P extends AnyPlugin> = P extends Plugin<infer Path, any, any, infer Ctx, any, infer Ext> ? {
     name: Path;
@@ -17,18 +21,25 @@ export type ResolvedPlugin<P extends AnyPlugin> = P extends Plugin<infer Path, a
  * Tipo para extrair o objeto de configuração de um plugin.
  * Ele torna as propriedades com valores padrão opcionais.
  */
-export type ConfigArgument<P extends AnyPlugin> = P extends Plugin<any, any, infer C, any, any> ? Omit<C, keyof P['defaultConfig']> & Partial<Pick<C, keyof P['defaultConfig'] & keyof C>> : never;
+export type InferConfigArgument<P extends AnyPlugin> = P extends Plugin<any, any, infer C, any, any> ? Omit<C, keyof P['defaultConfig']> & Partial<Pick<C, keyof P['defaultConfig'] & keyof C>> : never;
 /**
  * Defines the available lifecycle hooks a plugin can register.
  */
 export type PluginHooks<Instance extends AnyAsterflow, Context extends Record<string, any>, Extension extends Record<string, any> = {}> = {
     beforeInitialize?: ((app: ExtendedAsterflow<Instance> & Extension, context: Context) => void | Promise<void>)[];
     afterInitialize?: ((app: ExtendedAsterflow<Instance> & Extension, context: Context) => void | Promise<void>)[];
-    onRequest?: ((request: Request<unknown>, response: Response, context: Context) => void | Promise<void>)[];
-    onResponse?: ((request: Request<unknown>, response: Response, context: Context) => void | Promise<void>)[];
+    onRequest?: (({ context, request, response }: {
+        request: Request<Runtime>;
+        response: AsterResponse;
+        context: Context;
+    }) => void | Promise<void>)[];
+    onResponse?: (({ context, request, response }: {
+        request: Request<Runtime>;
+        response: AsterResponse;
+        context: Context;
+    }) => void | Promise<void>)[];
 };
 /**
  * Represents a function that resolves a part of the plugin's context.
- * @internal
  */
 export type Resolver = (config: any, context: any) => Promise<Record<string, any>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asterflow/plugin",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "main": "dist/cjs/index.cjs",
   "module": "dist/mjs/index.js",
   "types": "dist/types/index.d.ts",
@@ -18,9 +18,9 @@
     "node": ">=20"
   },
   "devDependencies": {
-    "@asterflow/core": "1.0.6",
-    "@asterflow/response": "1.0.3",
-    "@asterflow/request": "1.0.6"
+    "@asterflow/core": "1.0.8",
+    "@asterflow/response": "1.0.5",
+    "@asterflow/request": "1.0.8"
   },
   "peerDependencies": {
     "typescript": "^5.8.3"