bookish-press 0.4.0 → 0.4.3

package/util/scrollToEyeLevel.js

@@ -1,5 +1,10 @@
 let scrollToEyeLevel = (el) => {
     // Top of the target minus a third of window height.
-    window.scrollTo({ top: el.getBoundingClientRect().top + window.scrollY - window.innerHeight / 3, behavior: 'smooth' });
+    window.scrollTo({
+        top: el.getBoundingClientRect().top +
+            window.scrollY -
+            window.innerHeight / 3,
+        behavior: 'smooth',
+    });
 };
 export default scrollToEyeLevel;

package/components/chapter/renderPosition.d.ts

@@ -1,3 +0,0 @@
-import type Position from "../../models/chapter/Position";
-declare const renderPosition: (position: Position) => "" | "bookish-marginal-left-inset" | "bookish-marginal-right-inset";
-export default renderPosition;

package/components/chapter/renderPosition.js

@@ -1,4 +0,0 @@
-const renderPosition = (position) => position === "<" ? "bookish-marginal-left-inset" :
-    position === ">" ? "bookish-marginal-right-inset" :
-        "";
-export default renderPosition;

package/components/editor/ToolbarIcon.svelte

@@ -1,22 +0,0 @@
-<script>// If ends with .svg, its mapped to an asset in /svg/, otherwise just the text is displayed.
-export let name;
-</script>
-
-<span>
-    {#if name.endsWith(".svg")}
-        <img alt={`${name.replace(".svg", "")} icon`} src="/svg/{name}"/>
-    {:else}
-        {name}
-    {/if}
-</span>
-
-<style>
-    span {
-        margin-right: var(--bookish-app-chrome-padding);
-    }
-
-    img {
-        width: 1em;
-        height: 1em;
-    }
-</style>

package/components/editor/ToolbarIcon.svelte.d.ts

@@ -1,16 +0,0 @@
-import { SvelteComponentTyped } from "svelte";
-declare const __propDef: {
-    props: {
-        name: string;
-    };
-    events: {
-        [evt: string]: CustomEvent<any>;
-    };
-    slots: {};
-};
-export declare type ToolbarIconProps = typeof __propDef.props;
-export declare type ToolbarIconEvents = typeof __propDef.events;
-export declare type ToolbarIconSlots = typeof __propDef.slots;
-export default class ToolbarIcon extends SvelteComponentTyped<ToolbarIconProps, ToolbarIconEvents, ToolbarIconSlots> {
-}
-export {};

package/components/page/Alert.svelte

@@ -1,11 +0,0 @@
-<section><slot></slot></section>
-
-<style>
-    section {
-        margin-top: 1em;
-        margin-bottom: 1em;
-        background-color: var(--bookish-app-error-background);
-        color: var(--bookish-app-error-color);
-        padding: var(--bookish-app-chrome-padding);
-    }
-</style>

package/components/page/Alert.svelte.d.ts

@@ -1,23 +0,0 @@
-/** @typedef {typeof __propDef.props}  AlertProps */
-/** @typedef {typeof __propDef.events}  AlertEvents */
-/** @typedef {typeof __propDef.slots}  AlertSlots */
-export default class Alert extends SvelteComponentTyped<{}, {
-    [evt: string]: CustomEvent<any>;
-}, {
-    default: {};
-}> {
-}
-export type AlertProps = typeof __propDef.props;
-export type AlertEvents = typeof __propDef.events;
-export type AlertSlots = typeof __propDef.slots;
-import { SvelteComponentTyped } from "svelte";
-declare const __propDef: {
-    props: {};
-    events: {
-        [evt: string]: CustomEvent<any>;
-    };
-    slots: {
-        default: {};
-    };
-};
-export {};

package/components/page/Revisions.svelte

@@ -1,124 +0,0 @@
-<script>import Parser from "../../models/chapter/Parser";
-import { addDraftInFirestore, publishDraftInFirestore } from "../../models/Firestore";
-import Format from "../chapter/Format.svelte";
-import BookishEditor from "../editor/BookishEditor.svelte";
-import Switch from "../editor/Switch.svelte";
-import Instructions from "./Instructions.svelte";
-import Note from "../editor/Note.svelte";
-import { getEdition, isEditable } from "./Contexts";
-let edition = getEdition();
-let editable = isEditable();
-$: book = $edition.getBook();
-// Legacy revisions
-$: editionRevisions = $edition.getRevisions();
-// Book revisions
-$: bookRevisions = book?.getRevisions();
-// Copy the current draft to create a new draft.
-function handlePublish(index, published) {
-    if (book === undefined)
-        return;
-    publishDraftInFirestore(book, index, published);
-}
-function handleDraftEdition() {
-    if (book === undefined)
-        return;
-    addDraftInFirestore(book);
-}
-</script>
-
-{#if editionRevisions.length > 0 }
-    <h2 class="bookish-header" id="revisions">Revisions</h2>
-    <ul>
-        {#each editionRevisions as revision }
-            <li><em>{revision[0]}</em>. <Format node={Parser.parseFormat($edition, revision[1])} /></li>
-        {/each}
-    </ul>
-{/if}
-{#if book && bookRevisions}
-    <h2 class="bookish-header" id="revisions">Editions {#if editable}<button on:click={handleDraftEdition}>+</button>{/if}</h2>
-    <Instructions>
-        Each book has one or more editions, allowing you to track revisions and ensure previous versions remain available.
-        When you're ready to revise, make a new edition, then publish it when you're done.
-        The edition with a * is the default edition readers will see, unless they explicitly choose to view a previous edition.
-    </Instructions>
-    <table class="bookish-table">
-        <colgroup>
-            <col width="5%" />
-            <col width="5%" />
-            <col width="50%" />
-            <col width="35%" />
-        </colgroup>
-        <tbody>
-            {#each bookRevisions as revision, index}
-                {@const editionNumber = bookRevisions === undefined ? -1 : bookRevisions.length - index }
-                {@const viewing = revision.ref.id === $edition.getRef()?.id }
-
-                {#if editable || revision.published}
-                    <tr 
-                        class={`${!revision.published ? "bookish-edition-hidden" : ""} ${viewing ? "bookish-edition-editing": ""} `}
-                    >
-                        <td>
-                            <em>{ editionNumber + (editionNumber === 1 ? "st" : editionNumber === 2 ? "nd" : editionNumber === 3 ? "rd" : "th") }</em> <Note>{(new Date(revision.time).toLocaleDateString("en-us"))}</Note>
-                        </td>
-                        <td>
-                            {#if editable }
-                                {#if viewing }
-                                    Editing
-                                {:else}
-                                    <a href={`/write/${book.ref.id}/${bookRevisions.length - index}`}>Edit</a>
-                                {/if}
-                            {:else}
-                                {#if viewing }
-                                    Viewing
-                                {:else}
-                                    <a href={`/read/${book.ref.id}/${bookRevisions.length - index}`}>View</a>
-                                {/if}
-                            {/if}
-                        </td>
-                        <td>
-                            { #if editable }
-                                <BookishEditor 
-                                    ast={Parser.parseFormat(undefined, revision.summary).withTextIfEmpty()}
-                                    save={ newSummary => book ? book.setEditionChangeSummary(newSummary.toBookdown(), index) : undefined }
-                                    chapter={false}
-                                    component={Format}
-                                    placeholder="Summarize this edition's changes."
-                                /> 
-                            {:else}
-                                {#if revision.summary === ""}
-                                    <em>No summary of changes</em>
-                                {:else}
-                                    { revision.summary }
-                                {/if}
-                            {/if}
-                        </td>
-                        <td style="whitespace: nowrap">
-                            {#if editable}
-                                <Switch
-                                    position=">"
-                                    options={["hidden", "published"]} 
-                                    enabled={revision.published || revision.summary !== ""}
-                                    value={revision.published ? "published" : "hidden"} 
-                                    edit={ published => handlePublish(index, published === "published") }
-                                />
-                                {#if revision === bookRevisions.find(e => e.published)}*{/if}
-                            {/if}
-                        </td>
-                    </tr>
-                {/if}
-            {/each}
-        </tbody>
-    </table>
-{/if}
-
-<style>
-    .bookish-edition-hidden {
-        background: repeating-linear-gradient(
-            45deg,
-            var(--bookish-app-background),
-            var(--bookish-app-background) 10px,
-            var(--bookish-app-chrome-background) 10px,
-            var(--bookish-app-chrome-background) 20px
-        );
-    }
-</style>

package/components/page/Revisions.svelte.d.ts

@@ -1,14 +0,0 @@
-import { SvelteComponentTyped } from "svelte";
-declare const __propDef: {
-    props: {};
-    events: {
-        [evt: string]: CustomEvent<any>;
-    };
-    slots: {};
-};
-export declare type RevisionsProps = typeof __propDef.props;
-export declare type RevisionsEvents = typeof __propDef.events;
-export declare type RevisionsSlots = typeof __propDef.slots;
-export default class Revisions extends SvelteComponentTyped<RevisionsProps, RevisionsEvents, RevisionsSlots> {
-}
-export {};

package/models/BookLoader.d.ts

@@ -1,2 +0,0 @@
-import Edition from './book/Edition';
-export default function loadBookFromURL(url: string): Promise<Edition>;

package/models/BookLoader.js

@@ -1,67 +0,0 @@
-import Ajv from 'ajv';
-import addFormats from 'ajv-formats';
-import Edition from './book/Edition';
-import schema from "../../schemas/book.json";
-// Returns a Promise that, given a URL to 
-//   1) a to a valid "book.json" (see /src/schemas/book.json for a validity spec),
-//   2) a "chapters" folder with .md files corresponding to the chapter IDs in the spec,
-// resolves to a Book object with all of the book data.
-// If any errors are encountered, throws an Error.
-export default async function loadBookFromURL(url) {
-    let specification = undefined;
-    // Fetch the JSON from the given URL
-    return fetch(url + "book.json")
-        // If there's a valid response, get the JSON
-        .then(response => {
-        // If it's a valid status, parse the text as JSON.
-        if (response.status >= 200 && response.status <= 299)
-            return response.json();
-        // Otherwise, throw an error with the request failure.
-        else
-            throw Error(response.statusText);
-    })
-        // If the JSON doesn't parse...
-        .catch(() => {
-        throw Error("The book.json file that we received doesn't appear to be a JSON-formatted document.");
-    })
-        // Validate the specification and then load its chapters...
-        .then((book) => {
-        // Validate the book schema before we get started.
-        const ajv = new Ajv({
-            strictTuples: false
-        });
-        addFormats(ajv);
-        // Did the specification have schema errors?
-        // Initialize the book as null and set the errors.
-        if (!ajv.validate(schema, book)) {
-            throw Error("The book specification has validation errors" +
-                (ajv.errors ?
-                    ": " + ajv.errors.map(error => url + error.instancePath + " " + error.message).join("\n") :
-                    "."));
-        }
-        // Remember the book spec
-        specification = book;
-        // Map all non-forthcoming chapters to a list of fetch promises
-        return Promise.all(specification.chapters.filter((chapter) => !chapter.forthcoming).map((chapter) => fetch(url + "chapters/" + chapter.id + ".md")
-            .then((response) => {
-            // If we got a reasonable response, process the chapter.
-            if (response.ok)
-                return response.text();
-            else
-                throw Error("Unable to load chapter named '" + chapter.id + "'. Make sure the chapter ID and chapter file name match.");
-        })
-            // Set the text field of the chapter object in the specification
-            .then((text) => {
-            chapter.text = text;
-        })
-            // If there's an error, set chapter text to null.
-            .catch(() => {
-            chapter.text = undefined;
-        })));
-    })
-        // After all the chapter loading promises are done, make the book.
-        .then(() => {
-        // Construct a Book object given the spec and chapter text
-        return new Edition(undefined, undefined, specification);
-    });
-}

package/models/Firestore.d.ts

@@ -1,22 +0,0 @@
-import { DocumentReference } from "firebase/firestore";
-import Edition from "./book/Edition";
-import Book from "./book/Book";
-import type Chapter from "./book/Chapter";
-import type { ChapterContent } from "./book/Chapter";
-export declare const loadPublishedBooksFromFirestore: () => Promise<Book[]>;
-export declare const loadUsersBooksFromFirestore: (userID: string) => Promise<Book[] | null>;
-export declare const getBookFromIDOrName: (bookIDOrName: string) => Promise<Book | null>;
-export declare const loadBookFromFirestore: (bookID: string) => Promise<Book | null>;
-export declare const loadEditionFromFirestore: (book: Book, editionID: string) => Promise<Edition>;
-export declare const createBookInFirestore: (userID: string) => Promise<string>;
-export declare const addDraftInFirestore: (book: Book) => Promise<void>;
-export declare const publishDraftInFirestore: (book: Book, index: number, published: boolean) => Promise<void>;
-export declare const updateEditionInFirestore: (edition: Edition) => Promise<void>;
-export declare const deleteEditionInFirestore: (book: Book, index: number) => Promise<void>;
-export declare const updateBookInFirestore: (book: Book) => Promise<void>;
-export declare const addChapterInFirestore: (edition: DocumentReference, chapter: ChapterContent) => Promise<DocumentReference>;
-export declare const removeChapterFromEditionInFirestore: (chapter: Chapter) => Promise<void>;
-export declare const loadChapterTextFromFirestore: (chapter: DocumentReference) => Promise<ChapterContent>;
-export declare const updateChapterTextInFirestore: (edition: DocumentReference, chapter: DocumentReference, text: string) => Promise<void>;
-export declare const subdomainIsAvailable: (subdomain: string, book: Book) => Promise<boolean>;
-export declare const getBookIDFromBookName: (subdomain: string) => Promise<string>;

package/models/Firestore.js

@@ -1,194 +0,0 @@
-import { db } from "./Firebase";
-import { collection, getDocs, getDoc, setDoc, doc, addDoc, query, where, deleteDoc, DocumentReference } from "firebase/firestore";
-import Edition from "./book/Edition";
-import Book from "./book/Book";
-export const loadPublishedBooksFromFirestore = async () => {
-    if (!db)
-        throw Error("Can't retrieve books, not connected to the database.");
-    try {
-        const data = await getDocs(collection(db, "books"));
-        return data.docs.map(doc => new Book(doc.ref, doc.data())).filter(book => book.hasPublishedEdition());
-    }
-    catch {
-        throw Error("Couldn't load books, problem reading from the database.");
-    }
-};
-export const loadUsersBooksFromFirestore = async (userID) => {
-    if (!db)
-        throw Error("Can't retrieve user's books, not connected to Firebase.");
-    try {
-        const books = await getDocs(query(collection(db, "books"), where("uids", "array-contains", userID)));
-        return books.docs.map(doc => new Book(doc.ref, doc.data()));
-    }
-    catch (err) {
-        console.error(err);
-        return null;
-    }
-};
-export const getBookFromIDOrName = async (bookIDOrName) => {
-    const book = await loadBookFromFirestore(bookIDOrName);
-    if (book)
-        return book;
-    const bookID = await getBookIDFromBookName(bookIDOrName);
-    return loadBookFromFirestore(bookID);
-};
-export const loadBookFromFirestore = async (bookID) => {
-    if (!db)
-        return null;
-    const bookRef = doc(db, "books", bookID);
-    const book = await getDoc(bookRef);
-    return !book.exists() ? null : new Book(bookRef, book.data());
-};
-export const loadEditionFromFirestore = async (book, editionID) => {
-    if (!db)
-        throw Error("Can't retrieve edition, not connected to Firebase.");
-    const edition = await getDoc(doc(db, "editions", editionID));
-    if (edition.exists())
-        return new Edition(book, edition.ref, edition.data());
-    else
-        throw Error("" + editionID + " doesn't exist");
-};
-export const createBookInFirestore = async (userID) => {
-    if (!db)
-        throw Error("Can't create book, not connected to Firebase.");
-    // Make a new empty edition with a single chapter.
-    const newEdition = new Edition();
-    // Add the current user to the book
-    newEdition.addUserID(userID);
-    // Add the book to the editions collection
-    const editionRef = await addDoc(collection(db, "editions"), newEdition.toObject());
-    newEdition.setRef(editionRef);
-    // Add a new chapter to the edition and update it in the database.
-    await newEdition.addChapter();
-    await updateEditionInFirestore(newEdition);
-    // Note that we don't create a sub-collection of chapters here.
-    // Firestore creates sub-collections automatically when documents are added.
-    // Create a new book with the draft first edition and the user ID.
-    const newBook = {
-        title: "",
-        authors: [],
-        description: "",
-        cover: null,
-        revisions: [
-            {
-                ref: editionRef,
-                time: Date.now(),
-                summary: "",
-                published: false
-            }
-        ],
-        uids: [userID]
-    };
-    // Create the book
-    const bookRef = await addDoc(collection(db, "books"), newBook);
-    // Return the book id
-    return bookRef.id;
-};
-export const addDraftInFirestore = async (book) => {
-    if (!db)
-        throw Error("Can't publish draft, no Firebase connection.");
-    // Get the latest draft.
-    const latestDraft = await book.getDraftEdition();
-    if (latestDraft === undefined)
-        return;
-    // Create a copy of the existing draft as a new edition
-    const newDraft = await addDoc(collection(db, "editions"), latestDraft.toObject());
-    // Put the new edition in the book.
-    const revisions = book.getRevisions();
-    revisions.unshift({
-        ref: newDraft,
-        time: Date.now(),
-        summary: "",
-        published: false
-    });
-    book.setRevisions(revisions);
-    // Return the revised Book for viewing
-    updateBookInFirestore(book);
-};
-export const publishDraftInFirestore = async (book, index, published) => {
-    if (!db)
-        throw Error("Can't publish draft, no Firebase connection.");
-    // Update the edition's published status.
-    book.setPublished(published, index);
-    // Update the book with the latest published edition's metadata.
-    const draft = await book.getLatestPublishedEdition();
-    if (draft)
-        book.updateMetadataFromEdition(draft);
-    // Return the revised Book for viewing
-    updateBookInFirestore(book);
-};
-export const updateEditionInFirestore = async (edition) => {
-    if (!db)
-        throw Error("Can't update edition, not connected to Firebase.");
-    // Get the object for the edition so we can store it.
-    const spec = edition.toObject();
-    const editionRef = edition.getRef();
-    // Make sure the given edition has a database reference ID
-    if (!editionRef)
-        throw Error("Book given has no ID");
-    // Update the edition's document.
-    await setDoc(doc(db, "editions", editionRef.id), spec);
-    // Get the book of the editiion, and if the edition updated is the latest edition,
-    // update the book's cache of title, cover, authors, and description.
-    if (edition.book !== undefined && edition.isLatestPublishedEdition())
-        edition.book.updateMetadataFromEdition(edition);
-};
-export const deleteEditionInFirestore = async (book, index) => {
-    if (!db)
-        throw Error("Can't update edition, not connected to Firebase.");
-    const revisions = book.getRevisions();
-    if (index < 0 || index >= revisions.length)
-        return;
-    await deleteDoc(revisions[index].ref);
-    revisions.splice(index, 1);
-    book.setRevisions(revisions);
-    await updateBookInFirestore(book);
-};
-export const updateBookInFirestore = async (book) => {
-    if (!db)
-        throw Error("Can't update boo, not connected to Firebase.");
-    await setDoc(doc(db, "books", book.getRefID()), book.toObject());
-};
-export const addChapterInFirestore = async (edition, chapter) => {
-    if (!db)
-        throw Error("Can't add chapter, not connected to Firebase.");
-    return await addDoc(collection(db, `editions/${edition.id}/chapters`), chapter);
-};
-export const removeChapterFromEditionInFirestore = async (chapter) => {
-    if (!db)
-        throw Error("Can't add chapter, not connected to Firebase.");
-    const ref = chapter.getRef();
-    if (!ref)
-        throw Error("Can't delete chapter, it doesn't have a document ID.");
-    await deleteDoc(ref);
-};
-export const loadChapterTextFromFirestore = async (chapter) => {
-    if (!db)
-        throw Error("Not connected to Firebase.");
-    const text = await getDoc(chapter);
-    if (!text.exists())
-        throw Error("Chapter text does not exist.");
-    return text.data();
-};
-export const updateChapterTextInFirestore = async (edition, chapter, text) => {
-    if (!db)
-        throw Error("Can't update chapter, not connected to Firebase.");
-    // Get the object for the book so we can store it.
-    const spec = { text: text };
-    // Update the book's preview
-    await setDoc(doc(db, `editions/${edition.id}/chapters`, chapter.id), spec);
-};
-export const subdomainIsAvailable = async (subdomain, book) => {
-    if (!db)
-        throw Error("Not connected to Firebase.");
-    const matches = await getDocs(query(collection(db, "books"), where("domain", "==", subdomain)));
-    return matches.empty || matches.docs[0].id === book.getRefID();
-};
-export const getBookIDFromBookName = async (subdomain) => {
-    if (!db)
-        throw Error("Can't find book ID from URL, not connected to Firebase.");
-    const matches = await getDocs(query(collection(db, "books"), where("domain", "==", subdomain)));
-    if (!matches.empty)
-        return matches.docs[0].id;
-    throw Error("No book by this name.");
-};

package/models/chapter/ReferenceNode.d.ts

@@ -1,29 +0,0 @@
-import Node from "./Node";
-export default class ReferenceNode extends Node {
-    readonly citationID: string;
-    readonly authors: string;
-    readonly year: string;
-    readonly title: string;
-    readonly source: string;
-    readonly url: string;
-    readonly summary: string;
-    readonly short: boolean;
-    constructor(citationID: string, authors?: string, year?: string, title?: string, source?: string, url?: string, summary?: string, short?: boolean);
-    getType(): string;
-    getChildren(): never[];
-    getParentOf(): Node | undefined;
-    toText(): string;
-    toBookdown(): string;
-    toHTML(): string;
-    toList(): string[];
-    copy(): this;
-    withChildReplaced(): undefined;
-    withContentInRange(): this | undefined;
-    withCitationID(id: string): ReferenceNode;
-    withAuthors(authors: string): ReferenceNode;
-    withYear(year: string): ReferenceNode;
-    withTitle(title: string): ReferenceNode;
-    withSource(source: string): ReferenceNode;
-    withURL(url: string): ReferenceNode;
-    withSummary(summary: string): ReferenceNode;
-}

package/models/chapter/ReferenceNode.js

@@ -1,48 +0,0 @@
-import Node from "./Node";
-export default class ReferenceNode extends Node {
-    citationID;
-    authors;
-    year;
-    title;
-    source;
-    url;
-    summary;
-    short;
-    constructor(citationID, authors = "", year = "", title = "", source = "", url = "", summary = "", short = false) {
-        super();
-        this.citationID = citationID;
-        this.authors = authors;
-        this.year = year;
-        this.title = title;
-        this.source = source;
-        this.url = url;
-        this.summary = summary;
-        this.short = short;
-    }
-    getType() { return "reference"; }
-    getChildren() { return []; }
-    getParentOf() { return undefined; }
-    toText() { return this.authors + " " + this.year + " " + this.title + " " + this.source + (this.summary ? this.summary : ""); }
-    toBookdown() { return ""; }
-    toHTML() { return ""; }
-    toList() {
-        const list = [this.authors, this.year, this.title, this.source];
-        if (this.url)
-            list.push(this.url);
-        if (this.summary)
-            list.push(this.summary);
-        return list;
-    }
-    copy() {
-        return new ReferenceNode(this.citationID, this.authors, this.year, this.title, this.source, this.url, this.summary, this.short);
-    }
-    withChildReplaced() { return undefined; }
-    withContentInRange() { return this.copy(); }
-    withCitationID(id) { return new ReferenceNode(id, this.authors, this.year, this.title, this.source, this.url, this.summary, this.short); }
-    withAuthors(authors) { return new ReferenceNode(this.citationID, authors, this.year, this.title, this.source, this.url, this.summary, this.short); }
-    withYear(year) { return new ReferenceNode(this.citationID, this.authors, year, this.title, this.source, this.url, this.summary, this.short); }
-    withTitle(title) { return new ReferenceNode(this.citationID, this.authors, this.year, title, this.source, this.url, this.summary, this.short); }
-    withSource(source) { return new ReferenceNode(this.citationID, this.authors, this.year, this.title, source, this.url, this.summary, this.short); }
-    withURL(url) { return new ReferenceNode(this.citationID, this.authors, this.year, this.title, this.source, url, this.summary, this.short); }
-    withSummary(summary) { return new ReferenceNode(this.citationID, this.authors, this.year, this.title, this.source, this.url, summary, this.short); }
-}

package/models/loadEdition.d.ts

@@ -1,5 +0,0 @@
-export default function loadEdition(bookIDOrName: string, editionID: string | undefined, latestPublished: boolean): Promise<{
-    book: import("./book/Book").default;
-    edition: import("./book/Edition").default | undefined;
-    latest: boolean;
-} | null>;

package/models/loadEdition.js

@@ -1,16 +0,0 @@
-import { getBookFromIDOrName } from "./Firestore";
-export default async function loadEdition(bookIDOrName, editionID, latestPublished) {
-    const getEditionNumber = editionID === undefined ? undefined : parseInt(editionID);
-    const book = await getBookFromIDOrName(bookIDOrName);
-    if (book === null)
-        return null;
-    const unspecifiedEdition = getEditionNumber === undefined || isNaN(getEditionNumber) || !book.isValidEditionNumber(getEditionNumber);
-    const edition = unspecifiedEdition ?
-        await (latestPublished ? book.getLatestPublishedEdition() : book.getDraftEdition()) :
-        await book.getEditionNumber(getEditionNumber);
-    return {
-        book: book,
-        edition: edition,
-        latest: unspecifiedEdition
-    };
-}