@estiva-app/protocol 0.27.0 → 0.28.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
@@ -4,6 +4,25 @@ Every entry answers the wire question explicitly, including when the answer is
4
4
  nothing (ADR 0002 §4b). A change to the bytes an app publishes is a MAJOR — in
5
5
  `0.x`, a MINOR — even when no TypeScript signature moved.
6
6
 
7
+ ## 0.28.0 — 2026-10-07
8
+
9
+ **Wire behaviour: no builder's bytes changed; one tag is new and one is read
10
+ more narrowly** (COM-2, SPEC §13.6.1).
11
+
12
+ - New: a message points at one block of another object with
13
+ `["part", <address>, <block id>]`. `partTag`, `partsOf` (one per address,
14
+ first wins), `resolvePart` (five states: `resolved`, `unaddressable`,
15
+ `detached`, `deleted`, `unreadable`) and `absenceOf`, which tells a deleted
16
+ object from one you cannot read by a `kind:5` naming the address. The signer
17
+ is not compared with the author: the relay accepts the author's owner too
18
+ (§6.5), which no client can check. A part's block id must match
19
+ `[A-Za-z0-9_-]{1,64}`; any other is dropped, because it ends up in a URL
20
+ fragment and a selector.
21
+ - **Narrower:** `blockAnchorOf` returns `undefined` for an event whose `kind`
22
+ is given and is not 1111. A `kind:9` has no `A` to say whose block it names;
23
+ Ship read one against the page it was drawn on. Callers that pass only
24
+ `{ tags }` behave as before.
25
+
7
26
  ## 0.27.0 — 2026-10-06
8
27
 
9
28
  **Wire behaviour: no builder's bytes changed.** One builder removed (COM-3).
package/dist/anchors.d.ts CHANGED
@@ -53,8 +53,18 @@ export type BlockAnchor =
53
53
  state: 'detached';
54
54
  id: string;
55
55
  };
56
- /** The block id a comment anchors to, or `undefined` when it anchors to none. */
56
+ /**
57
+ * The block id a comment anchors to, or `undefined` when it anchors to none.
58
+ *
59
+ * Only a `kind:1111` anchors (§13.6): its `A` says which object the block is
60
+ * in. A `kind:9` has no `A`, so a `block` tag on one names a part of nothing in
61
+ * particular, and a reader that resolved it against the page it happened to be
62
+ * drawn on would report a confident "deleted" about the wrong document. Pass
63
+ * the event's kind and that case is refused; a message pointing at a block of
64
+ * another object says so with a `part` tag instead ({@link partsOf}).
65
+ */
57
66
  export declare function blockAnchorOf(event: {
67
+ kind?: number;
58
68
  tags: string[][];
59
69
  }): string | undefined;
60
70
  /**
@@ -66,4 +76,100 @@ export declare function blockAnchorOf(event: {
66
76
  * has no parts either, and a reader that throws renders nothing at all.
67
77
  */
68
78
  export declare function resolveBlockAnchor(id: string | undefined, value: string, format: ContentFormat): BlockAnchor;
79
+ /**
80
+ * A message pointing at one block of another object — SPEC §13.6.1 (COM-2).
81
+ *
82
+ * `["part", <address>, <block id>]`, beside the `a` for the same address and a
83
+ * body that names it. The same `(object, block)` pair as an anchor, but a
84
+ * different relation: an anchor is what a comment is *about* (like a reply's
85
+ * `e`), a part is what a message *shows* (like a `q`). They are separate tags
86
+ * so that one comment can be both anchored and pointing, and so that a reader
87
+ * which knows neither draws an ordinary reference to the object.
88
+ *
89
+ * Index 3 is left free for an extent (a section, a range), which is not built.
90
+ */
91
+ export declare const PART_TAG = "part";
92
+ /** One `part` tag, read. */
93
+ export interface PartPointer {
94
+ /** `kind:pubkey:d` — the object the block is in. */
95
+ address: string;
96
+ /** §13.3's block id within that object's body. */
97
+ block: string;
98
+ }
99
+ /** The `part` tag for one block of one object. */
100
+ export declare function partTag(address: string, block: string): string[];
101
+ /**
102
+ * The blocks a message points at, one per address, in tag order.
103
+ *
104
+ * The first tag for an address wins: a message shows one block of a given
105
+ * object, and a second tag for it would be a second card nobody can tell
106
+ * apart from the first by its reference in the text.
107
+ *
108
+ * **This is the tags only.** A reader draws a part only while the body still
109
+ * names its address — by `nostr:naddr…` or an app URL (§7.7) — because an edit
110
+ * carries no `part` (§6.8) and a person who removed the reference meant the
111
+ * card to go too. Which addresses the body names is the reader's own
112
+ * reference set; this function does not guess it.
113
+ */
114
+ export declare function partsOf(event: {
115
+ tags: string[][];
116
+ }): PartPointer[];
117
+ /**
118
+ * What a part resolved to. Five states, and like {@link BlockAnchor} none of
119
+ * them is a degree of another:
120
+ *
121
+ * - `resolved` — the block is there; draw it.
122
+ * - `unaddressable` — the object's body is not a block document, so it has no
123
+ * parts. Permanent for that body, and nothing was deleted.
124
+ * - `detached` — the object is readable and the block is gone from it.
125
+ * - `deleted` — the whole object was deleted: its author's `kind:5` names it.
126
+ * - `unreadable` — nothing came back and no deletion did either. **Not
127
+ * "exists but forbidden"**: an address that never existed reads exactly the
128
+ * same, and saying more would confirm a hidden object to anyone holding its
129
+ * address. A reader says it is not available to them, and shows no title and
130
+ * no text.
131
+ *
132
+ * `deleted` and `unreadable` must not render alike. That is the rule this
133
+ * union is shaped to make hard to break.
134
+ */
135
+ export type Part = {
136
+ state: 'resolved';
137
+ block: Block;
138
+ } | {
139
+ state: 'unaddressable';
140
+ } | {
141
+ state: 'detached';
142
+ } | {
143
+ state: 'deleted';
144
+ } | {
145
+ state: 'unreadable';
146
+ };
147
+ /**
148
+ * What a reader holds for the object a part points at: its body, or the reason
149
+ * it has none — from {@link absenceOf}.
150
+ */
151
+ export type PartSource = {
152
+ value: string;
153
+ format: ContentFormat;
154
+ } | 'deleted' | 'unreadable';
155
+ /** Which of the five states a part is in, against its object as it is now. */
156
+ export declare function resolvePart(block: string, source: PartSource): Part;
157
+ /**
158
+ * Why a read by address came back empty: `deleted` when the relay holds a
159
+ * deletion of it by address (a `kind:5` with that `a`), else `unreadable`.
160
+ *
161
+ * `deletions` is what `{kinds: [5], "#a": [address]}` returned. **The signer is
162
+ * not compared with the address's author**, because a client cannot make that
163
+ * comparison correctly (SPEC §6.5, corrected 2026-09-06): the relay accepts a
164
+ * deletion from the author *or the author's owner*, and ownership is visible
165
+ * only to the relay. Most objects here are written by an agent and deleted by
166
+ * the person who owns it; an author-only check would call every one of those
167
+ * "not available to you". A relay that stores deletions it did not adjudicate
168
+ * can at worst make an object you cannot read say "deleted" — less than you
169
+ * were told before, never more.
170
+ */
171
+ export declare function absenceOf(address: string, deletions: readonly {
172
+ kind: number;
173
+ tags: string[][];
174
+ }[]): 'deleted' | 'unreadable';
69
175
  //# sourceMappingURL=anchors.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../src/anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,KAAK,KAAK,EAAqD,MAAM,aAAa,CAAA;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,kCAAkC;AAClC,eAAO,MAAM,gBAAgB,UAAU,CAAA;AAEvC;;;;;;GAMG;AACH,MAAM,MAAM,WAAW;AACrB,wEAAwE;AACtE;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE;AACzB,6CAA6C;GAC3C;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE;AACjD;;;;;GAKG;GACD;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AACxC,+DAA+D;GAC7D;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAErC,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAG7E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,aAAa,GACpB,WAAW,CAWb"}
1
+ {"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../src/anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,KAAK,KAAK,EAAqD,MAAM,aAAa,CAAA;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,kCAAkC;AAClC,eAAO,MAAM,gBAAgB,UAAU,CAAA;AAEvC;;;;;;GAMG;AACH,MAAM,MAAM,WAAW;AACrB,wEAAwE;AACtE;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE;AACzB,6CAA6C;GAC3C;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE;AACjD;;;;;GAKG;GACD;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AACxC,+DAA+D;GAC7D;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAErC;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAI5F;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,aAAa,GACpB,WAAW,CAWb;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,QAAQ,SAAS,CAAA;AAE9B,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;CACd;AAED,kDAAkD;AAClD,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,GAAG,WAAW,EAAE,CAWlE;AAeD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,IAAI,GACZ;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACnC;IAAE,KAAK,EAAE,eAAe,CAAA;CAAE,GAC1B;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GACrB;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GACpB;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,CAAA;AAE3B;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAAG,SAAS,GAAG,YAAY,CAAA;AAE5F,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAMnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,EAAE,GACvD,SAAS,GAAG,YAAY,CAG1B"}
package/dist/anchors.js CHANGED
@@ -19,8 +19,19 @@
19
19
  import { findBlock, parseBlockDocument } from './blocks.js';
20
20
  /** The tag SPEC §13.6 defines. */
21
21
  export const BLOCK_ANCHOR_TAG = 'block';
22
- /** The block id a comment anchors to, or `undefined` when it anchors to none. */
22
+ /**
23
+ * The block id a comment anchors to, or `undefined` when it anchors to none.
24
+ *
25
+ * Only a `kind:1111` anchors (§13.6): its `A` says which object the block is
26
+ * in. A `kind:9` has no `A`, so a `block` tag on one names a part of nothing in
27
+ * particular, and a reader that resolved it against the page it happened to be
28
+ * drawn on would report a confident "deleted" about the wrong document. Pass
29
+ * the event's kind and that case is refused; a message pointing at a block of
30
+ * another object says so with a `part` tag instead ({@link partsOf}).
31
+ */
23
32
  export function blockAnchorOf(event) {
33
+ if (event.kind !== undefined && event.kind !== 1111)
34
+ return undefined;
24
35
  const id = event.tags.find((t) => t[0] === BLOCK_ANCHOR_TAG)?.[1];
25
36
  return id === undefined || id === '' ? undefined : id;
26
37
  }
@@ -47,4 +58,88 @@ export function resolveBlockAnchor(id, value, format) {
47
58
  const block = findBlock(document, id);
48
59
  return block ? { state: 'resolved', id, block } : { state: 'detached', id };
49
60
  }
61
+ /**
62
+ * A message pointing at one block of another object — SPEC §13.6.1 (COM-2).
63
+ *
64
+ * `["part", <address>, <block id>]`, beside the `a` for the same address and a
65
+ * body that names it. The same `(object, block)` pair as an anchor, but a
66
+ * different relation: an anchor is what a comment is *about* (like a reply's
67
+ * `e`), a part is what a message *shows* (like a `q`). They are separate tags
68
+ * so that one comment can be both anchored and pointing, and so that a reader
69
+ * which knows neither draws an ordinary reference to the object.
70
+ *
71
+ * Index 3 is left free for an extent (a section, a range), which is not built.
72
+ */
73
+ export const PART_TAG = 'part';
74
+ /** The `part` tag for one block of one object. */
75
+ export function partTag(address, block) {
76
+ return [PART_TAG, address, block];
77
+ }
78
+ /**
79
+ * The blocks a message points at, one per address, in tag order.
80
+ *
81
+ * The first tag for an address wins: a message shows one block of a given
82
+ * object, and a second tag for it would be a second card nobody can tell
83
+ * apart from the first by its reference in the text.
84
+ *
85
+ * **This is the tags only.** A reader draws a part only while the body still
86
+ * names its address — by `nostr:naddr…` or an app URL (§7.7) — because an edit
87
+ * carries no `part` (§6.8) and a person who removed the reference meant the
88
+ * card to go too. Which addresses the body names is the reader's own
89
+ * reference set; this function does not guess it.
90
+ */
91
+ export function partsOf(event) {
92
+ const out = [];
93
+ const seen = new Set();
94
+ for (const tag of event.tags) {
95
+ if (tag[0] !== PART_TAG)
96
+ continue;
97
+ const [, address, block] = tag;
98
+ if (!address || !block || !isAddress(address) || !BLOCK_ID.test(block) || seen.has(address))
99
+ continue;
100
+ seen.add(address);
101
+ out.push({ address, block });
102
+ }
103
+ return out;
104
+ }
105
+ /**
106
+ * The block ids a part may name. §13.3 fixes no grammar (`newBlockId` writes 12
107
+ * hex; SPEC's examples say `b1`), but a part's id arrives from a stranger's tag
108
+ * or a pasted URL and ends up in a fragment and, in an app, a selector — so a
109
+ * reader takes only ids that are safe in both and drops the rest.
110
+ */
111
+ const BLOCK_ID = /^[A-Za-z0-9_-]{1,64}$/;
112
+ /** `kind:pubkey:d` with a numeric kind and a 64-hex pubkey. */
113
+ function isAddress(value) {
114
+ return /^\d+:[0-9a-f]{64}:/.test(value);
115
+ }
116
+ /** Which of the five states a part is in, against its object as it is now. */
117
+ export function resolvePart(block, source) {
118
+ if (source === 'deleted' || source === 'unreadable')
119
+ return { state: source };
120
+ const anchor = resolveBlockAnchor(block, source.value, source.format);
121
+ if (anchor.state === 'resolved')
122
+ return { state: 'resolved', block: anchor.block };
123
+ if (anchor.state === 'detached')
124
+ return { state: 'detached' };
125
+ return { state: 'unaddressable' };
126
+ }
127
+ /**
128
+ * Why a read by address came back empty: `deleted` when the relay holds a
129
+ * deletion of it by address (a `kind:5` with that `a`), else `unreadable`.
130
+ *
131
+ * `deletions` is what `{kinds: [5], "#a": [address]}` returned. **The signer is
132
+ * not compared with the address's author**, because a client cannot make that
133
+ * comparison correctly (SPEC §6.5, corrected 2026-09-06): the relay accepts a
134
+ * deletion from the author *or the author's owner*, and ownership is visible
135
+ * only to the relay. Most objects here are written by an agent and deleted by
136
+ * the person who owns it; an author-only check would call every one of those
137
+ * "not available to you". A relay that stores deletions it did not adjudicate
138
+ * can at worst make an object you cannot read say "deleted" — less than you
139
+ * were told before, never more.
140
+ */
141
+ export function absenceOf(address, deletions) {
142
+ const deleted = deletions.some((event) => event.kind === 5 && event.tags.some((t) => t[0] === 'a' && t[1] === address));
143
+ return deleted ? 'deleted' : 'unreadable';
144
+ }
50
145
  //# sourceMappingURL=anchors.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"anchors.js","sourceRoot":"","sources":["../src/anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAkC,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAG3F,kCAAkC;AAClC,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAA;AAwBvC,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,KAA2B;IACvD,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACjE,OAAO,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA;AACvD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,EAAsB,EACtB,KAAa,EACb,MAAqB;IAErB,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAA;IACjE,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,CAAA;IAC9D,IAAI,QAAuB,CAAA;IAC3B,IAAI,CAAC;QACH,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,CAAA;IACvC,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IACrC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAA;AAC7E,CAAC"}
1
+ {"version":3,"file":"anchors.js","sourceRoot":"","sources":["../src/anchors.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -46,7 +46,7 @@
46
46
  /** Bumped by hand with the version in package.json — `test/version.test.ts`
47
47
  * pins the two together. It exists so "the upgrade reached the app" can be
48
48
  * checked by grepping a built bundle rather than by trusting a lockfile. */
49
- export declare const PROTOCOL_VERSION = "0.27.0";
49
+ export declare const PROTOCOL_VERSION = "0.28.0";
50
50
  export { type NostrTag, type UnsignedEvent, type SignedEvent, type Profile, type ThreadRef, type ChannelVisibility, type ChannelKind, type MemberRole, type FolderOp, type Label, type ResolutionAction, KIND, MAX_EMOJI_CHARS, MAX_MESSAGE_BYTES, MAX_MENTIONS, MAX_DM_OTHERS, MAX_RATIONALE_BYTES, RELAY_AUTH_TOLERANCE_SECS, ASSERTION_SUBTYPE, computeEventId, toNostrSeconds, canonicalChannelName, threadTags, addr, relayAuthUrl, buildProfile, parseProfile, buildCreateChannel, buildDeleteChannel, buildEditChannelMetadata, buildFolderCommand, buildAddMember, buildDmOpen, buildDmHide, buildReaction, buildDeletion, buildEdit, buildMessage, buildResolution, buildBareFile, buildHighlight, buildUnsignedRelayAuthEvent, } from './events.js';
51
51
  export { type AddressPointer, type EventPointer, encodeNevent, decodeNevent, convertBits, bech32Encode, bech32Decode, encodeNaddr, decodeNaddr, pointerToAddress, addressToPointer, addrToNaddr, naddrToAddr, referenceToPointer, NADDR_RE, findNaddrs, stripNaddrs, encodeNpub, decodeNpub, NOSTR_URI_RE, findNostrUris, } from './nip19.js';
52
52
  export { type AuthEventArgs, TIMESTAMP_TOLERANCE_SECS, normalizeUrl, buildUnsignedAuthEvent, base64, authorizationHeaderFor, authorizationHeader, } from './nip98.js';
@@ -59,6 +59,6 @@ export { type Block, type BlockDocument, type KnownBlockType, KNOWN_BLOCK_TYPES,
59
59
  export { type RenderInline, type RenderBlock, type RenderFormat, type ContentFormat, CONTENT_FORMAT_TAG, BLOCK_DOCUMENT_FORMAT, contentFormatOf, toRenderTree, renderTreeText, standaloneReference, referencesIn, } from './render.js';
60
60
  export { markerTextToBlockDocument, blockDocumentToMarkerText, } from './bridge-content.js';
61
61
  export { type EditorNode, type EditorDocument, EDITOR_BLOCK_TYPES, UNKNOWN_BLOCK_NODE, REFERENCE_NODE, documentForEditing, toEditorDocument, fromEditorDocument, publishableFromEditor, } from './editor.js';
62
- export { type BlockAnchor, BLOCK_ANCHOR_TAG, blockAnchorOf, resolveBlockAnchor, } from './anchors.js';
62
+ export { type BlockAnchor, type Part, type PartPointer, type PartSource, BLOCK_ANCHOR_TAG, PART_TAG, absenceOf, blockAnchorOf, partTag, partsOf, resolveBlockAnchor, resolvePart, } from './anchors.js';
63
63
  export { type BlossomVerb, type Imeta, BLOSSOM_AUTH_TTL_SECS, buildBlossomAuth, blossomAuthHeader, imetaTag, imetaOf, imetaFromAttrs, attachmentsInDocument, type BlobFetchLike, type BlobResponseLike, type FetchedBlob, sha256FromMediaUrl, fetchBlob, sha256Of, uploadBlob, imetaFor, canonicalizeImage, type UploadedBlob, type BlobUploadFetchLike, } from './media.js';
64
64
  //# 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
@@ -46,7 +46,7 @@
46
46
  /** Bumped by hand with the version in package.json — `test/version.test.ts`
47
47
  * pins the two together. It exists so "the upgrade reached the app" can be
48
48
  * checked by grepping a built bundle rather than by trusting a lockfile. */
49
- export const PROTOCOL_VERSION = '0.27.0';
49
+ export const PROTOCOL_VERSION = '0.28.0';
50
50
  export {
51
51
  // constants
52
52
  KIND, MAX_EMOJI_CHARS, MAX_MESSAGE_BYTES, MAX_MENTIONS, MAX_DM_OTHERS, MAX_RATIONALE_BYTES, RELAY_AUTH_TOLERANCE_SECS, ASSERTION_SUBTYPE,
@@ -65,6 +65,6 @@ export { KNOWN_BLOCK_TYPES, BlockDocumentError, validateBlockDocument, parseBloc
65
65
  export { CONTENT_FORMAT_TAG, BLOCK_DOCUMENT_FORMAT, contentFormatOf, toRenderTree, renderTreeText, standaloneReference, referencesIn, } from './render.js';
66
66
  export { markerTextToBlockDocument, blockDocumentToMarkerText, } from './bridge-content.js';
67
67
  export { EDITOR_BLOCK_TYPES, UNKNOWN_BLOCK_NODE, REFERENCE_NODE, documentForEditing, toEditorDocument, fromEditorDocument, publishableFromEditor, } from './editor.js';
68
- export { BLOCK_ANCHOR_TAG, blockAnchorOf, resolveBlockAnchor, } from './anchors.js';
68
+ export { BLOCK_ANCHOR_TAG, PART_TAG, absenceOf, blockAnchorOf, partTag, partsOf, resolveBlockAnchor, resolvePart, } from './anchors.js';
69
69
  export { BLOSSOM_AUTH_TTL_SECS, buildBlossomAuth, blossomAuthHeader, imetaTag, imetaOf, imetaFromAttrs, attachmentsInDocument, sha256FromMediaUrl, fetchBlob, sha256Of, uploadBlob, imetaFor, canonicalizeImage, } from './media.js';
70
70
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH;;4EAE4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAA;AAExC,OAAO;AAaL,YAAY;AACZ,IAAI,EACJ,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB;AACjB,8CAA8C;AAC9C,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,IAAI,EACJ,YAAY;AACZ,WAAW;AACX,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,SAAS,EACT,YAAY,EACZ,eAAe,EACf,aAAa,EACb,cAAc,EACd,2BAA2B,GAC5B,MAAM,aAAa,CAAA;AAEpB,OAAO,EAGL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,QAAQ,EACR,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAA;AAEnB,OAAO,EAEL,wBAAwB,EACxB,YAAY,EACZ,sBAAsB,EACtB,MAAM,EACN,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAGL,mBAAmB,EACnB,SAAS,EACT,eAAe,GAChB,MAAM,WAAW,CAAA;AAElB,OAAO,EAOL,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,KAAK,GACN,MAAM,aAAa,CAAA;AAEpB,OAAO,EAOL,cAAc,EACd,UAAU,EACV,eAAe,GAChB,MAAM,WAAW,CAAA;AAElB,OAAO,EAIL,0BAA0B,GAC3B,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAML,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,cAAc,CAAA;AAErB,OAAO,EAIL,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,qBAAqB,EACrB,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,YAAY,GACb,MAAM,aAAa,CAAA;AAEpB,OAAO,EAKL,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,YAAY,GACb,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAGL,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAEL,gBAAgB,EAChB,aAAa,EACb,kBAAkB,GACnB,MAAM,cAAc,CAAA;AACrB,OAAO,EAGL,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,OAAO,EACP,cAAc,EACd,qBAAqB,EAIrB,kBAAkB,EAClB,SAAS,EACT,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,iBAAiB,GAGlB,MAAM,YAAY,CAAA"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH;;4EAE4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAA;AAExC,OAAO;AAaL,YAAY;AACZ,IAAI,EACJ,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB;AACjB,8CAA8C;AAC9C,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,IAAI,EACJ,YAAY;AACZ,WAAW;AACX,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,SAAS,EACT,YAAY,EACZ,eAAe,EACf,aAAa,EACb,cAAc,EACd,2BAA2B,GAC5B,MAAM,aAAa,CAAA;AAEpB,OAAO,EAGL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,QAAQ,EACR,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAA;AAEnB,OAAO,EAEL,wBAAwB,EACxB,YAAY,EACZ,sBAAsB,EACtB,MAAM,EACN,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAGL,mBAAmB,EACnB,SAAS,EACT,eAAe,GAChB,MAAM,WAAW,CAAA;AAElB,OAAO,EAOL,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,KAAK,GACN,MAAM,aAAa,CAAA;AAEpB,OAAO,EAOL,cAAc,EACd,UAAU,EACV,eAAe,GAChB,MAAM,WAAW,CAAA;AAElB,OAAO,EAIL,0BAA0B,GAC3B,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAML,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,cAAc,CAAA;AAErB,OAAO,EAIL,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,qBAAqB,EACrB,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,YAAY,GACb,MAAM,aAAa,CAAA;AAEpB,OAAO,EAKL,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,YAAY,GACb,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAGL,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAKL,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,aAAa,EACb,OAAO,EACP,OAAO,EACP,kBAAkB,EAClB,WAAW,GACZ,MAAM,cAAc,CAAA;AACrB,OAAO,EAGL,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,OAAO,EACP,cAAc,EACd,qBAAqB,EAIrB,kBAAkB,EAClB,SAAS,EACT,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,iBAAiB,GAGlB,MAAM,YAAY,CAAA"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@estiva-app/protocol",
3
- "version": "0.27.0",
3
+ "version": "0.28.0",
4
4
  "description": "The Estiva wire format: Buzz-shaped Nostr event builders, NIP-01 ids, NIP-19 naddr, NIP-98 HTTP auth, and the relay clients. Speaks the protocol; interprets nothing.",
5
5
  "license": "MIT",
6
6
  "type": "module",
package/src/anchors.ts CHANGED
@@ -44,8 +44,18 @@ export type BlockAnchor =
44
44
  /** The tag names a block that is no longer in the document. */
45
45
  | { state: 'detached'; id: string }
46
46
 
47
- /** The block id a comment anchors to, or `undefined` when it anchors to none. */
48
- export function blockAnchorOf(event: { tags: string[][] }): string | undefined {
47
+ /**
48
+ * The block id a comment anchors to, or `undefined` when it anchors to none.
49
+ *
50
+ * Only a `kind:1111` anchors (§13.6): its `A` says which object the block is
51
+ * in. A `kind:9` has no `A`, so a `block` tag on one names a part of nothing in
52
+ * particular, and a reader that resolved it against the page it happened to be
53
+ * drawn on would report a confident "deleted" about the wrong document. Pass
54
+ * the event's kind and that case is refused; a message pointing at a block of
55
+ * another object says so with a `part` tag instead ({@link partsOf}).
56
+ */
57
+ export function blockAnchorOf(event: { kind?: number; tags: string[][] }): string | undefined {
58
+ if (event.kind !== undefined && event.kind !== 1111) return undefined
49
59
  const id = event.tags.find((t) => t[0] === BLOCK_ANCHOR_TAG)?.[1]
50
60
  return id === undefined || id === '' ? undefined : id
51
61
  }
@@ -74,3 +84,131 @@ export function resolveBlockAnchor(
74
84
  const block = findBlock(document, id)
75
85
  return block ? { state: 'resolved', id, block } : { state: 'detached', id }
76
86
  }
87
+
88
+ /**
89
+ * A message pointing at one block of another object — SPEC §13.6.1 (COM-2).
90
+ *
91
+ * `["part", <address>, <block id>]`, beside the `a` for the same address and a
92
+ * body that names it. The same `(object, block)` pair as an anchor, but a
93
+ * different relation: an anchor is what a comment is *about* (like a reply's
94
+ * `e`), a part is what a message *shows* (like a `q`). They are separate tags
95
+ * so that one comment can be both anchored and pointing, and so that a reader
96
+ * which knows neither draws an ordinary reference to the object.
97
+ *
98
+ * Index 3 is left free for an extent (a section, a range), which is not built.
99
+ */
100
+ export const PART_TAG = 'part'
101
+
102
+ /** One `part` tag, read. */
103
+ export interface PartPointer {
104
+ /** `kind:pubkey:d` — the object the block is in. */
105
+ address: string
106
+ /** §13.3's block id within that object's body. */
107
+ block: string
108
+ }
109
+
110
+ /** The `part` tag for one block of one object. */
111
+ export function partTag(address: string, block: string): string[] {
112
+ return [PART_TAG, address, block]
113
+ }
114
+
115
+ /**
116
+ * The blocks a message points at, one per address, in tag order.
117
+ *
118
+ * The first tag for an address wins: a message shows one block of a given
119
+ * object, and a second tag for it would be a second card nobody can tell
120
+ * apart from the first by its reference in the text.
121
+ *
122
+ * **This is the tags only.** A reader draws a part only while the body still
123
+ * names its address — by `nostr:naddr…` or an app URL (§7.7) — because an edit
124
+ * carries no `part` (§6.8) and a person who removed the reference meant the
125
+ * card to go too. Which addresses the body names is the reader's own
126
+ * reference set; this function does not guess it.
127
+ */
128
+ export function partsOf(event: { tags: string[][] }): PartPointer[] {
129
+ const out: PartPointer[] = []
130
+ const seen = new Set<string>()
131
+ for (const tag of event.tags) {
132
+ if (tag[0] !== PART_TAG) continue
133
+ const [, address, block] = tag
134
+ if (!address || !block || !isAddress(address) || !BLOCK_ID.test(block) || seen.has(address)) continue
135
+ seen.add(address)
136
+ out.push({ address, block })
137
+ }
138
+ return out
139
+ }
140
+
141
+ /**
142
+ * The block ids a part may name. §13.3 fixes no grammar (`newBlockId` writes 12
143
+ * hex; SPEC's examples say `b1`), but a part's id arrives from a stranger's tag
144
+ * or a pasted URL and ends up in a fragment and, in an app, a selector — so a
145
+ * reader takes only ids that are safe in both and drops the rest.
146
+ */
147
+ const BLOCK_ID = /^[A-Za-z0-9_-]{1,64}$/
148
+
149
+ /** `kind:pubkey:d` with a numeric kind and a 64-hex pubkey. */
150
+ function isAddress(value: string): boolean {
151
+ return /^\d+:[0-9a-f]{64}:/.test(value)
152
+ }
153
+
154
+ /**
155
+ * What a part resolved to. Five states, and like {@link BlockAnchor} none of
156
+ * them is a degree of another:
157
+ *
158
+ * - `resolved` — the block is there; draw it.
159
+ * - `unaddressable` — the object's body is not a block document, so it has no
160
+ * parts. Permanent for that body, and nothing was deleted.
161
+ * - `detached` — the object is readable and the block is gone from it.
162
+ * - `deleted` — the whole object was deleted: its author's `kind:5` names it.
163
+ * - `unreadable` — nothing came back and no deletion did either. **Not
164
+ * "exists but forbidden"**: an address that never existed reads exactly the
165
+ * same, and saying more would confirm a hidden object to anyone holding its
166
+ * address. A reader says it is not available to them, and shows no title and
167
+ * no text.
168
+ *
169
+ * `deleted` and `unreadable` must not render alike. That is the rule this
170
+ * union is shaped to make hard to break.
171
+ */
172
+ export type Part =
173
+ | { state: 'resolved'; block: Block }
174
+ | { state: 'unaddressable' }
175
+ | { state: 'detached' }
176
+ | { state: 'deleted' }
177
+ | { state: 'unreadable' }
178
+
179
+ /**
180
+ * What a reader holds for the object a part points at: its body, or the reason
181
+ * it has none — from {@link absenceOf}.
182
+ */
183
+ export type PartSource = { value: string; format: ContentFormat } | 'deleted' | 'unreadable'
184
+
185
+ /** Which of the five states a part is in, against its object as it is now. */
186
+ export function resolvePart(block: string, source: PartSource): Part {
187
+ if (source === 'deleted' || source === 'unreadable') return { state: source }
188
+ const anchor = resolveBlockAnchor(block, source.value, source.format)
189
+ if (anchor.state === 'resolved') return { state: 'resolved', block: anchor.block }
190
+ if (anchor.state === 'detached') return { state: 'detached' }
191
+ return { state: 'unaddressable' }
192
+ }
193
+
194
+ /**
195
+ * Why a read by address came back empty: `deleted` when the relay holds a
196
+ * deletion of it by address (a `kind:5` with that `a`), else `unreadable`.
197
+ *
198
+ * `deletions` is what `{kinds: [5], "#a": [address]}` returned. **The signer is
199
+ * not compared with the address's author**, because a client cannot make that
200
+ * comparison correctly (SPEC §6.5, corrected 2026-09-06): the relay accepts a
201
+ * deletion from the author *or the author's owner*, and ownership is visible
202
+ * only to the relay. Most objects here are written by an agent and deleted by
203
+ * the person who owns it; an author-only check would call every one of those
204
+ * "not available to you". A relay that stores deletions it did not adjudicate
205
+ * can at worst make an object you cannot read say "deleted" — less than you
206
+ * were told before, never more.
207
+ */
208
+ export function absenceOf(
209
+ address: string,
210
+ deletions: readonly { kind: number; tags: string[][] }[],
211
+ ): 'deleted' | 'unreadable' {
212
+ const deleted = deletions.some((event) => event.kind === 5 && event.tags.some((t) => t[0] === 'a' && t[1] === address))
213
+ return deleted ? 'deleted' : 'unreadable'
214
+ }
package/src/index.ts CHANGED
@@ -47,7 +47,7 @@
47
47
  /** Bumped by hand with the version in package.json — `test/version.test.ts`
48
48
  * pins the two together. It exists so "the upgrade reached the app" can be
49
49
  * checked by grepping a built bundle rather than by trusting a lockfile. */
50
- export const PROTOCOL_VERSION = '0.27.0'
50
+ export const PROTOCOL_VERSION = '0.28.0'
51
51
 
52
52
  export {
53
53
  // types
@@ -240,9 +240,17 @@ export {
240
240
 
241
241
  export {
242
242
  type BlockAnchor,
243
+ type Part,
244
+ type PartPointer,
245
+ type PartSource,
243
246
  BLOCK_ANCHOR_TAG,
247
+ PART_TAG,
248
+ absenceOf,
244
249
  blockAnchorOf,
250
+ partTag,
251
+ partsOf,
245
252
  resolveBlockAnchor,
253
+ resolvePart,
246
254
  } from './anchors.js'
247
255
  export {
248
256
  type BlossomVerb,