@supersuit/suggest-a-change 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.1 (2026-10-26)
+
+- **The sheet says when a relay opens the issue.** `Destination` takes `via: 'direct' | 'relay'` and `relayApp` (the relay's app name as people see it). With `via: 'relay'`, `destinationWords` says "Opened by the Supersuit Suggestions app on GitHub, which says it came from <name>." instead of naming a GitHub account that does not open it ("Filed from <account>'s GitHub account."); without a name it says "came from you", without an app name "a suggestions app". The Helm is the first user: its own Mac's account usually cannot push to the repo, so Supersuit files through the relay.
+- **The contract export is typed.** `"."` is now `{ types: "./dist/contract.d.mts", default: "./src/contract.mjs" }`, so a TypeScript host (the Helm's server, which checks a report's context with `validContext`) imports it with its types instead of an implicit any. Plain ESM imports are unchanged.
+
 ## 0.2.0 (2026-10-26)
 
 A suggestion now becomes one ordinary GitHub issue, with everything it was sent with, in the repo that owns the app. A minor version because the statuses changed: apps on `^0.1` stay on 0.1 until they take this one.

package/README.md

@@ -97,7 +97,7 @@ The trail (pages, taps, errors) is kept from the moment any of the module's scre
 
 The issue carries it all in a "Context (shared so this can be fixed)" table of what, value and why (in place of the About line), the trail in collapsible blocks, and a "Reach them" section with `mailto:` and `tel:` links "To thank them or ask a follow-up question". When the body would pass GitHub's limit, the trail is cut first (oldest taps, then pages, then errors), then the transcript.
 
-**Where it files.** With the optional `destination()` adapter, answering `{ repo, public, account, attaches, name? }`, that line becomes the list of exactly what the issue will carry ("your words · your voice note and its transcript · 2 screenshots, saved to the suggestion-attachments branch of acme/notes · this screen (Photos, /photos) · notes 1.2.3 · iPhone, 390x844 · the time · your name, Alex Kim"), the repo it files on, who can read it there (a public repo says so in `--sac-danger`), and whose GitHub account files it. The list follows the draft as things are added or removed, and it is built by `whatGoes` from `./github`, the same pieces `composeIssue` writes the body from, so the sheet and the issue cannot drift. `attaches: false` says files wait until the repo can take them. Sending is the consent. Without the adapter (or when it answers null) the sheet keeps the one line. My suggestions and the detail view link the issue a report became ("Issue #7"); a member who cannot read the repo still sees the number and the state.
+**Where it files.** With the optional `destination()` adapter, answering `{ repo, public, account, attaches, name? }`, that line becomes the list of exactly what the issue will carry ("your words · your voice note and its transcript · 2 screenshots, saved to the suggestion-attachments branch of acme/notes · this screen (Photos, /photos) · notes 1.2.3 · iPhone, 390x844 · the time · your name, Alex Kim"), the repo it files on, who can read it there (a public repo says so in `--sac-danger`), and whose GitHub account files it. The list follows the draft as things are added or removed, and it is built by `whatGoes` from `./github`, the same pieces `composeIssue` writes the body from, so the sheet and the issue cannot drift. `attaches: false` says files wait until the repo can take them. With `via: "relay"` (and `relayApp`, the relay's app name as people see it) the account line says the issue is opened by that app and whose it is ("Opened by the Supersuit Suggestions app on GitHub, which says it came from Alex Kim."), since the filer's own account is not what opens it. Sending is the consent. Without the adapter (or when it answers null) the sheet keeps the one line. My suggestions and the detail view link the issue a report became ("Issue #7"); a member who cannot read the repo still sees the number and the state.
 
 **Identity.** Every screen asks `adapters.identity()` when it mounts, whenever it is handed a different `adapters` object, and whenever the host calls `refreshIdentity()` (exported from `"./client"`; call it after a sign-in, sign-out or account switch). When the account differs, the old account's rows leave the screen and its waiting reports stay on the phone, to be sent only while that account is signed in; every send re-confirms the account first. Keep `adapters` stable where you can; a parent that rebuilds it every render is safe, only slower (one `identity()` call per render).
 

package/dist/github/compose.d.ts

@@ -50,6 +50,11 @@ export interface Destination {
     transcribes?: boolean;
     /** The largest file this destination takes; a larger one is named in the list as staying on the phone. */
     maxInlineBytes?: number;
+    /** How the issue is opened: `direct` from `account`, or `relay` by a relay's GitHub App (createSuggestionRelay), which names the
+     *  sender in the issue. With `relay` the sheet's account line says the app opens it and whose it is, not `account`. */
+    via?: 'direct' | 'relay';
+    /** The relay's app name as people see it ("Acme Suggestions"), for that line. */
+    relayApp?: string;
 }
 /** What composeIssue and whatGoes read: a report in the contract's shape, plus two optional names for the list. */
 export interface Draft {
@@ -137,7 +142,9 @@ export declare const PUBLIC_CONTACT_REASON = "this repo is public, so anyone cou
  *  of context. Anything but what the person added, the app's version and their name can be left out (`optional`). */
 export declare function whatGoes(draft: Draft, destination: Destination): GoesItem[];
 /** The lines around the list: where it files, who can read it there, and whose account files it. */
-export declare function destinationWords(d: Destination): {
+export declare function destinationWords(d: Destination & {
+    name?: string;
+}): {
     headline: string;
     privacy: string;
     danger: boolean;

package/dist/github/compose.js

@@ -115,11 +115,14 @@ function basicGoes(draft, destination) {
 }
 /** The lines around the list: where it files, who can read it there, and whose account files it. */
 export function destinationWords(d) {
+    // Through a relay the issue is opened by the relay's GitHub App, not by the sender's account: say so, and say whose it is.
+    const sender = typeof d.name === 'string' && d.name.trim() ? d.name.trim() : 'you';
+    const app = typeof d.relayApp === 'string' && d.relayApp.trim() ? `the ${d.relayApp.trim()} app` : 'a suggestions app';
     return {
         headline: `Sending this files an issue on ${d.repo}`,
         privacy: d.public ? 'public: anyone on the internet can read this' : `private: people with access to ${d.repo}'s code can read it`,
         danger: Boolean(d.public),
-        account: `Filed from ${d.account}'s GitHub account.`,
+        account: d.via === 'relay' ? `Opened by ${app} on GitHub, which says it came from ${sender}.` : `Filed from ${d.account}'s GitHub account.`,
     };
 }
 /** "2026-10-26T17:04:12Z" -> "2026-10-26 17:04 UTC"; anything unreadable as it is. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supersuit/suggest-a-change",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "The report format and flow behind a Suggest a change button: what a report is, who acts at each step, the screens, and the check every app runs. The contract has zero dependencies.",
   "type": "module",
   "bin": {
@@ -8,7 +8,10 @@
     "suggest-a-change-check": "bin/check.mjs"
   },
   "exports": {
-    ".": "./src/contract.mjs",
+    ".": {
+      "types": "./dist/contract.d.mts",
+      "default": "./src/contract.mjs"
+    },
     "./client": {
       "types": "./dist/client/index.d.ts",
       "import": "./dist/client/index.js"

package/src/github/compose.ts

@@ -28,6 +28,11 @@ export interface Destination {
   transcribes?: boolean
   /** The largest file this destination takes; a larger one is named in the list as staying on the phone. */
   maxInlineBytes?: number
+  /** How the issue is opened: `direct` from `account`, or `relay` by a relay's GitHub App (createSuggestionRelay), which names the
+   *  sender in the issue. With `relay` the sheet's account line says the app opens it and whose it is, not `account`. */
+  via?: 'direct' | 'relay'
+  /** The relay's app name as people see it ("Acme Suggestions"), for that line. */
+  relayApp?: string
 }
 /** What composeIssue and whatGoes read: a report in the contract's shape, plus two optional names for the list. */
 export interface Draft {
@@ -167,12 +172,15 @@ function basicGoes(draft: Draft, destination: Destination): GoesItem[] {
 }
 
 /** The lines around the list: where it files, who can read it there, and whose account files it. */
-export function destinationWords(d: Destination): { headline: string; privacy: string; danger: boolean; account: string } {
+export function destinationWords(d: Destination & { name?: string }): { headline: string; privacy: string; danger: boolean; account: string } {
+  // Through a relay the issue is opened by the relay's GitHub App, not by the sender's account: say so, and say whose it is.
+  const sender = typeof d.name === 'string' && d.name.trim() ? d.name.trim() : 'you'
+  const app = typeof d.relayApp === 'string' && d.relayApp.trim() ? `the ${d.relayApp.trim()} app` : 'a suggestions app'
   return {
     headline: `Sending this files an issue on ${d.repo}`,
     privacy: d.public ? 'public: anyone on the internet can read this' : `private: people with access to ${d.repo}'s code can read it`,
     danger: Boolean(d.public),
-    account: `Filed from ${d.account}'s GitHub account.`,
+    account: d.via === 'relay' ? `Opened by ${app} on GitHub, which says it came from ${sender}.` : `Filed from ${d.account}'s GitHub account.`,
   }
 }