@delali/narsil 0.4.5 → 0.4.6-next.333

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 (131) hide show
  1. package/README.md +1 -1
  2. package/dist/browser/{chunk-VAPCFSMX.mjs → chunk-3PGIOK7Z.mjs} +16 -1
  3. package/dist/browser/{chunk-263ERYKA.mjs → chunk-75MBWQFW.mjs} +71 -27
  4. package/dist/browser/{chunk-VIVG3OXM.mjs → chunk-FBDTHGDR.mjs} +7 -3
  5. package/dist/browser/{chunk-56UNHLAF.mjs → chunk-HIC42RBU.mjs} +1 -1
  6. package/dist/browser/{optional-reads-NQO5DKM4.mjs → optional-reads-4O4CJ7TR.mjs} +1 -1
  7. package/dist/browser/{runtime-OMKE7DF4.mjs → runtime-AMEB4J2D.mjs} +2 -1
  8. package/dist/browser/{segment-codec-leaf-GXSRX5VT.mjs → segment-codec-leaf-NDVBIBJJ.mjs} +3 -0
  9. package/dist/browser/{storage-leaf-42IZEOJJ.mjs → storage-leaf-NCOXQTXQ.mjs} +32 -12
  10. package/dist/{capabilities-DaJKuKlG.d.ts → capabilities-YazdElfW.d.ts} +2 -2
  11. package/dist/{chunk-KGLBLKYF.mjs → chunk-26AKUBDX.mjs} +66 -51
  12. package/dist/{react-native/chunks/chunk-3BEUTRYM.mjs → chunk-2M55WPWK.mjs} +1 -1
  13. package/dist/{chunk-AAH5CD3M.mjs → chunk-34QTB6O7.mjs} +1 -1
  14. package/dist/{chunk-GLPBA2YZ.mjs → chunk-3EFLY5LQ.mjs} +2 -2
  15. package/dist/{chunk-GDCTK5LU.mjs → chunk-3TENTQKL.mjs} +2 -2
  16. package/dist/{chunk-3PO2MOFY.mjs → chunk-3UAYJW6R.mjs} +2 -2
  17. package/dist/{chunk-VV6P6LKJ.mjs → chunk-3WYTRM24.mjs} +80 -78
  18. package/dist/chunk-43UYNPPC.mjs +110 -0
  19. package/dist/{chunk-UDDZVZTV.mjs → chunk-47NXBGQG.mjs} +2 -2
  20. package/dist/{chunk-RXQZ53NV.mjs → chunk-5CYLXJYQ.mjs} +2 -2
  21. package/dist/{chunk-6RNOECOF.mjs → chunk-5E46Y42F.mjs} +2 -2
  22. package/dist/{chunk-FAK7Y3OX.mjs → chunk-6U4C7VAD.mjs} +37 -9
  23. package/dist/{chunk-EY5U4P5V.mjs → chunk-7NMLFP2T.mjs} +17 -2
  24. package/dist/{chunk-BVLR6S5J.mjs → chunk-E6CHNSMY.mjs} +5 -5
  25. package/dist/{chunk-CP4ZQR2X.mjs → chunk-FBGUKBW2.mjs} +15 -9
  26. package/dist/{chunk-ZGGZXRGM.mjs → chunk-GYQKMYPG.mjs} +85 -38
  27. package/dist/{chunk-ICOCO7R4.mjs → chunk-GZ4YU36L.mjs} +1 -1
  28. package/dist/{chunk-3Q6CDT32.mjs → chunk-H2R4BTSO.mjs} +3 -3
  29. package/dist/{chunk-7SMVY4AX.mjs → chunk-HFF2R73P.mjs} +11 -11
  30. package/dist/{chunk-CPAE2QJP.mjs → chunk-HJCYLTVA.mjs} +1 -1
  31. package/dist/{chunk-XX4SKT54.mjs → chunk-KFUHQC6X.mjs} +22 -12
  32. package/dist/{chunk-5SHWA6PE.mjs → chunk-L2GYY6KY.mjs} +1 -1
  33. package/dist/{chunk-DEYEVTFV.mjs → chunk-L2W4FGTD.mjs} +2 -2
  34. package/dist/{chunk-4JLHHEBN.mjs → chunk-M5RYB6FE.mjs} +1 -1
  35. package/dist/{chunk-PBUME456.mjs → chunk-NOEMVUBS.mjs} +1 -1
  36. package/dist/{chunk-UQFWTROO.mjs → chunk-NSMF4OHE.mjs} +3 -3
  37. package/dist/{chunk-C3OQQ3M6.mjs → chunk-OPWZ7PZZ.mjs} +1 -1
  38. package/dist/{chunk-H7IIA2KL.mjs → chunk-PBVLCGCW.mjs} +1 -1
  39. package/dist/{chunk-REM3KDXN.mjs → chunk-U6B3HHTP.mjs} +4 -4
  40. package/dist/{chunk-M2Z5WVWW.mjs → chunk-UGMOBSMD.mjs} +2 -0
  41. package/dist/{chunk-43T3P3BE.mjs → chunk-WW3RDS57.mjs} +1 -1
  42. package/dist/{client-DetSCqP2.d.ts → client-B9YNYYs_.d.ts} +38 -12
  43. package/dist/client.d.ts +8 -8
  44. package/dist/client.mjs +2 -2
  45. package/dist/{config-BB4MRAsB.d.ts → config-DJFXyHMZ.d.ts} +2 -2
  46. package/dist/{config-XEHd4MFx.d.ts → config-DlvP2PSi.d.ts} +2 -2
  47. package/dist/{direct-executor-TWLEPVQO.mjs → direct-executor-2Y3JPVXT.mjs} +3 -3
  48. package/dist/distribution/coordinator/etcd.d.ts +2 -2
  49. package/dist/distribution/coordinator/etcd.mjs +6 -2
  50. package/dist/distribution/coordinator/in-memory.d.ts +2 -2
  51. package/dist/distribution/transport/grpc.mjs +1 -1
  52. package/dist/distribution/transport/tcp.mjs +24 -19
  53. package/dist/distribution.d.ts +14 -9
  54. package/dist/distribution.mjs +808 -646
  55. package/dist/{engine-DGG_yX0p.d.ts → engine-DP4PrdKM.d.ts} +51 -13
  56. package/dist/{index-fX_FbuRT.d.ts → index-CcivYH_R.d.ts} +1 -1
  57. package/dist/index.browser.mjs +3 -3
  58. package/dist/index.d.ts +6 -6
  59. package/dist/index.mjs +3 -3
  60. package/dist/index.react-native.mjs +3 -3
  61. package/dist/{long-query-thread-HK5FP64H.mjs → long-query-thread-6B2HXSBI.mjs} +13 -13
  62. package/dist/{msgpack-leaf-LIT7TKZW.mjs → msgpack-leaf-LTAJ5QGB.mjs} +2 -2
  63. package/dist/{optional-reads-ESDVS225.mjs → optional-reads-5QWIOFOU.mjs} +1 -1
  64. package/dist/{optional-writes-DPWRGFKK.mjs → optional-writes-27NHTIAL.mjs} +5 -5
  65. package/dist/{paged-partition-archive-NITVFYOC.mjs → paged-partition-archive-EFCEC4TD.mjs} +13 -13
  66. package/dist/partial-words.browser.mjs +3 -3
  67. package/dist/partial-words.mjs +3 -3
  68. package/dist/pattern.browser.mjs +2 -2
  69. package/dist/pattern.mjs +2 -2
  70. package/dist/persistence/durability/checkpoint-worker.d.ts +2 -1
  71. package/dist/persistence/durability/checkpoint-worker.mjs +10 -10
  72. package/dist/{query-actions-AA5LE2WV.mjs → query-actions-H6H54EJE.mjs} +3 -3
  73. package/dist/query-suggestions/merge-worker.mjs +6 -6
  74. package/dist/query-suggestions.browser.mjs +3 -3
  75. package/dist/query-suggestions.d.ts +2 -2
  76. package/dist/query-suggestions.mjs +4 -4
  77. package/dist/react-native/chunks/{chunk-6KVWTGEJ.mjs → chunk-7TURQEZZ.mjs} +84 -37
  78. package/dist/react-native/chunks/{chunk-ESVBC3AT.mjs → chunk-BIORJHQZ.mjs} +1 -1
  79. package/dist/react-native/chunks/{chunk-AOLLV37A.mjs → chunk-CBG4EUYD.mjs} +17 -2
  80. package/dist/{chunk-7HVZVD2N.mjs → react-native/chunks/chunk-DYAAQB5R.mjs} +1 -1
  81. package/dist/react-native/chunks/{chunk-HGZNA5A6.mjs → chunk-GCD64RZ2.mjs} +2 -2
  82. package/dist/react-native/chunks/{chunk-OVYLUGEW.mjs → chunk-UTYWL2W6.mjs} +2 -2
  83. package/dist/react-native/chunks/{chunk-ZZQ2RIYZ.mjs → chunk-XCJVLU6J.mjs} +2 -2
  84. package/dist/react-native/chunks/{chunk-574N6ERF.mjs → chunk-YMIPG3VC.mjs} +3 -3
  85. package/dist/react-native/chunks/{chunk-ZF3VSGEI.mjs → chunk-ZSJABTIE.mjs} +1 -1
  86. package/dist/react-native/chunks/{msgpack-leaf-FOUPTT7J.mjs → msgpack-leaf-Q4BPA4G7.mjs} +2 -2
  87. package/dist/react-native/chunks/{optional-reads-TN3PT6M4.mjs → optional-reads-M6F26KFO.mjs} +1 -1
  88. package/dist/react-native/chunks/{optional-writes-UYVKLJU6.mjs → optional-writes-NYFF5NTC.mjs} +4 -4
  89. package/dist/react-native/chunks/{restore-queue-AZIZ5ABX.mjs → restore-queue-4OXFRQ6N.mjs} +6 -6
  90. package/dist/react-native/chunks/{runtime-UOHD2XUJ.mjs → runtime-7UKADH3G.mjs} +2 -1
  91. package/dist/react-native/chunks/{segment-codec-leaf-TYO4LKQ6.mjs → segment-codec-leaf-YKUO5DU6.mjs} +4 -4
  92. package/dist/react-native/chunks/{segment-merge-leaf-KM52IXXQ.mjs → segment-merge-leaf-HIOWV5UN.mjs} +5 -5
  93. package/dist/react-native/chunks/{storage-leaf-HKJBZXIP.mjs → storage-leaf-H64VNQKE.mjs} +40 -20
  94. package/dist/react-native/chunks/{store-leaf-LS5LT25L.mjs → store-leaf-ZG5DR7QA.mjs} +5 -5
  95. package/dist/react-native/chunks/{suggestions-leaf-IJ3Z4EH3.mjs → suggestions-leaf-AJZ3SHZO.mjs} +5 -5
  96. package/dist/react-native/chunks/{worker-copies-VNXZRBVW.mjs → worker-copies-IY4ZIA6W.mjs} +4 -4
  97. package/dist/react-native/partial-words.mjs +3 -3
  98. package/dist/react-native/pattern.mjs +2 -2
  99. package/dist/react-native/query-suggestions.mjs +3 -3
  100. package/dist/react-native/sync.mjs +12 -7
  101. package/dist/react-native/synonyms.mjs +3 -3
  102. package/dist/react.d.ts +9 -9
  103. package/dist/{rerank-X4HOST2N.mjs → rerank-JTIQNROU.mjs} +25 -12
  104. package/dist/{restore-queue-CI72WRAF.mjs → restore-queue-JIJW3XKK.mjs} +6 -6
  105. package/dist/{runtime-USQYKN3I.mjs → runtime-WWFVQOBJ.mjs} +2 -1
  106. package/dist/{schema-CFnQ-WI3.d.ts → schema-CPQUdJTs.d.ts} +6 -0
  107. package/dist/{segment-codec-leaf-7R5H2IYU.mjs → segment-codec-leaf-LTIODLBH.mjs} +4 -4
  108. package/dist/{segment-merge-leaf-IWL4VH7C.mjs → segment-merge-leaf-CXOMXPAP.mjs} +4 -4
  109. package/dist/server.d.ts +22 -11
  110. package/dist/server.mjs +24 -20
  111. package/dist/{storage-leaf-6YCHFH2O.mjs → storage-leaf-VB5OG66O.mjs} +22 -22
  112. package/dist/{store-leaf-V5N2REHF.mjs → store-leaf-RBK3Y2H4.mjs} +5 -5
  113. package/dist/{suggestions-leaf-XFJ4L37A.mjs → suggestions-leaf-27TNMJ37.mjs} +7 -7
  114. package/dist/sync/filesystem.d.ts +3 -3
  115. package/dist/sync/filesystem.mjs +8 -8
  116. package/dist/sync/indexeddb.browser.mjs +1 -1
  117. package/dist/sync/indexeddb.d.ts +3 -3
  118. package/dist/sync/indexeddb.mjs +2 -2
  119. package/dist/sync.browser.mjs +7 -6
  120. package/dist/sync.d.ts +4 -4
  121. package/dist/sync.mjs +12 -7
  122. package/dist/synonyms.browser.mjs +3 -3
  123. package/dist/synonyms.mjs +3 -3
  124. package/dist/{tasks-Bpi5YNZF.d.ts → tasks-4rvZJuoN.d.ts} +8 -4
  125. package/dist/{thread-UQAIJ5CS.mjs → thread-J32AOE3H.mjs} +12 -12
  126. package/dist/{types-DGjk684l.d.ts → types-C3hkFf_3.d.ts} +2 -2
  127. package/dist/vector/search-worker.d.ts +1 -1
  128. package/dist/{worker-copies-44MSY3IU.mjs → worker-copies-F2WVSQQO.mjs} +6 -6
  129. package/dist/workers/entry.mjs +9 -9
  130. package/openapi.json +58 -2
  131. package/package.json +5 -7
@@ -1,14 +1,14 @@
1
- import { PAGED_SEGMENT_ENVELOPE_VERSION, loadFailed, checkEverySectionPage, openPagedFile, sectionNamed, createSectionReader, closePagedFile, readWholeSectionChecked, readCacheOfThisThread, createReadCache, MERGE_READ_CACHE_BYTES, encodePagedSegmentHead, SECTION_ALIGNMENT_BYTES, SEGMENT_PAGE_BYTES, FILE_ASSEMBLY_CHUNK_BYTES, readListedFile, requireListedChecksum, encodeSegmentManifest, requireNativePage, ID_SAMPLE_INTERVAL, SMALLEST_BLOCK_POSTINGS, readFileRange, PAYLOAD_PREFIX_BYTES, decodePagedSegmentHead, BLOCK_SUMMARY_BYTES, DOCUMENT_BLOCK_BYTES, MAX_DOCUMENT_BLOCK_RAW_BYTES, resumePagedFile, suspendPagedFile, cachedFileBytes, LIST_VIEWS_HELD_PER_SEGMENT, WRITER_YIELD_INTERVAL_TOKENS, DOCUMENT_BLOCK_MIN_RAW_BYTES, CACHED_POSITIONS, POSITION_WIDTH_BYTES, CACHED_LIST, POSTING_WIDTH_BYTES, readFileRangeLater, CACHED_DOCUMENT_BLOCK, failNativePage, REMOVAL_BUCKET_WRITE_BUFFER_BYTES, POSTING_WRITE_ROWS, POSTING_WRITE_POSITIONS, SECTION_WRITE_BUFFER_BYTES, LARGEST_REMOVAL_BUCKET_COUNT, REMOVAL_BUCKET_TARGET_BYTES, MERGED_SEGMENT_GROWTH_ALLOWANCE, MERGED_SEGMENT_TARGET_BYTES } from './chunk-UDDZVZTV.mjs';
1
+ import { PAGED_SEGMENT_ENVELOPE_VERSION, loadFailed, checkEverySectionPage, openPagedFile, sectionNamed, createSectionReader, closePagedFile, readWholeSectionChecked, readCacheOfThisThread, createReadCache, MERGE_READ_CACHE_BYTES, encodePagedSegmentHead, SECTION_ALIGNMENT_BYTES, SEGMENT_PAGE_BYTES, FILE_ASSEMBLY_CHUNK_BYTES, readListedFile, requireListedChecksum, encodeSegmentManifest, requireNativePage, ID_SAMPLE_INTERVAL, SMALLEST_BLOCK_POSTINGS, readFileRange, PAYLOAD_PREFIX_BYTES, decodePagedSegmentHead, BLOCK_SUMMARY_BYTES, DOCUMENT_BLOCK_BYTES, MAX_DOCUMENT_BLOCK_RAW_BYTES, resumePagedFile, suspendPagedFile, cachedFileBytes, LIST_VIEWS_HELD_PER_SEGMENT, WRITER_YIELD_INTERVAL_TOKENS, DOCUMENT_BLOCK_MIN_RAW_BYTES, CACHED_POSITIONS, POSITION_WIDTH_BYTES, CACHED_LIST, POSTING_WIDTH_BYTES, readFileRangeLater, CACHED_DOCUMENT_BLOCK, failNativePage, REMOVAL_BUCKET_WRITE_BUFFER_BYTES, POSTING_WRITE_ROWS, POSTING_WRITE_POSITIONS, SECTION_WRITE_BUFFER_BYTES, LARGEST_REMOVAL_BUCKET_COUNT, REMOVAL_BUCKET_TARGET_BYTES, MERGED_SEGMENT_GROWTH_ALLOWANCE, MERGED_SEGMENT_TARGET_BYTES } from './chunk-47NXBGQG.mjs';
2
2
  import { ReplicationMessageTypes } from './chunk-5FLRXF73.mjs';
3
3
  import { WIRE_BATCH_BUDGET } from './chunk-JDDXV6UF.mjs';
4
- import { SEGMENT_MANIFEST_VERSION, manifestKey, manifestReferencedKeys, segmentsPrefix, snapshotBundleKey, MAX_SEGMENTS_PER_PARTITION, segmentKey } from './chunk-CPAE2QJP.mjs';
4
+ import { SEGMENT_MANIFEST_VERSION, manifestKey, manifestReferencedKeys, segmentsPrefix, snapshotBundleKey, MAX_SEGMENTS_PER_PARTITION, segmentKey } from './chunk-HJCYLTVA.mjs';
5
5
  import { encode } from './chunk-S5QMWECL.mjs';
6
- import { restoreVectorFields } from './chunk-5SHWA6PE.mjs';
7
- import { requireWithinFileLimit, HEADER_SIZE, crc32Init, crc32Update, crc32Final, engineVersionParts, writeHeader, crc32, openChecksummedEnvelope, readHeader, packChecksummedEnvelope } from './chunk-RXQZ53NV.mjs';
8
- import { decodeStoredDocument, generateId, wrapFrozenTokenTable, createEncodedDocumentSource, assemblePagedFrozenSegment, buildPartialWordTableFrom, mergeFieldIndexes, isCompositePartition, reconstructSchemaFromMetadata, decodeSurfaceTable, mergeDocFrequencies, TermLookup, createFrozenRemovals, selectionKeeps, fieldIndexRemapOf, mergeKeywordSources, mergeSourceSpellings, mergeSourceSurfaces, mergedPartialSpellings, createSharedFrozenSegment, shareSegmentArrays, getLanguage, emptyPendingRegions, mergePostings2, scanPostingBlocks, holdsADiscardedField, SegmentRefusal, survivorDocumentsOf, partitionStateOf, freezeSegmentShared, createFrozenSegment, createPartitionManager, createPartitionRouter, buildSegmentPayloads, resolvePartitionInsertOptions, endOfValue, segmentArraysOf, mergeSegmentContents, decodeMapWithoutFields, prepareDocumentVectors, resolveIndexAnalysis } from './chunk-ZGGZXRGM.mjs';
6
+ import { restoreVectorFields } from './chunk-L2GYY6KY.mjs';
7
+ import { requireWithinFileLimit, HEADER_SIZE, crc32Init, crc32Update, crc32Final, engineVersionParts, writeHeader, crc32, openChecksummedEnvelope, readHeader, packChecksummedEnvelope } from './chunk-5CYLXJYQ.mjs';
8
+ import { decodeStoredDocument, generateId, wrapFrozenTokenTable, createEncodedDocumentSource, assemblePagedFrozenSegment, buildPartialWordTableFrom, mergeFieldIndexes, isCompositePartition, reconstructSchemaFromMetadata, decodeSurfaceTable, mergeDocFrequencies, TermLookup, createFrozenRemovals, selectionKeeps, fieldIndexRemapOf, mergeKeywordSources, mergeSourceSpellings, mergeSourceSurfaces, mergedPartialSpellings, createSharedFrozenSegment, shareSegmentArrays, getLanguage, emptyPendingRegions, mergePostings2, scanPostingBlocks, holdsADiscardedField, SegmentRefusal, survivorDocumentsOf, partitionStateOf, freezeSegmentShared, createFrozenSegment, createPartitionManager, createPartitionRouter, buildSegmentPayloads, resolvePartitionInsertOptions, endOfValue, segmentArraysOf, mergeSegmentContents, decodeMapWithoutFields, prepareDocumentVectors, resolveIndexAnalysis } from './chunk-GYQKMYPG.mjs';
9
9
  import { encodeDocument } from './chunk-2CKDCC65.mjs';
10
10
  import { decode } from './chunk-Y7GXGJFZ.mjs';
11
- import { extractVectorFieldsFromSchema, VECTOR_PATTERN, requireValidFieldTypes, partialFieldsOf, messagePackUpperBoundBytes } from './chunk-EY5U4P5V.mjs';
11
+ import { extractVectorFieldsFromSchema, VECTOR_PATTERN, requireValidFieldTypes, partialFieldsOf, messagePackUpperBoundBytes } from './chunk-7NMLFP2T.mjs';
12
12
  import { DEFAULT_REWRITE_BYTES_PER_CHECKPOINT, DEFAULT_COMPACTION_THRESHOLD, SEGMENT_FILE_FRAMING_SLACK_BYTES, REWRITE_ABOVE_REMOVED_DOCUMENT_SHARE, COMPACTION_LARGEST_MERGED_DOCUMENT_COUNT, SEGMENT_TOKEN_TABLE_SHARE_OF_FILE } from './chunk-S3JHYPH7.mjs';
13
13
  import { MAX_FILE_BYTES } from './chunk-4PY4JYMY.mjs';
14
14
  import { NarsilError, ErrorCodes } from './chunk-ZKOQR7EA.mjs';
@@ -3861,12 +3861,15 @@ function createInsyncConfirmMessage(payload, sourceId, requestId) {
3861
3861
  function isRecord2(value) {
3862
3862
  return value !== null && typeof value === "object" && !Array.isArray(value);
3863
3863
  }
3864
+ function invalidReplicationPayload(message) {
3865
+ return new NarsilError(ErrorCodes.REPLICATION_ENTRY_INVALID, message);
3866
+ }
3864
3867
  function optionalIndexUuid(value, payloadName) {
3865
3868
  if (value === void 0 || value === null) {
3866
3869
  return void 0;
3867
3870
  }
3868
3871
  if (typeof value !== "string" || value.length === 0) {
3869
- throw new Error(`Invalid ${payloadName}: "indexUuid" must be a non-empty string or absent`);
3872
+ throw invalidReplicationPayload(`Invalid ${payloadName}: "indexUuid" must be a non-empty string or absent`);
3870
3873
  }
3871
3874
  return value;
3872
3875
  }
@@ -3875,10 +3878,34 @@ function optionalPreviousPrimaryTerm(value, payloadName) {
3875
3878
  return void 0;
3876
3879
  }
3877
3880
  if (typeof value !== "number" || !Number.isInteger(value) || value < 0) {
3878
- throw new Error(`Invalid ${payloadName}: "previousPrimaryTerm" must be a non-negative integer or absent`);
3881
+ throw invalidReplicationPayload(
3882
+ `Invalid ${payloadName}: "previousPrimaryTerm" must be a non-negative integer or absent`
3883
+ );
3879
3884
  }
3880
3885
  return value;
3881
3886
  }
3887
+ function validateForwardOperation(operation, label) {
3888
+ if (typeof operation.documentId !== "string" || operation.documentId.length === 0) {
3889
+ throw invalidReplicationPayload(`Invalid ${label}: "documentId" must be a non-empty string`);
3890
+ }
3891
+ if (operation.operation !== "insert" && operation.operation !== "remove" && operation.operation !== "update") {
3892
+ throw invalidReplicationPayload(`Invalid ${label}: "operation" must be "insert", "remove", or "update"`);
3893
+ }
3894
+ operation.document ??= null;
3895
+ operation.updateFields ??= null;
3896
+ if (operation.document !== null && !(operation.document instanceof Uint8Array)) {
3897
+ throw invalidReplicationPayload(`Invalid ${label}: "document" must be binary or absent`);
3898
+ }
3899
+ if (operation.updateFields !== null && !isPlainObject(operation.updateFields)) {
3900
+ throw invalidReplicationPayload(`Invalid ${label}: "updateFields" must be a map or absent`);
3901
+ }
3902
+ if (operation.operation === "insert" && operation.document === null) {
3903
+ throw invalidReplicationPayload(`Invalid ${label}: an insert requires a document`);
3904
+ }
3905
+ if (operation.operation === "update" && operation.document === null && operation.updateFields === null) {
3906
+ throw invalidReplicationPayload(`Invalid ${label}: an update requires a document or updateFields`);
3907
+ }
3908
+ }
3882
3909
  function isPlainObject(value) {
3883
3910
  if (!isRecord2(value)) {
3884
3911
  return false;
@@ -3888,35 +3915,38 @@ function isPlainObject(value) {
3888
3915
  }
3889
3916
  function validateEntryPayload(decoded) {
3890
3917
  if (!isRecord2(decoded) || !isRecord2(decoded.entry)) {
3891
- throw new Error('Invalid EntryPayload: missing or invalid "entry" field');
3918
+ throw invalidReplicationPayload('Invalid EntryPayload: missing or invalid "entry" field');
3892
3919
  }
3893
3920
  const entry = decoded.entry;
3894
3921
  if (typeof entry.seqNo !== "number") {
3895
- throw new Error('Invalid EntryPayload: "entry.seqNo" must be a number');
3922
+ throw invalidReplicationPayload('Invalid EntryPayload: "entry.seqNo" must be a number');
3896
3923
  }
3897
3924
  if (typeof entry.primaryTerm !== "number") {
3898
- throw new Error('Invalid EntryPayload: "entry.primaryTerm" must be a number');
3925
+ throw invalidReplicationPayload('Invalid EntryPayload: "entry.primaryTerm" must be a number');
3899
3926
  }
3900
3927
  if (entry.operation !== "INDEX" && entry.operation !== "DELETE") {
3901
- throw new Error('Invalid EntryPayload: "entry.operation" must be "INDEX" or "DELETE"');
3928
+ throw invalidReplicationPayload('Invalid EntryPayload: "entry.operation" must be "INDEX" or "DELETE"');
3902
3929
  }
3903
3930
  if (typeof entry.partitionId !== "number") {
3904
- throw new Error('Invalid EntryPayload: "entry.partitionId" must be a number');
3931
+ throw invalidReplicationPayload('Invalid EntryPayload: "entry.partitionId" must be a number');
3905
3932
  }
3906
3933
  if (typeof entry.indexName !== "string") {
3907
- throw new Error('Invalid EntryPayload: "entry.indexName" must be a string');
3934
+ throw invalidReplicationPayload('Invalid EntryPayload: "entry.indexName" must be a string');
3908
3935
  }
3909
3936
  if (typeof entry.documentId !== "string") {
3910
- throw new Error('Invalid EntryPayload: "entry.documentId" must be a string');
3937
+ throw invalidReplicationPayload('Invalid EntryPayload: "entry.documentId" must be a string');
3911
3938
  }
3939
+ entry.document ??= null;
3912
3940
  if (entry.document !== null && !(entry.document instanceof Uint8Array)) {
3913
- throw new Error('Invalid EntryPayload: "entry.document" must be Uint8Array or null');
3941
+ throw invalidReplicationPayload('Invalid EntryPayload: "entry.document" must be binary or absent');
3914
3942
  }
3915
3943
  if ("previousDocument" in entry && entry.previousDocument !== null && !(entry.previousDocument instanceof Uint8Array)) {
3916
- throw new Error('Invalid EntryPayload: "entry.previousDocument" must be Uint8Array or null where present');
3944
+ throw invalidReplicationPayload(
3945
+ 'Invalid EntryPayload: "entry.previousDocument" must be Uint8Array or null where present'
3946
+ );
3917
3947
  }
3918
3948
  if (typeof entry.checksum !== "number") {
3919
- throw new Error('Invalid EntryPayload: "entry.checksum" must be a number');
3949
+ throw invalidReplicationPayload('Invalid EntryPayload: "entry.checksum" must be a number');
3920
3950
  }
3921
3951
  optionalIndexUuid(decoded.indexUuid, "EntryPayload");
3922
3952
  optionalPreviousPrimaryTerm(decoded.previousPrimaryTerm, "EntryPayload");
@@ -3924,23 +3954,25 @@ function validateEntryPayload(decoded) {
3924
3954
  }
3925
3955
  function validateEntryBatchPayload(decoded) {
3926
3956
  if (!isRecord2(decoded) || !Array.isArray(decoded.entries)) {
3927
- throw new Error('Invalid EntryBatchPayload: missing or invalid "entries" field');
3957
+ throw invalidReplicationPayload('Invalid EntryBatchPayload: missing or invalid "entries" field');
3928
3958
  }
3929
3959
  if (decoded.entries.length === 0) {
3930
- throw new Error('Invalid EntryBatchPayload: "entries" must not be empty');
3960
+ throw invalidReplicationPayload('Invalid EntryBatchPayload: "entries" must not be empty');
3931
3961
  }
3932
3962
  const validated = decoded.entries.map((candidate) => validateEntryPayload({ entry: candidate }).entry);
3933
3963
  const first = validated[0];
3934
3964
  for (let index = 1; index < validated.length; index++) {
3935
3965
  const entry = validated[index];
3936
3966
  if (entry.indexName !== first.indexName || entry.partitionId !== first.partitionId) {
3937
- throw new Error("Invalid EntryBatchPayload: entries must belong to one partition of one index");
3967
+ throw invalidReplicationPayload("Invalid EntryBatchPayload: entries must belong to one partition of one index");
3938
3968
  }
3939
3969
  if (entry.primaryTerm !== first.primaryTerm) {
3940
- throw new Error("Invalid EntryBatchPayload: entries must share one primary term");
3970
+ throw invalidReplicationPayload("Invalid EntryBatchPayload: entries must share one primary term");
3941
3971
  }
3942
3972
  if (entry.seqNo !== validated[index - 1].seqNo + 1) {
3943
- throw new Error("Invalid EntryBatchPayload: entries must carry contiguous ascending sequence numbers");
3973
+ throw invalidReplicationPayload(
3974
+ "Invalid EntryBatchPayload: entries must carry contiguous ascending sequence numbers"
3975
+ );
3944
3976
  }
3945
3977
  }
3946
3978
  const payload = { entries: validated };
@@ -3952,44 +3984,25 @@ function validateEntryBatchPayload(decoded) {
3952
3984
  }
3953
3985
  function validateForwardBatchPayload(decoded) {
3954
3986
  if (!isRecord2(decoded)) {
3955
- throw new Error("Invalid ForwardBatchPayload: expected an object");
3987
+ throw invalidReplicationPayload("Invalid ForwardBatchPayload: expected an object");
3956
3988
  }
3957
3989
  if (typeof decoded.indexName !== "string" || decoded.indexName.length === 0) {
3958
- throw new Error('Invalid ForwardBatchPayload: "indexName" must be a non-empty string');
3990
+ throw invalidReplicationPayload('Invalid ForwardBatchPayload: "indexName" must be a non-empty string');
3959
3991
  }
3960
3992
  if (!Array.isArray(decoded.operations)) {
3961
- throw new Error('Invalid ForwardBatchPayload: "operations" must be an array');
3962
- }
3963
- if (decoded.operations.length === 0) {
3964
- throw new Error('Invalid ForwardBatchPayload: "operations" must not be empty');
3993
+ throw invalidReplicationPayload('Invalid ForwardBatchPayload: "operations" must be an array');
3965
3994
  }
3966
- if (decoded.operations.length > MAX_FORWARD_BATCH_OPERATIONS) {
3967
- throw new Error(
3968
- `Invalid ForwardBatchPayload: "operations" exceeds maximum length of ${MAX_FORWARD_BATCH_OPERATIONS}`
3995
+ if (decoded.operations.length === 0 || decoded.operations.length > MAX_FORWARD_BATCH_OPERATIONS) {
3996
+ throw invalidReplicationPayload(
3997
+ `Invalid ForwardBatchPayload: "operations" must hold from 1 to ${MAX_FORWARD_BATCH_OPERATIONS} operations`
3969
3998
  );
3970
3999
  }
3971
4000
  for (let index = 0; index < decoded.operations.length; index++) {
3972
4001
  const operation = decoded.operations[index];
3973
4002
  if (!isRecord2(operation)) {
3974
- throw new Error(`Invalid ForwardBatchPayload: "operations[${index}]" must be an object`);
3975
- }
3976
- if (typeof operation.documentId !== "string" || operation.documentId.length === 0) {
3977
- throw new Error(`Invalid ForwardBatchPayload: "operations[${index}].documentId" must be a non-empty string`);
3978
- }
3979
- if (operation.operation !== "insert" && operation.operation !== "remove" && operation.operation !== "update") {
3980
- throw new Error(
3981
- `Invalid ForwardBatchPayload: "operations[${index}].operation" must be "insert", "remove", or "update"`
3982
- );
3983
- }
3984
- if (operation.document !== null && !(operation.document instanceof Uint8Array)) {
3985
- throw new Error(`Invalid ForwardBatchPayload: "operations[${index}].document" must be Uint8Array or null`);
3986
- }
3987
- if (operation.operation === "insert" && operation.document === null) {
3988
- throw new Error(`Invalid ForwardBatchPayload: "operations[${index}]" requires a document`);
3989
- }
3990
- if (operation.operation === "update" && operation.document === null && !isRecord2(operation.updateFields)) {
3991
- throw new Error(`Invalid ForwardBatchPayload: "operations[${index}]" requires a document or updateFields`);
4003
+ throw invalidReplicationPayload(`Invalid ForwardBatchPayload: "operations[${index}]" must be an object`);
3992
4004
  }
4005
+ validateForwardOperation(operation, `ForwardBatchPayload "operations[${index}]"`);
3993
4006
  }
3994
4007
  optionalIndexUuid(decoded.indexUuid, "ForwardBatchPayload");
3995
4008
  return decoded;
@@ -4012,6 +4025,8 @@ function validateForwardBatchResultPayload(decoded) {
4012
4025
  if (typeof result.success !== "boolean") {
4013
4026
  throw new Error(`Invalid ForwardBatchResultPayload: "results[${index}].success" must be a boolean`);
4014
4027
  }
4028
+ result.errorCode ??= null;
4029
+ result.errorMessage ??= null;
4015
4030
  if (result.errorCode !== null && typeof result.errorCode !== "string") {
4016
4031
  throw new Error(`Invalid ForwardBatchResultPayload: "results[${index}].errorCode" must be a string or null`);
4017
4032
  }
@@ -5028,4 +5043,4 @@ async function removeCheckpointGarbage(store, garbage) {
5028
5043
  }
5029
5044
  }
5030
5045
 
5031
- export { DEFAULT_LOG_RETENTION_BYTES, FRAME_CRC_SIZE, INSYNC_CAS_ATTEMPTS, KEYWORD_SEGMENT_ENVELOPE_VERSION, MAX_WAL_RECORD_BYTES, NOTHING_SAVED, RECORD_LENGTH_SIZE, SEGMENT_HEADER_SIZE, SEGMENT_TAIL_PATTERN, SNAPSHOT_CHUNK_SIZE, WAL_FORMAT_VERSION, WAL_FORMAT_VERSION_WITH_PREVIOUS_DOCUMENT, buildEntry, bytesThatSegmentsHoldInMemory, captureWholePartition, checkPagedContents, checkPagedSegmentFully, checkPagedSelections, checkSegmentHeader, checkpointGarbage, checkpointLastSeqNo, checkpointPrimaryTerm, commitCheckpointManifest, computeEntryChecksum, countsAsLatestHolder, createAckMessage, createEntryBatchMessage, createEntryMessage, createForwardBatchMessage, createForwardBatchResultMessage, createForwardMessage, createInsyncAddMessage, createInsyncConfirmMessage, createInsyncRemoveMessage, createPagedFrozenSegment, createPrimaryResignMessage, decodeKeywordSegment, decodeWalEntry, durableRecordMissing, encodeMarkerSlot, entryByteEstimate, filePathOf, frameRecord, isPagedSegmentFile, joinFrames, markerSlotOffset, mergePagedWindow, nextMarkerSlot, nextSegmentKey, openPagedSegmentScan, openPagedSnapshot, optionalIndexUuid, pagedListingOf, pagedTombstonesFor, parseSegmentStartSeqNo, partitionContentsOf, readCommitMarker, readSegmentFile, readWalSegments, removeCheckpointGarbage, removeUnusedSegmentFiles, residentSectionsOf, rewrittenHeaderKey, savedBytesOfManifest, segmentKey2 as segmentKey, validateAckPayload, validateEntryBatchPayload, validateEntryPayload, validateForwardBatchPayload, validateForwardBatchResultPayload, validateInsyncConfirmPayload, writeCheckpointSegments, writePagedSegment, writeSegmentHeader };
5046
+ export { DEFAULT_LOG_RETENTION_BYTES, FRAME_CRC_SIZE, INSYNC_CAS_ATTEMPTS, KEYWORD_SEGMENT_ENVELOPE_VERSION, MAX_WAL_RECORD_BYTES, NOTHING_SAVED, RECORD_LENGTH_SIZE, SEGMENT_HEADER_SIZE, SEGMENT_TAIL_PATTERN, SNAPSHOT_CHUNK_SIZE, WAL_FORMAT_VERSION, WAL_FORMAT_VERSION_WITH_PREVIOUS_DOCUMENT, buildEntry, bytesThatSegmentsHoldInMemory, captureWholePartition, checkPagedContents, checkPagedSegmentFully, checkPagedSelections, checkSegmentHeader, checkpointGarbage, checkpointLastSeqNo, checkpointPrimaryTerm, commitCheckpointManifest, computeEntryChecksum, countsAsLatestHolder, createAckMessage, createEntryBatchMessage, createEntryMessage, createForwardBatchMessage, createForwardBatchResultMessage, createForwardMessage, createInsyncAddMessage, createInsyncConfirmMessage, createInsyncRemoveMessage, createPagedFrozenSegment, createPrimaryResignMessage, decodeKeywordSegment, decodeWalEntry, durableRecordMissing, encodeMarkerSlot, entryByteEstimate, filePathOf, frameRecord, invalidReplicationPayload, isPagedSegmentFile, joinFrames, markerSlotOffset, mergePagedWindow, nextMarkerSlot, nextSegmentKey, openPagedSegmentScan, openPagedSnapshot, optionalIndexUuid, pagedListingOf, pagedTombstonesFor, parseSegmentStartSeqNo, partitionContentsOf, readCommitMarker, readSegmentFile, readWalSegments, removeCheckpointGarbage, removeUnusedSegmentFiles, residentSectionsOf, rewrittenHeaderKey, savedBytesOfManifest, segmentKey2 as segmentKey, validateAckPayload, validateEntryBatchPayload, validateEntryPayload, validateForwardBatchPayload, validateForwardBatchResultPayload, validateForwardOperation, validateInsyncConfirmPayload, writeCheckpointSegments, writePagedSegment, writeSegmentHeader };
@@ -1,4 +1,4 @@
1
- import { loadStorageCode, resolvePartialWordAnalysis, resolvePartitionInsertOptions, yieldToEventLoop, createPartitionIndex, writePartitionDocument } from './chunk-6KVWTGEJ.mjs';
1
+ import { loadStorageCode, resolvePartialWordAnalysis, resolvePartitionInsertOptions, yieldToEventLoop, createPartitionIndex, writePartitionDocument } from './chunk-GYQKMYPG.mjs';
2
2
 
3
3
  // src/partitioning/constants.ts
4
4
  var REBALANCE_CHUNK_SIZE = 1e3;
@@ -1,4 +1,4 @@
1
- import { readRecentMemoryFigures, readMemoryFigures } from './chunk-ZGGZXRGM.mjs';
1
+ import { readRecentMemoryFigures, readMemoryFigures } from './chunk-GYQKMYPG.mjs';
2
2
  import { collectGarbageBeforeAnswerRefusal, collectYoungGenerationBeforeRefusal, reservedHeapBytes, admitHeapBytes } from './chunk-BRTABNC7.mjs';
3
3
  import { NarsilError, ErrorCodes, ServerErrorCodes } from './chunk-ZKOQR7EA.mjs';
4
4
 
@@ -1,5 +1,5 @@
1
- import { MAX_HISTORY_FILE_BYTES, openChecksummedEnvelope, KEY_FINGERPRINT_BYTES, DAY_MS, dayFileKey, SCRAMBLED_ID_BYTES, restoreStagingPrefix, resolveSetting, QUERY_HISTORY_ARCHIVE_PREFIX, restoredFileKey, attachedRuntimeOf, MAX_INDEX_UUID_LENGTH, HEADER_SIZE, isGroup, isNormalPhrase, MAX_MAX_LENGTH, MAX_MAX_WORDS, listHistoryFolder, historyFileOf, MIN_PHRASE_TABLE_CAPACITY, PERSON_TABLE_MIN_SLOTS, PAIR_PAGE_BLOCKS, PAIR_BLOCK_SLOTS, packEnvelopeWithChecksum, crc32, MAX_PEOPLE_PER_PHRASE_IN_FILE } from './chunk-RXQZ53NV.mjs';
2
- import { loadSuggestionsCode, emitWriteEventAfter, dropEngineIndex } from './chunk-ZGGZXRGM.mjs';
1
+ import { MAX_HISTORY_FILE_BYTES, openChecksummedEnvelope, KEY_FINGERPRINT_BYTES, DAY_MS, dayFileKey, SCRAMBLED_ID_BYTES, restoreStagingPrefix, resolveSetting, QUERY_HISTORY_ARCHIVE_PREFIX, restoredFileKey, attachedRuntimeOf, MAX_INDEX_UUID_LENGTH, HEADER_SIZE, isGroup, isNormalPhrase, MAX_MAX_LENGTH, MAX_MAX_WORDS, listHistoryFolder, historyFileOf, MIN_PHRASE_TABLE_CAPACITY, PERSON_TABLE_MIN_SLOTS, PAIR_PAGE_BLOCKS, PAIR_BLOCK_SLOTS, packEnvelopeWithChecksum, crc32, MAX_PEOPLE_PER_PHRASE_IN_FILE } from './chunk-5CYLXJYQ.mjs';
2
+ import { loadSuggestionsCode, emitWriteEventAfter, dropEngineIndex } from './chunk-GYQKMYPG.mjs';
3
3
  import { NarsilError, ErrorCodes } from './chunk-ZKOQR7EA.mjs';
4
4
 
5
5
  // src/query-suggestions/engine-hooks.ts
@@ -1,7 +1,7 @@
1
1
  import { encode } from './chunk-S5QMWECL.mjs';
2
2
  import { oneSyncChangeAtATime } from './chunk-V6EUBAIT.mjs';
3
- import { openChecksummedEnvelope, packChecksummedEnvelope } from './chunk-RXQZ53NV.mjs';
4
- import { rulesOfStoredSynonyms, configurationPayloadOf, withOpenIndex, emitSyncChange, validQueryFilter, createPartitionIndex, prepareDocumentVectors, createPatternWorkMeter, resolvePartitionInsertOptions } from './chunk-ZGGZXRGM.mjs';
3
+ import { openChecksummedEnvelope, packChecksummedEnvelope } from './chunk-5CYLXJYQ.mjs';
4
+ import { rulesOfStoredSynonyms, configurationPayloadOf, withOpenIndex, emitSyncChange, validQueryFilter, createPartitionIndex, prepareDocumentVectors, createPatternWorkMeter, resolvePartitionInsertOptions } from './chunk-GYQKMYPG.mjs';
5
5
  import { decode } from './chunk-Y7GXGJFZ.mjs';
6
6
  import { newSyncEpoch, isSyncEpoch } from './chunk-BUMREPLU.mjs';
7
7
  import { NarsilError, ErrorCodes } from './chunk-ZKOQR7EA.mjs';
@@ -1,5 +1,5 @@
1
- import { createNumericIndex, createBooleanIndex, createEnumIndex, createLoadedGeoIndex, rebuildSizeIndexes, requirePatternSearch, patternIndexOf } from './chunk-ZGGZXRGM.mjs';
2
- import { getFlatSchema, schemaFieldsOf, getNestedValue } from './chunk-EY5U4P5V.mjs';
1
+ import { createNumericIndex, createBooleanIndex, createEnumIndex, createLoadedGeoIndex, rebuildSizeIndexes, requirePatternSearch, patternIndexOf } from './chunk-GYQKMYPG.mjs';
2
+ import { getFlatSchema, schemaFieldsOf, getNestedValue } from './chunk-7NMLFP2T.mjs';
3
3
 
4
4
  // src/core/partition/pattern-snapshot.ts
5
5
  function serializePatternIndexes(state, schema) {
@@ -1,7 +1,7 @@
1
- import { restoredEmbedding, restoredPartitionConfig, readSharedConfigFields } from './chunk-M2Z5WVWW.mjs';
1
+ import { restoredEmbedding, restoredPartitionConfig, readSharedConfigFields } from './chunk-UGMOBSMD.mjs';
2
2
  import { MAX_PARTITION_COUNT, MAX_REPLICATION_FACTOR } from './chunk-JDDXV6UF.mjs';
3
- import { storedStateOf } from './chunk-RXQZ53NV.mjs';
4
- import { getLanguage, generateId, decodeSynonymRules } from './chunk-ZGGZXRGM.mjs';
3
+ import { storedStateOf } from './chunk-5CYLXJYQ.mjs';
4
+ import { getLanguage, generateId, decodeSynonymRules } from './chunk-GYQKMYPG.mjs';
5
5
  import { decode } from './chunk-Y7GXGJFZ.mjs';
6
6
  import { isSyncEpoch } from './chunk-BUMREPLU.mjs';
7
7
  import { MAX_INDEX_NAME_LENGTH, INDEX_NAME_PATTERN } from './chunk-3ECIRFS5.mjs';
@@ -9,56 +9,6 @@ import { NarsilError, ErrorCodes } from './chunk-ZKOQR7EA.mjs';
9
9
  import { compareCodePoints } from './chunk-TGPKS2UM.mjs';
10
10
  import { encode } from '@msgpack/msgpack';
11
11
 
12
- // src/distribution/payload-guards.ts
13
- function isRecord(value) {
14
- return value !== null && typeof value === "object" && !Array.isArray(value);
15
- }
16
- function isValidInteger(value) {
17
- return typeof value === "number" && Number.isFinite(value) && Number.isInteger(value);
18
- }
19
-
20
- // src/distribution/cluster/constants.ts
21
- var LEADERSHIP_IMBALANCE_THRESHOLD = 2;
22
- var ESTIMATED_PARTITION_BYTES = 50 * 1024 * 1024;
23
- var REBALANCE_THRESHOLD = 0.1;
24
- var BOOTSTRAP_CAS_ATTEMPTS = 5;
25
- var ALLOCATION_CAS_ATTEMPTS = 5;
26
- var ALLOCATION_RETRY_DELAY_MS = 1e3;
27
- var TEARDOWN_CAS_ATTEMPTS = 5;
28
- var TEARDOWN_RETRY_DELAY_MS = 500;
29
- var TEARDOWN_RETRY_ROUNDS = 3;
30
- var RECOVERY_CAS_ATTEMPTS = 5;
31
- var REPLICATION_FACTOR_CAS_ATTEMPTS = 5;
32
- var SYNC_EPOCH_CAS_ATTEMPTS = 5;
33
- var HIDDEN_GENERATION_PREFIX = "narsil-generation-";
34
- var RESHARD_CUTOVER_LAG_ENTRIES = 1e3;
35
- var RESHARD_CUTOVER_TIMEOUT_MS = 1e4;
36
- var MAX_RESHARD_CUTOVER_ATTEMPTS = 10;
37
- var RESHARD_POLL_INTERVAL_MS = 50;
38
- var RESHARD_CONTROLLER_POLL_INTERVAL_MS = 250;
39
- var ANALYSIS_CHANGE_POLL_INTERVAL_MS = 100;
40
- var ANALYSIS_REBUILD_RESEND_MS = 3e4;
41
- var ANALYSIS_CHANGE_RETRY_MS = 1e3;
42
- var RESHARD_RECORD_CHECK_INTERVAL_MS = 1e3;
43
- var RESHARD_RETRY_DELAY_MS = 200;
44
- var RESHARD_FORWARD_BATCH_DOCUMENTS = 256;
45
- var RESHARD_RECORD_CAS_ATTEMPTS = 10;
46
- var PARTITION_STORES_TIMEOUT_MS = 5e3;
47
- var DEFAULT_CONTROLLER_CONFIG = {
48
- leaseTtlMs: 15e3,
49
- standbyRetryMs: 5e3,
50
- nodeLeftDelayMs: 6e4
51
- };
52
- var DEFAULT_NODE_LIFECYCLE_CONFIG = {
53
- bootstrapRetryBaseMs: 1e3,
54
- bootstrapRetryMaxMs: 5e3,
55
- bootstrapMaxRetries: 10,
56
- allocationDebounceMs: 250,
57
- nodeHeartbeatIntervalMs: 1e4
58
- };
59
- var MAX_SYNONYM_GENERATION_LENGTH = 128;
60
- var UNFED_REPLICA_CHECK_INTERVAL_MS = 1e3;
61
- var UNFED_REPLICA_RESYNC_MS = 15e3;
62
12
  function decodeClusterQuerySuggestionSettings(raw, reject) {
63
13
  let state;
64
14
  try {
@@ -83,12 +33,12 @@ function suggestionStateOfSettings(settings) {
83
33
  }
84
34
  function metadataWithSuggestionState(snapshot, state) {
85
35
  const decoded = decode(snapshot.bytes);
86
- const fields = isRecord2(decoded) ? decoded : {};
36
+ const fields = isRecord(decoded) ? decoded : {};
87
37
  const {
88
38
  querySuggestions: _setting,
89
39
  bannedQueries: _banned,
90
40
  ...settings
91
- } = isRecord2(fields.settings) ? fields.settings : { language: snapshot.settings?.language ?? getLanguage("english").name };
41
+ } = isRecord(fields.settings) ? fields.settings : { language: snapshot.settings?.language ?? getLanguage("english").name };
92
42
  const next = {
93
43
  ...settings,
94
44
  ...state?.querySuggestions !== void 0 ? { querySuggestions: state.querySuggestions } : {},
@@ -100,7 +50,7 @@ function isPositiveSafeInteger(value) {
100
50
  return typeof value === "number" && Number.isSafeInteger(value) && value >= 1;
101
51
  }
102
52
  function decodeHistorySetting(field, raw, reject) {
103
- if (!isRecord2(raw) || typeof raw.enabled !== "boolean") {
53
+ if (!isRecord(raw) || typeof raw.enabled !== "boolean") {
104
54
  return reject(`${field} must be a map with a boolean enabled`);
105
55
  }
106
56
  const { historyMaxAgeMs, historyMaxBytes } = raw;
@@ -118,7 +68,7 @@ function decodeHistorySetting(field, raw, reject) {
118
68
  }
119
69
  function decodeChangesSetting(raw, reject) {
120
70
  const history = decodeHistorySetting("changes", raw, reject);
121
- const previousDocument = isRecord2(raw) ? raw.previousDocument : void 0;
71
+ const previousDocument = isRecord(raw) ? raw.previousDocument : void 0;
122
72
  if (previousDocument !== void 0 && typeof previousDocument !== "boolean") {
123
73
  return reject("changes.previousDocument must be a boolean");
124
74
  }
@@ -145,8 +95,8 @@ function epochFeaturesOn(settings) {
145
95
  }
146
96
  function metadataWithSync(snapshot, next) {
147
97
  const decoded = decode(snapshot.bytes);
148
- const fields = isRecord2(decoded) ? decoded : {};
149
- const settings = isRecord2(fields.settings) ? withoutSyncFields(fields.settings) : { language: snapshot.settings?.language ?? getLanguage("english").name };
98
+ const fields = isRecord(decoded) ? decoded : {};
99
+ const settings = isRecord(fields.settings) ? withoutSyncFields(fields.settings) : { language: snapshot.settings?.language ?? getLanguage("english").name };
150
100
  return new Uint8Array(encode({ ...fields, settings: { ...settings, ...next } }, { ignoreUndefined: true }));
151
101
  }
152
102
  function withoutSyncFields(settings) {
@@ -164,6 +114,57 @@ function syncSettingsOfSnapshot(snapshot) {
164
114
  };
165
115
  }
166
116
 
117
+ // src/distribution/payload-guards.ts
118
+ function isRecord2(value) {
119
+ return value !== null && typeof value === "object" && !Array.isArray(value);
120
+ }
121
+ function isValidInteger(value) {
122
+ return typeof value === "number" && Number.isFinite(value) && Number.isInteger(value);
123
+ }
124
+
125
+ // src/distribution/cluster/constants.ts
126
+ var LEADERSHIP_IMBALANCE_THRESHOLD = 2;
127
+ var ESTIMATED_PARTITION_BYTES = 50 * 1024 * 1024;
128
+ var REBALANCE_THRESHOLD = 0.1;
129
+ var BOOTSTRAP_CAS_ATTEMPTS = 5;
130
+ var ALLOCATION_CAS_ATTEMPTS = 5;
131
+ var ALLOCATION_RETRY_DELAY_MS = 1e3;
132
+ var TEARDOWN_CAS_ATTEMPTS = 5;
133
+ var TEARDOWN_RETRY_DELAY_MS = 500;
134
+ var TEARDOWN_RETRY_ROUNDS = 3;
135
+ var RECOVERY_CAS_ATTEMPTS = 5;
136
+ var REPLICATION_FACTOR_CAS_ATTEMPTS = 5;
137
+ var SYNC_EPOCH_CAS_ATTEMPTS = 5;
138
+ var HIDDEN_GENERATION_PREFIX = "narsil-generation-";
139
+ var RESHARD_CUTOVER_LAG_ENTRIES = 1e3;
140
+ var RESHARD_CUTOVER_TIMEOUT_MS = 1e4;
141
+ var MAX_RESHARD_CUTOVER_ATTEMPTS = 10;
142
+ var RESHARD_POLL_INTERVAL_MS = 50;
143
+ var RESHARD_CONTROLLER_POLL_INTERVAL_MS = 250;
144
+ var ANALYSIS_CHANGE_POLL_INTERVAL_MS = 100;
145
+ var ANALYSIS_REBUILD_RESEND_MS = 3e4;
146
+ var ANALYSIS_CHANGE_RETRY_MS = 1e3;
147
+ var RESHARD_RECORD_CHECK_INTERVAL_MS = 1e3;
148
+ var RESHARD_RETRY_DELAY_MS = 200;
149
+ var RESHARD_FORWARD_BATCH_DOCUMENTS = 256;
150
+ var RESHARD_RECORD_CAS_ATTEMPTS = 10;
151
+ var PARTITION_STORES_TIMEOUT_MS = 5e3;
152
+ var DEFAULT_CONTROLLER_CONFIG = {
153
+ leaseTtlMs: 15e3,
154
+ standbyRetryMs: 5e3,
155
+ nodeLeftDelayMs: 6e4
156
+ };
157
+ var DEFAULT_NODE_LIFECYCLE_CONFIG = {
158
+ bootstrapRetryBaseMs: 1e3,
159
+ bootstrapRetryMaxMs: 5e3,
160
+ bootstrapMaxRetries: 10,
161
+ allocationDebounceMs: 250,
162
+ nodeHeartbeatIntervalMs: 1e4
163
+ };
164
+ var MAX_SYNONYM_GENERATION_LENGTH = 128;
165
+ var UNFED_REPLICA_CHECK_INTERVAL_MS = 1e3;
166
+ var UNFED_REPLICA_RESYNC_MS = 15e3;
167
+
167
168
  // src/distribution/cluster/synonym-set.ts
168
169
  var SYNONYM_CHUNK_BYTES = 1048576;
169
170
  var SYNONYM_SET_PREFIX = "_narsil/synonyms/";
@@ -189,7 +190,7 @@ async function digestOf(bytes) {
189
190
  return Array.from(hash, (byte) => byte.toString(16).padStart(2, "0")).join("");
190
191
  }
191
192
  function synonymSetRefOf(raw) {
192
- if (!isRecord(raw)) return "synonyms must be an object";
193
+ if (!isRecord2(raw)) return "synonyms must be an object";
193
194
  const { generation, digest, chunkCount, byteLength } = raw;
194
195
  if (typeof generation !== "string" || generation.length === 0 || generation.length > MAX_SYNONYM_GENERATION_LENGTH || !isKeySegment(generation)) {
195
196
  return "synonyms.generation must hold 1 to 128 characters, with no control character, slash, or backslash";
@@ -320,6 +321,7 @@ function settingsFieldsOf(source) {
320
321
  ...source.trackPositions !== void 0 ? { trackPositions: source.trackPositions } : {},
321
322
  ...source.textStorage !== void 0 ? { textStorage: source.textStorage } : {},
322
323
  ...source.strict !== void 0 ? { strict: source.strict } : {},
324
+ ...source.returnVectors !== void 0 ? { returnVectors: source.returnVectors } : {},
323
325
  ...source.required !== void 0 ? { required: source.required } : {},
324
326
  ...source.vectorPromotion !== void 0 ? { vectorPromotion: source.vectorPromotion } : {},
325
327
  ...source.patternValueLimit !== void 0 ? { patternValueLimit: source.patternValueLimit } : {},
@@ -338,7 +340,7 @@ function indexSettingsOf(config) {
338
340
  ...settingsFieldsOf(config)
339
341
  };
340
342
  }
341
- function isRecord2(value) {
343
+ function isRecord(value) {
342
344
  return value !== null && typeof value === "object" && !Array.isArray(value);
343
345
  }
344
346
  function settingsRejection(indexName) {
@@ -358,14 +360,14 @@ function isOptionalString(value) {
358
360
  }
359
361
  function decodePendingAnalysis(raw, reject) {
360
362
  if (raw === void 0) return void 0;
361
- if (!isRecord2(raw) || typeof raw.changeId !== "string" || !isGeneration(raw.generation) || typeof raw.language !== "string" || !isOptionalString(raw.tokenizer) || !isOptionalString(raw.stopWords) || raw.stopWordList !== void 0 && (!Array.isArray(raw.stopWordList) || raw.stopWordList.some((word) => typeof word !== "string"))) {
363
+ if (!isRecord(raw) || typeof raw.changeId !== "string" || !isGeneration(raw.generation) || typeof raw.language !== "string" || !isOptionalString(raw.tokenizer) || !isOptionalString(raw.stopWords) || raw.stopWordList !== void 0 && (!Array.isArray(raw.stopWordList) || raw.stopWordList.some((word) => typeof word !== "string"))) {
362
364
  return reject("pendingAnalysis is malformed");
363
365
  }
364
366
  return raw;
365
367
  }
366
368
  function decodeAnalysisFailure(raw, reject) {
367
369
  if (raw === void 0) return void 0;
368
- if (!isRecord2(raw) || typeof raw.changeId !== "string" || typeof raw.code !== "string" || typeof raw.message !== "string" || typeof raw.nodeId !== "string") {
370
+ if (!isRecord(raw) || typeof raw.changeId !== "string" || typeof raw.code !== "string" || typeof raw.message !== "string" || typeof raw.nodeId !== "string") {
369
371
  return reject("analysisFailure is malformed");
370
372
  }
371
373
  return raw;
@@ -387,7 +389,7 @@ function decodeIndexSettings(raw, indexName) {
387
389
  return void 0;
388
390
  }
389
391
  const reject = settingsRejection(indexName);
390
- if (!isRecord2(raw)) {
392
+ if (!isRecord(raw)) {
391
393
  return reject("settings must be an object");
392
394
  }
393
395
  if (typeof raw.language !== "string" || raw.language.length === 0) {
@@ -486,7 +488,7 @@ function indexConfigKey(indexName) {
486
488
  return `${INDEX_CONFIG_PREFIX}${indexName}${INDEX_CONFIG_SUFFIX}`;
487
489
  }
488
490
  function validateDecodedMetadata(decoded, indexName) {
489
- if (!isRecord2(decoded)) {
491
+ if (!isRecord(decoded)) {
490
492
  throw new NarsilError(
491
493
  ErrorCodes.CONTROLLER_METADATA_INVALID,
492
494
  `Index metadata for '${indexName}' is not an object`,
@@ -521,7 +523,7 @@ function validateDecodedMetadata(decoded, indexName) {
521
523
  { indexName, replicationFactor: truncateForDisplay(decoded.replicationFactor) }
522
524
  );
523
525
  }
524
- if (!isRecord2(decoded.constraints)) {
526
+ if (!isRecord(decoded.constraints)) {
525
527
  throw new NarsilError(
526
528
  ErrorCodes.CONTROLLER_METADATA_INVALID,
527
529
  `Index metadata for '${indexName}' has invalid constraints`,
@@ -571,7 +573,7 @@ async function putGenerationMetadata(coordinator, sourceName, generation) {
571
573
  if (sourceBytes === null || sourceBytes.byteLength === 0) return false;
572
574
  const decoded = decode(sourceBytes);
573
575
  validateDecodedMetadata(decoded, sourceName);
574
- if (!isRecord2(decoded)) return false;
576
+ if (!isRecord(decoded)) return false;
575
577
  const current = await coordinator.get(key);
576
578
  if (current !== null && current.byteLength > 0) return true;
577
579
  const held = storedSynonymSetOf(sourceBytes);
@@ -582,7 +584,7 @@ async function putGenerationMetadata(coordinator, sourceName, generation) {
582
584
  copiedSetGeneration = held.ref.generation;
583
585
  continue;
584
586
  }
585
- const settings = isRecord2(decoded.settings) ? withoutSyncFields(decoded.settings) : decoded.settings;
587
+ const settings = isRecord(decoded.settings) ? withoutSyncFields(decoded.settings) : decoded.settings;
586
588
  const bytes = new Uint8Array(encode({ ...decoded, settings, ...generation }, { ignoreUndefined: true }));
587
589
  return coordinator.compareAndSet(key, current, bytes);
588
590
  }
@@ -595,12 +597,12 @@ async function readStoredMetadata(coordinator, indexName) {
595
597
  }
596
598
  const decoded = decode(raw);
597
599
  const record = validateDecodedMetadata(decoded, indexName);
598
- return { bytes: raw, record, rawSettings: isRecord2(decoded) ? decoded.settings : void 0 };
600
+ return { bytes: raw, record, rawSettings: isRecord(decoded) ? decoded.settings : void 0 };
599
601
  }
600
602
  function indexMetadataSnapshotOf(bytes, indexName) {
601
603
  const decoded = decode(bytes);
602
604
  const record = validateDecodedMetadata(decoded, indexName);
603
- const rawSettings = isRecord2(decoded) ? decoded.settings : void 0;
605
+ const rawSettings = isRecord(decoded) ? decoded.settings : void 0;
604
606
  return { bytes, record, settings: decodeIndexSettings(rawSettings, indexName) };
605
607
  }
606
608
  async function readIndexMetadataSnapshot(coordinator, indexName) {
@@ -610,15 +612,15 @@ async function readIndexMetadataSnapshot(coordinator, indexName) {
610
612
  }
611
613
  function metadataWithSynonymSet(snapshot, ref) {
612
614
  const decoded = decode(snapshot.bytes);
613
- const fields = isRecord2(decoded) ? decoded : {};
614
- const { synonyms: _replaced, ...settings } = isRecord2(fields.settings) ? fields.settings : { language: snapshot.settings?.language ?? getLanguage("english").name };
615
+ const fields = isRecord(decoded) ? decoded : {};
616
+ const { synonyms: _replaced, ...settings } = isRecord(fields.settings) ? fields.settings : { language: snapshot.settings?.language ?? getLanguage("english").name };
615
617
  const nextSettings = ref === null ? settings : { ...settings, synonyms: ref };
616
618
  return new Uint8Array(encode({ ...fields, settings: nextSettings }, { ignoreUndefined: true }));
617
619
  }
618
620
  function metadataWithBm25(snapshot, bm25, bm25Revision) {
619
621
  const decoded = decode(snapshot.bytes);
620
- const fields = isRecord2(decoded) ? decoded : {};
621
- const { bm25: _replaced, ...settings } = isRecord2(fields.settings) ? fields.settings : { language: snapshot.settings?.language ?? getLanguage("english").name };
622
+ const fields = isRecord(decoded) ? decoded : {};
623
+ const { bm25: _replaced, ...settings } = isRecord(fields.settings) ? fields.settings : { language: snapshot.settings?.language ?? getLanguage("english").name };
622
624
  const nextSettings = { ...settings, bm25Revision, ...bm25 !== void 0 ? { bm25 } : {} };
623
625
  return new Uint8Array(encode({ ...fields, settings: nextSettings }, { ignoreUndefined: true }));
624
626
  }
@@ -635,7 +637,7 @@ async function putIndexReplicationFactor(coordinator, indexName, replicationFact
635
637
  if (record.replicationFactor === replicationFactor) {
636
638
  return record;
637
639
  }
638
- const updated = encode(isRecord2(decoded) ? { ...decoded, replicationFactor } : decoded, { ignoreUndefined: true });
640
+ const updated = encode(isRecord(decoded) ? { ...decoded, replicationFactor } : decoded, { ignoreUndefined: true });
639
641
  if (await coordinator.compareAndSet(key, raw, new Uint8Array(updated))) {
640
642
  return { ...record, replicationFactor };
641
643
  }
@@ -682,7 +684,7 @@ function decodedMetadataOf(bytes) {
682
684
  } catch {
683
685
  return null;
684
686
  }
685
- return isRecord2(decoded) ? decoded : null;
687
+ return isRecord(decoded) ? decoded : null;
686
688
  }
687
689
  function indexUuidOfStoredMetadata(bytes) {
688
690
  const decoded = decodedMetadataOf(bytes);
@@ -690,9 +692,9 @@ function indexUuidOfStoredMetadata(bytes) {
690
692
  }
691
693
  function storedSynonymSetOf(bytes) {
692
694
  const decoded = decodedMetadataOf(bytes);
693
- if (decoded === null || typeof decoded.indexUuid !== "string" || !isRecord2(decoded.settings)) return null;
695
+ if (decoded === null || typeof decoded.indexUuid !== "string" || !isRecord(decoded.settings)) return null;
694
696
  const ref = synonymSetRefOrNull(decoded.settings.synonyms);
695
697
  return ref === null ? null : { indexUuid: decoded.indexUuid, ref };
696
698
  }
697
699
 
698
- export { ALLOCATION_CAS_ATTEMPTS, ALLOCATION_RETRY_DELAY_MS, ANALYSIS_CHANGE_POLL_INTERVAL_MS, ANALYSIS_CHANGE_RETRY_MS, ANALYSIS_REBUILD_RESEND_MS, BOOTSTRAP_CAS_ATTEMPTS, DEFAULT_CONTROLLER_CONFIG, DEFAULT_NODE_LIFECYCLE_CONFIG, ESTIMATED_PARTITION_BYTES, HIDDEN_GENERATION_PREFIX, LEADERSHIP_IMBALANCE_THRESHOLD, MAX_RESHARD_CUTOVER_ATTEMPTS, PARTITION_STORES_TIMEOUT_MS, REBALANCE_THRESHOLD, RECOVERY_CAS_ATTEMPTS, RESHARD_CONTROLLER_POLL_INTERVAL_MS, RESHARD_CUTOVER_LAG_ENTRIES, RESHARD_CUTOVER_TIMEOUT_MS, RESHARD_FORWARD_BATCH_DOCUMENTS, RESHARD_POLL_INTERVAL_MS, RESHARD_RECORD_CAS_ATTEMPTS, RESHARD_RECORD_CHECK_INTERVAL_MS, RESHARD_RETRY_DELAY_MS, SYNC_EPOCH_CAS_ATTEMPTS, TEARDOWN_CAS_ATTEMPTS, TEARDOWN_RETRY_DELAY_MS, TEARDOWN_RETRY_ROUNDS, UNFED_REPLICA_CHECK_INTERVAL_MS, UNFED_REPLICA_RESYNC_MS, decodeIndexSettings, deleteSynonymSet, epochFeaturesOn, getClusterIndexConfig, getIndexMetadata, indexConfigFromSettings, indexConfigKey, indexMetadataSnapshotOf, indexSettingsOf, indexUuidOfStoredMetadata, isRecord, isRecord2, isValidInteger, metadataWithBm25, metadataWithSuggestionState, metadataWithSync, metadataWithSynonymSet, putGenerationMetadata, putIndexMetadata, putIndexReplicationFactor, readIndexMetadataSnapshot, readIndexState, storeSynonymSet, storedSynonymSetOf, suggestionStateOfSettings, syncSettingsOfSnapshot, validateIndexName, withPartitionCount };
700
+ export { ALLOCATION_CAS_ATTEMPTS, ALLOCATION_RETRY_DELAY_MS, ANALYSIS_CHANGE_POLL_INTERVAL_MS, ANALYSIS_CHANGE_RETRY_MS, ANALYSIS_REBUILD_RESEND_MS, BOOTSTRAP_CAS_ATTEMPTS, DEFAULT_CONTROLLER_CONFIG, DEFAULT_NODE_LIFECYCLE_CONFIG, ESTIMATED_PARTITION_BYTES, HIDDEN_GENERATION_PREFIX, LEADERSHIP_IMBALANCE_THRESHOLD, MAX_RESHARD_CUTOVER_ATTEMPTS, PARTITION_STORES_TIMEOUT_MS, REBALANCE_THRESHOLD, RECOVERY_CAS_ATTEMPTS, RESHARD_CONTROLLER_POLL_INTERVAL_MS, RESHARD_CUTOVER_LAG_ENTRIES, RESHARD_CUTOVER_TIMEOUT_MS, RESHARD_FORWARD_BATCH_DOCUMENTS, RESHARD_POLL_INTERVAL_MS, RESHARD_RECORD_CAS_ATTEMPTS, RESHARD_RECORD_CHECK_INTERVAL_MS, RESHARD_RETRY_DELAY_MS, SYNC_EPOCH_CAS_ATTEMPTS, TEARDOWN_CAS_ATTEMPTS, TEARDOWN_RETRY_DELAY_MS, TEARDOWN_RETRY_ROUNDS, UNFED_REPLICA_CHECK_INTERVAL_MS, UNFED_REPLICA_RESYNC_MS, decodeIndexSettings, deleteSynonymSet, epochFeaturesOn, getClusterIndexConfig, getIndexMetadata, indexConfigFromSettings, indexConfigKey, indexMetadataSnapshotOf, indexSettingsOf, indexUuidOfStoredMetadata, isRecord2 as isRecord, isRecord as isRecord2, isValidInteger, metadataWithBm25, metadataWithSuggestionState, metadataWithSync, metadataWithSynonymSet, putGenerationMetadata, putIndexMetadata, putIndexReplicationFactor, readIndexMetadataSnapshot, readIndexState, storeSynonymSet, storedSynonymSetOf, suggestionStateOfSettings, syncSettingsOfSnapshot, validateIndexName, withPartitionCount };