@estiva-app/interop 0.69.0 → 0.69.1
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 +16 -0
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/mentions.d.ts +8 -0
- package/dist/mentions.d.ts.map +1 -1
- package/dist/mentions.js +24 -5
- package/dist/mentions.js.map +1 -1
- package/package.json +1 -1
- package/src/index.ts +8 -1
- package/src/mentions.ts +26 -5
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,22 @@ how a declaration is read, is a MAJOR — in `0.x`, a MINOR — even when no
|
|
|
6
6
|
TypeScript signature moved. A consumer upgrading must be able to tell whether
|
|
7
7
|
manifests already published still mean what they meant.
|
|
8
8
|
|
|
9
|
+
## 0.69.1 — 2026-10-27
|
|
10
|
+
|
|
11
|
+
**Manifest: nothing.** A security fix in reading Mentioned in (PEEKM-7's
|
|
12
|
+
review); no manifest declaration or tag changes meaning.
|
|
13
|
+
|
|
14
|
+
- `readMentionedIn` asks about at most `MAX_MENTIONED_IN_LINKS_ASKED` (64)
|
|
15
|
+
links a read, newest messages first; one left over stays unanswered, so a
|
|
16
|
+
message pointing at the file keeps its row, and a later read asks the next
|
|
17
|
+
ones. Before, it asked about every link in up to 200 candidates at once, one
|
|
18
|
+
relay query each: one comment of hundreds of app links made every viewer of
|
|
19
|
+
the file fire that many and draw 429s.
|
|
20
|
+
- `mentionedInOf` and `readMentionedIn` read only a message's first
|
|
21
|
+
`MAX_LINKS_ASKED` (24) links, the ones a sender asks about before it tags. A
|
|
22
|
+
link past them names nothing and keeps no row, even one the reader already
|
|
23
|
+
knows.
|
|
24
|
+
|
|
9
25
|
## 0.69.0 — 2026-10-27
|
|
10
26
|
|
|
11
27
|
**Wire behaviour: a comment built from a manifest carries the `a`, `q` and
|
package/dist/index.d.ts
CHANGED
|
@@ -49,7 +49,7 @@ export { planCreateFolder, planRenameFolder, planDeleteFolder, planPlaceFile, pl
|
|
|
49
49
|
* keeps a resolver of its own.
|
|
50
50
|
*/
|
|
51
51
|
export { linkReader, linkTagsOf, linksIn, writtenOpenerOf, within, MAX_LINKS_ASKED, type LinkAnswer, type LinkReader, type LinkReaderOptions, type OwnPlace, } from './links.js';
|
|
52
|
-
export { mentionedInFilter, mentionedInOf, readMentionedIn, MENTIONED_IN_LIMIT, type MentionedIn } from './mentions.js';
|
|
52
|
+
export { mentionedInFilter, mentionedInOf, readMentionedIn, MENTIONED_IN_LIMIT, MAX_MENTIONED_IN_LINKS_ASKED, type MentionedIn, } from './mentions.js';
|
|
53
53
|
/**
|
|
54
54
|
* RFC 0.5 §7's URL grammar — how an object is named in an address bar, and how
|
|
55
55
|
* a pasted link is matched back to one.
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,0BAA0B,EAC1B,sBAAsB,EACtB,OAAO,EACP,KAAK,MAAM,EACX,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,KAAK,mBAAmB,EACxB,SAAS,EACT,KAAK,OAAO,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,eAAe,EACpB,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,aAAa,EAClB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAA;AAExB;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,GACjC,MAAM,iBAAiB,CAAA;AAExB;;;;;GAKG;AACH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAA;AAErB;;;;GAIG;AACH,OAAO,EACL,UAAU,EACV,UAAU,EACV,OAAO,EACP,eAAe,EACf,MAAM,EACN,eAAe,EACf,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,QAAQ,GACd,MAAM,YAAY,CAAA;AACnB,OAAO,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,0BAA0B,EAC1B,sBAAsB,EACtB,OAAO,EACP,KAAK,MAAM,EACX,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,KAAK,mBAAmB,EACxB,SAAS,EACT,KAAK,OAAO,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,eAAe,EACpB,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,aAAa,EAClB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAA;AAExB;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,GACjC,MAAM,iBAAiB,CAAA;AAExB;;;;;GAKG;AACH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAA;AAErB;;;;GAIG;AACH,OAAO,EACL,UAAU,EACV,UAAU,EACV,OAAO,EACP,eAAe,EACf,MAAM,EACN,eAAe,EACf,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,QAAQ,GACd,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,4BAA4B,EAC5B,KAAK,WAAW,GACjB,MAAM,eAAe,CAAA;AAEtB;;;;;;;GAOG;AACH,OAAO,EACL,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,EACd,UAAU,EACV,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA"}
|
package/dist/index.js
CHANGED
|
@@ -49,7 +49,7 @@ export { planCreateFolder, planRenameFolder, planDeleteFolder, planPlaceFile, pl
|
|
|
49
49
|
* keeps a resolver of its own.
|
|
50
50
|
*/
|
|
51
51
|
export { linkReader, linkTagsOf, linksIn, writtenOpenerOf, within, MAX_LINKS_ASKED, } from './links.js';
|
|
52
|
-
export { mentionedInFilter, mentionedInOf, readMentionedIn, MENTIONED_IN_LIMIT } from './mentions.js';
|
|
52
|
+
export { mentionedInFilter, mentionedInOf, readMentionedIn, MENTIONED_IN_LIMIT, MAX_MENTIONED_IN_LINKS_ASKED, } from './mentions.js';
|
|
53
53
|
/**
|
|
54
54
|
* RFC 0.5 §7's URL grammar — how an object is named in an address bar, and how
|
|
55
55
|
* a pasted link is matched back to one.
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,aAAa,EAIb,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,0BAA0B,EAC1B,sBAAsB,EACtB,OAAO,EAEP,cAAc,EACd,oBAAoB,EACpB,eAAe,EAEf,SAAS,EAET,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EAEjB,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,qBAAqB,EAErB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EAmBnB,cAAc,GAEf,MAAM,iBAAiB,CAAA;AAExB;;;GAGG;AACH,OAAO,EAAE,SAAS,EAA+B,MAAM,cAAc,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,oBAAoB,GAGrB,MAAM,iBAAiB,CAAA;AAExB;;;;;GAKG;AACH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,GAMd,MAAM,cAAc,CAAA;AAErB;;;;GAIG;AACH,OAAO,EACL,UAAU,EACV,UAAU,EACV,OAAO,EACP,eAAe,EACf,MAAM,EACN,eAAe,GAKhB,MAAM,YAAY,CAAA;AACnB,OAAO,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,aAAa,EAIb,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,0BAA0B,EAC1B,sBAAsB,EACtB,OAAO,EAEP,cAAc,EACd,oBAAoB,EACpB,eAAe,EAEf,SAAS,EAET,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EAEjB,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,qBAAqB,EAErB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EAmBnB,cAAc,GAEf,MAAM,iBAAiB,CAAA;AAExB;;;GAGG;AACH,OAAO,EAAE,SAAS,EAA+B,MAAM,cAAc,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,oBAAoB,GAGrB,MAAM,iBAAiB,CAAA;AAExB;;;;;GAKG;AACH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,GAMd,MAAM,cAAc,CAAA;AAErB;;;;GAIG;AACH,OAAO,EACL,UAAU,EACV,UAAU,EACV,OAAO,EACP,eAAe,EACf,MAAM,EACN,eAAe,GAKhB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,4BAA4B,GAE7B,MAAM,eAAe,CAAA;AAEtB;;;;;;;GAOG;AACH,OAAO,EACL,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,EACd,UAAU,GAGX,MAAM,gBAAgB,CAAA"}
|
package/dist/mentions.d.ts
CHANGED
|
@@ -12,6 +12,14 @@ export interface MentionedIn {
|
|
|
12
12
|
}
|
|
13
13
|
/** Enough for a list that is scanned, not read; the oldest pointers are what a cap drops. */
|
|
14
14
|
export declare const MENTIONED_IN_LIMIT = 200;
|
|
15
|
+
/**
|
|
16
|
+
* How many links one Mentioned-in read asks about in all, newest messages
|
|
17
|
+
* first. Each asked link is a relay query, and {@link MENTIONED_IN_LIMIT}
|
|
18
|
+
* candidates at {@link MAX_LINKS_ASKED} each would be 4,800 of them for one
|
|
19
|
+
* panel (PEEKM-7's review). A link left over stays unanswered, so a message
|
|
20
|
+
* pointing at the file keeps its row; a later read asks the next ones.
|
|
21
|
+
*/
|
|
22
|
+
export declare const MAX_MENTIONED_IN_LINKS_ASKED = 64;
|
|
15
23
|
/** The one filter for the candidates: every message, comment and edit pointing at the file. */
|
|
16
24
|
export declare function mentionedInFilter(address: string, limit?: number): Record<string, unknown>;
|
|
17
25
|
/**
|
package/dist/mentions.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mentions.d.ts","sourceRoot":"","sources":["../src/mentions.ts"],"names":[],"mappings":"AAkBA,OAAO,EAA0B,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClG,OAAO,
|
|
1
|
+
{"version":3,"file":"mentions.d.ts","sourceRoot":"","sources":["../src/mentions.ts"],"names":[],"mappings":"AAkBA,OAAO,EAA0B,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClG,OAAO,EAAoC,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAE9C,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,mHAAmH;IACnH,KAAK,EAAE,WAAW,CAAA;IAClB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,4FAA4F;IAC5F,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAED,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,MAAM,CAAA;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAU9C,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtG;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,YAAY,EAC1B,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,EAChC,UAAU,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAqB,GACjD,WAAW,EAAE,CA4Bf;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAO,GACtG,OAAO,CAAC,WAAW,EAAE,CAAC,CAgBxB"}
|
package/dist/mentions.js
CHANGED
|
@@ -17,9 +17,24 @@
|
|
|
17
17
|
*/
|
|
18
18
|
import { anchorsOf, editsByTarget, editTargetOf, isCommentOn, KIND_COMMENT, KIND_EDIT, KIND_MESSAGE } from '@estiva-app/conversation';
|
|
19
19
|
import { toRenderTree, valuesIn } from '@estiva-app/protocol';
|
|
20
|
-
import { linksIn, within } from './links.js';
|
|
20
|
+
import { linksIn, within, MAX_LINKS_ASKED } from './links.js';
|
|
21
21
|
/** Enough for a list that is scanned, not read; the oldest pointers are what a cap drops. */
|
|
22
22
|
export const MENTIONED_IN_LIMIT = 200;
|
|
23
|
+
/**
|
|
24
|
+
* How many links one Mentioned-in read asks about in all, newest messages
|
|
25
|
+
* first. Each asked link is a relay query, and {@link MENTIONED_IN_LIMIT}
|
|
26
|
+
* candidates at {@link MAX_LINKS_ASKED} each would be 4,800 of them for one
|
|
27
|
+
* panel (PEEKM-7's review). A link left over stays unanswered, so a message
|
|
28
|
+
* pointing at the file keeps its row; a later read asks the next ones.
|
|
29
|
+
*/
|
|
30
|
+
export const MAX_MENTIONED_IN_LINKS_ASKED = 64;
|
|
31
|
+
/**
|
|
32
|
+
* The links of a message's words that can name the file: the first
|
|
33
|
+
* {@link MAX_LINKS_ASKED}, the ones a sender asks about before it tags. A link
|
|
34
|
+
* past them earned no `a`, so it is never asked about and keeps no row: a body
|
|
35
|
+
* of hundreds of links costs a reader no more than a sender.
|
|
36
|
+
*/
|
|
37
|
+
const linksNaming = (tree) => linksIn(tree).slice(0, MAX_LINKS_ASKED);
|
|
23
38
|
/** The one filter for the candidates: every message, comment and edit pointing at the file. */
|
|
24
39
|
export function mentionedInFilter(address, limit = MENTIONED_IN_LIMIT) {
|
|
25
40
|
return { kinds: [KIND_COMMENT, KIND_MESSAGE, KIND_EDIT], '#a': [address], limit };
|
|
@@ -63,7 +78,10 @@ export function mentionedInOf(events, address, resolveLink, commentKinds, unansw
|
|
|
63
78
|
const body = edit?.content ?? event.content;
|
|
64
79
|
const tree = toRenderTree(body, 'marker');
|
|
65
80
|
const pointsNow = (edit ?? event).tags.some((t) => t[0] === 'a' && t[1] === address);
|
|
66
|
-
|
|
81
|
+
const first = linksNaming(tree);
|
|
82
|
+
const named = new Set(first);
|
|
83
|
+
const resolve = resolveLink && ((url) => (named.has(url) ? resolveLink(url) : undefined));
|
|
84
|
+
if (!valuesIn(tree, resolve).includes(file) && !(pointsNow && first.some(unanswered)))
|
|
67
85
|
continue;
|
|
68
86
|
out.push(edit ? { event, body, edit } : { event, body });
|
|
69
87
|
}
|
|
@@ -87,9 +105,10 @@ export async function readMentionedIn(query, address, options = {}) {
|
|
|
87
105
|
const links = options.links;
|
|
88
106
|
if (!links)
|
|
89
107
|
return mentionedInOf(events, address, undefined, options.commentKinds, () => true);
|
|
90
|
-
//
|
|
91
|
-
|
|
92
|
-
const
|
|
108
|
+
// The links that can name the file in each candidate's latest words: read as if each named it, so each candidate holding one is kept to ask.
|
|
109
|
+
// At most MAX_MENTIONED_IN_LINKS_ASKED, newest messages first; one left over stays unanswered, so a message pointing at the file keeps its row.
|
|
110
|
+
const urls = [...new Set(mentionedInOf(events, address, () => address, options.commentKinds).flatMap((m) => linksNaming(toRenderTree(m.body, 'marker'))))];
|
|
111
|
+
const waiting = urls.filter((url) => !links.answered(url)).slice(0, MAX_MENTIONED_IN_LINKS_ASKED);
|
|
93
112
|
if (waiting.length)
|
|
94
113
|
await within(links.ask(waiting), options.waitMs ?? 5000);
|
|
95
114
|
return mentionedInOf(events, address, links.known, options.commentKinds, (url) => !links.answered(url));
|
package/dist/mentions.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mentions.js","sourceRoot":"","sources":["../src/mentions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACrI,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAuC,MAAM,sBAAsB,CAAA;AAClG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAmB,MAAM,YAAY,CAAA;
|
|
1
|
+
{"version":3,"file":"mentions.js","sourceRoot":"","sources":["../src/mentions.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@estiva-app/interop",
|
|
3
|
-
"version": "0.69.
|
|
3
|
+
"version": "0.69.1",
|
|
4
4
|
"description": "Render and act on another app's objects from its published NIP-89 manifest. The owner defines the projection; the consumer decides how it looks.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
package/src/index.ts
CHANGED
|
@@ -164,7 +164,14 @@ export {
|
|
|
164
164
|
type LinkReaderOptions,
|
|
165
165
|
type OwnPlace,
|
|
166
166
|
} from './links.js'
|
|
167
|
-
export {
|
|
167
|
+
export {
|
|
168
|
+
mentionedInFilter,
|
|
169
|
+
mentionedInOf,
|
|
170
|
+
readMentionedIn,
|
|
171
|
+
MENTIONED_IN_LIMIT,
|
|
172
|
+
MAX_MENTIONED_IN_LINKS_ASKED,
|
|
173
|
+
type MentionedIn,
|
|
174
|
+
} from './mentions.js'
|
|
168
175
|
|
|
169
176
|
/**
|
|
170
177
|
* RFC 0.5 §7's URL grammar — how an object is named in an address bar, and how
|
package/src/mentions.ts
CHANGED
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
*/
|
|
18
18
|
import { anchorsOf, editsByTarget, editTargetOf, isCommentOn, KIND_COMMENT, KIND_EDIT, KIND_MESSAGE } from '@estiva-app/conversation'
|
|
19
19
|
import { toRenderTree, valuesIn, type LinkResolver, type SignedEvent } from '@estiva-app/protocol'
|
|
20
|
-
import { linksIn, within, type LinkReader } from './links.js'
|
|
20
|
+
import { linksIn, within, MAX_LINKS_ASKED, type LinkReader } from './links.js'
|
|
21
21
|
import type { QueryFn } from './projection.js'
|
|
22
22
|
|
|
23
23
|
/** One message that mentions the file, as its latest words say. */
|
|
@@ -33,6 +33,23 @@ export interface MentionedIn {
|
|
|
33
33
|
/** Enough for a list that is scanned, not read; the oldest pointers are what a cap drops. */
|
|
34
34
|
export const MENTIONED_IN_LIMIT = 200
|
|
35
35
|
|
|
36
|
+
/**
|
|
37
|
+
* How many links one Mentioned-in read asks about in all, newest messages
|
|
38
|
+
* first. Each asked link is a relay query, and {@link MENTIONED_IN_LIMIT}
|
|
39
|
+
* candidates at {@link MAX_LINKS_ASKED} each would be 4,800 of them for one
|
|
40
|
+
* panel (PEEKM-7's review). A link left over stays unanswered, so a message
|
|
41
|
+
* pointing at the file keeps its row; a later read asks the next ones.
|
|
42
|
+
*/
|
|
43
|
+
export const MAX_MENTIONED_IN_LINKS_ASKED = 64
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* The links of a message's words that can name the file: the first
|
|
47
|
+
* {@link MAX_LINKS_ASKED}, the ones a sender asks about before it tags. A link
|
|
48
|
+
* past them earned no `a`, so it is never asked about and keeps no row: a body
|
|
49
|
+
* of hundreds of links costs a reader no more than a sender.
|
|
50
|
+
*/
|
|
51
|
+
const linksNaming = (tree: ReturnType<typeof toRenderTree>) => linksIn(tree).slice(0, MAX_LINKS_ASKED)
|
|
52
|
+
|
|
36
53
|
/** The one filter for the candidates: every message, comment and edit pointing at the file. */
|
|
37
54
|
export function mentionedInFilter(address: string, limit = MENTIONED_IN_LIMIT): Record<string, unknown> {
|
|
38
55
|
return { kinds: [KIND_COMMENT, KIND_MESSAGE, KIND_EDIT], '#a': [address], limit }
|
|
@@ -78,7 +95,10 @@ export function mentionedInOf(
|
|
|
78
95
|
const body = edit?.content ?? event.content
|
|
79
96
|
const tree = toRenderTree(body, 'marker')
|
|
80
97
|
const pointsNow = (edit ?? event).tags.some((t) => t[0] === 'a' && t[1] === address)
|
|
81
|
-
|
|
98
|
+
const first = linksNaming(tree)
|
|
99
|
+
const named = new Set(first)
|
|
100
|
+
const resolve: LinkResolver | undefined = resolveLink && ((url) => (named.has(url) ? resolveLink(url) : undefined))
|
|
101
|
+
if (!valuesIn(tree, resolve).includes(file) && !(pointsNow && first.some(unanswered))) continue
|
|
82
102
|
out.push(edit ? { event, body, edit } : { event, body })
|
|
83
103
|
}
|
|
84
104
|
return out.sort((a, b) => b.event.created_at - a.event.created_at)
|
|
@@ -105,9 +125,10 @@ export async function readMentionedIn(
|
|
|
105
125
|
const events = [...candidates, ...targets, ...edits]
|
|
106
126
|
const links = options.links
|
|
107
127
|
if (!links) return mentionedInOf(events, address, undefined, options.commentKinds, () => true)
|
|
108
|
-
//
|
|
109
|
-
|
|
110
|
-
const
|
|
128
|
+
// The links that can name the file in each candidate's latest words: read as if each named it, so each candidate holding one is kept to ask.
|
|
129
|
+
// At most MAX_MENTIONED_IN_LINKS_ASKED, newest messages first; one left over stays unanswered, so a message pointing at the file keeps its row.
|
|
130
|
+
const urls = [...new Set(mentionedInOf(events, address, () => address, options.commentKinds).flatMap((m) => linksNaming(toRenderTree(m.body, 'marker'))))]
|
|
131
|
+
const waiting = urls.filter((url) => !links.answered(url)).slice(0, MAX_MENTIONED_IN_LINKS_ASKED)
|
|
111
132
|
if (waiting.length) await within(links.ask(waiting), options.waitMs ?? 5000)
|
|
112
133
|
return mentionedInOf(events, address, links.known, options.commentKinds, (url) => !links.answered(url))
|
|
113
134
|
}
|