wuira 0.2.7 → 0.2.8

package/CHANGELOG.md

@@ -7,6 +7,16 @@ with the release date and highlight breaking changes explicitly.
 
 ## Unreleased
 
+## 0.2.8 — 2026-10-17
+
+### Fixed
+
+- `UnitSource("target").onChange` invalidates on `PLAYER_TARGET_CHANGED`, including
+  combat and target removal, without reading secret identities or notifying other
+  unit sources. Event subscriptions stop with the last consumer.
+- Add `onTokenChange` for secure consumers that should only rewrite bindings after
+  an explicit `Retarget`, not when a stable target address points to another unit.
+
 ## 0.2.7 — 2026-10-16
 
 ### Added

package/lib/datasources/UnitSource.d.ts

@@ -20,11 +20,16 @@ export declare class UnitSource extends DataSource<UnitIdentity | undefined> {
     readonly Is: UnitPredicates;
     private restricted;
     private readonly listeners;
+    private readonly tokenListeners;
+    private events?;
     constructor(token: string);
     get Token(): string;
     /** Keep source objects/subscriptions while a stable identity moves to another unit slot. */
     Retarget(token: string): void;
+    /** Secure consumers only need notification when the actual unit address changes. */
+    onTokenChange(listener: () => void): () => void;
     onChange(listener: () => void): () => void;
+    private UpdateEvents;
     protected HasSecretFields(): boolean;
     protected GetValue(): UnitIdentity | undefined;
 }

package/lib/datasources/UnitSource.lua

@@ -506,32 +506,76 @@ function UnitSource.prototype.____constructor(self, token)
     self.token = token
     self.restricted = false
     self.listeners = __TS__New(Set)
+    self.tokenListeners = __TS__New(Set)
     self.Is = __TS__New(
         ____exports.UnitPredicates,
         function() return self.Token end
     )
 end
 function UnitSource.prototype.Retarget(self, token)
+    if issecretvalue(token) or type(token) ~= "string" or __TS__StringTrim(token) == "" then
+        error("UnitSource: expected a public unit token")
+    end
     if token == self.token then
         return
     end
     if InCombatLockdown() then
         error("UnitSource: retarget after combat so secure actions and displayed data stay aligned")
     end
-    if issecretvalue(token) or type(token) ~= "string" or __TS__StringTrim(token) == "" then
-        error("UnitSource: expected a public unit token")
-    end
     self.token = token
+    self:UpdateEvents()
+    for ____, listener in __TS__Iterator(self.tokenListeners) do
+        listener(nil)
+    end
     for ____, listener in __TS__Iterator(self.listeners) do
         listener(nil)
     end
 end
+function UnitSource.prototype.onTokenChange(self, listener)
+    self.tokenListeners:add(listener)
+    return function()
+        self.tokenListeners:delete(listener)
+    end
+end
 function UnitSource.prototype.onChange(self, listener)
     self.listeners:add(listener)
+    self:UpdateEvents()
     return function()
         self.listeners:delete(listener)
+        self:UpdateEvents()
     end
 end
+function UnitSource.prototype.UpdateEvents(self)
+    local ____opt_2 = self.events
+    if ____opt_2 ~= nil then
+        ____opt_2:UnregisterAllEvents()
+    end
+    if self.listeners.size == 0 or self.token ~= "target" then
+        local ____opt_4 = self.events
+        if ____opt_4 ~= nil then
+            ____opt_4:SetScript("OnEvent", nil)
+        end
+        local ____opt_6 = self.events
+        if ____opt_6 ~= nil then
+            ____opt_6:Hide()
+        end
+        self.events = nil
+        return
+    end
+    if self.events == nil then
+        self.events = CreateFrame("Frame", nil, UIParent)
+    end
+    local frame = self.events
+    frame:RegisterEvent("PLAYER_TARGET_CHANGED")
+    frame:SetScript(
+        "OnEvent",
+        function()
+            for ____, listener in __TS__Iterator(self.listeners) do
+                listener(nil)
+            end
+        end
+    )
+end
 function UnitSource.prototype.HasSecretFields(self)
     return self.restricted
 end

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "git+https://github.com/KerimCETINBAS/wuira.git"
   },
-  "version": "0.2.7",
+  "version": "0.2.8",
   "author": {
     "name": "Kerim Cetinbas",
     "email": "a.cetinbas@icloud.com"