webmail/lib/stored-data-errors.ts

import { NextResponse } from 'next/server';
import { StoreUnavailableError } from '@/lib/shared-store/types';

/**
 * A user's stored document exists but can't be read: it doesn't decrypt
 * (another session secret), it is cut short, or the read failed. It is not
 * the same as "nothing stored": a route that treated it as empty would merge
 * into nothing and overwrite the user's real data on the next save. Routes
 * answer 503 and write nothing.
 */
export class StoredDataUnreadableError extends Error {
  constructor(what: string, options?: { cause?: unknown }) {
    super(`Stored ${what} could not be read`, options);
    this.name = 'StoredDataUnreadableError';
  }
}

/** True for the errors that mean "try again later, nothing was written". */
export function isStoredDataUnavailable(error: unknown): boolean {
  return error instanceof StoredDataUnreadableError || error instanceof StoreUnavailableError;
}

/**
 * The 503 for an unreadable document or an unreachable shared store, or null
 * for any other error. The client keeps its own copy and retries.
 */
export function storedDataUnavailableResponse(
  error: unknown,
  headers?: Record<string, string>,
): NextResponse | null {
  if (error instanceof StoredDataUnreadableError) {
    return NextResponse.json(
      { error: 'Your stored data could not be read on the server. Nothing was changed.', code: 'stored_data_unreadable' },
      { status: 503, headers: { 'Retry-After': '10', ...headers } },
    );
  }
  if (error instanceof StoreUnavailableError) {
    return NextResponse.json(
      { error: 'Storage is temporarily unavailable. Nothing was changed.', code: 'store_unavailable' },
      { status: 503, headers: { 'Retry-After': '10', ...headers } },
    );
  }
  return null;
}