@delali/narsil 0.3.1-next.99 → 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.
- package/NOTICE +45 -0
- package/README.md +27 -8
- package/dist/adapters/filesystem.d.ts +1 -1
- package/dist/adapters/filesystem.mjs +101 -13
- package/dist/adapters/gcs.d.ts +49 -0
- package/dist/adapters/gcs.mjs +213 -0
- package/dist/adapters/indexeddb.d.ts +1 -1
- package/dist/adapters/indexeddb.mjs +2 -7
- package/dist/adapters/memory.d.ts +1 -1
- package/dist/adapters/memory.mjs +5 -0
- package/dist/adapters/s3.d.ts +53 -0
- package/dist/adapters/s3.mjs +263 -0
- package/dist/{adapters-BQFQ4PRz.d.ts → adapters-pljAqmrC.d.ts} +33 -0
- package/dist/browser/chunk-4E5APHTM.mjs +1459 -0
- package/dist/browser/chunk-NDYADQ4Y.mjs +23426 -0
- package/dist/browser/chunk-QAOVAYAG.mjs +564 -0
- package/dist/browser/chunk-WC2DEXWU.mjs +29 -0
- package/dist/browser/chunk-YINZFPLT.mjs +1239 -0
- package/dist/browser/chunk-YJHGOJAC.mjs +15 -0
- package/dist/browser/{chunk-Z7QH2XHB.mjs → core-leaf-HWAXCEWX.mjs} +3987 -2103
- package/dist/browser/custom-token-results-R5BIX7SL.mjs +59 -0
- package/dist/browser/digest-leaf-64IPRPZD.mjs +151 -0
- package/dist/browser/durability-config-75NSFCQN.mjs +97 -0
- package/dist/browser/embed-GG6PS3EA.mjs +264 -0
- package/dist/browser/geo-index-GNHY4PUB.mjs +1484 -0
- package/dist/browser/gzip-JF3S6PPT.mjs +31 -0
- package/dist/browser/module-ZZTNG5JZ.mjs +5762 -0
- package/dist/browser/msgpack-leaf-44XNWSSY.mjs +302 -0
- package/dist/browser/optional-reads-XMVPG6HG.mjs +3230 -0
- package/dist/browser/optional-writes-76DWMRQH.mjs +3603 -0
- package/dist/browser/phrase-module-6UGFVW5J.mjs +617 -0
- package/dist/browser/resolve-vector-text-XRR2OVHE.mjs +85 -0
- package/dist/browser/restore-queue-SG5O735W.mjs +196 -0
- package/dist/browser/{runtime-NYE5TB6O.mjs → runtime-OMKE7DF4.mjs} +83 -25
- package/dist/browser/segment-codec-leaf-A427QJUX.mjs +554 -0
- package/dist/browser/segment-merge-leaf-7BZ54JPI.mjs +1636 -0
- package/dist/browser/storage-leaf-5UTR5K7J.mjs +19829 -0
- package/dist/browser/store-leaf-3L33V35P.mjs +2070 -0
- package/dist/browser/suggestions-leaf-UBNDVKBD.mjs +1430 -0
- package/dist/browser/worker-copies-JXSGYR5X.mjs +2951 -0
- package/dist/{capabilities-BTTIs96E.d.ts → capabilities-DMte5K9_.d.ts} +162 -18
- package/dist/chunk-2AFZE7Y3.mjs +72 -0
- package/dist/chunk-2CKDCC65.mjs +47 -0
- package/dist/chunk-3ECIRFS5.mjs +61 -0
- package/dist/chunk-44W3CBNG.mjs +7 -0
- package/dist/chunk-4H4RG2FR.mjs +13 -0
- package/dist/chunk-4PY4JYMY.mjs +11 -0
- package/dist/chunk-4ZPVAHWF.mjs +1289 -0
- package/dist/chunk-5EI5CXO6.mjs +197 -0
- package/dist/chunk-5F5MXWS5.mjs +283 -0
- package/dist/{chunk-OHP7QR33.mjs → chunk-5FLRXF73.mjs} +25 -4
- package/dist/chunk-6FOENO4E.mjs +273 -0
- package/dist/chunk-6GHX35ZM.mjs +108 -0
- package/dist/chunk-6MSZ543Y.mjs +32 -0
- package/dist/chunk-6N6HHBCQ.mjs +4596 -0
- package/dist/{chunk-LXPIXDUJ.mjs → chunk-7P5YWDRQ.mjs} +403 -169
- package/dist/{chunk-TGP5M5R7.mjs → chunk-7T4LAYT4.mjs} +1 -1
- package/dist/{chunk-GGSH6KBQ.mjs → chunk-ASZLNVWW.mjs} +23 -3
- package/dist/chunk-AVBPB3MI.mjs +602 -0
- package/dist/{chunk-UCDF35PU.mjs → chunk-AVGUEEQ3.mjs} +494 -245
- package/dist/chunk-BUMREPLU.mjs +15 -0
- package/dist/chunk-BY6NALRK.mjs +31921 -0
- package/dist/chunk-C4ZMXXTL.mjs +92 -0
- package/dist/{chunk-2WYMG3OZ.mjs → chunk-C74KPRR7.mjs} +274 -19
- package/dist/{chunk-RSRVGAIQ.mjs → chunk-D456ZFPQ.mjs} +3 -2
- package/dist/chunk-DXZ6JDWG.mjs +797 -0
- package/dist/chunk-FJXJZUWF.mjs +209 -0
- package/dist/chunk-FS3HPPSC.mjs +212 -0
- package/dist/chunk-FT4KLZXW.mjs +1164 -0
- package/dist/chunk-GR5GMFJJ.mjs +104 -0
- package/dist/chunk-GXCDWLQI.mjs +193 -0
- package/dist/chunk-GXED6R3Q.mjs +271 -0
- package/dist/chunk-HLPRHOSO.mjs +17 -0
- package/dist/chunk-IL5DRCNU.mjs +3041 -0
- package/dist/{chunk-P36MUFEJ.mjs → chunk-JDDXV6UF.mjs} +2 -1
- package/dist/chunk-K5HSUPYS.mjs +11 -0
- package/dist/chunk-KYIRXTCA.mjs +100 -0
- package/dist/chunk-LFXS6OF7.mjs +289 -0
- package/dist/chunk-LNGE7SLY.mjs +151 -0
- package/dist/chunk-M2Z5WVWW.mjs +194 -0
- package/dist/{chunk-45AVKHMJ.mjs → chunk-M3B7SGJB.mjs} +63 -50
- package/dist/chunk-M3OW2XSP.mjs +40 -0
- package/dist/chunk-MFPSQZ6P.mjs +127 -0
- package/dist/chunk-MRCJBWJZ.mjs +1292 -0
- package/dist/chunk-MSIN4NM3.mjs +25 -0
- package/dist/chunk-MW3CJVGP.mjs +219 -0
- package/dist/chunk-MYM6CAVK.mjs +76 -0
- package/dist/chunk-NJJN4FMM.mjs +84 -0
- package/dist/chunk-NM7I3BM7.mjs +59 -0
- package/dist/chunk-OIJ64LGT.mjs +19 -0
- package/dist/{chunk-K7D4ZTSW.mjs → chunk-P4F4UWLC.mjs} +1 -1
- package/dist/chunk-Q2AP2FSN.mjs +15 -0
- package/dist/chunk-R2PJKSNL.mjs +54 -0
- package/dist/{chunk-HXJBSHXF.mjs → chunk-R724DJSG.mjs} +5056 -2619
- package/dist/chunk-S2POFTLN.mjs +10 -0
- package/dist/chunk-S5QMWECL.mjs +7 -0
- package/dist/chunk-SLAC5PAB.mjs +5008 -0
- package/dist/chunk-T4HMSZCX.mjs +5 -0
- package/dist/chunk-TACP6VK6.mjs +111 -0
- package/dist/chunk-TGPKS2UM.mjs +125 -0
- package/dist/chunk-TKKXPKEO.mjs +979 -0
- package/dist/chunk-V6EUBAIT.mjs +19 -0
- package/dist/chunk-XL56L4IR.mjs +228 -0
- package/dist/chunk-XQIAMDAG.mjs +3076 -0
- package/dist/chunk-YTUZ4R22.mjs +1063 -0
- package/dist/{chunk-KV3AZFT3.mjs → chunk-ZKOQR7EA.mjs} +45 -1
- package/dist/chunk-ZPJFGGGI.mjs +638 -0
- package/dist/chunk-ZXX5GZEX.mjs +17 -0
- package/dist/{client-i9eLJrw5.d.ts → client-BKqtl0_V.d.ts} +442 -22
- package/dist/client.d.ts +11 -10
- package/dist/client.mjs +8 -898
- package/dist/config-Bnl7L-0H.d.ts +608 -0
- package/dist/{config-P__Diiy4.d.ts → config-CJ-jfI0a.d.ts} +119 -9
- package/dist/core-leaf-6JVHEVFB.mjs +8 -0
- package/dist/custom-token-results-NXHBVY7U.mjs +59 -0
- package/dist/digest-leaf-KXBGKYHZ.mjs +1 -0
- package/dist/direct-executor-V3WOYU2Y.mjs +17 -0
- package/dist/distribution/coordinator/etcd.d.ts +63 -7
- package/dist/distribution/coordinator/etcd.mjs +725 -81
- package/dist/distribution/coordinator/in-memory.d.ts +3 -3
- package/dist/distribution/coordinator/in-memory.mjs +65 -10
- package/dist/distribution/transport/grpc.d.ts +2 -2
- package/dist/distribution/transport/grpc.mjs +39 -10
- package/dist/distribution/transport/in-memory.d.ts +2 -2
- package/dist/distribution/transport/in-memory.mjs +9 -6
- package/dist/distribution/transport/tcp.d.ts +2 -2
- package/dist/distribution/transport/tcp.mjs +20 -15
- package/dist/distribution.d.ts +267 -56
- package/dist/distribution.mjs +23156 -11362
- package/dist/durability-config-VWS2K24E.mjs +96 -0
- package/dist/embed-4PHHKGBK.mjs +263 -0
- package/dist/embeddings/openai.d.ts +1 -1
- package/dist/embeddings/openai.mjs +2 -2
- package/dist/{memory-CUEDwr-F.d.ts → engine-qjAxJSKk.d.ts} +2254 -1123
- package/dist/geo-index-2ZMMWWSK.mjs +1484 -0
- package/dist/gzip-2UCZW2MM.mjs +31 -0
- package/dist/{index-lcdGLyJH.d.ts → index-B_vmxpgW.d.ts} +260 -102
- package/dist/index.browser.mjs +4 -4
- package/dist/index.d.ts +2133 -57
- package/dist/index.mjs +16 -32
- package/dist/index.react-native.mjs +12 -0
- package/dist/invalidation/broadcast-channel.d.ts +1 -1
- package/dist/invalidation/filesystem.d.ts +1 -1
- package/dist/invalidation/filesystem.mjs +1 -2
- package/dist/invalidation/noop.d.ts +1 -1
- package/dist/languages/albanian.mjs +1 -1
- package/dist/languages/amharic.mjs +1 -1
- package/dist/languages/arabic.mjs +1 -1
- package/dist/languages/armenian.mjs +1 -1
- package/dist/languages/azerbaijani.mjs +1 -1
- package/dist/languages/bambara.mjs +1 -1
- package/dist/languages/basque.mjs +1 -1
- package/dist/languages/belarusian.mjs +1 -1
- package/dist/languages/bengali.mjs +1 -1
- package/dist/languages/bosnian.mjs +1 -1
- package/dist/languages/breton.mjs +1 -1
- package/dist/languages/bulgarian.mjs +1 -1
- package/dist/languages/burmese.mjs +1 -1
- package/dist/languages/catalan.mjs +1 -1
- package/dist/languages/chinese.mjs +1 -1
- package/dist/languages/croatian.mjs +1 -1
- package/dist/languages/czech.mjs +1 -1
- package/dist/languages/dagbani.mjs +1 -1
- package/dist/languages/danish.mjs +1 -1
- package/dist/languages/dutch.mjs +1 -1
- package/dist/languages/english.mjs +1 -1
- package/dist/languages/esperanto.mjs +1 -1
- package/dist/languages/estonian.mjs +1 -1
- package/dist/languages/ewe.mjs +1 -1
- package/dist/languages/faroese.mjs +1 -1
- package/dist/languages/fijian.mjs +1 -1
- package/dist/languages/finnish.mjs +1 -1
- package/dist/languages/french.mjs +1 -1
- package/dist/languages/ga.mjs +1 -1
- package/dist/languages/galician.mjs +1 -1
- package/dist/languages/georgian.mjs +1 -1
- package/dist/languages/german.mjs +1 -1
- package/dist/languages/greek.mjs +1 -1
- package/dist/languages/guarani.mjs +1 -1
- package/dist/languages/gujarati.mjs +1 -1
- package/dist/languages/haitian-creole.mjs +1 -1
- package/dist/languages/hausa.mjs +1 -1
- package/dist/languages/hawaiian.mjs +1 -1
- package/dist/languages/hebrew.mjs +1 -1
- package/dist/languages/hindi.mjs +1 -1
- package/dist/languages/hungarian.mjs +1 -1
- package/dist/languages/icelandic.mjs +1 -1
- package/dist/languages/igbo.mjs +1 -1
- package/dist/languages/indonesian.mjs +1 -1
- package/dist/languages/irish.mjs +1 -1
- package/dist/languages/italian.mjs +1 -1
- package/dist/languages/japanese.mjs +1 -1
- package/dist/languages/kannada.mjs +1 -1
- package/dist/languages/kazakh.mjs +1 -1
- package/dist/languages/khmer.mjs +1 -1
- package/dist/languages/kinyarwanda.mjs +1 -1
- package/dist/languages/kirundi.mjs +1 -1
- package/dist/languages/korean.mjs +1 -1
- package/dist/languages/kurmanji.mjs +1 -1
- package/dist/languages/kyrgyz.mjs +1 -1
- package/dist/languages/lao.mjs +1 -1
- package/dist/languages/latin.mjs +1 -1
- package/dist/languages/latvian.mjs +1 -1
- package/dist/languages/lingala.mjs +1 -1
- package/dist/languages/lithuanian.mjs +1 -1
- package/dist/languages/luxembourgish.mjs +1 -1
- package/dist/languages/macedonian.mjs +1 -1
- package/dist/languages/malagasy.mjs +1 -1
- package/dist/languages/malay.mjs +1 -1
- package/dist/languages/malayalam.mjs +1 -1
- package/dist/languages/maltese.mjs +1 -1
- package/dist/languages/maori.mjs +1 -1
- package/dist/languages/marathi.mjs +1 -1
- package/dist/languages/nepali.mjs +1 -1
- package/dist/languages/norwegian.mjs +1 -1
- package/dist/languages/oromo.mjs +1 -1
- package/dist/languages/persian.mjs +1 -1
- package/dist/languages/polish.mjs +1 -1
- package/dist/languages/portuguese.mjs +1 -1
- package/dist/languages/punjabi.mjs +1 -1
- package/dist/languages/romanian.mjs +1 -1
- package/dist/languages/russian.mjs +1 -1
- package/dist/languages/samoan.mjs +1 -1
- package/dist/languages/sanskrit.mjs +1 -1
- package/dist/languages/scottish-gaelic.mjs +1 -1
- package/dist/languages/serbian.mjs +1 -1
- package/dist/languages/shona.mjs +1 -1
- package/dist/languages/sinhala.mjs +1 -1
- package/dist/languages/slovak.mjs +1 -1
- package/dist/languages/slovenian.mjs +1 -1
- package/dist/languages/sorani.mjs +1 -1
- package/dist/languages/spanish.mjs +1 -1
- package/dist/languages/swahili.mjs +1 -1
- package/dist/languages/swedish.mjs +1 -1
- package/dist/languages/tagalog.mjs +1 -1
- package/dist/languages/tamil.mjs +1 -1
- package/dist/languages/tatar.mjs +1 -1
- package/dist/languages/telugu.mjs +1 -1
- package/dist/languages/thai.mjs +1 -1
- package/dist/languages/tibetan.mjs +1 -1
- package/dist/languages/tigrinya.mjs +1 -1
- package/dist/languages/tongan.mjs +1 -1
- package/dist/languages/turkish.mjs +1 -1
- package/dist/languages/twi.mjs +1 -1
- package/dist/languages/ukrainian.mjs +1 -1
- package/dist/languages/urdu.mjs +1 -1
- package/dist/languages/vietnamese.mjs +1 -1
- package/dist/languages/welsh.mjs +1 -1
- package/dist/languages/wolof.mjs +1 -1
- package/dist/languages/xhosa.mjs +1 -1
- package/dist/languages/yoruba.mjs +1 -1
- package/dist/languages/zulu.mjs +1 -1
- package/dist/long-query-thread-UCRK7MSI.mjs +154 -0
- package/dist/module-5ZSLUQII.mjs +3729 -0
- package/dist/msgpack-leaf-H5ZYW7S7.mjs +9 -0
- package/dist/optional-reads-5HFMF2QZ.mjs +3373 -0
- package/dist/optional-writes-4UOQKETU.mjs +247 -0
- package/dist/paged-partition-archive-BBRLZCIF.mjs +253 -0
- package/dist/partial-words.browser.mjs +1650 -0
- package/dist/partial-words.mjs +17 -11
- package/dist/{chunk-ASY5PHYI.mjs → pattern.browser.mjs} +253 -311
- package/dist/pattern.mjs +6 -7
- package/dist/persistence/durability/checkpoint-worker.d.ts +93 -25
- package/dist/persistence/durability/checkpoint-worker.mjs +51 -41
- package/dist/phrase-module-EFESWOCR.mjs +635 -0
- package/dist/query-actions-HMJUVWGT.mjs +119 -0
- package/dist/query-suggestions/merge-worker.d.ts +55 -0
- package/dist/query-suggestions/merge-worker.mjs +53 -0
- package/dist/query-suggestions-CBYkrQ5T.d.ts +311 -0
- package/dist/query-suggestions.browser.mjs +47 -0
- package/dist/query-suggestions.d.ts +20 -0
- package/dist/query-suggestions.mjs +19 -0
- package/dist/react-native/chunks/chunk-3OEFSHVV.mjs +970 -0
- package/dist/{browser/chunk-RELZRJNR.mjs → react-native/chunks/chunk-43R4GCM7.mjs} +49 -50
- package/dist/react-native/chunks/chunk-AKRYHAVG.mjs +6729 -0
- package/dist/react-native/chunks/chunk-CW2ZFXSE.mjs +14 -0
- package/dist/react-native/chunks/chunk-G3WCDTOF.mjs +29640 -0
- package/dist/react-native/chunks/chunk-GXXHHA2T.mjs +212 -0
- package/dist/react-native/chunks/chunk-H3MDVPBO.mjs +151 -0
- package/dist/react-native/chunks/chunk-HQEVQEDJ.mjs +52 -0
- package/dist/react-native/chunks/chunk-HRDMIQ63.mjs +131 -0
- package/dist/react-native/chunks/chunk-HTBY4GON.mjs +565 -0
- package/dist/react-native/chunks/chunk-LX62Y4B5.mjs +61 -0
- package/dist/react-native/chunks/chunk-MRH36RN3.mjs +902 -0
- package/dist/react-native/chunks/chunk-Q32DDFKX.mjs +19 -0
- package/dist/react-native/chunks/chunk-UE4ANHSX.mjs +127 -0
- package/dist/react-native/chunks/chunk-UNZPWLVL.mjs +1063 -0
- package/dist/react-native/chunks/chunk-UO44MA5M.mjs +232 -0
- package/dist/react-native/chunks/chunk-UYKIV2KT.mjs +42 -0
- package/dist/react-native/chunks/chunk-VUJCSQG5.mjs +11 -0
- package/dist/react-native/chunks/chunk-WVHF4ZAK.mjs +802 -0
- package/dist/react-native/chunks/chunk-ZUJCUPVS.mjs +54 -0
- package/dist/react-native/chunks/core-leaf-S2KNBWDY.mjs +7 -0
- package/dist/react-native/chunks/custom-token-results-3OZEMRE7.mjs +59 -0
- package/dist/react-native/chunks/digest-leaf-X6OIFDIU.mjs +1 -0
- package/dist/react-native/chunks/durability-config-FCSD4MXY.mjs +96 -0
- package/dist/react-native/chunks/embed-HA2I7RCF.mjs +263 -0
- package/dist/react-native/chunks/geo-index-QEYKEVPH.mjs +1484 -0
- package/dist/react-native/chunks/gzip.react-native-CVM4NQG2.mjs +12 -0
- package/dist/react-native/chunks/module-FMBX75GP.mjs +5209 -0
- package/dist/react-native/chunks/msgpack-leaf-JMNGSTRW.mjs +7 -0
- package/dist/react-native/chunks/optional-reads-AFPO2FEB.mjs +3364 -0
- package/dist/react-native/chunks/optional-writes-XOH25XZI.mjs +296 -0
- package/dist/react-native/chunks/phrase-module-IGYBK7XH.mjs +636 -0
- package/dist/react-native/chunks/replace-IMZUVUOE.mjs +57 -0
- package/dist/react-native/chunks/resolve-vector-text-GE2CRJKI.mjs +84 -0
- package/dist/react-native/chunks/restore-queue-LLNMYB4Z.mjs +187 -0
- package/dist/react-native/chunks/runtime-UOHD2XUJ.mjs +615 -0
- package/dist/react-native/chunks/segment-codec-leaf-VR6O5GLC.mjs +13 -0
- package/dist/react-native/chunks/segment-merge-leaf-LLMWU4EW.mjs +14 -0
- package/dist/react-native/chunks/storage-leaf-JD7PIDO4.mjs +19633 -0
- package/dist/react-native/chunks/store-leaf-4UVCMYGN.mjs +15 -0
- package/dist/react-native/chunks/suggestions-leaf-J5VT5RHY.mjs +1321 -0
- package/dist/react-native/chunks/worker-copies-ZYHY7FKJ.mjs +2831 -0
- package/dist/react-native/partial-words.mjs +1658 -0
- package/dist/react-native/pattern.mjs +2570 -0
- package/dist/react-native/query-suggestions.mjs +55 -0
- package/dist/react-native/sync.mjs +2759 -0
- package/dist/react-native/synonyms.mjs +676 -0
- package/dist/react.d.ts +12 -8
- package/dist/react.mjs +45 -1
- package/dist/{rerank-NWTKK636.mjs → rerank-RI2PMNOD.mjs} +22 -12
- package/dist/rerankers/http.d.ts +1 -1
- package/dist/rerankers/http.mjs +2 -2
- package/dist/resolve-vector-text-OD4J3WHF.mjs +3 -0
- package/dist/restore-queue-PCKWDAKQ.mjs +192 -0
- package/dist/runtime-USQYKN3I.mjs +615 -0
- package/dist/{schema-4W_7tk1f.d.ts → schema-CzG9OUw5.d.ts} +70 -30
- package/dist/segment-codec-leaf-QJM7I6QG.mjs +18 -0
- package/dist/segment-merge-leaf-4BJGIJHY.mjs +18 -0
- package/dist/server.d.ts +348 -22
- package/dist/server.mjs +2211 -327
- package/dist/storage-leaf-GRRRI7UV.mjs +5962 -0
- package/dist/store-leaf-6VMMSVBE.mjs +20 -0
- package/dist/stored-values-BWIMpiT_.d.ts +25 -0
- package/dist/suggestions-leaf-4KPTMPTL.mjs +54 -0
- package/dist/sync/filesystem.d.ts +30 -0
- package/dist/sync/filesystem.mjs +288 -0
- package/dist/sync/indexeddb.browser.mjs +287 -0
- package/dist/sync/indexeddb.d.ts +30 -0
- package/dist/sync/indexeddb.mjs +242 -0
- package/dist/sync.browser.mjs +1271 -0
- package/dist/sync.d.ts +23 -0
- package/dist/sync.mjs +2712 -0
- package/dist/synonyms.browser.mjs +658 -0
- package/dist/synonyms.mjs +17 -7
- package/dist/tasks-65b6t6lk.d.ts +782 -0
- package/dist/thread-UJ3W5LVI.mjs +31 -0
- package/dist/{types-B3b68nfF.d.ts → types-Ck97nB3D.d.ts} +1 -1
- package/dist/types-CpCg-Gq-.d.ts +227 -0
- package/dist/{types-Cb9kiY5P.d.ts → types-DvncmvuQ.d.ts} +12 -1
- package/dist/vector/search-worker.d.ts +10 -2
- package/dist/vector/search-worker.mjs +11 -11
- package/dist/worker-copies-YSXZXIGC.mjs +2232 -0
- package/dist/workers/entry.mjs +75 -15
- package/openapi.json +6840 -0
- package/package.json +406 -19
- package/dist/browser/chunk-CN4I4FZU.mjs +0 -602
- package/dist/browser/chunk-HOZW3PKP.mjs +0 -9
- package/dist/browser/chunk-JPTQZWJQ.mjs +0 -10
- package/dist/browser/chunk-LD55ZGU3.mjs +0 -347
- package/dist/browser/chunk-NAFT3K6X.mjs +0 -24546
- package/dist/browser/chunk-NNG3EEB6.mjs +0 -2728
- package/dist/browser/chunk-QWES44AW.mjs +0 -473
- package/dist/browser/durability-wiring-PY3L7DES.mjs +0 -3679
- package/dist/browser/module-PDXYHT75.mjs +0 -2822
- package/dist/browser/release-76MXRPGV.mjs +0 -33
- package/dist/browser/restore-queue-DVIYJ7RU.mjs +0 -35
- package/dist/browser/snapshot-J57MZK6L.mjs +0 -1207
- package/dist/browser/write-L7FAQA47.mjs +0 -208
- package/dist/chunk-37CD3OKS.mjs +0 -87
- package/dist/chunk-5XNIRLFC.mjs +0 -96
- package/dist/chunk-7X5JST5L.mjs +0 -114
- package/dist/chunk-AV4IJKD2.mjs +0 -35
- package/dist/chunk-AY3AQ3UH.mjs +0 -73
- package/dist/chunk-BKB3XTMI.mjs +0 -707
- package/dist/chunk-C7SLA6CM.mjs +0 -19
- package/dist/chunk-COVCQ73F.mjs +0 -587
- package/dist/chunk-DJHHF2L5.mjs +0 -17
- package/dist/chunk-E74YLAIG.mjs +0 -24
- package/dist/chunk-FMWRCP2C.mjs +0 -57
- package/dist/chunk-GES7U2PM.mjs +0 -68
- package/dist/chunk-HJSN7UYG.mjs +0 -10
- package/dist/chunk-JFRNNBOM.mjs +0 -35
- package/dist/chunk-K25LZA54.mjs +0 -8484
- package/dist/chunk-KEHK2O6P.mjs +0 -13
- package/dist/chunk-KOKM4PQN.mjs +0 -52
- package/dist/chunk-KZ3NX2P7.mjs +0 -21
- package/dist/chunk-L3L5YFXC.mjs +0 -614
- package/dist/chunk-L5ORED7V.mjs +0 -25
- package/dist/chunk-LH4NZNJJ.mjs +0 -1731
- package/dist/chunk-LU2CE5AE.mjs +0 -507
- package/dist/chunk-LXWDQLTW.mjs +0 -30
- package/dist/chunk-MHOSCQCQ.mjs +0 -948
- package/dist/chunk-NKRBEGJZ.mjs +0 -1705
- package/dist/chunk-NTRMFARG.mjs +0 -462
- package/dist/chunk-NW4XDSP2.mjs +0 -212
- package/dist/chunk-OOEXLUGR.mjs +0 -117
- package/dist/chunk-ORBLD3EL.mjs +0 -6
- package/dist/chunk-OWNZYMRE.mjs +0 -3591
- package/dist/chunk-PPY2GSIB.mjs +0 -44
- package/dist/chunk-QY7GC2MW.mjs +0 -33
- package/dist/chunk-R6A773WK.mjs +0 -226
- package/dist/chunk-R6PR4WYZ.mjs +0 -68
- package/dist/chunk-R7EEKAJE.mjs +0 -593
- package/dist/chunk-RONEOEON.mjs +0 -426
- package/dist/chunk-VWULPWRJ.mjs +0 -7469
- package/dist/chunk-WCJKUGHB.mjs +0 -262
- package/dist/chunk-WQBCBKY3.mjs +0 -8
- package/dist/chunk-X5CV2E2B.mjs +0 -1
- package/dist/chunk-YA7XLE2R.mjs +0 -1256
- package/dist/chunk-YTJCGKM4.mjs +0 -56
- package/dist/chunk-ZG477IPV.mjs +0 -526
- package/dist/chunk-ZYNAMIYX.mjs +0 -113
- package/dist/config-BGB_fDtq.d.ts +0 -237
- package/dist/direct-executor-CXZ66ACP.mjs +0 -22
- package/dist/durability-wiring-QTHOGFMZ.mjs +0 -3229
- package/dist/engine-BGCEm9E_.d.ts +0 -577
- package/dist/module-3NONKBZX.mjs +0 -1860
- package/dist/release-BH3DKW3T.mjs +0 -33
- package/dist/restore-queue-JPRBUYII.mjs +0 -35
- package/dist/runtime-ZKYZFJJC.mjs +0 -177
- package/dist/snapshot-HOGXNO5W.mjs +0 -793
- package/dist/tasks-HG3rlxx6.d.ts +0 -302
- package/dist/thread-B657LQXK.mjs +0 -692
- package/dist/write-XLIGTXBU.mjs +0 -238
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import { P as PersistenceAdapter } from '../adapters-pljAqmrC.js';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* The access keys {@link createS3Persistence} signs its requests with.
|
|
5
|
+
*
|
|
6
|
+
* @public
|
|
7
|
+
*/
|
|
8
|
+
interface S3Credentials {
|
|
9
|
+
/** The access key ID. */
|
|
10
|
+
accessKeyId: string;
|
|
11
|
+
/** The secret access key. */
|
|
12
|
+
secretAccessKey: string;
|
|
13
|
+
/** The session token of temporary credentials, which long-lived keys leave out. */
|
|
14
|
+
sessionToken?: string;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Where {@link createS3Persistence} stores its objects, and how it reaches the store.
|
|
18
|
+
*
|
|
19
|
+
* @public
|
|
20
|
+
*/
|
|
21
|
+
interface S3PersistenceConfig {
|
|
22
|
+
/** The adapter writes every object to this bucket. */
|
|
23
|
+
bucket: string;
|
|
24
|
+
/** The bucket's region, which the SDK otherwise reads from the environment. */
|
|
25
|
+
region?: string;
|
|
26
|
+
/** The address of an S3-compatible service, which you leave out for Amazon S3 itself. */
|
|
27
|
+
endpoint?: string;
|
|
28
|
+
/** Puts the bucket name in the path of each request, which most S3-compatible services need. */
|
|
29
|
+
forcePathStyle?: boolean;
|
|
30
|
+
/** The keys to sign with, which the SDK otherwise reads from its default credential chain. */
|
|
31
|
+
credentials?: S3Credentials;
|
|
32
|
+
/** The adapter stores every key under this prefix inside the bucket, so several stores can share one bucket. */
|
|
33
|
+
keyPrefix?: string;
|
|
34
|
+
/** The SDK tries each request this many times before it reports the failure. */
|
|
35
|
+
maxAttempts?: number;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Builds a persistence adapter that stores each key as one object in an S3 bucket, or in any service that speaks
|
|
39
|
+
* the S3 protocol.
|
|
40
|
+
*
|
|
41
|
+
* Cluster backups use it as the store outside the cluster. The adapter loads `@aws-sdk/client-s3`, an optional
|
|
42
|
+
* peer dependency, when you call this function, and it refuses to load an object larger than one stored file can be.
|
|
43
|
+
*
|
|
44
|
+
* @param config - The bucket, the region or endpoint, and the credentials.
|
|
45
|
+
* @returns An adapter you pass wherever Narsil takes a {@link PersistenceAdapter}.
|
|
46
|
+
* @throws A `NarsilError` with `PERSISTENCE_DEPENDENCY_MISSING` and the install command when the SDK is missing, and
|
|
47
|
+
* with `CONFIG_INVALID` when the bucket name is empty.
|
|
48
|
+
*
|
|
49
|
+
* @public
|
|
50
|
+
*/
|
|
51
|
+
declare function createS3Persistence(config: S3PersistenceConfig): Promise<PersistenceAdapter>;
|
|
52
|
+
|
|
53
|
+
export { type S3Credentials, type S3PersistenceConfig, createS3Persistence };
|
|
@@ -0,0 +1,263 @@
|
|
|
1
|
+
import { requireBucket, objectKeyPrefix, objectStoreFailure, requireObjectKey, refuseOversizedObject, requireStreamLength, countedChunks, readWhole, partsOf } from '../chunk-GR5GMFJJ.mjs';
|
|
2
|
+
import '../chunk-4PY4JYMY.mjs';
|
|
3
|
+
import { OBJECT_STORE_LIST_PAGE_KEYS, OBJECT_STORE_CONFLICT_ATTEMPTS, OBJECT_STORE_CONFLICT_RETRY_MS, OBJECT_STORE_PART_BYTES } from '../chunk-K5HSUPYS.mjs';
|
|
4
|
+
import { ErrorCodes, NarsilError } from '../chunk-ZKOQR7EA.mjs';
|
|
5
|
+
|
|
6
|
+
// src/persistence/s3.ts
|
|
7
|
+
var S3_NOT_FOUND_STATUS = 404;
|
|
8
|
+
var S3_PRECONDITION_FAILED_STATUS = 412;
|
|
9
|
+
var S3_CONFLICT_STATUS = 409;
|
|
10
|
+
async function loadS3Module() {
|
|
11
|
+
try {
|
|
12
|
+
return await import('@aws-sdk/client-s3');
|
|
13
|
+
} catch (err) {
|
|
14
|
+
throw new NarsilError(
|
|
15
|
+
ErrorCodes.PERSISTENCE_DEPENDENCY_MISSING,
|
|
16
|
+
"The `@aws-sdk/client-s3` package is not installed. Install it with `pnpm add @aws-sdk/client-s3` (or the npm or yarn equivalent) to use createS3Persistence.",
|
|
17
|
+
{ cause: err instanceof Error ? err.message : String(err) }
|
|
18
|
+
);
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
function isNotFound(error) {
|
|
22
|
+
if (typeof error !== "object" || error === null) return false;
|
|
23
|
+
const named = error;
|
|
24
|
+
return named.name === "NoSuchKey" || named.name === "NotFound" || named.$metadata?.httpStatusCode === S3_NOT_FOUND_STATUS;
|
|
25
|
+
}
|
|
26
|
+
function statusCodeOf(error) {
|
|
27
|
+
if (typeof error !== "object" || error === null) return void 0;
|
|
28
|
+
return error.$metadata?.httpStatusCode;
|
|
29
|
+
}
|
|
30
|
+
function isPreconditionFailed(error) {
|
|
31
|
+
return statusCodeOf(error) === S3_PRECONDITION_FAILED_STATUS;
|
|
32
|
+
}
|
|
33
|
+
function discardBody(body) {
|
|
34
|
+
if (typeof body === "object" && body !== null && "destroy" in body && typeof body.destroy === "function") {
|
|
35
|
+
body.destroy();
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
async function uploadParts(target, parts, first) {
|
|
39
|
+
const { sdk, client, bucket, objectKey } = target;
|
|
40
|
+
const created = await client.send(new sdk.CreateMultipartUploadCommand({ Bucket: bucket, Key: objectKey }));
|
|
41
|
+
const uploadId = created.UploadId;
|
|
42
|
+
if (uploadId === void 0) {
|
|
43
|
+
throw new NarsilError(
|
|
44
|
+
ErrorCodes.PERSISTENCE_SAVE_FAILED,
|
|
45
|
+
`The object store started a multipart upload of "${objectKey}" without an upload ID`,
|
|
46
|
+
{ key: objectKey }
|
|
47
|
+
);
|
|
48
|
+
}
|
|
49
|
+
try {
|
|
50
|
+
const completed = [];
|
|
51
|
+
let part = first;
|
|
52
|
+
while (part !== void 0) {
|
|
53
|
+
const PartNumber = completed.length + 1;
|
|
54
|
+
const sent = await client.send(
|
|
55
|
+
new sdk.UploadPartCommand({
|
|
56
|
+
Bucket: bucket,
|
|
57
|
+
Key: objectKey,
|
|
58
|
+
UploadId: uploadId,
|
|
59
|
+
PartNumber,
|
|
60
|
+
Body: part,
|
|
61
|
+
ContentLength: part.byteLength
|
|
62
|
+
})
|
|
63
|
+
);
|
|
64
|
+
completed.push({ ETag: sent.ETag, PartNumber });
|
|
65
|
+
const next = await parts.next();
|
|
66
|
+
part = next.done === true ? void 0 : next.value;
|
|
67
|
+
}
|
|
68
|
+
await client.send(
|
|
69
|
+
new sdk.CompleteMultipartUploadCommand({
|
|
70
|
+
Bucket: bucket,
|
|
71
|
+
Key: objectKey,
|
|
72
|
+
UploadId: uploadId,
|
|
73
|
+
MultipartUpload: { Parts: completed }
|
|
74
|
+
})
|
|
75
|
+
);
|
|
76
|
+
} catch (error) {
|
|
77
|
+
await client.send(new sdk.AbortMultipartUploadCommand({ Bucket: bucket, Key: objectKey, UploadId: uploadId })).catch(() => void 0);
|
|
78
|
+
throw error;
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
async function saveObjectStream(target, key, data, length) {
|
|
82
|
+
requireStreamLength(key, length);
|
|
83
|
+
const counted = countedChunks(key, data, length);
|
|
84
|
+
if (length <= OBJECT_STORE_PART_BYTES) {
|
|
85
|
+
const body = await readWhole(counted, length);
|
|
86
|
+
await target.client.send(
|
|
87
|
+
new target.sdk.PutObjectCommand({
|
|
88
|
+
Bucket: target.bucket,
|
|
89
|
+
Key: target.objectKey,
|
|
90
|
+
Body: body,
|
|
91
|
+
ContentLength: length
|
|
92
|
+
})
|
|
93
|
+
);
|
|
94
|
+
return;
|
|
95
|
+
}
|
|
96
|
+
const parts = partsOf(counted, OBJECT_STORE_PART_BYTES)[Symbol.asyncIterator]();
|
|
97
|
+
const first = await parts.next();
|
|
98
|
+
if (first.done === true) {
|
|
99
|
+
throw new NarsilError(ErrorCodes.PERSISTENCE_SAVE_FAILED, `The stream for "${key}" ended before its first part`, {
|
|
100
|
+
key
|
|
101
|
+
});
|
|
102
|
+
}
|
|
103
|
+
await uploadParts(target, parts, first.value);
|
|
104
|
+
}
|
|
105
|
+
async function* bodyChunks(body) {
|
|
106
|
+
const reader = body.transformToWebStream().getReader();
|
|
107
|
+
try {
|
|
108
|
+
for (; ; ) {
|
|
109
|
+
const step = await reader.read();
|
|
110
|
+
if (step.done) return;
|
|
111
|
+
yield step.value;
|
|
112
|
+
}
|
|
113
|
+
} finally {
|
|
114
|
+
await reader.cancel().catch(() => void 0);
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
async function* failingAs(key, chunks) {
|
|
118
|
+
try {
|
|
119
|
+
yield* chunks;
|
|
120
|
+
} catch (error) {
|
|
121
|
+
throw objectStoreFailure(ErrorCodes.PERSISTENCE_LOAD_FAILED, "load", key, error);
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
async function createS3Persistence(config) {
|
|
125
|
+
const bucket = requireBucket(config.bucket, "S3");
|
|
126
|
+
const root = objectKeyPrefix(config.keyPrefix, "S3");
|
|
127
|
+
const sdk = await loadS3Module();
|
|
128
|
+
const client = new sdk.S3Client({
|
|
129
|
+
...config.region === void 0 ? {} : { region: config.region },
|
|
130
|
+
...config.endpoint === void 0 ? {} : { endpoint: config.endpoint },
|
|
131
|
+
...config.forcePathStyle === void 0 ? {} : { forcePathStyle: config.forcePathStyle },
|
|
132
|
+
...config.credentials === void 0 ? {} : { credentials: config.credentials },
|
|
133
|
+
...config.maxAttempts === void 0 ? {} : { maxAttempts: config.maxAttempts }
|
|
134
|
+
});
|
|
135
|
+
return {
|
|
136
|
+
async save(key, data) {
|
|
137
|
+
requireObjectKey(key);
|
|
138
|
+
try {
|
|
139
|
+
await client.send(
|
|
140
|
+
new sdk.PutObjectCommand({
|
|
141
|
+
Bucket: bucket,
|
|
142
|
+
Key: `${root}${key}`,
|
|
143
|
+
Body: data,
|
|
144
|
+
ContentLength: data.byteLength
|
|
145
|
+
})
|
|
146
|
+
);
|
|
147
|
+
} catch (error) {
|
|
148
|
+
throw objectStoreFailure(ErrorCodes.PERSISTENCE_SAVE_FAILED, "save", key, error);
|
|
149
|
+
}
|
|
150
|
+
},
|
|
151
|
+
async saveIfAbsent(key, data) {
|
|
152
|
+
requireObjectKey(key);
|
|
153
|
+
for (let attempt = 1; ; attempt++) {
|
|
154
|
+
try {
|
|
155
|
+
await client.send(
|
|
156
|
+
new sdk.PutObjectCommand({
|
|
157
|
+
Bucket: bucket,
|
|
158
|
+
Key: `${root}${key}`,
|
|
159
|
+
Body: data,
|
|
160
|
+
ContentLength: data.byteLength,
|
|
161
|
+
IfNoneMatch: "*"
|
|
162
|
+
})
|
|
163
|
+
);
|
|
164
|
+
return true;
|
|
165
|
+
} catch (error) {
|
|
166
|
+
if (isPreconditionFailed(error)) return false;
|
|
167
|
+
if (statusCodeOf(error) !== S3_CONFLICT_STATUS || attempt >= OBJECT_STORE_CONFLICT_ATTEMPTS) {
|
|
168
|
+
throw objectStoreFailure(ErrorCodes.PERSISTENCE_SAVE_FAILED, "save", key, error);
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
await new Promise((resolve) => setTimeout(resolve, OBJECT_STORE_CONFLICT_RETRY_MS * attempt));
|
|
172
|
+
}
|
|
173
|
+
},
|
|
174
|
+
async load(key) {
|
|
175
|
+
requireObjectKey(key);
|
|
176
|
+
try {
|
|
177
|
+
const object = await client.send(new sdk.GetObjectCommand({ Bucket: bucket, Key: `${root}${key}` }));
|
|
178
|
+
try {
|
|
179
|
+
refuseOversizedObject(key, object.ContentLength ?? 0);
|
|
180
|
+
} catch (error) {
|
|
181
|
+
discardBody(object.Body);
|
|
182
|
+
throw error;
|
|
183
|
+
}
|
|
184
|
+
if (object.Body === void 0) return new Uint8Array(0);
|
|
185
|
+
const bytes = await object.Body.transformToByteArray();
|
|
186
|
+
refuseOversizedObject(key, bytes.byteLength);
|
|
187
|
+
return bytes;
|
|
188
|
+
} catch (error) {
|
|
189
|
+
if (isNotFound(error)) return null;
|
|
190
|
+
throw objectStoreFailure(ErrorCodes.PERSISTENCE_LOAD_FAILED, "load", key, error);
|
|
191
|
+
}
|
|
192
|
+
},
|
|
193
|
+
async saveStream(key, data, length) {
|
|
194
|
+
requireObjectKey(key);
|
|
195
|
+
try {
|
|
196
|
+
await saveObjectStream({ sdk, client, bucket, objectKey: `${root}${key}` }, key, data, length);
|
|
197
|
+
} catch (error) {
|
|
198
|
+
throw objectStoreFailure(ErrorCodes.PERSISTENCE_SAVE_FAILED, "save", key, error);
|
|
199
|
+
}
|
|
200
|
+
},
|
|
201
|
+
async loadStream(key) {
|
|
202
|
+
requireObjectKey(key);
|
|
203
|
+
try {
|
|
204
|
+
const object = await client.send(new sdk.GetObjectCommand({ Bucket: bucket, Key: `${root}${key}` }));
|
|
205
|
+
try {
|
|
206
|
+
refuseOversizedObject(key, object.ContentLength ?? 0);
|
|
207
|
+
} catch (error) {
|
|
208
|
+
discardBody(object.Body);
|
|
209
|
+
throw error;
|
|
210
|
+
}
|
|
211
|
+
const body = object.Body;
|
|
212
|
+
if (body === void 0) return failingAs(key, []);
|
|
213
|
+
return failingAs(key, bodyChunks(body));
|
|
214
|
+
} catch (error) {
|
|
215
|
+
if (isNotFound(error)) return null;
|
|
216
|
+
throw objectStoreFailure(ErrorCodes.PERSISTENCE_LOAD_FAILED, "load", key, error);
|
|
217
|
+
}
|
|
218
|
+
},
|
|
219
|
+
async delete(key) {
|
|
220
|
+
requireObjectKey(key);
|
|
221
|
+
const objectKey = `${root}${key}`;
|
|
222
|
+
try {
|
|
223
|
+
const head = await client.send(new sdk.HeadObjectCommand({ Bucket: bucket, Key: objectKey }));
|
|
224
|
+
if (head.ETag === void 0) {
|
|
225
|
+
throw new NarsilError(
|
|
226
|
+
ErrorCodes.PERSISTENCE_DELETE_FAILED,
|
|
227
|
+
`The store reported no ETag for "${key}", so the adapter deletes nothing`,
|
|
228
|
+
{ key }
|
|
229
|
+
);
|
|
230
|
+
}
|
|
231
|
+
await client.send(new sdk.DeleteObjectCommand({ Bucket: bucket, Key: objectKey, IfMatch: head.ETag }));
|
|
232
|
+
} catch (error) {
|
|
233
|
+
if (isNotFound(error) || isPreconditionFailed(error)) return;
|
|
234
|
+
throw objectStoreFailure(ErrorCodes.PERSISTENCE_DELETE_FAILED, "delete", key, error);
|
|
235
|
+
}
|
|
236
|
+
},
|
|
237
|
+
async list(prefix) {
|
|
238
|
+
const keys = [];
|
|
239
|
+
let continuationToken;
|
|
240
|
+
try {
|
|
241
|
+
do {
|
|
242
|
+
const page = await client.send(
|
|
243
|
+
new sdk.ListObjectsV2Command({
|
|
244
|
+
Bucket: bucket,
|
|
245
|
+
Prefix: `${root}${prefix}`,
|
|
246
|
+
MaxKeys: OBJECT_STORE_LIST_PAGE_KEYS,
|
|
247
|
+
...continuationToken === void 0 ? {} : { ContinuationToken: continuationToken }
|
|
248
|
+
})
|
|
249
|
+
);
|
|
250
|
+
for (const object of page.Contents ?? []) {
|
|
251
|
+
if (object.Key?.startsWith(root) === true) keys.push(object.Key.slice(root.length));
|
|
252
|
+
}
|
|
253
|
+
continuationToken = page.IsTruncated === true ? page.NextContinuationToken : void 0;
|
|
254
|
+
} while (continuationToken !== void 0);
|
|
255
|
+
} catch (error) {
|
|
256
|
+
throw objectStoreFailure(ErrorCodes.PERSISTENCE_LOAD_FAILED, "list the keys under", prefix, error);
|
|
257
|
+
}
|
|
258
|
+
return keys;
|
|
259
|
+
}
|
|
260
|
+
};
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
export { createS3Persistence };
|
|
@@ -36,6 +36,39 @@ interface PersistenceAdapter {
|
|
|
36
36
|
* @returns Every matching key, in any order.
|
|
37
37
|
*/
|
|
38
38
|
list(prefix: string): Promise<string[]>;
|
|
39
|
+
/**
|
|
40
|
+
* Writes the bytes that `data` yields under `key` without holding the whole file in memory, replacing whatever the
|
|
41
|
+
* key held. A failed or short stream leaves the previous value in place. Offer it for a store that holds large
|
|
42
|
+
* files, because a cluster backup streams each file through it.
|
|
43
|
+
*
|
|
44
|
+
* @param key - The key that a later {@link PersistenceAdapter.load} reads.
|
|
45
|
+
* @param data - The bytes to store, in order.
|
|
46
|
+
* @param length - The number of bytes that `data` yields.
|
|
47
|
+
* @throws A `NarsilError` with `PERSISTENCE_SAVE_FAILED` when `data` yields more or fewer than `length` bytes, or
|
|
48
|
+
* when the store refuses the write.
|
|
49
|
+
*/
|
|
50
|
+
saveStream?(key: string, data: AsyncIterable<Uint8Array>, length: number): Promise<void>;
|
|
51
|
+
/**
|
|
52
|
+
* Reads the bytes stored under `key` in order, without holding the whole file in memory.
|
|
53
|
+
*
|
|
54
|
+
* @param key - The key that a matching save wrote.
|
|
55
|
+
* @returns The stored bytes in chunks, or `null` when the key holds nothing.
|
|
56
|
+
* @throws A `NarsilError` with `PERSISTENCE_LOAD_FAILED` when the store fails the read.
|
|
57
|
+
*/
|
|
58
|
+
loadStream?(key: string): Promise<AsyncIterable<Uint8Array> | null>;
|
|
59
|
+
/**
|
|
60
|
+
* Stores `data` under `key` only where the key holds nothing, as one atomic step, so that where several calls race on
|
|
61
|
+
* an absent key, exactly one returns `true`. A cluster backup store must offer it, because the cluster claims its key
|
|
62
|
+
* prefix with it.
|
|
63
|
+
*
|
|
64
|
+
* @param key - The key to fill.
|
|
65
|
+
* @param data - The bytes to store.
|
|
66
|
+
* @returns `true` where this call stored `data`, and `false` where the key already held a value. A retry after a lost
|
|
67
|
+
* response can return `false` for bytes that the earlier attempt stored, so load the key and compare where you need to
|
|
68
|
+
* know whose bytes it holds.
|
|
69
|
+
* @throws A `NarsilError` with `PERSISTENCE_SAVE_FAILED` when the store refuses the write.
|
|
70
|
+
*/
|
|
71
|
+
saveIfAbsent?(key: string, data: Uint8Array): Promise<boolean>;
|
|
39
72
|
/** This adapter writes to this directory, when a filesystem backs it. */
|
|
40
73
|
readonly directory?: string;
|
|
41
74
|
}
|