polfan-server-js-client 0.2.85 → 0.2.87

package/build/types/AbstractChatClient.d.ts

@@ -1,4 +1,4 @@
-import { Bye, GetSession, JoinSpace, Session, SpaceJoined, Error as ErrorType, SpaceLeft, SpaceMemberJoined, SpaceMemberLeft, SpaceMemberUpdated, SpaceDeleted, SpaceMembers, SpaceRooms, NewRole, RoomDeleted, RoomJoined, RoomLeft, RoomMemberLeft, RoomMemberJoined, RoomMembers, NewRoom, NewTopic, TopicDeleted, NewMessage, GetPermissionOverwrites, GetComputedPermissions, LeaveSpace, CreateSpace, DeleteSpace, GetSpaceMembers, GetSpaceRooms, CreateRole, DeleteRole, AssignRole, DeassignRole, SetPermissionOverwrites, JoinRoom, LeaveRoom, CreateRoom, DeleteRoom, GetRoomMembers, CreateTopic, DeleteTopic, CreateMessage, Envelope, PermissionOverwrites, PermissionOverwritesUpdated, RoomMemberUpdated, UpdateRole, RoleUpdated, Ack, UserUpdated, UpdateRoom, RoomUpdated, UpdateSpace, SpaceUpdated, PermissionOverwriteTargets, GetPermissionOverwriteTargets, Owners, Ok, GetOwners, CreateOwner, RoleDeleted, FollowedTopicUpdated, TopicFollowed, TopicUnfollowed, FollowedTopics, FollowTopic, UnfollowTopic, GetFollowedTopics, Messages, GetMessages, Topics, GetTopics, TopicUpdated, UpdateTopic, GetDiscoverableSpaces, DiscoverableSpaces, CreateEmoticon, DeleteEmoticon, GetEmoticons, Emoticons, EmoticonDeleted, NewEmoticon, Bans, GetBans, Ban, Unban, Kick, ClientData, GetClientData, SetClientData, GetRoomSummary, GetSpaceSummary, RoomSummaryEvent, SpaceSummaryEvent, UpdateSpaceMember, Relationships, RelationshipDeleted, NewRelationship, DeleteRelationship, CreateRelationship, RoomSummaryUpdated, Pong, Ping, RedactMessages, MessagesRedacted, ReportAbuse, UpdateRoomMember, GetRelationships } from "./types/src";
+import { Bye, GetSession, JoinSpace, Session, SpaceJoined, Error as ErrorType, SpaceLeft, SpaceMemberJoined, SpaceMemberLeft, SpaceMemberUpdated, SpaceDeleted, SpaceMembers, SpaceRooms, NewRole, RoomDeleted, RoomJoined, RoomLeft, RoomMemberLeft, RoomMemberJoined, RoomMembers, NewRoom, NewTopic, TopicDeleted, NewMessage, GetPermissionOverwrites, GetComputedPermissions, LeaveSpace, CreateSpace, DeleteSpace, GetSpaceMembers, GetSpaceRooms, CreateRole, DeleteRole, AssignRole, DeassignRole, SetPermissionOverwrites, JoinRoom, LeaveRoom, CreateRoom, DeleteRoom, GetRoomMembers, CreateTopic, DeleteTopic, CreateMessage, Envelope, PermissionOverwrites, PermissionOverwritesUpdated, RoomMemberUpdated, UpdateRole, RoleUpdated, Ack, UserUpdated, UpdateRoom, RoomUpdated, UpdateSpace, SpaceUpdated, PermissionOverwriteTargets, GetPermissionOverwriteTargets, Owners, Ok, GetOwners, CreateOwner, RoleDeleted, FollowedTopicUpdated, TopicFollowed, TopicUnfollowed, FollowedTopics, FollowTopic, UnfollowTopic, GetFollowedTopics, Messages, GetMessages, Topics, GetTopics, TopicUpdated, UpdateTopic, GetDiscoverableSpaces, DiscoverableSpaces, CreateEmoticon, DeleteEmoticon, GetEmoticons, Emoticons, EmoticonDeleted, NewEmoticon, Bans, GetBans, Ban, Unban, Kick, ClientData, GetClientData, SetClientData, GetRoomSummary, GetSpaceSummary, RoomSummaryEvent, SpaceSummaryEvent, UpdateSpaceMember, Relationships, RelationshipDeleted, NewRelationship, DeleteRelationship, CreateRelationship, RoomSummaryUpdated, Pong, Ping, RedactMessages, MessagesRedacted, ReportAbuse, UpdateRoomMember, GetRelationships, GetUserInfo, UserInfo } from "./types/src";
 import { EventTarget } from "./EventTarget";
 type ArrayOfPromiseResolvers = [(value: any) => void, (reason?: any) => void];
 type ExtraEventMap = Record<string, any>;
@@ -43,6 +43,7 @@ export type EventsMap = {
     RelationshipDeleted: RelationshipDeleted;
     Relationships: Relationships;
     Pong: Pong;
+    UserInfo: UserInfo;
     DiscoverableSpaces: DiscoverableSpaces;
     SpaceJoined: SpaceJoined;
     SpaceLeft: SpaceLeft;
@@ -107,6 +108,7 @@ export type CommandsMap = {
     GetRelationships: CommandDefinition<GetRelationships, EventsMap['Relationships']>;
     Ping: CommandDefinition<Ping, EventsMap['Pong']>;
     ReportAbuse: CommandDefinition<ReportAbuse, EventsMap['Ok']>;
+    GetUserInfo: CommandDefinition<GetUserInfo, EventsMap['UserInfo']>;
     GetDiscoverableSpaces: CommandDefinition<GetDiscoverableSpaces, EventsMap['DiscoverableSpaces']>;
     JoinSpace: CommandDefinition<JoinSpace, EventsMap['SpaceJoined']>;
     LeaveSpace: CommandDefinition<LeaveSpace, EventsMap['SpaceLeft']>;

package/build/types/state-tracker/TopicHistoryWindow.d.ts

@@ -30,6 +30,7 @@ export declare abstract class TraversableRemoteCollection<ItemT, EventMapT exten
         current: WindowState;
         ongoing?: WindowState;
         limit: number | null;
+        retainRatio: number;
         fetchLimit: number;
         lastFetchCount: number;
         oldestId: string | null;
@@ -43,15 +44,23 @@ export declare abstract class TraversableRemoteCollection<ItemT, EventMapT exten
      */
     set fetchLimit(value: number);
     /**
-     * Maximum numer of items stored in window.
+     * Maximum number of items stored in window (High Watermark).
      * Null for unlimited.
      */
     get limit(): number | null;
     /**
-     * Maximum numer of items stored in window.
+     * Maximum number of items stored in window (High Watermark).
      * Null for unlimited.
      */
     set limit(value: number | null);
+    /**
+     * Percentage of limit to keep when trimming.
+     */
+    get retainRatio(): number;
+    /**
+     * Percentage of limit to keep when trimming.
+     */
+    set retainRatio(value: number);
     get hasLatest(): boolean;
     get hasOldest(): boolean;
     abstract createMirror(): TraversableRemoteCollection<ItemT, EventMapT>;
@@ -65,7 +74,7 @@ export declare abstract class TraversableRemoteCollection<ItemT, EventMapT exten
     protected refreshFetchedState(): Promise<void>;
     protected addItems(newItems: ItemT[], to: 'head' | 'tail'): void;
     /**
-     * Return array with messages of count that matching limit.
+     * Return array with messages trimmed using High/Low Watermark strategy.
      */
     private trimItemsArrayToLimit;
 }

package/build/types/types/src/index.d.ts

@@ -131,4 +131,7 @@ import { ReportAbuse } from "./schemes/commands/ReportAbuse";
 import { RedactMessages } from "./schemes/commands/RedactMessages";
 import { MessagesRedacted } from "./schemes/events/MessagesRedacted";
 import { GetRelationships } from "./schemes/commands/GetRelationships";
-export { Envelope, Message, MessageType, MessageAuthor, Role, Room, RoomType, RoomStream, RoomStreamType, RoomHistory, RoomHistoryMode, RoomMember, RoomSummary, RoomSummaryExtras, Space, SpaceMember, Topic, FollowedTopic, User, UserState, PermissionOverwritesValue, ChatLocation, SpaceSummary, SpaceDiscoverable, Emoticon, PermissionOverwritesTarget, BanObject, LeaveReason, UserRelationship, UserRelationshipType, CreateTopicInitialMessage, Bye, Error, Messages, NewMessage, NewRole, NewRoom, NewTopic, TopicFollowed, TopicUnfollowed, FollowedTopics, FollowedTopicUpdated, ComputedPermissions, PermissionOverwrites, PermissionOverwritesUpdated, RoleDeleted, RoleUpdated, RoomDeleted, RoomUpdated, RoomJoined, RoomLeft, RoomMemberJoined, RoomMemberLeft, RoomMembers, RoomMemberUpdated, UserUpdated, Session, SpaceDeleted, SpaceUpdated, SpaceJoined, SpaceLeft, SpaceMemberJoined, SpaceMemberLeft, SpaceMembers, SpaceMemberUpdated, SpaceRooms, TopicDeleted, TopicUpdated, PermissionOverwriteTargets, Owners, Ok, DiscoverableSpaces, Emoticons, EmoticonDeleted, NewEmoticon, Bans, ClientData, SpaceSummaryEvent, RoomSummaryEvent, NewRelationship, RelationshipDeleted, Relationships, RoomSummaryUpdated, Pong, MessagesRedacted, AssignRole, GetMessages, CreateMessage, Ack, CreateRole, CreateRoom, CreateSpace, CreateTopic, FollowTopic, UnfollowTopic, GetFollowedTopics, DeassignRole, DeleteRole, DeleteRoom, DeleteSpace, DeleteTopic, SetPermissionOverwrites, GetPermissionOverwrites, GetComputedPermissions, GetRoomMembers, GetSession, GetSpaceMembers, GetSpaceRooms, JoinRoom, JoinSpace, LeaveRoom, LeaveSpace, UpdateRole, UpdateSpace, UpdateRoom, UpdateTopic, GetPermissionOverwriteTargets, CreateOwner, DeleteOwner, GetOwners, Topics, GetTopics, GetDiscoverableSpaces, GetEmoticons, CreateEmoticon, DeleteEmoticon, Ban, Unban, GetBans, Kick, GetClientData, SetClientData, GetSpaceSummary, GetRoomSummary, UpdateSpaceMember, CreateRelationship, DeleteRelationship, GetRelationships, UpdateRoomMember, Ping, ReportAbuse, RedactMessages };
+import { GetUserInfo } from "./schemes/commands/GetUserInfo";
+import { UserInfo } from "./schemes/events/UserInfo";
+import { UserInformation } from "./schemes/UserInformation";
+export { Envelope, Message, MessageType, MessageAuthor, Role, Room, RoomType, RoomStream, RoomStreamType, RoomHistory, RoomHistoryMode, RoomMember, RoomSummary, RoomSummaryExtras, Space, SpaceMember, Topic, FollowedTopic, User, UserState, PermissionOverwritesValue, ChatLocation, SpaceSummary, SpaceDiscoverable, Emoticon, PermissionOverwritesTarget, BanObject, LeaveReason, UserRelationship, UserRelationshipType, CreateTopicInitialMessage, UserInformation, Bye, Error, Messages, NewMessage, NewRole, NewRoom, NewTopic, TopicFollowed, TopicUnfollowed, FollowedTopics, FollowedTopicUpdated, ComputedPermissions, PermissionOverwrites, PermissionOverwritesUpdated, RoleDeleted, RoleUpdated, RoomDeleted, RoomUpdated, RoomJoined, RoomLeft, RoomMemberJoined, RoomMemberLeft, RoomMembers, RoomMemberUpdated, UserUpdated, Session, SpaceDeleted, SpaceUpdated, SpaceJoined, SpaceLeft, SpaceMemberJoined, SpaceMemberLeft, SpaceMembers, SpaceMemberUpdated, SpaceRooms, TopicDeleted, TopicUpdated, PermissionOverwriteTargets, Owners, Ok, DiscoverableSpaces, Emoticons, EmoticonDeleted, NewEmoticon, Bans, ClientData, SpaceSummaryEvent, RoomSummaryEvent, NewRelationship, RelationshipDeleted, Relationships, RoomSummaryUpdated, Pong, MessagesRedacted, UserInfo, AssignRole, GetMessages, CreateMessage, Ack, CreateRole, CreateRoom, CreateSpace, CreateTopic, FollowTopic, UnfollowTopic, GetFollowedTopics, DeassignRole, DeleteRole, DeleteRoom, DeleteSpace, DeleteTopic, SetPermissionOverwrites, GetPermissionOverwrites, GetComputedPermissions, GetRoomMembers, GetSession, GetSpaceMembers, GetSpaceRooms, JoinRoom, JoinSpace, LeaveRoom, LeaveSpace, UpdateRole, UpdateSpace, UpdateRoom, UpdateTopic, GetPermissionOverwriteTargets, CreateOwner, DeleteOwner, GetOwners, Topics, GetTopics, GetDiscoverableSpaces, GetEmoticons, CreateEmoticon, DeleteEmoticon, Ban, Unban, GetBans, Kick, GetClientData, SetClientData, GetSpaceSummary, GetRoomSummary, UpdateSpaceMember, CreateRelationship, DeleteRelationship, GetRelationships, UpdateRoomMember, Ping, ReportAbuse, RedactMessages, GetUserInfo, };

package/build/types/types/src/schemes/BanObject.d.ts

@@ -1,11 +1,14 @@
 import { User } from "./User";
 import { ChatLocation } from "./ChatLocation";
+export type BanType = 'Ban' | 'Mute';
 export interface BanObject {
+    id: string;
     bannedUser: User;
     banningUser?: User;
     location: ChatLocation;
     reason: string;
-    diagnosticId: string;
     expiresAt?: string;
     createdAt: string;
+    type: BanType;
+    parentId?: string;
 }

package/build/types/types/src/schemes/RoomSummary.d.ts

@@ -4,6 +4,7 @@ export interface RoomSummaryExtras {
 }
 export interface RoomSummary {
     id: string;
+    spaceId?: string;
     name: string;
     description: string;
     memberCount: number;

package/build/types/types/src/schemes/UserInformation.d.ts

@@ -0,0 +1,11 @@
+import { User } from "./User";
+import { SpaceSummary } from "./SpaceSummary";
+import { RoomSummary } from "./RoomSummary";
+export interface UserInformation {
+    user: User;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    spaces: SpaceSummary[];
+    rooms: RoomSummary[];
+    knownAliases?: User[];
+}

package/build/types/types/src/schemes/commands/Ban.d.ts

@@ -1,8 +1,10 @@
 import { ChatLocation } from "../ChatLocation";
+import { BanType } from "../BanObject";
 export interface Ban {
     userId: string;
     location: ChatLocation;
     reason: string;
     expiresAt?: string;
     notify?: boolean;
+    type?: BanType;
 }

package/build/types/types/src/schemes/commands/GetBans.d.ts

@@ -1,4 +1,6 @@
 import { ChatLocation } from "../ChatLocation";
+import { BanType } from "../BanObject";
 export interface GetBans {
     location: ChatLocation;
+    type?: BanType;
 }

package/build/types/types/src/schemes/commands/GetUserInfo.d.ts

@@ -0,0 +1,3 @@
+export interface GetUserInfo {
+    id: string;
+}

package/build/types/types/src/schemes/commands/Unban.d.ts

@@ -1,5 +1,3 @@
-import { ChatLocation } from "../ChatLocation";
 export interface Unban {
-    userId: string;
-    location: ChatLocation;
+    id: string;
 }

package/build/types/types/src/schemes/events/Session.d.ts

@@ -5,4 +5,5 @@ export interface Session {
     protoVersion: string;
     state: UserState;
     user: User;
+    ict?: string;
 }

package/build/types/types/src/schemes/events/UserInfo.d.ts

@@ -0,0 +1,4 @@
+import { UserInformation } from "../UserInformation";
+export interface UserInfo {
+    info: UserInformation;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polfan-server-js-client",
-  "version": "0.2.85",
+  "version": "0.2.87",
   "description": "JavaScript client library for handling communication with Polfan chat server.",
   "author": "Jarosław Żak",
   "license": "MIT",

package/src/AbstractChatClient.ts

@@ -109,6 +109,8 @@ import {
     ReportAbuse,
     UpdateRoomMember,
     GetRelationships,
+    GetUserInfo,
+    UserInfo,
 } from "./types/src";
 import {EventTarget} from "./EventTarget";
 
@@ -188,6 +190,7 @@ export type CommandResponse<CommandType extends keyof CommandsMap> = CommandsMap
     RelationshipDeleted: RelationshipDeleted,
     Relationships: Relationships,
     Pong: Pong,
+    UserInfo: UserInfo,
     // Space events
     DiscoverableSpaces: DiscoverableSpaces,
     SpaceJoined: SpaceJoined,
@@ -257,6 +260,7 @@ export type CommandsMap = {
     GetRelationships: CommandDefinition<GetRelationships, EventsMap['Relationships']>,
     Ping: CommandDefinition<Ping, EventsMap['Pong']>,
     ReportAbuse: CommandDefinition<ReportAbuse, EventsMap['Ok']>,
+    GetUserInfo: CommandDefinition<GetUserInfo, EventsMap['UserInfo']>,
      // Space commands
     GetDiscoverableSpaces: CommandDefinition<GetDiscoverableSpaces, EventsMap['DiscoverableSpaces']>,
     JoinSpace: CommandDefinition<JoinSpace, EventsMap['SpaceJoined']>,

package/src/state-tracker/TopicHistoryWindow.ts

@@ -40,14 +40,16 @@ export abstract class TraversableRemoteCollection<
     protected internalState: {
         current: WindowState,
         ongoing?: WindowState,
-        limit: number | null,
+        limit: number | null, // Acts as High Watermark
+        retainRatio: number, // Percentage of limit to keep when trimming
         fetchLimit: number,
         lastFetchCount: number,
         oldestId: string | null,
     } = {
         current: WindowState.LIVE,
         ongoing: undefined,
-        limit: 50,
+        limit: 1000,
+        retainRatio: 1,
         fetchLimit: 50,
         lastFetchCount: 0,
         oldestId: null,
@@ -68,7 +70,7 @@ export abstract class TraversableRemoteCollection<
     }
 
     /**
-     * Maximum numer of items stored in window.
+     * Maximum number of items stored in window (High Watermark).
      * Null for unlimited.
      */
     public get limit(): number | null {
@@ -76,13 +78,27 @@ export abstract class TraversableRemoteCollection<
     }
 
     /**
-     * Maximum numer of items stored in window.
+     * Maximum number of items stored in window (High Watermark).
      * Null for unlimited.
      */
     public set limit(value: number | null) {
         this.internalState.limit = value;
     }
 
+    /**
+     * Percentage of limit to keep when trimming.
+     */
+    public get retainRatio(): number {
+        return this.internalState.retainRatio;
+    }
+
+    /**
+     * Percentage of limit to keep when trimming.
+     */
+    public set retainRatio(value: number) {
+        this.internalState.retainRatio = value;
+    }
+
     public get hasLatest(): boolean {
         return [WindowState.LATEST, WindowState.LIVE].includes(this.state);
     }
@@ -111,7 +127,7 @@ export abstract class TraversableRemoteCollection<
             this.internalState.ongoing = undefined;
         }
 
-        this.deleteAll();
+        this._items.deleteAll(); // Directly call deleteAll to prevent event emit.
         this.addItems(result, 'tail');
         this.internalState.current = WindowState.LATEST;
     }
@@ -205,25 +221,31 @@ export abstract class TraversableRemoteCollection<
             result = this.trimItemsArrayToLimit([...this.items, ...newItems], 'head');
         }
 
-        this.deleteAll();
+        this._items.deleteAll(); // Directly call deleteAll to prevent event emit.
         this.set(...result);
     }
 
     /**
-     * Return array with messages of count that matching limit.
+     * Return array with messages trimmed using High/Low Watermark strategy.
      */
     private trimItemsArrayToLimit(items: ItemT[], from: 'head' | 'tail'): ItemT[] {
-        if (this.limit === null) {
+        const highWatermark = this.limit;
+
+        if (highWatermark === null || items.length <= highWatermark) {
             return items;
         }
 
+        const lowWatermark = Math.floor(highWatermark * this.internalState.retainRatio);
+
         if (from === 'head') {
-            return items.slice(-this.limit);
+            return items.slice(-lowWatermark);
         }
 
         if (from === 'tail') {
-            return items.slice(0, this.limit);
+            return items.slice(0, lowWatermark);
         }
+
+        return items;
     }
 }
 

package/src/types/src/index.ts

@@ -131,6 +131,9 @@ import {ReportAbuse} from "./schemes/commands/ReportAbuse";
 import {RedactMessages} from "./schemes/commands/RedactMessages";
 import {MessagesRedacted} from "./schemes/events/MessagesRedacted";
 import {GetRelationships} from "./schemes/commands/GetRelationships";
+import {GetUserInfo} from "./schemes/commands/GetUserInfo";
+import {UserInfo} from "./schemes/events/UserInfo";
+import {UserInformation} from "./schemes/UserInformation";
 
 export {
     // objects
@@ -165,6 +168,7 @@ export {
     UserRelationship,
     UserRelationshipType,
     CreateTopicInitialMessage,
+    UserInformation,
     // events
     Bye,
     Error,
@@ -220,6 +224,7 @@ export {
     RoomSummaryUpdated,
     Pong,
     MessagesRedacted,
+    UserInfo,
     // commands
     AssignRole,
     GetMessages,
@@ -277,5 +282,6 @@ export {
     UpdateRoomMember,
     Ping,
     ReportAbuse,
-    RedactMessages
+    RedactMessages,
+    GetUserInfo,
 };

package/src/types/src/schemes/BanObject.ts

@@ -1,12 +1,16 @@
 import {User} from "./User";
 import {ChatLocation} from "./ChatLocation";
 
+export type BanType = 'Ban' | 'Mute';
+
 export interface BanObject {
+    id: string;
     bannedUser: User;
     banningUser?: User;
     location: ChatLocation;
     reason: string;
-    diagnosticId: string;
     expiresAt?: string;
     createdAt: string;
+    type: BanType;
+    parentId?: string;
 }

package/src/types/src/schemes/RoomSummary.ts

@@ -6,6 +6,7 @@ export interface RoomSummaryExtras {
 
 export interface RoomSummary {
     id: string;
+    spaceId?: string;
     name: string;
     description: string;
     memberCount: number;

package/src/types/src/schemes/UserInformation.ts

@@ -0,0 +1,12 @@
+import {User} from "./User";
+import {SpaceSummary} from "./SpaceSummary";
+import {RoomSummary} from "./RoomSummary";
+
+export interface UserInformation {
+    user: User;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    spaces: SpaceSummary[];
+    rooms: RoomSummary[];
+    knownAliases?: User[];
+}

package/src/types/src/schemes/commands/Ban.ts

@@ -1,4 +1,5 @@
 import {ChatLocation} from "../ChatLocation";
+import {BanType} from "../BanObject";
 
 export interface Ban {
     userId: string;
@@ -6,4 +7,5 @@ export interface Ban {
     reason: string;
     expiresAt?: string;
     notify?: boolean;
+    type?: BanType;
 }

package/src/types/src/schemes/commands/GetBans.ts

@@ -1,5 +1,7 @@
 import {ChatLocation} from "../ChatLocation";
+import {BanType} from "../BanObject";
 
 export interface GetBans {
     location: ChatLocation;
+    type?: BanType;
 }

package/src/types/src/schemes/commands/GetUserInfo.ts

@@ -0,0 +1,3 @@
+export interface GetUserInfo {
+    id: string;
+}

package/src/types/src/schemes/commands/Unban.ts

@@ -1,6 +1,3 @@
-import {ChatLocation} from "../ChatLocation";
-
 export interface Unban {
-    userId: string;
-    location: ChatLocation;
+    id: string;
 }

package/src/types/src/schemes/events/Session.ts

@@ -6,4 +6,5 @@ export interface Session {
     protoVersion: string;
     state: UserState;
     user: User;
+    ict?: string;
 }

package/src/types/src/schemes/events/UserInfo.ts

@@ -0,0 +1,5 @@
+import {UserInformation} from "../UserInformation";
+
+export interface UserInfo {
+    info: UserInformation;
+}

package/tests/history-window.test.ts

@@ -69,7 +69,8 @@ class TestableHistoryWindow extends TraversableRemoteCollection<SimpleMessage> {
 test('history window - fresh instance', async () => {
     const window = new TestableHistoryWindow();
     expect(window.items).toHaveLength(0);
-    expect(window.limit).toEqual(50);
+    expect(window.limit).toEqual(1000);
+    expect(window.retainRatio).toEqual(1);
 });
 
 test('history window - states change', async () => {
@@ -251,3 +252,36 @@ test('history window - hasOldest false when in LATEST and length == fetchLimit',
     expect(window.fetchLimit).toEqual(3);
     expect(window.hasOldest).toBeFalsy();
 });
+
+test('history window - high/low watermark limit (retainRatio)', async () => {
+    const window = new TestableHistoryWindow();
+    window.limit = 6; // High Watermark
+    window.retainRatio = 0.5; // Low Watermark target = 6 * 0.5 = 3
+    window.fetchLimit = 3;
+
+    await window.resetToLatest(); // [7, 8, 9]
+
+    expect(window.items).toHaveLength(3);
+
+    await window.fetchPrevious(); // [4, 5, 6] added to 'head' -> [4, 5, 6, 7, 8, 9]
+
+    expect(window.items).toHaveLength(6);
+    [4, 5, 6, 7, 8, 9].forEach(id => expect(window.items.map(item => item.id)).toContain(id));
+
+    await window.fetchPrevious(); // [1, 2, 3] added to 'head' -> [1, 2, 3, 4, 5, 6, 7, 8, 9]
+
+    expect(window.items).toHaveLength(3);
+    [1, 2, 3].forEach(id => expect(window.items.map(item => item.id)).toContain(id));
+    expect(window.state).toEqual(WindowState.PAST);
+
+    await window.fetchNext(); // [4, 5, 6] added to 'tail' -> [1, 2, 3, 4, 5, 6]
+
+    expect(window.items).toHaveLength(6);
+    [1, 2, 3, 4, 5, 6].forEach(id => expect(window.items.map(item => item.id)).toContain(id));
+
+    await window.fetchNext(); // [7, 8, 9] added to 'tail' -> [1, 2, 3, 4, 5, 6, 7, 8, 9]
+
+    expect(window.items).toHaveLength(3);
+    [7, 8, 9].forEach(id => expect(window.items.map(item => item.id)).toContain(id));
+    expect(window.state).toEqual(WindowState.LATEST);
+});