@gryt/core 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -7,3 +7,5 @@ export { inviteLink, isPublicHost, normalizeCode, normalizeHost, parseServerInpu
 export { NAME_POOL, pickRandomName } from "./profile/randomName.js";
 export { cellState, CUSTOM_VALUE, describeRules, EVERYONE_VALUE, indexRules, nextCellState, scopeChoiceFromValue, scopeChoiceValue, scopeOptions, scopeSetPayload, withCell, type CellState, type ChannelRule, type RuleEffect, type ScopeChoice, } from "./permissions/channelRules.js";
 export { groupMembersByRole, OFFLINE_GROUP_KEY, UNGROUPED_GROUP_KEY, type GroupableMember, type GroupableRole, type MemberGroup, } from "./members/groups.js";
+export { senderStreamId } from "./webrtc/senderStreamId.js";
+export { describeFolderRules, folderFollowNote, folderPhrase, } from "./permissions/folderRules.js";

package/dist/index.js

@@ -9,3 +9,5 @@ export { inviteLink, isPublicHost, normalizeCode, normalizeHost, parseServerInpu
 export { NAME_POOL, pickRandomName } from "./profile/randomName.js";
 export { cellState, CUSTOM_VALUE, describeRules, EVERYONE_VALUE, indexRules, nextCellState, scopeChoiceFromValue, scopeChoiceValue, scopeOptions, scopeSetPayload, withCell, } from "./permissions/channelRules.js";
 export { groupMembersByRole, OFFLINE_GROUP_KEY, UNGROUPED_GROUP_KEY, } from "./members/groups.js";
+export { senderStreamId } from "./webrtc/senderStreamId.js";
+export { describeFolderRules, folderFollowNote, folderPhrase, } from "./permissions/folderRules.js";

package/dist/permissions/folderRules.d.ts

@@ -0,0 +1,10 @@
+import type { ChannelRule } from "./channelRules.js";
+/** "the X folder", or "its folder" when nothing is named. */
+export declare function folderPhrase(folderName: string | null): string;
+/** Shown once a channel has permissions of its own instead of following its folder. */
+export declare function folderFollowNote(folderName: string | null): string;
+/**
+ * The folder's half of `describeRules`: reading denied here hides the folder
+ * along with every channel in it that follows it.
+ */
+export declare function describeFolderRules(rules: ChannelRule[], roleNames: Map<string, string>): string;

package/dist/permissions/folderRules.js

@@ -0,0 +1,29 @@
+/** "the X folder", or "its folder" when nothing is named. */
+export function folderPhrase(folderName) {
+    return folderName ? `the ${folderName} folder` : "its folder";
+}
+/** Shown once a channel has permissions of its own instead of following its folder. */
+export function folderFollowNote(folderName) {
+    return `Has its own permissions instead of ${folderPhrase(folderName)}'s.`;
+}
+/**
+ * The folder's half of `describeRules`: reading denied here hides the folder
+ * along with every channel in it that follows it.
+ */
+export function describeFolderRules(rules, roleNames) {
+    if (rules.length === 0) {
+        return "Everyone on the server can see and use the channels in this folder.";
+    }
+    const hidden = rules
+        .filter((r) => r.permission === "read_messages" && r.effect === "deny")
+        .map((r) => roleNames.get(r.roleId) ?? r.roleId);
+    const others = rules.filter((r) => r.permission !== "read_messages").length;
+    if (hidden.length === 0) {
+        return `${others} change${others === 1 ? "" : "s"} to what roles can do in this folder's channels.`;
+    }
+    const list = hidden.length === 1
+        ? hidden[0]
+        : `${hidden.slice(0, -1).join(", ")} and ${hidden[hidden.length - 1]}`;
+    const rest = others > 0 ? `, and ${others} other change${others === 1 ? "" : "s"}` : "";
+    return `${list} won't see this folder or anything in it${rest}.`;
+}

package/dist/webrtc/senderStreamId.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The stream id for a role: the first one given on this connection, kept in place
+ * across a `replaceTrack` swap. With no connection, `streamId` is returned unchanged.
+ */
+export declare function senderStreamId<Role extends string>(pc: object | null | undefined, role: Role, streamId: string): string;

package/dist/webrtc/senderStreamId.js

@@ -0,0 +1,16 @@
+/** Keyed by connection, so a reconnect — a new connection object — starts over. */
+const byConnection = new WeakMap();
+/**
+ * The stream id for a role: the first one given on this connection, kept in place
+ * across a `replaceTrack` swap. With no connection, `streamId` is returned unchanged.
+ */
+export function senderStreamId(pc, role, streamId) {
+    if (!pc)
+        return streamId;
+    let ids = byConnection.get(pc);
+    if (!ids) {
+        ids = {};
+        byConnection.set(pc, ids);
+    }
+    return (ids[role] ??= streamId);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gryt/core",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Gryt's shared application logic: one implementation of the things the desktop and mobile apps both do.",
   "license": "AGPL-3.0-only",
   "repository": {