@cloudbitmaps/core 0.20.0 → 0.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (77) hide show
  1. package/README.md +101 -5
  2. package/dist/{chunk-YSC7NJWV.js → chunk-OSU7W2Y3.js} +811 -164
  3. package/dist/chunk-OSU7W2Y3.js.map +7 -0
  4. package/dist/core/audit.d.ts +12 -2
  5. package/dist/core/bit-route.d.ts +9 -1
  6. package/dist/core/blob.d.ts +12 -1
  7. package/dist/core/codec.d.ts +1 -1
  8. package/dist/core/combine-expr.d.ts +10 -8
  9. package/dist/core/combine-feed.d.ts +12 -18
  10. package/dist/core/combine-many.d.ts +29 -22
  11. package/dist/core/concurrency.d.ts +8 -0
  12. package/dist/core/consistency.d.ts +69 -17
  13. package/dist/core/crbm/reader.d.ts +52 -6
  14. package/dist/core/crbm-storage-source.d.ts +65 -452
  15. package/dist/core/crypto.d.ts +6 -1
  16. package/dist/core/determinism.d.ts +2 -1
  17. package/dist/core/engine.d.ts +222 -33
  18. package/dist/core/erase-id.d.ts +60 -15
  19. package/dist/core/erasure.d.ts +5 -4
  20. package/dist/core/errors.d.ts +61 -11
  21. package/dist/core/leases.d.ts +4 -3
  22. package/dist/core/load.d.ts +58 -45
  23. package/dist/core/lru.d.ts +2 -15
  24. package/dist/core/metrics.d.ts +5 -3
  25. package/dist/core/pinned-storage-source.d.ts +4 -4
  26. package/dist/core/ports.d.ts +96 -22
  27. package/dist/core/registry-scan.d.ts +0 -7
  28. package/dist/core/retention-sweep.d.ts +70 -66
  29. package/dist/core/retention.d.ts +2 -2
  30. package/dist/core/retry.d.ts +15 -18
  31. package/dist/core/rollback.d.ts +61 -31
  32. package/dist/core/validate.d.ts +2 -0
  33. package/dist/driver-kit.d.ts +11 -2
  34. package/dist/driver-kit.js +84 -16
  35. package/dist/driver-kit.js.map +3 -3
  36. package/dist/drivers/_shared/bytes.d.ts +6 -0
  37. package/dist/drivers/_shared/faults.d.ts +15 -0
  38. package/dist/drivers/_shared/object-keys.d.ts +18 -0
  39. package/dist/drivers/_shared/object-registry-keys.d.ts +0 -2
  40. package/dist/drivers/_shared/object-registry.d.ts +2 -0
  41. package/dist/drivers/_shared/options.d.ts +19 -0
  42. package/dist/drivers/backends.d.ts +2 -0
  43. package/dist/drivers/crypto.d.ts +1 -1
  44. package/dist/export/index.d.ts +9 -8
  45. package/dist/index.d.ts +11 -10
  46. package/dist/index.js +4202 -2833
  47. package/dist/index.js.map +4 -4
  48. package/package.json +7 -2
  49. package/dist/chunk-YSC7NJWV.js.map +0 -7
  50. package/dist/core/chunk-checks.d.ts +0 -34
  51. package/dist/core/chunk-stream.d.ts +0 -22
  52. package/dist/core/chunk-window.d.ts +0 -30
  53. package/dist/core/combine-ledger.d.ts +0 -43
  54. package/dist/core/crbm/crc32c.d.ts +0 -10
  55. package/dist/core/crbm/fingerprint.d.ts +0 -18
  56. package/dist/core/crbm/format.d.ts +0 -151
  57. package/dist/core/crbm/frame.d.ts +0 -10
  58. package/dist/core/crbm/plan-reads.d.ts +0 -44
  59. package/dist/core/crbm/varint.d.ts +0 -13
  60. package/dist/core/crbm/writer.d.ts +0 -68
  61. package/dist/core/due-index.d.ts +0 -53
  62. package/dist/core/generation-gc.d.ts +0 -179
  63. package/dist/core/item-pull.d.ts +0 -29
  64. package/dist/core/kept-generations.d.ts +0 -40
  65. package/dist/core/metadata.d.ts +0 -42
  66. package/dist/core/reader-defaults.d.ts +0 -29
  67. package/dist/core/summary.d.ts +0 -78
  68. package/dist/core/token.d.ts +0 -41
  69. package/dist/drivers/_shared/entropy.d.ts +0 -5
  70. package/dist/drivers/_shared/registry.d.ts +0 -104
  71. package/dist/drivers/localfs/exact-case.d.ts +0 -37
  72. package/dist/drivers/localfs/fs-util.d.ts +0 -33
  73. package/dist/drivers/localfs/paths.d.ts +0 -40
  74. package/dist/drivers/localfs/registry.d.ts +0 -44
  75. package/dist/drivers/localfs/storage.d.ts +0 -21
  76. package/dist/drivers/memory.d.ts +0 -61
  77. package/dist/testing/fuzz-core.d.ts +0 -15
package/dist/index.d.ts CHANGED
@@ -7,10 +7,11 @@
7
7
  * {@link CodecInterface} seam, so a *flavor* package (`@cloudbitmaps/roaring` today) supplies the codec and a
8
8
  * facade on top.
9
9
  *
10
- * **You normally install a flavor, not this package** — `pnpm add @cloudbitmaps/roaring` pulls this in
11
- * transitively and re-exports, by name, what an application uses, so `@cloudbitmaps/roaring` is the one name to
12
- * know. The engine, the standalone forms of the store's methods and the retry and budget internals stay here:
13
- * depend on `core` directly only when authoring a new flavor or a driver.
10
+ * **This entry is internal.** It is the engine `@cloudbitmaps/roaring` and the storage-driver packages import, and it is
11
+ * outside the stability promise: it can change in any minor release, and a change to it gets no CHANGELOG Breaking
12
+ * entry. Install `@cloudbitmaps/roaring` and a driver; `@cloudbitmaps/roaring` re-exports, by name, what an application
13
+ * uses. The public entry of this package is `@cloudbitmaps/core/driver-kit`, the contract for writing a driver.
14
+ * Within a minor, this entry changes only additively: a removal or a changed signature waits for the next minor.
14
15
  *
15
16
  * Nothing in here may import a flavor package — the dependency arrow is one-way (flavor → core), so core stays
16
17
  * publishable on its own and every codec reuses one driver set with zero duplication.
@@ -26,7 +27,6 @@ export { mapWithConcurrency } from './core/concurrency.js';
26
27
  export { resolveBudget, resolvePerOpBudget, checkBudget, collectWithinBudget } from './core/budget.js';
27
28
  export { segmentExists, listSegments } from './core/discover.js';
28
29
  export type { SegmentInfo } from './core/discover.js';
29
- export type { Token } from './core/ports.js';
30
30
  export { segmentKey } from './core/keys.js';
31
31
  export { isStorageBackend } from './core/ports.js';
32
32
  export { LocalFsStorage, MemoryStorage } from './drivers/backends.js';
@@ -39,7 +39,7 @@ export { PinnedStorageChunkSource } from './core/pinned-storage-source.js';
39
39
  export type { PinnedAt } from './core/pinned-storage-source.js';
40
40
  export { judgeLoad, loadSegment, loadSegmentChunks } from './core/load.js';
41
41
  export { compileCombineMany, rebindCombineMany, runCombineMany } from './core/combine-many.js';
42
- export type { CombineExpr, CombineManyDeps, CombineManyFeed, CombineManyFeedRecord, CombineManyOperand, CombineManyOperandStats, CombineManyOutcome, CombineManyOutput, CombineManyOutputStats, CombineManyRequest, CombineManyRun, CombineManyStats, CombineManyWrite, CompiledCombineMany, } from './core/combine-many.js';
42
+ export type { CombineManyDeps, CombineManyFeed, CombineManyOperand, CombineManyOutcome, CombineManyOutput, CombineManyRequest, CombineManyRun, CombineManyWrite, CompiledCombineMany, Expr, MaterializeManyFeedRecord, MaterializeManyOperandStats, MaterializeManyOutputStats, MaterializeManyStats, } from './core/combine-many.js';
43
43
  export type { LoadDeps, LoadOptions, LoadGuard, GuardRefusal, LoadJudgement, LoadResult, LoadRefusal, } from './core/load.js';
44
44
  export type { LoadInput, PortableBitmap } from './core/load-input.js';
45
45
  export { decodeSerialized } from './core/load-input.js';
@@ -49,9 +49,9 @@ export { eraseIdFromSegment } from './core/erase-id.js';
49
49
  export type { EraseIdDeps, EraseIdResult } from './core/erase-id.js';
50
50
  export type { CodecInterface, CodecBitmap, EncodedChunk } from './core/codec.js';
51
51
  export type { Clock, Entropy, Rng } from './core/determinism.js';
52
- export type { StorageChunkSource, IStorageDriver, StorageCaps, StorageDeleteOptions, TailRead, ChunkRef, ChunkRead, ReadChunksOptions, SegmentRef, GenKey, IRegistryDriver, StorageBackend, RegistryRecord, NewRegistryRecord, RegistryPatch, RegistryStatus, RegistrySummary, RegistryWriteOptions, LeaseEntry, ClearRegistrySummary, SealedRegistrySummary, GenerationMetadata, GenerationSummary, RegCaps, GovernanceMeta, SegmentSize, } from './core/ports.js';
53
- export { CloudRoaringError, ValidationError, WriteConflictError, IntegrityError, NotFoundError, UnsupportedError, CapabilityError, TransientError, KeyUnavailableError, BudgetExceededError, LeaseExpiredError, LeaseLimitError, StaleOperandError, isCloudRoaringError, isWriteConflictError, isTransientError, isNotFoundError, isIntegrityError, isValidationError, isLeaseExpiredError, isLeaseLimitError, isStaleOperandError, isUnsupportedError, isCapabilityError, isBudgetExceededError, isKeyUnavailableError, } from './core/errors.js';
54
- export type { Aead, AeadSealed, IKeystore, WrappedDek, CrbmCrypto } from './core/crypto.js';
52
+ export type { SegmentRef, GenerationMetadata } from './core/ports.js';
53
+ export { CloudRoaringError, ValidationError, WriteConflictError, IntegrityError, NotFoundError, UnsupportedError, CapabilityError, TransientError, KeyUnavailableError, BudgetExceededError, LeaseExpiredError, LeaseLimitError, StaleOperandError, errorKind, } from './core/errors.js';
54
+ export type { CrbmCrypto } from './core/crypto.js';
55
55
  export { aadFor } from './core/crypto.js';
56
56
  export { NodeAead, InProcessKeystore } from './drivers/crypto.js';
57
57
  export type { InProcessKeystoreOptions } from './drivers/crypto.js';
@@ -64,6 +64,7 @@ export { excludingReservedRows } from './core/registry-scan.js';
64
64
  export type { RetireExpiredOptions, RetireExpiredResult, RetireEntry, } from './core/retention-sweep.js';
65
65
  export { DEFAULT_BUDGET } from './core/budget.js';
66
66
  export type { Budget, BudgetOption } from './core/budget.js';
67
+ export type { ErrorKind } from './core/errors.js';
67
68
  export { runConsistencyCheck } from './core/consistency.js';
68
69
  export type { ConsistencyReport, ConsistencyIssue, ConsistencyErrorEntry, } from './core/consistency.js';
69
70
  export type { ExportFormat, ExportSink, ExportWriter, ExportOptions, ExportedSegment, ExportFailure, ExportManifest, ExportSkipped, } from './export/index.js';
@@ -74,7 +75,7 @@ export type { RetryingOptions } from './drivers/retry/retrying-chunk-source.js';
74
75
  export { CrbmReader } from './core/crbm/reader.js';
75
76
  export type { CrbmReaderOptions } from './core/crbm/reader.js';
76
77
  export { BufferReader } from './core/blob.js';
77
- export type { BlobReader, BlobSink } from './core/blob.js';
78
+ export type { BlobReader } from './core/blob.js';
78
79
  export { NOOP_METRICS, CountingMetricsSink } from './core/metrics.js';
79
80
  export type { IMetricsSink, MetricEvent, MetricOpName, MetricsSnapshot } from './core/metrics.js';
80
81
  export { RecordingAuditSink } from './core/audit.js';