npm - @storyteller-platform/epub - Versions diffs - 0.2.1 → 0.4.0 - Mend

@storyteller-platform/epub 0.2.1 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/README.md CHANGED Viewed

@@ -220,90 +220,132 @@ To get started with developing in the Storyteller monorepo, check out the
 ## Epub
 Defined in:
-[epub/node.ts:24](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/node.ts#L24)
+[epub/index.ts:164](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L164)
-### Extends
+A single EPUB instance.
-- `Epub`
+The entire EPUB contents will be read into memory.
+Example usage:
+```ts
+import {
+  Epub,
+  getBody,
+  findByName,
+  textContent,
+} from "@storyteller-platform/epub"
+const epub = await Epub.from("./path/to/book.epub")
+const title = await epub.getTitle()
+const spineItems = await epub.getSpineItems()
+const chptOne = spineItems[0]
+const chptOneXml = await epub.readXhtmlItemContents(chptOne.id)
+const body = getBody(chptOneXml)
+const h1 = Epub.findXmlChildByName("h1", body)
+const headingText = textContent(h1)
+await epub.setTitle(headingText)
+await epub.writeToFile("./path/to/updated.epub")
+await epub.close()
+```
+### Link
+https://www.w3.org/TR/epub-33/
 ### Constructors
 #### Constructor
-> `protected` **new Epub**(`entries`, `onClose?`): [`Epub`](#epub)
+> `protected` **new Epub**(`zipFs`, `zipPath`, `inputPath`): [`Epub`](#epub)
 Defined in:
-[epub/index.ts:409](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L409)
+[epub/index.ts:368](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L368)
 ##### Parameters
-| Parameter  | Type                                |
-| ---------- | ----------------------------------- |
-| `entries`  | `EpubEntry`[]                       |
-| `onClose?` | () => `void` \| `Promise`\<`void`\> |
+| Parameter   | Type                    |
+| ----------- | ----------------------- |
+| `zipFs`     | `ZipFS`                 |
+| `zipPath`   | `NativePath`            |
+| `inputPath` | `undefined` \| `string` |
 ##### Returns
 [`Epub`](#epub)
-##### Inherited from
+### Properties
-`BaseEpub.constructor`
+#### inputPath
-### Properties
+> `protected` **inputPath**: `undefined` \| `string`
-#### xhtmlBuilder
+Defined in:
+[epub/index.ts:371](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L371)
-> `static` **xhtmlBuilder**: `XMLBuilder`
+#### zipFs
+> `protected` **zipFs**: `ZipFS`
 Defined in:
-[epub/index.ts:241](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L241)
+[epub/index.ts:369](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L369)
-##### Inherited from
+#### zipPath
-`BaseEpub.xhtmlBuilder`
+> `protected` **zipPath**: `NativePath`
-#### xhtmlParser
+Defined in:
+[epub/index.ts:370](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L370)
-> `static` **xhtmlParser**: `XMLParser`
+#### xhtmlBuilder
+> `static` **xhtmlBuilder**: `XMLBuilder`
 Defined in:
-[epub/index.ts:209](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L209)
+[epub/index.ts:204](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L204)
-##### Inherited from
+#### xhtmlParser
-`BaseEpub.xhtmlParser`
+> `static` **xhtmlParser**: `XMLParser`
+Defined in:
+[epub/index.ts:172](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L172)
 #### xmlBuilder
 > `static` **xmlBuilder**: `XMLBuilder`
 Defined in:
-[epub/index.ts:234](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L234)
-##### Inherited from
-`BaseEpub.xmlBuilder`
+[epub/index.ts:197](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L197)
 #### xmlParser
 > `static` **xmlParser**: `XMLParser`
 Defined in:
-[epub/index.ts:202](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L202)
+[epub/index.ts:165](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L165)
+### Methods
-##### Inherited from
+#### \[dispose\]()
-`BaseEpub.xmlParser`
+> **\[dispose\]**(): `void`
-### Methods
+Defined in:
+[epub/index.ts:2445](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2445)
+##### Returns
+`void`
 #### addCollection()
 > **addCollection**(`collection`, `index?`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1518](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1518)
+[epub/index.ts:1494](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1494)
 Add a collection to the EPUB metadata.
@@ -321,16 +363,12 @@ collections. Otherwise, it will be added to the end of the list.
 `Promise`\<`void`\>
-##### Inherited from
-`BaseEpub.addCollection`
 #### addContributor()
 > **addContributor**(`contributor`, `index?`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1860](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1860)
+[epub/index.ts:1836](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1836)
 Add a contributor to the EPUB metadata.
@@ -355,16 +393,12 @@ This is a convenience method for
 https://www.w3.org/TR/epub-33/#sec-opf-dccreator
-##### Inherited from
-`BaseEpub.addContributor`
 #### addCreator()
 > **addCreator**(`creator`, `index?`, `type?`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1705](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1705)
+[epub/index.ts:1681](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1681)
 Add a creator to the EPUB metadata.
@@ -387,10 +421,6 @@ creators. Otherwise, it will be added to the end of the list.
 https://www.w3.org/TR/epub-33/#sec-opf-dccreator
-##### Inherited from
-`BaseEpub.addCreator`
 #### addManifestItem()
 ##### Call Signature
@@ -398,7 +428,7 @@ https://www.w3.org/TR/epub-33/#sec-opf-dccreator
 > **addManifestItem**(`item`, `contents`, `encoding`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:2196](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2196)
+[epub/index.ts:2163](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2163)
 Create a new manifest item and write its contents to a new entry.
@@ -422,16 +452,12 @@ https://www.w3.org/TR/epub-33/#sec-pkg-manifest
 https://www.w3.org/TR/epub-33/#sec-contentdocs
-###### Inherited from
-`BaseEpub.addManifestItem`
 ##### Call Signature
 > **addManifestItem**(`item`, `contents`, `encoding`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:2201](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2201)
+[epub/index.ts:2168](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2168)
 Create a new manifest item and write its contents to a new entry.
@@ -455,16 +481,12 @@ https://www.w3.org/TR/epub-33/#sec-pkg-manifest
 https://www.w3.org/TR/epub-33/#sec-contentdocs
-###### Inherited from
-`BaseEpub.addManifestItem`
 ##### Call Signature
 > **addManifestItem**(`item`, `contents`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:2206](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2206)
+[epub/index.ts:2173](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2173)
 Create a new manifest item and write its contents to a new entry.
@@ -487,16 +509,12 @@ https://www.w3.org/TR/epub-33/#sec-pkg-manifest
 https://www.w3.org/TR/epub-33/#sec-contentdocs
-###### Inherited from
-`BaseEpub.addManifestItem`
 #### addMetadata()
 > **addMetadata**(`entry`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:2315](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2315)
+[epub/index.ts:2285](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2285)
 Add a new metadata entry to the Epub.
@@ -518,16 +536,12 @@ useful semantic representations of metadata, use specific methods such as
 https://www.w3.org/TR/epub-33/#sec-pkg-metadata
-##### Inherited from
-`BaseEpub.addMetadata`
 #### addSpineItem()
 > **addSpineItem**(`manifestId`, `index?`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1914](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1914)
+[epub/index.ts:1890](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1890)
 Add an item to the spine of the EPUB.
@@ -552,16 +566,12 @@ throw an error.
 https://www.w3.org/TR/epub-33/#sec-spine-elem
-##### Inherited from
-`BaseEpub.addSpineItem`
 #### addSubject()
 > **addSubject**(`subject`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1051](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1051)
+[epub/index.ts:1027](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1027)
 Add a subject to the EPUB metadata.
@@ -579,28 +589,6 @@ Add a subject to the EPUB metadata.
 https://www.w3.org/TR/epub-33/#sec-opf-dcsubject
-##### Inherited from
-`BaseEpub.addSubject`
-#### close()
-> **close**(): `Promise`\<`void`\>
-Defined in:
-[epub/index.ts:429](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L429)
-Close the Epub. Must be called before the Epub goes out of scope/is garbage
-collected.
-##### Returns
-`Promise`\<`void`\>
-##### Inherited from
-`BaseEpub.close`
 #### createXhtmlDocument()
 > **createXhtmlDocument**(`body`, `head?`, `language?`):
@@ -608,7 +596,7 @@ collected.
 > [`XmlElement`](#xmlelement)\<`"?xml"`\>)[]\>
 Defined in:
-[epub/index.ts:2019](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2019)
+[epub/index.ts:1991](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1991)
 Create a new XHTML document with the given body and head.
@@ -625,16 +613,23 @@ Create a new XHTML document with the given body and head.
 `Promise`\<([`XmlElement`](#xmlelement)\<`"html"`\> \|
 [`XmlElement`](#xmlelement)\<`"?xml"`\>)[]\>
-##### Inherited from
+#### discardAndClose()
+> **discardAndClose**(): `void`
+Defined in:
+[epub/index.ts:2394](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2394)
+##### Returns
-`BaseEpub.createXhtmlDocument`
+`void`
 #### findAllMetadataItems()
 > **findAllMetadataItems**(`predicate`): `Promise`\<`object`[]\>
 Defined in:
-[epub/index.ts:804](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L804)
+[epub/index.ts:750](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L750)
 Returns the item in the metadata element's children array that matches the
 provided predicate.
@@ -649,10 +644,6 @@ provided predicate.
 `Promise`\<`object`[]\>
-##### Inherited from
-`BaseEpub.findAllMetadataItems`
 #### findMetadataItem()
 > **findMetadataItem**(`predicate`): `Promise`\<`null` \| \{ `id`: `undefined`
@@ -678,7 +669,7 @@ provided predicate.
 > \}\>
 Defined in:
-[epub/index.ts:795](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L795)
+[epub/index.ts:741](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L741)
 Returns the item in the metadata element's children array that matches the
 provided predicate.
@@ -712,16 +703,12 @@ provided predicate.
 `` `Y${string}` `` \| `` `Z${string}` `` \| `` `?${string}` ``; `value`:
 `undefined` \| `string`; \}\>
-##### Inherited from
-`BaseEpub.findMetadataItem`
 #### getCollections()
 > **getCollections**(): `Promise`\<[`Collection`](#collection)[]\>
 Defined in:
-[epub/index.ts:1478](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1478)
+[epub/index.ts:1454](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1454)
 Retrieve the list of collections.
@@ -729,16 +716,12 @@ Retrieve the list of collections.
 `Promise`\<[`Collection`](#collection)[]\>
-##### Inherited from
-`BaseEpub.getCollections`
 #### getContributors()
 > **getContributors**(): `Promise`\<[`DcCreator`](#dccreator)[]\>
 Defined in:
-[epub/index.ts:1692](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1692)
+[epub/index.ts:1668](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1668)
 Retrieve the list of contributors.
@@ -752,16 +735,12 @@ This is a convenience method for `epub.getCreators('contributor')`.
 https://www.w3.org/TR/epub-33/#sec-opf-dccontributor
-##### Inherited from
-`BaseEpub.getContributors`
 #### getCoverImage()
 > **getCoverImage**(): `Promise`\<`null` \| `Uint8Array`\<`ArrayBufferLike`\>\>
 Defined in:
-[epub/index.ts:954](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L954)
+[epub/index.ts:930](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L930)
 Retrieve the cover image data as a byte array.
@@ -776,17 +755,13 @@ retrieve the image manifest item, use epub.getCoverImageItem().
 https://www.w3.org/TR/epub-33/#sec-cover-image
-##### Inherited from
-`BaseEpub.getCoverImage`
 #### getCoverImageItem()
 > **getCoverImageItem**(): `Promise`\<`null` \|
 > [`ManifestItem`](#manifestitem)\>
 Defined in:
-[epub/index.ts:935](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L935)
+[epub/index.ts:911](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L911)
 Retrieve the cover image manifest item.
@@ -801,16 +776,12 @@ this item's id to epub.readItemContents, or use epub.getCoverImage() instead.
 https://www.w3.org/TR/epub-33/#sec-cover-image
-##### Inherited from
-`BaseEpub.getCoverImageItem`
 #### getCreators()
 > **getCreators**(`type`): `Promise`\<[`DcCreator`](#dccreator)[]\>
 Defined in:
-[epub/index.ts:1631](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1631)
+[epub/index.ts:1607](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1607)
 Retrieve the list of creators.
@@ -828,16 +799,12 @@ Retrieve the list of creators.
 https://www.w3.org/TR/epub-33/#sec-opf-dccreator
-##### Inherited from
-`BaseEpub.getCreators`
 #### getDescription()
 > **getDescription**(): `Promise`\<`null` \| `string`\>
 Defined in:
-[epub/index.ts:1329](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1329)
+[epub/index.ts:1305](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1305)
 Retrieve the Epub's description as specified in its package document metadata.
@@ -848,16 +815,31 @@ as a string. Descriptions may include HTML markup.
 `Promise`\<`null` \| `string`\>
-##### Inherited from
+#### getIdentifier()
+> **getIdentifier**(): `Promise`\<`null` \| `string`\>
+Defined in:
+[epub/index.ts:845](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L845)
+Retrieve the identifier from the dc:identifier element in the EPUB metadata.
+If there is no dc:identifier element, returns null.
+##### Returns
+`Promise`\<`null` \| `string`\>
+##### Link
-`BaseEpub.getDescription`
+https://www.w3.org/TR/epub-33/#sec-opf-dcidentifier
 #### getLanguage()
 > **getLanguage**(): `Promise`\<`null` \| `Locale`\>
 Defined in:
-[epub/index.ts:1170](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1170)
+[epub/index.ts:1146](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1146)
 Retrieve the Epub's language as specified in its package document metadata.
@@ -872,17 +854,13 @@ Intl.Locale instance.
 https://www.w3.org/TR/epub-33/#sec-opf-dclanguage
-##### Inherited from
-`BaseEpub.getLanguage`
 #### getManifest()
 > **getManifest**(): `Promise`\<`Record`\<`string`,
 > [`ManifestItem`](#manifestitem)\>\>
 Defined in:
-[epub/index.ts:720](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L720)
+[epub/index.ts:666](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L666)
 Retrieve the manifest for the Epub.
@@ -897,16 +875,12 @@ properties.
 https://www.w3.org/TR/epub-33/#sec-pkg-manifest
-##### Inherited from
-`BaseEpub.getManifest`
 #### getMetadata()
 > **getMetadata**(): `Promise`\<[`EpubMetadata`](#epubmetadata)\>
 Defined in:
-[epub/index.ts:871](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L871)
+[epub/index.ts:817](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L817)
 Retrieve the metadata entries for the Epub.
@@ -924,17 +898,13 @@ as `getTitle()` and `getAuthors()`.
 https://www.w3.org/TR/epub-33/#sec-pkg-metadata
-##### Inherited from
-`BaseEpub.getMetadata`
 #### getPackageVocabularyPrefixes()
 > **getPackageVocabularyPrefixes**(): `Promise`\<`Record`\<`string`,
 > `string`\>\>
 Defined in:
-[epub/index.ts:1346](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1346)
+[epub/index.ts:1322](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1322)
 Return the set of custom vocabulary prefixes set on this publication's root
 package element.
@@ -949,16 +919,12 @@ Returns a map from prefix to URI
 https://www.w3.org/TR/epub-33/#sec-prefix-attr
-##### Inherited from
-`BaseEpub.getPackageVocabularyPrefixes`
 #### getPublicationDate()
 > **getPublicationDate**(): `Promise`\<`null` \| `Date`\>
 Defined in:
-[epub/index.ts:991](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L991)
+[epub/index.ts:967](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L967)
 Retrieve the publication date from the dc:date element in the EPUB metadata as a
 Date object.
@@ -973,16 +939,12 @@ If there is no dc:date element, returns null.
 https://www.w3.org/TR/epub-33/#sec-opf-dcdate
-##### Inherited from
-`BaseEpub.getPublicationDate`
 #### getSpineItems()
 > **getSpineItems**(): `Promise`\<[`ManifestItem`](#manifestitem)[]\>
 Defined in:
-[epub/index.ts:1895](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1895)
+[epub/index.ts:1871](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1871)
 Retrieve the manifest items that make up the Epub's spine.
@@ -997,16 +959,12 @@ to users by default.
 https://www.w3.org/TR/epub-33/#sec-spine-elem
-##### Inherited from
-`BaseEpub.getSpineItems`
 #### getSubjects()
 > **getSubjects**(): `Promise`\<(`string` \| [`DcSubject`](#dcsubject))[]\>
 Defined in:
-[epub/index.ts:1125](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1125)
+[epub/index.ts:1101](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1101)
 Retrieve the list of subjects for this EPUB.
@@ -1022,16 +980,12 @@ authority, and term.
 https://www.w3.org/TR/epub-33/#sec-opf-dcsubject
-##### Inherited from
-`BaseEpub.getSubjects`
 #### getSubtitle()
 > **getSubtitle**(): `Promise`\<`null` \| `string`\>
 Defined in:
-[epub/index.ts:1236](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1236)
+[epub/index.ts:1212](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1212)
 Retrieve the subtitle of the Epub, if it exists.
@@ -1043,16 +997,12 @@ Retrieve the subtitle of the Epub, if it exists.
 https://www.w3.org/TR/epub-33/#sec-opf-dctitle
-##### Inherited from
-`BaseEpub.getSubtitle`
 #### getTitle()
 > **getTitle**(`expanded`): `Promise`\<`null` \| `string`\>
 Defined in:
-[epub/index.ts:1212](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1212)
+[epub/index.ts:1188](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1188)
 Retrieve the title of the Epub.
@@ -1070,16 +1020,12 @@ Retrieve the title of the Epub.
 https://www.w3.org/TR/epub-33/#sec-opf-dctitle
-##### Inherited from
-`BaseEpub.getTitle`
 #### getTitles()
 > **getTitles**(): `Promise`\<`object`[]\>
 Defined in:
-[epub/index.ts:1248](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1248)
+[epub/index.ts:1224](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1224)
 Retrieve all title entries of the Epub.
@@ -1091,16 +1037,12 @@ Retrieve all title entries of the Epub.
 https://www.w3.org/TR/epub-33/#sec-opf-dctitle
-##### Inherited from
-`BaseEpub.getTitles`
 #### getType()
 > **getType**(): `Promise`\<`null` \| [`MetadataEntry`](#metadataentry)\>
 Defined in:
-[epub/index.ts:1038](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1038)
+[epub/index.ts:1014](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1014)
 Retrieve the publication type from the dc:type element in the EPUB metadata.
@@ -1114,10 +1056,6 @@ If there is no dc:type element, returns null.
 https://www.w3.org/TR/epub-33/#sec-opf-dctype
-##### Inherited from
-`BaseEpub.getType`
 #### readItemContents()
 ##### Call Signature
@@ -1125,7 +1063,7 @@ https://www.w3.org/TR/epub-33/#sec-opf-dctype
 > **readItemContents**(`id`): `Promise`\<`Uint8Array`\<`ArrayBufferLike`\>\>
 Defined in:
-[epub/index.ts:1991](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1991)
+[epub/index.ts:1963](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1963)
 Retrieve the contents of a manifest item, given its id.
@@ -1143,16 +1081,12 @@ Retrieve the contents of a manifest item, given its id.
 https://www.w3.org/TR/epub-33/#sec-contentdocs
-###### Inherited from
-`BaseEpub.readItemContents`
 ##### Call Signature
 > **readItemContents**(`id`, `encoding`): `Promise`\<`string`\>
 Defined in:
-[epub/index.ts:1992](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1992)
+[epub/index.ts:1964](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1964)
 Retrieve the contents of a manifest item, given its id.
@@ -1171,10 +1105,6 @@ Retrieve the contents of a manifest item, given its id.
 https://www.w3.org/TR/epub-33/#sec-contentdocs
-###### Inherited from
-`BaseEpub.readItemContents`
 #### readXhtmlItemContents()
 ##### Call Signature
@@ -1182,7 +1112,7 @@ https://www.w3.org/TR/epub-33/#sec-contentdocs
 > **readXhtmlItemContents**(`id`, `as?`): `Promise`\<[`ParsedXml`](#parsedxml)\>
 Defined in:
-[epub/index.ts:2052](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2052)
+[epub/index.ts:2024](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2024)
 Retrieves the contents of an XHTML item, given its manifest id.
@@ -1201,16 +1131,12 @@ Retrieves the contents of an XHTML item, given its manifest id.
 https://www.w3.org/TR/epub-33/#sec-xhtml
-###### Inherited from
-`BaseEpub.readXhtmlItemContents`
 ##### Call Signature
 > **readXhtmlItemContents**(`id`, `as`): `Promise`\<`string`\>
 Defined in:
-[epub/index.ts:2053](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2053)
+[epub/index.ts:2025](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2025)
 Retrieves the contents of an XHTML item, given its manifest id.
@@ -1229,16 +1155,12 @@ Retrieves the contents of an XHTML item, given its manifest id.
 https://www.w3.org/TR/epub-33/#sec-xhtml
-###### Inherited from
-`BaseEpub.readXhtmlItemContents`
 #### removeCollection()
 > **removeCollection**(`index`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1587](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1587)
+[epub/index.ts:1563](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1563)
 Remove a collection from the EPUB metadata.
@@ -1255,16 +1177,12 @@ returned by `epub.getCollections()`.
 `Promise`\<`void`\>
-##### Inherited from
-`BaseEpub.removeCollection`
 #### removeContributor()
 > **removeContributor**(`index`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1844](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1844)
+[epub/index.ts:1820](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1820)
 Remove a contributor from the EPUB metadata.
@@ -1287,16 +1205,12 @@ This is a convenience method for `epub.removeCreator(index, 'contributor')`.
 https://www.w3.org/TR/epub-33/#sec-opf-dccreator
-##### Inherited from
-`BaseEpub.removeContributor`
 #### removeCreator()
 > **removeCreator**(`index`, `type`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1792](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1792)
+[epub/index.ts:1768](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1768)
 Remove a creator from the EPUB metadata.
@@ -1318,16 +1232,12 @@ returned by `epub.getCreators()`.
 https://www.w3.org/TR/epub-33/#sec-opf-dccreator
-##### Inherited from
-`BaseEpub.removeCreator`
 #### removeManifestItem()
 > **removeManifestItem**(`id`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:2153](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2153)
+[epub/index.ts:2120](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2120)
 ##### Parameters
@@ -1339,16 +1249,12 @@ Defined in:
 `Promise`\<`void`\>
-##### Inherited from
-`BaseEpub.removeManifestItem`
 #### removeMetadata()
 > **removeMetadata**(`predicate`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:2399](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2399)
+[epub/index.ts:2369](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2369)
 Remove one or more metadata entries.
@@ -1369,16 +1275,12 @@ all metadata entries that match the predicate will be removed.
 https://www.w3.org/TR/epub-33/#sec-pkg-metadata
-##### Inherited from
-`BaseEpub.removeMetadata`
 #### removeSpineItem()
 > **removeSpineItem**(`index`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1950](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1950)
+[epub/index.ts:1926](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1926)
 Remove the spine item at the specified index.
@@ -1396,16 +1298,12 @@ Remove the spine item at the specified index.
 https://www.w3.org/TR/epub-33/#sec-spine-elem
-##### Inherited from
-`BaseEpub.removeSpineItem`
 #### removeSubject()
 > **removeSubject**(`index`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1088](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1088)
+[epub/index.ts:1064](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1064)
 Remove a subject from the EPUB metadata.
@@ -1426,16 +1324,12 @@ returned by `epub.getSubjects()`.
 https://www.w3.org/TR/epub-33/#sec-opf-dccreator
-##### Inherited from
-`BaseEpub.removeSubject`
 #### replaceMetadata()
 > **replaceMetadata**(`predicate`, `entry`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:2354](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2354)
+[epub/index.ts:2324](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2324)
 Replace a metadata entry with a new one.
@@ -1457,16 +1351,28 @@ first metadata entry that matches the predicate will be replaced.
 https://www.w3.org/TR/epub-33/#sec-pkg-metadata
-##### Inherited from
+#### saveAndClose()
-`BaseEpub.replaceMetadata`
+> **saveAndClose**(): `Promise`\<`void`\>
+Defined in:
+[epub/index.ts:2411](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2411)
+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.
+##### Returns
+`Promise`\<`void`\>
 #### setCoverImage()
 > **setCoverImage**(`href`, `data`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:968](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L968)
+[epub/index.ts:944](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L944)
 Set the cover image for the EPUB.
@@ -1484,16 +1390,12 @@ then writes the provided image data to the provided href within the publication.
 `Promise`\<`void`\>
-##### Inherited from
-`BaseEpub.setCoverImage`
 #### setDescription()
 > **setDescription**(`description`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1313](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1313)
+[epub/index.ts:1289](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1289)
 Update the Epub's description metadata entry.
@@ -1511,16 +1413,38 @@ encoded as HTML entities.
 `Promise`\<`void`\>
-##### Inherited from
+#### setIdentifier()
+> **setIdentifier**(`identifier`): `Promise`\<`void`\>
+Defined in:
+[epub/index.ts:859](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L859)
+Set the dc:identifier metadata element with the provided string.
+Updates the existing dc:identifier element if one exists. Otherwise creates a
+new element
+##### Parameters
+| Parameter    | Type     |
+| ------------ | -------- |
+| `identifier` | `string` |
+##### Returns
+`Promise`\<`void`\>
+##### Link
-`BaseEpub.setDescription`
+https://www.w3.org/TR/epub-33/#sec-opf-dcidentifier
 #### setLanguage()
 > **setLanguage**(`locale`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1195](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1195)
+[epub/index.ts:1171](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1171)
 Update the Epub's language metadata entry.
@@ -1541,16 +1465,12 @@ element
 https://www.w3.org/TR/epub-33/#sec-opf-dclanguage
-##### Inherited from
-`BaseEpub.setLanguage`
 #### setPackageVocabularyPrefix()
 > **setPackageVocabularyPrefix**(`prefix`, `uri`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1364](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1364)
+[epub/index.ts:1340](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1340)
 Set a custom vocabulary prefix on the root package element.
@@ -1569,16 +1489,12 @@ Set a custom vocabulary prefix on the root package element.
 https://www.w3.org/TR/epub-33/#sec-prefix-attr
-##### Inherited from
-`BaseEpub.setPackageVocabularyPrefix`
 #### setPublicationDate()
 > **setPublicationDate**(`date`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1006](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1006)
+[epub/index.ts:982](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L982)
 Set the dc:date metadata element with the provided date.
@@ -1599,16 +1515,12 @@ element
 https://www.w3.org/TR/epub-33/#sec-opf-dcdate
-##### Inherited from
-`BaseEpub.setPublicationDate`
 #### setTitle()
 > **setTitle**(`title`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1388](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1388)
+[epub/index.ts:1364](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1364)
 Set the title of the Epub.
@@ -1631,16 +1543,12 @@ To set specific titles and their types, use epub.setTitles().
 https://www.w3.org/TR/epub-33/#sec-opf-dctitle
-##### Inherited from
-`BaseEpub.setTitle`
 #### setTitles()
 > **setTitles**(`entries`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1416](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1416)
+[epub/index.ts:1392](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1392)
 ##### Parameters
@@ -1652,16 +1560,12 @@ Defined in:
 `Promise`\<`void`\>
-##### Inherited from
-`BaseEpub.setTitles`
 #### setType()
 > **setType**(`type`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:1022](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L1022)
+[epub/index.ts:998](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L998)
 Set the dc:type metadata element.
@@ -1682,16 +1586,12 @@ element.
 https://www.w3.org/TR/epub-33/#sec-opf-dctype
-##### Inherited from
-`BaseEpub.setType`
 #### updateManifestItem()
 > **updateManifestItem**(`id`, `newItem`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:2266](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2266)
+[epub/index.ts:2236](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2236)
 Update the manifest entry for an existing item.
@@ -1713,10 +1613,6 @@ To update the contents of an entry, use `epub.writeItemContents()` or
 https://www.w3.org/TR/epub-33/#sec-pkg-manifest
-##### Inherited from
-`BaseEpub.updateManifestItem`
 #### writeItemContents()
 ##### Call Signature
@@ -1724,7 +1620,7 @@ https://www.w3.org/TR/epub-33/#sec-pkg-manifest
 > **writeItemContents**(`id`, `contents`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:2105](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2105)
+[epub/index.ts:2072](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2072)
 Write new contents for an existing manifest item, specified by its id.
@@ -1746,16 +1642,12 @@ The id must reference an existing manifest item. If creating a new item, use
 https://www.w3.org/TR/epub-33/#sec-contentdocs
-###### Inherited from
-`BaseEpub.writeItemContents`
 ##### Call Signature
 > **writeItemContents**(`id`, `contents`, `encoding`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:2106](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2106)
+[epub/index.ts:2073](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2073)
 Write new contents for an existing manifest item, specified by its id.
@@ -1778,64 +1670,12 @@ The id must reference an existing manifest item. If creating a new item, use
 https://www.w3.org/TR/epub-33/#sec-contentdocs
-###### Inherited from
-`BaseEpub.writeItemContents`
-#### writeToArray()
-> **writeToArray**(): `Promise`\<`Uint8Array`\<`ArrayBufferLike`\>\>
-Defined in:
-[epub/index.ts:2436](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2436)
-Write the current contents of the Epub to a new Uint8Array.
-This _does not_ close the Epub. It can continue to be modified after it has been
-written to disk. Use `epub.close()` to close the Epub.
-When this method is called, the "dcterms:modified" meta tag is automatically
-updated to the current UTC timestamp.
-##### Returns
-`Promise`\<`Uint8Array`\<`ArrayBufferLike`\>\>
-##### Inherited from
-`BaseEpub.writeToArray`
-#### writeToFile()
-> **writeToFile**(`path`): `Promise`\<`void`\>
-Defined in:
-[epub/node.ts:56](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/node.ts#L56)
-Write the current contents of the Epub to a new EPUB archive on disk.
-This _does not_ close the Epub. It can continue to be modified after it has been
-written to disk. Use `epub.close()` to close the Epub.
-When this method is called, the "dcterms:modified" meta tag is automatically
-updated to the current UTC timestamp.
-##### Parameters
-| Parameter | Type     | Description                                                                                                                     |
-| --------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| `path`    | `string` | The file path to write the new archive to. The parent directory does not need te exist -- the path will be recursively created. |
-##### Returns
-`Promise`\<`void`\>
 #### writeXhtmlItemContents()
 > **writeXhtmlItemContents**(`id`, `contents`): `Promise`\<`void`\>
 Defined in:
-[epub/index.ts:2145](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2145)
+[epub/index.ts:2112](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L2112)
 Write new contents for an existing XHTML item, specified by its id.
@@ -1857,16 +1697,12 @@ The id must reference an existing manifest item. If creating a new item, use
 https://www.w3.org/TR/epub-33/#sec-xhtml
-##### Inherited from
-`BaseEpub.writeXhtmlItemContents`
 #### addLinkToXhtmlHead()
 > `static` **addLinkToXhtmlHead**(`xml`, `link`): `void`
 Defined in:
-[epub/index.ts:271](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L271)
+[epub/index.ts:234](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L234)
 Given an XML structure representing a complete XHTML document, add a `link`
 element to the `head` of the document.
@@ -1887,40 +1723,35 @@ This method modifies the provided XML structure.
 `void`
-##### Inherited from
-`BaseEpub.addLinkToXhtmlHead`
 #### create()
-> `static` **create**(...`args`): `Promise`\<[`Epub`](#epub)\>
+> `static` **create**(`path`, `__namedParameters`, `additionalMetadata`):
+> `Promise`\<[`Epub`](#epub)\>
 Defined in:
-[epub/node.ts:25](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/node.ts#L25)
+[epub/index.ts:389](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L389)
 Construct an Epub instance, optionally beginning with the provided metadata.
 ##### Parameters
-| Parameter | Type                                                             |
-| --------- | ---------------------------------------------------------------- |
-| ...`args` | \[[`DublinCore`](#dublincore), [`EpubMetadata`](#epubmetadata)\] |
+| Parameter            | Type                            | Default value | Description                             |
+| -------------------- | ------------------------------- | ------------- | --------------------------------------- |
+| `path`               | `string`                        | `undefined`   | -                                       |
+| `__namedParameters`  | [`DublinCore`](#dublincore)     | `undefined`   | -                                       |
+| `additionalMetadata` | [`EpubMetadata`](#epubmetadata) | `[]`          | An array of additional metadata entries |
 ##### Returns
 `Promise`\<[`Epub`](#epub)\>
-##### Overrides
-`BaseEpub.create`
 #### createXmlElement()
 > `static` **createXmlElement**\<`Name`\>(`name`, `properties`, `children`):
 > [`XmlElement`](#xmlelement)\<`Name`\>
 Defined in:
-[epub/index.ts:306](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L306)
+[epub/index.ts:269](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L269)
 ##### Type Parameters
@@ -1940,16 +1771,12 @@ Defined in:
 [`XmlElement`](#xmlelement)\<`Name`\>
-##### Inherited from
-`BaseEpub.createXmlElement`
 #### createXmlTextNode()
 > `static` **createXmlTextNode**(`text`): [`XmlTextNode`](#xmltextnode)
 Defined in:
-[epub/index.ts:319](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L319)
+[epub/index.ts:282](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L282)
 ##### Parameters
@@ -1961,17 +1788,13 @@ Defined in:
 [`XmlTextNode`](#xmltextnode)
-##### Inherited from
-`BaseEpub.createXmlTextNode`
 #### findXmlChildByName()
 > `static` **findXmlChildByName**\<`Name`\>(`name`, `xml`, `filter?`):
 > `undefined` \| [`XmlElement`](#xmlelement)\<`Name`\>
 Defined in:
-[epub/index.ts:380](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L380)
+[epub/index.ts:343](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L343)
 Given an XML structure, find the first child matching the provided name and
 optional filter.
@@ -1994,16 +1817,12 @@ optional filter.
 `undefined` \| [`XmlElement`](#xmlelement)\<`Name`\>
-##### Inherited from
-`BaseEpub.findXmlChildByName`
 #### formatSmilDuration()
 > `static` **formatSmilDuration**(`duration`): `string`
 Defined in:
-[epub/index.ts:254](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L254)
+[epub/index.ts:217](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L217)
 Format a duration, provided as a number of seconds, as a SMIL clock value, to be
 used for Media Overlays.
@@ -2022,39 +1841,31 @@ used for Media Overlays.
 https://www.w3.org/TR/epub-33/#sec-duration
-##### Inherited from
-`BaseEpub.formatSmilDuration`
 #### from()
-> `static` **from**(...`args`): `Promise`\<[`Epub`](#epub)\>
+> `static` **from**(`pathOrData`): `Promise`\<[`Epub`](#epub)\>
 Defined in:
-[epub/node.ts:31](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/node.ts#L31)
+[epub/index.ts:480](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L480)
 Construct an Epub instance by reading an existing EPUB publication.
 ##### Parameters
-| Parameter | Type                                              |
-| --------- | ------------------------------------------------- |
-| ...`args` | \[`string` \| `Uint8Array`\<`ArrayBufferLike`\>\] |
+| Parameter    | Type                                          | Description                                                                                                                           |
+| ------------ | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| `pathOrData` | `string` \| `Uint8Array`\<`ArrayBufferLike`\> | Must be either a string representing the path to an EPUB file on disk, or a Uint8Array representing the data of the EPUB publication. |
 ##### Returns
 `Promise`\<[`Epub`](#epub)\>
-##### Overrides
-`BaseEpub.from`
 #### getXhtmlBody()
 > `static` **getXhtmlBody**(`xml`): [`ParsedXml`](#parsedxml)
 Defined in:
-[epub/index.ts:296](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L296)
+[epub/index.ts:259](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L259)
 Given an XML structure representing a complete XHTML document, return the
 sub-structure representing the children of the document's body element.
@@ -2069,16 +1880,12 @@ sub-structure representing the children of the document's body element.
 [`ParsedXml`](#parsedxml)
-##### Inherited from
-`BaseEpub.getXhtmlBody`
 #### getXhtmlTextContent()
 > `static` **getXhtmlTextContent**(`xml`): `string`
 Defined in:
-[epub/index.ts:328](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L328)
+[epub/index.ts:291](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L291)
 Given an XML structure representing a complete XHTML document, return a string
 representing the concatenation of all text nodes in the document.
@@ -2093,16 +1900,12 @@ representing the concatenation of all text nodes in the document.
 `string`
-##### Inherited from
-`BaseEpub.getXhtmlTextContent`
 #### getXmlChildren()
 > `static` **getXmlChildren**\<`Name`\>(`element`): [`ParsedXml`](#parsedxml)
 Defined in:
-[epub/index.ts:360](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L360)
+[epub/index.ts:323](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L323)
 Given an XMLElement, return a list of its children
@@ -2122,16 +1925,12 @@ Given an XMLElement, return a list of its children
 [`ParsedXml`](#parsedxml)
-##### Inherited from
-`BaseEpub.getXmlChildren`
 #### getXmlElementName()
 > `static` **getXmlElementName**\<`Name`\>(`element`): `Name`
 Defined in:
-[epub/index.ts:345](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L345)
+[epub/index.ts:308](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L308)
 Given an XMLElement, return its tag name.
@@ -2151,16 +1950,12 @@ Given an XMLElement, return its tag name.
 `Name`
-##### Inherited from
-`BaseEpub.getXmlElementName`
 #### isXmlTextNode()
 > `static` **isXmlTextNode**(`node`): `node is XmlTextNode`
 Defined in:
-[epub/index.ts:393](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L393)
+[epub/index.ts:356](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L356)
 Given an XMLNode, determine whether it represents a text node or an XML element.
@@ -2174,16 +1969,12 @@ Given an XMLNode, determine whether it represents a text node or an XML element.
 `node is XmlTextNode`
-##### Inherited from
-`BaseEpub.isXmlTextNode`
 #### replaceXmlChildren()
 > `static` **replaceXmlChildren**\<`Name`\>(`element`, `children`): `void`
 Defined in:
-[epub/index.ts:368](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L368)
+[epub/index.ts:331](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L331)
 ##### Type Parameters
@@ -2202,16 +1993,12 @@ Defined in:
 `void`
-##### Inherited from
-`BaseEpub.replaceXmlChildren`
 ---
 ## AlternateScript
 Defined in:
-[epub/index.ts:142](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L142)
+[epub/index.ts:105](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L105)
 ### Properties
@@ -2220,21 +2007,21 @@ Defined in:
 > **locale**: `Locale`
 Defined in:
-[epub/index.ts:144](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L144)
+[epub/index.ts:107](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L107)
 #### name
 > **name**: `string`
 Defined in:
-[epub/index.ts:143](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L143)
+[epub/index.ts:106](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L106)
 ---
 ## Collection
 Defined in:
-[epub/index.ts:166](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L166)
+[epub/index.ts:129](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L129)
 ### Properties
@@ -2243,28 +2030,28 @@ Defined in:
 > **name**: `string`
 Defined in:
-[epub/index.ts:167](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L167)
+[epub/index.ts:130](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L130)
 #### position?
 > `optional` **position**: `string`
 Defined in:
-[epub/index.ts:169](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L169)
+[epub/index.ts:132](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L132)
 #### type?
 > `optional` **type**: `string`
 Defined in:
-[epub/index.ts:168](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L168)
+[epub/index.ts:131](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L131)
 ---
 ## DcCreator
 Defined in:
-[epub/index.ts:147](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L147)
+[epub/index.ts:110](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L110)
 ### Properties
@@ -2273,42 +2060,42 @@ Defined in:
 > `optional` **alternateScripts**: [`AlternateScript`](#alternatescript)[]
 Defined in:
-[epub/index.ts:152](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L152)
+[epub/index.ts:115](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L115)
 #### fileAs?
 > `optional` **fileAs**: `string`
 Defined in:
-[epub/index.ts:151](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L151)
+[epub/index.ts:114](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L114)
 #### name
 > **name**: `string`
 Defined in:
-[epub/index.ts:148](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L148)
+[epub/index.ts:111](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L111)
 #### role?
 > `optional` **role**: `string`
 Defined in:
-[epub/index.ts:149](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L149)
+[epub/index.ts:112](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L112)
 #### roleScheme?
 > `optional` **roleScheme**: `string`
 Defined in:
-[epub/index.ts:150](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L150)
+[epub/index.ts:113](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L113)
 ---
 ## DcSubject
 Defined in:
-[epub/index.ts:136](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L136)
+[epub/index.ts:99](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L99)
 ### Properties
@@ -2317,28 +2104,28 @@ Defined in:
 > **authority**: `string`
 Defined in:
-[epub/index.ts:138](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L138)
+[epub/index.ts:101](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L101)
 #### term
 > **term**: `string`
 Defined in:
-[epub/index.ts:139](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L139)
+[epub/index.ts:102](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L102)
 #### value
 > **value**: `string`
 Defined in:
-[epub/index.ts:137](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L137)
+[epub/index.ts:100](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L100)
 ---
 ## DublinCore
 Defined in:
-[epub/index.ts:155](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L155)
+[epub/index.ts:118](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L118)
 ### Properties
@@ -2347,56 +2134,56 @@ Defined in:
 > `optional` **contributors**: [`DcCreator`](#dccreator)[]
 Defined in:
-[epub/index.ts:162](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L162)
+[epub/index.ts:125](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L125)
 #### creators?
 > `optional` **creators**: [`DcCreator`](#dccreator)[]
 Defined in:
-[epub/index.ts:161](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L161)
+[epub/index.ts:124](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L124)
 #### date?
 > `optional` **date**: `Date`
 Defined in:
-[epub/index.ts:159](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L159)
+[epub/index.ts:122](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L122)
 #### identifier
 > **identifier**: `string`
 Defined in:
-[epub/index.ts:158](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L158)
+[epub/index.ts:121](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L121)
 #### language
 > **language**: `Locale`
 Defined in:
-[epub/index.ts:157](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L157)
+[epub/index.ts:120](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L120)
 #### subjects?
 > `optional` **subjects**: (`string` \| [`DcSubject`](#dcsubject))[]
 Defined in:
-[epub/index.ts:160](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L160)
+[epub/index.ts:123](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L123)
 #### title
 > **title**: `string`
 Defined in:
-[epub/index.ts:156](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L156)
+[epub/index.ts:119](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L119)
 #### type?
 > `optional` **type**: `string`
 Defined in:
-[epub/index.ts:163](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L163)
+[epub/index.ts:126](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L126)
 ---
@@ -2406,7 +2193,7 @@ Defined in:
 > \`$\{Letter \| Uppercase\<Letter\> \| QuestionMark\}$\{string\}\`
 Defined in:
-[epub/index.ts:63](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L63)
+[epub/index.ts:60](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L60)
 A valid name for an XML element (must start with a letter)
@@ -2417,7 +2204,7 @@ A valid name for an XML element (must start with a letter)
 > **EpubMetadata** = [`MetadataEntry`](#metadataentry)[]
 Defined in:
-[epub/index.ts:134](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L134)
+[epub/index.ts:97](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L97)
 ---
@@ -2426,7 +2213,7 @@ Defined in:
 > **ManifestItem** = `object`
 Defined in:
-[epub/index.ts:84](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L84)
+[epub/index.ts:81](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L81)
 ### Properties
@@ -2435,42 +2222,42 @@ Defined in:
 > `optional` **fallback**: `string`
 Defined in:
-[epub/index.ts:88](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L88)
+[epub/index.ts:85](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L85)
 #### href
 > **href**: `string`
 Defined in:
-[epub/index.ts:86](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L86)
+[epub/index.ts:83](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L83)
 #### id
 > **id**: `string`
 Defined in:
-[epub/index.ts:85](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L85)
+[epub/index.ts:82](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L82)
 #### mediaOverlay?
 > `optional` **mediaOverlay**: `string`
 Defined in:
-[epub/index.ts:89](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L89)
+[epub/index.ts:86](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L86)
 #### mediaType?
 > `optional` **mediaType**: `string`
 Defined in:
-[epub/index.ts:87](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L87)
+[epub/index.ts:84](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L84)
 #### properties?
 > `optional` **properties**: `string`[]
 Defined in:
-[epub/index.ts:90](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L90)
+[epub/index.ts:87](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L87)
 ---
@@ -2479,7 +2266,7 @@ Defined in:
 > **MetadataEntry** = `object`
 Defined in:
-[epub/index.ts:127](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L127)
+[epub/index.ts:90](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L90)
 ### Properties
@@ -2488,28 +2275,38 @@ Defined in:
 > `optional` **id**: `string`
 Defined in:
-[epub/index.ts:128](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L128)
+[epub/index.ts:91](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L91)
 #### properties
 > **properties**: `Record`\<`string`, `string`\>
 Defined in:
-[epub/index.ts:130](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L130)
+[epub/index.ts:93](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L93)
 #### type
 > **type**: [`ElementName`](#elementname)
 Defined in:
-[epub/index.ts:129](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L129)
+[epub/index.ts:92](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L92)
 #### value
 > **value**: `string` \| `undefined`
 Defined in:
-[epub/index.ts:131](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L131)
+[epub/index.ts:94](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L94)
+---
+## PackageElement
+> **PackageElement** = [`XmlElement`](#xmlelement)\<`"package"`\> \|
+> [`XmlElement`](#xmlelement)\<`"opf:package"`\>
+Defined in:
+[epub/index.ts:135](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L135)
 ---
@@ -2518,7 +2315,7 @@ Defined in:
 > **ParsedXml** = [`XmlNode`](#xmlnode)[]
 Defined in:
-[epub/index.ts:82](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L82)
+[epub/index.ts:79](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L79)
 An XML structure
@@ -2529,11 +2326,11 @@ An XML structure
 > **XmlElement**\<`Name`\> = `object` & `{ [key in Name]: ParsedXml }`
 Defined in:
-[epub/index.ts:69](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L69)
+[epub/index.ts:66](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L66)
 An XML element
-### Type declaration
+### Type Declaration
 #### :@?
@@ -2552,7 +2349,7 @@ An XML element
 > **XmlNode** = [`XmlElement`](#xmlelement) \| [`XmlTextNode`](#xmltextnode)
 Defined in:
-[epub/index.ts:79](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L79)
+[epub/index.ts:76](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L76)
 A valid XML node. May be either an element or a text node.
@@ -2563,7 +2360,7 @@ A valid XML node. May be either an element or a text node.
 > **XmlTextNode** = `object`
 Defined in:
-[epub/index.ts:76](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L76)
+[epub/index.ts:73](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L73)
 A text node in an XML document
@@ -2574,4 +2371,4 @@ A text node in an XML document
 > **#text**: `string`
 Defined in:
-[epub/index.ts:76](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L76)
+[epub/index.ts:73](https://gitlab.com/storyteller-platform/storyteller/-/blob/main/epub/index.ts#L73)