@wyxos/vibe 5.1.0 → 5.2.1

package/lib/core/autofill.d.ts

@@ -1,5 +1,6 @@
 import type { VibeAutofillOptions, VibeAutofillSessionSnapshot, VibeAutofillState, VibeCursor, VibeFrontendAutofillOptions, VibeItem, VibePageLoader } from '../types';
 import type { VibeRuntimeState } from './runtime';
+import { type LoadedPageRecord } from './page';
 import { type RequestDelaySnapshot } from './requestDelay';
 export declare const DEFAULT_MAX_ADDITIONAL_PAGES = 10;
 export declare function frontendAutofillRequestLimit(options: VibeFrontendAutofillOptions, includeInitialRequest?: boolean): number;
@@ -15,6 +16,7 @@ export interface FrontendAutofillCollection extends FrontendAutofillProgress {
     total?: number;
 }
 export interface FrontendAutofillResult extends FrontendAutofillCollection {
+    pages: LoadedPageRecord[];
     status: 'complete' | 'exhausted';
 }
 interface CollectFrontendAutofillOptions {

package/lib/core/exactMediaRemovalController.d.ts

@@ -3,6 +3,8 @@ import type { VibeRuntimeState } from './runtime';
 import type { VibeItemId, VibeMediaRemoval, VibeMediaTarget } from '../types';
 interface ExactMediaRemovalControllerOptions {
     onActivate: (postId: VibeItemId) => void;
+    onPostRemoved: (postId: VibeItemId) => void;
+    onPostRestored: (postId: VibeItemId) => void;
     reelForward: ReelForwardController;
     state: VibeRuntimeState;
 }

package/lib/core/fill.d.ts

@@ -1,3 +1,4 @@
+import { type LoadedPageRecord } from './page';
 import type { VibeFillOptions, VibeFillSessionSnapshot, VibeFillState, VibeFillTarget, VibeCursor, VibeFrontendFillOptions, VibeItem, VibePageLoader } from '../types';
 import { type RequestDelaySnapshot } from './requestDelay';
 export interface FrontendFillProgress {
@@ -8,6 +9,7 @@ export interface FrontendFillProgress {
 export interface FrontendFillResult extends FrontendFillProgress {
     items: VibeItem[];
     lastCursor: VibeCursor;
+    pages: LoadedPageRecord[];
     status: 'complete' | 'exhausted';
     total?: number;
 }

package/lib/core/fillController.d.ts

@@ -1,9 +1,11 @@
+import type { LoadedPageRecord } from './page';
 import type { VibeRuntimeState } from './runtime';
 import type { VibeBackendFillUpdate, VibeCursor, VibeFillOptions, VibeFillSessionSnapshot, VibeFillTarget, VibePageLoader } from '../types';
 interface FillControllerOptions {
     fill?: VibeFillOptions;
     loadPage?: VibePageLoader;
     onLastCursor: (cursor: VibeCursor) => void;
+    onPages: (pages: readonly LoadedPageRecord[]) => void;
     state: VibeRuntimeState;
 }
 export declare class VibeFillController {

package/lib/core/initialAutofill.d.ts

@@ -1,4 +1,5 @@
 import { type FrontendAutofillCollection } from './autofill';
+import type { LoadedPageRecord } from './page';
 import type { VibeRuntimeState } from './runtime';
 import type { CreateVibeOptions, VibeCursor } from '../types';
 interface InitialAutofillContext {
@@ -6,9 +7,10 @@ interface InitialAutofillContext {
     isCurrent: () => boolean;
     onCollection: (collection: FrontendAutofillCollection) => void;
     onLastCursor: (cursor: VibeCursor) => void;
+    onPages: (pages: readonly LoadedPageRecord[]) => void;
     options: CreateVibeOptions;
     signal: AbortSignal;
     state: VibeRuntimeState;
 }
-export declare function autofillInitialPage({ cycleId, isCurrent, onCollection, onLastCursor, options, signal, state, }: InitialAutofillContext): Promise<void>;
+export declare function autofillInitialPage({ cycleId, isCurrent, onCollection, onLastCursor, onPages, options, signal, state, }: InitialAutofillContext): Promise<void>;
 export {};

package/lib/core/page.d.ts

@@ -1,3 +1,9 @@
-import type { VibeItem, VibePage } from '../types';
+import type { VibeCursor, VibeItem, VibeItemId, VibePage } from '../types';
+export interface LoadedPageRecord {
+    contributionIds: VibeItemId[];
+    cursor: VibeCursor;
+    next: VibeCursor;
+    returnedIds: VibeItemId[];
+}
 export declare function validatePage(page: VibePage): VibePage;
 export declare function appendUniqueItems(current: readonly VibeItem[], incoming: readonly VibeItem[]): VibeItem[];

package/lib/core/pageRequest.d.ts

@@ -0,0 +1,18 @@
+import type { CreateVibeOptions, VibeCursor, VibePageRequest } from '../types';
+import type { VibeAutofillController } from './autofillController';
+import { type LoadedPageRecord } from './page';
+import type { VibeRuntimeState } from './runtime';
+interface PageRequestOptions {
+    append: boolean;
+    autofillController: VibeAutofillController;
+    cursor: VibeCursor;
+    isCurrent: () => boolean;
+    loadPage: (request: VibePageRequest) => ReturnType<NonNullable<CreateVibeOptions['loadPage']>>;
+    onLastCursor: (cursor: VibeCursor) => void;
+    onPages: (pages: readonly LoadedPageRecord[]) => void;
+    options: CreateVibeOptions;
+    signal: AbortSignal;
+    state: VibeRuntimeState;
+}
+export declare function performPageRequest({ append, autofillController, cursor, isCurrent, loadPage, onLastCursor, onPages, options, signal, state, }: PageRequestOptions): Promise<void>;
+export {};

package/lib/core/removalControllers.d.ts

@@ -9,6 +9,8 @@ interface RemovalControllerOptions {
     historyLimit: number | undefined;
     loadNext: () => Promise<void>;
     onActivate: (postId: VibeItemId) => void;
+    onItemsRemoved: (postIds: readonly VibeItemId[]) => void;
+    onItemsRestored: (postIds: readonly VibeItemId[]) => void;
     retryEnd: () => Promise<void>;
     state: VibeRuntimeState;
     surface: () => VibeSurfaceExpose | null;

package/lib/core/removalReconciliationController.d.ts

@@ -0,0 +1,35 @@
+import type { CreateVibeOptions, VibeCursor, VibeItem, VibeItemId, VibePageLoader } from '../types';
+import { type LoadedPageRecord } from './page';
+interface ReconciliationResult {
+    items: VibeItem[];
+    lastCursor: VibeCursor;
+    next: VibeCursor;
+    pages: LoadedPageRecord[];
+    replaceFrom: number;
+    total?: number;
+}
+interface ReconcileOptions {
+    existingItems: readonly VibeItem[];
+    loadPage: VibePageLoader;
+    signal: AbortSignal;
+}
+export declare class RemovalReconciliationController {
+    private readonly delay;
+    private readonly enabled;
+    private readonly maxReplayPages;
+    private readonly pageSize;
+    private pages;
+    private readonly tombstones;
+    constructor(options: CreateVibeOptions);
+    completeReconciliation(result: ReconciliationResult): void;
+    filterItems(items: readonly VibeItem[]): VibeItem[];
+    needsReconciliation(items: readonly VibeItem[]): boolean;
+    recordPages(records: readonly LoadedPageRecord[]): void;
+    remove(postIds: readonly VibeItemId[]): void;
+    reset(): void;
+    restore(postIds: readonly VibeItemId[]): void;
+    reconcile({ existingItems, loadPage, signal, }: ReconcileOptions): Promise<ReconciliationResult>;
+    private findUnderfilledPage;
+    private recordPage;
+}
+export {};