@storyteller-platform/epub 0.7.1 → 0.8.1

package/dist/index.cjs

@@ -1,2846 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var index_exports = {};
-__export(index_exports, {
-  Epub: () => Epub,
-  EpubFactory: () => EpubFactory,
-  EpubReadOnlyError: () => EpubReadOnlyError,
-  EpubVersionError: () => EpubVersionError,
-  MemoryAdapter: () => import_memory.MemoryAdapter,
-  TmpFsAdapter: () => import_tmpfs2.TmpFsAdapter
-});
-module.exports = __toCommonJS(index_exports);
-var import_promises = require("node:fs/promises");
-var import_async_mutex = require("async-mutex");
-var import_fast_xml_parser = require("fast-xml-parser");
-var import_mem = __toESM(require("mem"), 1);
-var import_nanoid = require("nanoid");
-var import_media_types = require("@storyteller-platform/media-types");
-var import_path = require("@storyteller-platform/path");
-var import_tmpfs = require("./adapters/tmpfs.cjs");
-var Upgrade = __toESM(require("./upgrade.ts"), 1);
-var import_memory = require("./adapters/memory.cjs");
-var import_tmpfs2 = require("./adapters/tmpfs.cjs");
-class EpubVersionError extends Error {
-}
-class EpubReadOnlyError extends Error {
-}
-const OPF_NAMESPACE = "http://www.idpf.org/2007/opf";
-const ENTRY_ORIGIN = "epub:///";
-function entryToUrlPath(entry) {
-  return entry.split("/").map(encodeURIComponent).join("/");
-}
-function resolveEntryUrl(from, href) {
-  const base = new URL(entryToUrlPath(from), ENTRY_ORIGIN);
-  if (!URL.canParse(href, base.toString())) return null;
-  const url = new URL(href, base);
-  return url.href.startsWith(ENTRY_ORIGIN) ? url : null;
-}
-function renameOpfAttributes(attrs, prefix) {
-  const attrPrefix = `@_${prefix}:`;
-  const renamed = {};
-  for (const [key, value] of Object.entries(attrs)) {
-    if (key === `@_xmlns:${prefix}`) continue;
-    if (key.startsWith(attrPrefix)) {
-      renamed[`@_opf:${key.slice(attrPrefix.length)}`] = value;
-    } else {
-      renamed[key] = value;
-    }
-  }
-  return renamed;
-}
-function stripOpfPrefix(node, prefix) {
-  if (Epub.isXmlTextNode(node)) return node;
-  const name = Epub.getXmlElementName(node);
-  const bareName = name.startsWith(`${prefix}:`) ? name.slice(prefix.length + 1) : name;
-  const element = {
-    [bareName]: Epub.getXmlChildren(node).map(
-      (child) => stripOpfPrefix(child, prefix)
-    )
-  };
-  if (node[":@"]) {
-    element[":@"] = renameOpfAttributes(node[":@"], prefix);
-  }
-  return element;
-}
-function normalizeOpfNamespacePrefixes(doc) {
-  var _a;
-  const root = doc.find(
-    (node) => !Epub.isXmlTextNode(node) && Epub.getXmlElementName(node).endsWith(":package")
-  );
-  if (!root) return doc;
-  const prefix = Epub.getXmlElementName(root).slice(0, -":package".length);
-  if (((_a = root[":@"]) == null ? void 0 : _a[`@_xmlns:${prefix}`]) !== OPF_NAMESPACE) return doc;
-  const stripped = stripOpfPrefix(root, prefix);
-  stripped[":@"] = {
-    ...stripped[":@"],
-    "@_xmlns": OPF_NAMESPACE,
-    "@_xmlns:opf": OPF_NAMESPACE
-  };
-  doc[doc.indexOf(root)] = stripped;
-  return doc;
-}
-class Epub {
-  /**
-   * Prefer the static factories ({@link Epub.using}, {@link Epub.from},
-   * {@link Epub.create}, {@link Epub.upgrade}) over calling this constructor
-   * directly. It's public so {@link EpubFactory} can construct instances; nothing
-   * else should need to.
-   */
-  constructor(adapterClass, adapter, inputPath, readonlyOverride = false) {
-    this.adapterClass = adapterClass;
-    this.adapter = adapter;
-    this.inputPath = inputPath;
-    this.readonlyOverride = readonlyOverride;
-    this.storage = adapterClass.kind;
-    this.readXhtmlItemContents = (0, import_mem.default)(
-      this.readXhtmlItemContents.bind(this),
-      // This isn't unnecessary, the generic here just isn't handling the
-      // overloaded method type correctly
-      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-      { cacheKey: ([id, as]) => `${id}:${as ?? "xhtml"}` }
-    );
-  }
-  static xmlParser = new import_fast_xml_parser.XMLParser({
-    allowBooleanAttributes: true,
-    preserveOrder: true,
-    ignoreAttributes: false,
-    parseTagValue: false
-  });
-  static xhtmlParser = (() => {
-    const parser = new import_fast_xml_parser.XMLParser({
-      allowBooleanAttributes: true,
-      alwaysCreateTextNode: true,
-      preserveOrder: true,
-      ignoreAttributes: false,
-      htmlEntities: true,
-      trimValues: false,
-      stopNodes: ["*.pre", "*.script"],
-      parseTagValue: false,
-      updateTag(_tagName, _jPath, attrs) {
-        if (attrs && "@_/" in attrs) {
-          delete attrs["@_/"];
-        }
-        return true;
-      }
-    });
-    parser.addEntity("nbsp", "\xA0");
-    parser.addEntity("#160", "\xA0");
-    return parser;
-  })();
-  static xmlBuilder = new import_fast_xml_parser.XMLBuilder({
-    preserveOrder: true,
-    format: true,
-    ignoreAttributes: false,
-    suppressEmptyNode: true
-  });
-  static xhtmlBuilder = new import_fast_xml_parser.XMLBuilder({
-    preserveOrder: true,
-    ignoreAttributes: false,
-    stopNodes: ["*.pre", "*.script"],
-    suppressEmptyNode: true
-  });
-  /**
-   * Format a duration, provided as a number of seconds, as
-   * a SMIL clock value, to be used for Media Overlays.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-duration
-   */
-  static formatSmilDuration(duration) {
-    const hours = Math.floor(duration / 3600);
-    const minutes = Math.floor(duration / 60 - hours * 60);
-    const secondsAndMillis = duration - minutes * 60 - hours * 3600;
-    const [seconds, millis] = secondsAndMillis.toFixed(2).split(".");
-    return `${hours.toString().padStart(2, "0")}:${minutes.toString().padStart(2, "0")}:${seconds.padStart(2, "0")}.${millis ?? "0"}`;
-  }
-  /**
-   * Given an XML structure representing a complete XHTML document,
-   * add a `link` element to the `head` of the document.
-   *
-   * This method modifies the provided XML structure.
-   */
-  static addLinkToXhtmlHead(xml, link) {
-    const html = Epub.findXmlChildByName("html", xml);
-    if (!html) throw new Error("Invalid XHTML document: no html element");
-    const head = Epub.findXmlChildByName("head", html.html);
-    if (!head) throw new Error("Invalid XHTML document: no head element");
-    head["head"].push({
-      link: [],
-      ":@": {
-        "@_rel": link.rel,
-        "@_href": link.href,
-        "@_type": link.type
-      }
-    });
-  }
-  /**
-   * Given an XML structure representing a complete XHTML document,
-   * return the sub-structure representing the children of the
-   * document's body element.
-   */
-  static getXhtmlBody(xml) {
-    const html = Epub.findXmlChildByName("html", xml);
-    if (!html) throw new Error("Invalid XHTML document: no html element");
-    const body = Epub.findXmlChildByName("body", html["html"]);
-    if (!body) throw new Error("Invalid XHTML document: No body element");
-    return body["body"];
-  }
-  static createXmlElement(name, properties, children = []) {
-    return {
-      ":@": Object.fromEntries(
-        Object.entries(properties).map(([prop, value]) => [`@_${prop}`, value])
-      ),
-      [name]: children
-    };
-  }
-  static createXmlTextNode(text) {
-    return { ["#text"]: text };
-  }
-  /**
-   * Given an XML structure representing a complete XHTML document,
-   * return a string representing the concatenation of all text nodes
-   * in the document.
-   */
-  static getXhtmlTextContent(xml) {
-    let text = "";
-    for (const child of xml) {
-      if (Epub.isXmlTextNode(child)) {
-        text += child["#text"];
-        continue;
-      }
-      const children = Epub.getXmlChildren(child);
-      text += Epub.getXhtmlTextContent(children);
-    }
-    return text;
-  }
-  /**
-   * Given an XMLElement, return its attributes.
-   */
-  static getXmlAttributes(element) {
-    return Object.fromEntries(
-      Object.entries(element[":@"] ?? {}).map(([key, value]) => [
-        key.slice(2),
-        value
-      ])
-    );
-  }
-  /**
-   * Given an XMLElement, return its tag name.
-   */
-  static getXmlElementName(element) {
-    const keys = Object.keys(element);
-    const elementName = keys.find((key) => key !== ":@" && key !== "#text");
-    if (!elementName)
-      throw new Error(
-        `Invalid XML Element: missing tag name
-${JSON.stringify(element, null, 2)}`
-      );
-    return elementName;
-  }
-  /**
-   * Given an XMLElement, return a list of its children
-   */
-  static getXmlChildren(element) {
-    const elementName = Epub.getXmlElementName(element);
-    return element[elementName];
-  }
-  static replaceXmlChildren(element, children) {
-    const elementName = Epub.getXmlElementName(element);
-    element[elementName] = children;
-  }
-  /**
-   * Given an XML structure, find the first child matching
-   * the provided name and optional filter.
-   */
-  static findXmlChildByName(name, xml, filter) {
-    const element = xml.find(
-      (e) => name in e && (filter ? filter(e) : true)
-    );
-    return element;
-  }
-  /**
-   * Given an XML structure, find the first descendant matching
-   * the provided name and optional filter.
-   *
-   * Will perform a breadth first search for the element, returning
-   * the highest element in the tree matching the name and filter.
-   */
-  static findXmlDescendantByName(name, xml, filter) {
-    const found = Epub.findXmlChildByName(name, xml, filter);
-    if (found) return found;
-    for (const node of xml) {
-      if (Epub.isXmlTextNode(node)) continue;
-      const children = Epub.getXmlChildren(node);
-      const found2 = this.findXmlDescendantByName(name, children, filter);
-      if (found2) return found2;
-    }
-    return void 0;
-  }
-  /**
-   * Given an XMLNode, determine whether it represents
-   * a text node or an XML element.
-   */
-  static isXmlTextNode(node) {
-    return "#text" in node;
-  }
-  rootfile = null;
-  manifest = null;
-  spine = null;
-  packageMutex = new import_async_mutex.Mutex();
-  /**
-   * Storage backend kind in use for this instance
-   *
-   * Public so callers can declare type-level requirements via {@link InMemoryEpubReader}
-   * Orthogonal to the read-only / writable axis (controlled by `readonlyOverride`
-   * and the adapter's capability bag)
-   */
-  storage;
-  /**
-   * Runtime guard for mutation methods
-   */
-  assertWritable() {
-    if (!this.adapterClass.capabilities.writable || this.readonlyOverride) {
-      throw new EpubReadOnlyError(
-        "cannot mutate a read-only Epub. open via Epub.using(TmpFsAdapter).from(path) (without { readonly: true }) to modify."
-      );
-    }
-  }
-  /**
-   * Construct a new EPUB on a writable backend, optionally seeded
-   * with the provided metadata. Equivalent to
-   * `Epub.using(TmpFsAdapter).create(...)`.
-   *
-   * @param dublinCore Core metadata terms
-   * @param additionalMetadata An array of additional metadata entries
-   */
-  static async create(path, dublinCore, additionalMetadata = []) {
-    return Epub.using(import_tmpfs.TmpFsAdapter).create(path, dublinCore, additionalMetadata);
-  }
-  /**
-   * Specify the storage backend to use for the EPUB
-   *
-   * The returned factory exposes `from`, `create`, and `upgrade`,
-   * which route through the supplied adapter.
-   *
-   * @example
-   * ```ts
-   * using epub = await Epub.using(TmpFsAdapter).from(path)
-   * using reader = await Epub.using(MemoryAdapter).from(buffer, { cache: false })
-   * ```
-   */
-  static using(adapterClass) {
-    return new EpubFactory(adapterClass);
-  }
-  static async from(pathOrData, options = {}) {
-    return Epub.using(import_tmpfs.TmpFsAdapter).from(pathOrData, options);
-  }
-  static async assertEpub3(epub) {
-    const version = await epub.getVersion();
-    if (!version.startsWith("3.")) {
-      epub.discardAndClose();
-      throw new EpubVersionError(
-        "This is not a valid EPUB 3 publication. This library only supports EPUB 3, not EPUB 2. Use Epub.upgrade(path) to convert."
-      );
-    }
-  }
-  async copy(path) {
-    if (!this.adapter.duplicate) {
-      throw new Error(
-        `cannot copy an Epub backed by ${this.adapterClass.kind}: adapter does not implement duplicate()`
-      );
-    }
-    const newAdapter = await this.adapter.duplicate();
-    return new Epub(this.adapterClass, newAdapter, path);
-  }
-  async removeEntry(href) {
-    this.assertWritable();
-    if (!this.adapter.remove) {
-      throw new EpubReadOnlyError(
-        `adapter ${this.adapterClass.kind} does not support entry removal`
-      );
-    }
-    const rootfile = await this.getRootfile();
-    await this.adapter.remove(await this.resolveEntry(rootfile, href));
-  }
-  /**
-   * Length of the underlying archive entry for a manifest item, in bytes
-   * Necessary to compute the readium page count which is for COMPRESSED content
-   * @see {@link https://github.com/readium/architecture/issues/123}
-   */
-  async getItemArchiveLength(id) {
-    const rootfile = await this.getRootfile();
-    const manifest = await this.getManifest();
-    const manifestItem = manifest[id];
-    if (!manifestItem)
-      throw new Error(`Could not find item with id "${id}" in manifest`);
-    return this.adapter.archiveLength(
-      await this.resolveEntry(rootfile, manifestItem.href)
-    );
-  }
-  async getRootfile() {
-    var _a;
-    if (this.rootfile !== null) return this.rootfile;
-    const containerString = await this.adapter.read(
-      "META-INF/container.xml",
-      "utf-8"
-    );
-    if (!containerString)
-      throw new Error("Failed to parse EPUB: Missing META-INF/container.xml");
-    const containerDocument = Epub.xmlParser.parse(containerString);
-    const container = Epub.findXmlChildByName("container", containerDocument);
-    if (!container)
-      throw new Error(
-        "Failed to parse EPUB container.xml: Found no container element"
-      );
-    const rootfiles = Epub.findXmlChildByName(
-      "rootfiles",
-      Epub.getXmlChildren(container)
-    );
-    if (!rootfiles)
-      throw new Error(
-        "Failed to parse EPUB container.xml: Found no rootfiles element"
-      );
-    const rootfile = Epub.findXmlChildByName(
-      "rootfile",
-      Epub.getXmlChildren(rootfiles),
-      (node) => {
-        var _a2;
-        return !Epub.isXmlTextNode(node) && ((_a2 = node[":@"]) == null ? void 0 : _a2["@_media-type"]) === import_media_types.MediaType.OPF.mime;
-      }
-    );
-    const fullPath = (_a = rootfile == null ? void 0 : rootfile[":@"]) == null ? void 0 : _a["@_full-path"];
-    if (!fullPath)
-      throw new Error(
-        "Failed to parse EPUB container.xml: Found no rootfile element"
-      );
-    this.rootfile = await this.resolveEntry("", fullPath);
-    return this.rootfile;
-  }
-  async getPackageDocument() {
-    const rootfile = await this.getRootfile();
-    const packageDocumentString = await this.adapter.read(rootfile, "utf-8");
-    if (!packageDocumentString)
-      throw new Error(
-        `Failed to parse EPUB: could not find package document at ${rootfile}`
-      );
-    const packageDocument = Epub.xmlParser.parse(
-      packageDocumentString
-    );
-    return normalizeOpfNamespacePrefixes(packageDocument);
-  }
-  async getPackageElement() {
-    const packageDocument = await this.getPackageDocument();
-    const packageElement = Epub.findXmlChildByName("package", packageDocument);
-    if (!packageElement) {
-      throw new Error(
-        "Failed to parse EPUB: Found no package element in package document"
-      );
-    }
-    return packageElement;
-  }
-  /**
-   * Safely modify the package document, without race conditions.
-   *
-   * Since the reading the package document is an async process,
-   * multiple simultaneously dispatched function calls that all
-   * attempt to modify it can clobber each other's changes. This
-   * method uses a mutex to ensure that each update runs exclusively.
-   *
-   * @param producer The function to update the package document. If
-   *    it returns a new package document, that will be persisted, otherwise
-   *    it will be assumed that the package document was modified in place.
-   */
-  async withPackage(producer) {
-    this.assertWritable();
-    await this.packageMutex.runExclusive(async () => {
-      const packageDocument = await this.getPackageDocument();
-      const packageElement = Epub.findXmlChildByName("package", packageDocument);
-      if (!packageElement) {
-        throw new Error(
-          "Failed to parse EPUB: Found no package element in package document"
-        );
-      }
-      const produced = await producer(packageElement);
-      const updatedPackageDocument = await Epub.xmlBuilder.build(
-        produced ?? packageDocument
-      );
-      const rootfile = await this.getRootfile();
-      await this.writeEntryContents(rootfile, updatedPackageDocument, "utf-8");
-    });
-  }
-  /**
-   * Retrieve the manifest for the Epub.
-   *
-   * This is represented as a map from each manifest items'
-   * id to the rest of its properties.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-pkg-manifest
-   */
-  async getManifest() {
-    if (this.manifest !== null) return this.manifest;
-    const packageElement = await this.getPackageElement();
-    const manifest = Epub.findXmlChildByName(
-      "manifest",
-      Epub.getXmlChildren(packageElement)
-    );
-    if (!manifest)
-      throw new Error(
-        "Failed to parse EPUB: Found no manifest element in package document"
-      );
-    this.manifest = Epub.getXmlChildren(manifest).reduce((acc, item) => {
-      var _a, _b;
-      if (Epub.isXmlTextNode(item)) return acc;
-      if (!((_a = item[":@"]) == null ? void 0 : _a["@_id"]) || !item[":@"]["@_href"]) {
-        return acc;
-      }
-      return {
-        ...acc,
-        [item[":@"]["@_id"]]: {
-          id: item[":@"]["@_id"],
-          href: item[":@"]["@_href"],
-          mediaType: item[":@"]["@_media-type"],
-          mediaOverlay: item[":@"]["@_media-overlay"],
-          fallback: item[":@"]["@_fallback"],
-          properties: (_b = item[":@"]["@_properties"]) == null ? void 0 : _b.split(" ")
-        }
-      };
-    }, {});
-    return this.manifest;
-  }
-  /**
-   * Returns the first index in the metadata element's children array
-   * that matches the provided predicate.
-   *
-   * Note: This may technically be different than the index in the
-   * getMetadata() array, as it includes non-metadata nodes, like
-   * text nodes. These are technically not allowed, but may exist,
-   * nonetheless. As consumers only ever see the getMetadata()
-   * array, this method is only meant to be used internally.
-   */
-  findMetadataIndex(packageElement, predicate) {
-    const metadataElement = Epub.findXmlChildByName(
-      "metadata",
-      Epub.getXmlChildren(packageElement)
-    );
-    if (!metadataElement)
-      throw new Error(
-        "Failed to parse EPUB: Found no metadata element in package document"
-      );
-    return metadataElement.metadata.findIndex((node) => {
-      const item = Epub.parseMetadataItem(node);
-      if (!item) return false;
-      return predicate(item);
-    });
-  }
-  /**
-   * Returns the item in the metadata element's children array
-   * that matches the provided predicate.
-   */
-  async findMetadataItem(predicate) {
-    const [first] = await this.findAllMetadataItems(predicate);
-    return first ?? null;
-  }
-  /**
-   * Returns the item in the metadata element's children array
-   * that matches the provided predicate.
-   */
-  async findAllMetadataItems(predicate) {
-    const packageElement = await this.getPackageElement();
-    const metadataElement = Epub.findXmlChildByName(
-      "metadata",
-      Epub.getXmlChildren(packageElement)
-    );
-    if (!metadataElement)
-      throw new Error(
-        "Failed to parse EPUB: Found no metadata element in package document"
-      );
-    const elements = metadataElement.metadata.filter((node) => {
-      const item = Epub.parseMetadataItem(node);
-      if (!item) return false;
-      return predicate(item);
-    });
-    return elements.map((element) => Epub.parseMetadataItem(element)).filter((item) => !!item);
-  }
-  static parseMetadataItem(node) {
-    if (Epub.isXmlTextNode(node)) return null;
-    const elementName = Epub.getXmlElementName(node);
-    const textNode = Epub.getXmlChildren(node)[0];
-    const value = !textNode || !Epub.isXmlTextNode(textNode) ? void 0 : textNode["#text"].replaceAll(/\s+/g, " ");
-    const attributes = node[":@"] ?? {};
-    const { id, ...properties } = Object.fromEntries(
-      Object.entries(attributes).map(([attrName, value2]) => [
-        attrName.slice(2),
-        value2
-      ])
-    );
-    return {
-      id,
-      type: elementName,
-      properties,
-      value
-    };
-  }
-  /**
-   * Retrieve the metadata entries for the Epub.
-   *
-   * This is represented as an array of metadata entries,
-   * in the order that they're presented in the Epub package document.
-   *
-   * For more useful semantic representations of metadata, use
-   * specific methods such as `getTitle()` and `getAuthors()`.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-pkg-metadata
-   */
-  async getMetadata() {
-    const packageElement = await this.getPackageElement();
-    const metadataElement = Epub.findXmlChildByName(
-      "metadata",
-      Epub.getXmlChildren(packageElement)
-    );
-    if (!metadataElement)
-      throw new Error(
-        "Failed to parse EPUB: Found no metadata element in package document"
-      );
-    const metadata = metadataElement.metadata.map((node) => Epub.parseMetadataItem(node)).filter((node) => !!node);
-    return metadata;
-  }
-  /**
-   * Retrieve the first identifier from the dc:identifier element
-   * in the EPUB metadata.
-   *
-   * If there is no dc:identifier element, returns null.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dcidentifier
-   *
-   * @deprecated Use {@link getUniqueIdentifier} instead to get the unique identifier,
-   * or {@link getIdentifiers} to get all identifiers.
-   */
-  async getIdentifier() {
-    const metadata = await this.getMetadata();
-    const entry = metadata.find(({ type }) => type === "dc:identifier");
-    return (entry == null ? void 0 : entry.value) ?? null;
-  }
-  /**
-   * Set the dc:identifier metadata element with the provided string.
-   *
-   * Updates the existing dc:identifier element if one exists.
-   * Otherwise creates a new element
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dcidentifier
-   *
-   * @deprecated Use {@link setUniqueIdentifier} instead.
-   */
-  async setIdentifier(identifier) {
-    await this.replaceMetadata(({ type }) => type === "dc:identifier", {
-      type: "dc:identifier",
-      properties: {},
-      value: identifier
-    });
-  }
-  /**
-   * Retrieve the identifier with the unique identifier id
-   * in the EPUB metadata.
-   *
-   * If there is no unique identifier id, returns the first dc:identifier element.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dcidentifier
-   */
-  async getUniqueIdentifier() {
-    const metadata = await this.getMetadata();
-    const uniqueId = await this.getUniqueIdentifierId();
-    if (!uniqueId) {
-      return null;
-    }
-    const entry = metadata.find(
-      ({ type, id }) => type === "dc:identifier" && id === uniqueId
-    );
-    return (entry == null ? void 0 : entry.value) ?? null;
-  }
-  /**
-   * Set the unique identifier id for the EPUB.
-   *
-   * Updates the existing dc:identifier element referenced by the unique identifier id if one exists.
-   * Otherwise creates a new element with the provided identifier, and sets the unique identifier id to the new element's id.
-   *
-   * Note: you likely shouldn't change the unique identifier id unless you are producing a new EPUB.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dcidentifier
-   */
-  async setUniqueIdentifier(identifier) {
-    await this.withPackage(async (packageElement) => {
-      const metadata = Epub.findXmlChildByName(
-        "metadata",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!metadata) {
-        throw new Error(
-          "Failed to parse EPUB: found no metadata element in package document"
-        );
-      }
-      let uniqueId = await this.getUniqueIdentifierId();
-      if (!uniqueId) {
-        const newUniqueId = (0, import_nanoid.nanoid)();
-        packageElement[":@"] = {
-          ...packageElement[":@"],
-          "@_unique-identifier": newUniqueId
-        };
-        uniqueId = newUniqueId;
-      }
-      const children = Epub.getXmlChildren(metadata);
-      const entry = Epub.findXmlChildByName(
-        "dc:identifier",
-        children,
-        (node) => {
-          var _a;
-          return ((_a = node[":@"]) == null ? void 0 : _a["@_id"]) === uniqueId;
-        }
-      );
-      if (entry) {
-        children.splice(
-          children.indexOf(entry),
-          1,
-          Epub.createXmlElement("dc:identifier", { id: uniqueId }, [
-            Epub.createXmlTextNode(identifier)
-          ])
-        );
-        return;
-      }
-      children.push(
-        Epub.createXmlElement("dc:identifier", { id: uniqueId }, [
-          Epub.createXmlTextNode(identifier)
-        ])
-      );
-    });
-  }
-  /**
-   * Retrieve the id of the publication's unique identifier, as declared by the
-   * package element's `unique-identifier` attribute.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dcidentifier
-   */
-  async getUniqueIdentifierId() {
-    var _a;
-    const packageElement = await this.getPackageElement();
-    return ((_a = packageElement[":@"]) == null ? void 0 : _a["@_unique-identifier"]) ?? null;
-  }
-  /**
-   * Collect `dc:identifier` or `dc:source` entries, attaching the value and
-   * scheme of any refining `identifier-type` meta (spec D.3.8) and a legacy
-   * `opf:scheme` attribute. Values are not interpreted.
-   *
-   * `onRefinement` is invoked for every other meta refining a collected entry,
-   * so callers can surface element-specific refinements (e.g. `source-of` on a
-   * `dc:source`).
-   */
-  static collectDcEntries(metadata, type, onRefinement) {
-    const entries = metadata.filter((entry) => entry.type === type && entry.value !== void 0).map((entry) => ({
-      // filtered above, so value is defined
-      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-      value: entry.value,
-      ...entry.id && { id: entry.id },
-      ...entry.properties["opf:scheme"] && {
-        scheme: entry.properties["opf:scheme"]
-      }
-    }));
-    for (const meta of metadata) {
-      if (meta.type !== "meta" || meta.value === void 0) continue;
-      const property = meta.properties["property"];
-      const refines = meta.properties["refines"];
-      if (!property || !refines) continue;
-      const target = entries.find((t) => t.id === refines.slice(1));
-      if (!target) continue;
-      if (property === "identifier-type") {
-        target.identifierType = meta.value;
-        if (meta.properties["scheme"]) target.scheme = meta.properties["scheme"];
-      } else {
-        onRefinement == null ? void 0 : onRefinement(target, property, meta.value);
-      }
-    }
-    return entries;
-  }
-  /**
-   * Retrieve every `dc:identifier` entry, returned as found.
-   *
-   * Values are not interpreted. Any refining `identifier-type` meta (spec
-   * D.3.8) or legacy `opf:scheme` attribute is surfaced on the entry, but no
-   * parsing of the value itself is attempted. To read `dc:source` entries, use
-   * {@link getSources}.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dcidentifier
-   */
-  async getIdentifiers() {
-    const metadata = await this.getMetadata();
-    return Epub.collectDcEntries(metadata, "dc:identifier");
-  }
-  /**
-   * Retrieve every `dc:source` entry, returned as found.
-   *
-   * Like {@link getIdentifiers}, values are not interpreted. In addition to a
-   * refining `identifier-type`, a refining `source-of` meta (spec D.3.11) is
-   * surfaced as `sourceOf`.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dcsource
-   */
-  async getSources() {
-    const metadata = await this.getMetadata();
-    return Epub.collectDcEntries(
-      metadata,
-      "dc:source",
-      (source, property) => {
-        if (property === "source-of") {
-          source.isPageBreakSource = true;
-        }
-      }
-    );
-  }
-  /**
-   * Retrieve the `pageBreakSource` property (EPUB 3.4, spec D.2.9), the
-   * publication-level source for the source of its page break markers.
-   *
-   * This property replaces the refining `source-of="pagination"` meta (spec
-   * D.3.11), see {@link EpubSource.sourceOf}. If no `pageBreakSource` property is found,
-   * we fall back to finding a `dc:source` with a `source-of="pagination"` refinement.
-   *
-   * @link https://www.w3.org/TR/epub/#pageBreakSource
-   */
-  async getPageBreakSource() {
-    const entry = await this.findMetadataItem(
-      (item) => item.type === "meta" && item.properties["property"] === "pageBreakSource" && !!item.value
-    );
-    if (entry) {
-      return {
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        value: entry.value,
-        id: entry.id,
-        identifierType: void 0,
-        scheme: void 0,
-        isPageBreakSource: true
-      };
-    }
-    const sources = await this.getSources();
-    const source = sources.find((source2) => source2.isPageBreakSource);
-    if (source) {
-      return source;
-    }
-    return null;
-  }
-  /**
-   * Set the `pageBreakSource` property (EPUB 3.4, spec D.2.9), or remove it when
-   * passed null. Replaces an existing `pageBreakSource` meta if present.
-   *
-   * Pass `none` to indicate the pagination is unique to this publication.
-   *
-   * @link https://www.w3.org/TR/epub/#pageBreakSource
-   */
-  async setPageBreakSource(value) {
-    if (value === null) {
-      await this.removeMetadata(
-        (item) => item.properties["property"] === "pageBreakSource"
-      );
-      return;
-    }
-    await this.replaceMetadata(
-      (item) => item.properties["property"] === "pageBreakSource",
-      { type: "meta", properties: { property: "pageBreakSource" }, value }
-    );
-  }
-  /**
-   * Replace the publication's `dc:identifier` entries.
-   *
-   * This replaces ALL existing `dc:identifier` elements except the publication's
-   * unique identifier (the one referenced by the package element's
-   * `unique-identifier` attribute), which is always preserved and must not be
-   * included in the provided list. If included anyway, it is ignored. See
-   * {@link setUniqueIdentifier} to change it.
-   *
-   * Identifiers are placed in the order they are provided.
-   *
-   * `dc:source` entries are not touched, use {@link setSources} for those.
-   *
-   * When an entry has an `identifierType`, it is written in the refining form
-   * (a `meta` with `property="identifier-type"`, carrying the `scheme`
-   * attribute when provided). An entry with only a `scheme` is written using
-   * the legacy `opf:scheme` attribute.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dcidentifier
-   */
-  async setIdentifiers(identifiers) {
-    const uniqueId = await this.getUniqueIdentifierId();
-    await this.withPackage((packageElement) => {
-      var _a;
-      const metadata = Epub.findXmlChildByName(
-        "metadata",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!metadata)
-        throw new Error(
-          "Failed to parse EPUB: found no metadata element in package document"
-        );
-      const children = Epub.getXmlChildren(metadata);
-      const removedIds = /* @__PURE__ */ new Set();
-      for (let i = children.length - 1; i >= 0; i--) {
-        const node = children[i];
-        if (Epub.isXmlTextNode(node) || Epub.getXmlElementName(node) !== "dc:identifier") {
-          continue;
-        }
-        const id = (_a = node[":@"]) == null ? void 0 : _a["@_id"];
-        if (id && id === uniqueId) {
-          continue;
-        }
-        if (id) {
-          removedIds.add(id);
-        }
-        children.splice(i, 1);
-      }
-      Epub.removeRefiningMetas(children, removedIds, ["identifier-type"]);
-      for (const identifier of identifiers) {
-        if (identifier.id && identifier.id === uniqueId) continue;
-        const id = identifier.id ?? (identifier.identifierType !== void 0 ? (0, import_nanoid.nanoid)() : void 0);
-        children.push(
-          Epub.createXmlElement(
-            "dc:identifier",
-            {
-              ...id && { id },
-              ...identifier.scheme && identifier.identifierType === void 0 && {
-                "opf:scheme": identifier.scheme
-              }
-            },
-            [Epub.createXmlTextNode(identifier.value)]
-          )
-        );
-        if (identifier.identifierType !== void 0 && id) {
-          children.push(
-            Epub.createXmlElement(
-              "meta",
-              {
-                refines: `#${id}`,
-                property: "identifier-type",
-                ...identifier.scheme && { scheme: identifier.scheme }
-              },
-              [Epub.createXmlTextNode(identifier.identifierType)]
-            )
-          );
-        }
-      }
-    });
-  }
-  /**
-   * Remove `meta` refinements pointing at any of the given ids,
-   * restricted to the given `property` values as a cleanup step
-   * Mutates `children` in place.
-   */
-  static removeRefiningMetas(children, ids, properties) {
-    var _a, _b, _c;
-    for (let i = children.length - 1; i >= 0; i--) {
-      const node = children[i];
-      if (Epub.isXmlTextNode(node) || Epub.getXmlElementName(node) !== "meta") {
-        continue;
-      }
-      const property = (_a = node[":@"]) == null ? void 0 : _a["@_property"];
-      if (!property || !properties.includes(property)) continue;
-      const refines = (_c = (_b = node[":@"]) == null ? void 0 : _b["@_refines"]) == null ? void 0 : _c.slice(1);
-      if (refines && ids.has(refines)) {
-        children.splice(i, 1);
-      }
-    }
-  }
-  /**
-   * Replace the publication's `dc:source` entries.
-   *
-   * This replaces ALL existing `dc:source` elements (and their refining
-   * `identifier-type` / `source-of` metas). `dc:identifier` entries are not
-   * touched; use {@link setIdentifiers} for those. Pass an empty array to
-   * remove all sources.
-   *
-   * When an entry has an `identifierType`, it is written in the refining form.
-   * A `sourceOf` value is written as a refining `source-of` meta (spec D.3.11).
-   * An entry with only a `scheme` uses the legacy `opf:scheme` attribute.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dcsource
-   */
-  async setSources(sources) {
-    await this.withPackage((packageElement) => {
-      var _a;
-      const metadata = Epub.findXmlChildByName(
-        "metadata",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!metadata)
-        throw new Error(
-          "Failed to parse EPUB: found no metadata element in package document"
-        );
-      const children = Epub.getXmlChildren(metadata);
-      const removedIds = /* @__PURE__ */ new Set();
-      for (let i = children.length - 1; i >= 0; i--) {
-        const node = children[i];
-        if (Epub.isXmlTextNode(node) || Epub.getXmlElementName(node) !== "dc:source") {
-          continue;
-        }
-        const id = (_a = node[":@"]) == null ? void 0 : _a["@_id"];
-        if (id) {
-          removedIds.add(id);
-        }
-        children.splice(i, 1);
-      }
-      Epub.removeRefiningMetas(children, removedIds, [
-        "identifier-type",
-        "source-of"
-      ]);
-      for (const source of sources) {
-        const needsId = source.identifierType !== void 0 || source.isPageBreakSource;
-        const id = source.id ?? (needsId ? (0, import_nanoid.nanoid)() : void 0);
-        children.push(
-          Epub.createXmlElement(
-            "dc:source",
-            {
-              ...id && { id },
-              ...source.scheme && source.identifierType === void 0 && {
-                "opf:scheme": source.scheme
-              }
-            },
-            [Epub.createXmlTextNode(source.value)]
-          )
-        );
-        if (source.identifierType !== void 0 && id) {
-          children.push(
-            Epub.createXmlElement(
-              "meta",
-              {
-                refines: `#${id}`,
-                property: "identifier-type",
-                ...source.scheme && { scheme: source.scheme }
-              },
-              [Epub.createXmlTextNode(source.identifierType)]
-            )
-          );
-        }
-        if (source.isPageBreakSource && id) {
-          children.push(
-            Epub.createXmlElement(
-              "meta",
-              { refines: `#${id}`, property: "source-of" },
-              [Epub.createXmlTextNode("pagination")]
-            )
-          );
-        }
-      }
-    });
-  }
-  /**
-   * Even "EPUB 3" publications sometimes still only use the
-   * EPUB 2 specification for identifying the cover image.
-   * This is a private method that is used as a fallback if
-   * we fail to find the cover image according to the EPUB 3
-   * spec.
-   */
-  async getEpub2CoverImage() {
-    var _a;
-    const packageElement = await this.getPackageElement();
-    const metadataElement = Epub.findXmlChildByName(
-      "metadata",
-      Epub.getXmlChildren(packageElement)
-    );
-    if (!metadataElement)
-      throw new Error(
-        "Failed to parse EPUB: Found no metadata element in package document"
-      );
-    const coverImageElement = Epub.getXmlChildren(metadataElement).find(
-      (node) => {
-        var _a2;
-        return !Epub.isXmlTextNode(node) && ((_a2 = node[":@"]) == null ? void 0 : _a2["@_name"]) === "cover";
-      }
-    );
-    const manifestItemId = (_a = coverImageElement == null ? void 0 : coverImageElement[":@"]) == null ? void 0 : _a["@_content"];
-    if (!manifestItemId) return null;
-    const manifest = await this.getManifest();
-    return Object.values(manifest).find((item) => item.id === manifestItemId) ?? null;
-  }
-  /**
-   * Retrieve the cover image manifest item.
-   *
-   * This does not return the actual image data. To
-   * retrieve the image data, pass this item's id to
-   * epub.readItemContents, or use epub.getCoverImage()
-   * instead.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-cover-image
-   */
-  async getCoverImageItem() {
-    const manifest = await this.getManifest();
-    const coverImage = Object.values(manifest).find(
-      (item) => {
-        var _a;
-        return (_a = item.properties) == null ? void 0 : _a.includes("cover-image");
-      }
-    );
-    if (coverImage) return coverImage;
-    return this.getEpub2CoverImage();
-  }
-  /**
-   * Retrieve the cover image data as a byte array.
-   *
-   * This does not include, for example, the cover image's
-   * filename or mime type. To retrieve the image manifest
-   * item, use epub.getCoverImageItem().
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-cover-image
-   */
-  async getCoverImage() {
-    const coverImageItem = await this.getCoverImageItem();
-    if (!coverImageItem) return coverImageItem;
-    return this.readItemContents(coverImageItem.id);
-  }
-  /**
-   * Set the cover image for the EPUB.
-   *
-   * Adds a manifest item with the `cover-image` property, per
-   * the EPUB 3 spec, and then writes the provided image data to
-   * the provided href within the publication.
-   */
-  async setCoverImage(href, data) {
-    var _a;
-    const coverImageItem = await this.getCoverImageItem();
-    if (coverImageItem) {
-      await this.removeManifestItem(coverImageItem.id);
-    }
-    const mediaType = (_a = import_media_types.MediaType.fromPath(href)) == null ? void 0 : _a.mime;
-    if (!mediaType)
-      throw new Error(`Invalid file extension for cover image: ${href}`);
-    await this.addManifestItem(
-      { id: "cover-image", href, mediaType, properties: ["cover-image"] },
-      data
-    );
-  }
-  /**
-   * Retrieve the publication date from the dc:date element
-   * in the EPUB metadata as a Date object.
-   *
-   * If there is no dc:date element, returns null.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dcdate
-   */
-  async getPublicationDate() {
-    const metadata = await this.getMetadata();
-    const entry = metadata.find(({ type }) => type === "dc:date");
-    if (!(entry == null ? void 0 : entry.value)) return null;
-    return new Date(entry.value);
-  }
-  /**
-   * Set the dc:date metadata element with the provided date.
-   *
-   * Updates the existing dc:date element if one exists.
-   * Otherwise creates a new element
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dcdate
-   */
-  async setPublicationDate(date) {
-    await this.replaceMetadata(({ type }) => type === "dc:date", {
-      type: "dc:date",
-      properties: {},
-      value: date.toISOString()
-    });
-  }
-  /**
-   * Retrieve the modified date from the dcterms:modified metadata
-   * in the EPUB metadata as a Date object.
-   *
-   * If there is no meta element with dcterms:modified, returns null.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-metadata-last-modified
-   */
-  async getModifiedDate() {
-    const metadata = await this.getMetadata();
-    const entry = metadata.find(
-      ({ properties }) => properties["property"] === "dcterms:modified"
-    );
-    if (!(entry == null ? void 0 : entry.value)) return null;
-    return new Date(entry.value);
-  }
-  /**
-   * Retrieve the layout from the rendition:layout meta element
-   * in the EPUB metadata.
-   *
-   * If there is no meta element, returns 'reflowable'.
-   *
-   * @link https://www.w3.org/TR/epub-33/#layout
-   */
-  async getLayout() {
-    const metadata = await this.getMetadata();
-    const entry = metadata.find(
-      ({ properties }) => properties["property"] === "rendition:layout"
-    );
-    if ((entry == null ? void 0 : entry.value) !== "reflowable" && (entry == null ? void 0 : entry.value) !== "pre-paginated") {
-      return "reflowable";
-    }
-    return entry.value;
-  }
-  /**
-   * Retrieve the base direction from the package element.
-   *
-   * If there is no `dir` attribute on the package element,
-   * returns 'auto'.
-   *
-   * @link https://www.w3.org/TR/epub-33/#attrdef-dir
-   */
-  async getBaseDirection() {
-    var _a;
-    const packageEl = await this.getPackageElement();
-    const dir = (_a = packageEl[":@"]) == null ? void 0 : _a["@_dir"];
-    if (dir !== "ltr" && dir !== "rtl" && dir !== "auto") {
-      return "auto";
-    }
-    return dir;
-  }
-  /**
-   * Set the dc:type metadata element.
-   *
-   * Updates the existing dc:type element if one exists.
-   * Otherwise creates a new element.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dctype
-   */
-  async setType(type) {
-    await this.replaceMetadata(({ type: type2 }) => type2 === "dc:type", {
-      type: "dc:type",
-      properties: {},
-      value: type
-    });
-  }
-  /**
-   * Retrieve the publication type from the dc:type element
-   * in the EPUB metadata.
-   *
-   * If there is no dc:type element, returns null.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dctype
-   */
-  async getType() {
-    const metadata = await this.getMetadata();
-    return metadata.find(({ type }) => type === "dc:type") ?? null;
-  }
-  /**
-   * Add a subject to the EPUB metadata.
-   *
-   * @param subject May be a string representing just a schema-less
-   *  subject name, or a DcSubject object
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dcsubject
-   */
-  async addSubject(subject) {
-    const subjectEntry = typeof subject === "string" ? {
-      value: subject
-    } : subject;
-    const subjectId = (0, import_nanoid.nanoid)();
-    await this.addMetadata({
-      id: subjectId,
-      type: "dc:subject",
-      properties: {},
-      value: subjectEntry.value
-    });
-    if ("authority" in subjectEntry) {
-      await this.addMetadata({
-        type: "meta",
-        properties: { refines: `#${subjectId}`, property: "authority" },
-        value: subjectEntry.authority
-      });
-      await this.addMetadata({
-        type: "meta",
-        properties: { refines: `#${subjectId}`, property: "term" },
-        value: subjectEntry.term
-      });
-    }
-  }
-  /**
-   * Remove a subject from the EPUB metadata.
-   *
-   * Removes the subject at the provided index. This index
-   * refers to the array returned by `epub.getSubjects()`.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dccreator
-   */
-  async removeSubject(index) {
-    await this.withPackage((packageElement) => {
-      const metadata = Epub.findXmlChildByName(
-        "metadata",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!metadata)
-        throw new Error(
-          "Failed to parse EPUB: found no metadata element in package document"
-        );
-      let subjectCount = null;
-      let metadataIndex = null;
-      for (const meta of Epub.getXmlChildren(metadata)) {
-        if (subjectCount === index) break;
-        metadataIndex = metadataIndex === null ? 0 : metadataIndex + 1;
-        if (Epub.isXmlTextNode(meta)) continue;
-        if (Epub.getXmlElementName(meta) !== "dc:subject") continue;
-        subjectCount = subjectCount === null ? 0 : subjectCount + 1;
-      }
-      if (subjectCount === null || metadataIndex === null) return;
-      Epub.getXmlChildren(metadata).splice(metadataIndex, 1);
-    });
-  }
-  /**
-   * Retrieve the list of subjects for this EPUB.
-   *
-   * Subjects without associated authority and term metadata
-   * will be returned as strings. Otherwise, they will
-   * be represented as DcSubject objects, with a value,
-   * authority, and term.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dcsubject
-   */
-  async getSubjects() {
-    const metadata = await this.getMetadata();
-    const subjectEntries = metadata.filter(({ type }) => type === "dc:subject");
-    const subjects = subjectEntries.map(({ value }) => value).filter((value) => !!value);
-    metadata.forEach((entry) => {
-      if (entry.type !== "meta" || entry.properties["property"] !== "term" && entry.properties["property"] !== "authority") {
-        return;
-      }
-      const subjectIdref = entry.properties["refines"];
-      if (!subjectIdref) return;
-      const subjectId = subjectIdref.slice(1);
-      const index = subjectEntries.findIndex((entry2) => entry2.id === subjectId);
-      if (index === -1) return;
-      const subject = typeof subjects[index] === "string" ? { value: subjects[index], authority: void 0, term: void 0 } : (
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        subjects[index]
-      );
-      subject[entry.properties["property"]] = entry.value;
-      subjects.splice(index, 1, subject);
-    });
-    return subjects;
-  }
-  /**
-   * Retrieve the Epub's language as specified in its
-   * package document metadata.
-   *
-   * If no language metadata is specified, returns null.
-   * Returns the language as an Intl.Locale instance.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dclanguage
-   */
-  async getLanguage() {
-    const metadata = await this.getMetadata();
-    const languageEntries = metadata.filter(
-      (entry) => entry.type === "dc:language"
-    );
-    const primaryLanguage = languageEntries[0];
-    if (!primaryLanguage) return null;
-    const locale = primaryLanguage.value;
-    if (!locale || locale.toLowerCase() === "und") return null;
-    try {
-      return new Intl.Locale(locale);
-    } catch {
-      return null;
-    }
-  }
-  /**
-   * Update the Epub's language metadata entry.
-   *
-   * Updates the existing dc:language element if one exists.
-   * Otherwise creates a new element
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dclanguage
-   */
-  async setLanguage(locale) {
-    await this.replaceMetadata(({ type }) => type === "dc:language", {
-      type: "dc:language",
-      properties: {},
-      value: locale.toString()
-    });
-  }
-  /**
-   * Retrieve the title of the Epub.
-   *
-   * @param main Optional - whether to return only the first title segment
-   *  if multiple are found. Otherwise, will follow the spec to combine title
-   *  segments
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dctitle
-   */
-  async getTitle(expanded = false) {
-    var _a;
-    const entries = await this.getTitles();
-    if (!expanded) {
-      const mainEntry = entries.find((entry) => entry.type === "main");
-      if (mainEntry) return mainEntry.title;
-      const shortEntry = entries.find((entry) => entry.type === "short");
-      if (shortEntry) return shortEntry.title;
-      return ((_a = entries[0]) == null ? void 0 : _a.title) ?? null;
-    }
-    const expandedEntry = entries.find((entry) => entry.type === "expanded");
-    if (expandedEntry) return expandedEntry.title;
-    return entries.map((entry) => entry.title).join(", ");
-  }
-  /**
-   * Retrieve the subtitle of the Epub, if it exists.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dctitle
-   */
-  async getSubtitle() {
-    const entries = await this.getTitles();
-    const subtitleEntry = entries.find((entry) => entry.type === "subtitle");
-    return (subtitleEntry == null ? void 0 : subtitleEntry.title) ?? null;
-  }
-  /**
-   * Retrieve all title entries of the Epub.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dctitle
-   */
-  async getTitles() {
-    const metadata = await this.getMetadata();
-    const titleEntries = metadata.filter((entry) => entry.type === "dc:title");
-    const titleRefinements = metadata.filter(
-      (entry) => entry.type === "meta" && entry.properties["refines"] && (entry.properties["property"] === "title-type" || entry.properties["property"] === "display-seq")
-    );
-    const sortedTitleParts = titleEntries.filter(
-      (titleEntry) => titleEntry.id && titleRefinements.some(
-        (entry) => {
-          var _a;
-          return entry.value && ((_a = entry.properties["refines"]) == null ? void 0 : _a.slice(1)) === titleEntry.id && entry.properties["property"] === "display-seq" && !Number.isNaN(parseInt(entry.value, 10));
-        }
-      )
-    ).sort((a, b) => {
-      const refinementA = titleRefinements.find(
-        (entry) => entry.properties["property"] === "display-seq" && entry.properties["refines"].slice(1) === a.id
-      );
-      const refinementB = titleRefinements.find(
-        (entry) => entry.properties["property"] === "display-seq" && entry.properties["refines"].slice(1) === b.id
-      );
-      const sortA = parseInt(refinementA.value, 10);
-      const sortB = parseInt(refinementB.value, 10);
-      return sortA - sortB;
-    });
-    return (sortedTitleParts.length === 0 ? titleEntries : sortedTitleParts).map((entry) => {
-      const titleType = titleRefinements.find(
-        (refinement) => {
-          var _a;
-          return ((_a = refinement.properties["refines"]) == null ? void 0 : _a.slice(1)) === entry.id && refinement.properties["property"] === "title-type";
-        }
-      );
-      return {
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        title: entry.value,
-        type: (titleType == null ? void 0 : titleType.value) ?? null
-      };
-    });
-  }
-  /**
-   * Update the Epub's description metadata entry.
-   *
-   * Updates the existing dc:description element if one exists.
-   * Otherwise creates a new element. Any non-ASCII symbols,
-   * `&`, `<`, `>`, `"`, `'`, and `\``` will be encoded as HTML entities.
-   */
-  async setDescription(description) {
-    await this.replaceMetadata(({ type }) => type === "dc:description", {
-      type: "dc:description",
-      value: description,
-      properties: {}
-    });
-  }
-  /**
-   * Retrieve the Epub's description as specified in its
-   * package document metadata.
-   *
-   * If no description metadata is specified, returns null.
-   * Returns the description as a string. Descriptions may
-   * include HTML markup.
-   */
-  async getDescription() {
-    const metadata = await this.getMetadata();
-    const descriptionEntry = metadata.find(
-      (entry) => entry.type === "dc:description"
-    );
-    if (!(descriptionEntry == null ? void 0 : descriptionEntry.value)) return null;
-    return descriptionEntry.value;
-  }
-  /**
-   * Return the set of custom vocabulary prefixes set on this publication's
-   * root package element.
-   *
-   * Returns a map from prefix to URI
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-prefix-attr
-   */
-  async getPackageVocabularyPrefixes() {
-    var _a;
-    const packageElement = await this.getPackageElement();
-    const prefixValue = (_a = packageElement[":@"]) == null ? void 0 : _a["@_prefix"];
-    if (!prefixValue) return {};
-    const matches = prefixValue.matchAll(/(?:([a-z]+): +(\S+)\s*)/gs);
-    return Array.from(matches).reduce(
-      (acc, match) => match[1] && match[2] ? { ...acc, [match[1]]: match[2] } : acc,
-      {}
-    );
-  }
-  /**
-   * Set a custom vocabulary prefix on the root package element.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-prefix-attr
-   */
-  async setPackageVocabularyPrefix(prefix, uri) {
-    await this.withPackage(async (packageElement) => {
-      const prefixes = await this.getPackageVocabularyPrefixes();
-      prefixes[prefix] = uri;
-      packageElement[":@"] ??= {};
-      packageElement[":@"]["@_prefix"] = Object.entries(prefixes).map(([p, u]) => `${p}: ${u}`).join("\n    ");
-    });
-  }
-  /**
-   * Set the title of the Epub.
-   *
-   * This will replace all existing dc:title elements with
-   * this title. It will be given title-type "main".
-   *
-   * To set specific titles and their types, use epub.setTitles().
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dctitle
-   */
-  // TODO: This should allow users to optionally specify an array,
-  // rather than a single string, to support expanded titles.
-  async setTitle(title) {
-    await this.withPackage((packageElement) => {
-      const metadata = Epub.findXmlChildByName(
-        "metadata",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!metadata)
-        throw new Error(
-          "Failed to parse EPUB: found no metadata element in package document"
-        );
-      const titleElement = Epub.findXmlChildByName(
-        "dc:title",
-        metadata.metadata
-      );
-      if (!titleElement) {
-        Epub.getXmlChildren(metadata).push(
-          Epub.createXmlElement("dc:title", {}, [
-            Epub.createXmlTextNode(title)
-          ])
-        );
-      } else {
-        titleElement["dc:title"] = [Epub.createXmlTextNode(title)];
-      }
-    });
-  }
-  async setTitles(entries) {
-    await this.withPackage((packageElement) => {
-      var _a, _b;
-      const metadata = Epub.findXmlChildByName(
-        "metadata",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!metadata) {
-        throw new Error(
-          "Failed to parse EPUB: found no metadata element in package document"
-        );
-      }
-      const metadataEntries = Epub.getXmlChildren(metadata);
-      for (let i = metadataEntries.length - 1; i >= 0; i--) {
-        const meta = metadataEntries[i];
-        if (Epub.isXmlTextNode(meta)) continue;
-        if (Epub.getXmlElementName(meta) === "dc:title" || ((_a = meta[":@"]) == null ? void 0 : _a["@_property"]) === "title-type" || ((_b = meta[":@"]) == null ? void 0 : _b["@_property"]) === "display-seq") {
-          metadataEntries.splice(i, 1);
-        }
-      }
-      for (let i = 0; i < entries.length; i++) {
-        const entry = entries[i];
-        const id = (0, import_nanoid.nanoid)();
-        metadataEntries.push(
-          Epub.createXmlElement("dc:title", { id }, [
-            Epub.createXmlTextNode(entry.title)
-          ])
-        );
-        if (entry.type) {
-          metadataEntries.push(
-            Epub.createXmlElement(
-              "meta",
-              { refines: `#${id}`, property: "title-type" },
-              [Epub.createXmlTextNode(entry.type)]
-            )
-          );
-        }
-        metadataEntries.push(
-          Epub.createXmlElement(
-            "meta",
-            { refines: `#${id}`, property: "display-seq" },
-            [Epub.createXmlTextNode((i + 1).toString())]
-          )
-        );
-      }
-    });
-  }
-  /**
-   * Retrieve the list of collections.
-   */
-  async getCollections() {
-    var _a, _b;
-    const metadata = await this.getMetadata();
-    const collections = [];
-    for (const entry of metadata) {
-      if (entry.properties["property"] === "belongs-to-collection" && entry.value) {
-        const type = (_a = metadata.find(
-          (e) => e.properties["refines"] === `#${entry.id ?? ""}` && e.properties["property"] === "collection-type"
-        )) == null ? void 0 : _a.value;
-        const position = (_b = metadata.find(
-          (e) => e.properties["refines"] === `#${entry.id ?? ""}` && e.properties["property"] === "group-position"
-        )) == null ? void 0 : _b.value;
-        collections.push({
-          name: entry.value,
-          ...type && { type },
-          ...position && { position }
-        });
-      }
-    }
-    return collections;
-  }
-  /**
-   * Add a collection to the EPUB metadata.
-   *
-   * If index is provided, the collection will be placed at
-   * that index in the list of collections. Otherwise, it
-   * will be added to the end of the list.
-   */
-  async addCollection(collection, index) {
-    const collectionId = (0, import_nanoid.nanoid)();
-    await this.withPackage((packageElement) => {
-      var _a;
-      const metadata = Epub.findXmlChildByName(
-        "metadata",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!metadata)
-        throw new Error(
-          "Failed to parse EPUB: found no metadata element in package document"
-        );
-      let collectionCount = 0;
-      let metadataIndex = 0;
-      for (const meta of Epub.getXmlChildren(metadata)) {
-        if (collectionCount === index) break;
-        metadataIndex++;
-        if (Epub.isXmlTextNode(meta)) continue;
-        if (Epub.getXmlElementName(meta) !== "meta") continue;
-        if (((_a = meta[":@"]) == null ? void 0 : _a["@_property"]) !== "belongs-to-collection") continue;
-        collectionCount++;
-      }
-      Epub.getXmlChildren(metadata).splice(
-        metadataIndex,
-        0,
-        Epub.createXmlElement(
-          "meta",
-          { id: collectionId, property: "belongs-to-collection" },
-          [Epub.createXmlTextNode(collection.name)]
-        )
-      );
-    });
-    if (collection.position) {
-      await this.addMetadata({
-        type: "meta",
-        properties: { refines: `#${collectionId}`, property: "group-position" },
-        value: collection.position
-      });
-    }
-    if (collection.type) {
-      await this.addMetadata({
-        type: "meta",
-        properties: {
-          refines: `#${collectionId}`,
-          property: "collection-type"
-        },
-        value: collection.type
-      });
-    }
-  }
-  /**
-   * Remove a collection from the EPUB metadata.
-   *
-   * Removes the collection at the provided index. This index
-   * refers to the array returned by `epub.getCollections()`.
-   */
-  async removeCollection(index) {
-    await this.withPackage((packageElement) => {
-      var _a, _b;
-      const metadata = Epub.findXmlChildByName(
-        "metadata",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!metadata)
-        throw new Error(
-          "Failed to parse EPUB: found no metadata element in package document"
-        );
-      let collectionCount = null;
-      let metadataIndex = null;
-      for (const meta of Epub.getXmlChildren(metadata)) {
-        if (collectionCount === index) break;
-        metadataIndex = metadataIndex === null ? 0 : metadataIndex + 1;
-        if (Epub.isXmlTextNode(meta)) continue;
-        if (Epub.getXmlElementName(meta) !== "meta") continue;
-        if (((_a = meta[":@"]) == null ? void 0 : _a["@_property"]) !== "belongs-to-collection") continue;
-        collectionCount = collectionCount === null ? 0 : collectionCount + 1;
-      }
-      if (collectionCount === null || metadataIndex === null) return;
-      const [removed] = Epub.getXmlChildren(metadata).splice(metadataIndex, 1);
-      if (removed && !Epub.isXmlTextNode(removed) && ((_b = removed[":@"]) == null ? void 0 : _b["@_id"])) {
-        const id = removed[":@"]["@_id"];
-        const newChildren = Epub.getXmlChildren(metadata).filter((node) => {
-          var _a2;
-          if (Epub.isXmlTextNode(node)) return true;
-          if (Epub.getXmlElementName(node) !== "meta") return true;
-          if (((_a2 = node[":@"]) == null ? void 0 : _a2["@_refines"]) !== `#${id}`) return true;
-          return false;
-        });
-        Epub.replaceXmlChildren(metadata, newChildren);
-      }
-    });
-  }
-  /**
-   * Retrieve the list of creators.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dccreator
-   */
-  async getCreators(type = "creator") {
-    const metadata = await this.getMetadata();
-    const creatorEntries = metadata.filter(
-      (entry) => entry.type === `dc:${type}`
-    );
-    const creators = [];
-    const creatorsById = /* @__PURE__ */ new Map();
-    for (const entry of creatorEntries) {
-      if (!entry.value) continue;
-      const creator = { name: entry.value };
-      creators.push(creator);
-      if (entry.id) creatorsById.set(entry.id, creator);
-    }
-    metadata.forEach((entry) => {
-      if (entry.type !== "meta" || entry.properties["property"] !== "file-as" && entry.properties["property"] !== "role" && entry.properties["property"] !== "alternate-script" || !entry.value) {
-        return;
-      }
-      const creatorIdref = entry.properties["refines"];
-      if (!creatorIdref) return;
-      const creatorId = creatorIdref.slice(1);
-      const creator = creatorsById.get(creatorId);
-      if (!creator) return;
-      if (entry.properties["alternate-script"]) {
-        if (!entry.properties["xml:lang"]) return;
-        creator.alternateScripts ??= [];
-        creator.alternateScripts.push({
-          name: entry.value,
-          locale: new Intl.Locale(entry.properties["xml:lang"])
-        });
-        return;
-      }
-      const prop = entry.properties["property"] === "file-as" ? "fileAs" : "role";
-      creator[prop] = entry.value;
-      if (prop === "role" && entry.properties["scheme"]) {
-        creator.roleScheme = entry.properties["scheme"];
-      }
-    });
-    return creators;
-  }
-  /**
-   * Retrieve the list of contributors.
-   *
-   * This is a convenience method for
-   * `epub.getCreators('contributor')`.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dccontributor
-   */
-  getContributors() {
-    return this.getCreators("contributor");
-  }
-  /**
-   * Add a creator to the EPUB metadata.
-   *
-   * If index is provided, the creator will be placed at
-   * that index in the list of creators. Otherwise, it
-   * will be added to the end of the list.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dccreator
-   */
-  async addCreator(creator, index, type = "creator") {
-    const creatorId = (0, import_nanoid.nanoid)();
-    await this.withPackage((packageElement) => {
-      const metadata = Epub.findXmlChildByName(
-        "metadata",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!metadata)
-        throw new Error(
-          "Failed to parse EPUB: found no metadata element in package document"
-        );
-      let creatorCount = 0;
-      let metadataIndex = 0;
-      for (const meta of Epub.getXmlChildren(metadata)) {
-        if (creatorCount === index) break;
-        metadataIndex++;
-        if (Epub.isXmlTextNode(meta)) continue;
-        if (Epub.getXmlElementName(meta) !== `dc:${type}`) continue;
-        creatorCount++;
-      }
-      Epub.getXmlChildren(metadata).splice(
-        metadataIndex,
-        0,
-        Epub.createXmlElement(`dc:${type}`, { id: creatorId }, [
-          Epub.createXmlTextNode(creator.name)
-        ])
-      );
-    });
-    if (creator.role) {
-      await this.addMetadata({
-        type: "meta",
-        properties: {
-          refines: `#${creatorId}`,
-          property: "role",
-          ...creator.roleScheme && { scheme: creator.roleScheme }
-        },
-        value: creator.role
-      });
-    }
-    if (creator.fileAs) {
-      await this.addMetadata({
-        type: "meta",
-        properties: { refines: `#${creatorId}`, property: "file-as" },
-        value: creator.fileAs
-      });
-    }
-    if (creator.alternateScripts) {
-      for (const alternate of creator.alternateScripts) {
-        await this.addMetadata({
-          type: "meta",
-          properties: {
-            refines: `#${creatorId}`,
-            property: "alternate-script",
-            "xml:lang": alternate.locale.toString()
-          },
-          value: alternate.name
-        });
-      }
-    }
-  }
-  /**
-   * Remove a creator from the EPUB metadata.
-   *
-   * Removes the creator at the provided index. This index
-   * refers to the array returned by `epub.getCreators()`.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dccreator
-   */
-  async removeCreator(index, type = "creator") {
-    await this.withPackage((packageElement) => {
-      var _a;
-      const metadata = Epub.findXmlChildByName(
-        "metadata",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!metadata)
-        throw new Error(
-          "Failed to parse EPUB: found no metadata element in package document"
-        );
-      let creatorCount = null;
-      let metadataIndex = null;
-      for (const meta of Epub.getXmlChildren(metadata)) {
-        if (creatorCount === index) break;
-        metadataIndex = metadataIndex === null ? 0 : metadataIndex + 1;
-        if (Epub.isXmlTextNode(meta)) continue;
-        if (Epub.getXmlElementName(meta) !== `dc:${type}`) continue;
-        creatorCount = creatorCount === null ? 0 : creatorCount + 1;
-      }
-      if (creatorCount === null || metadataIndex === null) return;
-      const [removed] = Epub.getXmlChildren(metadata).splice(metadataIndex, 1);
-      if (removed && !Epub.isXmlTextNode(removed) && ((_a = removed[":@"]) == null ? void 0 : _a["@_id"])) {
-        const id = removed[":@"]["@_id"];
-        const newChildren = Epub.getXmlChildren(metadata).filter((node) => {
-          var _a2;
-          if (Epub.isXmlTextNode(node)) return true;
-          if (Epub.getXmlElementName(node) !== "meta") return true;
-          if (((_a2 = node[":@"]) == null ? void 0 : _a2["@_refines"]) !== `#${id}`) return true;
-          return false;
-        });
-        Epub.replaceXmlChildren(metadata, newChildren);
-      }
-    });
-  }
-  /**
-   * Remove a contributor from the EPUB metadata.
-   *
-   * Removes the contributor at the provided index. This index
-   * refers to the array returned by `epub.getContributors()`.
-   *
-   * This is a convenience method for
-   * `epub.removeCreator(index, 'contributor')`.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dccreator
-   */
-  async removeContributor(index) {
-    return this.removeCreator(index, "contributor");
-  }
-  /**
-   * Add a contributor to the EPUB metadata.
-   *
-   * If index is provided, the creator will be placed at
-   * that index in the list of creators. Otherwise, it
-   * will be added to the end of the list.
-   *
-   * This is a convenience method for
-   * `epub.addCreator(contributor, index, 'contributor')`.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-opf-dccreator
-   */
-  addContributor(contributor, index) {
-    return this.addCreator(contributor, index, "contributor");
-  }
-  async getSpine() {
-    if (this.spine !== null) return this.spine;
-    const packageElement = await this.getPackageElement();
-    const spine = Epub.findXmlChildByName(
-      "spine",
-      Epub.getXmlChildren(packageElement)
-    );
-    if (!spine)
-      throw new Error(
-        "Failed to parse EPUB: Found no spine element in package document"
-      );
-    this.spine = spine["spine"].filter((node) => !Epub.isXmlTextNode(node)).map((itemref) => {
-      var _a;
-      return (_a = itemref[":@"]) == null ? void 0 : _a["@_idref"];
-    }).filter((idref) => !!idref);
-    return this.spine;
-  }
-  /**
-   * Retrieve the manifest items that make up the Epub's spine.
-   *
-   * The spine specifies the order that the contents of the Epub
-   * should be displayed to users by default.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-spine-elem
-   */
-  async getSpineItems() {
-    const spine = await this.getSpine();
-    const manifest = await this.getManifest();
-    return spine.map((itemref) => manifest[itemref]).filter((entry) => !!entry);
-  }
-  /**
-   * Add an item to the spine of the EPUB.
-   *
-   * If `index` is undefined, the item will be added
-   * to the end of the spine. Otherwise it will be
-   * inserted at the specified index.
-   *
-   * If the manifestId does not correspond to an item
-   * in the manifest, this will throw an error.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-spine-elem
-   */
-  async addSpineItem(manifestId, index) {
-    const item = Epub.createXmlElement("itemref", { idref: manifestId });
-    const manifest = await this.getManifest();
-    const manifestItem = manifest[manifestId];
-    if (!manifestItem)
-      throw new Error(`Manifest item not found with id "${manifestId}"`);
-    await this.withPackage((packageElement) => {
-      const spine = Epub.findXmlChildByName(
-        "spine",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!spine)
-        throw new Error(
-          "Failed to parse EPUB: Found no spine element in package document"
-        );
-      if (index === void 0) {
-        Epub.getXmlChildren(spine).push(item);
-      } else {
-        Epub.getXmlChildren(spine).splice(index, 0, item);
-      }
-    });
-    this.spine = null;
-  }
-  /**
-   * Remove the spine item at the specified index.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-spine-elem
-   */
-  async removeSpineItem(index) {
-    await this.withPackage((packageElement) => {
-      const spine = Epub.findXmlChildByName(
-        "spine",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!spine)
-        throw new Error(
-          "Failed to parse EPUB: Found no spine element in package document"
-        );
-      Epub.getXmlChildren(spine).splice(index, 1);
-    });
-    this.spine = null;
-  }
-  async getNavigationChildren(ol, navHref, { resolveToRoot } = {}) {
-    var _a;
-    const children = [];
-    const childrenElements = Epub.getXmlChildren(ol).filter(
-      (node) => !Epub.isXmlTextNode(node) && Epub.getXmlElementName(node) === "li"
-    );
-    for (const childEl of childrenElements) {
-      const [firstChild, secondChild] = Epub.getXmlChildren(childEl).filter(
-        (node) => !Epub.isXmlTextNode(node) && ["a", "span", "ol"].includes(Epub.getXmlElementName(node))
-      );
-      if (!firstChild) continue;
-      if (!["a", "span"].includes(Epub.getXmlElementName(firstChild))) {
-        continue;
-      }
-      if (Epub.getXmlElementName(firstChild) === "span" && (!secondChild || Epub.getXmlElementName(secondChild) !== "ol")) {
-        continue;
-      }
-      children.push({
-        title: Epub.getXhtmlTextContent(Epub.getXmlChildren(firstChild)),
-        ...Epub.getXmlElementName(firstChild) === "a" && ((_a = firstChild[":@"]) == null ? void 0 : _a["@_href"]) && {
-          href: await this.resolveHref(
-            firstChild[":@"]["@_href"],
-            void 0,
-            { toRoot: resolveToRoot }
-          )
-        },
-        ...secondChild && Epub.getXmlElementName(secondChild) === "ol" && {
-          children: await this.getNavigationChildren(secondChild, navHref, {
-            resolveToRoot
-          })
-        }
-      });
-    }
-    return children;
-  }
-  async getNavigation(role, { resolveToRoot } = {}) {
-    const manifest = await this.getManifest();
-    const navItem = Object.values(manifest).find(
-      (item) => {
-        var _a;
-        return (_a = item.properties) == null ? void 0 : _a.includes("nav");
-      }
-    );
-    if (!navItem) return null;
-    const navContents = await this.readXhtmlItemContents(navItem.id);
-    const navEl = Epub.findXmlDescendantByName(
-      "nav",
-      navContents,
-      (node) => Epub.getXmlAttributes(node)["epub:type"] === role
-    );
-    if (!navEl) return null;
-    const [firstChild, secondChild] = Epub.getXmlChildren(navEl).filter(
-      (node) => !!(!Epub.isXmlTextNode(node) && Epub.getXmlElementName(node).match(/(?:h[1-6]|ol)/))
-    );
-    if (!firstChild) return null;
-    const title = Epub.getXmlElementName(firstChild).match(/h[1-6]/) ? Epub.getXhtmlTextContent(Epub.getXmlChildren(firstChild)) : null;
-    const list = Epub.getXmlElementName(firstChild) === "ol" ? firstChild : secondChild && Epub.getXmlElementName(secondChild) === "ol" ? secondChild : null;
-    if (!list) return null;
-    const children = await this.getNavigationChildren(list, navItem.href, {
-      resolveToRoot
-    });
-    return {
-      ...title && { title },
-      children
-    };
-  }
-  /**
-   * Returns the structured table of contents navigation document
-   * as a Navigation object.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-nav-toc
-   */
-  async getTableOfContents({
-    resolveToRoot
-  } = {}) {
-    const navigationToc = await this.getNavigation("toc", { resolveToRoot });
-    if (navigationToc) return navigationToc;
-    const ncxToc = await this.getNcxTableOfContents();
-    return {
-      children: ncxToc
-    };
-  }
-  /**
-   * Returns the structured landmarks navigation document
-   * as a Navigation object
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-nav-landmarks
-   */
-  async getLandmarks({
-    resolveToRoot
-  } = {}) {
-    return this.getNavigation("landmarks", { resolveToRoot });
-  }
-  /**
-   * Returns the structured page list navigation document
-   * as a Navigation object
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-nav-landmarks
-   */
-  async getPageList({
-    resolveToRoot
-  } = {}) {
-    return this.getNavigation("page-list", { resolveToRoot });
-  }
-  /**
-   * Name the entry a resolved URL addresses.
-   *
-   * A correctly authored publication percent-encodes its hrefs, so the
-   * decoded reading is the one the spec calls for and the one we prefer.
-   * Some publications instead write the entry name verbatim, so when the two
-   * readings differ we ask the archive which one it holds. A verbatim name
-   * carrying a bare `%`, as `100%.xhtml` does, is not a valid encoding at all
-   * and can only be its own answer.
-   */
-  async entryForUrl(url) {
-    const asWritten = url.pathname.slice(1);
-    let decoded;
-    try {
-      decoded = decodeURIComponent(asWritten);
-    } catch {
-      return asWritten;
-    }
-    if (decoded === asWritten) {
-      return decoded;
-    }
-    if (await this.adapter.exists(decoded)) {
-      return decoded;
-    }
-    return await this.adapter.exists(asWritten) ? asWritten : decoded;
-  }
-  /**
-   * Resolve an href to the name of the archive entry it addresses.
-   *
-   * @param from The entry the href appears in; it resolves against that
-   *   entry's directory
-   * @throws when the href addresses something outside the publication
-   */
-  async resolveEntry(from, href) {
-    const url = resolveEntryUrl(from, href);
-    if (!url) {
-      throw new Error(
-        `href does not address an entry in this publication: ${href}`
-      );
-    }
-    return this.entryForUrl(url);
-  }
-  /**
-   * Returns a path-relative-scheme-less URL, relative to the
-   * container root.
-   *
-   * An href that points outside the publication, such as an external link in
-   * a navigation document, is handed back unchanged.
-   *
-   * @param href The href to resolve
-   * @param [relativeTo] Optional - The href to resolve this href relative to.
-       Use if resolving a relative href from a file other than the package document.
-   */
-  async resolveHref(href, relativeTo, { toRoot } = {}) {
-    if (href.startsWith("#")) return href;
-    const rootfile = await this.getRootfile();
-    const from = relativeTo ? await this.resolveEntry(rootfile, relativeTo) : rootfile;
-    const url = resolveEntryUrl(from, href);
-    if (!url) return href;
-    const entry = (await this.entryForUrl(url)).split("/");
-    const base = toRoot ? [] : rootfile.split("/").slice(0, -1);
-    let shared = 0;
-    while (shared < base.length && base[shared] === entry[shared]) {
-      shared++;
-    }
-    const relative = [
-      ...Array(base.length - shared).fill(".."),
-      ...entry.slice(shared).map(encodeURIComponent)
-    ];
-    return relative.join("/") + url.hash;
-  }
-  async readFileContents(href, relativeTo, encoding) {
-    const rootfile = await this.getRootfile();
-    const from = relativeTo ? await this.resolveEntry(rootfile, relativeTo) : rootfile;
-    const entry = await this.resolveEntry(from, href);
-    const itemEntry = encoding ? await this.adapter.read(entry, encoding) : await this.adapter.read(entry);
-    return itemEntry;
-  }
-  async readItemContents(id, encoding) {
-    const rootfile = await this.getRootfile();
-    const manifest = await this.getManifest();
-    const manifestItem = manifest[id];
-    if (!manifestItem)
-      throw new Error(`Could not find item with id "${id}" in manifest`);
-    const entry = await this.resolveEntry(rootfile, manifestItem.href);
-    const itemEntry = encoding ? await this.adapter.read(entry, encoding) : await this.adapter.read(entry);
-    return itemEntry;
-  }
-  /**
-   * Create a new XHTML document with the given body
-   * and head.
-   *
-   * @param body The XML nodes to place in the body of the document
-   * @param head Optional - the XMl nodes to place in the head
-   * @param language Optional - defaults to the EPUB's language
-   */
-  async createXhtmlDocument(body, head, language) {
-    const lang = language ?? await this.getLanguage();
-    return [
-      Epub.createXmlElement("?xml", { version: "1.0", encoding: "UTF-8" }, [
-        { "#text": "" }
-      ]),
-      Epub.createXmlElement(
-        "html",
-        {
-          xmlns: "http://www.w3.org/1999/xhtml",
-          "xmlns:epub": "http://www.idpf.org/2007/ops",
-          ...lang && { "xml:lang": lang.toString(), lang: lang.toString() }
-        },
-        [
-          Epub.createXmlElement("head", {}, head),
-          Epub.createXmlElement("body", {}, body)
-        ]
-      )
-    ];
-  }
-  async readXhtmlItemContents(id, as = "xhtml") {
-    const contents = await this.readItemContents(id, "utf-8");
-    const xml = Epub.xhtmlParser.parse(contents);
-    if (as === "xhtml") return xml;
-    const body = Epub.getXhtmlBody(xml);
-    return Epub.getXhtmlTextContent(body);
-  }
-  async writeEntryContents(path, contents, encoding) {
-    this.assertWritable();
-    if (!this.adapter.write) {
-      throw new EpubReadOnlyError(
-        `adapter ${this.adapterClass.kind} does not support writes`
-      );
-    }
-    if (encoding === "utf-8") {
-      await this.adapter.write(path, contents, encoding);
-    } else {
-      await this.adapter.write(path, contents);
-    }
-  }
-  async writeItemContents(id, contents, encoding) {
-    const rootfile = await this.getRootfile();
-    const manifest = await this.getManifest();
-    const manifestItem = manifest[id];
-    if (!manifestItem)
-      throw new Error(`Could not find item with id "${id}" in manifest`);
-    import_mem.default.clear(this.readXhtmlItemContents);
-    const entry = await this.resolveEntry(rootfile, manifestItem.href);
-    if (encoding === "utf-8") {
-      await this.writeEntryContents(entry, contents, encoding);
-    } else {
-      await this.writeEntryContents(entry, contents);
-    }
-  }
-  /**
-   * Write new contents for an existing XHTML item,
-   * specified by its id.
-   *
-   * The id must reference an existing manifest item. If
-   * creating a new item, use `epub.addManifestItem()` instead.
-   *
-   * @param id The id of the manifest item to write new contents for
-   * @param contents The new contents. Must be a parsed XML tree.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-xhtml
-   */
-  async writeXhtmlItemContents(id, contents) {
-    await this.writeItemContents(
-      id,
-      Epub.xhtmlBuilder.build(contents),
-      "utf-8"
-    );
-  }
-  async removeManifestItem(id) {
-    await this.withPackage(async (packageElement) => {
-      var _a;
-      const manifest = Epub.findXmlChildByName(
-        "manifest",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!manifest)
-        throw new Error(
-          "Failed to parse EPUB: Found no manifest element in package document"
-        );
-      const itemIndex = Epub.getXmlChildren(manifest).findIndex(
-        (node) => {
-          var _a2;
-          return !Epub.isXmlTextNode(node) && ((_a2 = node[":@"]) == null ? void 0 : _a2["@_id"]) === id;
-        }
-      );
-      if (itemIndex === -1) return;
-      const [item] = Epub.getXmlChildren(manifest).splice(itemIndex, 1);
-      if (!item || Epub.isXmlTextNode(item) || !((_a = item[":@"]) == null ? void 0 : _a["@_href"])) return;
-      await this.removeEntry(item[":@"]["@_href"]);
-    });
-    this.manifest = null;
-  }
-  async addManifestItem(item, contents, encoding) {
-    await this.withPackage((packageElement) => {
-      const manifest = Epub.findXmlChildByName(
-        "manifest",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!manifest)
-        throw new Error(
-          "Failed to parse EPUB: Found no manifest element in package document"
-        );
-      Epub.getXmlChildren(manifest).push(
-        Epub.createXmlElement("item", {
-          id: item.id,
-          href: item.href,
-          ...item.mediaType && { "media-type": item.mediaType },
-          ...item.fallback && { fallback: item.fallback },
-          ...item.mediaOverlay && { "media-overlay": item.mediaOverlay },
-          ...item.properties && {
-            properties: item.properties.join(" ")
-          }
-        })
-      );
-    });
-    this.manifest = null;
-    const rootfile = await this.getRootfile();
-    const filename = await this.resolveEntry(rootfile, item.href);
-    const data = encoding === "utf-8" || encoding === "xml" ? new TextEncoder().encode(
-      encoding === "utf-8" ? contents : await Epub.xmlBuilder.build(
-        contents
-      )
-    ) : contents;
-    await this.writeEntryContents(filename, data);
-  }
-  /**
-   * Update the manifest entry for an existing item.
-   *
-   * To update the contents of an entry, use `epub.writeItemContents()`
-   * or `epub.writeXhtmlItemContents()`
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-pkg-manifest
-   */
-  async updateManifestItem(id, newItem) {
-    await this.withPackage((packageElement) => {
-      const manifest = Epub.findXmlChildByName(
-        "manifest",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!manifest)
-        throw new Error(
-          "Failed to parse EPUB: Found no manifest element in package document"
-        );
-      const itemIndex = manifest["manifest"].findIndex(
-        (item) => {
-          var _a;
-          return !Epub.isXmlTextNode(item) && ((_a = item[":@"]) == null ? void 0 : _a["@_id"]) === id;
-        }
-      );
-      Epub.getXmlChildren(manifest).splice(
-        itemIndex,
-        1,
-        Epub.createXmlElement("item", {
-          id,
-          href: newItem.href,
-          ...newItem.mediaType && { "media-type": newItem.mediaType },
-          ...newItem.fallback && { fallback: newItem.fallback },
-          ...newItem.mediaOverlay && {
-            "media-overlay": newItem.mediaOverlay
-          },
-          ...newItem.properties && {
-            properties: newItem.properties.join(" ")
-          }
-        })
-      );
-    });
-    this.manifest = null;
-  }
-  /**
-   * Add a new metadata entry to the Epub.
-   *
-   * This method, like `epub.getMetadata()`, operates on
-   * metadata entries. For more useful semantic representations
-   * of metadata, use specific methods such as `setTitle()` and
-   * `setLanguage()`.
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-pkg-metadata
-   */
-  async addMetadata(entry) {
-    await this.withPackage((packageElement) => {
-      const metadata = Epub.findXmlChildByName(
-        "metadata",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!metadata)
-        throw new Error(
-          "Failed to parse EPUB: found no metadata element in package document"
-        );
-      Epub.getXmlChildren(metadata).push(
-        Epub.createXmlElement(
-          entry.type,
-          {
-            ...entry.id && { id: entry.id },
-            ...entry.properties
-          },
-          entry.value !== void 0 ? [Epub.createXmlTextNode(entry.value)] : []
-        )
-      );
-    });
-  }
-  /**
-   * Replace a metadata entry with a new one.
-   *
-   * The `predicate` argument will be used to determine which entry
-   * to replace. The first metadata entry that matches the
-   * predicate will be replaced.
-   *
-   * @param predicate Calls predicate once for each metadata entry,
-   *  until it finds one where predicate returns true
-   * @param entry The new entry to replace the found entry with
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-pkg-metadata
-   */
-  async replaceMetadata(predicate, entry) {
-    await this.withPackage((packageElement) => {
-      const metadataElement = Epub.findXmlChildByName(
-        "metadata",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!metadataElement)
-        throw new Error(
-          "Failed to parse EPUB: found no metadata element in package document"
-        );
-      const oldEntryIndex = this.findMetadataIndex(packageElement, predicate);
-      const newElement = Epub.createXmlElement(
-        entry.type,
-        {
-          ...entry.id && { id: entry.id },
-          ...entry.properties
-        },
-        entry.value !== void 0 ? [Epub.createXmlTextNode(entry.value)] : []
-      );
-      if (oldEntryIndex === -1) {
-        metadataElement.metadata.push(newElement);
-      } else {
-        metadataElement.metadata.splice(oldEntryIndex, 1, newElement);
-      }
-    });
-  }
-  /**
-   * Remove one or more metadata entries.
-   *
-   * The `predicate` argument will be used to determine which entries
-   * to remove. The all metadata entries that match the
-   * predicate will be removed.
-   *
-   * @param predicate Calls predicate once for each metadata entry,
-   *  removing any for which it returns true
-   *
-   * @link https://www.w3.org/TR/epub-33/#sec-pkg-metadata
-   */
-  async removeMetadata(predicate) {
-    await this.withPackage((packageElement) => {
-      const metadataElement = Epub.findXmlChildByName(
-        "metadata",
-        Epub.getXmlChildren(packageElement)
-      );
-      if (!metadataElement) {
-        throw new Error(
-          "Failed to parse EPUB: found no metadata element in package document"
-        );
-      }
-      const metadataEntries = Epub.getXmlChildren(metadataElement);
-      for (let i = metadataEntries.length - 1; i >= 0; i--) {
-        const meta = metadataEntries[i];
-        const item = Epub.parseMetadataItem(meta);
-        if (!item) continue;
-        if (predicate(item)) {
-          metadataEntries.splice(i, 1);
-        }
-      }
-    });
-  }
-  /**
-   * Returns the EPUB version declared on the package element.
-   */
-  async getVersion() {
-    var _a;
-    const packageElement = await this.getPackageElement();
-    return ((_a = packageElement[":@"]) == null ? void 0 : _a["@_version"]) ?? "2.0";
-  }
-  /**
-   * Parse the NCX table of contents, if one exists, and return
-   * a tree of TocEntry nodes.
-   *
-   * Useful for both EPUB 2 publications (where the NCX is the
-   * primary navigation) and EPUB 3 publications that retain an
-   * NCX for backwards compatibility.
-   */
-  async getNcxTableOfContents() {
-    var _a;
-    const [manifest, packageElement] = await Promise.all([
-      this.getManifest(),
-      this.getPackageElement()
-    ]);
-    const spine = Epub.findXmlChildByName(
-      "spine",
-      Epub.getXmlChildren(packageElement)
-    );
-    const spineTocId = (_a = spine == null ? void 0 : spine[":@"]) == null ? void 0 : _a["@_toc"];
-    const ncxItem = spineTocId ? manifest[spineTocId] : Object.values(manifest).find(
-      (item) => import_media_types.MediaType.fromMime(item.mediaType ?? "") === import_media_types.MediaType.NCX
-    );
-    if (!ncxItem) return [];
-    const ncxContent = await this.readItemContents(ncxItem.id, "utf-8");
-    const ncxXml = Epub.xmlParser.parse(ncxContent);
-    const ncxElement = Epub.findXmlChildByName("ncx", ncxXml);
-    if (!ncxElement) return [];
-    const ncxChildren = Epub.getXmlChildren(ncxElement);
-    const navMap = Epub.findXmlChildByName("navMap", ncxChildren) ?? Epub.findXmlChildByName("navmap", ncxChildren);
-    if (!navMap) return [];
-    return this.parseNavPoints(Epub.getXmlChildren(navMap), ncxItem.href);
-  }
-  async parseNavPoints(nodes, ncxHref) {
-    var _a;
-    const entries = [];
-    for (const node of nodes) {
-      if (Epub.isXmlTextNode(node)) continue;
-      const name = Epub.getXmlElementName(node);
-      const isNavPoint = name === "navPoint" || name === "navpoint";
-      if (!isNavPoint) continue;
-      const children = Epub.getXmlChildren(node);
-      const navLabel = Epub.findXmlChildByName("navLabel", children) ?? Epub.findXmlChildByName("navlabel", children);
-      let title = null;
-      if (navLabel) {
-        const textEl = Epub.findXmlChildByName(
-          "text",
-          Epub.getXmlChildren(navLabel)
-        );
-        if (textEl) {
-          title = Epub.getXhtmlTextContent(Epub.getXmlChildren(textEl)).trim() || null;
-        }
-      }
-      const contentEl = Epub.findXmlChildByName("content", children);
-      const src = (_a = contentEl == null ? void 0 : contentEl[":@"]) == null ? void 0 : _a["@_src"];
-      const href = src ? await this.resolveHref(src, ncxHref) : null;
-      const childEntries = await this.parseNavPoints(children, ncxHref);
-      entries.push({
-        title: title ?? `${entries.length}`,
-        ...href && { href },
-        children: childEntries
-      });
-    }
-    return entries;
-  }
-  /**
-   * Retrieve the guide entries from the package document.
-   *
-   * The guide element is deprecated in EPUB 3 in favor of
-   * the landmarks nav, but many publications still include it.
-   */
-  async getGuideEntries() {
-    const packageElement = await this.getPackageElement();
-    const guide = Epub.findXmlChildByName(
-      "guide",
-      Epub.getXmlChildren(packageElement)
-    );
-    if (!guide) return [];
-    return Epub.getXmlChildren(guide).filter(
-      (node) => !Epub.isXmlTextNode(node) && "reference" in node
-    ).map((ref) => {
-      var _a, _b, _c;
-      return {
-        href: ((_a = ref[":@"]) == null ? void 0 : _a["@_href"]) ?? "",
-        title: ((_b = ref[":@"]) == null ? void 0 : _b["@_title"]) ?? "",
-        type: (((_c = ref[":@"]) == null ? void 0 : _c["@_type"]) ?? "").toLowerCase()
-      };
-    }).filter((entry) => entry.href);
-  }
-  discardAndClose() {
-    this.rootfile = null;
-    this.manifest = null;
-    this.spine = null;
-    void this.adapter.dispose();
-  }
-  /**
-   * Write the current contents of the Epub to a new
-   * EPUB archive on disk.
-   *
-   * When this method is called, the "dcterms:modified"
-   * meta tag is automatically updated to the current UTC
-   * timestamp.
-   */
-  async saveAndClose() {
-    this.assertWritable();
-    if (!this.inputPath) {
-      throw new Error("In-memory EPUB files cannot be saved to disk");
-    }
-    if (!this.adapter.serialize) {
-      throw new Error(
-        `adapter ${this.adapterClass.kind} does not support serialization`
-      );
-    }
-    await this.replaceMetadata(
-      (entry) => entry.properties["property"] === "dcterms:modified",
-      {
-        type: "meta",
-        properties: { property: "dcterms:modified" },
-        // We need UTC with integer seconds, but toISOString gives UTC with ms
-        value: (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d+/, "")
-      }
-    );
-    await this.adapter.serialize(this.inputPath);
-  }
-  /**
-   * Upgrade an EPUB 2 publication to EPUB 3 in place, returning a new,
-   * valid Epub 3 instance. Equivalent to
-   * `Epub.using(TmpFsAdapter).upgrade(...)`.
-   */
-  static async upgrade(path, options = {}) {
-    return Epub.using(import_tmpfs.TmpFsAdapter).upgrade(path, options);
-  }
-  [Symbol.dispose]() {
-    this.discardAndClose();
-  }
-}
-class EpubFactory {
-  constructor(adapterClass) {
-    this.adapterClass = adapterClass;
-  }
-  async from(source, options = {}) {
-    const adapter = await this.adapterClass.init(
-      source,
-      options
-    );
-    const inputPath = typeof source === "string" ? source : void 0;
-    const readonlyOverride = options.readonly === true;
-    const epub = new Epub(
-      this.adapterClass,
-      adapter,
-      inputPath,
-      readonlyOverride
-    );
-    try {
-      await epub.getPackageElement();
-    } catch (e) {
-      epub.discardAndClose();
-      console.error(e);
-      throw new Error(
-        "This is not a valid EPUB publication. Could not read the package document."
-      );
-    }
-    try {
-      await Epub.assertEpub3(epub);
-    } catch (error) {
-      epub.discardAndClose();
-      throw error;
-    }
-    return epub;
-  }
-  /**
-   * Construct a new EPUB on this factory's adapter, optionally seeded
-   * with the provided metadata. Requires a writable adapter that
-   * implements `initEmpty` (today: {@link TmpFsAdapter}).
-   *
-   * @throws when the adapter is read-only or does not implement initEmpty
-   */
-  async create(path, {
-    title,
-    language,
-    identifier,
-    date,
-    subjects,
-    type,
-    creators,
-    contributors
-  }, additionalMetadata = []) {
-    if (!this.adapterClass.capabilities.writable) {
-      throw new EpubReadOnlyError(
-        `adapter ${this.adapterClass.kind} is read-only; cannot create`
-      );
-    }
-    if (!this.adapterClass.initEmpty) {
-      throw new Error(
-        `adapter ${this.adapterClass.kind} does not support create() (missing initEmpty)`
-      );
-    }
-    const adapter = await this.adapterClass.initEmpty();
-    if (!adapter.write) {
-      throw new Error(
-        `adapter ${this.adapterClass.kind} declared writable but did not implement write()`
-      );
-    }
-    const encoder = new TextEncoder();
-    const container = encoder.encode(`<?xml version="1.0"?>
-<container version="1.0" xmlns="urn:oasis:names:tc:opendocument:xmlns:container">
-  <rootfiles>
-    <rootfile media-type="${import_media_types.MediaType.OPF.mime}" full-path="OEBPS/content.opf"/>
-  </rootfiles>
-</container>
-`);
-    await adapter.write("META-INF/container.xml", container);
-    const packageDocument = encoder.encode(`<?xml version="1.0"?>
-<package unique-identifier="pub-id" dir="${language.textInfo.direction}" xml:lang="${language.toString()}" version="3.0" xmlns:dc="http://purl.org/dc/elements/1.1/">
-  <metadata>
-  </metadata>
-  <manifest>
-  </manifest>
-  <spine>
-  </spine>
-</package>
-`);
-    await adapter.write("OEBPS/content.opf", packageDocument);
-    const epub = new Epub(this.adapterClass, adapter, path);
-    const metadata = [
-      {
-        id: "pub-id",
-        type: "dc:identifier",
-        properties: {},
-        value: identifier
-      },
-      ...additionalMetadata
-    ];
-    await Promise.all(metadata.map((entry) => epub.addMetadata(entry)));
-    await epub.setTitle(title);
-    await epub.setLanguage(language);
-    if (date) await epub.setPublicationDate(date);
-    if (type) await epub.setType(type);
-    if (subjects) {
-      await Promise.all(subjects.map((subject) => epub.addSubject(subject)));
-    }
-    if (creators) {
-      await Promise.all(creators.map((creator) => epub.addCreator(creator)));
-    }
-    if (contributors) {
-      await Promise.all(
-        contributors.map((contributor) => epub.addCreator(contributor))
-      );
-    }
-    return epub;
-  }
-  /**
-   * Upgrade an EPUB 2 publication to EPUB 3 in place using this
-   * factory's adapter, returning a new, valid Epub 3 instance.
-   *
-   * Performs the following transformations:
-   *  - upgrades OPF metadata to EPUB 3 conventions
-   *  - scans XHTML documents and adds manifest item properties
-   *  - parses the NCX into a TOC tree and generates a nav.xhtml
-   *  - removes the NCX file and the guide element (configurable)
-   *  - fixes common font MIME types
-   *  - bumps the package version to 3.0
-   *  - goes over each xhtml item and rewrites it using XMLParser to make sure the output is valid XHTML
-   *
-   * Requires a writable adapter. When {@link Upgrade.Epub2UpgradeOptions.outputPath}
-   * is set, the source file is copied to that path on disk first; this
-   * only makes sense for adapters whose `source` is a real fs path.
-   *
-   * @throws when the adapter is read-only
-   */
-  async upgrade(path, options = {}) {
-    if (!this.adapterClass.capabilities.writable) {
-      throw new EpubReadOnlyError(
-        `adapter ${this.adapterClass.kind} is read-only; cannot upgrade`
-      );
-    }
-    const { removeNcx = false, outputPath } = options;
-    if (outputPath) {
-      await (0, import_promises.mkdir)((0, import_path.dirname)(outputPath), { recursive: true });
-      await (0, import_promises.cp)(path, outputPath, { force: true });
-    }
-    const source = outputPath ?? path;
-    const adapter = await this.adapterClass.init(
-      source,
-      options
-    );
-    const epub = new Epub(this.adapterClass, adapter, source);
-    try {
-      await epub.getPackageElement();
-    } catch (e) {
-      epub.discardAndClose();
-      console.error(e);
-      throw new Error(
-        "This is not a valid EPUB publication. Could not read the package document."
-      );
-    }
-    try {
-      const version = await epub.getVersion();
-      if (version.startsWith("3.")) {
-        return epub;
-      }
-      const tocEntries = await epub.getNcxTableOfContents();
-      let landmarks = [];
-      await epub.withPackage((pkg) => {
-        landmarks = Upgrade.extractGuideLandmarks(pkg);
-        Upgrade.upgradePackageMetadata(pkg);
-        Upgrade.fixFontMimeTypes(pkg);
-        Upgrade.removeGuide(pkg);
-        if (removeNcx) {
-          Upgrade.removeSpineTocRef(pkg);
-        }
-        Upgrade.setPackageVersion(pkg, "3.0");
-      });
-      await Upgrade.collectManifestProperties(epub);
-      if (removeNcx) {
-        await Upgrade.removeNcx(epub);
-      }
-      const navHref = await Upgrade.chooseNavHref(epub);
-      const navContent = await Upgrade.buildNavDocument(
-        epub,
-        tocEntries,
-        landmarks
-      );
-      await epub.addManifestItem(
-        {
-          id: "nav",
-          href: navHref,
-          mediaType: import_media_types.MediaType.XHTML.mime,
-          properties: ["nav"]
-        },
-        navContent,
-        "utf-8"
-      );
-      const manifest = await epub.getManifest();
-      for (const item of Object.values(manifest)) {
-        if (import_media_types.MediaType.fromMime(item.mediaType ?? "") !== import_media_types.MediaType.XHTML)
-          continue;
-        const contents = await epub.readXhtmlItemContents(item.id);
-        await epub.writeXhtmlItemContents(item.id, contents);
-      }
-      return epub;
-    } catch (error) {
-      epub.discardAndClose();
-      throw error;
-    }
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  Epub,
-  EpubFactory,
-  EpubReadOnlyError,
-  EpubVersionError,
-  MemoryAdapter,
-  TmpFsAdapter
-});