@aglyn/tenant-feature-instance 1.0.0-beta.201 → 1.0.0-beta.202

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/tenant-feature-instance",
-  "version": "1.0.0-beta.201",
+  "version": "1.0.0-beta.202",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -25,11 +25,11 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/aglyn": "1.0.0-beta.201",
-    "@aglyn/shared-data-enums": "1.0.0-beta.201",
-    "@aglyn/shared-ui-jsx": "1.0.0-beta.201",
-    "@aglyn/shared-util-http": "1.0.0-beta.201",
-    "@aglyn/shared-util-timestamp": "1.0.0-beta.201",
+    "@aglyn/aglyn": "1.0.0-beta.202",
+    "@aglyn/shared-data-enums": "1.0.0-beta.202",
+    "@aglyn/shared-ui-jsx": "1.0.0-beta.202",
+    "@aglyn/shared-util-http": "1.0.0-beta.202",
+    "@aglyn/shared-util-timestamp": "1.0.0-beta.202",
     "@swc/helpers": "0.5.23",
     "lodash-es": "^4.18.1"
   },

package/src/lib/hooks/use-resolved-activity-actors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+interface ActorRowLike {
+    actorId?: string | null;
+    actorEmail?: string | null;
+}
+/**
+ * A site activity feed's rows, each one that recorded a uid and no address
+ * given the address that uid holds now as `actorEmailNow` (AGL-3369).
+ *
+ * The site feeds read `hosts/{hostId}/activity` in the browser, which sees a
+ * uid but cannot turn one into an address; `/api/hosts/activity-actors`
+ * does, for members of the site and only for uids its log names. Rows render
+ * at once and gain the address when it arrives; a failed lookup leaves them
+ * as they were, and the presenter names the uid instead.
+ */
+export declare function useResolvedActivityActors<T extends ActorRowLike>(hostId: string | null | undefined, rows: readonly T[]): Array<T & {
+    actorEmailNow?: string;
+}>;
+export {};

package/src/lib/hooks/use-resolved-activity-actors.js

@@ -0,0 +1,92 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { useEffect, useMemo, useRef, useState } from "react";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "./firebase/firebase-services.js";
+/** What the route resolves per request; a larger page asks in turns. */ const ACTORS_PER_REQUEST = 50;
+/** A uid the row recorded with no address beside it, or null. */ function unaddressedUid(row) {
+    if (row.actorEmail) return null;
+    const uid = typeof row.actorId === 'string' ? row.actorId.trim() : '';
+    return uid && uid !== 'api' && !uid.startsWith('system:') ? uid : null;
+}
+/**
+ * A site activity feed's rows, each one that recorded a uid and no address
+ * given the address that uid holds now as `actorEmailNow` (AGL-3369).
+ *
+ * The site feeds read `hosts/{hostId}/activity` in the browser, which sees a
+ * uid but cannot turn one into an address; `/api/hosts/activity-actors`
+ * does, for members of the site and only for uids its log names. Rows render
+ * at once and gain the address when it arrives; a failed lookup leaves them
+ * as they were, and the presenter names the uid instead.
+ */ export function useResolvedActivityActors(hostId, rows) {
+    const { data: user } = useUser();
+    const [resolved, setResolved] = useState({});
+    // Asked once per site, in a ref: marking a uid asked must not re-run the
+    // effect that is still waiting on its answer.
+    const asked = useRef(new Set());
+    const currentHost = useRef(hostId);
+    // A different site is a different log: nothing resolved for one is asked
+    // of another's.
+    useEffect(()=>{
+        currentHost.current = hostId;
+        asked.current = new Set();
+        setResolved({});
+    }, [
+        hostId
+    ]);
+    useEffect(()=>{
+        if (!hostId || !user) return;
+        const fresh = [
+            ...new Set(rows.map(unaddressedUid).filter((uid)=>Boolean(uid)))
+        ].filter((uid)=>!asked.current.has(uid));
+        if (!fresh.length) return;
+        for (const uid of fresh)asked.current.add(uid);
+        void (async ()=>{
+            for(let start = 0; start < fresh.length; start += ACTORS_PER_REQUEST){
+                const url = new URL('/api/hosts/activity-actors', window.location.origin);
+                url.searchParams.set('hostId', hostId);
+                url.searchParams.set('uids', fresh.slice(start, start + ACTORS_PER_REQUEST).join(','));
+                try {
+                    const response = await authorizedFetch(user, url.toString());
+                    if (!response.ok) continue;
+                    const payload = await response.json();
+                    if (currentHost.current === hostId && payload.actors) {
+                        setResolved((previous)=>_extends({}, previous, payload.actors));
+                    }
+                } catch (unused) {
+                // The row keeps its uid; the presenter names it.
+                }
+            }
+        })();
+    }, [
+        hostId,
+        user,
+        rows
+    ]);
+    return useMemo(()=>rows.map((row)=>{
+            const uid = unaddressedUid(row);
+            const now = uid ? resolved[uid] : undefined;
+            return now ? _extends({}, row, {
+                actorEmailNow: now
+            }) : row;
+        }), [
+        rows,
+        resolved
+    ]);
+}
+
+//# sourceMappingURL=use-resolved-activity-actors.js.map

package/src/lib/hooks/use-resolved-activity-actors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/tenant/feature/instance/src/lib/hooks/use-resolved-activity-actors.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useEffect, useMemo, useRef, useState } from 'react'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from './firebase/firebase-services'\n\n/** What the route resolves per request; a larger page asks in turns. */\nconst ACTORS_PER_REQUEST = 50\n\ninterface ActorRowLike {\n  actorId?: string | null\n  actorEmail?: string | null\n}\n\n/** A uid the row recorded with no address beside it, or null. */\nfunction unaddressedUid(row: ActorRowLike): string | null {\n  if (row.actorEmail) return null\n  const uid = typeof row.actorId === 'string' ? row.actorId.trim() : ''\n  return uid && uid !== 'api' && !uid.startsWith('system:') ? uid : null\n}\n\n/**\n * A site activity feed's rows, each one that recorded a uid and no address\n * given the address that uid holds now as `actorEmailNow` (AGL-3369).\n *\n * The site feeds read `hosts/{hostId}/activity` in the browser, which sees a\n * uid but cannot turn one into an address; `/api/hosts/activity-actors`\n * does, for members of the site and only for uids its log names. Rows render\n * at once and gain the address when it arrives; a failed lookup leaves them\n * as they were, and the presenter names the uid instead.\n */\nexport function useResolvedActivityActors<T extends ActorRowLike>(\n  hostId: string | null | undefined,\n  rows: readonly T[],\n): Array<T & { actorEmailNow?: string }> {\n  const { data: user } = useUser()\n  const [resolved, setResolved] = useState<Record<string, string>>({})\n  // Asked once per site, in a ref: marking a uid asked must not re-run the\n  // effect that is still waiting on its answer.\n  const asked = useRef(new Set<string>())\n  const currentHost = useRef(hostId)\n\n  // A different site is a different log: nothing resolved for one is asked\n  // of another's.\n  useEffect(() => {\n    currentHost.current = hostId\n    asked.current = new Set()\n    setResolved({})\n  }, [hostId])\n\n  useEffect(() => {\n    if (!hostId || !user) return\n    const fresh = [\n      ...new Set(rows.map(unaddressedUid).filter((uid): uid is string => Boolean(uid))),\n    ].filter((uid) => !asked.current.has(uid))\n    if (!fresh.length) return\n    for (const uid of fresh) asked.current.add(uid)\n    void (async () => {\n      for (let start = 0; start < fresh.length; start += ACTORS_PER_REQUEST) {\n        const url = new URL('/api/hosts/activity-actors', window.location.origin)\n        url.searchParams.set('hostId', hostId)\n        url.searchParams.set('uids', fresh.slice(start, start + ACTORS_PER_REQUEST).join(','))\n        try {\n          const response = await authorizedFetch(user, url.toString())\n          if (!response.ok) continue\n          const payload = (await response.json()) as { actors?: Record<string, string> }\n          if (currentHost.current === hostId && payload.actors) {\n            setResolved((previous) => ({ ...previous, ...payload.actors }))\n          }\n        } catch {\n          // The row keeps its uid; the presenter names it.\n        }\n      }\n    })()\n  }, [hostId, user, rows])\n\n  return useMemo(\n    () =>\n      rows.map((row) => {\n        const uid = unaddressedUid(row)\n        const now = uid ? resolved[uid] : undefined\n        return now ? { ...row, actorEmailNow: now } : row\n      }),\n    [rows, resolved],\n  )\n}\n"],"names":["useEffect","useMemo","useRef","useState","authorizedFetch","useUser","ACTORS_PER_REQUEST","unaddressedUid","row","actorEmail","uid","actorId","trim","startsWith","useResolvedActivityActors","hostId","rows","data","user","resolved","setResolved","asked","Set","currentHost","current","fresh","map","filter","Boolean","has","length","add","start","url","URL","window","location","origin","searchParams","set","slice","join","response","toString","ok","payload","json","actors","previous","now","undefined","actorEmailNow"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,SAAS,EAAEC,OAAO,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,QAAO;AAC5D,SAASC,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,OAAO,QAAQ,kCAA8B;AAEtD,sEAAsE,GACtE,MAAMC,qBAAqB;AAO3B,+DAA+D,GAC/D,SAASC,eAAeC,GAAiB;IACvC,IAAIA,IAAIC,UAAU,EAAE,OAAO;IAC3B,MAAMC,MAAM,OAAOF,IAAIG,OAAO,KAAK,WAAWH,IAAIG,OAAO,CAACC,IAAI,KAAK;IACnE,OAAOF,OAAOA,QAAQ,SAAS,CAACA,IAAIG,UAAU,CAAC,aAAaH,MAAM;AACpE;AAEA;;;;;;;;;CASC,GACD,OAAO,SAASI,0BACdC,MAAiC,EACjCC,IAAkB;IAElB,MAAM,EAAEC,MAAMC,IAAI,EAAE,GAAGb;IACvB,MAAM,CAACc,UAAUC,YAAY,GAAGjB,SAAiC,CAAC;IAClE,yEAAyE;IACzE,8CAA8C;IAC9C,MAAMkB,QAAQnB,OAAO,IAAIoB;IACzB,MAAMC,cAAcrB,OAAOa;IAE3B,yEAAyE;IACzE,gBAAgB;IAChBf,UAAU;QACRuB,YAAYC,OAAO,GAAGT;QACtBM,MAAMG,OAAO,GAAG,IAAIF;QACpBF,YAAY,CAAC;IACf,GAAG;QAACL;KAAO;IAEXf,UAAU;QACR,IAAI,CAACe,UAAU,CAACG,MAAM;QACtB,MAAMO,QAAQ;eACT,IAAIH,IAAIN,KAAKU,GAAG,CAACnB,gBAAgBoB,MAAM,CAAC,CAACjB,MAAuBkB,QAAQlB;SAC5E,CAACiB,MAAM,CAAC,CAACjB,MAAQ,CAACW,MAAMG,OAAO,CAACK,GAAG,CAACnB;QACrC,IAAI,CAACe,MAAMK,MAAM,EAAE;QACnB,KAAK,MAAMpB,OAAOe,MAAOJ,MAAMG,OAAO,CAACO,GAAG,CAACrB;QAC3C,KAAK,AAAC,CAAA;YACJ,IAAK,IAAIsB,QAAQ,GAAGA,QAAQP,MAAMK,MAAM,EAAEE,SAAS1B,mBAAoB;gBACrE,MAAM2B,MAAM,IAAIC,IAAI,8BAA8BC,OAAOC,QAAQ,CAACC,MAAM;gBACxEJ,IAAIK,YAAY,CAACC,GAAG,CAAC,UAAUxB;gBAC/BkB,IAAIK,YAAY,CAACC,GAAG,CAAC,QAAQd,MAAMe,KAAK,CAACR,OAAOA,QAAQ1B,oBAAoBmC,IAAI,CAAC;gBACjF,IAAI;oBACF,MAAMC,WAAW,MAAMtC,gBAAgBc,MAAMe,IAAIU,QAAQ;oBACzD,IAAI,CAACD,SAASE,EAAE,EAAE;oBAClB,MAAMC,UAAW,MAAMH,SAASI,IAAI;oBACpC,IAAIvB,YAAYC,OAAO,KAAKT,UAAU8B,QAAQE,MAAM,EAAE;wBACpD3B,YAAY,CAAC4B,WAAc,aAAKA,UAAaH,QAAQE,MAAM;oBAC7D;gBACF,EAAE,eAAM;gBACN,iDAAiD;gBACnD;YACF;QACF,CAAA;IACF,GAAG;QAAChC;QAAQG;QAAMF;KAAK;IAEvB,OAAOf,QACL,IACEe,KAAKU,GAAG,CAAC,CAAClB;YACR,MAAME,MAAMH,eAAeC;YAC3B,MAAMyC,MAAMvC,MAAMS,QAAQ,CAACT,IAAI,GAAGwC;YAClC,OAAOD,MAAM,aAAKzC;gBAAK2C,eAAeF;iBAAQzC;QAChD,IACF;QAACQ;QAAMG;KAAS;AAEpB"}