@estiva-app/conversation 0.8.1 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -6,6 +6,19 @@ none. A change to how an event is read is a MINOR in `0.x` even when no
6
6
  signature moved, because two apps on different versions would then disagree
7
7
  about a conversation.
8
8
 
9
+ ## 0.9.0 — 2026-10-06
10
+
11
+ **A restored draft keeps an urgent mention urgent** (CON-31): a draft now
12
+ keeps whom it names urgently beside its text — `write(key, text, urgent?)`
13
+ and `readDraft(key)` → `{ text, urgent? }`. The text cannot say it: an urgent
14
+ mention of somebody with a key is the same `nostr:npub…` as an ordinary one,
15
+ so a restored draft was sent without its `urgent` tag. `read` still returns
16
+ the text; a draft kept before this reads as text alone, and a malformed
17
+ `urgent` list costs the urgency, never the words.
18
+
19
+ SPEC: none. Drafts are local and never on the relay; the send writes §13.1's
20
+ existing `["urgent", <pubkey>]`, now also for a restored draft.
21
+
9
22
  ## 0.8.1 — 2026-10-06
10
23
 
11
24
  **A sentence after an unmatched `[` stops asking the relay** (08d7f243):
package/dist/drafts.d.ts CHANGED
@@ -55,11 +55,30 @@ export interface DraftStorage {
55
55
  setItem(key: string, value: string): void;
56
56
  removeItem(key: string): void;
57
57
  }
58
+ /**
59
+ * A draft as a composer seeds from it: the marker text, and the keys of the
60
+ * people it names urgently (CON-31).
61
+ *
62
+ * The text cannot carry the urgency. An urgent mention of somebody with a key
63
+ * is written as the same `nostr:npub…` as an ordinary one, and the urgency is
64
+ * the `["urgent", <pubkey>]` tag the send adds (SPEC §13.1) — so a draft kept
65
+ * as text alone came back as an ordinary mention and was sent as one.
66
+ */
67
+ export interface Draft {
68
+ text: string;
69
+ /** Whom the urgent chips named, by key; absent when none did. What `urgentTagsFor` takes. */
70
+ urgent?: string[];
71
+ }
58
72
  export interface DraftStore {
59
- /** The draft for this key, or `undefined` — including when storage is unusable. */
73
+ /** The draft's text for this key, or `undefined` — including when storage is unusable. */
60
74
  read(key: string): string | undefined;
61
- /** Keep this text. An empty or whitespace-only draft is a cleared one. */
62
- write(key: string, text: string): void;
75
+ /** The whole draft — its text and its urgent picks — or `undefined`, as {@link DraftStore.read}. */
76
+ readDraft(key: string): Draft | undefined;
77
+ /**
78
+ * Keep this text, and whom it names urgently (the composer's urgent chips, by
79
+ * key). An empty or whitespace-only draft is a cleared one.
80
+ */
81
+ write(key: string, text: string, urgent?: readonly string[]): void;
63
82
  /** Forget it — what a successful send calls. */
64
83
  clear(key: string): void;
65
84
  }
@@ -1 +1 @@
1
- {"version":3,"file":"drafts.d.ts","sourceRoot":"","sources":["../src/drafts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,mGAAmG;AACnG,eAAO,MAAM,gBAAgB,QAA2B,CAAA;AAExD;;;;GAIG;AACH,eAAO,MAAM,eAAe,OAAO,CAAA;AAKnC;;;;GAIG;AACH,eAAO,MAAM,SAAS;IACpB,6DAA6D;mBAC9C,MAAM;IACrB,yDAAyD;0BACnC,MAAM;IAC5B,mGAAmG;oBACnF,MAAM;CACvB,CAAA;AAED,wFAAwF;AACxF,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACnC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAQD,MAAM,WAAW,UAAU;IACzB,mFAAmF;IACnF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACrC,0EAA0E;IAC1E,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,gDAAgD;IAChD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,uEAAuE;AACvE,eAAO,MAAM,SAAS,EAAE,UAAwE,CAAA;AAEhG;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,EAAE,GAAG,GAAE,MAAM,MAAiB,GAAG,UAAU,CA8C5G"}
1
+ {"version":3,"file":"drafts.d.ts","sourceRoot":"","sources":["../src/drafts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,mGAAmG;AACnG,eAAO,MAAM,gBAAgB,QAA2B,CAAA;AAExD;;;;GAIG;AACH,eAAO,MAAM,eAAe,OAAO,CAAA;AAKnC;;;;GAIG;AACH,eAAO,MAAM,SAAS;IACpB,6DAA6D;mBAC9C,MAAM;IACrB,yDAAyD;0BACnC,MAAM;IAC5B,mGAAmG;oBACnF,MAAM;CACvB,CAAA;AAED,wFAAwF;AACxF,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACnC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAgBD,MAAM,WAAW,UAAU;IACzB,0FAA0F;IAC1F,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACrC,oGAAoG;IACpG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;IACzC;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;IAClE,gDAAgD;IAChD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,uEAAuE;AACvE,eAAO,MAAM,SAAS,EAAE,UAAoG,CAAA;AAE5H;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,EAAE,GAAG,GAAE,MAAM,MAAiB,GAAG,UAAU,CAoD5G"}
package/dist/drafts.js CHANGED
@@ -51,8 +51,11 @@ export const draftKeys = {
51
51
  /** Writing into a container itself — a Peek topic, a DM — by the id a person navigates between. */
52
52
  container: (id) => `container:${id}`,
53
53
  };
54
+ const HEX_KEY = /^[0-9a-f]{64}$/;
55
+ /** The keys in a list, once each — what is written, and all that is read back. */
56
+ const keysIn = (list) => Array.isArray(list) ? [...new Set(list.filter((k) => typeof k === 'string' && HEX_KEY.test(k)))] : [];
54
57
  /** A store that keeps nothing, for when there is no storage to use. */
55
- export const NO_DRAFTS = { read: () => undefined, write: () => { }, clear: () => { } };
58
+ export const NO_DRAFTS = { read: () => undefined, readDraft: () => undefined, write: () => { }, clear: () => { } };
56
59
  /**
57
60
  * A draft store over some storage. **Every operation is guarded**: a private
58
61
  * window, cleared site data, blocked storage or a full quota all surface as
@@ -69,36 +72,41 @@ export function createDraftStore(storage, now = Date.now) {
69
72
  // The draft is already unreachable as far as anybody reading it is concerned.
70
73
  }
71
74
  };
72
- return {
73
- read(key) {
74
- try {
75
- const raw = storage.getItem(PREFIX + key);
76
- if (!raw)
77
- return undefined;
78
- const draft = JSON.parse(raw);
79
- if (typeof draft?.text !== 'string' || typeof draft?.at !== 'number') {
80
- // Another version's shape, or corrupted: better dropped than shown.
81
- remove(key);
82
- return undefined;
83
- }
84
- if (now() - draft.at > DRAFT_MAX_AGE_MS) {
85
- remove(key);
86
- return undefined;
87
- }
88
- return draft.text;
75
+ const readDraft = (key) => {
76
+ try {
77
+ const raw = storage.getItem(PREFIX + key);
78
+ if (!raw)
79
+ return undefined;
80
+ const draft = JSON.parse(raw);
81
+ if (typeof draft?.text !== 'string' || typeof draft?.at !== 'number') {
82
+ // Another version's shape, or corrupted: better dropped than shown.
83
+ remove(key);
84
+ return undefined;
89
85
  }
90
- catch {
86
+ if (now() - draft.at > DRAFT_MAX_AGE_MS) {
87
+ remove(key);
91
88
  return undefined;
92
89
  }
93
- },
94
- write(key, text) {
90
+ // A malformed `urgent` costs the urgency, not the text: the words are what a person would miss.
91
+ const urgent = keysIn(draft.urgent);
92
+ return urgent.length > 0 ? { text: draft.text, urgent } : { text: draft.text };
93
+ }
94
+ catch {
95
+ return undefined;
96
+ }
97
+ };
98
+ return {
99
+ read: (key) => readDraft(key)?.text,
100
+ readDraft,
101
+ write(key, text, urgent) {
95
102
  // Whitespace is not a draft: emptying the field forgets it.
96
103
  if (!text.trim())
97
104
  return remove(key);
98
105
  if (text.length > DRAFT_MAX_CHARS)
99
106
  return remove(key);
100
107
  try {
101
- const draft = { text, at: now() };
108
+ const picks = keysIn(urgent);
109
+ const draft = picks.length > 0 ? { text, at: now(), urgent: picks } : { text, at: now() };
102
110
  storage.setItem(PREFIX + key, JSON.stringify(draft));
103
111
  }
104
112
  catch {
@@ -1 +1 @@
1
- {"version":3,"file":"drafts.js","sourceRoot":"","sources":["../src/drafts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,mGAAmG;AACnG,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAA;AAEnC,uFAAuF;AACvF,MAAM,MAAM,GAAG,kBAAkB,CAAA;AAEjC;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,6DAA6D;IAC7D,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,UAAU,IAAI,EAAE;IAC1C,yDAAyD;IACzD,MAAM,EAAE,CAAC,WAAmB,EAAE,EAAE,CAAC,UAAU,WAAW,EAAE;IACxD,mGAAmG;IACnG,SAAS,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,aAAa,EAAE,EAAE;CAC7C,CAAA;AAwBD,uEAAuE;AACvE,MAAM,CAAC,MAAM,SAAS,GAAe,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAA;AAEhG;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAiC,EAAE,MAAoB,IAAI,CAAC,GAAG;IAC9F,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAA;IAE9B,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE;QAC7B,IAAI,CAAC;YACH,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,CAAA;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,8EAA8E;QAChF,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,IAAI,CAAC,GAAG;YACN,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAA;gBACzC,IAAI,CAAC,GAAG;oBAAE,OAAO,SAAS,CAAA;gBAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAA;gBACrD,IAAI,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE,EAAE,KAAK,QAAQ,EAAE,CAAC;oBACrE,oEAAoE;oBACpE,MAAM,CAAC,GAAG,CAAC,CAAA;oBACX,OAAO,SAAS,CAAA;gBAClB,CAAC;gBACD,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,EAAE,GAAG,gBAAgB,EAAE,CAAC;oBACxC,MAAM,CAAC,GAAG,CAAC,CAAA;oBACX,OAAO,SAAS,CAAA;gBAClB,CAAC;gBACD,OAAO,KAAK,CAAC,IAAI,CAAA;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;QAED,KAAK,CAAC,GAAG,EAAE,IAAI;YACb,4DAA4D;YAC5D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;YACpC,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe;gBAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;YACrD,IAAI,CAAC;gBACH,MAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,CAAA;gBAC9C,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,6DAA6D;YAC/D,CAAC;QACH,CAAC;QAED,KAAK,EAAE,MAAM;KACd,CAAA;AACH,CAAC"}
1
+ {"version":3,"file":"drafts.js","sourceRoot":"","sources":["../src/drafts.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -12,7 +12,7 @@
12
12
  * apps: it imports no app's data layer, opens no socket, and takes every
13
13
  * environment touch — the relay read, the clock, storage — as a parameter.
14
14
  */
15
- export declare const CONVERSATION_VERSION = "0.8.1";
15
+ export declare const CONVERSATION_VERSION = "0.9.0";
16
16
  export { KIND_MESSAGE, KIND_COMMENT, KIND_EDIT, KIND_REACTION, KIND_DELETION, KIND_ASSERTION, isConversationKind, isEventId, } from './kinds.js';
17
17
  export { trustedTs, orderingMs, byOrder } from './order.js';
18
18
  export { namedInBody, isReply, anchorsOf, isCommentOn, referencesAddress, strengthOn, threadStrength, referenceTagsFor, mentionTagsFor, peopleNamedInBody, MAX_MENTIONED_PEOPLE, type Strength, } from './strength.js';
@@ -26,5 +26,5 @@ export { FILE_TIER, fileReference, MESSAGE_TIER, rankReferences, REFERENCE_CAPS,
26
26
  export { KIND_CHANGE, MEMBER_FIELD_PREFIX, memberField, memberOfField, mentions, streamOf, membershipOf, membersOf, membershipFilters, candidateFilesOf, buildMembershipChange, MUTED_D_TAG, APPDATA_TAG, parseMutedBlob, serializeMutedBlob, buildMutedEvent, mutedFilter, mutedFromFollowed, type Membership, type MutedList, } from './membership.js';
27
27
  export { READ_STATE_TAG, READ_STATE_D_PREFIX, MAX_CONTEXTS, MAX_CONTEXT_ID_BYTES, MAX_TIMESTAMP, MAX_CLIENT_ID_BYTES, MAX_BLOB_BYTES, MAX_CONTEXTS_BYTES, READ_STATE_HORIZON_DAYS, channelContext, fileContext, threadContext, messageContext, toContextSeconds, isPublishableContextId, loadSlotIdentity, rotateSlotId, readStateDTag, parseReadStateBlob, serializeReadStateBlob, capContextsToBytes, capReadStateContexts, THREAD_RULE_FROM, REPLY_FLOOR_CONTEXT, advanceContexts, buildReadStateEvent, allSlotsFilter, mergeSlots, classifyOwnSlots, effectiveReadAt, threadReadAt, belowReplyFloor, fetchReadState, createSlotCache, publishReadState, type SlotCache, type SlotIdentity, type SlotStorage, type SlotSource, type RandomBytes, type ReadStateBlob, type CappedContexts, type SlotBlob, type OwnSlotVerdict, type Nip44, type FetchedReadState, } from './readState.js';
28
28
  export { unreadIn, isUnread, type StreamJudge } from './unread.js';
29
- export { createDraftStore, draftKeys, NO_DRAFTS, DRAFT_MAX_AGE_MS, DRAFT_MAX_CHARS, type DraftStore, type DraftStorage, } from './drafts.js';
29
+ export { createDraftStore, draftKeys, NO_DRAFTS, DRAFT_MAX_AGE_MS, DRAFT_MAX_CHARS, type Draft, type DraftStore, type DraftStorage, } from './drafts.js';
30
30
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -12,7 +12,7 @@
12
12
  * apps: it imports no app's data layer, opens no socket, and takes every
13
13
  * environment touch — the relay read, the clock, storage — as a parameter.
14
14
  */
15
- export const CONVERSATION_VERSION = '0.8.1';
15
+ export const CONVERSATION_VERSION = '0.9.0';
16
16
  export { KIND_MESSAGE, KIND_COMMENT, KIND_EDIT, KIND_REACTION, KIND_DELETION, KIND_ASSERTION, isConversationKind, isEventId, } from './kinds.js';
17
17
  export { trustedTs, orderingMs, byOrder } from './order.js';
18
18
  export { namedInBody, isReply, anchorsOf, isCommentOn, referencesAddress, strengthOn, threadStrength, referenceTagsFor, mentionTagsFor, peopleNamedInBody, MAX_MENTIONED_PEOPLE, } from './strength.js';
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAA;AAE3C,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,SAAS,GACV,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3D,OAAO,EACL,WAAW,EACX,OAAO,EACP,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GAErB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAiB,MAAM,cAAc,CAAA;AAEpE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAiB,MAAM,YAAY,CAAA;AAEnG,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,GAIf,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,aAAa,EAAoE,MAAM,kBAAkB,CAAA;AAElH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAmB,MAAM,eAAe,CAAA;AAE9F,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAExH,OAAO,EACL,SAAS,EACT,aAAa,EACb,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,QAAQ,GAQT,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACX,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,iBAAiB,GAGlB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,eAAe,EACf,gBAAgB,GAYjB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAoB,MAAM,aAAa,CAAA;AAElE,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,eAAe,GAGhB,MAAM,aAAa,CAAA"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAA;AAE3C,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,SAAS,GACV,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3D,OAAO,EACL,WAAW,EACX,OAAO,EACP,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GAErB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAiB,MAAM,cAAc,CAAA;AAEpE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAiB,MAAM,YAAY,CAAA;AAEnG,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,GAIf,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,aAAa,EAAoE,MAAM,kBAAkB,CAAA;AAElH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAmB,MAAM,eAAe,CAAA;AAE9F,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAExH,OAAO,EACL,SAAS,EACT,aAAa,EACb,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,QAAQ,GAQT,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACX,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,iBAAiB,GAGlB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,eAAe,EACf,gBAAgB,GAYjB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAoB,MAAM,aAAa,CAAA;AAElE,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,eAAe,GAIhB,MAAM,aAAa,CAAA"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@estiva-app/conversation",
3
- "version": "0.8.1",
3
+ "version": "0.9.0",
4
4
  "description": "The conversation rules of the Estiva SPEC (§6.2–§6.8, §11): comment and mention strengths, threading, the edit, reaction and attachment folds, NIP-22 comment and reply builders, drafts, NIP-RS read state, membership and unread. A convenience an app adopts, never a requirement.",
5
5
  "license": "MIT",
6
6
  "type": "module",
package/src/drafts.ts CHANGED
@@ -63,23 +63,51 @@ export interface DraftStorage {
63
63
  removeItem(key: string): void
64
64
  }
65
65
 
66
+ /**
67
+ * A draft as a composer seeds from it: the marker text, and the keys of the
68
+ * people it names urgently (CON-31).
69
+ *
70
+ * The text cannot carry the urgency. An urgent mention of somebody with a key
71
+ * is written as the same `nostr:npub…` as an ordinary one, and the urgency is
72
+ * the `["urgent", <pubkey>]` tag the send adds (SPEC §13.1) — so a draft kept
73
+ * as text alone came back as an ordinary mention and was sent as one.
74
+ */
75
+ export interface Draft {
76
+ text: string
77
+ /** Whom the urgent chips named, by key; absent when none did. What `urgentTagsFor` takes. */
78
+ urgent?: string[]
79
+ }
80
+
66
81
  interface StoredDraft {
67
82
  text: string
68
83
  /** When it was last typed, for the age cap. */
69
84
  at: number
85
+ /** Absent in a draft with no urgent mention, and in every draft kept before CON-31. */
86
+ urgent?: string[]
70
87
  }
71
88
 
89
+ const HEX_KEY = /^[0-9a-f]{64}$/
90
+
91
+ /** The keys in a list, once each — what is written, and all that is read back. */
92
+ const keysIn = (list: unknown): string[] =>
93
+ Array.isArray(list) ? [...new Set(list.filter((k): k is string => typeof k === 'string' && HEX_KEY.test(k)))] : []
94
+
72
95
  export interface DraftStore {
73
- /** The draft for this key, or `undefined` — including when storage is unusable. */
96
+ /** The draft's text for this key, or `undefined` — including when storage is unusable. */
74
97
  read(key: string): string | undefined
75
- /** Keep this text. An empty or whitespace-only draft is a cleared one. */
76
- write(key: string, text: string): void
98
+ /** The whole draft — its text and its urgent picks — or `undefined`, as {@link DraftStore.read}. */
99
+ readDraft(key: string): Draft | undefined
100
+ /**
101
+ * Keep this text, and whom it names urgently (the composer's urgent chips, by
102
+ * key). An empty or whitespace-only draft is a cleared one.
103
+ */
104
+ write(key: string, text: string, urgent?: readonly string[]): void
77
105
  /** Forget it — what a successful send calls. */
78
106
  clear(key: string): void
79
107
  }
80
108
 
81
109
  /** A store that keeps nothing, for when there is no storage to use. */
82
- export const NO_DRAFTS: DraftStore = { read: () => undefined, write: () => {}, clear: () => {} }
110
+ export const NO_DRAFTS: DraftStore = { read: () => undefined, readDraft: () => undefined, write: () => {}, clear: () => {} }
83
111
 
84
112
  /**
85
113
  * A draft store over some storage. **Every operation is guarded**: a private
@@ -97,33 +125,39 @@ export function createDraftStore(storage: DraftStorage | undefined, now: () => n
97
125
  }
98
126
  }
99
127
 
100
- return {
101
- read(key) {
102
- try {
103
- const raw = storage.getItem(PREFIX + key)
104
- if (!raw) return undefined
105
- const draft = JSON.parse(raw) as Partial<StoredDraft>
106
- if (typeof draft?.text !== 'string' || typeof draft?.at !== 'number') {
107
- // Another version's shape, or corrupted: better dropped than shown.
108
- remove(key)
109
- return undefined
110
- }
111
- if (now() - draft.at > DRAFT_MAX_AGE_MS) {
112
- remove(key)
113
- return undefined
114
- }
115
- return draft.text
116
- } catch {
128
+ const readDraft = (key: string): Draft | undefined => {
129
+ try {
130
+ const raw = storage.getItem(PREFIX + key)
131
+ if (!raw) return undefined
132
+ const draft = JSON.parse(raw) as Partial<StoredDraft>
133
+ if (typeof draft?.text !== 'string' || typeof draft?.at !== 'number') {
134
+ // Another version's shape, or corrupted: better dropped than shown.
135
+ remove(key)
117
136
  return undefined
118
137
  }
119
- },
138
+ if (now() - draft.at > DRAFT_MAX_AGE_MS) {
139
+ remove(key)
140
+ return undefined
141
+ }
142
+ // A malformed `urgent` costs the urgency, not the text: the words are what a person would miss.
143
+ const urgent = keysIn(draft.urgent)
144
+ return urgent.length > 0 ? { text: draft.text, urgent } : { text: draft.text }
145
+ } catch {
146
+ return undefined
147
+ }
148
+ }
149
+
150
+ return {
151
+ read: (key) => readDraft(key)?.text,
152
+ readDraft,
120
153
 
121
- write(key, text) {
154
+ write(key, text, urgent) {
122
155
  // Whitespace is not a draft: emptying the field forgets it.
123
156
  if (!text.trim()) return remove(key)
124
157
  if (text.length > DRAFT_MAX_CHARS) return remove(key)
125
158
  try {
126
- const draft: StoredDraft = { text, at: now() }
159
+ const picks = keysIn(urgent)
160
+ const draft: StoredDraft = picks.length > 0 ? { text, at: now(), urgent: picks } : { text, at: now() }
127
161
  storage.setItem(PREFIX + key, JSON.stringify(draft))
128
162
  } catch {
129
163
  // Quota, or storage refused. The text is still in the field.
package/src/index.ts CHANGED
@@ -12,7 +12,7 @@
12
12
  * apps: it imports no app's data layer, opens no socket, and takes every
13
13
  * environment touch — the relay read, the clock, storage — as a parameter.
14
14
  */
15
- export const CONVERSATION_VERSION = '0.8.1'
15
+ export const CONVERSATION_VERSION = '0.9.0'
16
16
 
17
17
  export {
18
18
  KIND_MESSAGE,
@@ -164,6 +164,7 @@ export {
164
164
  NO_DRAFTS,
165
165
  DRAFT_MAX_AGE_MS,
166
166
  DRAFT_MAX_CHARS,
167
+ type Draft,
167
168
  type DraftStore,
168
169
  type DraftStorage,
169
170
  } from './drafts.js'