@supersuit/artifacts 0.57.2 → 0.58.1

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 `@supersuit/artifacts`. One entry per version, newest first. Each entry says what changed, how a
 host can tell whether it is affected (DETECTOR), what a host does about it (REMEDY), and the tests.
 
+## 0.58.1 (2026-10-27)
+
+**The no-link door on a per-reader page offers sign-in.** A signed-in owner or hub admin already got
+through a `links: per-reader` page without a link, but a signed-out one met "This page opens from the
+link it was sent with." and nothing else, so a co-founder opening a company page's bare address had
+no way in (2026-10-27).
+
+- DETECTOR: open a per-reader page's bare address signed out; the door has no sign-in link.
+- REMEDY: none for the host beyond taking this version. The door now carries "Sign in" (only with
+  `signInOrigin` set, only to a visitor not signed in); a signed-in reader who is not owner or admin
+  still sees the plain door, and nothing of the page is shown before the gate.
+- Tests: `src/routes/per-reader.test.tsx` (sign-in offered when signed out, not offered when signed in).
+
+## 0.58.0 (2026-10-27)
+
+**A link's provenance can name its reader by an opaque person id.** Superlinks step 6: a funnel
+suggestion ("Ada read the proposal to the end: move her to proposed?") has to know whose opens these
+are. A label is a name and cannot be trusted as an identity; the sender's opaque person id can.
+
+- `provenance.subject`: a person id, `p_` and 8 characters from the sender's records. Anything else
+  (a name, a different shape) is refused 400 and nothing is added. Kept on the row and answered back
+  like the rest of the provenance.
+- DETECTOR: a sender that posts `provenance.subject` and reads it back missing is on 0.57.x or older.
+- REMEDY: update the host.
+- Tests: recipients-api.test.tsx (subject kept; a name and malformed ids refused).
+
 ## 0.57.2 (2026-10-26)
 
 **0.57.1, published.** 0.57.1 was tagged but never reached npm: its publish run refused it, because

package/README.md

@@ -1085,7 +1085,7 @@ mark is counted as before-send; senders mark as soon as delivery is confirmed.
 ### Who minted a link (0.53.0)
 
 Every link can say who made it, on whose authority, and when: `add: [{ label, provenance: { actor,
-authority, at?, link?, funnel?, stage? } }]`. `actor` is a person acting by hand or "<person>'s
+authority, at?, link?, funnel?, stage?, subject? } }]`; `subject` (0.58.0) is the sender's opaque person id (`p_` and 8 characters), never a name. `actor` is a person acting by hand or "<person>'s
 Pluma"; `authority` names what they acted under ("approved by <person> on the send card", "on
 <person>'s explicit request", "under the recurrent <name>"), with `link` to the session or message
 where one exists (https only); `at` defaults to now. `funnel` (a slug) and `stage` (an id, only with

package/lib/artifacts/recipients-store.d.ts

@@ -36,6 +36,7 @@ export type Provenance = {
     link?: string;
     funnel?: string;
     stage?: string;
+    subject?: string;
 };
 export type RecipientsRecord = {
     recipients: Record<string, Recipient>;

package/lib/routes/artifacts.js

@@ -353,7 +353,9 @@ export function createArtifactRoutes(config) {
             const secret = usableSecret(config.recipientSecret?.());
             const g = await perReaderGate({ id, param, cookie: await readCookie(ridCookieName(id)).catch(() => undefined), secret, recipients: config.recipients });
             if (g.state === 'shut') {
-                return (_jsx(BrandGround, { pack: pack, mode: a.theme, children: _jsx("p", { "data-per-reader-shut": true, className: "mx-auto max-w-xl px-6 pt-32 text-center text-lg opacity-80", children: g.why === 'no-link' ? NO_LINK : UNAVAILABLE }) }));
+                return (_jsxs(BrandGround, { pack: pack, mode: a.theme, children: [_jsx("p", { "data-per-reader-shut": true, className: "mx-auto max-w-xl px-6 pt-32 text-center text-lg opacity-80", children: g.why === 'no-link' ? NO_LINK : UNAVAILABLE }), g.why === 'no-link' && !me && signInOrigin
+                            ? _jsxs("p", { "data-per-reader-sign-in": true, className: "mx-auto max-w-xl px-6 pt-4 text-center text-base opacity-70", children: ["Published this page or help run this site? ", _jsx("a", { className: "underline", href: signInUrl(signInOrigin, pageUrl(id)), children: "Sign in" })] })
+                            : null] }));
             }
             // A fetcher is not the reader: it sets no cookie, carries no render token and sees no note.
             const remember = g.fromLink && !bot

package/lib/routes/recipients-routes.js

@@ -18,7 +18,7 @@ const SLUG = /^[a-z0-9][a-z0-9_-]{0,63}$/;
  *  now), and the funnel step it serves. -> the clean record, or the reason it is refused. */
 export function readProvenance(v, now = new Date()) {
     if (!v || typeof v !== 'object' || Array.isArray(v))
-        return { ok: false, why: 'provenance is { actor, authority, at?, link?, funnel?, stage? }' };
+        return { ok: false, why: 'provenance is { actor, authority, at?, link?, funnel?, stage?, subject? }' };
     const p = v;
     const text = (x, max) => (typeof x === 'string' && x.trim() ? x.trim().slice(0, max) : '');
     const actor = text(p.actor, 120), authority = text(p.authority, 300);
@@ -42,8 +42,12 @@ export function readProvenance(v, now = new Date()) {
         return { ok: false, why: 'provenance.funnel must be a funnel slug' };
     if (p.stage !== undefined && (typeof p.stage !== 'string' || !SLUG.test(p.stage) || p.funnel === undefined))
         return { ok: false, why: 'provenance.stage must be a stage id, with its funnel' };
+    // The reader by the sender's opaque person id (superlinks step 6), so a funnel can tell whose opens
+    // these are without a name ever reaching the host.
+    if (p.subject !== undefined && (typeof p.subject !== 'string' || !/^p_[0-9abcdefghjkmnpqrstvwxyz]{8}$/.test(p.subject)))
+        return { ok: false, why: 'provenance.subject must be an opaque person id (p_ and 8 characters), never a name' };
     const at = typeof p.at === 'string' ? new Date(p.at).toISOString() : now.toISOString();
-    return { ok: true, value: { actor, authority, at, ...(link ? { link } : {}), ...(p.funnel ? { funnel: p.funnel } : {}), ...(p.stage ? { stage: p.stage } : {}) } };
+    return { ok: true, value: { actor, authority, at, ...(link ? { link } : {}), ...(p.funnel ? { funnel: p.funnel } : {}), ...(p.stage ? { stage: p.stage } : {}), ...(p.subject ? { subject: p.subject } : {}) } };
 }
 const none = () => new NextResponse(null, { status: 204, headers: { 'cache-control': 'no-store' } });
 const json = (b, status = 200) => NextResponse.json(b, { status, headers: { 'cache-control': 'no-store' } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supersuit/artifacts",
-  "version": "0.57.2",
+  "version": "0.58.1",
   "description": "Publish markdown as branded, read-aloud pages from a Next.js app: the artifacts store, the route factory, the read-along reader, brand packs, password and confidential pages, and share cards.",
   "license": "MIT",
   "type": "module",