Release 1.8.2

Author: chrismccord

CHANGELOG.md

@@ -29,7 +29,7 @@ This release introduces deprecation warnings for several features that have been
 
   * The `config` variable is no longer available in `Phoenix.Endpoint`. In the past, it was possible to read your endpoint configuration at compile-time via an injected variable named `config`, which is no longer supported. Use `Application.compile_env/3` instead, which is tracked by the Elixir compiler and lead to a better developer experience. This may also lead to errors on application boot if you were previously incorrectly setting compile time config at runtime.
 
-## 1.8.2 (Unreleased)
+## 1.8.2 (2025-11-26)
 
 ### Bug fixes
   - [phoenix.js] fix issue where LongPoll can cause "unmatched topic" errors (observed on iOS only) ([#6538](https://github.com/phoenixframework/phoenix/pull/6538))
@@ -46,6 +46,7 @@ This release introduces deprecation warnings for several features that have been
   - [Phoenix.Controller.assign/2] allow passing a function as second argument ([#6542](https://github.com/phoenixframework/phoenix/pull/6542))
   - [Phoenix.Controller.assign/2] support keyword lists and maps as second argument similar to LiveView ([#6513](https://github.com/phoenixframework/phoenix/pull/6513))
   - [Presence] support custom dispatcher for `presence_diff` broadcast ([#6500](https://github.com/phoenixframework/phoenix/pull/6500))
+  - [AGENTS.md] add short test guidelines to usage rules
 
 ## 1.8.1 (2025-08-28)
 

installer/mix.exs

@@ -6,7 +6,7 @@ end
 defmodule Phx.New.MixProject do
   use Mix.Project
 
-  @version "1.8.1"
+  @version "1.8.2"
   @scm_url "https://github.com/phoenixframework/phoenix"
 
   # If the elixir requirement is updated, we need to update:

installer/mix.lock

@@ -1,6 +1,6 @@
 %{
   "earmark_parser": {:hex, :earmark_parser, "1.4.44", "f20830dd6b5c77afe2b063777ddbbff09f9759396500cdbe7523efd58d7a339c", [:mix], [], "hexpm", "4778ac752b4701a5599215f7030989c989ffdc4f6df457c5f36938cc2d2a2750"},
-  "ex_doc": {:hex, :ex_doc, "0.38.4", "ab48dff7a8af84226bf23baddcdda329f467255d924380a0cf0cee97bb9a9ede", [:mix], [{:earmark_parser, "~> 1.4.44", [hex: :earmark_parser, repo: "hexpm", optional: false]}, {:makeup_c, ">= 0.1.0", [hex: :makeup_c, repo: "hexpm", optional: true]}, {:makeup_elixir, "~> 0.14 or ~> 1.0", [hex: :makeup_elixir, repo: "hexpm", optional: false]}, {:makeup_erlang, "~> 0.1 or ~> 1.0", [hex: :makeup_erlang, repo: "hexpm", optional: false]}, {:makeup_html, ">= 0.1.0", [hex: :makeup_html, repo: "hexpm", optional: true]}], "hexpm", "f7b62346408a83911c2580154e35613eb314e0278aeea72ed7fedef9c1f165b2"},
+  "ex_doc": {:hex, :ex_doc, "0.39.1", "e19d356a1ba1e8f8cfc79ce1c3f83884b6abfcb79329d435d4bbb3e97ccc286e", [:mix], [{:earmark_parser, "~> 1.4.44", [hex: :earmark_parser, repo: "hexpm", optional: false]}, {:makeup_c, ">= 0.1.0", [hex: :makeup_c, repo: "hexpm", optional: true]}, {:makeup_elixir, "~> 0.14 or ~> 1.0", [hex: :makeup_elixir, repo: "hexpm", optional: false]}, {:makeup_erlang, "~> 0.1 or ~> 1.0", [hex: :makeup_erlang, repo: "hexpm", optional: false]}, {:makeup_html, ">= 0.1.0", [hex: :makeup_html, repo: "hexpm", optional: true]}], "hexpm", "8abf0ed3e3ca87c0847dfc4168ceab5bedfe881692f1b7c45f4a11b232806865"},
   "makeup": {:hex, :makeup, "1.2.1", "e90ac1c65589ef354378def3ba19d401e739ee7ee06fb47f94c687016e3713d1", [:mix], [{:nimble_parsec, "~> 1.4", [hex: :nimble_parsec, repo: "hexpm", optional: false]}], "hexpm", "d36484867b0bae0fea568d10131197a4c2e47056a6fbe84922bf6ba71c8d17ce"},
   "makeup_elixir": {:hex, :makeup_elixir, "1.0.1", "e928a4f984e795e41e3abd27bfc09f51db16ab8ba1aebdba2b3a575437efafc2", [:mix], [{:makeup, "~> 1.0", [hex: :makeup, repo: "hexpm", optional: false]}, {:nimble_parsec, "~> 1.2.3 or ~> 1.3", [hex: :nimble_parsec, repo: "hexpm", optional: false]}], "hexpm", "7284900d412a3e5cfd97fdaed4f5ed389b8f2b4cb49efc0eb3bd10e2febf9507"},
   "makeup_erlang": {:hex, :makeup_erlang, "1.0.2", "03e1804074b3aa64d5fad7aa64601ed0fb395337b982d9bcf04029d68d51b6a7", [:mix], [{:makeup, "~> 1.0", [hex: :makeup, repo: "hexpm", optional: false]}], "hexpm", "af33ff7ef368d5893e4a267933e7744e46ce3cf1f61e2dccf53a111ed3aa3727"},

priv/static/phoenix.cjs.js

@@ -253,12 +253,14 @@ var Phoenix = (() => {
       });
       this.onClose(() => {
         this.rejoinTimer.reset();
-        if (this.socket.hasLogger()) this.socket.log("channel", `close ${this.topic} ${this.joinRef()}`);
+        if (this.socket.hasLogger())
+          this.socket.log("channel", `close ${this.topic} ${this.joinRef()}`);
         this.state = CHANNEL_STATES.closed;
         this.socket.remove(this);
       });
       this.onError((reason) => {
-        if (this.socket.hasLogger()) this.socket.log("channel", `error ${this.topic}`, reason);
+        if (this.socket.hasLogger())
+          this.socket.log("channel", `error ${this.topic}`, reason);
         if (this.isJoining()) {
           this.joinPush.reset();
         }
@@ -268,7 +270,8 @@ var Phoenix = (() => {
         }
       });
       this.joinPush.receive("timeout", () => {
-        if (this.socket.hasLogger()) this.socket.log("channel", `timeout ${this.topic} (${this.joinRef()})`, this.joinPush.timeout);
+        if (this.socket.hasLogger())
+          this.socket.log("channel", `timeout ${this.topic} (${this.joinRef()})`, this.joinPush.timeout);
         let leavePush = new Push(this, CHANNEL_EVENTS.leave, closure({}), this.timeout);
         leavePush.send();
         this.state = CHANNEL_STATES.errored;
@@ -414,7 +417,8 @@ var Phoenix = (() => {
       this.joinPush.cancelTimeout();
       this.state = CHANNEL_STATES.leaving;
       let onClose = () => {
-        if (this.socket.hasLogger()) this.socket.log("channel", `leave ${this.topic}`);
+        if (this.socket.hasLogger())
+          this.socket.log("channel", `leave ${this.topic}`);
         this.trigger(CHANNEL_EVENTS.close, "leave");
       };
       let leavePush = new Push(this, CHANNEL_EVENTS.leave, closure({}), timeout);
@@ -448,7 +452,8 @@ var Phoenix = (() => {
         return false;
       }
       if (joinRef && joinRef !== this.joinRef()) {
-        if (this.socket.hasLogger()) this.socket.log("channel", "dropping outdated message", { topic, event, payload, joinRef });
+        if (this.socket.hasLogger())
+          this.socket.log("channel", "dropping outdated message", { topic, event, payload, joinRef });
         return false;
       } else {
         return true;
@@ -791,7 +796,7 @@ var Phoenix = (() => {
   };
 
   // js/phoenix/presence.js
-  var Presence = class _Presence {
+  var Presence = class {
     constructor(channel, opts = {}) {
       let events = opts.events || { state: "presence_state", diff: "presence_diff" };
       this.state = {};
@@ -809,9 +814,9 @@ var Phoenix = (() => {
       this.channel.on(events.state, (newState) => {
         let { onJoin, onLeave, onSync } = this.caller;
         this.joinRef = this.channel.joinRef();
-        this.state = _Presence.syncState(this.state, newState, onJoin, onLeave);
+        this.state = Presence.syncState(this.state, newState, onJoin, onLeave);
         this.pendingDiffs.forEach((diff) => {
-          this.state = _Presence.syncDiff(this.state, diff, onJoin, onLeave);
+          this.state = Presence.syncDiff(this.state, diff, onJoin, onLeave);
         });
         this.pendingDiffs = [];
         onSync();
@@ -821,7 +826,7 @@ var Phoenix = (() => {
         if (this.inPendingSyncState()) {
           this.pendingDiffs.push(diff);
         } else {
-          this.state = _Presence.syncDiff(this.state, diff, onJoin, onLeave);
+          this.state = Presence.syncDiff(this.state, diff, onJoin, onLeave);
           onSync();
         }
       });
@@ -836,7 +841,7 @@ var Phoenix = (() => {
       this.caller.onSync = callback;
     }
     list(by) {
-      return _Presence.list(this.state, by);
+      return Presence.list(this.state, by);
     }
     inPendingSyncState() {
       return !this.joinRef || this.joinRef !== this.channel.joinRef();
@@ -1385,7 +1390,8 @@ var Phoenix = (() => {
       clearTimeout(this.heartbeatTimeoutTimer);
     }
     onConnOpen() {
-      if (this.hasLogger()) this.log("transport", `${this.transport.name} connected to ${this.endPointURL()}`);
+      if (this.hasLogger())
+        this.log("transport", `${this.transport.name} connected to ${this.endPointURL()}`);
       this.closeWasClean = false;
       this.disconnecting = false;
       this.establishedConnections++;
@@ -1470,10 +1476,12 @@ var Phoenix = (() => {
       }, 150 * tries);
     }
     onConnClose(event) {
-      if (this.conn) this.conn.onclose = () => {
-      };
+      if (this.conn)
+        this.conn.onclose = () => {
+        };
       let closeCode = event && event.code;
-      if (this.hasLogger()) this.log("transport", "close", event);
+      if (this.hasLogger())
+        this.log("transport", "close", event);
       this.triggerChanError();
       this.clearHeartbeats();
       if (!this.closeWasClean && closeCode !== 1e3) {
@@ -1485,7 +1493,8 @@ var Phoenix = (() => {
      * @private
      */
     onConnError(error) {
-      if (this.hasLogger()) this.log("transport", error);
+      if (this.hasLogger())
+        this.log("transport", error);
       let transportBefore = this.transport;
       let establishedBefore = this.establishedConnections;
       this.stateChangeCallbacks.error.forEach(([, callback]) => {
@@ -1609,7 +1618,8 @@ var Phoenix = (() => {
           this.pendingHeartbeatRef = null;
           this.heartbeatTimer = setTimeout(() => this.sendHeartbeat(), this.heartbeatIntervalMs);
         }
-        if (this.hasLogger()) this.log("receive", `${payload.status || ""} ${topic} ${event} ${ref && "(" + ref + ")" || ""}`, payload);
+        if (this.hasLogger())
+          this.log("receive", `${payload.status || ""} ${topic} ${event} ${ref && "(" + ref + ")" || ""}`, payload);
         for (let i = 0; i < this.channels.length; i++) {
           const channel = this.channels[i];
           if (!channel.isMember(topic, event, payload, join_ref)) {
@@ -1626,7 +1636,8 @@ var Phoenix = (() => {
     leaveOpenTopic(topic) {
       let dupChannel = this.channels.find((c) => c.topic === topic && (c.isJoined() || c.isJoining()));
       if (dupChannel) {
-        if (this.hasLogger()) this.log("transport", `leaving duplicate topic "${topic}"`);
+        if (this.hasLogger())
+          this.log("transport", `leaving duplicate topic "${topic}"`);
         dupChannel.leave();
       }
     }