@nodefony/realtime 10.0.0-alpha.1 → 10.0.0-alpha.3

package/dist/nodefony/src/server/RealtimeHub.js

@@ -56,6 +56,25 @@ const isReservedSystemChannel = isPlatformChannel;
 */
 const REVOCATION_REVALIDATE_MS = 3e4;
 /**
+* Le MOTIF de famille d'un canal — son dernier segment remplacé par `*`.
+*
+* `"studio:metrics:1s"` → `"studio:metrics:*"`, `"alerts"` → `"*"`. Sert à
+* SUGGÉRER une politique qui garde toute une famille, quand un canal dérivé
+* n'est couvert par aucune.
+*
+* Sans expression régulière, et c'est délibéré : `/[^:]*$/` sur un nom de canal
+* venu de l'extérieur se replie à chaque position d'échec, coût quadratique sur
+* une entrée que le module ne choisit pas. Chercher le dernier séparateur est
+* linéaire, et dit plus clairement ce qu'on fait.
+*
+* @param channel - le nom complet du canal
+* @returns le motif couvrant sa famille
+*/
+function channelFamily(channel) {
+	const i = channel.lastIndexOf(":");
+	return i === -1 ? "*" : `${channel.slice(0, i + 1)}*`;
+}
+/**
 * RealtimeHub — broker temps réel **PAR INSTANCE** (1 pod = 1 process = 1 hub local).
 *
 * Élève le realtime serveur du modèle **per-connexion** (chaque connexion son propre
@@ -792,7 +811,7 @@ var RealtimeHub = class RealtimeHub {
 	noticeUnguardedDynamicChannel(channel) {
 		if (!this.hasChannelPolicies()) return;
 		if (this.resolveChannelPolicy(channel) !== null) return;
-		this.#notifyOnce("unguarded-dynamic-channel", `le canal "${channel}" est servi par une fabrique DYNAMIQUE et n'est couvert par AUCUNE politique déclarée, alors que ce module en déclare pour d'autres canaux. Un canal dérivé (suffixe de cadence, forage, identifiant) n'hérite pas de la politique de son parent : un nom exact ne garde que lui-même. Déclarer un MOTIF pour garder la famille — @RealtimeChannel("${channel.replace(/[^:]*$/u, "*")}", { … }) — ou porter la vérification dans la fabrique elle-même.`);
+		this.#notifyOnce("unguarded-dynamic-channel", `le canal "${channel}" est servi par une fabrique DYNAMIQUE et n'est couvert par AUCUNE politique déclarée, alors que ce module en déclare pour d'autres canaux. Un canal dérivé (suffixe de cadence, forage, identifiant) n'hérite pas de la politique de son parent : un nom exact ne garde que lui-même. Déclarer un MOTIF pour garder la famille — @RealtimeChannel("${channelFamily(channel)}", { … }) — ou porter la vérification dans la fabrique elle-même.`);
 	}
 	/**
 	* Enregistre la **factory d'un canal système** (plateforme) — un module bas
@@ -923,4 +942,4 @@ function getRealtimeHub() {
 	return _hub ??= new RealtimeHub();
 }
 //#endregion
-export { RESERVED_SYSTEM_PREFIXES, REVOCATION_REVALIDATE_MS, RealtimeHub, RealtimeHub as default, SLOW_CONSUMER_BYTES, getRealtimeHub, isReservedSystemChannel };
+export { RESERVED_SYSTEM_PREFIXES, REVOCATION_REVALIDATE_MS, RealtimeHub, RealtimeHub as default, SLOW_CONSUMER_BYTES, channelFamily, getRealtimeHub, isReservedSystemChannel };

package/dist/types/nodefony/src/server/RealtimeHub.d.ts

@@ -81,6 +81,22 @@ export declare const isReservedSystemChannel: typeof isPlatformChannel;
  * délai). Ordre de grandeur aligné sur le heartbeat WS (`keepaliveInterval` 20 s).
  */
 export declare const REVOCATION_REVALIDATE_MS = 30000;
+/**
+ * Le MOTIF de famille d'un canal — son dernier segment remplacé par `*`.
+ *
+ * `"studio:metrics:1s"` → `"studio:metrics:*"`, `"alerts"` → `"*"`. Sert à
+ * SUGGÉRER une politique qui garde toute une famille, quand un canal dérivé
+ * n'est couvert par aucune.
+ *
+ * Sans expression régulière, et c'est délibéré : `/[^:]*$/` sur un nom de canal
+ * venu de l'extérieur se replie à chaque position d'échec, coût quadratique sur
+ * une entrée que le module ne choisit pas. Chercher le dernier séparateur est
+ * linéaire, et dit plus clairement ce qu'on fait.
+ *
+ * @param channel - le nom complet du canal
+ * @returns le motif couvrant sa famille
+ */
+export declare function channelFamily(channel: string): string;
 /**
  * Connexion à identité RÉVOCABLE inscrite au registre de re-validation (F4). Ne
  * porte QUE ce qu'il faut pour re-valider puis fermer : le token (avec `isValid`) et

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodefony/realtime",
-  "version": "10.0.0-alpha.1",
+  "version": "10.0.0-alpha.3",
   "description": "Couche temps réel serveur de Nodefony : canaux, appels bidirectionnels JSON-RPC 2.0, contre-pression, et diffusion entre plusieurs instances (boucle locale, IPC de grappe, Redis)",
   "author": "Christophe CAMENSULI <ccamensuli@gmail.com>",
   "type": "module",
@@ -40,18 +40,18 @@
     "esm"
   ],
   "peerDependencies": {
-    "@nodefony/framework": "*",
-    "@nodefony/http": "*",
-    "nodefony": "*",
+    "@nodefony/framework": "^10.0.0-alpha.3",
+    "@nodefony/http": "^10.0.0-alpha.3",
+    "nodefony": "^10.0.0-alpha.3",
     "reflect-metadata": "0.2.2",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@nodefony/framework": "*",
-    "@nodefony/http": "*",
+    "@nodefony/framework": "^10.0.0-alpha.3",
+    "@nodefony/http": "^10.0.0-alpha.3",
     "@types/node": "26.4.1",
     "@vitest/coverage-v8": "5.0.0",
-    "nodefony": "*",
+    "nodefony": "^10.0.0-alpha.3",
     "reflect-metadata": "0.2.2",
     "rimraf": "6.1.3",
     "vitest": "5.0.0"