FileSystemStorageProvider

reference

1 min readUpdated 2026-07-29

Kind: Class

Source: atloria-monorepo/libs/parser-core/src/storage/file-system-storage.provider.ts

File system storage provider implementation

Implements: IStorageProvider

Methods

Method	Signature	Returns
`getMode`	`getMode()`	`StorageMode`
`initialize`	`initialize()`	`Promise<void>`
`saveScreenshot`	`saveScreenshot(buffer: Buffer, metadata: ScreenshotMetadata)`	`Promise<ScreenshotSaveResult>`
`findExistingScreenshot`	`findExistingScreenshot(metadata: Partial<ScreenshotMetadata>)`	`Promise<ScreenshotSaveResult
`saveDocument`	`saveDocument(document: DocumentMetadata)`	`Promise<DocumentSaveResult>`
`documentExists`	`documentExists(_projectId: string, categoryPath: string[], slug: string)`	`Promise<boolean>`
`listDocuments`	`listDocuments(_projectId: string, categoryPath: string[])`	`Promise<Array<{ id: string; title: string; slug: string; url: string }>>`

FileSystemStorageProvider stops the work with an early return when existing.
FileSystemStorageProvider stops the work with an early return when query.projectId && stored.projectId !== query.projectId.
FileSystemStorageProvider stops the work with an early return when query.url && stored.url !== query.url.
FileSystemStorageProvider stops the work with an early return when stored.viewport.width !== query.viewport.width || stored.viewport.height !== query.viewpo….
FileSystemStorageProvider stops the work with an early return when query.stateType && stored.stateType !== query.stateType.
FileSystemStorageProvider stops the work with an early return when query.flowStepId && stored.flowStepId !== query.flowStepId.

FileSystemStorageProvider handles failure in 5 places: it turns it into a return value in 3, and discards it silently in 2. A failure discarded silently leaves no trace for whoever debugs this later.