@qlover/fe-corekit 3.0.1 → 3.1.1

package/dist/index.d.ts

@@ -6848,6 +6848,16 @@ type RequestAdapterContext = ExecutorContextInterface<RequestAdapterConfig, unkn
  * ```
  */
 type RequestPluginConfig = HeaderInjectorConfig & {
+    /**
+     * Allow empty URL
+     *
+     * If set to `false`, an error will be thrown when both `url` and `baseURL` are empty.
+     * If set to `true` (default), the URL builder will attempt to build the URL even if they are empty.
+     *
+     * @since 3.1.0
+     * @default `true`
+     */
+    allowEmptyUrl?: boolean;
     requestDataSerializer?: (data: unknown, config: RequestAdapterConfig & Omit<RequestPluginConfig, 'requestDataSerializer'>) => unknown;
 };
 interface RequestPluginInnerConfig {
@@ -6947,6 +6957,16 @@ declare class RequestPlugin implements LifecyclePluginInterface<RequestAdapterCo
      * @override
      */
     onBefore(ctx: RequestAdapterContext): void;
+    /**
+     * Main request handler
+     *
+     * This is the core of the plugin. It merges default plugin configuration with request context configuration,
+     * processes request data, builds the URL, and injects headers.
+     *
+     * @param config - Request configuration
+     * @returns Merged configuration with processed data, built URL, and injected headers
+     */
+    mergeConfig(config: RequestAdapterConfig & RequestPluginConfig): RequestAdapterConfig & RequestPluginConfig;
     /**
      * Merge default plugin configuration with request context configuration
      *
@@ -6959,7 +6979,7 @@ declare class RequestPlugin implements LifecyclePluginInterface<RequestAdapterCo
      * @param contextConfig - Configuration from request context
      * @returns Merged configuration
      */
-    protected mergeConfig(contextConfig: RequestAdapterConfig): RequestAdapterConfig & RequestPluginConfig;
+    protected createConfig(contextConfig: RequestAdapterConfig): RequestAdapterConfig & RequestPluginConfig;
     /**
      * Build the URL from the request configuration
      *
@@ -6967,7 +6987,7 @@ declare class RequestPlugin implements LifecyclePluginInterface<RequestAdapterCo
      * @returns The built URL
      * @throws {Error} If the built URL is empty or invalid
      */
-    protected buildUrl(config: RequestAdapterConfig): string;
+    protected buildUrl(config: RequestAdapterConfig & RequestPluginConfig): string;
     /**
      * Inject default headers into request configuration
      *
@@ -7263,6 +7283,7 @@ declare class ResponsePlugin implements LifecyclePluginInterface<ResponsePluginC
      * ```
      */
     onSuccess(context: ResponsePluginContext): Promise<void>;
+    handleResponse(returnValue: unknown, config: ResponsePluginConfig & RequestAdapterConfig<unknown>): Promise<RequestAdapterResponse> | undefined;
     /**
      * Validate response status
      *