@jackwener/opencli 1.7.12 → 1.7.14

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.
Files changed (419) hide show
  1. package/README.md +8 -7
  2. package/README.zh-CN.md +9 -8
  3. package/cli-manifest.json +12128 -6665
  4. package/clis/1point3acres/digest.js +35 -0
  5. package/clis/1point3acres/forum.js +51 -0
  6. package/clis/1point3acres/forums.js +44 -0
  7. package/clis/1point3acres/hot.js +35 -0
  8. package/clis/1point3acres/latest.js +35 -0
  9. package/clis/1point3acres/notifications.js +64 -0
  10. package/clis/1point3acres/search.js +71 -0
  11. package/clis/1point3acres/thread.js +117 -0
  12. package/clis/1point3acres/user.js +77 -0
  13. package/clis/1point3acres/utils.js +247 -0
  14. package/clis/_shared/desktop-commands.js +4 -0
  15. package/clis/aibase/news.js +110 -0
  16. package/clis/aibase/news.test.js +59 -0
  17. package/clis/amazon/discussion.test.js +1 -28
  18. package/clis/antigravity/watch.js +3 -2
  19. package/clis/arxiv/author.js +44 -0
  20. package/clis/baidu-scholar/search.js +0 -1
  21. package/clis/bbc/topic.js +57 -0
  22. package/clis/bbc/utils.js +79 -0
  23. package/clis/chaoxing/assignments.js +1 -1
  24. package/clis/chaoxing/exams.js +1 -1
  25. package/clis/chatgpt/ask.js +57 -0
  26. package/clis/chatgpt/commands.test.js +45 -0
  27. package/clis/chatgpt/detail.js +46 -0
  28. package/clis/chatgpt/history.js +39 -0
  29. package/clis/chatgpt/image.js +12 -11
  30. package/clis/chatgpt/image.test.js +23 -0
  31. package/clis/chatgpt/new.js +25 -0
  32. package/clis/chatgpt/read.js +43 -0
  33. package/clis/chatgpt/send.js +46 -0
  34. package/clis/chatgpt/status.js +29 -0
  35. package/clis/chatgpt/utils.js +294 -4
  36. package/clis/chatgpt/utils.test.js +13 -0
  37. package/clis/chatgpt-app/ask.js +6 -3
  38. package/clis/chatwise/ask.js +16 -43
  39. package/clis/chatwise/composer.test.js +186 -0
  40. package/clis/chatwise/send.js +2 -24
  41. package/clis/chatwise/utils.js +143 -0
  42. package/clis/claude/ask.js +1 -1
  43. package/clis/claude/detail.js +1 -0
  44. package/clis/claude/history.js +1 -0
  45. package/clis/claude/new.js +1 -0
  46. package/clis/claude/read.js +1 -0
  47. package/clis/claude/send.js +1 -0
  48. package/clis/claude/status.js +1 -0
  49. package/clis/codex/ask.js +15 -9
  50. package/clis/codex/history.js +16 -33
  51. package/clis/codex/projects.js +28 -0
  52. package/clis/codex/read.js +10 -4
  53. package/clis/codex/send.js +10 -3
  54. package/clis/codex/sidebar.js +356 -0
  55. package/clis/codex/sidebar.test.js +329 -0
  56. package/clis/coingecko/categories.js +75 -0
  57. package/clis/coingecko/coin.js +107 -0
  58. package/clis/coingecko/coingecko.test.js +109 -0
  59. package/clis/coingecko/derivatives.js +84 -0
  60. package/clis/coingecko/exchanges.js +74 -0
  61. package/clis/coingecko/global.js +71 -0
  62. package/clis/coingecko/top.js +64 -0
  63. package/clis/coingecko/trending.js +55 -0
  64. package/clis/coupang/add-to-cart.js +21 -13
  65. package/clis/coupang/coupang.test.js +159 -0
  66. package/clis/coupang/product.js +257 -0
  67. package/clis/coupang/search.js +38 -16
  68. package/clis/coupang/utils.js +55 -1
  69. package/clis/crates/crate.js +62 -0
  70. package/clis/crates/search.js +44 -0
  71. package/clis/crates/utils.js +72 -0
  72. package/clis/ctrip/ctrip.test.js +234 -0
  73. package/clis/ctrip/hotel-suggest.js +45 -0
  74. package/clis/ctrip/search.js +22 -68
  75. package/clis/ctrip/utils.js +175 -0
  76. package/clis/cursor/ask.js +6 -3
  77. package/clis/dblp/author.js +133 -0
  78. package/clis/dblp/venue.js +64 -0
  79. package/clis/deepseek/ask.js +12 -7
  80. package/clis/deepseek/ask.test.js +13 -13
  81. package/clis/deepseek/detail.js +38 -0
  82. package/clis/deepseek/detail.test.js +81 -0
  83. package/clis/deepseek/history.js +1 -0
  84. package/clis/deepseek/new.js +1 -0
  85. package/clis/deepseek/read.js +1 -0
  86. package/clis/deepseek/send.js +140 -0
  87. package/clis/deepseek/send.test.js +107 -0
  88. package/clis/deepseek/status.js +1 -0
  89. package/clis/deepseek/utils.js +66 -0
  90. package/clis/deepseek/utils.test.js +107 -1
  91. package/clis/defillama/defillama.test.js +99 -0
  92. package/clis/defillama/protocol.js +84 -0
  93. package/clis/defillama/protocols.js +55 -0
  94. package/clis/defillama/utils.js +99 -0
  95. package/clis/devto/latest.js +74 -0
  96. package/clis/dockerhub/image.js +52 -0
  97. package/clis/dockerhub/search.js +47 -0
  98. package/clis/dockerhub/utils.js +100 -0
  99. package/clis/doubao/ask.js +7 -3
  100. package/clis/doubao/detail.js +1 -0
  101. package/clis/doubao/history.js +1 -0
  102. package/clis/doubao/meeting-summary.js +1 -0
  103. package/clis/doubao/meeting-transcript.js +1 -0
  104. package/clis/doubao/new.js +1 -0
  105. package/clis/doubao/read.js +1 -0
  106. package/clis/doubao/send.js +1 -0
  107. package/clis/doubao/status.js +1 -0
  108. package/clis/douyin/draft.test.js +1 -30
  109. package/clis/endoflife/endoflife.test.js +51 -0
  110. package/clis/endoflife/product.js +55 -0
  111. package/clis/endoflife/utils.js +89 -0
  112. package/clis/facebook/__fixtures__/notifications-page.html +13 -0
  113. package/clis/facebook/notifications.js +326 -30
  114. package/clis/facebook/notifications.test.js +458 -0
  115. package/clis/flathub/app.js +71 -0
  116. package/clis/flathub/flathub.test.js +90 -0
  117. package/clis/flathub/search.js +80 -0
  118. package/clis/flathub/utils.js +114 -0
  119. package/clis/gemini/ask.js +7 -3
  120. package/clis/gemini/ask.test.js +2 -2
  121. package/clis/gemini/deep-research-result.js +6 -2
  122. package/clis/gemini/deep-research-result.test.js +15 -14
  123. package/clis/gemini/deep-research.js +8 -4
  124. package/clis/gemini/deep-research.test.js +15 -18
  125. package/clis/gemini/image.js +7 -2
  126. package/clis/gemini/new.js +1 -0
  127. package/clis/gemini/utils.js +0 -4
  128. package/clis/google-scholar/cite.js +0 -1
  129. package/clis/google-scholar/profile.js +0 -1
  130. package/clis/google-scholar/search.js +0 -1
  131. package/clis/goproxy/goproxy.test.js +103 -0
  132. package/clis/goproxy/module.js +47 -0
  133. package/clis/goproxy/utils.js +165 -0
  134. package/clis/goproxy/versions.js +59 -0
  135. package/clis/gov-law/recent.js +0 -1
  136. package/clis/gov-law/search.js +0 -1
  137. package/clis/gov-policy/__fixtures__/recent.html +16 -0
  138. package/clis/gov-policy/__fixtures__/search.html +41 -0
  139. package/clis/gov-policy/gov-policy.test.js +224 -0
  140. package/clis/gov-policy/recent.js +66 -24
  141. package/clis/gov-policy/search.js +65 -23
  142. package/clis/gov-policy/utils.js +54 -0
  143. package/clis/grok/ask.js +49 -265
  144. package/clis/grok/ask.test.js +21 -46
  145. package/clis/grok/detail.js +60 -0
  146. package/clis/grok/history.js +48 -0
  147. package/clis/grok/{image.ts → image.js} +56 -70
  148. package/clis/grok/image.test.ts +20 -0
  149. package/clis/grok/new.js +20 -0
  150. package/clis/grok/read.js +39 -0
  151. package/clis/grok/send.js +50 -0
  152. package/clis/grok/status.js +41 -0
  153. package/clis/grok/utils.js +326 -0
  154. package/clis/grok/utils.test.js +103 -0
  155. package/clis/hf/datasets.js +88 -0
  156. package/clis/hf/hf.test.js +16 -0
  157. package/clis/hf/models.js +91 -0
  158. package/clis/hf/paper.js +79 -0
  159. package/clis/hf/spaces.js +101 -0
  160. package/clis/hf/top.js +1 -0
  161. package/clis/homebrew/cask.js +39 -0
  162. package/clis/homebrew/formula.js +41 -0
  163. package/clis/homebrew/popular.js +54 -0
  164. package/clis/homebrew/utils.js +100 -0
  165. package/clis/hupu/__fixtures__/hot-home.html +64 -0
  166. package/clis/hupu/detail.js +0 -1
  167. package/clis/hupu/hot.js +156 -35
  168. package/clis/hupu/hot.test.js +224 -0
  169. package/clis/hupu/search.js +0 -1
  170. package/clis/instagram/note.js +1 -1
  171. package/clis/instagram/note.test.js +1 -29
  172. package/clis/instagram/post.js +1 -1
  173. package/clis/instagram/post.test.js +1 -1
  174. package/clis/instagram/reel.js +1 -1
  175. package/clis/instagram/story.js +1 -1
  176. package/clis/instagram/story.test.js +1 -34
  177. package/clis/jd/commands.test.js +1 -24
  178. package/clis/lichess/lichess.test.js +85 -0
  179. package/clis/lichess/top.js +46 -0
  180. package/clis/lichess/user.js +91 -0
  181. package/clis/lichess/utils.js +97 -0
  182. package/clis/linkedin/search.js +107 -10
  183. package/clis/linkedin/search.test.js +222 -0
  184. package/clis/linux-do/feed.js +2 -5
  185. package/clis/linux-do/feed.test.js +35 -0
  186. package/clis/lobsters/domain.js +92 -0
  187. package/clis/maven/artifact.js +49 -0
  188. package/clis/maven/search.js +51 -0
  189. package/clis/maven/utils.js +110 -0
  190. package/clis/mdn/search.js +97 -0
  191. package/clis/medium/tag.js +135 -0
  192. package/clis/npm/downloads.js +59 -0
  193. package/clis/npm/package.js +70 -0
  194. package/clis/npm/search.js +49 -0
  195. package/clis/npm/utils.js +76 -0
  196. package/clis/nuget/nuget.test.js +111 -0
  197. package/clis/nuget/package.js +101 -0
  198. package/clis/nuget/search.js +69 -0
  199. package/clis/nuget/utils.js +87 -0
  200. package/clis/nvd/cve.js +121 -0
  201. package/clis/oeis/oeis.test.js +88 -0
  202. package/clis/oeis/search.js +63 -0
  203. package/clis/oeis/sequence.js +71 -0
  204. package/clis/oeis/utils.js +88 -0
  205. package/clis/openalex/search.js +69 -0
  206. package/clis/openalex/utils.js +160 -0
  207. package/clis/openalex/work.js +65 -0
  208. package/clis/openfda/drug-label.js +74 -0
  209. package/clis/openfda/food-recall.js +65 -0
  210. package/clis/openfda/openfda.test.js +114 -0
  211. package/clis/openfda/utils.js +67 -0
  212. package/clis/osv/osv.test.js +97 -0
  213. package/clis/osv/query.js +72 -0
  214. package/clis/osv/utils.js +169 -0
  215. package/clis/osv/vulnerability.js +54 -0
  216. package/clis/packagist/package.js +49 -0
  217. package/clis/packagist/search.js +43 -0
  218. package/clis/packagist/utils.js +113 -0
  219. package/clis/paperreview/feedback.js +1 -1
  220. package/clis/paperreview/review.js +1 -1
  221. package/clis/paperreview/submit.js +1 -1
  222. package/clis/pixiv/download.test.js +1 -1
  223. package/clis/pixiv/illusts.test.js +1 -1
  224. package/clis/pixiv/search.test.js +1 -1
  225. package/clis/pubmed/article.js +50 -0
  226. package/clis/pubmed/author.js +64 -0
  227. package/clis/pubmed/citations.js +36 -0
  228. package/clis/pubmed/pubmed.test.js +276 -0
  229. package/clis/pubmed/related.js +45 -0
  230. package/clis/pubmed/search.js +75 -0
  231. package/clis/pubmed/utils.js +309 -0
  232. package/clis/pypi/downloads.js +66 -0
  233. package/clis/pypi/package.js +79 -0
  234. package/clis/pypi/utils.js +55 -0
  235. package/clis/quark/mv.js +1 -1
  236. package/clis/quark/save.js +1 -1
  237. package/clis/qwen/ask.js +85 -0
  238. package/clis/qwen/detail.js +62 -0
  239. package/clis/qwen/history.js +61 -0
  240. package/clis/qwen/image.js +179 -0
  241. package/clis/qwen/new.js +23 -0
  242. package/clis/qwen/read.js +41 -0
  243. package/clis/qwen/send.js +55 -0
  244. package/clis/qwen/status.js +37 -0
  245. package/clis/qwen/utils.js +409 -0
  246. package/clis/qwen/utils.test.js +45 -0
  247. package/clis/rest-countries/country.js +65 -0
  248. package/clis/rest-countries/region.js +64 -0
  249. package/clis/rest-countries/rest-countries.test.js +83 -0
  250. package/clis/rest-countries/utils.js +126 -0
  251. package/clis/reuters/article-detail.js +53 -0
  252. package/clis/reuters/reuters.test.js +299 -0
  253. package/clis/reuters/search.js +45 -34
  254. package/clis/reuters/utils.js +159 -0
  255. package/clis/rfc/rfc.js +52 -0
  256. package/clis/rfc/rfc.test.js +74 -0
  257. package/clis/rfc/utils.js +72 -0
  258. package/clis/rubygems/gem.js +42 -0
  259. package/clis/rubygems/search.js +47 -0
  260. package/clis/rubygems/utils.js +86 -0
  261. package/clis/stackoverflow/related.js +66 -0
  262. package/clis/stackoverflow/stackoverflow.test.js +58 -0
  263. package/clis/stackoverflow/tag.js +60 -0
  264. package/clis/stackoverflow/user.js +50 -0
  265. package/clis/stackoverflow/utils.js +118 -0
  266. package/clis/steam/app.js +67 -0
  267. package/clis/steam/search.js +58 -0
  268. package/clis/steam/steam.test.js +46 -0
  269. package/clis/steam/utils.js +107 -0
  270. package/clis/taobao/commands.test.js +1 -24
  271. package/clis/test-utils.js +61 -0
  272. package/clis/tieba/hot.js +0 -1
  273. package/clis/tiktok/comment.js +128 -41
  274. package/clis/tiktok/creator-videos.js +270 -0
  275. package/clis/tiktok/creator-videos.test.js +113 -0
  276. package/clis/tiktok/explore.js +137 -29
  277. package/clis/tiktok/follow.js +115 -33
  278. package/clis/tiktok/following.js +157 -36
  279. package/clis/tiktok/friends.js +139 -37
  280. package/clis/tiktok/live.js +137 -41
  281. package/clis/tiktok/notifications.js +141 -38
  282. package/clis/tiktok/refactor.test.js +389 -0
  283. package/clis/tiktok/unfollow.js +124 -38
  284. package/clis/tiktok/user.js +203 -29
  285. package/clis/tiktok/utils.js +505 -0
  286. package/clis/tiktok/write-refactor.test.js +370 -0
  287. package/clis/toutiao/articles.js +36 -62
  288. package/clis/toutiao/hot.js +63 -0
  289. package/clis/toutiao/toutiao.test.js +378 -0
  290. package/clis/toutiao/utils.js +161 -0
  291. package/clis/tvmaze/search.js +61 -0
  292. package/clis/tvmaze/show.js +60 -0
  293. package/clis/tvmaze/tvmaze.test.js +93 -0
  294. package/clis/tvmaze/utils.js +110 -0
  295. package/clis/twitter/accept.js +1 -1
  296. package/clis/twitter/followers.js +134 -69
  297. package/clis/twitter/quote.js +139 -0
  298. package/clis/twitter/quote.test.js +106 -0
  299. package/clis/twitter/reply-dm.js +1 -1
  300. package/clis/twitter/reply.test.js +1 -29
  301. package/clis/twitter/retweet.js +99 -0
  302. package/clis/twitter/retweet.test.js +69 -0
  303. package/clis/twitter/shared.js +38 -0
  304. package/clis/twitter/shared.test.js +28 -1
  305. package/clis/twitter/unlike.js +87 -0
  306. package/clis/twitter/unlike.test.js +72 -0
  307. package/clis/twitter/unretweet.js +99 -0
  308. package/clis/twitter/unretweet.test.js +69 -0
  309. package/clis/uisdc/news.js +105 -0
  310. package/clis/uisdc/news.test.js +66 -0
  311. package/clis/wanfang/search.js +0 -1
  312. package/clis/web/read.js +47 -17
  313. package/clis/web/read.test.js +101 -1
  314. package/clis/weixin/create-draft.js +1 -1
  315. package/clis/weixin/drafts.js +1 -1
  316. package/clis/weixin/drafts.test.js +5 -1
  317. package/clis/weixin/search.js +157 -0
  318. package/clis/weixin/search.test.js +227 -0
  319. package/clis/wikidata/entity.js +60 -0
  320. package/clis/wikidata/search.js +50 -0
  321. package/clis/wikidata/utils.js +117 -0
  322. package/clis/wikidata/wikidata.test.js +83 -0
  323. package/clis/wikipedia/page.js +95 -0
  324. package/clis/wttr/current.js +63 -0
  325. package/clis/wttr/forecast.js +71 -0
  326. package/clis/wttr/utils.js +50 -0
  327. package/clis/wttr/wttr.test.js +84 -0
  328. package/clis/xianyu/chat.js +16 -4
  329. package/clis/xianyu/chat.test.js +64 -0
  330. package/clis/xianyu/publish.js +485 -0
  331. package/clis/xianyu/publish.test.js +220 -0
  332. package/clis/xiaoe/catalog.js +105 -40
  333. package/clis/xiaoe/content.js +164 -29
  334. package/clis/xiaoe/courses.js +86 -29
  335. package/clis/xiaoe/xiaoe.test.js +486 -0
  336. package/clis/xiaohongshu/creator-notes-summary.js +1 -1
  337. package/clis/xiaohongshu/publish.js +16 -3
  338. package/clis/xiaohongshu/publish.test.js +46 -1
  339. package/clis/youtube/transcript.js +13 -19
  340. package/clis/youtube/transcript.test.js +17 -0
  341. package/clis/yuanbao/ask.js +17 -66
  342. package/clis/yuanbao/ask.test.js +5 -5
  343. package/clis/yuanbao/detail.js +65 -0
  344. package/clis/yuanbao/history.js +51 -0
  345. package/clis/yuanbao/new.js +1 -0
  346. package/clis/yuanbao/read.js +38 -0
  347. package/clis/yuanbao/send.js +57 -0
  348. package/clis/yuanbao/shared.js +297 -5
  349. package/clis/yuanbao/shared.test.js +80 -0
  350. package/clis/yuanbao/status.js +44 -0
  351. package/clis/zlibrary/commands.test.js +1 -11
  352. package/dist/src/browser/base-page.d.ts +9 -0
  353. package/dist/src/browser/base-page.js +44 -1
  354. package/dist/src/browser/base-page.test.js +66 -0
  355. package/dist/src/browser/bridge.js +47 -45
  356. package/dist/src/browser/cdp.d.ts +1 -0
  357. package/dist/src/browser/cdp.js +51 -9
  358. package/dist/src/browser/daemon-client.d.ts +4 -0
  359. package/dist/src/browser/errors.js +1 -1
  360. package/dist/src/browser/page.d.ts +1 -1
  361. package/dist/src/browser/page.js +3 -1
  362. package/dist/src/browser/page.test.js +29 -0
  363. package/dist/src/browser/target-errors.d.ts +2 -1
  364. package/dist/src/browser/target-errors.js +1 -0
  365. package/dist/src/browser/target-resolver.d.ts +25 -0
  366. package/dist/src/browser/target-resolver.js +43 -0
  367. package/dist/src/browser.test.js +18 -0
  368. package/dist/src/build-manifest.js +9 -4
  369. package/dist/src/build-manifest.test.js +2 -8
  370. package/dist/src/capabilityRouting.d.ts +16 -1
  371. package/dist/src/capabilityRouting.js +24 -1
  372. package/dist/src/capabilityRouting.test.js +19 -1
  373. package/dist/src/cli.js +76 -11
  374. package/dist/src/cli.test.js +241 -1
  375. package/dist/src/commanderAdapter.js +23 -9
  376. package/dist/src/commanderAdapter.test.js +0 -1
  377. package/dist/src/discovery.js +2 -5
  378. package/dist/src/errors.js +1 -1
  379. package/dist/src/execution.d.ts +1 -1
  380. package/dist/src/execution.js +111 -27
  381. package/dist/src/execution.test.js +326 -17
  382. package/dist/src/help.d.ts +27 -2
  383. package/dist/src/help.js +196 -23
  384. package/dist/src/help.test.d.ts +1 -0
  385. package/dist/src/help.test.js +54 -0
  386. package/dist/src/main.js +14 -1
  387. package/dist/src/manifest-types.d.ts +5 -3
  388. package/dist/src/pipeline/executor.js +1 -1
  389. package/dist/src/pipeline/executor.test.js +8 -0
  390. package/dist/src/pipeline/registry.d.ts +9 -0
  391. package/dist/src/pipeline/registry.js +13 -1
  392. package/dist/src/pipeline/steps/browser.d.ts +1 -0
  393. package/dist/src/pipeline/steps/browser.js +10 -0
  394. package/dist/src/pipeline/steps/download.test.js +1 -0
  395. package/dist/src/registry-api.d.ts +1 -1
  396. package/dist/src/registry.d.ts +12 -11
  397. package/dist/src/registry.js +16 -6
  398. package/dist/src/registry.test.js +2 -2
  399. package/dist/src/runtime.d.ts +2 -1
  400. package/dist/src/runtime.js +1 -1
  401. package/dist/src/serialization.d.ts +2 -2
  402. package/dist/src/serialization.js +4 -6
  403. package/dist/src/serialization.test.js +17 -0
  404. package/dist/src/types.d.ts +17 -0
  405. package/dist/src/validate.js +15 -11
  406. package/dist/src/validate.test.d.ts +9 -0
  407. package/dist/src/validate.test.js +90 -0
  408. package/package.json +1 -1
  409. package/scripts/fetch-adapters.js +1 -1
  410. package/scripts/typed-error-lint-baseline.json +5 -77
  411. package/clis/ctrip/search.test.js +0 -64
  412. package/clis/gov-policy/commands.test.js +0 -27
  413. package/clis/linux-do/category.js +0 -37
  414. package/clis/linux-do/hot.js +0 -26
  415. package/clis/linux-do/latest.js +0 -19
  416. package/clis/pixiv/test-utils.js +0 -23
  417. package/clis/toutiao/articles.test.js +0 -30
  418. package/dist/src/analysis.d.ts +0 -40
  419. package/dist/src/analysis.js +0 -172
package/clis/facebook/notifications.test.js ADDED
@@ -0,0 +1,458 @@
1
+ // Facebook notifications — unit tests for pure helpers + JSDOM fixture
2
+ // test for the `extractNotificationRowsFromDoc` extractor.
3
+ //
4
+ // The fixture (`__fixtures__/notifications-page.html`) is a frozen
5
+ // snapshot of `www.facebook.com/notifications` captured live from a
6
+ // logged-in session. Class names are stripped; SVG / `<i>` icon nodes
7
+ // are removed. The structure preserves what the extractor needs:
8
+ // - 5 `[role="listitem"]` rows: 1 header ("新通知" — no anchor) +
9
+ // 4 real notifications across 3 distinct `notif_t` types
10
+ // (`onthisday`, `approve_from_another_device`,
11
+ // `group_recommendation`).
12
+ // - Each data row has `<a href>` with `notif_id` + `notif_t` query
13
+ // params, `<div>未读</div>` unread badge, `<abbr aria-label="N天前">
14
+ // <span>N天</span></abbr>` for time, and a `<div role="button"
15
+ // aria-label="标记为已读，<body>">` for the bare body text.
16
+ //
17
+ // Per dianping #1313 / hupu #1387 / xiaoe #1388 pattern: the live IIFE
18
+ // embeds the same `extractNotificationRowsFromDoc` function via
19
+ // `${fn.toString()}` so the extractor seen by these JSDOM tests is the
20
+ // exact same code that runs in the browser.
21
+
22
+ import { describe, it, expect, vi } from 'vitest';
23
+ import { JSDOM } from 'jsdom';
24
+ import { readFileSync } from 'node:fs';
25
+ import { fileURLToPath } from 'node:url';
26
+ import { dirname, resolve } from 'node:path';
27
+ import {
28
+ ArgumentError,
29
+ AuthRequiredError,
30
+ CommandExecutionError,
31
+ EmptyResultError,
32
+ } from '@jackwener/opencli/errors';
33
+
34
+ import {
35
+ FB_HOST,
36
+ NOTIFICATIONS_LIMIT_DEFAULT,
37
+ NOTIFICATIONS_LIMIT_MAX,
38
+ MARK_AS_READ_PREFIXES,
39
+ UNREAD_BADGE_LABELS,
40
+ normalizeNotificationsLimit,
41
+ stripMarkAsReadPrefix,
42
+ stripAnchorChrome,
43
+ parseNotifQuery,
44
+ isFacebookAuthRedirectPath,
45
+ extractNotificationRowsFromDoc,
46
+ buildNotificationsScript,
47
+ notificationsCommand,
48
+ } from './notifications.js';
49
+
50
+ const __filename = fileURLToPath(import.meta.url);
51
+ const __dirname = dirname(__filename);
52
+ const fixturePath = resolve(__dirname, '__fixtures__/notifications-page.html');
53
+ const fixtureHtml = readFileSync(fixturePath, 'utf8');
54
+ const manifestPath = resolve(__dirname, '../../cli-manifest.json');
55
+
56
+ function loadFixtureDoc() {
57
+ return new JSDOM(fixtureHtml, { url: 'https://www.facebook.com/notifications' }).window.document;
58
+ }
59
+
60
+ function loadManifestCommand() {
61
+ const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
62
+ return manifest.find(cmd => cmd.site === 'facebook' && cmd.name === 'notifications');
63
+ }
64
+
65
+ const fixtureHelpers = {
66
+ stripMark: stripMarkAsReadPrefix,
67
+ stripChrome: stripAnchorChrome,
68
+ parseQuery: parseNotifQuery,
69
+ fbHost: FB_HOST,
70
+ markPrefixes: MARK_AS_READ_PREFIXES,
71
+ unreadBadges: UNREAD_BADGE_LABELS,
72
+ };
73
+
74
+ describe('facebook/notifications — registration contract', () => {
75
+ it('declares site/name/access/strategy/browser correctly', () => {
76
+ expect(notificationsCommand.site).toBe('facebook');
77
+ expect(notificationsCommand.name).toBe('notifications');
78
+ expect(notificationsCommand.access).toBe('read');
79
+ expect(notificationsCommand.strategy).toBe('cookie');
80
+ expect(notificationsCommand.browser).toBe(true);
81
+ expect(notificationsCommand.navigateBefore).toBe(false);
82
+ });
83
+
84
+ it('exposes the seven enrichment columns in stable order', () => {
85
+ expect(notificationsCommand.columns).toEqual([
86
+ 'index',
87
+ 'unread',
88
+ 'text',
89
+ 'time',
90
+ 'url',
91
+ 'notif_id',
92
+ 'notif_type',
93
+ ]);
94
+ });
95
+
96
+ it('declares limit arg with default and help string', () => {
97
+ const limit = notificationsCommand.args.find(a => a.name === 'limit');
98
+ expect(limit).toBeDefined();
99
+ expect(limit.type).toBe('int');
100
+ expect(limit.default).toBe(NOTIFICATIONS_LIMIT_DEFAULT);
101
+ expect(limit.help).toContain(String(NOTIFICATIONS_LIMIT_MAX));
102
+ });
103
+
104
+ it('build manifest preserves navigateBefore=false so invalid limits do not pre-nav', () => {
105
+ const manifestCommand = loadManifestCommand();
106
+ expect(manifestCommand).toBeDefined();
107
+ expect(manifestCommand.navigateBefore).toBe(false);
108
+ });
109
+ });
110
+
111
+ describe('normalizeNotificationsLimit', () => {
112
+ it('returns default for undefined / null / empty', () => {
113
+ expect(normalizeNotificationsLimit(undefined)).toBe(NOTIFICATIONS_LIMIT_DEFAULT);
114
+ expect(normalizeNotificationsLimit(null)).toBe(NOTIFICATIONS_LIMIT_DEFAULT);
115
+ expect(normalizeNotificationsLimit('')).toBe(NOTIFICATIONS_LIMIT_DEFAULT);
116
+ });
117
+
118
+ it('accepts positive integer in range', () => {
119
+ expect(normalizeNotificationsLimit(1)).toBe(1);
120
+ expect(normalizeNotificationsLimit(50)).toBe(50);
121
+ expect(normalizeNotificationsLimit(NOTIFICATIONS_LIMIT_MAX)).toBe(NOTIFICATIONS_LIMIT_MAX);
122
+ expect(normalizeNotificationsLimit('25')).toBe(25);
123
+ });
124
+
125
+ it('rejects 0 / negative / over-max / non-integer / non-numeric — never silent clamps', () => {
126
+ expect(() => normalizeNotificationsLimit(0)).toThrow(/positive integer/);
127
+ expect(() => normalizeNotificationsLimit(-1)).toThrow(/positive integer/);
128
+ expect(() => normalizeNotificationsLimit(NOTIFICATIONS_LIMIT_MAX + 1)).toThrow(
129
+ new RegExp(`\\[1, ${NOTIFICATIONS_LIMIT_MAX}\\]`),
130
+ );
131
+ expect(() => normalizeNotificationsLimit(1.5)).toThrow(/positive integer/);
132
+ expect(() => normalizeNotificationsLimit('abc')).toThrow(/positive integer/);
133
+ });
134
+ });
135
+
136
+ describe('stripMarkAsReadPrefix', () => {
137
+ it('strips known locale prefixes', () => {
138
+ expect(stripMarkAsReadPrefix('标记为已读，回顾你在 2019年6月的那段过往.', MARK_AS_READ_PREFIXES))
139
+ .toBe('回顾你在 2019年6月的那段过往.');
140
+ expect(stripMarkAsReadPrefix('Mark as read, John liked your photo', MARK_AS_READ_PREFIXES))
141
+ .toBe('John liked your photo');
142
+ expect(stripMarkAsReadPrefix('Mark as Read, John liked your photo', MARK_AS_READ_PREFIXES))
143
+ .toBe('John liked your photo');
144
+ });
145
+
146
+ it('returns null when prefix is missing — never silent default', () => {
147
+ expect(stripMarkAsReadPrefix('管理Jake Win通知设置', MARK_AS_READ_PREFIXES)).toBeNull();
148
+ expect(stripMarkAsReadPrefix('arbitrary aria-label without prefix', MARK_AS_READ_PREFIXES))
149
+ .toBeNull();
150
+ });
151
+
152
+ it('returns null on missing / empty input', () => {
153
+ expect(stripMarkAsReadPrefix(null, MARK_AS_READ_PREFIXES)).toBeNull();
154
+ expect(stripMarkAsReadPrefix(undefined, MARK_AS_READ_PREFIXES)).toBeNull();
155
+ expect(stripMarkAsReadPrefix('', MARK_AS_READ_PREFIXES)).toBeNull();
156
+ expect(stripMarkAsReadPrefix(' ', MARK_AS_READ_PREFIXES)).toBeNull();
157
+ });
158
+ });
159
+
160
+ describe('stripAnchorChrome', () => {
161
+ it('strips leading 未读 / Unread badge', () => {
162
+ expect(stripAnchorChrome('未读John liked your photo', null, UNREAD_BADGE_LABELS))
163
+ .toBe('John liked your photo');
164
+ expect(stripAnchorChrome('UnreadJohn liked your photo', null, UNREAD_BADGE_LABELS))
165
+ .toBe('John liked your photo');
166
+ });
167
+
168
+ it('strips trailing time-ago suffix when timeStr is provided', () => {
169
+ expect(stripAnchorChrome('未读回顾你在 2019年6月的那段过往.2天', '2天', UNREAD_BADGE_LABELS))
170
+ .toBe('回顾你在 2019年6月的那段过往');
171
+ expect(stripAnchorChrome('未读有人尝试登录，但我们已阻止。7周', '7周', UNREAD_BADGE_LABELS))
172
+ .toBe('有人尝试登录，但我们已阻止');
173
+ });
174
+
175
+ it('keeps text intact when there is no badge / no time', () => {
176
+ expect(stripAnchorChrome('John liked your photo', null, UNREAD_BADGE_LABELS))
177
+ .toBe('John liked your photo');
178
+ });
179
+
180
+ it('returns empty string for falsy input', () => {
181
+ expect(stripAnchorChrome('', null, UNREAD_BADGE_LABELS)).toBe('');
182
+ expect(stripAnchorChrome(null, null, UNREAD_BADGE_LABELS)).toBe('');
183
+ });
184
+ });
185
+
186
+ describe('parseNotifQuery', () => {
187
+ it('extracts notif_id and notif_t from absolute URLs', () => {
188
+ const href = 'https://www.facebook.com/photo/?fbid=104&set=a.105&notif_id=1777&notif_t=onthisday&ref=notif';
189
+ expect(parseNotifQuery(href, FB_HOST)).toEqual({
190
+ notif_id: '1777',
191
+ notif_type: 'onthisday',
192
+ });
193
+ });
194
+
195
+ it('handles relative URLs by resolving against fbHost', () => {
196
+ expect(parseNotifQuery('/groups/discover/?notif_id=1234&notif_t=group_recommendation', FB_HOST))
197
+ .toEqual({ notif_id: '1234', notif_type: 'group_recommendation' });
198
+ });
199
+
200
+ it('returns null fields when query params are absent — typed unknown', () => {
201
+ expect(parseNotifQuery('https://www.facebook.com/photo/?fbid=999', FB_HOST))
202
+ .toEqual({ notif_id: null, notif_type: null });
203
+ });
204
+
205
+ it('returns null fields for empty / unparseable input', () => {
206
+ expect(parseNotifQuery('', FB_HOST)).toEqual({ notif_id: null, notif_type: null });
207
+ expect(parseNotifQuery(null, FB_HOST)).toEqual({ notif_id: null, notif_type: null });
208
+ // jsdom's URL constructor accepts a lot — pass an obviously broken
209
+ // protocol to force the catch path.
210
+ expect(parseNotifQuery('http://[::not-an-ipv6', FB_HOST))
211
+ .toEqual({ notif_id: null, notif_type: null });
212
+ });
213
+ });
214
+
215
+ describe('isFacebookAuthRedirectPath', () => {
216
+ it('matches Facebook login/checkpoint paths including .php redirects', () => {
217
+ expect(isFacebookAuthRedirectPath('/login')).toBe(true);
218
+ expect(isFacebookAuthRedirectPath('/login/')).toBe(true);
219
+ expect(isFacebookAuthRedirectPath('/login.php')).toBe(true);
220
+ expect(isFacebookAuthRedirectPath('/login/identify/')).toBe(true);
221
+ expect(isFacebookAuthRedirectPath('/checkpoint')).toBe(true);
222
+ expect(isFacebookAuthRedirectPath('/checkpoint.php')).toBe(true);
223
+ });
224
+
225
+ it('does not match unrelated login-looking paths', () => {
226
+ expect(isFacebookAuthRedirectPath('/loginhelp')).toBe(false);
227
+ expect(isFacebookAuthRedirectPath('/help/login')).toBe(false);
228
+ expect(isFacebookAuthRedirectPath('/notifications')).toBe(false);
229
+ });
230
+ });
231
+
232
+ describe('extractNotificationRowsFromDoc — JSDOM against frozen fixture', () => {
233
+ it('extracts 4 data rows (1 header skipped) with full schema and stable order', () => {
234
+ const doc = loadFixtureDoc();
235
+ const rows = extractNotificationRowsFromDoc(doc, 100, fixtureHelpers);
236
+ expect(rows).toHaveLength(4);
237
+ expect(rows[0]).toEqual({
238
+ index: 1,
239
+ unread: true,
240
+ text: '回顾你在 2019年6月的那段过往',
241
+ time: '2天',
242
+ url: 'https://www.facebook.com/photo/?fbid=104250644186433&set=a.104250310853133&notif_id=1777926497886652&notif_t=onthisday&ref=notif',
243
+ notif_id: '1777926497886652',
244
+ notif_type: 'onthisday',
245
+ });
246
+ expect(rows[2]).toMatchObject({
247
+ index: 3,
248
+ unread: true,
249
+ text: '有人尝试登录，但我们已阻止',
250
+ time: '7周',
251
+ notif_type: 'approve_from_another_device',
252
+ notif_id: '1773680546395691',
253
+ });
254
+ expect(rows[3]).toMatchObject({
255
+ index: 4,
256
+ unread: true,
257
+ text: '你可能会喜欢 ETYCAL VIBEZ fan\'s page',
258
+ time: '2天',
259
+ notif_type: 'group_recommendation',
260
+ });
261
+ });
262
+
263
+ it('respects limit by returning at most N rows', () => {
264
+ const doc = loadFixtureDoc();
265
+ const rows = extractNotificationRowsFromDoc(doc, 2, fixtureHelpers);
266
+ expect(rows).toHaveLength(2);
267
+ expect(rows.map(r => r.index)).toEqual([1, 2]);
268
+ });
269
+
270
+ it('skips the header listitem (no <a href>) — guards against silent empty', () => {
271
+ const doc = loadFixtureDoc();
272
+ const allListitems = doc.querySelectorAll('[role="listitem"]');
273
+ expect(allListitems.length).toBe(5); // 1 header + 4 data
274
+ const rows = extractNotificationRowsFromDoc(doc, 100, fixtureHelpers);
275
+ expect(rows.length).toBe(4); // header skipped
276
+ // None of the returned rows match the header text.
277
+ for (const row of rows) {
278
+ expect(row.text).not.toBe('新通知');
279
+ }
280
+ });
281
+
282
+ it('text column has no truncation — bug fix vs legacy substring(0, 150)', () => {
283
+ const doc = loadFixtureDoc();
284
+ const rows = extractNotificationRowsFromDoc(doc, 100, fixtureHelpers);
285
+ // The on-this-day row body is 16+ chars; the legacy adapter would
286
+ // have happily returned anything <= 150. The point of this test
287
+ // is to assert nothing is silently sliced — full body text round-
288
+ // trips through the extractor.
289
+ expect(rows[0].text).toBe('回顾你在 2019年6月的那段过往');
290
+ expect(rows[1].text).toBe('看看你在 2019年6月发布的帖子，瞬间回到过去的美好时光');
291
+ // No row has a value that ends with our legacy truncation point.
292
+ for (const row of rows) {
293
+ expect(row.text).not.toMatch(/\u2026$/); // U+2026 ellipsis as a defensive check
294
+ }
295
+ });
296
+
297
+ it('time is null (typed unknown) when abbr is missing — never the legacy "-" sentinel', () => {
298
+ // Build a one-off JSDOM doc that mimics a row without an abbr.
299
+ const html = `<!doctype html><html><body><div role="main">
300
+ <div role="listitem">
301
+ <a href="https://www.facebook.com/page?notif_id=999&notif_t=test_event">
302
+ <span><div>未读</div>Body text without time</span>
303
+ </a>
304
+ </div>
305
+ </body></html>`;
306
+ const doc = new JSDOM(html).window.document;
307
+ const rows = extractNotificationRowsFromDoc(doc, 5, fixtureHelpers);
308
+ expect(rows).toHaveLength(1);
309
+ expect(rows[0].time).toBeNull();
310
+ expect(rows[0].text).toBe('Body text without time');
311
+ });
312
+
313
+ it('unread is false when no badge is present — bug fix vs legacy column-drop', () => {
314
+ const html = `<!doctype html><html><body><div role="main">
315
+ <div role="listitem">
316
+ <a href="https://www.facebook.com/x?notif_id=1&notif_t=read">
317
+ <span>Already read notification</span>
318
+ <abbr aria-label="3 hr"><span>3 hr</span></abbr>
319
+ </a>
320
+ </div>
321
+ </body></html>`;
322
+ const doc = new JSDOM(html).window.document;
323
+ const rows = extractNotificationRowsFromDoc(doc, 5, fixtureHelpers);
324
+ expect(rows).toHaveLength(1);
325
+ expect(rows[0].unread).toBe(false);
326
+ expect(rows[0].text).toBe('Already read notification');
327
+ });
328
+
329
+ it('resolves relative hrefs to full URLs for the url column', () => {
330
+ const html = `<!doctype html><html><body><div role="main">
331
+ <div role="listitem">
332
+ <a href="/groups/discover/?notif_id=42&notif_t=group_recommendation">
333
+ <span>UnreadRelative URL body</span>
334
+ <abbr aria-label="1 hr"><span>1 hr</span></abbr>
335
+ </a>
336
+ </div>
337
+ </body></html>`;
338
+ const doc = new JSDOM(html, { url: 'https://www.facebook.com/notifications' }).window.document;
339
+ const rows = extractNotificationRowsFromDoc(doc, 5, fixtureHelpers);
340
+ expect(rows).toHaveLength(1);
341
+ expect(rows[0].url).toBe('https://www.facebook.com/groups/discover/?notif_id=42&notif_t=group_recommendation');
342
+ expect(rows[0].notif_id).toBe('42');
343
+ expect(rows[0].notif_type).toBe('group_recommendation');
344
+ });
345
+
346
+ it('skips anchor rows with no recoverable body text — no text:null success rows', () => {
347
+ const html = `<!doctype html><html><body><div role="main">
348
+ <div role="listitem">
349
+ <a href="https://www.facebook.com/x?notif_id=1&notif_t=blank">
350
+ <span><div>未读</div></span>
351
+ <abbr aria-label="3 hr"><span>3 hr</span></abbr>
352
+ </a>
353
+ </div>
354
+ </body></html>`;
355
+ const doc = new JSDOM(html).window.document;
356
+ const rows = extractNotificationRowsFromDoc(doc, 5, fixtureHelpers);
357
+ expect(rows).toEqual([]);
358
+ });
359
+
360
+ it('returns [] for a doc with no listitems — Node side maps to EmptyResultError', () => {
361
+ const doc = new JSDOM('<!doctype html><html><body></body></html>').window.document;
362
+ const rows = extractNotificationRowsFromDoc(doc, 5, fixtureHelpers);
363
+ expect(rows).toEqual([]);
364
+ });
365
+ });
366
+
367
+ describe('buildNotificationsScript — IIFE invariants', () => {
368
+ it('embeds all four pure helpers via fn.toString()', () => {
369
+ const script = buildNotificationsScript(15);
370
+ expect(script).toContain('function stripMarkAsReadPrefix');
371
+ expect(script).toContain('function stripAnchorChrome');
372
+ expect(script).toContain('function parseNotifQuery');
373
+ expect(script).toContain('function isFacebookAuthRedirectPath');
374
+ expect(script).toContain('function extractNotificationRowsFromDoc');
375
+ });
376
+
377
+ it('inlines limit and FB_HOST so the live page does not depend on Node closures', () => {
378
+ const script = buildNotificationsScript(7);
379
+ expect(script).toMatch(/extractNotificationRowsFromDoc\(document,\s*7,/);
380
+ expect(script).toContain('"https://www.facebook.com"');
381
+ });
382
+
383
+ it('inlines locale prefix and badge tables so the IIFE has them at runtime', () => {
384
+ const script = buildNotificationsScript(15);
385
+ expect(script).toContain('"标记为已读，"');
386
+ expect(script).toContain('"未读"');
387
+ expect(script).toContain('"Unread"');
388
+ });
389
+
390
+ it('contains an auth-redirect guard before the DOM walk', () => {
391
+ const script = buildNotificationsScript(15);
392
+ expect(script).toMatch(/AUTH_REQUIRED.*facebook/i);
393
+ expect(script).toContain('isFacebookAuthRedirectPath(window.location.pathname');
394
+ });
395
+
396
+ it('does NOT contain the legacy silent-truncation slice/substring — anti-pattern regression guard', () => {
397
+ const script = buildNotificationsScript(15);
398
+ // Legacy: text.substring(0, 150) — silent-bad-shape that this PR fixes.
399
+ expect(script).not.toMatch(/text\.substring\(0,\s*150\)/);
400
+ // Legacy: time || '-' — silent sentinel that this PR fixes.
401
+ expect(script).not.toMatch(/time\s*\|\|\s*['"]-['"]/);
402
+ });
403
+ });
404
+
405
+ describe('facebook/notifications — func typed boundaries', () => {
406
+ function createPageMock(rows) {
407
+ return {
408
+ goto: vi.fn().mockResolvedValue(undefined),
409
+ evaluate: vi.fn().mockResolvedValue(rows),
410
+ };
411
+ }
412
+
413
+ function createFailingPageMock(error, { failGoto = false } = {}) {
414
+ return {
415
+ goto: vi.fn(failGoto ? () => Promise.reject(error) : () => Promise.resolve()),
416
+ evaluate: vi.fn(failGoto ? () => Promise.resolve([]) : () => Promise.reject(error)),
417
+ };
418
+ }
419
+
420
+ it('validates --limit upfront before navigation', async () => {
421
+ const page = createPageMock([]);
422
+ await expect(notificationsCommand.func(page, { limit: 0 })).rejects.toThrow(ArgumentError);
423
+ await expect(notificationsCommand.func(page, { limit: NOTIFICATIONS_LIMIT_MAX + 1 })).rejects.toThrow(ArgumentError);
424
+ expect(page.goto).not.toHaveBeenCalled();
425
+ expect(page.evaluate).not.toHaveBeenCalled();
426
+ });
427
+
428
+ it('returns rows verbatim on success', async () => {
429
+ const row = {
430
+ index: 1,
431
+ unread: true,
432
+ text: 'hello',
433
+ time: '2天',
434
+ url: 'https://www.facebook.com/notifications/?notif_id=1&notif_t=test',
435
+ notif_id: '1',
436
+ notif_type: 'test',
437
+ };
438
+ await expect(notificationsCommand.func(createPageMock([row]), { limit: 1 })).resolves.toEqual([row]);
439
+ });
440
+
441
+ it('maps empty rows to EmptyResultError', async () => {
442
+ await expect(notificationsCommand.func(createPageMock([]), { limit: 1 })).rejects.toThrow(EmptyResultError);
443
+ });
444
+
445
+ it('maps auth sentinel evaluate failures to AuthRequiredError', async () => {
446
+ const page = createFailingPageMock(new Error('AUTH_REQUIRED: facebook.com redirected to login'));
447
+ await expect(notificationsCommand.func(page, { limit: 1 })).rejects.toThrow(AuthRequiredError);
448
+ });
449
+
450
+ it('wraps navigation and evaluate failures as CommandExecutionError', async () => {
451
+ await expect(
452
+ notificationsCommand.func(createFailingPageMock(new Error('network down'), { failGoto: true }), { limit: 1 }),
453
+ ).rejects.toThrow(CommandExecutionError);
454
+ await expect(
455
+ notificationsCommand.func(createFailingPageMock(new Error('selector crashed')), { limit: 1 }),
456
+ ).rejects.toThrow(CommandExecutionError);
457
+ });
458
+ });
package/clis/flathub/app.js ADDED
@@ -0,0 +1,71 @@
1
+ // flathub app — full appstream metadata for a Flathub app id.
2
+ //
3
+ // Hits `/api/v2/appstream/<appId>`. AppStream IDs are reverse-DNS (e.g.
4
+ // "org.mozilla.firefox", "org.gnome.Calculator").
5
+ import { cli, Strategy } from '@jackwener/opencli/registry';
6
+ import { EmptyResultError } from '@jackwener/opencli/errors';
7
+ import {
8
+ FLATHUB_API_BASE,
9
+ FLATHUB_APP_BASE,
10
+ flathubFetch,
11
+ joinList,
12
+ pickLatestRelease,
13
+ requireAppId,
14
+ } from './utils.js';
15
+
16
+ cli({
17
+ site: 'flathub',
18
+ name: 'app',
19
+ access: 'read',
20
+ description: 'Full Flathub appstream metadata for an app id (license, categories, latest release)',
21
+ domain: 'flathub.org',
22
+ strategy: Strategy.PUBLIC,
23
+ browser: false,
24
+ args: [
25
+ { name: 'appId', positional: true, required: true, help: 'AppStream id (e.g. "org.mozilla.firefox", "org.gnome.Calculator")' },
26
+ ],
27
+ columns: [
28
+ 'appId',
29
+ 'name',
30
+ 'summary',
31
+ 'developer',
32
+ 'license',
33
+ 'isFreeLicense',
34
+ 'isEol',
35
+ 'categories',
36
+ 'keywords',
37
+ 'latestVersion',
38
+ 'latestReleaseDate',
39
+ 'homepage',
40
+ 'bugtracker',
41
+ 'donation',
42
+ 'url',
43
+ ],
44
+ func: async (args) => {
45
+ const appId = requireAppId(args.appId);
46
+ const url = `${FLATHUB_API_BASE}/appstream/${encodeURIComponent(appId)}`;
47
+ const body = await flathubFetch(url, 'flathub app');
48
+ if (!body || typeof body !== 'object' || !body.id) {
49
+ throw new EmptyResultError('flathub app', `Flathub app "${appId}" returned empty payload.`);
50
+ }
51
+ const urls = body.urls && typeof body.urls === 'object' ? body.urls : {};
52
+ const release = pickLatestRelease(body.releases);
53
+ return [{
54
+ appId: typeof body.id === 'string' ? body.id : appId,
55
+ name: typeof body.name === 'string' ? body.name : null,
56
+ summary: typeof body.summary === 'string' ? body.summary : null,
57
+ developer: typeof body.developer_name === 'string' ? body.developer_name : null,
58
+ license: typeof body.project_license === 'string' ? body.project_license : null,
59
+ isFreeLicense: body.is_free_license === true,
60
+ isEol: body.is_eol === true,
61
+ categories: joinList(body.categories),
62
+ keywords: joinList(body.keywords, 8),
63
+ latestVersion: release.version,
64
+ latestReleaseDate: release.date,
65
+ homepage: typeof urls.homepage === 'string' ? urls.homepage : null,
66
+ bugtracker: typeof urls.bugtracker === 'string' ? urls.bugtracker : null,
67
+ donation: typeof urls.donation === 'string' ? urls.donation : null,
68
+ url: `${FLATHUB_APP_BASE}/${appId}`,
69
+ }];
70
+ },
71
+ });
package/clis/flathub/flathub.test.js ADDED
@@ -0,0 +1,90 @@
1
+ import { afterEach, describe, expect, it, vi } from 'vitest';
2
+ import { getRegistry } from '@jackwener/opencli/registry';
3
+ import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
4
+ import './search.js';
5
+ import './app.js';
6
+
7
+ afterEach(() => {
8
+ vi.unstubAllGlobals();
9
+ vi.restoreAllMocks();
10
+ });
11
+
12
+ describe('flathub search adapter', () => {
13
+ const cmd = getRegistry().get('flathub/search');
14
+
15
+ it('rejects bad args before fetching', async () => {
16
+ const fetchMock = vi.fn();
17
+ vi.stubGlobal('fetch', fetchMock);
18
+ await expect(cmd.func({ query: '' })).rejects.toThrow(ArgumentError);
19
+ await expect(cmd.func({ query: 'foo', limit: 999 })).rejects.toThrow(ArgumentError);
20
+ expect(fetchMock).not.toHaveBeenCalled();
21
+ });
22
+
23
+ it('maps HTTP 429 to CommandExecutionError', async () => {
24
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response('throttled', { status: 429 })));
25
+ await expect(cmd.func({ query: 'firefox' })).rejects.toThrow(CommandExecutionError);
26
+ });
27
+
28
+ it('throws EmptyResultError on empty hits', async () => {
29
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response(JSON.stringify({ hits: [] }), { status: 200 })));
30
+ await expect(cmd.func({ query: 'no-such-app' })).rejects.toThrow(EmptyResultError);
31
+ });
32
+
33
+ it('round-trips appId into flathub.org URL and normalises updated_at unix-seconds to ISO', async () => {
34
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response(JSON.stringify({
35
+ hits: [{
36
+ app_id: 'org.mozilla.firefox', name: 'Firefox', summary: 'Web browser',
37
+ developer_name: 'Mozilla', project_license: 'MPL-2.0', is_free_license: true,
38
+ main_categories: 'network', installs_last_month: 100000,
39
+ updated_at: 1730000000,
40
+ }],
41
+ }), { status: 200 })));
42
+ const rows = await cmd.func({ query: 'firefox', limit: 5 });
43
+ expect(rows[0]).toMatchObject({
44
+ rank: 1, appId: 'org.mozilla.firefox', name: 'Firefox',
45
+ license: 'MPL-2.0', isFreeLicense: true, mainCategories: 'network',
46
+ installsLastMonth: 100000, updatedAt: '2024-10-27',
47
+ url: 'https://flathub.org/apps/org.mozilla.firefox',
48
+ });
49
+ });
50
+ });
51
+
52
+ describe('flathub app adapter', () => {
53
+ const cmd = getRegistry().get('flathub/app');
54
+
55
+ it('rejects malformed appId before fetching', async () => {
56
+ const fetchMock = vi.fn();
57
+ vi.stubGlobal('fetch', fetchMock);
58
+ await expect(cmd.func({ appId: '' })).rejects.toThrow(ArgumentError);
59
+ await expect(cmd.func({ appId: 'no-dot' })).rejects.toThrow(ArgumentError);
60
+ await expect(cmd.func({ appId: '.starts.with.dot' })).rejects.toThrow(ArgumentError);
61
+ expect(fetchMock).not.toHaveBeenCalled();
62
+ });
63
+
64
+ it('maps HTTP 404 to EmptyResultError', async () => {
65
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response('missing', { status: 404 })));
66
+ await expect(cmd.func({ appId: 'org.example.does-not-exist' })).rejects.toThrow(EmptyResultError);
67
+ });
68
+
69
+ it('handles releases with string-typed timestamps (flathub appstream quirk)', async () => {
70
+ vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response(JSON.stringify({
71
+ id: 'org.mozilla.firefox', name: 'Firefox', summary: 'Web browser',
72
+ developer_name: 'Mozilla', project_license: 'MPL-2.0', is_free_license: true,
73
+ categories: ['Network', 'WebBrowser'], keywords: ['Browser'],
74
+ urls: { homepage: 'https://www.mozilla.org/firefox/' },
75
+ releases: [
76
+ // upstream emits these as numeric strings, not numbers
77
+ { version: '150.0.1', timestamp: '1777248000', type: 'stable' },
78
+ { version: '149.0.0', timestamp: '1770000000', type: 'stable' },
79
+ ],
80
+ }), { status: 200 })));
81
+ const rows = await cmd.func({ appId: 'org.mozilla.firefox' });
82
+ expect(rows[0]).toMatchObject({
83
+ appId: 'org.mozilla.firefox', name: 'Firefox',
84
+ categories: 'Network, WebBrowser',
85
+ latestVersion: '150.0.1', latestReleaseDate: '2026-04-27',
86
+ homepage: 'https://www.mozilla.org/firefox/',
87
+ url: 'https://flathub.org/apps/org.mozilla.firefox',
88
+ });
89
+ });
90
+ });