Class Bundle

js/bundle/src/decoder.ts:25–189

/** This class represents parsed Web Bundle. */
export class Bundle {
  version: FormatVersion;
  private b1PrimaryURL: string | null = null; // only valid in format version b1
  private sections: { [key: string]: unknown } = {};
  private responses: { [key: number]: Response } = {}; // Offset-in-responses -> resp
  private compatAdapter: CompatAdapter;

  constructor(buffer: Uint8Array) {
    const wbn = asArray(cborg.decode(buffer, { useMaps: true }));

    let peekVersion = bytestringToString(wbn[1]).replace(/\0+$/, '');
    if (!isApprovedVersion(peekVersion)) {
      throw new Error('Unsupported web bundle version.');
    }
    this.compatAdapter = this.createCompatAdapter(peekVersion);

    if (wbn.length !== this.compatAdapter.wbnLength) {
      throw new Error(
        `Wrong toplevel structure ${peekVersion} ${wbn.length} ${this.compatAdapter.wbnLength}`
      );
    }
    const [
      magic,
      version,
      primaryURL, // null in format version b2
      sectionLengthsCBOR,
      sections,
      length,
    ] = this.compatAdapter.destructureBundle(wbn);
    if (bytestringToString(magic) !== '🌐📦') {
      throw new Error('Wrong magic');
    }
    const tempVersion = bytestringToString(version).replace(/\0+$/, ''); // Strip off the '\0' paddings.
    if (!isApprovedVersion(tempVersion)) {
      throw new Error('Unsupported web bundle version.');
    }
    this.version = tempVersion;

    if (primaryURL) {
      this.b1PrimaryURL = asString(primaryURL);
    }
    const sectionLengths = asArray(
      cborg.decode(asBytestring(sectionLengthsCBOR), { useMaps: true })
    );
    const sectionsArray = asArray(sections);
    if (sectionLengths.length !== sectionsArray.length * 2) {
      throw new Error(
        "Number of elements in section-lengths and in sections don't match"
      );
    }
    for (let i = 0; i < sectionsArray.length; i++) {
      this.sections[asString(sectionLengths[i * 2])] = sectionsArray[i];
    }

    if (this.sections['critical']) {
      for (const name of asArray(this.sections['critical'])) {
        if (!knownSections.includes(asString(name))) {
          throw new Error(`unknown section ${name} is marked as critical`);