polfan-server-js-client 0.3.3 → 0.4.1

package/.idea/shelf/Uncommitted_changes_before_Checkout_at_05_08_2026_17_28__Changes_.xml

@@ -0,0 +1,4 @@
+<changelist name="Uncommitted_changes_before_Checkout_at_05_08_2026_17_28_[Changes]" date="1785943698237" recycled="false" toDelete="true">
+  <option name="PATH" value="$PROJECT_DIR$/.idea/shelf/Uncommitted_changes_before_Checkout_at_05_08_2026_17_28_[Changes]/shelved.patch" />
+  <option name="DESCRIPTION" value="Uncommitted changes before Checkout at 05.08.2026 17:28 [Changes]" />
+</changelist>

package/.idea/workspace.xml

@@ -4,7 +4,7 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="831dae43-0da1-47fd-a5f7-33dd5eec2992" name="Changes" comment="Custom avatars support" />
+    <list default="true" id="831dae43-0da1-47fd-a5f7-33dd5eec2992" name="Changes" comment="Reacting changes" />
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
     <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
@@ -14,7 +14,7 @@
     <execution />
   </component>
   <component name="EmbeddingIndexingInfo">
-    <option name="cachedIndexableFilesCount" value="212" />
+    <option name="cachedIndexableFilesCount" value="213" />
   </component>
   <component name="Git.Rebase.Settings">
     <option name="NEW_BASE" value="origin/main" />
@@ -22,7 +22,7 @@
   <component name="Git.Settings">
     <option name="RECENT_BRANCH_BY_REPOSITORY">
       <map>
-        <entry key="$PROJECT_DIR$" value="claude/avatars-room-space-support-bvrcaz" />
+        <entry key="$PROJECT_DIR$" value="claude/room-messages-reconnect-history-kfddmm" />
         <entry key="$PROJECT_DIR$/src/types" value="main" />
       </map>
     </option>
@@ -67,34 +67,34 @@
     <option name="hideEmptyMiddlePackages" value="true" />
     <option name="showLibraryContents" value="true" />
   </component>
-  <component name="PropertiesComponent">{
-  &quot;keyToString&quot;: {
-    &quot;RunOnceActivity.MCP Project settings loaded&quot;: &quot;true&quot;,
-    &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
-    &quot;RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager&quot;: &quot;true&quot;,
-    &quot;RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252&quot;: &quot;true&quot;,
-    &quot;RunOnceActivity.git.unshallow&quot;: &quot;true&quot;,
-    &quot;RunOnceActivity.typescript.service.memoryLimit.init&quot;: &quot;true&quot;,
-    &quot;codeWithMe.voiceChat.enabledByDefault&quot;: &quot;false&quot;,
-    &quot;com.intellij.ml.llm.matterhorn.ej.ui.settings.DefaultModelSelectionForGA.v1&quot;: &quot;true&quot;,
-    &quot;git-widget-placeholder&quot;: &quot;main&quot;,
-    &quot;git.auto.fetch.suggestion.counter&quot;: &quot;3&quot;,
-    &quot;ignore.virus.scanning.warn.message&quot;: &quot;true&quot;,
-    &quot;junie.onboarding.icon.badge.shown&quot;: &quot;true&quot;,
-    &quot;last_opened_file_path&quot;: &quot;//wsl.localhost/Debian/home/jarek/polfan-js-client-library&quot;,
-    &quot;node.js.detected.package.eslint&quot;: &quot;true&quot;,
-    &quot;node.js.detected.package.tslint&quot;: &quot;true&quot;,
-    &quot;node.js.selected.package.eslint&quot;: &quot;(autodetect)&quot;,
-    &quot;node.js.selected.package.tslint&quot;: &quot;(autodetect)&quot;,
-    &quot;nodejs_package_manager_path&quot;: &quot;npm&quot;,
-    &quot;npm.build:node.executor&quot;: &quot;Run&quot;,
-    &quot;settings.editor.selected.configurable&quot;: &quot;com.github.copilot.settings.chat.ChatConfigurable&quot;,
-    &quot;to.speed.mode.migration.done&quot;: &quot;true&quot;,
-    &quot;ts.external.directory.path&quot;: &quot;\\\\wsl.localhost\\Debian\\home\\jarek\\polfan-js-client-library\\node_modules\\typescript\\lib&quot;,
-    &quot;vcs.patch.to.clipboard&quot;: &quot;true&quot;,
-    &quot;vue.rearranger.settings.migration&quot;: &quot;true&quot;
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "RunOnceActivity.MCP Project settings loaded": "true",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager": "true",
+    "RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252": "true",
+    "RunOnceActivity.git.unshallow": "true",
+    "RunOnceActivity.typescript.service.memoryLimit.init": "true",
+    "codeWithMe.voiceChat.enabledByDefault": "false",
+    "com.intellij.ml.llm.matterhorn.ej.ui.settings.DefaultModelSelectionForGA.v1": "true",
+    "git-widget-placeholder": "claude/chat-reactions-polls-system-hwea5i",
+    "git.auto.fetch.suggestion.counter": "3",
+    "ignore.virus.scanning.warn.message": "true",
+    "junie.onboarding.icon.badge.shown": "true",
+    "last_opened_file_path": "//wsl.localhost/Debian/home/jarek/polfan-js-client-library",
+    "node.js.detected.package.eslint": "true",
+    "node.js.detected.package.tslint": "true",
+    "node.js.selected.package.eslint": "(autodetect)",
+    "node.js.selected.package.tslint": "(autodetect)",
+    "nodejs_package_manager_path": "npm",
+    "npm.build:node.executor": "Run",
+    "settings.editor.selected.configurable": "com.github.copilot.settings.chat.ChatConfigurable",
+    "to.speed.mode.migration.done": "true",
+    "ts.external.directory.path": "\\\\wsl.localhost\\Debian\\home\\jarek\\polfan-js-client-library\\node_modules\\typescript\\lib",
+    "vcs.patch.to.clipboard": "true",
+    "vue.rearranger.settings.migration": "true"
   }
-}</component>
+}]]></component>
   <component name="RunManager">
     <configuration name="build:node" type="js.build_tools.npm" temporary="true" nameIsGenerated="true">
       <package-json value="$PROJECT_DIR$/package.json" />
@@ -112,6 +112,7 @@
         <item itemvalue="npm.build:node" />
         <item itemvalue="npm.build:node" />
         <item itemvalue="npm.build:node" />
+        <item itemvalue="npm.build:node" />
       </list>
     </recent_temporary>
   </component>
@@ -242,23 +243,10 @@
       <workItem from="1784524117686" duration="79000" />
       <workItem from="1784562428378" duration="25143000" />
       <workItem from="1785316847947" duration="4816000" />
-      <workItem from="1785689068542" duration="2232000" />
-    </task>
-    <task id="LOCAL-00065" summary="Align to custom colors and nicks protocol changes">
-      <option name="closed" value="true" />
-      <created>1764689897013</created>
-      <option name="number" value="00065" />
-      <option name="presentableId" value="LOCAL-00065" />
-      <option name="project" value="LOCAL" />
-      <updated>1764689897014</updated>
-    </task>
-    <task id="LOCAL-00066" summary="Connection handling optimizations">
-      <option name="closed" value="true" />
-      <created>1764955397384</created>
-      <option name="number" value="00066" />
-      <option name="presentableId" value="LOCAL-00066" />
-      <option name="project" value="LOCAL" />
-      <updated>1764955397384</updated>
+      <workItem from="1785689068542" duration="6390000" />
+      <workItem from="1786526830597" duration="598000" />
+      <workItem from="1787125977456" duration="278000" />
+      <workItem from="1787576741803" duration="2076000" />
     </task>
     <task id="LOCAL-00067" summary="Ping-pong connection monitoring">
       <option name="closed" value="true" />
@@ -636,7 +624,23 @@
       <option name="project" value="LOCAL" />
       <updated>1785594413375</updated>
     </task>
-    <option name="localTasksCounter" value="114" />
+    <task id="LOCAL-00114" summary="User presence status support">
+      <option name="closed" value="true" />
+      <created>1787126229969</created>
+      <option name="number" value="00114" />
+      <option name="presentableId" value="LOCAL-00114" />
+      <option name="project" value="LOCAL" />
+      <updated>1787126229970</updated>
+    </task>
+    <task id="LOCAL-00115" summary="Reacting changes">
+      <option name="closed" value="true" />
+      <created>1787581107970</created>
+      <option name="number" value="00115" />
+      <option name="presentableId" value="LOCAL-00115" />
+      <option name="project" value="LOCAL" />
+      <updated>1787581107970</updated>
+    </task>
+    <option name="localTasksCounter" value="116" />
     <servers />
   </component>
   <component name="TypeScriptGeneratedFilesManager">
@@ -648,6 +652,11 @@
         <entry key="Branch">
           <value>
             <list>
+              <RecentGroup>
+                <option name="FILTER_VALUES">
+                  <option value="claude/chat-reactions-polls-system-hwea5i" />
+                </option>
+              </RecentGroup>
               <RecentGroup>
                 <option name="FILTER_VALUES">
                   <option value="claude/avatars-room-space-support-bvrcaz" />
@@ -688,7 +697,7 @@
                   <entry key="branch">
                     <value>
                       <list>
-                        <option value="claude/avatars-room-space-support-bvrcaz" />
+                        <option value="claude/chat-reactions-polls-system-hwea5i" />
                       </list>
                     </value>
                   </entry>
@@ -701,8 +710,6 @@
     </option>
   </component>
   <component name="VcsManagerConfiguration">
-    <MESSAGE value="TopicHistoryWindow retainRatio and event handling improvements" />
-    <MESSAGE value="Remove removed message from Topic last message" />
     <MESSAGE value="Update Topic on redacted message" />
     <MESSAGE value="Fix room member update event handle" />
     <MESSAGE value="Fix room member update event handle" />
@@ -726,7 +733,9 @@
     <MESSAGE value="Add members to rooms and invitation only rooms support" />
     <MESSAGE value="Introduce room invitations and manual member adding" />
     <MESSAGE value="Custom avatars support" />
-    <option name="LAST_COMMIT_MESSAGE" value="Custom avatars support" />
+    <MESSAGE value="User presence status support" />
+    <MESSAGE value="Reacting changes" />
+    <option name="LAST_COMMIT_MESSAGE" value="Reacting changes" />
   </component>
   <component name="XSLT-Support.FileAssociations.UIState">
     <expand />

package/CODE_OF_CONDUCT.md

@@ -1,76 +1,76 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, sex characteristics, gender identity and expression,
-level of experience, education, socio-economic status, nationality, personal
-appearance, race, religion, or sexual identity and orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to creating a positive environment
-include:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery and unwelcome sexual attention or
- advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
- address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
- professional setting
-
-## Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
-
-## Scope
-
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at opensource@hodgef.com. All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
-
-[homepage]: https://www.contributor-covenant.org
-
-For answers to common questions about this code of conduct, see
-https://www.contributor-covenant.org/faq
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+ advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+ address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at opensource@hodgef.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq

package/README.md

@@ -1,45 +1,45 @@
-# pserv-js-client-library
-TypeScript client library to handle connection with Devana (new Polfan) chat service.
-
-## How to use?
-
-```js
-(async () => {
-    // Get access token by credentials
-    const token = await PServ.AuthClient.createToken('login', 'password');
-    
-    // Create web api client (there is also WebSocket client available)
-    const client = new PServ.WebApiChatClient({
-        token: token.token, // Pass received token
-        url: 'https://pserv-api-address',
-    });
-    
-    // Call `GetSession` command which returns user session data
-    const session = await client.send('GetSession');
-    
-    console.log("My nick:", session.user.nick);
-    console.log("The rooms you are in:", session.rooms);
-    console.log("The spaces you are in:", session.spaces);
-    console.log("The version of server you connected to:", session.serverVersion);
-})();
-```
-
-## State management
-
-The library provides built-in state management for WebSocket client. To enable it, just pass `stateTracking`
-option to the `WebSocketChatClient` constructor:
-
-```js
-const wsClient = new PServ.WebSocketChatClient({
-    token: 'your-access-token',
-    url: 'wss://pserv-websocket-address',
-    stateTracking: true, // Enable state tracking
-});
-```
-
-With state tracking enabled, the client will automatically maintain the current state of rooms, users, and messages, 
-by handling incoming events from the server. Reactive data structures are available via `ObservableIndexedObjectCollection`
-objects, which allows you to subscribe to changes.
-
-**Important note:** you can cache these objects for the connection lifetime, but you should refetch them after reconnecting,
+# pserv-js-client-library
+TypeScript client library to handle connection with Devana (new Polfan) chat service.
+
+## How to use?
+
+```js
+(async () => {
+    // Get access token by credentials
+    const token = await PServ.AuthClient.createToken('login', 'password');
+    
+    // Create web api client (there is also WebSocket client available)
+    const client = new PServ.WebApiChatClient({
+        token: token.token, // Pass received token
+        url: 'https://pserv-api-address',
+    });
+    
+    // Call `GetSession` command which returns user session data
+    const session = await client.send('GetSession');
+    
+    console.log("My nick:", session.user.nick);
+    console.log("The rooms you are in:", session.rooms);
+    console.log("The spaces you are in:", session.spaces);
+    console.log("The version of server you connected to:", session.serverVersion);
+})();
+```
+
+## State management
+
+The library provides built-in state management for WebSocket client. To enable it, just pass `stateTracking`
+option to the `WebSocketChatClient` constructor:
+
+```js
+const wsClient = new PServ.WebSocketChatClient({
+    token: 'your-access-token',
+    url: 'wss://pserv-websocket-address',
+    stateTracking: true, // Enable state tracking
+});
+```
+
+With state tracking enabled, the client will automatically maintain the current state of rooms, users, and messages, 
+by handling incoming events from the server. Reactive data structures are available via `ObservableIndexedObjectCollection`
+objects, which allows you to subscribe to changes.
+
+**Important note:** you can cache these objects for the connection lifetime, but you should refetch them after reconnecting,
 because some structures are rebuild from scratch on `Session` event.

package/babel.config.js

@@ -1,6 +1,6 @@
-module.exports = {
-  presets: [
-    ["@babel/preset-env"],
-    ["@babel/preset-typescript", { allowDeclareFields: true }],
-  ],
+module.exports = {
+  presets: [
+    ["@babel/preset-env"],
+    ["@babel/preset-typescript", { allowDeclareFields: true }],
+  ],
 };