@monterosa/sdk-interact-kit 0.19.0-rc.2 → 0.19.0-rc.4

package/dist/core/connect/public-types.d.ts

@@ -28,7 +28,8 @@ export declare enum Klass {
     Poll = "p",
     Feedback = "fb",
     Eoc = "eoc",
-    Vote = "v"
+    Vote = "v",
+    SubsCounter = "subscounter"
 }
 /**
  * @internal

package/dist/core/index.d.ts

@@ -11,3 +11,4 @@ export * from './connection_health';
 export * from './project';
 export * from './event';
 export * from './element';
+export * from './presence_counter';

package/dist/core/presence_counter/api.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * @monterosa/sdk-interact-kit
+ *
+ * Copyright © 2025 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+import { Unsubscribe } from '@monterosa/sdk-util';
+import { PresenceCounter } from './types';
+import { InteractProject } from '../project';
+export declare const presenceCounters: Map<string, PresenceCounter>;
+export declare function getPresenceCounter(project?: InteractProject): Promise<PresenceCounter>;
+export declare function onPresenceCounterUpdate(presenceCounter: PresenceCounter, callback: (count: number) => void): Unsubscribe;
+export declare function onPresenceCounterOpen(presenceCounter: PresenceCounter, callback: () => void): Unsubscribe;
+export declare function onPresenceCounterClose(presenceCounter: PresenceCounter, callback: () => void): Unsubscribe;

package/dist/core/presence_counter/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * @monterosa/sdk-interact-kit
+ *
+ * Copyright © 2025 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+export { getPresenceCounter, onPresenceCounterUpdate, onPresenceCounterOpen, onPresenceCounterClose, } from './api';
+export { PresenceCounter, PresenceCounterState } from './types';

package/dist/core/presence_counter/presence_counter_impl.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * @monterosa/sdk-interact-kit
+ *
+ * Copyright © 2025 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+import { Emitter } from '@monterosa/sdk-util';
+import { PresenceCounter } from './types';
+export declare class PresenceCounterImpl extends Emitter implements PresenceCounter {
+    private host;
+    private id;
+    private state;
+    lastCount: number;
+    private connect;
+    private closeTimeout?;
+    private boundHandleMessage;
+    private boundHandleTimeout;
+    constructor(host: string, id: string);
+    init(): Promise<void>;
+    get isOpened(): boolean;
+    private handleMessage;
+    private handleCounterUpdate;
+    private handleTimeout;
+    private resetTimeout;
+    destroy(): void;
+}

package/dist/core/presence_counter/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * @monterosa/sdk-interact-kit
+ *
+ * Copyright © 2025 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+import { Emitter } from '@monterosa/sdk-util';
+export interface PresenceCounter extends Emitter {
+    readonly isOpened: boolean;
+    readonly lastCount: number;
+}
+export declare enum PresenceCounterState {
+    Opened = "opened",
+    Closed = "closed"
+}
+export type PresenceCounterData = {
+    counter: number;
+    next_update_at: number;
+};

package/dist/index.cjs.js

@@ -200,6 +200,7 @@ exports.Klass = void 0;
     Klass["Feedback"] = "fb";
     Klass["Eoc"] = "eoc";
     Klass["Vote"] = "v";
+    Klass["SubsCounter"] = "subscounter";
 })(exports.Klass || (exports.Klass = {}));
 /**
  * @internal
@@ -2172,55 +2173,6 @@ var ElementImpl = /** @class */ (function (_super) {
     return ElementImpl;
 }(sdkUtil.Emitter));
 
-/**
- * @license
- * @monterosa/sdk-interact-kit
- *
- * Copyright © 2022 Monterosa Productions Limited. All rights reserved.
- *
- * More details on the license can be found at https://www.monterosa.co/sdk/license
- */
-var calculatePercentage = function (values) {
-    // Calculate sum of all votes
-    var sum = values.reduce(function (memo, value) { return memo + value; }, 0);
-    // create array of hashes
-    var results = values.map(function (value, idx) { return ({
-        idx: idx,
-        votes: value,
-        percentage: Math.round((100 * value) / sum) || 0,
-    }); });
-    // Sum them all up - this can be less, equal or greater than a 100%
-    var total = results.reduce(function (memo, _a) {
-        var percentage = _a.percentage;
-        return memo + percentage;
-    }, 0);
-    total = total || 100;
-    // Calculate number of percent that we are missing or that we need to lose
-    var delta = 100 - total;
-    var sign = delta >= 0 ? 1 : -1;
-    // Order all options by number of votes
-    results.sort(function (a, b) {
-        var result = sign * (b.votes - a.votes);
-        if (result !== 0) {
-            return result;
-        }
-        return sign * (a.idx - b.idx);
-    });
-    // If we have percents to lose then take one percent off lowest options
-    // If we are missing percents then add one percent to highest options
-    var i = 0;
-    while (delta !== 0) {
-        if (results[i].votes > 0) {
-            results[i].percentage += sign;
-            delta -= sign;
-        }
-        i++;
-    }
-    // Restore options order
-    results.sort(function (a, b) { return a.idx - b.idx; });
-    return results.map(function (item) { return item.percentage; });
-};
-
 /**
  * @license
  * @monterosa/sdk-interact-kit
@@ -2377,7 +2329,7 @@ function handleFeedbackMessage(message) {
                 return [2 /*return*/];
             }
             votes = counters.split(':').map(function (value) { return +value; });
-            percentages = calculatePercentage(votes);
+            percentages = sdkUtil.calculatePercentage(votes);
             results = votes.map(function (item, idx) { return ({
                 percentage: percentages[idx],
                 votes: item,
@@ -2660,6 +2612,198 @@ function onElementRevoked(event, callback) {
     return sdkUtil.subscribe(event, 'revoke', callback);
 }
 
+/**
+ * @license
+ * @monterosa/sdk-interact-kit
+ *
+ * Copyright © 2025 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+exports.PresenceCounterState = void 0;
+(function (PresenceCounterState) {
+    PresenceCounterState["Opened"] = "opened";
+    PresenceCounterState["Closed"] = "closed";
+})(exports.PresenceCounterState || (exports.PresenceCounterState = {}));
+
+/**
+ * @license
+ * @monterosa/sdk-interact-kit
+ *
+ * Copyright © 2023 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+var logger = new sdkCore.Logger('@monterosa/sdk-interact-kit');
+
+/**
+ * @license
+ * @monterosa/sdk-interact-kit
+ *
+ * Copyright © 2025 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+var PresenceCounterImpl = /** @class */ (function (_super) {
+    __extends(PresenceCounterImpl, _super);
+    function PresenceCounterImpl(host, id) {
+        var _this = _super.call(this) || this;
+        _this.host = host;
+        _this.id = id;
+        _this.state = exports.PresenceCounterState.Closed;
+        _this.lastCount = 0;
+        _this.connect = null;
+        _this.boundHandleMessage = _this.handleMessage.bind(_this);
+        _this.boundHandleTimeout = _this.handleTimeout.bind(_this);
+        return _this;
+    }
+    PresenceCounterImpl.prototype.init = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _a = this;
+                        return [4 /*yield*/, getConnect(this.host)];
+                    case 1:
+                        _a.connect = _b.sent();
+                        this.connect.on('message', this.boundHandleMessage);
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    Object.defineProperty(PresenceCounterImpl.prototype, "isOpened", {
+        get: function () {
+            return this.state === exports.PresenceCounterState.Opened;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    PresenceCounterImpl.prototype.handleMessage = function (message) {
+        return __awaiter(this, void 0, void 0, function () {
+            var id, klass, data, subsData;
+            return __generator(this, function (_a) {
+                id = message.id, klass = message.klass, data = message.data;
+                if (id !== this.id || klass !== exports.Klass.SubsCounter) {
+                    return [2 /*return*/];
+                }
+                try {
+                    subsData = JSON.parse(data[0]);
+                    this.handleCounterUpdate(subsData.counter);
+                    this.resetTimeout(subsData.next_update_at);
+                }
+                catch (e) {
+                    logger.warn("Couldn't parse subscounter message.");
+                }
+                return [2 /*return*/];
+            });
+        });
+    };
+    PresenceCounterImpl.prototype.handleCounterUpdate = function (count) {
+        if (count < 0) {
+            return;
+        }
+        var shouldEmitUpdated = false;
+        var shouldEmitState = false;
+        if (this.lastCount !== count) {
+            shouldEmitUpdated = true;
+            this.lastCount = count;
+        }
+        if (this.state === exports.PresenceCounterState.Closed) {
+            shouldEmitState = true;
+            this.state = exports.PresenceCounterState.Opened;
+        }
+        if (shouldEmitUpdated) {
+            this.emit('updated', this.lastCount);
+        }
+        if (shouldEmitState) {
+            this.emit('state', exports.PresenceCounterState.Opened);
+        }
+    };
+    PresenceCounterImpl.prototype.handleTimeout = function () {
+        this.state = exports.PresenceCounterState.Closed;
+        this.emit('state', exports.PresenceCounterState.Closed);
+    };
+    PresenceCounterImpl.prototype.resetTimeout = function (nextUpdateAt) {
+        clearTimeout(this.closeTimeout);
+        this.closeTimeout = setTimeout(this.boundHandleTimeout, 
+        // because of the time difference between the server and the client,
+        // we need to add 3 seconds to the timeout
+        (nextUpdateAt - sdkUtil.now() + 3) * 1000);
+    };
+    PresenceCounterImpl.prototype.destroy = function () {
+        if (this.connect !== null) {
+            this.connect.off('message', this.boundHandleMessage);
+        }
+    };
+    return PresenceCounterImpl;
+}(sdkUtil.Emitter));
+
+/**
+ * @license
+ * @monterosa/sdk-interact-kit
+ *
+ * Copyright © 2025 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+var presenceCounters = new Map();
+var getPresenceCounterMemoized = sdkUtil.memoizePromise(function (host, id) { return __awaiter(void 0, void 0, void 0, function () {
+    var presenceCounter;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                if (presenceCounters.has(id)) {
+                    return [2 /*return*/, presenceCounters.get(id)];
+                }
+                presenceCounter = new PresenceCounterImpl(host, id);
+                return [4 /*yield*/, presenceCounter.init()];
+            case 1:
+                _a.sent();
+                presenceCounters.set(id, presenceCounter);
+                return [2 /*return*/, presenceCounter];
+        }
+    });
+}); }, function (_, id) { return id; });
+function getPresenceCounter(project) {
+    return __awaiter(this, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!(project === undefined)) return [3 /*break*/, 2];
+                    return [4 /*yield*/, getProject()];
+                case 1:
+                    project = _a.sent();
+                    _a.label = 2;
+                case 2: return [2 /*return*/, getPresenceCounterMemoized(project.context.sdk.options.host, project.id)];
+            }
+        });
+    });
+}
+function onPresenceCounterUpdate(presenceCounter, callback) {
+    presenceCounter.on('updated', callback);
+    return function () { return presenceCounter.off('updated', callback); };
+}
+function onPresenceCounterOpen(presenceCounter, callback) {
+    var handler = function (state) {
+        if (state === exports.PresenceCounterState.Opened) {
+            callback();
+        }
+    };
+    presenceCounter.on('state', handler);
+    return function () { return presenceCounter.off('state', handler); };
+}
+function onPresenceCounterClose(presenceCounter, callback) {
+    var handler = function (state) {
+        if (state === exports.PresenceCounterState.Closed) {
+            callback();
+        }
+    };
+    presenceCounter.on('state', handler);
+    return function () { return presenceCounter.off('state', handler); };
+}
+
 exports.Answer = Answer;
 exports.ElementImpl = ElementImpl;
 exports.EventImpl = EventImpl;
@@ -2676,6 +2820,7 @@ exports.getEvent = getEvent;
 exports.getEventMemoized = getEventMemoized;
 exports.getEvents = getEvents;
 exports.getEventsMemoized = getEventsMemoized;
+exports.getPresenceCounter = getPresenceCounter;
 exports.getProject = getProject;
 exports.getProjectMemoized = getProjectMemoized;
 exports.login = login;
@@ -2690,6 +2835,9 @@ exports.onEventPublished = onEventPublished;
 exports.onEventRemoved = onEventRemoved;
 exports.onEventState = onEventState;
 exports.onEventUpdated = onEventUpdated;
+exports.onPresenceCounterClose = onPresenceCounterClose;
+exports.onPresenceCounterOpen = onPresenceCounterOpen;
+exports.onPresenceCounterUpdate = onPresenceCounterUpdate;
 exports.onProjectFieldsUpdated = onProjectFieldsUpdated;
 exports.onProjectListingsUpdated = onProjectListingsUpdated;
 exports.validateAnswer = validateAnswer;