DSAR-FS-1001: STORAGE_FILESYSTEM_RETRY_EXHAUSTED

Meaning

A filesystem storage operation failed after exhausting all configured retry attempts.

Probable Causes

• Persistent I/O errors (permission denied, disk full, file locked) across all retries.
• The target directory or mount point became unavailable during operation.
• Retry budget (retryMaxAttempts) is too low for the current error rate.

How to Fix

1. Inspect error.details.lastError for the message of the final failed attempt.
2. Verify the storage directory exists and has correct read/write permissions.
3. Check available disk space on the target volume.
4. Increase retryMaxAttempts in the storage adapter configuration if appropriate.

Retryable

No — retries are already exhausted. Address the root cause before retrying the outer operation.

Minimal Trigger Example

import { makeFilesystemStorageAdapter } from "@dsar/storage-filesystem";

const adapter = makeFilesystemStorageAdapter({
	baseDir: "/unwritable-path",
	retryMaxAttempts: 2,
});

try {
	await adapter.putObject({
		bytes: new TextEncoder().encode("{}"),
		contentType: "application/json",
		key: "requests/req-1.json",
	});
} catch (error) {
	if (error && typeof error === "object" && "code" in error) {
		if (error.code === "DSAR-FS-1001") {
			console.error("Last filesystem error:", error.details?.lastError);
		}
	}
}