@supersuit/suggest-a-change 0.1.5 → 0.1.6

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.1.6 (2026-10-15)
+
+- **Writes made in the same millisecond leave the phone in the order they were made.** `enqueue` stamps each op with `seq`, and the queue sorts by `at`, then `seq`, then id. Before, ties fell to the id, so a screen that saved a draft and then asked for it to be prepared in one tick sent the prepare first about half the time, and the receiver prepared the draft as it had been.
+
 ## 0.1.5 (2026-10-14)
 
 - **The agent is Pluma.** Every word a person reads now names Pluma, the agent formerly called Freeda: "With Pluma", "Goes to <owner> and Pluma", "Pluma picks it up". The status key `with-freeda` is unchanged, so stored reports and older clients still read. A copy of the contract vendored elsewhere must be taken again: these are new bytes.

package/dist/client/outbox.d.ts

@@ -9,6 +9,8 @@ export interface Op {
     /** The id of the write this one belongs to (a part's report or follow-up). While that write is refused, this one is held, not sent. */
     parent?: string;
     at: number;
+    /** The order this phone made it in, among writes with the same `at`. Written by enqueue. */
+    seq?: number;
     error?: string;
 }
 export type Sent = 'done' | {

package/dist/client/outbox.js

@@ -5,8 +5,11 @@ export function makeOutbox({ store, send, reach }) {
     // the new write existed. Measured on the phone: without this, a second answer sat on the phone
     // until the 15 s tick.
     let again = false;
+    // Two writes in one millisecond (a save, then the step that reads it) keep the order they were made
+    // in. Ordering them by id instead sent the second first about half the time.
+    let made = 0;
     async function pending() {
-        return (await store.all('outbox')).map((r) => r.value).sort((a, b) => a.at - b.at || a.id.localeCompare(b.id));
+        return (await store.all('outbox')).map((r) => r.value).sort((a, b) => a.at - b.at || (a.seq ?? 0) - (b.seq ?? 0) || a.id.localeCompare(b.id));
     }
     async function tell(landed) {
         const all = await pending();
@@ -56,7 +59,7 @@ export function makeOutbox({ store, send, reach }) {
     }
     return {
         pending,
-        async enqueue(op) { await store.put('outbox', op.id, op); await tell(); },
+        async enqueue(op) { await store.put('outbox', op.id, { ...op, seq: op.seq ?? ++made }); await tell(); },
         drain() {
             if (running) {
                 again = true;

package/package.json

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

@@ -18,6 +18,8 @@ export interface Op {
   /** The id of the write this one belongs to (a part's report or follow-up). While that write is refused, this one is held, not sent. */
   parent?: string
   at: number
+  /** The order this phone made it in, among writes with the same `at`. Written by enqueue. */
+  seq?: number
   error?: string
 }
 export type Sent = 'done' | { refused: string }
@@ -30,9 +32,12 @@ export function makeOutbox({ store, send, reach }: { store: Store; send(op: Op):
   // the new write existed. Measured on the phone: without this, a second answer sat on the phone
   // until the 15 s tick.
   let again = false
+  // Two writes in one millisecond (a save, then the step that reads it) keep the order they were made
+  // in. Ordering them by id instead sent the second first about half the time.
+  let made = 0
 
   async function pending(): Promise<Op[]> {
-    return (await store.all<Op>('outbox')).map((r) => r.value).sort((a, b) => a.at - b.at || a.id.localeCompare(b.id))
+    return (await store.all<Op>('outbox')).map((r) => r.value).sort((a, b) => a.at - b.at || (a.seq ?? 0) - (b.seq ?? 0) || a.id.localeCompare(b.id))
   }
   async function tell(landed?: string) {
     const all = await pending()
@@ -69,7 +74,7 @@ export function makeOutbox({ store, send, reach }: { store: Store; send(op: Op):
   }
   return {
     pending,
-    async enqueue(op: Op) { await store.put('outbox', op.id, op); await tell() },
+    async enqueue(op: Op) { await store.put('outbox', op.id, { ...op, seq: op.seq ?? ++made }); await tell() },
     drain(): Promise<void> {
       if (running) { again = true; return running }
       return (running = run().finally(() => { running = null }))