@spoosh/angular 0.3.0 → 0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # @spoosh/angular
 
-Angular signals integration for Spoosh - `injectRead`, `injectWrite`, and `injectInfiniteRead`.
+Angular signals integration for Spoosh - `injectRead`, `injectLazyRead`, `injectWrite`, and `injectInfiniteRead`.
 
 **[Documentation](https://spoosh.dev/docs/integrations/angular)** · **Requirements:** TypeScript >= 5.0, Angular >= 16.0
 
@@ -23,13 +23,13 @@ const spoosh = new Spoosh<ApiSchema, Error>("/api").use([
   cachePlugin({ staleTime: 5000 }),
 ]);
 
-export const { injectRead, injectWrite, injectInfiniteRead } =
+export const { injectRead, injectLazyRead, injectWrite, injectInfiniteRead } =
   createAngularSpoosh(spoosh);
 ```
 
 ### injectRead
 
-Fetch data with automatic caching and refetching using Angular signals.
+Fetch data with automatic caching and triggering using Angular signals.
 
 ```typescript
 @Component({
@@ -74,6 +74,28 @@ export class UserListComponent {
 }
 ```
 
+### injectLazyRead
+
+Lazy data fetching for print/download/export scenarios. Does not auto-fetch on mount.
+
+```typescript
+@Component({
+  template: `
+    <button (click)="handlePrint('123')" [disabled]="order.loading()">
+      {{ order.loading() ? "Loading..." : "Print" }}
+    </button>
+  `,
+})
+export class PrintOrderComponent {
+  order = injectLazyRead((api) => api("orders/:id").GET);
+
+  async handlePrint(orderId: string) {
+    const { data } = await this.order.trigger({ params: { id: orderId } });
+    if (data) this.printService.printReceipt(data);
+  }
+}
+```
+
 ### injectWrite
 
 Trigger mutations with loading and error states.
@@ -187,7 +209,7 @@ export class PostListComponent {
 | `loading`  | `Signal<boolean>`             | True during initial load                  |
 | `fetching` | `Signal<boolean>`             | True during any fetch                     |
 | `meta`     | `Signal<PluginResults>`       | Plugin metadata (e.g., `transformedData`) |
-| `refetch`  | `() => Promise`               | Manually trigger refetch                  |
+| `trigger`  | `() => Promise`               | Manually trigger fetch                    |
 | `abort`    | `() => void`                  | Abort current request                     |
 
 ### injectWrite(writeFn)
@@ -202,7 +224,6 @@ export class PostListComponent {
 | `loading` | `Signal<boolean>`             | True while mutation is in progress |
 | `meta`    | `Signal<PluginResults>`       | Plugin metadata                    |
 | `input`   | `TriggerOptions \| undefined` | Last trigger input                 |
-| `reset`   | `() => void`                  | Reset state                        |
 | `abort`   | `() => void`                  | Abort current request              |
 
 ### injectInfiniteRead(readFn, options)

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _spoosh_core from '@spoosh/core';
-import { PluginArray, StateManager, EventEmitter, PluginExecutor, ReadClient, SpooshResponse, WriteClient, MethodOptionsMap, CoreRequestOptionsBase, SpooshPlugin, PluginTypeConfig, InfiniteRequestOptions, ResolveTypes, ResolverContext, ResolveResultTypes, MergePluginInstanceApi } from '@spoosh/core';
+import { PluginArray, StateManager, EventEmitter, PluginExecutor, ReadClient, TagOptions, SpooshResponse, WriteClient, MethodOptionsMap, CoreRequestOptionsBase, SpooshPlugin, PluginTypeConfig, InfiniteRequestOptions, ResolveTypes, ResolverContext, ResolveResultTypes, MergePluginInstanceApi } from '@spoosh/core';
 import { Signal } from '@angular/core';
 
 interface SpooshInstanceShape<TApi, TSchema, TDefaultError, TPlugins extends PluginArray> {
@@ -14,10 +14,8 @@ interface SpooshInstanceShape<TApi, TSchema, TDefaultError, TPlugins extends Plu
     };
 }
 type EnabledOption = boolean | (() => boolean);
-interface BaseReadOptions {
+interface BaseReadOptions extends TagOptions {
     enabled?: EnabledOption;
-    tags?: string[];
-    additionalTags?: string[];
 }
 interface BaseReadResult<TData, TError, TPluginResult = Record<string, unknown>> {
     data: Signal<TData | undefined>;
@@ -26,7 +24,7 @@ interface BaseReadResult<TData, TError, TPluginResult = Record<string, unknown>>
     fetching: Signal<boolean>;
     meta: Signal<TPluginResult>;
     abort: () => void;
-    refetch: () => Promise<SpooshResponse<TData, TError>>;
+    trigger: () => Promise<SpooshResponse<TData, TError>>;
 }
 interface BaseWriteResult<TData, TError, TOptions, TPluginResult = Record<string, unknown>> {
     trigger: (options?: TOptions) => Promise<SpooshResponse<TData, TError>>;
@@ -34,7 +32,13 @@ interface BaseWriteResult<TData, TError, TOptions, TPluginResult = Record<string
     error: Signal<TError | undefined>;
     loading: Signal<boolean>;
     meta: Signal<TPluginResult>;
-    reset: () => void;
+    abort: () => void;
+}
+interface BaseLazyReadResult<TData, TError, TOptions> {
+    trigger: (options?: TOptions) => Promise<SpooshResponse<TData, TError>>;
+    data: Signal<TData | undefined>;
+    error: Signal<TError | undefined>;
+    loading: Signal<boolean>;
     abort: () => void;
 }
 type PageContext<TData, TRequest> = {
@@ -42,7 +46,8 @@ type PageContext<TData, TRequest> = {
     allResponses: TData[];
     request: TRequest;
 };
-interface BaseInfiniteReadOptions<TData, TItem, TRequest> extends BaseReadOptions {
+interface BaseInfiniteReadOptions<TData, TItem, TRequest> extends TagOptions {
+    enabled?: EnabledOption;
     canFetchNext: (ctx: PageContext<TData, TRequest>) => boolean;
     canFetchPrev?: (ctx: PageContext<TData, TRequest>) => boolean;
     nextPageRequest: (ctx: PageContext<TData, TRequest>) => Partial<TRequest>;
@@ -62,7 +67,7 @@ interface BaseInfiniteReadResult<TData, TError, TItem, TPluginResult = Record<st
     meta: Signal<TPluginResult>;
     fetchNext: () => Promise<void>;
     fetchPrev: () => Promise<void>;
-    refetch: () => Promise<void>;
+    trigger: () => Promise<void>;
     abort: () => void;
 }
 type QueryRequestOptions = CoreRequestOptionsBase;
@@ -149,6 +154,23 @@ type ExtractMethodBody<T> = ExtractMethodOptions<T> extends {
     body: infer B;
 } ? B : never;
 
+declare function createInjectLazyRead<TSchema, TDefaultError, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]>(options: Omit<SpooshInstanceShape<unknown, TSchema, TDefaultError, TPlugins>, "_types">): <TMethod extends (...args: never[]) => Promise<SpooshResponse<unknown, unknown>>>(readFn: (api: ReadApiClient<TSchema, TDefaultError>) => TMethod) => BaseLazyReadResult<TMethod extends (...args: never[]) => infer R ? Extract<Awaited<R>, {
+    data: unknown;
+    error?: undefined;
+}> extends {
+    data: infer D;
+} ? D : unknown : unknown, [TMethod extends (...args: never[]) => infer R_1 ? Extract<Awaited<R_1>, {
+    error: unknown;
+    data?: undefined;
+}> extends {
+    error: infer E;
+} ? E : unknown : unknown] extends [unknown] ? TDefaultError : TMethod extends (...args: never[]) => infer R_1 ? Extract<Awaited<R_1>, {
+    error: unknown;
+    data?: undefined;
+}> extends {
+    error: infer E;
+} ? E : unknown : unknown, TMethod extends (...args: infer A) => unknown ? A[0] extends object ? Pick<A[0], Extract<keyof A[0], "query" | "body" | "params">> : object : object> & WriteResponseInputFields<ExtractResponseQuery<TMethod>, ExtractResponseBody<TMethod>, ExtractResponseParamNames<TMethod>>;
+
 type AnyInfiniteRequestOptions = InfiniteRequestOptions;
 declare function createInjectInfiniteRead<TSchema, TDefaultError, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]>(options: Omit<SpooshInstanceShape<unknown, TSchema, TDefaultError, TPlugins>, "_types">): <TReadFn extends (api: ReadApiClient<TSchema, TDefaultError>) => Promise<SpooshResponse<unknown, unknown>>, TRequest extends AnyInfiniteRequestOptions = AnyInfiniteRequestOptions, TItem = unknown>(readFn: TReadFn, readOptions: BaseInfiniteReadOptions<TReadFn extends (...args: never[]) => infer R ? Extract<Awaited<R>, {
     data: unknown;
@@ -320,8 +342,9 @@ type SpooshAngularFunctions<TDefaultError, TSchema, TPlugins extends PluginArray
     injectRead: ReturnType<typeof createInjectRead<TSchema, TDefaultError, TPlugins>>;
     injectWrite: ReturnType<typeof createInjectWrite<TSchema, TDefaultError, TPlugins>>;
     injectInfiniteRead: ReturnType<typeof createInjectInfiniteRead<TSchema, TDefaultError, TPlugins>>;
+    injectLazyRead: ReturnType<typeof createInjectLazyRead<TSchema, TDefaultError, TPlugins>>;
 } & MergePluginInstanceApi<TPlugins, TSchema>;
 
 declare function createAngularSpoosh<TSchema, TDefaultError, TPlugins extends PluginArray, TApi>(instance: SpooshInstanceShape<TApi, TSchema, TDefaultError, TPlugins>): SpooshAngularFunctions<TDefaultError, TSchema, TPlugins>;
 
-export { type AngularOptionsMap, type BaseInfiniteReadOptions, type BaseInfiniteReadResult, type BaseReadOptions, type BaseReadResult, type BaseWriteResult, type EnabledOption, type ExtractMethodBody, type ExtractMethodData, type ExtractMethodError, type ExtractMethodOptions, type ExtractMethodQuery, type ExtractResponseBody, type ExtractResponseParamNames, type ExtractResponseQuery, type PageContext, type ReadApiClient, type ResponseInputFields, type SpooshInstanceShape, type WriteApiClient, type WriteResponseInputFields, createAngularSpoosh };
+export { type AngularOptionsMap, type BaseInfiniteReadOptions, type BaseInfiniteReadResult, type BaseLazyReadResult, type BaseReadOptions, type BaseReadResult, type BaseWriteResult, type EnabledOption, type ExtractMethodBody, type ExtractMethodData, type ExtractMethodError, type ExtractMethodOptions, type ExtractMethodQuery, type ExtractResponseBody, type ExtractResponseParamNames, type ExtractResponseQuery, type PageContext, type ReadApiClient, type ResponseInputFields, type SpooshInstanceShape, type WriteApiClient, type WriteResponseInputFields, createAngularSpoosh };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _spoosh_core from '@spoosh/core';
-import { PluginArray, StateManager, EventEmitter, PluginExecutor, ReadClient, SpooshResponse, WriteClient, MethodOptionsMap, CoreRequestOptionsBase, SpooshPlugin, PluginTypeConfig, InfiniteRequestOptions, ResolveTypes, ResolverContext, ResolveResultTypes, MergePluginInstanceApi } from '@spoosh/core';
+import { PluginArray, StateManager, EventEmitter, PluginExecutor, ReadClient, TagOptions, SpooshResponse, WriteClient, MethodOptionsMap, CoreRequestOptionsBase, SpooshPlugin, PluginTypeConfig, InfiniteRequestOptions, ResolveTypes, ResolverContext, ResolveResultTypes, MergePluginInstanceApi } from '@spoosh/core';
 import { Signal } from '@angular/core';
 
 interface SpooshInstanceShape<TApi, TSchema, TDefaultError, TPlugins extends PluginArray> {
@@ -14,10 +14,8 @@ interface SpooshInstanceShape<TApi, TSchema, TDefaultError, TPlugins extends Plu
     };
 }
 type EnabledOption = boolean | (() => boolean);
-interface BaseReadOptions {
+interface BaseReadOptions extends TagOptions {
     enabled?: EnabledOption;
-    tags?: string[];
-    additionalTags?: string[];
 }
 interface BaseReadResult<TData, TError, TPluginResult = Record<string, unknown>> {
     data: Signal<TData | undefined>;
@@ -26,7 +24,7 @@ interface BaseReadResult<TData, TError, TPluginResult = Record<string, unknown>>
     fetching: Signal<boolean>;
     meta: Signal<TPluginResult>;
     abort: () => void;
-    refetch: () => Promise<SpooshResponse<TData, TError>>;
+    trigger: () => Promise<SpooshResponse<TData, TError>>;
 }
 interface BaseWriteResult<TData, TError, TOptions, TPluginResult = Record<string, unknown>> {
     trigger: (options?: TOptions) => Promise<SpooshResponse<TData, TError>>;
@@ -34,7 +32,13 @@ interface BaseWriteResult<TData, TError, TOptions, TPluginResult = Record<string
     error: Signal<TError | undefined>;
     loading: Signal<boolean>;
     meta: Signal<TPluginResult>;
-    reset: () => void;
+    abort: () => void;
+}
+interface BaseLazyReadResult<TData, TError, TOptions> {
+    trigger: (options?: TOptions) => Promise<SpooshResponse<TData, TError>>;
+    data: Signal<TData | undefined>;
+    error: Signal<TError | undefined>;
+    loading: Signal<boolean>;
     abort: () => void;
 }
 type PageContext<TData, TRequest> = {
@@ -42,7 +46,8 @@ type PageContext<TData, TRequest> = {
     allResponses: TData[];
     request: TRequest;
 };
-interface BaseInfiniteReadOptions<TData, TItem, TRequest> extends BaseReadOptions {
+interface BaseInfiniteReadOptions<TData, TItem, TRequest> extends TagOptions {
+    enabled?: EnabledOption;
     canFetchNext: (ctx: PageContext<TData, TRequest>) => boolean;
     canFetchPrev?: (ctx: PageContext<TData, TRequest>) => boolean;
     nextPageRequest: (ctx: PageContext<TData, TRequest>) => Partial<TRequest>;
@@ -62,7 +67,7 @@ interface BaseInfiniteReadResult<TData, TError, TItem, TPluginResult = Record<st
     meta: Signal<TPluginResult>;
     fetchNext: () => Promise<void>;
     fetchPrev: () => Promise<void>;
-    refetch: () => Promise<void>;
+    trigger: () => Promise<void>;
     abort: () => void;
 }
 type QueryRequestOptions = CoreRequestOptionsBase;
@@ -149,6 +154,23 @@ type ExtractMethodBody<T> = ExtractMethodOptions<T> extends {
     body: infer B;
 } ? B : never;
 
+declare function createInjectLazyRead<TSchema, TDefaultError, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]>(options: Omit<SpooshInstanceShape<unknown, TSchema, TDefaultError, TPlugins>, "_types">): <TMethod extends (...args: never[]) => Promise<SpooshResponse<unknown, unknown>>>(readFn: (api: ReadApiClient<TSchema, TDefaultError>) => TMethod) => BaseLazyReadResult<TMethod extends (...args: never[]) => infer R ? Extract<Awaited<R>, {
+    data: unknown;
+    error?: undefined;
+}> extends {
+    data: infer D;
+} ? D : unknown : unknown, [TMethod extends (...args: never[]) => infer R_1 ? Extract<Awaited<R_1>, {
+    error: unknown;
+    data?: undefined;
+}> extends {
+    error: infer E;
+} ? E : unknown : unknown] extends [unknown] ? TDefaultError : TMethod extends (...args: never[]) => infer R_1 ? Extract<Awaited<R_1>, {
+    error: unknown;
+    data?: undefined;
+}> extends {
+    error: infer E;
+} ? E : unknown : unknown, TMethod extends (...args: infer A) => unknown ? A[0] extends object ? Pick<A[0], Extract<keyof A[0], "query" | "body" | "params">> : object : object> & WriteResponseInputFields<ExtractResponseQuery<TMethod>, ExtractResponseBody<TMethod>, ExtractResponseParamNames<TMethod>>;
+
 type AnyInfiniteRequestOptions = InfiniteRequestOptions;
 declare function createInjectInfiniteRead<TSchema, TDefaultError, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]>(options: Omit<SpooshInstanceShape<unknown, TSchema, TDefaultError, TPlugins>, "_types">): <TReadFn extends (api: ReadApiClient<TSchema, TDefaultError>) => Promise<SpooshResponse<unknown, unknown>>, TRequest extends AnyInfiniteRequestOptions = AnyInfiniteRequestOptions, TItem = unknown>(readFn: TReadFn, readOptions: BaseInfiniteReadOptions<TReadFn extends (...args: never[]) => infer R ? Extract<Awaited<R>, {
     data: unknown;
@@ -320,8 +342,9 @@ type SpooshAngularFunctions<TDefaultError, TSchema, TPlugins extends PluginArray
     injectRead: ReturnType<typeof createInjectRead<TSchema, TDefaultError, TPlugins>>;
     injectWrite: ReturnType<typeof createInjectWrite<TSchema, TDefaultError, TPlugins>>;
     injectInfiniteRead: ReturnType<typeof createInjectInfiniteRead<TSchema, TDefaultError, TPlugins>>;
+    injectLazyRead: ReturnType<typeof createInjectLazyRead<TSchema, TDefaultError, TPlugins>>;
 } & MergePluginInstanceApi<TPlugins, TSchema>;
 
 declare function createAngularSpoosh<TSchema, TDefaultError, TPlugins extends PluginArray, TApi>(instance: SpooshInstanceShape<TApi, TSchema, TDefaultError, TPlugins>): SpooshAngularFunctions<TDefaultError, TSchema, TPlugins>;
 
-export { type AngularOptionsMap, type BaseInfiniteReadOptions, type BaseInfiniteReadResult, type BaseReadOptions, type BaseReadResult, type BaseWriteResult, type EnabledOption, type ExtractMethodBody, type ExtractMethodData, type ExtractMethodError, type ExtractMethodOptions, type ExtractMethodQuery, type ExtractResponseBody, type ExtractResponseParamNames, type ExtractResponseQuery, type PageContext, type ReadApiClient, type ResponseInputFields, type SpooshInstanceShape, type WriteApiClient, type WriteResponseInputFields, createAngularSpoosh };
+export { type AngularOptionsMap, type BaseInfiniteReadOptions, type BaseInfiniteReadResult, type BaseLazyReadResult, type BaseReadOptions, type BaseReadResult, type BaseWriteResult, type EnabledOption, type ExtractMethodBody, type ExtractMethodData, type ExtractMethodError, type ExtractMethodOptions, type ExtractMethodQuery, type ExtractResponseBody, type ExtractResponseParamNames, type ExtractResponseQuery, type PageContext, type ReadApiClient, type ResponseInputFields, type SpooshInstanceShape, type WriteApiClient, type WriteResponseInputFields, createAngularSpoosh };

package/dist/index.js

@@ -33,8 +33,7 @@ function createInjectRead(options) {
     const destroyRef = (0, import_core.inject)(import_core.DestroyRef);
     const {
       enabled: enabledOption = true,
-      tags = void 0,
-      additionalTags = void 0,
+      tags,
       ...pluginOpts
     } = readOptions ?? {};
     const getEnabled = () => typeof enabledOption === "function" ? enabledOption() : enabledOption;
@@ -137,7 +136,7 @@ function createInjectRead(options) {
       initialRequestOptions?.params
     );
     const initialResolvedTags = (0, import_core2.resolveTags)(
-      { tags, additionalTags },
+      tags !== void 0 ? { tags } : void 0,
       initialResolvedPath
     );
     const initialQueryKey = stateManager.createQueryKey({
@@ -162,7 +161,7 @@ function createInjectRead(options) {
         const pathSegments = capturedCall.path.split("/").filter(Boolean);
         const resolvedPath = (0, import_core2.resolvePath)(pathSegments, requestOptions?.params);
         const resolvedTags = (0, import_core2.resolveTags)(
-          { tags, additionalTags },
+          tags !== void 0 ? { tags } : void 0,
           resolvedPath
         );
         const queryKey = stateManager.createQueryKey({
@@ -268,7 +267,7 @@ function createInjectRead(options) {
     const abort = () => {
       currentController?.abort();
     };
-    const refetch = () => {
+    const trigger = () => {
       if (currentController) {
         if (!isMounted) {
           currentController.mount();
@@ -288,7 +287,7 @@ function createInjectRead(options) {
       loading: loadingSignal,
       fetching: fetchingSignal,
       abort,
-      refetch
+      trigger
     };
     return result;
   };
@@ -334,14 +333,6 @@ function createInjectWrite(options) {
         currentSubscription();
       }
     });
-    const reset = () => {
-      if (currentQueryKey) {
-        stateManager.deleteCache(currentQueryKey);
-      }
-      dataSignal.set(void 0);
-      errorSignal.set(void 0);
-      loadingSignal.set(false);
-    };
     const abort = () => {
       currentController?.abort();
     };
@@ -432,7 +423,6 @@ function createInjectWrite(options) {
       data: dataSignal,
       error: errorSignal,
       loading: loadingSignal,
-      reset,
       abort
     };
     return result;
@@ -449,7 +439,6 @@ function createInjectInfiniteRead(options) {
     const {
       enabled: enabledOption = true,
       tags,
-      additionalTags,
       canFetchNext,
       nextPageRequest,
       merger,
@@ -617,7 +606,7 @@ function createInjectInfiniteRead(options) {
       initialRequestOptions?.params
     );
     const initialResolvedTags = (0, import_core6.resolveTags)(
-      { tags, additionalTags },
+      tags !== void 0 ? { tags } : void 0,
       initialResolvedPath
     );
     const initialBaseOptionsForKey = {
@@ -640,7 +629,7 @@ function createInjectInfiniteRead(options) {
         const pathSegments = capturedCall.path.split("/").filter(Boolean);
         const resolvedPath = (0, import_core6.resolvePath)(pathSegments, requestOptions?.params);
         const resolvedTags = (0, import_core6.resolveTags)(
-          { tags, additionalTags },
+          tags !== void 0 ? { tags } : void 0,
           resolvedPath
         );
         const baseOptionsForKey = {
@@ -732,7 +721,7 @@ function createInjectInfiniteRead(options) {
         fetchingPrevSignal.set(false);
       }
     };
-    const refetch = async () => {
+    const trigger = async () => {
       if (!currentController) return;
       if (!isMounted) {
         currentController.mount();
@@ -765,7 +754,131 @@ function createInjectInfiniteRead(options) {
       canFetchPrev: canFetchPrevSignal,
       fetchNext,
       fetchPrev,
-      refetch,
+      trigger,
+      abort
+    };
+    return result;
+  };
+}
+
+// src/injectLazyRead/index.ts
+var import_core7 = require("@angular/core");
+var import_core8 = require("@spoosh/core");
+function createInjectLazyRead(options) {
+  const { api, stateManager, pluginExecutor, eventEmitter } = options;
+  return function injectLazyRead(readFn) {
+    const destroyRef = (0, import_core7.inject)(import_core7.DestroyRef);
+    const captureSelector = () => {
+      const selectorResult = {
+        call: null,
+        selector: null
+      };
+      const selectorProxy = (0, import_core8.createSelectorProxy)(
+        (result2) => {
+          selectorResult.call = result2.call;
+          selectorResult.selector = result2.selector;
+        }
+      );
+      readFn(selectorProxy);
+      if (!selectorResult.selector) {
+        throw new Error(
+          'injectLazyRead requires selecting an HTTP method (GET). Example: injectLazyRead((api) => api("posts").GET)'
+        );
+      }
+      return selectorResult.selector;
+    };
+    const hookId = `angular-${Math.random().toString(36).slice(2)}`;
+    let currentQueryKey = null;
+    let currentController = null;
+    let currentSubscription = null;
+    const dataSignal = (0, import_core7.signal)(void 0);
+    const errorSignal = (0, import_core7.signal)(void 0);
+    const loadingSignal = (0, import_core7.signal)(false);
+    const lastTriggerOptionsSignal = (0, import_core7.signal)(void 0);
+    const inputSignal = (0, import_core7.signal)({});
+    destroyRef.onDestroy(() => {
+      if (currentSubscription) {
+        currentSubscription();
+      }
+    });
+    const abort = () => {
+      currentController?.abort();
+    };
+    const trigger = async (triggerOptions) => {
+      const selectedEndpoint = captureSelector();
+      const params = triggerOptions?.params;
+      const pathSegments = selectedEndpoint.path.split("/").filter(Boolean);
+      (0, import_core8.resolvePath)(pathSegments, params);
+      const queryKey = stateManager.createQueryKey({
+        path: pathSegments,
+        method: selectedEndpoint.method,
+        options: triggerOptions
+      });
+      const needsNewController = !currentController || currentQueryKey !== queryKey;
+      if (needsNewController) {
+        if (currentSubscription) {
+          currentSubscription();
+        }
+        const controller = (0, import_core8.createOperationController)({
+          operationType: "read",
+          path: pathSegments,
+          method: selectedEndpoint.method,
+          tags: [],
+          stateManager,
+          eventEmitter,
+          pluginExecutor,
+          hookId,
+          requestOptions: triggerOptions,
+          fetchFn: async (fetchOpts) => {
+            const pathMethods = api(selectedEndpoint.path);
+            const method = pathMethods[selectedEndpoint.method];
+            return method(fetchOpts);
+          }
+        });
+        currentSubscription = controller.subscribe(() => {
+          const state = controller.getState();
+          dataSignal.set(state.data);
+          errorSignal.set(state.error);
+        });
+        currentController = controller;
+        currentQueryKey = queryKey;
+      }
+      lastTriggerOptionsSignal.set(triggerOptions);
+      const opts = triggerOptions;
+      const inputInner = {};
+      if (opts?.query !== void 0) {
+        inputInner.query = opts.query;
+      }
+      if (opts?.body !== void 0) {
+        inputInner.body = opts.body;
+      }
+      if (opts?.params !== void 0) {
+        inputInner.params = opts.params;
+      }
+      inputSignal.set(inputInner);
+      loadingSignal.set(true);
+      currentController.setPluginOptions(triggerOptions);
+      try {
+        const response = await currentController.execute(triggerOptions);
+        if (response.error) {
+          errorSignal.set(response.error);
+        } else {
+          errorSignal.set(void 0);
+        }
+        return response;
+      } catch (err) {
+        errorSignal.set(err);
+        throw err;
+      } finally {
+        loadingSignal.set(false);
+      }
+    };
+    const result = {
+      trigger,
+      input: inputSignal,
+      data: dataSignal,
+      error: errorSignal,
+      loading: loadingSignal,
       abort
     };
     return result;
@@ -793,6 +906,14 @@ function createAngularSpoosh(instance) {
     eventEmitter,
     pluginExecutor
   });
+  const injectLazyRead = createInjectLazyRead(
+    {
+      api,
+      stateManager,
+      eventEmitter,
+      pluginExecutor
+    }
+  );
   const instanceApiContext = {
     api,
     stateManager,
@@ -813,6 +934,7 @@ function createAngularSpoosh(instance) {
     injectRead,
     injectWrite,
     injectInfiniteRead,
+    injectLazyRead,
     ...instanceApis
   };
 }

package/dist/index.mjs

@@ -18,8 +18,7 @@ function createInjectRead(options) {
     const destroyRef = inject(DestroyRef);
     const {
       enabled: enabledOption = true,
-      tags = void 0,
-      additionalTags = void 0,
+      tags,
       ...pluginOpts
     } = readOptions ?? {};
     const getEnabled = () => typeof enabledOption === "function" ? enabledOption() : enabledOption;
@@ -122,7 +121,7 @@ function createInjectRead(options) {
       initialRequestOptions?.params
     );
     const initialResolvedTags = resolveTags(
-      { tags, additionalTags },
+      tags !== void 0 ? { tags } : void 0,
       initialResolvedPath
     );
     const initialQueryKey = stateManager.createQueryKey({
@@ -147,7 +146,7 @@ function createInjectRead(options) {
         const pathSegments = capturedCall.path.split("/").filter(Boolean);
         const resolvedPath = resolvePath(pathSegments, requestOptions?.params);
         const resolvedTags = resolveTags(
-          { tags, additionalTags },
+          tags !== void 0 ? { tags } : void 0,
           resolvedPath
         );
         const queryKey = stateManager.createQueryKey({
@@ -253,7 +252,7 @@ function createInjectRead(options) {
     const abort = () => {
       currentController?.abort();
     };
-    const refetch = () => {
+    const trigger = () => {
       if (currentController) {
         if (!isMounted) {
           currentController.mount();
@@ -273,7 +272,7 @@ function createInjectRead(options) {
       loading: loadingSignal,
       fetching: fetchingSignal,
       abort,
-      refetch
+      trigger
     };
     return result;
   };
@@ -324,14 +323,6 @@ function createInjectWrite(options) {
         currentSubscription();
       }
     });
-    const reset = () => {
-      if (currentQueryKey) {
-        stateManager.deleteCache(currentQueryKey);
-      }
-      dataSignal.set(void 0);
-      errorSignal.set(void 0);
-      loadingSignal.set(false);
-    };
     const abort = () => {
       currentController?.abort();
     };
@@ -422,7 +413,6 @@ function createInjectWrite(options) {
       data: dataSignal,
       error: errorSignal,
       loading: loadingSignal,
-      reset,
       abort
     };
     return result;
@@ -451,7 +441,6 @@ function createInjectInfiniteRead(options) {
     const {
       enabled: enabledOption = true,
       tags,
-      additionalTags,
       canFetchNext,
       nextPageRequest,
       merger,
@@ -619,7 +608,7 @@ function createInjectInfiniteRead(options) {
       initialRequestOptions?.params
     );
     const initialResolvedTags = resolveTags3(
-      { tags, additionalTags },
+      tags !== void 0 ? { tags } : void 0,
       initialResolvedPath
     );
     const initialBaseOptionsForKey = {
@@ -642,7 +631,7 @@ function createInjectInfiniteRead(options) {
         const pathSegments = capturedCall.path.split("/").filter(Boolean);
         const resolvedPath = resolvePath3(pathSegments, requestOptions?.params);
         const resolvedTags = resolveTags3(
-          { tags, additionalTags },
+          tags !== void 0 ? { tags } : void 0,
           resolvedPath
         );
         const baseOptionsForKey = {
@@ -734,7 +723,7 @@ function createInjectInfiniteRead(options) {
         fetchingPrevSignal.set(false);
       }
     };
-    const refetch = async () => {
+    const trigger = async () => {
       if (!currentController) return;
       if (!isMounted) {
         currentController.mount();
@@ -767,7 +756,135 @@ function createInjectInfiniteRead(options) {
       canFetchPrev: canFetchPrevSignal,
       fetchNext,
       fetchPrev,
-      refetch,
+      trigger,
+      abort
+    };
+    return result;
+  };
+}
+
+// src/injectLazyRead/index.ts
+import { signal as signal4, DestroyRef as DestroyRef4, inject as inject4 } from "@angular/core";
+import {
+  createOperationController as createOperationController3,
+  createSelectorProxy as createSelectorProxy4,
+  resolvePath as resolvePath4
+} from "@spoosh/core";
+function createInjectLazyRead(options) {
+  const { api, stateManager, pluginExecutor, eventEmitter } = options;
+  return function injectLazyRead(readFn) {
+    const destroyRef = inject4(DestroyRef4);
+    const captureSelector = () => {
+      const selectorResult = {
+        call: null,
+        selector: null
+      };
+      const selectorProxy = createSelectorProxy4(
+        (result2) => {
+          selectorResult.call = result2.call;
+          selectorResult.selector = result2.selector;
+        }
+      );
+      readFn(selectorProxy);
+      if (!selectorResult.selector) {
+        throw new Error(
+          'injectLazyRead requires selecting an HTTP method (GET). Example: injectLazyRead((api) => api("posts").GET)'
+        );
+      }
+      return selectorResult.selector;
+    };
+    const hookId = `angular-${Math.random().toString(36).slice(2)}`;
+    let currentQueryKey = null;
+    let currentController = null;
+    let currentSubscription = null;
+    const dataSignal = signal4(void 0);
+    const errorSignal = signal4(void 0);
+    const loadingSignal = signal4(false);
+    const lastTriggerOptionsSignal = signal4(void 0);
+    const inputSignal = signal4({});
+    destroyRef.onDestroy(() => {
+      if (currentSubscription) {
+        currentSubscription();
+      }
+    });
+    const abort = () => {
+      currentController?.abort();
+    };
+    const trigger = async (triggerOptions) => {
+      const selectedEndpoint = captureSelector();
+      const params = triggerOptions?.params;
+      const pathSegments = selectedEndpoint.path.split("/").filter(Boolean);
+      resolvePath4(pathSegments, params);
+      const queryKey = stateManager.createQueryKey({
+        path: pathSegments,
+        method: selectedEndpoint.method,
+        options: triggerOptions
+      });
+      const needsNewController = !currentController || currentQueryKey !== queryKey;
+      if (needsNewController) {
+        if (currentSubscription) {
+          currentSubscription();
+        }
+        const controller = createOperationController3({
+          operationType: "read",
+          path: pathSegments,
+          method: selectedEndpoint.method,
+          tags: [],
+          stateManager,
+          eventEmitter,
+          pluginExecutor,
+          hookId,
+          requestOptions: triggerOptions,
+          fetchFn: async (fetchOpts) => {
+            const pathMethods = api(selectedEndpoint.path);
+            const method = pathMethods[selectedEndpoint.method];
+            return method(fetchOpts);
+          }
+        });
+        currentSubscription = controller.subscribe(() => {
+          const state = controller.getState();
+          dataSignal.set(state.data);
+          errorSignal.set(state.error);
+        });
+        currentController = controller;
+        currentQueryKey = queryKey;
+      }
+      lastTriggerOptionsSignal.set(triggerOptions);
+      const opts = triggerOptions;
+      const inputInner = {};
+      if (opts?.query !== void 0) {
+        inputInner.query = opts.query;
+      }
+      if (opts?.body !== void 0) {
+        inputInner.body = opts.body;
+      }
+      if (opts?.params !== void 0) {
+        inputInner.params = opts.params;
+      }
+      inputSignal.set(inputInner);
+      loadingSignal.set(true);
+      currentController.setPluginOptions(triggerOptions);
+      try {
+        const response = await currentController.execute(triggerOptions);
+        if (response.error) {
+          errorSignal.set(response.error);
+        } else {
+          errorSignal.set(void 0);
+        }
+        return response;
+      } catch (err) {
+        errorSignal.set(err);
+        throw err;
+      } finally {
+        loadingSignal.set(false);
+      }
+    };
+    const result = {
+      trigger,
+      input: inputSignal,
+      data: dataSignal,
+      error: errorSignal,
+      loading: loadingSignal,
       abort
     };
     return result;
@@ -795,6 +912,14 @@ function createAngularSpoosh(instance) {
     eventEmitter,
     pluginExecutor
   });
+  const injectLazyRead = createInjectLazyRead(
+    {
+      api,
+      stateManager,
+      eventEmitter,
+      pluginExecutor
+    }
+  );
   const instanceApiContext = {
     api,
     stateManager,
@@ -815,6 +940,7 @@ function createAngularSpoosh(instance) {
     injectRead,
     injectWrite,
     injectInfiniteRead,
+    injectLazyRead,
     ...instanceApis
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spoosh/angular",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "license": "MIT",
   "description": "Angular signals integration for Spoosh API client",
   "keywords": [
@@ -34,11 +34,11 @@
     }
   },
   "peerDependencies": {
-    "@spoosh/core": ">=0.6.0",
+    "@spoosh/core": ">=0.7.0",
     "@angular/core": ">=16.0.0"
   },
   "devDependencies": {
-    "@spoosh/core": "0.6.0"
+    "@spoosh/core": "0.9.0"
   },
   "scripts": {
     "dev": "tsup --watch",