@supersuit/suggest-a-change 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.1.1 (2026-10-13)
+
+- **A report sent with the Mac away is sent when it is back, even with the sheet closed.** The outbox used to move only while the sheet, My suggestions or a detail screen was mounted, so a report waited until the person opened one again. `<SuggestEntry>` now keeps the outbox moving while it is mounted, and `KeepSending` is exported from `./client` for a host with no always-mounted entry (it draws nothing).
+- A voice file's upload link now allows 200,000 bytes per second of declared length, so an uncompressed WAV is not refused.
+- When finalize refuses a file, the pending entry is removed first and the stored object is deleted only if that removal happened.
+- The client test "after Send, focus moves to the receipt" waits for both of its conditions, for longer.
+
 ## 0.1.0 (2026-10-12)
 
 First release. The report contract and flow map: kinds, roles, ceilings, statuses, who acts at each step, and report validation.

package/README.md

@@ -47,7 +47,7 @@ const adapters: Adapters = {
 // then:                        {open && <SuggestSheet adapters={adapters} where={{ screen: "Photos", route: location.pathname }} onClose={() => setOpen(false)} />}
 ```
 
-The entry carries `data-suggest-entry` (the attribute the screen check looks for; see "The check" below). Signed out, it opens nothing and says why. The receipt says "Got it" only after the adapter has answered `done` for the report and every attachment; until then it says the report is on the phone. Every text field the module renders sits in a `[data-voice-field]` container with a `[data-voice-control]`; a host's `Field` slot must keep that shape (it receives `FieldProps`, which is the Helm's voice field props). A voice note alone is a whole report: the recording is kept and uploaded as a part, and the receiving Mac writes the transcript.
+The entry also keeps the phone's outbox moving while it is mounted (a report sent with the Mac away goes when it is back, with the sheet closed); a host with no always-mounted entry renders `<KeepSending adapters={adapters} />` once, high in the app. The entry carries `data-suggest-entry` (the attribute the screen check looks for; see "The check" below). Signed out, it opens nothing and says why. The receipt says "Got it" only after the adapter has answered `done` for the report and every attachment; until then it says the report is on the phone. Every text field the module renders sits in a `[data-voice-field]` container with a `[data-voice-control]`; a host's `Field` slot must keep that shape (it receives `FieldProps`, which is the Helm's voice field props). A voice note alone is a whole report: the recording is kept and uploaded as a part, and the receiving Mac writes the transcript.
 
 Styling: structure only, class names prefixed `sac-`. `@supersuit/suggest-a-change/styles.css` is optional defaults (16px inputs so iOS does not zoom, 44px touch targets, safe-area padding on the sheet). Re-skin it with these custom properties:
 

package/dist/client/entry.d.ts

@@ -1,4 +1,9 @@
 import type { Adapters } from './adapters.ts';
+/** Keeps the phone's outbox moving (on reconnect and every 15 seconds) for as long as it is mounted, with nothing drawn.
+ *  <SuggestEntry> already does this; a host with no always-mounted entry mounts this once, high in the app. */
+export declare function KeepSending({ adapters }: {
+    adapters: Adapters;
+}): null;
 export declare function SuggestEntry({ adapters, onOpen, className }: {
     adapters: Adapters;
     onOpen(): void;

package/dist/client/entry.js

@@ -4,8 +4,15 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 // Signed out, it opens nothing and says why. Signed in, it hands over to the host (`onOpen`), which
 // shows the sheet. `<ReportProblem>` is the same control for an error screen, already filled in.
 import { useEffect, useState } from 'react';
+import { useRuntime } from './runtime.js';
 import { SuggestSheet } from './sheet.js';
 import { stringsFor } from './words.js';
+/** Keeps the phone's outbox moving (on reconnect and every 15 seconds) for as long as it is mounted, with nothing drawn.
+ *  <SuggestEntry> already does this; a host with no always-mounted entry mounts this once, high in the app. */
+export function KeepSending({ adapters }) {
+    useRuntime(adapters);
+    return null;
+}
 export function SuggestEntry({ adapters, onOpen, className }) {
     const S = stringsFor(adapters.words);
     const [why, setWhy] = useState('');
@@ -28,7 +35,7 @@ export function SuggestEntry({ adapters, onOpen, className }) {
         setWhy('');
         onOpen();
     }
-    return (_jsxs("span", { className: "sac-entry-wrap", children: [_jsx("button", { type: "button", "data-suggest-entry": "", className: `sac-entry${className ? ` ${className}` : ''}`, "aria-busy": busy || undefined, onClick: () => void press(), children: S.entry }), why ? _jsx("span", { role: "status", className: "sac-entry-why", children: why }) : null] }));
+    return (_jsxs("span", { className: "sac-entry-wrap", children: [_jsx(KeepSending, { adapters: adapters }), _jsx("button", { type: "button", "data-suggest-entry": "", className: `sac-entry${className ? ` ${className}` : ''}`, "aria-busy": busy || undefined, onClick: () => void press(), children: S.entry }), why ? _jsx("span", { role: "status", className: "sac-entry-why", children: why }) : null] }));
 }
 /** For an error screen: opens the sheet as "something is broken", with the screen and what went wrong filled in. */
 export function ReportProblem({ adapters, screen, error }) {

package/dist/server/handlers.d.ts

@@ -158,7 +158,7 @@ export declare const APPROVAL_LEASE_MS: number;
 export declare const READ_TTL_MS: number;
 export declare const VOICE_FILE_BYTES: number;
 /** A voice file may be this many bytes per declared second (768 kbit/s, generous for any recorder) plus a little slack: ten seconds cannot claim 25 MB. */
-export declare const VOICE_BYTES_PER_SECOND = 96000;
+export declare const VOICE_BYTES_PER_SECOND = 200000;
 /** How long a report with missing attachments waits before it is offered to a Mac anyway. */
 export declare const INCOMPLETE_GRACE_MS: number;
 export declare function createReportHandlers(opts: ReportHandlerOptions): {

package/dist/server/handlers.js

@@ -26,7 +26,7 @@ export const APPROVAL_LEASE_MS = 7 * 24 * 3600_000;
 export const READ_TTL_MS = 5 * 60_000;
 export const VOICE_FILE_BYTES = 25 * 2 ** 20;
 /** A voice file may be this many bytes per declared second (768 kbit/s, generous for any recorder) plus a little slack: ten seconds cannot claim 25 MB. */
-export const VOICE_BYTES_PER_SECOND = 96_000;
+export const VOICE_BYTES_PER_SECOND = 200_000;
 /** How long a report with missing attachments waits before it is offered to a Mac anyway. */
 export const INCOMPLETE_GRACE_MS = 60 * 60_000;
 const FILE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$/;
@@ -374,8 +374,9 @@ export function createReportHandlers(opts) {
             return json(409, { error: 'that file has not arrived yet' });
         const declared = declaredFile(r, file);
         const refuse = async (error) => {
-            await store.discard({ reportId: id, file }); // nothing unverified stays in storage
-            await store.setFile(id, file, null);
+            // Drop the pending entry first and delete the object only if that really removed it: a verified entry that won a race is never orphaned.
+            if (await store.setFile(id, file, null))
+                await store.discard({ reportId: id, file }); // nothing unverified stays in storage
             return json(422, { error });
         };
         if (!sameType(state.pending.type, real.type) || !sameType(declared?.type ?? state.pending.type, real.type))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supersuit/suggest-a-change",
-  "version": "0.1.0",
+  "version": "0.1.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": {

package/src/client/entry.tsx

@@ -4,9 +4,17 @@
 // shows the sheet. `<ReportProblem>` is the same control for an error screen, already filled in.
 import { useEffect, useState } from 'react'
 import type { Adapters } from './adapters.ts'
+import { useRuntime } from './runtime.ts'
 import { SuggestSheet } from './sheet.tsx'
 import { stringsFor } from './words.ts'
 
+/** Keeps the phone's outbox moving (on reconnect and every 15 seconds) for as long as it is mounted, with nothing drawn.
+ *  <SuggestEntry> already does this; a host with no always-mounted entry mounts this once, high in the app. */
+export function KeepSending({ adapters }: { adapters: Adapters }) {
+  useRuntime(adapters)
+  return null
+}
+
 export function SuggestEntry({ adapters, onOpen, className }: { adapters: Adapters; onOpen(): void; className?: string }) {
   const S = stringsFor(adapters.words)
   const [why, setWhy] = useState('')
@@ -23,6 +31,7 @@ export function SuggestEntry({ adapters, onOpen, className }: { adapters: Adapte
   }
   return (
     <span className="sac-entry-wrap">
+      <KeepSending adapters={adapters} />
       <button type="button" data-suggest-entry="" className={`sac-entry${className ? ` ${className}` : ''}`} aria-busy={busy || undefined} onClick={() => void press()}>{S.entry}</button>
       {why ? <span role="status" className="sac-entry-why">{why}</span> : null}
     </span>

package/src/server/handlers.ts

@@ -108,7 +108,7 @@ export const APPROVAL_LEASE_MS = 7 * 24 * 3600_000
 export const READ_TTL_MS = 5 * 60_000
 export const VOICE_FILE_BYTES = 25 * 2 ** 20
 /** A voice file may be this many bytes per declared second (768 kbit/s, generous for any recorder) plus a little slack: ten seconds cannot claim 25 MB. */
-export const VOICE_BYTES_PER_SECOND = 96_000
+export const VOICE_BYTES_PER_SECOND = 200_000
 /** How long a report with missing attachments waits before it is offered to a Mac anyway. */
 export const INCOMPLETE_GRACE_MS = 60 * 60_000
 const FILE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$/
@@ -362,8 +362,8 @@ export function createReportHandlers(opts: ReportHandlerOptions) {
     if (!real) return json(409, { error: 'that file has not arrived yet' })
     const declared = declaredFile(r, file)
     const refuse = async (error: string) => {
-      await store.discard({ reportId: id, file }) // nothing unverified stays in storage
-      await store.setFile(id, file, null)
+      // Drop the pending entry first and delete the object only if that really removed it: a verified entry that won a race is never orphaned.
+      if (await store.setFile(id, file, null)) await store.discard({ reportId: id, file }) // nothing unverified stays in storage
       return json(422, { error })
     }
     if (!sameType(state.pending.type, real.type) || !sameType(declared?.type ?? state.pending.type, real.type)) return refuse('the file\'s contents are not the type it was declared as')