David Snelling
352e356fd5
Three additive surfaces for native index providers, which hold only `storage` and must never construct their own fact-log reader (the log's open path is writer-side — it reconciles by truncating/rewriting): - Fact-scan capability on the storage adapter (the getBinaryBlobPath pattern): the host brain wires a closure over its LIVE fact log at init; providers call storage.scanFacts()/factLogHeadGeneration()/ factSegmentPaths() and fall back to the enumeration walk on null. Restore/reopen swaps the underlying log transparently. - The family-stamp trio (readFamilyStamp/writeFamilyStamp/ verifyFamilyStamp + types) exported from @soulcraft/brainy/internals, so 'one verifier' is literally one function shared with the native side, never two synchronized copies. - Rollup invariants widened to number|string: content fingerprints (e.g. a per-tree SHA-256) are valid invariant values; strict equality either way, and a type mismatch reads as incoherence, never a pass.
47 lines
2.2 KiB
TypeScript
47 lines
2.2 KiB
TypeScript
/**
|
|
* Internal utilities for first-party plugins.
|
|
* NOT part of the public API — may change between minor versions.
|
|
*/
|
|
export { getGlobalCache, setGlobalCache, clearGlobalCache, UnifiedCache } from './utils/unifiedCache.js'
|
|
export type { UnifiedCacheConfig, CacheItem } from './utils/unifiedCache.js'
|
|
export { prodLog, createModuleLogger } from './utils/logger.js'
|
|
export { FieldTypeInference, FieldType } from './utils/fieldTypeInference.js'
|
|
export type { FieldTypeInfo } from './utils/fieldTypeInference.js'
|
|
export {
|
|
EntityIdMapper,
|
|
EntityIdSpaceExceeded,
|
|
U32_ENTITY_ID_MAX,
|
|
} from './utils/entityIdMapper.js'
|
|
export type { EntityIdMapperOptions, EntityIdMapperData } from './utils/entityIdMapper.js'
|
|
export { getRecommendedCacheConfig, formatBytes, checkMemoryPressure } from './utils/memoryDetection.js'
|
|
export type { MemoryInfo, CacheAllocationStrategy } from './utils/memoryDetection.js'
|
|
// Entity field resolution — single source of truth for reading fields off
|
|
// HNSWNounWithMetadata. First-party plugins (Cor) use this to stay in
|
|
// lockstep with the entity shape contract.
|
|
export { resolveEntityField, STANDARD_ENTITY_FIELDS } from './coreTypes.js'
|
|
|
|
// The generalized family stamp — ONE verifier, both member modes, shared
|
|
// verbatim with native providers so stamp verification is literally one
|
|
// function, never two synchronized copies. Providers write the same shape
|
|
// (their set-swap rewrites stamps, so adoption is migration-free).
|
|
export {
|
|
readFamilyStamp,
|
|
writeFamilyStamp,
|
|
verifyFamilyStamp,
|
|
FAMILY_STAMPS_PREFIX,
|
|
ENTITY_TREE_STAMP_PATH
|
|
} from './db/familyStamp.js'
|
|
export type {
|
|
FamilyStamp,
|
|
StampMembers,
|
|
StampVerdict,
|
|
EnumeratedMember,
|
|
StampStorage
|
|
} from './db/familyStamp.js'
|
|
|
|
// Generation fact-log types — the scan surface a provider reaches through the
|
|
// storage capability (`storage.scanFacts` / `storage.factLogHeadGeneration` /
|
|
// `storage.factSegmentPaths`, wired by the host brain at init). Providers
|
|
// never construct a FactLog themselves: open() is writer-side (it reconciles
|
|
// by truncating/rewriting) and there is exactly one writer.
|
|
export type { CommitFact, FactOp, FactScanBatch, FactScanHandle } from './db/factLog.js'
|