@omniviewdev/runtime 0.11.0 → 0.12.0

package/dist/hooks/resource/useEventBatcher.d.ts

@@ -14,11 +14,12 @@ export type ResourceUpdateEvent = {
     type: 'DELETE';
     payload: DeletePayload;
 };
-/** Advisory events may patch observed host keys, never expand native page membership. */
-export declare function applyBatch(oldData: ResourceView | undefined, events: readonly ResourceUpdateEvent[], membershipChanged?: boolean): ResourceView | undefined;
-/** At most one pending event per observed page key; unseen row bodies are never retained. */
+/** Explicit pages retain bounded membership; collections accept every admitted target event. */
+export declare function applyBatch(oldData: ResourceView | undefined, events: readonly ResourceUpdateEvent[], membershipChanged?: boolean, collection?: boolean): ResourceView | undefined;
+/** Keep only the latest event for each key within the active acquisition. */
 export declare function useEventBatcher(queryClient: QueryClient, queryKey: QueryKey, watchState: WatchState, options?: {
     syncWindowMs?: number;
     enabled?: boolean;
     isCurrent?: () => boolean;
+    collection?: boolean;
 }): (event: ResourceUpdateEvent) => void;

package/dist/hooks/resource/useResources.d.ts

@@ -4,6 +4,8 @@ export interface UseResourcesOptions {
     pluginID?: string;
     request?: HostEnumerateRequest;
     enabled?: boolean;
+    /** Acquire all source pages internally and maintain collection membership from live events. */
+    collection?: boolean;
     /** Actual advisory native updates, never inferred from a finite page. */
     live?: boolean;
 }
@@ -12,14 +14,14 @@ export interface AcquiredResourcePage {
     request: HostEnumerateRequest;
     page: ResourceView;
 }
-/** One attempted acquisition and one displayed successful page; never accumulated row history. */
-export declare const useResources: ({ pluginID: explicitPluginID, request, enabled, live }: UseResourcesOptions) => {
+/** Acquire an explicit source page, or opt into a complete collection acquisition. */
+export declare const useResources: ({ pluginID: explicitPluginID, request, enabled, live, collection }: UseResourcesOptions) => {
     /** Attempted request state; an error does not rename or replace the acquired page. */
-    resources: import('@tanstack/react-query').UseQueryResult<import('../..').HostSourcePage, Error>;
+    resources: import('@tanstack/react-query').UseQueryResult<ResourceView, Error>;
     acquired: AcquiredResourcePage | undefined;
     /** Gate acquired readiness when a consumer chooses to display the attempted page instead. */
     isAcquiredRequestCurrent: boolean;
-    refreshAcquiredPage: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<import('../..').HostSourcePage, Error>>;
+    refreshAcquiredPage: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<ResourceView, Error>>;
     view: {
         guarantee: "bestEffort";
         count: import('../..').Count;