Framework
FlashcoreConfig
Interface: FlashcoreConfig
Configuration for the Flashcore v1 client.
Properties
| Property | Type | Description |
|---|---|---|
adapter | FlashcoreAdapter<string, unknown> | The storage adapter. |
autoRepair? | | boolean | { catalog: boolean; filter: boolean; indexes: boolean; uniqueIndexes: boolean; } | Auto-repair configuration. |
connection? | { maxRetries: number; retryBaseDelay: number; retryMaxDelay: number; } | Connection/retry settings. |
connection.maxRetries? | number | - |
connection.retryBaseDelay? | number | - |
connection.retryMaxDelay? | number | - |
indexPersistence? | { flushOnShutdown: boolean; intervalMs: number; maxInMemoryRecords: number; memoryLimit: number; shutdownTimeout: number; strategy: "immediate" | "batched" | "periodic"; } | Index persistence configuration. |
indexPersistence.flushOnShutdown? | boolean | - |
indexPersistence.intervalMs? | number | - |
indexPersistence.maxInMemoryRecords? | number | Maximum records to hold in memory before evicting (default: 100000) |
indexPersistence.memoryLimit? | number | Maximum memory for indexes in bytes (default: 50MB) |
indexPersistence.shutdownTimeout? | number | - |
indexPersistence.strategy? | "immediate" | "batched" | "periodic" | - |
kvReadPreference? | "legacy" | "v1" | KV read preference for dual-key resolution. - 'legacy': prefer legacy composed key format (default for robo.js import) - 'v1': prefer safe encoded key format (default for robo.js/flashcore import) |
kvWriteMode? | "legacy" | "v1" | "dual" | KV write mode for key storage. - 'legacy': write only legacy key format - 'v1': write only safe key format - 'dual': write both formats (for migration) |
lazyLoading? | boolean | Enable lazy loading of catalogs/indexes. |
namespaceSeparator? | string | Namespace separator for joining array namespaces. Default: '/' |
plugins? | FlashcorePlugin[] | Flashcore plugins to apply. |
safety? | { maxBulkOperationWithoutWhere: number; maxDefaultResults: number; warnResultsThreshold: number; } | Safety limits. |
safety.maxBulkOperationWithoutWhere? | number | - |
safety.maxDefaultResults? | number | - |
safety.warnResultsThreshold? | number | - |
transactions? | { maxRetries: number; mode: "auto" | "native" | "batch" | "optimistic" | "serial" | "single"; retryDelay: number; timeout: number; } | Transaction configuration. |
transactions.maxRetries? | number | - |
transactions.mode? | "auto" | "native" | "batch" | "optimistic" | "serial" | "single" | - |
transactions.retryDelay? | number | - |
transactions.timeout? | number | - |
wal? | WALConfig | WAL configuration (Phase 4). |