@tastic/profile 0.10.0 → 0.11.0

package/README.md

@@ -244,13 +244,18 @@ so a host app plugs the reducer(s) into whatever store it already has:
 - **`createProfileSelectionSlice<TSeat>(namespace, defaultState)`** — a factory for the *other*
   per-seat piece of state: which profile id each seat currently has selected (parallel to
   `createProfileExtensionSlice` above, but keyed by seat instead of by profile id). Returns a
-  `{ actions: { select, clearProfile }, reducer }` pair over a plain `Record<TSeat, string | null>`.
+  `{ actions: { select, clearProfile, pruneToRoster }, reducer }` pair over a plain
+  `Record<TSeat, string | null>`.
   Unlike `createProfileExtensionSlice`, the seat set can't be derived from `TSeat` alone (types
   don't exist at runtime), so callers pass their own `defaultState` — the same literal object (e.g.
   `{ 1: null, 2: null }`) every app already declares today. `select({ seat, profileId })` sets one
   seat's selection directly; `clearProfile(profileId)` walks every seat and nulls out any that
   currently points at that id — call it when a profile is deleted so no seat is left referencing a
-  ghost id. Always local, like the guest/CPU/override colors below — never part of the shared
+  ghost id. `pruneToRoster(ids)` nulls every seat whose id is no longer in the given roster; dispatch
+  it after both `profilesActions.setAll` paths (the initial `resolveInitialProfiles` reconcile and
+  `onRemoteChange`), since a sibling app can delete a profile without this app's own delete ever
+  running, and it returns the same state object when nothing changes.
+  Always local, like the guest/CPU/override colors below, and never part of the shared
   App Group roster, since who's selected on *this* device is naturally per-app, per-device state.
 
 ## Muted profile colors (`ProfileColorProvider`)

package/dist/index.d.mts

@@ -141,6 +141,7 @@ interface SelectProfilePayload<TSeat> {
 }
 interface ProfileSelectionActions<TSeat> {
     clearProfile: ActionCreator<string>;
+    pruneToRoster: ActionCreator<string[]>;
     select: ActionCreator<SelectProfilePayload<TSeat>>;
 }
 type ProfileSelectionState<TSeat extends string | number> = Record<TSeat, string | null>;

package/dist/index.d.ts

@@ -141,6 +141,7 @@ interface SelectProfilePayload<TSeat> {
 }
 interface ProfileSelectionActions<TSeat> {
     clearProfile: ActionCreator<string>;
+    pruneToRoster: ActionCreator<string[]>;
     select: ActionCreator<SelectProfilePayload<TSeat>>;
 }
 type ProfileSelectionState<TSeat extends string | number> = Record<TSeat, string | null>;

package/dist/index.js

@@ -607,6 +607,7 @@ var REHYDRATE = "persist/REHYDRATE";
 function createProfileSelectionSlice(namespace, defaultState, mountKey = "profileSelection") {
   const select = createActionCreator(`profileSelection/${namespace}/select`);
   const clearProfile = createActionCreator(`profileSelection/${namespace}/clearProfile`);
+  const pruneToRoster = createActionCreator(`profileSelection/${namespace}/pruneToRoster`);
   function reducer(state = defaultState, action) {
     if (action.type === REHYDRATE) {
       const persisted = action.payload?.[mountKey];
@@ -620,9 +621,22 @@ function createProfileSelectionSlice(namespace, defaultState, mountKey = "profil
       }
       return next;
     }
+    if (pruneToRoster.match(action)) {
+      const roster = new Set(action.payload);
+      const next = { ...state };
+      let changed = false;
+      for (const seat of Object.keys(state)) {
+        const profileId = state[seat];
+        if (profileId !== null && !roster.has(profileId)) {
+          next[seat] = null;
+          changed = true;
+        }
+      }
+      return changed ? next : state;
+    }
     return state;
   }
-  return { actions: { clearProfile, select }, reducer };
+  return { actions: { clearProfile, pruneToRoster, select }, reducer };
 }
 
 // src/redux/profilesSlice.ts

package/dist/index.mjs

@@ -566,6 +566,7 @@ var REHYDRATE = "persist/REHYDRATE";
 function createProfileSelectionSlice(namespace, defaultState, mountKey = "profileSelection") {
   const select = createActionCreator(`profileSelection/${namespace}/select`);
   const clearProfile = createActionCreator(`profileSelection/${namespace}/clearProfile`);
+  const pruneToRoster = createActionCreator(`profileSelection/${namespace}/pruneToRoster`);
   function reducer(state = defaultState, action) {
     if (action.type === REHYDRATE) {
       const persisted = action.payload?.[mountKey];
@@ -579,9 +580,22 @@ function createProfileSelectionSlice(namespace, defaultState, mountKey = "profil
       }
       return next;
     }
+    if (pruneToRoster.match(action)) {
+      const roster = new Set(action.payload);
+      const next = { ...state };
+      let changed = false;
+      for (const seat of Object.keys(state)) {
+        const profileId = state[seat];
+        if (profileId !== null && !roster.has(profileId)) {
+          next[seat] = null;
+          changed = true;
+        }
+      }
+      return changed ? next : state;
+    }
     return state;
   }
-  return { actions: { clearProfile, select }, reducer };
+  return { actions: { clearProfile, pruneToRoster, select }, reducer };
 }
 
 // src/redux/profilesSlice.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tastic/profile",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Player profile identity for local-multiplayer React Native games — a saved name/color/tag a player selects per seat, with a picker, an inline-editable roster screen, and a reusable identity badge, deliberately blind to any app-specific fields (control scheme, stats) an app layers on top",
   "keywords": [
     "react-native",

package/src/redux/profileSelectionSlice.ts

@@ -14,6 +14,7 @@ export interface SelectProfilePayload<TSeat> {
 
 export interface ProfileSelectionActions<TSeat> {
   clearProfile: ActionCreator<string>
+  pruneToRoster: ActionCreator<string[]>
   select: ActionCreator<SelectProfilePayload<TSeat>>
 }
 
@@ -50,9 +51,15 @@ export interface ProfileSelectionSlice<TSeat extends string | number> {
 // from inside its own reducer function — only worth overriding if some future consumer ever mounts
 // this under a different key. Note `namespace` above is a different thing: it's the app's own name
 // (e.g. 'airhockey', 'boxhockey'), used only to prefix action types, not the mount key.
+//
+// `pruneToRoster(ids)` nulls every seat whose profile id is no longer in the given roster. Call it
+// after any profilesActions.setAll (initial reconcile, onRemoteChange), since a sibling app can
+// delete a profile without this app's own deleteProfile ever running. It returns the same state
+// object when nothing changes, so dispatching it on every foreground resume costs no re-render.
 export function createProfileSelectionSlice<TSeat extends string | number>(namespace: string, defaultState: ProfileSelectionState<TSeat>, mountKey = 'profileSelection'): ProfileSelectionSlice<TSeat> {
   const select = createActionCreator<SelectProfilePayload<TSeat>>(`profileSelection/${namespace}/select`)
   const clearProfile = createActionCreator<string>(`profileSelection/${namespace}/clearProfile`)
+  const pruneToRoster = createActionCreator<string[]>(`profileSelection/${namespace}/pruneToRoster`)
 
   function reducer(state: ProfileSelectionState<TSeat> = defaultState, action: { type: string; payload?: unknown }): ProfileSelectionState<TSeat> {
     // redux-persist's own default stateReconciler (autoMergeLevel1) HARD-REPLACES this slice's
@@ -74,8 +81,21 @@ export function createProfileSelectionSlice<TSeat extends string | number>(names
       }
       return next
     }
+    if (pruneToRoster.match(action)) {
+      const roster = new Set(action.payload)
+      const next = { ...state }
+      let changed = false
+      for (const seat of Object.keys(state) as TSeat[]) {
+        const profileId = state[seat]
+        if (profileId !== null && !roster.has(profileId)) {
+          next[seat] = null
+          changed = true
+        }
+      }
+      return changed ? next : state
+    }
     return state
   }
 
-  return { actions: { clearProfile, select }, reducer }
+  return { actions: { clearProfile, pruneToRoster, select }, reducer }
 }