Function getEmbeddedFileStream

src/attachments/file-spec.ts:136–158

(fileSpec: PdfDict, resolver: RefResolver)

 * @returns The stream if found, null if external reference or missing
 */
export function getEmbeddedFileStream(fileSpec: PdfDict, resolver: RefResolver): PdfStream | null {
  // Get /EF (embedded file dictionary)
  const ef = fileSpec.getDict("EF", resolver);

  if (!ef) {
    return null; // External file reference
  }

  // Get /F entry (or /UF) from EF dict - points to the stream
  const streamRef = ef.getRef("F") ?? ef.getRef("UF");

  if (!streamRef) {
    return null;
  }

  const stream = resolver(streamRef);

  if (stream instanceof PdfStream) {
    return stream;
  }

  return null;
}

/**
 * Parse a FileSpec dictionary into AttachmentInfo.