2 Commits

Include renames

Author	SHA1	Message	Date
Claude	078072b527	port(smarm): track HEAD efbc254 — RFC 014/015 API sync ... - gen_server rename (RFC 015, 3e31606): ServerRef/ServerCtx/ServerBuilder -> GenServerRef/GenServerCtx/GenServerBuilder across conn_actor, conn_registry, serve, pubsub, channels::session. - type Timer = () on the three GenServer impls (RFC 015, 57eadb5); handle_timer/handle_idle/tick_every stay defaulted — opt-in later. - Watcher and GenServerCtx are now generic over the server type: watcher fields typed Watcher<Table<M>> / Watcher<Registry<P, K>>; Registry's struct bounds strengthened to its GenServer impl bounds (P: Encode + Decode + Send + Sync + 'static, K: SessionKey) so the Watcher field's G: GenServer bound is satisfiable at the declaration. - RFC 014 (a866e34) registry: register is (Name<M>, Sender<M>), self-only — a name is a typed messaging endpoint, not a pid tag. The introspection-only urus.server / urus.listener.{i} bindings are dropped rather than faked with unit channels; the whereis integration test is deleted; a proper messageable-name design is icebox'd in ROADMAP.md. - Audit vs smarm 6c2b7e9 (queued messages dropped when Receiver drops): pubsub's prune-on-send-failure retain still holds — send Errs once receiver_alive is false, so a dropped rx prunes on next broadcast, exactly what subscriber_count's doc already promised. Freeing stranded Arc<M> broadcasts is strictly good. No change needed. - The 7x E0283 in channels/mod.rs were cascade fallout of the generics changes; dissolved with the port, as discovery predicted. Suite: 90 lib + 45 integration + 2 doc, green under default, smarm-trace, phoenix, and all-features. 3 pre-existing clippy lints (conn.rs, parser.rs, conn_actor.rs; clippy 1.97 strictness) deferred to a follow-up chore commit to keep this diff pure.	2026-07-13 08:22:40 +00:00
Claude	0de2baa72d	feat(channels): opt-in session persistence — v0.6 chunk 3 ... ChannelSession<P> (src/channels/session.rs): a channel actor that outlives its transport, buffering outbound broadcasts as the same Arc<Broadcast<P>>s the relay path carries (zero re-allocation) until rejoin, buffer cap, or TTL. Registered per pattern via PrefixRouter::channel_session::<S>(pattern, factory) / channel_session_default::<C>(pattern); one registry gen_server per registration, monomorphic over S::Key (no type erasure). Machinery: deploy() computes the key on the conn actor and casts the join handshake to the registry; the registry maps key -> (pid, control sender), forwards reattaches, spawns-and-monitors fresh actors, and prunes on Down (pid-guarded against replaced entries). The session actor selects [inbound, bus, ctl] attached and select_timeout([ctl, bus], ttl-remaining) detached; detach triggers are the closed inbound arm and ws send failure (the failed broadcast is the buffer's first entry — nothing lost). Drain re-encodes under the new join generation. As-landed decisions (each in module docs): - ChannelFactory gained a #[doc(hidden)] deploy() seam (default = ephemeral linked actor, the chunk-1 behavior verbatim); JoinHandshake and ChannelInbox are opaque pub structs. Channel construction moved from run_channel into deploy — same linked blast radius. - Every attach calls ch.join() again (rejoin acks need a payload and channels get to re-auth); session channels must treat join as re-entrant. - A rejected rejoin ENDS the session (no zombie sessions held open for unauthorized clients); next join is a cold start. - A second transport EVICTS the first (best-effort phx_close); a session is single-transport. - Explicit leave ends the session, not just the attachment. - TTL per detach episode; subscribe once, on first successful join; cap.max(1) semantics (cap 0 = first buffered message tears down, but an empty buffer still waits out the TTL). - Key: Clone beyond the ratified Eq+Hash+Send — the registry keeps a pid -> key reverse index for Down pruning. - The registry spawns eagerly at registration (channel_session is in-runtime-only, same law as ChannelHub::new): a lazy OnceLock would block std-sync under green threads on first-join races. - Shutdown composes WITHOUT links: conns die -> router Arcs drop -> registry inbox closes -> registry exits -> ctl senders drop -> detached sessions wake on the closed ctl arm, terminate, exit. shutdown_with_detached_session_terminates is the proof (ttl 30s vs 5s budget — only the chain can reap it). Tests: 6 session unit tests (buffer-and-drain ordering across reconnect, TTL expiry, cap teardown, leave, eviction incl. stale conn-entry self-prune, rejected rejoin) + the shutdown integration test. Shared toy codec + conn harness extracted to channels/testkit.rs (mod.rs tests now import it; no behavior change). Hammer: 35x lifecycle subset (+channels +session) + 3x full (phoenix) + 1x full (phoenix+smarm-trace) + featureless + channels-only, all green; dbg-grep clean. Suite: 90 unit + 46 integration + 2 doc under --features phoenix.	2026-06-12 15:22:54 +00:00