@delali/narsil 0.3.1-next.98 → 0.4.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.
Files changed (426) hide show
  1. package/NOTICE +45 -0
  2. package/README.md +27 -8
  3. package/dist/adapters/filesystem.d.ts +1 -1
  4. package/dist/adapters/filesystem.mjs +101 -13
  5. package/dist/adapters/gcs.d.ts +49 -0
  6. package/dist/adapters/gcs.mjs +213 -0
  7. package/dist/adapters/indexeddb.d.ts +1 -1
  8. package/dist/adapters/indexeddb.mjs +2 -7
  9. package/dist/adapters/memory.d.ts +1 -1
  10. package/dist/adapters/memory.mjs +5 -0
  11. package/dist/adapters/s3.d.ts +53 -0
  12. package/dist/adapters/s3.mjs +263 -0
  13. package/dist/{adapters-BQFQ4PRz.d.ts → adapters-pljAqmrC.d.ts} +33 -0
  14. package/dist/browser/chunk-4E5APHTM.mjs +1459 -0
  15. package/dist/browser/chunk-NDYADQ4Y.mjs +23426 -0
  16. package/dist/browser/chunk-QAOVAYAG.mjs +564 -0
  17. package/dist/browser/chunk-WC2DEXWU.mjs +29 -0
  18. package/dist/browser/chunk-YINZFPLT.mjs +1239 -0
  19. package/dist/browser/chunk-YJHGOJAC.mjs +15 -0
  20. package/dist/browser/{chunk-Z7QH2XHB.mjs → core-leaf-HWAXCEWX.mjs} +3987 -2103
  21. package/dist/browser/custom-token-results-R5BIX7SL.mjs +59 -0
  22. package/dist/browser/digest-leaf-64IPRPZD.mjs +151 -0
  23. package/dist/browser/durability-config-75NSFCQN.mjs +97 -0
  24. package/dist/browser/embed-GG6PS3EA.mjs +264 -0
  25. package/dist/browser/geo-index-GNHY4PUB.mjs +1484 -0
  26. package/dist/browser/gzip-JF3S6PPT.mjs +31 -0
  27. package/dist/browser/module-ZZTNG5JZ.mjs +5762 -0
  28. package/dist/browser/msgpack-leaf-44XNWSSY.mjs +302 -0
  29. package/dist/browser/optional-reads-XMVPG6HG.mjs +3230 -0
  30. package/dist/browser/optional-writes-76DWMRQH.mjs +3603 -0
  31. package/dist/browser/phrase-module-6UGFVW5J.mjs +617 -0
  32. package/dist/browser/resolve-vector-text-XRR2OVHE.mjs +85 -0
  33. package/dist/browser/restore-queue-SG5O735W.mjs +196 -0
  34. package/dist/browser/{runtime-NYE5TB6O.mjs → runtime-OMKE7DF4.mjs} +83 -25
  35. package/dist/browser/segment-codec-leaf-A427QJUX.mjs +554 -0
  36. package/dist/browser/segment-merge-leaf-7BZ54JPI.mjs +1636 -0
  37. package/dist/browser/storage-leaf-5UTR5K7J.mjs +19829 -0
  38. package/dist/browser/store-leaf-3L33V35P.mjs +2070 -0
  39. package/dist/browser/suggestions-leaf-UBNDVKBD.mjs +1430 -0
  40. package/dist/browser/worker-copies-JXSGYR5X.mjs +2951 -0
  41. package/dist/{capabilities-BTTIs96E.d.ts → capabilities-DMte5K9_.d.ts} +162 -18
  42. package/dist/chunk-2AFZE7Y3.mjs +72 -0
  43. package/dist/chunk-2CKDCC65.mjs +47 -0
  44. package/dist/chunk-3ECIRFS5.mjs +61 -0
  45. package/dist/chunk-44W3CBNG.mjs +7 -0
  46. package/dist/chunk-4H4RG2FR.mjs +13 -0
  47. package/dist/chunk-4PY4JYMY.mjs +11 -0
  48. package/dist/chunk-4ZPVAHWF.mjs +1289 -0
  49. package/dist/chunk-5EI5CXO6.mjs +197 -0
  50. package/dist/chunk-5F5MXWS5.mjs +283 -0
  51. package/dist/{chunk-OHP7QR33.mjs → chunk-5FLRXF73.mjs} +25 -4
  52. package/dist/chunk-6FOENO4E.mjs +273 -0
  53. package/dist/chunk-6GHX35ZM.mjs +108 -0
  54. package/dist/chunk-6MSZ543Y.mjs +32 -0
  55. package/dist/chunk-6N6HHBCQ.mjs +4596 -0
  56. package/dist/{chunk-LXPIXDUJ.mjs → chunk-7P5YWDRQ.mjs} +403 -169
  57. package/dist/{chunk-TGP5M5R7.mjs → chunk-7T4LAYT4.mjs} +1 -1
  58. package/dist/{chunk-GGSH6KBQ.mjs → chunk-ASZLNVWW.mjs} +23 -3
  59. package/dist/chunk-AVBPB3MI.mjs +602 -0
  60. package/dist/{chunk-UCDF35PU.mjs → chunk-AVGUEEQ3.mjs} +494 -245
  61. package/dist/chunk-BUMREPLU.mjs +15 -0
  62. package/dist/chunk-BY6NALRK.mjs +31921 -0
  63. package/dist/chunk-C4ZMXXTL.mjs +92 -0
  64. package/dist/{chunk-2WYMG3OZ.mjs → chunk-C74KPRR7.mjs} +274 -19
  65. package/dist/{chunk-RSRVGAIQ.mjs → chunk-D456ZFPQ.mjs} +3 -2
  66. package/dist/chunk-DXZ6JDWG.mjs +797 -0
  67. package/dist/chunk-FJXJZUWF.mjs +209 -0
  68. package/dist/chunk-FS3HPPSC.mjs +212 -0
  69. package/dist/chunk-FT4KLZXW.mjs +1164 -0
  70. package/dist/chunk-GR5GMFJJ.mjs +104 -0
  71. package/dist/chunk-GXCDWLQI.mjs +193 -0
  72. package/dist/chunk-GXED6R3Q.mjs +271 -0
  73. package/dist/chunk-HLPRHOSO.mjs +17 -0
  74. package/dist/chunk-IL5DRCNU.mjs +3041 -0
  75. package/dist/{chunk-P36MUFEJ.mjs → chunk-JDDXV6UF.mjs} +2 -1
  76. package/dist/chunk-K5HSUPYS.mjs +11 -0
  77. package/dist/chunk-KYIRXTCA.mjs +100 -0
  78. package/dist/chunk-LFXS6OF7.mjs +289 -0
  79. package/dist/chunk-LNGE7SLY.mjs +151 -0
  80. package/dist/chunk-M2Z5WVWW.mjs +194 -0
  81. package/dist/{chunk-45AVKHMJ.mjs → chunk-M3B7SGJB.mjs} +63 -50
  82. package/dist/chunk-M3OW2XSP.mjs +40 -0
  83. package/dist/chunk-MFPSQZ6P.mjs +127 -0
  84. package/dist/chunk-MRCJBWJZ.mjs +1292 -0
  85. package/dist/chunk-MSIN4NM3.mjs +25 -0
  86. package/dist/chunk-MW3CJVGP.mjs +219 -0
  87. package/dist/chunk-MYM6CAVK.mjs +76 -0
  88. package/dist/chunk-NJJN4FMM.mjs +84 -0
  89. package/dist/chunk-NM7I3BM7.mjs +59 -0
  90. package/dist/chunk-OIJ64LGT.mjs +19 -0
  91. package/dist/{chunk-K7D4ZTSW.mjs → chunk-P4F4UWLC.mjs} +1 -1
  92. package/dist/chunk-Q2AP2FSN.mjs +15 -0
  93. package/dist/chunk-R2PJKSNL.mjs +54 -0
  94. package/dist/{chunk-HXJBSHXF.mjs → chunk-R724DJSG.mjs} +5056 -2619
  95. package/dist/chunk-S2POFTLN.mjs +10 -0
  96. package/dist/chunk-S5QMWECL.mjs +7 -0
  97. package/dist/chunk-SLAC5PAB.mjs +5008 -0
  98. package/dist/chunk-T4HMSZCX.mjs +5 -0
  99. package/dist/chunk-TACP6VK6.mjs +111 -0
  100. package/dist/chunk-TGPKS2UM.mjs +125 -0
  101. package/dist/chunk-TKKXPKEO.mjs +979 -0
  102. package/dist/chunk-V6EUBAIT.mjs +19 -0
  103. package/dist/chunk-XL56L4IR.mjs +228 -0
  104. package/dist/chunk-XQIAMDAG.mjs +3076 -0
  105. package/dist/chunk-YTUZ4R22.mjs +1063 -0
  106. package/dist/{chunk-KV3AZFT3.mjs → chunk-ZKOQR7EA.mjs} +45 -1
  107. package/dist/chunk-ZPJFGGGI.mjs +638 -0
  108. package/dist/chunk-ZXX5GZEX.mjs +17 -0
  109. package/dist/{client-i9eLJrw5.d.ts → client-BKqtl0_V.d.ts} +442 -22
  110. package/dist/client.d.ts +11 -10
  111. package/dist/client.mjs +8 -898
  112. package/dist/config-Bnl7L-0H.d.ts +608 -0
  113. package/dist/{config-P__Diiy4.d.ts → config-CJ-jfI0a.d.ts} +119 -9
  114. package/dist/core-leaf-6JVHEVFB.mjs +8 -0
  115. package/dist/custom-token-results-NXHBVY7U.mjs +59 -0
  116. package/dist/digest-leaf-KXBGKYHZ.mjs +1 -0
  117. package/dist/direct-executor-V3WOYU2Y.mjs +17 -0
  118. package/dist/distribution/coordinator/etcd.d.ts +63 -7
  119. package/dist/distribution/coordinator/etcd.mjs +725 -81
  120. package/dist/distribution/coordinator/in-memory.d.ts +3 -3
  121. package/dist/distribution/coordinator/in-memory.mjs +65 -10
  122. package/dist/distribution/transport/grpc.d.ts +2 -2
  123. package/dist/distribution/transport/grpc.mjs +39 -10
  124. package/dist/distribution/transport/in-memory.d.ts +2 -2
  125. package/dist/distribution/transport/in-memory.mjs +9 -6
  126. package/dist/distribution/transport/tcp.d.ts +2 -2
  127. package/dist/distribution/transport/tcp.mjs +20 -15
  128. package/dist/distribution.d.ts +267 -56
  129. package/dist/distribution.mjs +23156 -11362
  130. package/dist/durability-config-VWS2K24E.mjs +96 -0
  131. package/dist/embed-4PHHKGBK.mjs +263 -0
  132. package/dist/embeddings/openai.d.ts +1 -1
  133. package/dist/embeddings/openai.mjs +2 -2
  134. package/dist/{memory-CUEDwr-F.d.ts → engine-qjAxJSKk.d.ts} +2254 -1123
  135. package/dist/geo-index-2ZMMWWSK.mjs +1484 -0
  136. package/dist/gzip-2UCZW2MM.mjs +31 -0
  137. package/dist/{index-lcdGLyJH.d.ts → index-B_vmxpgW.d.ts} +260 -102
  138. package/dist/index.browser.mjs +4 -4
  139. package/dist/index.d.ts +2133 -57
  140. package/dist/index.mjs +16 -32
  141. package/dist/index.react-native.mjs +12 -0
  142. package/dist/invalidation/broadcast-channel.d.ts +1 -1
  143. package/dist/invalidation/filesystem.d.ts +1 -1
  144. package/dist/invalidation/filesystem.mjs +1 -2
  145. package/dist/invalidation/noop.d.ts +1 -1
  146. package/dist/languages/albanian.mjs +1 -1
  147. package/dist/languages/amharic.mjs +1 -1
  148. package/dist/languages/arabic.mjs +1 -1
  149. package/dist/languages/armenian.mjs +1 -1
  150. package/dist/languages/azerbaijani.mjs +1 -1
  151. package/dist/languages/bambara.mjs +1 -1
  152. package/dist/languages/basque.mjs +1 -1
  153. package/dist/languages/belarusian.mjs +1 -1
  154. package/dist/languages/bengali.mjs +1 -1
  155. package/dist/languages/bosnian.mjs +1 -1
  156. package/dist/languages/breton.mjs +1 -1
  157. package/dist/languages/bulgarian.mjs +1 -1
  158. package/dist/languages/burmese.mjs +1 -1
  159. package/dist/languages/catalan.mjs +1 -1
  160. package/dist/languages/chinese.mjs +1 -1
  161. package/dist/languages/croatian.mjs +1 -1
  162. package/dist/languages/czech.mjs +1 -1
  163. package/dist/languages/dagbani.mjs +1 -1
  164. package/dist/languages/danish.mjs +1 -1
  165. package/dist/languages/dutch.mjs +1 -1
  166. package/dist/languages/english.mjs +1 -1
  167. package/dist/languages/esperanto.mjs +1 -1
  168. package/dist/languages/estonian.mjs +1 -1
  169. package/dist/languages/ewe.mjs +1 -1
  170. package/dist/languages/faroese.mjs +1 -1
  171. package/dist/languages/fijian.mjs +1 -1
  172. package/dist/languages/finnish.mjs +1 -1
  173. package/dist/languages/french.mjs +1 -1
  174. package/dist/languages/ga.mjs +1 -1
  175. package/dist/languages/galician.mjs +1 -1
  176. package/dist/languages/georgian.mjs +1 -1
  177. package/dist/languages/german.mjs +1 -1
  178. package/dist/languages/greek.mjs +1 -1
  179. package/dist/languages/guarani.mjs +1 -1
  180. package/dist/languages/gujarati.mjs +1 -1
  181. package/dist/languages/haitian-creole.mjs +1 -1
  182. package/dist/languages/hausa.mjs +1 -1
  183. package/dist/languages/hawaiian.mjs +1 -1
  184. package/dist/languages/hebrew.mjs +1 -1
  185. package/dist/languages/hindi.mjs +1 -1
  186. package/dist/languages/hungarian.mjs +1 -1
  187. package/dist/languages/icelandic.mjs +1 -1
  188. package/dist/languages/igbo.mjs +1 -1
  189. package/dist/languages/indonesian.mjs +1 -1
  190. package/dist/languages/irish.mjs +1 -1
  191. package/dist/languages/italian.mjs +1 -1
  192. package/dist/languages/japanese.mjs +1 -1
  193. package/dist/languages/kannada.mjs +1 -1
  194. package/dist/languages/kazakh.mjs +1 -1
  195. package/dist/languages/khmer.mjs +1 -1
  196. package/dist/languages/kinyarwanda.mjs +1 -1
  197. package/dist/languages/kirundi.mjs +1 -1
  198. package/dist/languages/korean.mjs +1 -1
  199. package/dist/languages/kurmanji.mjs +1 -1
  200. package/dist/languages/kyrgyz.mjs +1 -1
  201. package/dist/languages/lao.mjs +1 -1
  202. package/dist/languages/latin.mjs +1 -1
  203. package/dist/languages/latvian.mjs +1 -1
  204. package/dist/languages/lingala.mjs +1 -1
  205. package/dist/languages/lithuanian.mjs +1 -1
  206. package/dist/languages/luxembourgish.mjs +1 -1
  207. package/dist/languages/macedonian.mjs +1 -1
  208. package/dist/languages/malagasy.mjs +1 -1
  209. package/dist/languages/malay.mjs +1 -1
  210. package/dist/languages/malayalam.mjs +1 -1
  211. package/dist/languages/maltese.mjs +1 -1
  212. package/dist/languages/maori.mjs +1 -1
  213. package/dist/languages/marathi.mjs +1 -1
  214. package/dist/languages/nepali.mjs +1 -1
  215. package/dist/languages/norwegian.mjs +1 -1
  216. package/dist/languages/oromo.mjs +1 -1
  217. package/dist/languages/persian.mjs +1 -1
  218. package/dist/languages/polish.mjs +1 -1
  219. package/dist/languages/portuguese.mjs +1 -1
  220. package/dist/languages/punjabi.mjs +1 -1
  221. package/dist/languages/romanian.mjs +1 -1
  222. package/dist/languages/russian.mjs +1 -1
  223. package/dist/languages/samoan.mjs +1 -1
  224. package/dist/languages/sanskrit.mjs +1 -1
  225. package/dist/languages/scottish-gaelic.mjs +1 -1
  226. package/dist/languages/serbian.mjs +1 -1
  227. package/dist/languages/shona.mjs +1 -1
  228. package/dist/languages/sinhala.mjs +1 -1
  229. package/dist/languages/slovak.mjs +1 -1
  230. package/dist/languages/slovenian.mjs +1 -1
  231. package/dist/languages/sorani.mjs +1 -1
  232. package/dist/languages/spanish.mjs +1 -1
  233. package/dist/languages/swahili.mjs +1 -1
  234. package/dist/languages/swedish.mjs +1 -1
  235. package/dist/languages/tagalog.mjs +1 -1
  236. package/dist/languages/tamil.mjs +1 -1
  237. package/dist/languages/tatar.mjs +1 -1
  238. package/dist/languages/telugu.mjs +1 -1
  239. package/dist/languages/thai.mjs +1 -1
  240. package/dist/languages/tibetan.mjs +1 -1
  241. package/dist/languages/tigrinya.mjs +1 -1
  242. package/dist/languages/tongan.mjs +1 -1
  243. package/dist/languages/turkish.mjs +1 -1
  244. package/dist/languages/twi.mjs +1 -1
  245. package/dist/languages/ukrainian.mjs +1 -1
  246. package/dist/languages/urdu.mjs +1 -1
  247. package/dist/languages/vietnamese.mjs +1 -1
  248. package/dist/languages/welsh.mjs +1 -1
  249. package/dist/languages/wolof.mjs +1 -1
  250. package/dist/languages/xhosa.mjs +1 -1
  251. package/dist/languages/yoruba.mjs +1 -1
  252. package/dist/languages/zulu.mjs +1 -1
  253. package/dist/long-query-thread-UCRK7MSI.mjs +154 -0
  254. package/dist/module-5ZSLUQII.mjs +3729 -0
  255. package/dist/msgpack-leaf-H5ZYW7S7.mjs +9 -0
  256. package/dist/optional-reads-5HFMF2QZ.mjs +3373 -0
  257. package/dist/optional-writes-4UOQKETU.mjs +247 -0
  258. package/dist/paged-partition-archive-BBRLZCIF.mjs +253 -0
  259. package/dist/partial-words.browser.mjs +1650 -0
  260. package/dist/partial-words.mjs +17 -11
  261. package/dist/{chunk-ASY5PHYI.mjs → pattern.browser.mjs} +253 -311
  262. package/dist/pattern.mjs +6 -7
  263. package/dist/persistence/durability/checkpoint-worker.d.ts +93 -25
  264. package/dist/persistence/durability/checkpoint-worker.mjs +51 -41
  265. package/dist/phrase-module-EFESWOCR.mjs +635 -0
  266. package/dist/query-actions-HMJUVWGT.mjs +119 -0
  267. package/dist/query-suggestions/merge-worker.d.ts +55 -0
  268. package/dist/query-suggestions/merge-worker.mjs +53 -0
  269. package/dist/query-suggestions-CBYkrQ5T.d.ts +311 -0
  270. package/dist/query-suggestions.browser.mjs +47 -0
  271. package/dist/query-suggestions.d.ts +20 -0
  272. package/dist/query-suggestions.mjs +19 -0
  273. package/dist/react-native/chunks/chunk-3OEFSHVV.mjs +970 -0
  274. package/dist/{browser/chunk-RELZRJNR.mjs → react-native/chunks/chunk-43R4GCM7.mjs} +49 -50
  275. package/dist/react-native/chunks/chunk-AKRYHAVG.mjs +6729 -0
  276. package/dist/react-native/chunks/chunk-CW2ZFXSE.mjs +14 -0
  277. package/dist/react-native/chunks/chunk-G3WCDTOF.mjs +29640 -0
  278. package/dist/react-native/chunks/chunk-GXXHHA2T.mjs +212 -0
  279. package/dist/react-native/chunks/chunk-H3MDVPBO.mjs +151 -0
  280. package/dist/react-native/chunks/chunk-HQEVQEDJ.mjs +52 -0
  281. package/dist/react-native/chunks/chunk-HRDMIQ63.mjs +131 -0
  282. package/dist/react-native/chunks/chunk-HTBY4GON.mjs +565 -0
  283. package/dist/react-native/chunks/chunk-LX62Y4B5.mjs +61 -0
  284. package/dist/react-native/chunks/chunk-MRH36RN3.mjs +902 -0
  285. package/dist/react-native/chunks/chunk-Q32DDFKX.mjs +19 -0
  286. package/dist/react-native/chunks/chunk-UE4ANHSX.mjs +127 -0
  287. package/dist/react-native/chunks/chunk-UNZPWLVL.mjs +1063 -0
  288. package/dist/react-native/chunks/chunk-UO44MA5M.mjs +232 -0
  289. package/dist/react-native/chunks/chunk-UYKIV2KT.mjs +42 -0
  290. package/dist/react-native/chunks/chunk-VUJCSQG5.mjs +11 -0
  291. package/dist/react-native/chunks/chunk-WVHF4ZAK.mjs +802 -0
  292. package/dist/react-native/chunks/chunk-ZUJCUPVS.mjs +54 -0
  293. package/dist/react-native/chunks/core-leaf-S2KNBWDY.mjs +7 -0
  294. package/dist/react-native/chunks/custom-token-results-3OZEMRE7.mjs +59 -0
  295. package/dist/react-native/chunks/digest-leaf-X6OIFDIU.mjs +1 -0
  296. package/dist/react-native/chunks/durability-config-FCSD4MXY.mjs +96 -0
  297. package/dist/react-native/chunks/embed-HA2I7RCF.mjs +263 -0
  298. package/dist/react-native/chunks/geo-index-QEYKEVPH.mjs +1484 -0
  299. package/dist/react-native/chunks/gzip.react-native-CVM4NQG2.mjs +12 -0
  300. package/dist/react-native/chunks/module-FMBX75GP.mjs +5209 -0
  301. package/dist/react-native/chunks/msgpack-leaf-JMNGSTRW.mjs +7 -0
  302. package/dist/react-native/chunks/optional-reads-AFPO2FEB.mjs +3364 -0
  303. package/dist/react-native/chunks/optional-writes-XOH25XZI.mjs +296 -0
  304. package/dist/react-native/chunks/phrase-module-IGYBK7XH.mjs +636 -0
  305. package/dist/react-native/chunks/replace-IMZUVUOE.mjs +57 -0
  306. package/dist/react-native/chunks/resolve-vector-text-GE2CRJKI.mjs +84 -0
  307. package/dist/react-native/chunks/restore-queue-LLNMYB4Z.mjs +187 -0
  308. package/dist/react-native/chunks/runtime-UOHD2XUJ.mjs +615 -0
  309. package/dist/react-native/chunks/segment-codec-leaf-VR6O5GLC.mjs +13 -0
  310. package/dist/react-native/chunks/segment-merge-leaf-LLMWU4EW.mjs +14 -0
  311. package/dist/react-native/chunks/storage-leaf-JD7PIDO4.mjs +19633 -0
  312. package/dist/react-native/chunks/store-leaf-4UVCMYGN.mjs +15 -0
  313. package/dist/react-native/chunks/suggestions-leaf-J5VT5RHY.mjs +1321 -0
  314. package/dist/react-native/chunks/worker-copies-ZYHY7FKJ.mjs +2831 -0
  315. package/dist/react-native/partial-words.mjs +1658 -0
  316. package/dist/react-native/pattern.mjs +2570 -0
  317. package/dist/react-native/query-suggestions.mjs +55 -0
  318. package/dist/react-native/sync.mjs +2759 -0
  319. package/dist/react-native/synonyms.mjs +676 -0
  320. package/dist/react.d.ts +12 -8
  321. package/dist/react.mjs +45 -1
  322. package/dist/{rerank-NWTKK636.mjs → rerank-RI2PMNOD.mjs} +22 -12
  323. package/dist/rerankers/http.d.ts +1 -1
  324. package/dist/rerankers/http.mjs +2 -2
  325. package/dist/resolve-vector-text-OD4J3WHF.mjs +3 -0
  326. package/dist/restore-queue-PCKWDAKQ.mjs +192 -0
  327. package/dist/runtime-USQYKN3I.mjs +615 -0
  328. package/dist/{schema-4W_7tk1f.d.ts → schema-CzG9OUw5.d.ts} +70 -30
  329. package/dist/segment-codec-leaf-QJM7I6QG.mjs +18 -0
  330. package/dist/segment-merge-leaf-4BJGIJHY.mjs +18 -0
  331. package/dist/server.d.ts +348 -22
  332. package/dist/server.mjs +2211 -327
  333. package/dist/storage-leaf-GRRRI7UV.mjs +5962 -0
  334. package/dist/store-leaf-6VMMSVBE.mjs +20 -0
  335. package/dist/stored-values-BWIMpiT_.d.ts +25 -0
  336. package/dist/suggestions-leaf-4KPTMPTL.mjs +54 -0
  337. package/dist/sync/filesystem.d.ts +30 -0
  338. package/dist/sync/filesystem.mjs +288 -0
  339. package/dist/sync/indexeddb.browser.mjs +287 -0
  340. package/dist/sync/indexeddb.d.ts +30 -0
  341. package/dist/sync/indexeddb.mjs +242 -0
  342. package/dist/sync.browser.mjs +1271 -0
  343. package/dist/sync.d.ts +23 -0
  344. package/dist/sync.mjs +2712 -0
  345. package/dist/synonyms.browser.mjs +658 -0
  346. package/dist/synonyms.mjs +17 -7
  347. package/dist/tasks-65b6t6lk.d.ts +782 -0
  348. package/dist/thread-UJ3W5LVI.mjs +31 -0
  349. package/dist/{types-B3b68nfF.d.ts → types-Ck97nB3D.d.ts} +1 -1
  350. package/dist/types-CpCg-Gq-.d.ts +227 -0
  351. package/dist/{types-Cb9kiY5P.d.ts → types-DvncmvuQ.d.ts} +12 -1
  352. package/dist/vector/search-worker.d.ts +10 -2
  353. package/dist/vector/search-worker.mjs +11 -11
  354. package/dist/worker-copies-YSXZXIGC.mjs +2232 -0
  355. package/dist/workers/entry.mjs +75 -15
  356. package/openapi.json +6840 -0
  357. package/package.json +406 -19
  358. package/dist/browser/chunk-CN4I4FZU.mjs +0 -602
  359. package/dist/browser/chunk-HOZW3PKP.mjs +0 -9
  360. package/dist/browser/chunk-JPTQZWJQ.mjs +0 -10
  361. package/dist/browser/chunk-LD55ZGU3.mjs +0 -347
  362. package/dist/browser/chunk-NAFT3K6X.mjs +0 -24546
  363. package/dist/browser/chunk-NNG3EEB6.mjs +0 -2728
  364. package/dist/browser/chunk-QWES44AW.mjs +0 -473
  365. package/dist/browser/durability-wiring-PY3L7DES.mjs +0 -3679
  366. package/dist/browser/module-PDXYHT75.mjs +0 -2822
  367. package/dist/browser/release-76MXRPGV.mjs +0 -33
  368. package/dist/browser/restore-queue-DVIYJ7RU.mjs +0 -35
  369. package/dist/browser/snapshot-J57MZK6L.mjs +0 -1207
  370. package/dist/browser/write-L7FAQA47.mjs +0 -208
  371. package/dist/chunk-37CD3OKS.mjs +0 -87
  372. package/dist/chunk-5XNIRLFC.mjs +0 -96
  373. package/dist/chunk-7X5JST5L.mjs +0 -114
  374. package/dist/chunk-AV4IJKD2.mjs +0 -35
  375. package/dist/chunk-AY3AQ3UH.mjs +0 -73
  376. package/dist/chunk-BKB3XTMI.mjs +0 -707
  377. package/dist/chunk-C7SLA6CM.mjs +0 -19
  378. package/dist/chunk-COVCQ73F.mjs +0 -587
  379. package/dist/chunk-DJHHF2L5.mjs +0 -17
  380. package/dist/chunk-E74YLAIG.mjs +0 -24
  381. package/dist/chunk-FMWRCP2C.mjs +0 -57
  382. package/dist/chunk-GES7U2PM.mjs +0 -68
  383. package/dist/chunk-HJSN7UYG.mjs +0 -10
  384. package/dist/chunk-JFRNNBOM.mjs +0 -35
  385. package/dist/chunk-K25LZA54.mjs +0 -8484
  386. package/dist/chunk-KEHK2O6P.mjs +0 -13
  387. package/dist/chunk-KOKM4PQN.mjs +0 -52
  388. package/dist/chunk-KZ3NX2P7.mjs +0 -21
  389. package/dist/chunk-L3L5YFXC.mjs +0 -614
  390. package/dist/chunk-L5ORED7V.mjs +0 -25
  391. package/dist/chunk-LH4NZNJJ.mjs +0 -1731
  392. package/dist/chunk-LU2CE5AE.mjs +0 -507
  393. package/dist/chunk-LXWDQLTW.mjs +0 -30
  394. package/dist/chunk-MHOSCQCQ.mjs +0 -948
  395. package/dist/chunk-NKRBEGJZ.mjs +0 -1705
  396. package/dist/chunk-NTRMFARG.mjs +0 -462
  397. package/dist/chunk-NW4XDSP2.mjs +0 -212
  398. package/dist/chunk-OOEXLUGR.mjs +0 -117
  399. package/dist/chunk-ORBLD3EL.mjs +0 -6
  400. package/dist/chunk-OWNZYMRE.mjs +0 -3591
  401. package/dist/chunk-PPY2GSIB.mjs +0 -44
  402. package/dist/chunk-QY7GC2MW.mjs +0 -33
  403. package/dist/chunk-R6A773WK.mjs +0 -226
  404. package/dist/chunk-R6PR4WYZ.mjs +0 -68
  405. package/dist/chunk-R7EEKAJE.mjs +0 -593
  406. package/dist/chunk-RONEOEON.mjs +0 -426
  407. package/dist/chunk-VWULPWRJ.mjs +0 -7469
  408. package/dist/chunk-WCJKUGHB.mjs +0 -262
  409. package/dist/chunk-WQBCBKY3.mjs +0 -8
  410. package/dist/chunk-X5CV2E2B.mjs +0 -1
  411. package/dist/chunk-YA7XLE2R.mjs +0 -1256
  412. package/dist/chunk-YTJCGKM4.mjs +0 -56
  413. package/dist/chunk-ZG477IPV.mjs +0 -526
  414. package/dist/chunk-ZYNAMIYX.mjs +0 -113
  415. package/dist/config-BGB_fDtq.d.ts +0 -237
  416. package/dist/direct-executor-CXZ66ACP.mjs +0 -22
  417. package/dist/durability-wiring-QTHOGFMZ.mjs +0 -3229
  418. package/dist/engine-BGCEm9E_.d.ts +0 -577
  419. package/dist/module-3NONKBZX.mjs +0 -1860
  420. package/dist/release-BH3DKW3T.mjs +0 -33
  421. package/dist/restore-queue-JPRBUYII.mjs +0 -35
  422. package/dist/runtime-ZKYZFJJC.mjs +0 -177
  423. package/dist/snapshot-HOGXNO5W.mjs +0 -793
  424. package/dist/tasks-HG3rlxx6.d.ts +0 -302
  425. package/dist/thread-B657LQXK.mjs +0 -692
  426. package/dist/write-XLIGTXBU.mjs +0 -238
@@ -1,14 +1,14 @@
1
- import { a as CreateIndexOptions, C as ClusterNamespace, b as ClusterNodeConfig } from './config-BGB_fDtq.js';
2
- export { c as ClusterControllerConfig, d as ClusterMemoryConfig, e as ClusterNodeInfo, f as ClusterQueryConfig, N as NodeReadiness, R as ReplicationConfig } from './config-BGB_fDtq.js';
3
- import { R as RerankAdapter } from './adapters-BQFQ4PRz.js';
4
- import { B as BatchResult, L as ListParams, g as ListResult, h as SuggestParams, j as SuggestResult, Q as QueryParams, P as PreflightResult, I as IndexStats, k as PartitionStatsResult, M as MemoryStats, l as NarsilEventMap, e as QueryResult } from './memory-CUEDwr-F.js';
5
- import { I as IndexConfig, A as AnyDocument, a as InsertOptions } from './schema-4W_7tk1f.js';
1
+ import { d as CreateIndexOptions, C as ClusterNamespace, e as ClusterNodeConfig } from './config-Bnl7L-0H.js';
2
+ export { B as BackupListing, f as BackupOperationOptions, g as BackupProgress, a as BackupSummary, h as ClusterBackupConfig, i as ClusterControllerConfig, c as ClusterHealth, j as ClusterHealthStatus, k as ClusterMemoryConfig, l as ClusterMetrics, b as ClusterNodeInfo, m as ClusterQueryConfig, n as CommitPointFigure, o as CoordinatorRequestFigure, p as CreateBackupOptions, D as DamagedBackup, I as IndexHealth, N as NodeReadiness, P as PartitionReplicationFigure, R as ReplicaLagFigure, q as ReplicationConfig, r as RestoreBackupOptions, V as VectorRebuildWaitFigure } from './config-Bnl7L-0H.js';
3
+ import { R as RerankAdapter } from './adapters-pljAqmrC.js';
4
+ import { g as ChangesSetting, h as ChangesStatus, F as FollowChangesOptions, d as ChangesEvent, p as SyncSetting, q as SyncStatus, B as BatchResult, L as ListParams, y as ListResult, w as SuggestParams, A as SuggestResult, Q as QueryParams, z as PreflightResult, I as IndexInfo, D as AnalysisChange, x as IndexStats, P as PartitionStatsResult, M as MemoryStats, J as NarsilEventMap, t as QueryResult, s as Narsil } from './engine-qjAxJSKk.js';
5
+ import { B as BM25Params, I as IndexConfig, A as AnyDocument, a as InsertOptions } from './schema-CzG9OUw5.js';
6
+ import { c as NodeCapacity, N as NodeRole } from './index-B_vmxpgW.js';
7
+ export { A as AllocationConstraints, e as AllocationEvent, a as AllocationTable, C as ClusterCoordinator, E as ExpectedReplicaRegistration, I as IndexMetadataEvent, f as IndexMetadataWatch, g as IndexPartitionBytes, h as NodeEvent, d as NodeMemoryReport, b as NodeRegistration, P as PartitionAssignment, i as PartitionState, R as RegistrationLease, S as SchemaEvent, U as UnassignedReason } from './index-B_vmxpgW.js';
6
8
  import { a as SynonymRule } from './synonyms-CpOAHPa-.js';
7
- import { b as NodeCapacity, N as NodeRole } from './index-lcdGLyJH.js';
8
- export { c as AllocationConstraints, d as AllocationEvent, A as AllocationTable, C as ClusterCoordinator, I as IndexPartitionBytes, e as NodeEvent, f as NodeMemoryReport, a as NodeRegistration, P as PartitionAssignment, g as PartitionState, S as SchemaEvent, U as UnassignedReason } from './index-lcdGLyJH.js';
9
- import { N as Narsil } from './engine-BGCEm9E_.js';
10
- export { L as ListenHandler, N as NodeTransport, R as RespondFn, T as TransportConfig, a as TransportMessage } from './types-Cb9kiY5P.js';
11
- import './config-P__Diiy4.js';
9
+ export { L as ListenHandler, N as NodeTransport, R as RespondFn, T as TransportConfig, a as TransportMessage } from './types-DvncmvuQ.js';
10
+ import './config-CJ-jfI0a.js';
11
+ import './query-suggestions-CBYkrQ5T.js';
12
12
 
13
13
  /**
14
14
  * The cluster splits an index into this many partitions when
@@ -18,9 +18,11 @@ import './config-P__Diiy4.js';
18
18
  */
19
19
  declare const DEFAULT_PARTITION_COUNT = 5;
20
20
  /**
21
- * The cluster keeps this many copies of each partition when
22
- * {@link CreateIndexOptions} names no factor. One copy means a lost node costs
23
- * that partition, so raise it for anything you cannot rebuild.
21
+ * The cluster keeps this many replicas of each partition, besides its
22
+ * primary, when {@link CreateIndexOptions} names no factor. One replica
23
+ * gives two copies of every partition, so the cluster keeps each partition
24
+ * through the loss of one node, and 0 leaves a partition with its primary
25
+ * alone.
24
26
  *
25
27
  * @public
26
28
  */
@@ -34,6 +36,158 @@ declare const DEFAULT_REPLICATION_FACTOR = 1;
34
36
  */
35
37
  declare const DEFAULT_CAPACITY: NodeCapacity;
36
38
 
39
+ /**
40
+ * Turns change capture on and off for an index across a cluster, follows its changes, and exports its documents.
41
+ *
42
+ * @public
43
+ */
44
+ interface ClusterNodeChanges {
45
+ /**
46
+ * Replaces the change capture setting of an index across the cluster.
47
+ *
48
+ * Turning capture on gives the index a new epoch unless device sync is on. Turning it off makes every node delete the
49
+ * history of its copies unless device sync is on, and close every change feed of the index. The node stores the
50
+ * setting in the index metadata, so every node applies it through its metadata watch.
51
+ *
52
+ * @param indexName - The index whose setting the cluster replaces.
53
+ * @param setting - The new setting.
54
+ * @throws A `NarsilError` with `CHANGES_BACKUP_STORE_REQUIRED` when the cluster has no backup store, with
55
+ * `CHANGES_DURABILITY_REQUIRED` when this node has no write-ahead log durability, with `CHANGES_NOT_READY` while a
56
+ * registered node has a specification version below 1.5, with `CONFIG_INVALID` when a field has the wrong type or a
57
+ * history limit is not a positive whole number, and with `INDEX_NOT_FOUND` when no index has that name.
58
+ */
59
+ updateChanges(indexName: string, setting: ChangesSetting): Promise<void>;
60
+ /**
61
+ * Returns the change capture state of an index, as the index metadata holds it.
62
+ *
63
+ * @param indexName - The index whose state the cluster returns.
64
+ * @returns The setting and the epoch.
65
+ * @throws A `NarsilError` with `INDEX_NOT_FOUND` when no index has that name.
66
+ */
67
+ getChanges(indexName: string): Promise<ChangesStatus>;
68
+ /**
69
+ * Returns the changes of an index above a list of positions, read from each partition's primary up to the point
70
+ * that every replica has acknowledged, and then each later change, until the signal aborts or the caller stops
71
+ * iterating.
72
+ *
73
+ * The first event gives the epoch and the positions. Each later event holds the changes of one partition in `seqNo`
74
+ * order. Where the positions no longer lead to the index's changes, the last event is a resync.
75
+ *
76
+ * @param indexName - The index whose changes the cluster returns.
77
+ * @param options - The epoch and positions to start from, a filter, and a signal.
78
+ * @returns The events, one at a time.
79
+ * @throws A `NarsilError` with `CHANGES_NOT_ENABLED` when capture is off or turns off, with `CHANGES_NOT_READY` while
80
+ * a registered node has a specification version below 1.5, with `CHANGES_INVALID_POSITIONS` for a malformed epoch or
81
+ * list of positions, with `SEARCH_INVALID_FILTER` for a filter that breaks the shape or the limits of a query's
82
+ * filters, with `SEARCH_INVALID_FIELD` for a filter that tests a field which the schema leaves out, and with
83
+ * `CHANGES_PREVIOUS_DOCUMENT_REQUIRED` for a filter while `previousDocument` is off.
84
+ */
85
+ followChanges(indexName: string, options?: FollowChangesOptions): AsyncIterable<ChangesEvent>;
86
+ /**
87
+ * Returns every document of an index with change capture on, as the newest backup of its epoch holds them, after a
88
+ * header that gives the epoch and the position of each partition at that backup.
89
+ *
90
+ * @param indexName - The index whose documents the cluster exports.
91
+ * @returns The export as a stream of JSON lines.
92
+ * @throws A `NarsilError` with `CHANGES_EXPORT_PREPARING` while the cluster takes the backup that the export needs,
93
+ * with `CHANGES_BACKUP_STORE_REQUIRED` when the cluster has no backup store, and with
94
+ * `CLUSTER_OPERATION_UNSUPPORTED` when change capture is off.
95
+ */
96
+ exportDocuments(indexName: string): Promise<ReadableStream<Uint8Array>>;
97
+ }
98
+
99
+ /**
100
+ * Changes the search settings of a live index across a cluster.
101
+ *
102
+ * @public
103
+ */
104
+ interface ClusterNodeSearchSettings {
105
+ /**
106
+ * Replaces the synonym set of an index across the cluster, so that every
107
+ * search that starts after the promise resolves expands its words with the
108
+ * new set.
109
+ *
110
+ * The node stores the set in the coordinator before it asks each node that
111
+ * holds a partition of the index to apply the set. The promise resolves
112
+ * once every one of those nodes answers. Pass an empty list to remove the
113
+ * set.
114
+ *
115
+ * @param indexName - The index whose set the cluster replaces.
116
+ * @param synonyms - The new set, in the shape that {@link SynonymRule}
117
+ * describes.
118
+ * @throws A `NarsilError` with `CONFIG_INVALID` when a rule breaks that
119
+ * shape, when a word analyses to no token or to more than one, or when the
120
+ * set passes 100,000 rules, 500,000 words, or 4,194,304 bytes of words in
121
+ * UTF-8. It throws `CLUSTER_WRITE_BLOCKED` when the index metadata changes
122
+ * between the node's read and its write on every one of its tries, and
123
+ * `QUERY_NODE_TIMEOUT` when a node holding a partition gives no answer.
124
+ * After a timeout, the coordinator keeps the new set, so a retry of the
125
+ * same call can finish applying it.
126
+ */
127
+ updateSynonyms(indexName: string, synonyms: SynonymRule[]): Promise<void>;
128
+ /**
129
+ * Returns the synonym set that the coordinator holds for an index, with
130
+ * every word as the caller wrote it, or an empty list when the index holds
131
+ * no set.
132
+ *
133
+ * @param indexName - The index whose set the node returns.
134
+ * @throws A `NarsilError` with `INDEX_NOT_FOUND` when the cluster holds no
135
+ * index under that name.
136
+ */
137
+ getSynonyms(indexName: string): Promise<SynonymRule[]>;
138
+ /**
139
+ * Replaces the BM25 setting of an index across the cluster, so that this
140
+ * node scores every search that starts after the promise resolves under the
141
+ * new setting.
142
+ *
143
+ * The call replaces the whole setting, and `{}` clears it. The promise
144
+ * resolves once the coordinator stores the setting and this node applies it.
145
+ * Every other node follows through its watch of the index metadata, so a
146
+ * search that another node coordinates can use the old setting for that
147
+ * time.
148
+ *
149
+ * @param indexName - The index whose setting the node replaces.
150
+ * @param bm25 - The new setting, in the shape that {@link BM25Params} describes.
151
+ * @throws A `NarsilError` with `CONFIG_INVALID` when a value breaks that
152
+ * shape, with `INDEX_NOT_FOUND` when the cluster holds no index under that
153
+ * name, with `BM25_NOT_READY` while a registered node has a specification
154
+ * version below 1.1, and with `CLUSTER_WRITE_BLOCKED` when other writes keep
155
+ * changing the index metadata.
156
+ */
157
+ updateBM25(indexName: string, bm25: BM25Params): Promise<void>;
158
+ }
159
+
160
+ /**
161
+ * Turns device sync on and off for an index across a cluster.
162
+ *
163
+ * @public
164
+ */
165
+ interface ClusterNodeSyncSettings {
166
+ /**
167
+ * Replaces the device sync setting of an index across the cluster.
168
+ *
169
+ * Turning sync on gives the index a new epoch. Changing a history limit while sync is on keeps the epoch. Turning
170
+ * sync off makes every node delete the history of its copies and close every feed of the index with close code
171
+ * 4410. The node stores the setting in the index metadata, so every node applies it through its metadata watch.
172
+ *
173
+ * @param indexName - The index whose setting the cluster replaces.
174
+ * @param setting - The new setting.
175
+ * @throws A `NarsilError` with `SYNC_BACKUP_STORE_REQUIRED` when the cluster has no backup store, with
176
+ * `SYNC_DURABILITY_REQUIRED` when this node has no write-ahead log durability, with `SYNC_NOT_READY` while a
177
+ * registered node has a specification version below 1.3, with `CONFIG_INVALID` when a history limit is not a
178
+ * positive whole number, and with `INDEX_NOT_FOUND` when no index has that name.
179
+ */
180
+ updateSync(indexName: string, setting: SyncSetting): Promise<void>;
181
+ /**
182
+ * Returns the device sync state of an index, as the index metadata holds it.
183
+ *
184
+ * @param indexName - The index whose state the cluster returns.
185
+ * @returns The setting, whether a device has asked for the snapshot, and the epoch.
186
+ * @throws A `NarsilError` with `INDEX_NOT_FOUND` when no index has that name.
187
+ */
188
+ getSync(indexName: string): Promise<SyncStatus>;
189
+ }
190
+
37
191
  /**
38
192
  * One node of a cluster, which routes each write to the partition's primary
39
193
  * and gathers each search from every partition.
@@ -44,7 +198,7 @@ declare const DEFAULT_CAPACITY: NodeCapacity;
44
198
  *
45
199
  * @public
46
200
  */
47
- interface ClusterNode {
201
+ interface ClusterNode extends ClusterNodeSearchSettings, ClusterNodeSyncSettings, ClusterNodeChanges {
48
202
  /** This identifies the node across the cluster. */
49
203
  readonly nodeId: string;
50
204
  /** The node holds these roles in the cluster. */
@@ -147,39 +301,6 @@ interface ClusterNode {
147
301
  * @param name - The index to drop.
148
302
  */
149
303
  dropIndex(name: string): Promise<void>;
150
- /**
151
- * Replaces the synonym set of an index across the cluster, so that every
152
- * search that starts after the promise resolves expands its words with the
153
- * new set.
154
- *
155
- * The node stores the set in the coordinator before it asks each node that
156
- * holds a partition of the index to apply the set. The promise resolves
157
- * once every one of those nodes answers. Pass an empty list to remove the
158
- * set.
159
- *
160
- * @param indexName - The index whose set the cluster replaces.
161
- * @param synonyms - The new set, in the shape that {@link SynonymRule}
162
- * describes.
163
- * @throws A `NarsilError` with `CONFIG_INVALID` when a rule breaks that
164
- * shape, when a word analyses to no token or to more than one, or when the
165
- * set passes 100,000 rules, 500,000 words, or 4,194,304 bytes of words in
166
- * UTF-8. It throws `CLUSTER_WRITE_BLOCKED` when the index metadata changes
167
- * between the node's read and its write on every one of its tries, and
168
- * `QUERY_NODE_TIMEOUT` when a node holding a partition gives no answer.
169
- * After a timeout, the coordinator keeps the new set, so a retry of the
170
- * same call can finish applying it.
171
- */
172
- updateSynonyms(indexName: string, synonyms: SynonymRule[]): Promise<void>;
173
- /**
174
- * Returns the synonym set that the coordinator holds for an index, with
175
- * every word as the caller wrote it, or an empty list when the index holds
176
- * no set.
177
- *
178
- * @param indexName - The index whose set the node returns.
179
- * @throws A `NarsilError` with `INDEX_NOT_FOUND` when the cluster holds no
180
- * index under that name.
181
- */
182
- getSynonyms(indexName: string): Promise<SynonymRule[]>;
183
304
  /**
184
305
  * Removes every document from an index across the cluster and keeps the
185
306
  * index itself, along with its schema and allocation.
@@ -236,6 +357,64 @@ interface ClusterNode {
236
357
  * @returns The match count and the time the count took.
237
358
  */
238
359
  preflight(indexName: string, params: QueryParams): Promise<PreflightResult>;
360
+ /**
361
+ * Lists every index that the cluster holds a schema for, with its document count summed over every partition, its
362
+ * partition count, and its language.
363
+ *
364
+ * The state, the reopen count, and the stale analysis flag describe this node's own copy, so an index that this node
365
+ * holds no copy of reports `open` and 0 reopens. An index that a caller drops while the listing runs drops out of it.
366
+ *
367
+ * @returns One entry per index, in the order the coordinator lists the schemas.
368
+ * @throws A `NarsilError` with `QUERY_PARTIAL_FAILURE` where no copy of some partition answers its count.
369
+ */
370
+ listIndexes(): Promise<IndexInfo[]>;
371
+ /**
372
+ * Rebuilds the terms of an index on every node that holds a copy, and resolves once every one of those nodes has
373
+ * finished.
374
+ *
375
+ * Each node rebuilds its own copies from their documents, so a primary and its replicas reach the same terms without
376
+ * sending entries, and a node skips a copy whose analysis is already current. A node that answers late keeps its
377
+ * rebuild running, and this call waits for it for as long as the node stays registered.
378
+ *
379
+ * @param indexName - The index whose terms are rebuilt.
380
+ * @throws A `NarsilError` with `INDEX_NOT_FOUND` where the cluster holds no such index, and with
381
+ * `QUERY_PARTIAL_FAILURE`, naming each node in `details.nodeIds`, where a node fails, cannot be reached, or leaves
382
+ * the cluster before it answers.
383
+ */
384
+ rebuildAnalysis(indexName: string): Promise<void>;
385
+ /**
386
+ * Gives a cluster index a new language, stop word set, or tokeniser, and resolves once the cluster publishes the new
387
+ * settings, while the index keeps answering searches under the old settings.
388
+ *
389
+ * Every node that holds a copy builds the new terms beside the old ones, and the controller finishes the change if
390
+ * this node dies. A later change replaces one that is still building, so the latest change wins.
391
+ *
392
+ * @param indexName - The index to change.
393
+ * @param change - The settings to change, each by a registered name, with `null` returning a setting to its default.
394
+ * @throws A `NarsilError` with `LANGUAGE_NOT_SUPPORTED` or `CONFIG_INVALID` for an unregistered name, with
395
+ * `ANALYSIS_CHANGE_NOT_READY` where a registered node runs an older specification version, with
396
+ * `ANALYSIS_REBUILD_MEMORY_EXCEEDED` where a node lacks the memory for a second copy of the terms, with
397
+ * `ANALYSIS_CHANGE_REPLACED` where a later change replaces this one, and with
398
+ * `PARTITION_REBALANCING_BACKPRESSURE` during a partition count change.
399
+ */
400
+ changeAnalysis(indexName: string, change: AnalysisChange): Promise<void>;
401
+ /**
402
+ * Moves an index onto a new number of partitions, and resolves once every read and write of the index goes to the new
403
+ * layout.
404
+ *
405
+ * The controller copies every document into a hidden index that has the new partition count while the current
406
+ * layout keeps serving reads and writes. Once the copy has caught up, writes to the index wait for a cutover of a few
407
+ * seconds at most, failing with `PARTITION_REBALANCING_BACKPRESSURE` until it finishes, and the index name moves onto
408
+ * the new layout in a single allocation write.
409
+ *
410
+ * @param indexName - The index whose partition count changes.
411
+ * @param targetPartitionCount - The number of partitions that the index ends up with.
412
+ * @throws A `NarsilError` with `INDEX_NOT_FOUND` where the cluster holds no such index, with `CONFIG_INVALID` for a
413
+ * count outside the allowed range or equal to the current one, with `PARTITION_REBALANCING_BACKPRESSURE` while
414
+ * another change to the same index runs, with `NODE_NOT_CONTROLLER` where no node holds the controller lease, and
415
+ * with `ALLOCATION_FAILED` where the controller aborts the change.
416
+ */
417
+ rebalance(indexName: string, targetPartitionCount: number): Promise<void>;
239
418
  /**
240
419
  * Describes one index across the cluster: its document count and memory
241
420
  * estimate summed over every partition, its partition count, its language,
@@ -345,9 +524,38 @@ interface ClusterNode {
345
524
  has(indexName: string, docId: string): Promise<boolean>;
346
525
  /** This reaches the cluster-facing side of the node. */
347
526
  cluster: ClusterNamespace;
348
- /** Joins the cluster: the node registers, takes on its allocated partitions, and starts serving. */
527
+ /**
528
+ * Joins the cluster: the node registers, takes on its allocated partitions, and starts serving.
529
+ *
530
+ * The start fails with `NODE_VERSION_INCOMPATIBLE` where the active controller follows a specification version
531
+ * with another major version, because nodes on different major versions cannot share a cluster. A node that finds
532
+ * no active controller joins, and a later controller on another major version gives it no partition.
533
+ */
349
534
  start(): Promise<void>;
350
- /** Leaves the cluster: the node hands its partitions on, deregisters, and closes the engine it ran. */
535
+ /**
536
+ * Leaves the cluster for good: the controller moves every copy that the node holds to other nodes, and the node then
537
+ * deregisters and shuts down.
538
+ *
539
+ * The node publishes its registration with `draining` set, so the controller places nothing new on it, hands each
540
+ * partition that it leads to an in-sync replica elsewhere, and moves each of its replicas by adding the new copy
541
+ * before it drops this one. The call returns once no allocation table names the node and {@link ClusterNode.shutdown}
542
+ * has finished. The drain waits for as long as the cluster has no other node that can take a copy, so pass `signal`
543
+ * to give up. An abort rejects with the signal's reason and publishes the registration without `draining`, which
544
+ * stops the drain and leaves the node in the cluster.
545
+ *
546
+ * @param options - Holds `signal`, which ends the wait and keeps the node in the cluster.
547
+ * @returns A promise that settles once the node has left the cluster and shut down.
548
+ */
549
+ decommission(options?: {
550
+ signal?: AbortSignal;
551
+ }): Promise<void>;
552
+ /**
553
+ * Leaves the cluster at once: the node deregisters and closes the engine it ran.
554
+ *
555
+ * The controller treats the node as failed, so it promotes a replica for each partition that the node led and waits
556
+ * `nodeLeftDelayMs` before it moves the node's replicas, which lets a node that restarts in place take them back.
557
+ * Call {@link ClusterNode.decommission} to move the copies off the node first.
558
+ */
351
559
  shutdown(): Promise<void>;
352
560
  }
353
561
 
@@ -359,13 +567,13 @@ interface ClusterNode {
359
567
  * answering. A node whose roles include `controller` stands for election and
360
568
  * runs allocation for the whole cluster while it holds the lease.
361
569
  *
362
- * @param config - The coordinator, the transport, this node's address, and the
570
+ * @param callerConfig - The coordinator, the transport, this node's address, and the
363
571
  * settings for the engine it runs locally.
364
572
  * @returns The node, ready for {@link ClusterNode.start}.
365
573
  *
366
574
  * @public
367
575
  */
368
- declare function createClusterNode(config: ClusterNodeConfig): Promise<ClusterNode>;
576
+ declare function createClusterNode(callerConfig: ClusterNodeConfig): Promise<ClusterNode>;
369
577
 
370
578
  /**
371
579
  * How {@link clusterNodeEngine} shapes the operations it forwards.
@@ -382,16 +590,19 @@ interface ClusterEngineOptions {
382
590
  * serves a single engine.
383
591
  *
384
592
  * Writes, updates, searches, suggestions, listings, counts, index creation,
385
- * index removal, synonym sets, and document reads route through the cluster.
593
+ * index removal, analysis rebuilds, analysis changes, synonym sets, document reads, change capture, and the
594
+ * document export of an index with change capture on route through the cluster.
386
595
  * Checkpointing, memory statistics, index opens, index closes, engine events,
387
596
  * and rerank adapter registration reach this node's local engine, because
388
597
  * each covers a per-node fact. This node reranks the searches that it
389
598
  * receives with the adapters registered on it. Every other operation fails with
390
599
  * `CLUSTER_OPERATION_UNSUPPORTED`, which the HTTP server answers with status
391
600
  * 501, so a caller learns the operation is missing rather than reading a
392
- * wrong answer. That covers `getStats`, `getPartitionStats`, and
393
- * `listIndexes` as well, because {@link Narsil} declares them synchronous and
394
- * a cluster answer needs a round trip; call them on the
601
+ * wrong answer. The HTTP server answers the index list, the index figures,
602
+ * and the partition figures from the whole cluster. The adapter's own
603
+ * `getStats`, `getPartitionStats`, and `listIndexes` still fail with
604
+ * `CLUSTER_OPERATION_UNSUPPORTED`, because {@link Narsil} declares them
605
+ * synchronous and a cluster answer needs a round trip, so call them on the
395
606
  * {@link ClusterNode} itself, where they are asynchronous.
396
607
  *
397
608
  * @param node - The cluster node the adapter serves.
@@ -403,4 +614,4 @@ interface ClusterEngineOptions {
403
614
  */
404
615
  declare function clusterNodeEngine(node: ClusterNode, options?: ClusterEngineOptions): Narsil;
405
616
 
406
- export { type ClusterEngineOptions, ClusterNamespace, type ClusterNode, ClusterNodeConfig, CreateIndexOptions, DEFAULT_CAPACITY, DEFAULT_PARTITION_COUNT, DEFAULT_REPLICATION_FACTOR, NodeCapacity, NodeRole, clusterNodeEngine, createClusterNode };
617
+ export { type ClusterEngineOptions, ClusterNamespace, type ClusterNode, type ClusterNodeChanges, ClusterNodeConfig, type ClusterNodeSearchSettings, type ClusterNodeSyncSettings, CreateIndexOptions, DEFAULT_CAPACITY, DEFAULT_PARTITION_COUNT, DEFAULT_REPLICATION_FACTOR, NodeCapacity, NodeRole, clusterNodeEngine, createClusterNode };