@storyteller-platform/audiobook 0.1.0

package/dist/base.cjs

@@ -0,0 +1,248 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var base_exports = {};
+__export(base_exports, {
+  BaseAudiobook: () => BaseAudiobook,
+  BaseAudiobookEntry: () => BaseAudiobookEntry
+});
+module.exports = __toCommonJS(base_exports);
+var import_node_taglib_sharp = require("node-taglib-sharp");
+function splitNames(names) {
+  return names.flatMap(
+    (entry) => entry.split(/[;,/]/).map((name) => name.trim())
+  );
+}
+class BaseAudiobookEntry {
+  async getFile() {
+    if (this.file) return this.file;
+    const file = await this.createFile();
+    this.file = file;
+    return this.file;
+  }
+  async getTitle() {
+    const file = await this.getFile();
+    return file.tag.title;
+  }
+  async setTitle(title) {
+    const file = await this.getFile();
+    file.tag.title = title;
+  }
+  async getSubtitle() {
+    const file = await this.getFile();
+    return file.tag.subtitle;
+  }
+  async setSubtitle(subtitle) {
+    const file = await this.getFile();
+    file.tag.subtitle = subtitle;
+  }
+  async getDescription() {
+    const file = await this.getFile();
+    return file.tag.description || file.tag.comment || null;
+  }
+  async setDescription(description) {
+    const file = await this.getFile();
+    file.tag.description = description;
+  }
+  async getAuthors() {
+    const file = await this.getFile();
+    const albumArtists = file.tag.albumArtists;
+    if (albumArtists.length) {
+      return splitNames(albumArtists);
+    }
+    const artists = file.tag.performers;
+    return splitNames(artists);
+  }
+  async setAuthors(authors) {
+    const file = await this.getFile();
+    file.tag.albumArtists = authors;
+    file.tag.performers = authors;
+  }
+  async getNarrators() {
+    const file = await this.getFile();
+    const composers = file.tag.composers;
+    if (composers.length) {
+      return splitNames(composers);
+    }
+    const conductor = file.tag.conductor;
+    if (!conductor) return [];
+    return splitNames([conductor]);
+  }
+  async setNarrators(narrators) {
+    const file = await this.getFile();
+    file.tag.composers = narrators;
+    file.tag.conductor = narrators.join(";");
+  }
+  async getCoverArt() {
+    const file = await this.getFile();
+    return file.tag.pictures.find(
+      (picture) => picture.type === import_node_taglib_sharp.PictureType.FrontCover
+    ) ?? null;
+  }
+  async setCoverArt(picture) {
+    const file = await this.getFile();
+    const pictures = file.tag.pictures;
+    const frontCover = pictures.find(
+      (picture2) => picture2.type === import_node_taglib_sharp.PictureType.FrontCover
+    );
+    if (frontCover) {
+      Object.assign(frontCover, picture);
+    } else {
+      pictures.push(picture);
+    }
+    file.tag.pictures = pictures;
+  }
+  async getPublisher() {
+    const file = await this.getFile();
+    return file.tag.publisher;
+  }
+  async setPublisher(publisher) {
+    const file = await this.getFile();
+    file.tag.publisher = publisher;
+  }
+  async getReleased() {
+    const file = await this.getFile();
+    return file.tag.year.toString();
+  }
+  async setReleased(released) {
+    const file = await this.getFile();
+    file.tag.year = parseInt(released);
+  }
+  save() {
+    var _a;
+    (_a = this.file) == null ? void 0 : _a.save();
+  }
+}
+class BaseAudiobook {
+  metadata = {};
+  async getFirstValue(getter) {
+    for (const entry of this.entries) {
+      const value = await getter(entry);
+      if (value) return value;
+    }
+    return null;
+  }
+  async setValue(setter) {
+    for (const entry of this.entries) {
+      await setter(entry);
+    }
+  }
+  async getTitle() {
+    if (this.metadata.title) {
+      return this.metadata.title;
+    }
+    const title = await this.getFirstValue((entry) => entry.getTitle());
+    if (title) this.metadata.title = title;
+    return title;
+  }
+  async setTitle(title) {
+    this.metadata.title = title;
+    await this.setValue((entry) => entry.setTitle(title));
+  }
+  async getSubtitle() {
+    if (this.metadata.subtitle) {
+      return this.metadata.subtitle;
+    }
+    const subtitle = await this.getFirstValue((entry) => entry.getSubtitle());
+    if (subtitle) this.metadata.subtitle = subtitle;
+    return subtitle;
+  }
+  async setSubtitle(subtitle) {
+    this.metadata.subtitle = subtitle;
+    await this.setValue((entry) => entry.setSubtitle(subtitle));
+  }
+  async getDescription() {
+    if (this.metadata.description) {
+      return this.metadata.description;
+    }
+    const description = await this.getFirstValue(
+      (entry) => entry.getDescription()
+    );
+    if (description) this.metadata.description = description;
+    return description;
+  }
+  async setDescription(description) {
+    this.metadata.description = description;
+    await this.setValue((entry) => entry.setDescription(description));
+  }
+  async getAuthors() {
+    if (this.metadata.authors) {
+      return this.metadata.authors;
+    }
+    const authors = await this.getFirstValue((entry) => entry.getAuthors());
+    if (authors) this.metadata.authors = authors;
+    return authors ?? [];
+  }
+  async setAuthors(authors) {
+    this.metadata.authors = authors;
+    await this.setValue((entry) => entry.setAuthors(authors));
+  }
+  async getNarrators() {
+    if (this.metadata.narrators) {
+      return this.metadata.narrators;
+    }
+    const narrators = await this.getFirstValue((entry) => entry.getNarrators());
+    if (narrators) this.metadata.narrators = narrators;
+    return narrators ?? [];
+  }
+  async setNarrators(narrators) {
+    this.metadata.narrators = narrators;
+    await this.setValue((entry) => entry.setNarrators(narrators));
+  }
+  async getCoverArt() {
+    if (this.metadata.coverArt) {
+      return this.metadata.coverArt;
+    }
+    const coverArt = await this.getFirstValue((entry) => entry.getCoverArt());
+    if (coverArt) this.metadata.coverArt = coverArt;
+    return coverArt;
+  }
+  async setCoverArt(picture) {
+    this.metadata.coverArt = picture;
+    await this.setValue((entry) => entry.setCoverArt(picture));
+  }
+  async getPublisher() {
+    if (this.metadata.publisher) {
+      return this.metadata.publisher;
+    }
+    const publisher = await this.getFirstValue((entry) => entry.getPublisher());
+    if (publisher) this.metadata.publisher = publisher;
+    return publisher;
+  }
+  async setPublisher(publisher) {
+    this.metadata.publisher = publisher;
+    await this.setValue((entry) => entry.setPublisher(publisher));
+  }
+  async getReleased() {
+    if (this.metadata.released) {
+      return this.metadata.released;
+    }
+    const released = await this.getFirstValue((entry) => entry.getReleased());
+    if (released) this.metadata.released = released;
+    return released;
+  }
+  async setReleased(released) {
+    this.metadata.released = released;
+    await this.setValue((entry) => entry.setReleased(released));
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseAudiobook,
+  BaseAudiobookEntry
+});

package/dist/base.d.cts

@@ -0,0 +1,67 @@
+import { File, IPicture } from 'node-taglib-sharp';
+
+declare abstract class BaseAudiobookEntry {
+    abstract filename: string;
+    protected abstract file: File | null;
+    abstract getData(): Promise<Uint8Array>;
+    abstract createFile(): Promise<File>;
+    getFile(): Promise<File>;
+    getTitle(): Promise<string | null>;
+    setTitle(title: string): Promise<void>;
+    getSubtitle(): Promise<string | null>;
+    setSubtitle(subtitle: string): Promise<void>;
+    getDescription(): Promise<string | null>;
+    setDescription(description: string): Promise<void>;
+    getAuthors(): Promise<string[]>;
+    setAuthors(authors: string[]): Promise<void>;
+    getNarrators(): Promise<string[]>;
+    setNarrators(narrators: string[]): Promise<void>;
+    getCoverArt(): Promise<IPicture | null>;
+    setCoverArt(picture: IPicture): Promise<void>;
+    getPublisher(): Promise<string | null>;
+    setPublisher(publisher: string): Promise<void>;
+    getReleased(): Promise<string | null>;
+    setReleased(released: string): Promise<void>;
+    save(): void;
+}
+interface AudiobookChapter {
+    filename: string;
+    start: number;
+    stop: number;
+    title: string;
+}
+interface AudiobookMetadata {
+    title?: string;
+    subtitle?: string;
+    description?: string;
+    coverArt?: IPicture;
+    chapters?: AudiobookChapter[];
+    authors?: string[];
+    narrators?: string[];
+    publisher?: string;
+    released?: string;
+}
+declare abstract class BaseAudiobook {
+    protected metadata: AudiobookMetadata;
+    protected abstract entries: BaseAudiobookEntry[];
+    protected getFirstValue<T>(getter: (entry: BaseAudiobookEntry) => Promise<T>): Promise<T | null>;
+    protected setValue(setter: (entry: BaseAudiobookEntry) => Promise<void>): Promise<void>;
+    getTitle(): Promise<string | null>;
+    setTitle(title: string): Promise<void>;
+    getSubtitle(): Promise<string | null>;
+    setSubtitle(subtitle: string): Promise<void>;
+    getDescription(): Promise<string | null>;
+    setDescription(description: string): Promise<void>;
+    getAuthors(): Promise<string[]>;
+    setAuthors(authors: string[]): Promise<void>;
+    getNarrators(): Promise<string[]>;
+    setNarrators(narrators: string[]): Promise<void>;
+    getCoverArt(): Promise<IPicture | null>;
+    setCoverArt(picture: IPicture): Promise<void>;
+    getPublisher(): Promise<string | null>;
+    setPublisher(publisher: string): Promise<void>;
+    getReleased(): Promise<string | null>;
+    setReleased(released: string): Promise<void>;
+}
+
+export { type AudiobookChapter, type AudiobookMetadata, BaseAudiobook, BaseAudiobookEntry };

package/dist/base.d.ts

@@ -0,0 +1,67 @@
+import { File, IPicture } from 'node-taglib-sharp';
+
+declare abstract class BaseAudiobookEntry {
+    abstract filename: string;
+    protected abstract file: File | null;
+    abstract getData(): Promise<Uint8Array>;
+    abstract createFile(): Promise<File>;
+    getFile(): Promise<File>;
+    getTitle(): Promise<string | null>;
+    setTitle(title: string): Promise<void>;
+    getSubtitle(): Promise<string | null>;
+    setSubtitle(subtitle: string): Promise<void>;
+    getDescription(): Promise<string | null>;
+    setDescription(description: string): Promise<void>;
+    getAuthors(): Promise<string[]>;
+    setAuthors(authors: string[]): Promise<void>;
+    getNarrators(): Promise<string[]>;
+    setNarrators(narrators: string[]): Promise<void>;
+    getCoverArt(): Promise<IPicture | null>;
+    setCoverArt(picture: IPicture): Promise<void>;
+    getPublisher(): Promise<string | null>;
+    setPublisher(publisher: string): Promise<void>;
+    getReleased(): Promise<string | null>;
+    setReleased(released: string): Promise<void>;
+    save(): void;
+}
+interface AudiobookChapter {
+    filename: string;
+    start: number;
+    stop: number;
+    title: string;
+}
+interface AudiobookMetadata {
+    title?: string;
+    subtitle?: string;
+    description?: string;
+    coverArt?: IPicture;
+    chapters?: AudiobookChapter[];
+    authors?: string[];
+    narrators?: string[];
+    publisher?: string;
+    released?: string;
+}
+declare abstract class BaseAudiobook {
+    protected metadata: AudiobookMetadata;
+    protected abstract entries: BaseAudiobookEntry[];
+    protected getFirstValue<T>(getter: (entry: BaseAudiobookEntry) => Promise<T>): Promise<T | null>;
+    protected setValue(setter: (entry: BaseAudiobookEntry) => Promise<void>): Promise<void>;
+    getTitle(): Promise<string | null>;
+    setTitle(title: string): Promise<void>;
+    getSubtitle(): Promise<string | null>;
+    setSubtitle(subtitle: string): Promise<void>;
+    getDescription(): Promise<string | null>;
+    setDescription(description: string): Promise<void>;
+    getAuthors(): Promise<string[]>;
+    setAuthors(authors: string[]): Promise<void>;
+    getNarrators(): Promise<string[]>;
+    setNarrators(narrators: string[]): Promise<void>;
+    getCoverArt(): Promise<IPicture | null>;
+    setCoverArt(picture: IPicture): Promise<void>;
+    getPublisher(): Promise<string | null>;
+    setPublisher(publisher: string): Promise<void>;
+    getReleased(): Promise<string | null>;
+    setReleased(released: string): Promise<void>;
+}
+
+export { type AudiobookChapter, type AudiobookMetadata, BaseAudiobook, BaseAudiobookEntry };

package/dist/base.js

@@ -0,0 +1,223 @@
+import { PictureType } from "node-taglib-sharp";
+function splitNames(names) {
+  return names.flatMap(
+    (entry) => entry.split(/[;,/]/).map((name) => name.trim())
+  );
+}
+class BaseAudiobookEntry {
+  async getFile() {
+    if (this.file) return this.file;
+    const file = await this.createFile();
+    this.file = file;
+    return this.file;
+  }
+  async getTitle() {
+    const file = await this.getFile();
+    return file.tag.title;
+  }
+  async setTitle(title) {
+    const file = await this.getFile();
+    file.tag.title = title;
+  }
+  async getSubtitle() {
+    const file = await this.getFile();
+    return file.tag.subtitle;
+  }
+  async setSubtitle(subtitle) {
+    const file = await this.getFile();
+    file.tag.subtitle = subtitle;
+  }
+  async getDescription() {
+    const file = await this.getFile();
+    return file.tag.description || file.tag.comment || null;
+  }
+  async setDescription(description) {
+    const file = await this.getFile();
+    file.tag.description = description;
+  }
+  async getAuthors() {
+    const file = await this.getFile();
+    const albumArtists = file.tag.albumArtists;
+    if (albumArtists.length) {
+      return splitNames(albumArtists);
+    }
+    const artists = file.tag.performers;
+    return splitNames(artists);
+  }
+  async setAuthors(authors) {
+    const file = await this.getFile();
+    file.tag.albumArtists = authors;
+    file.tag.performers = authors;
+  }
+  async getNarrators() {
+    const file = await this.getFile();
+    const composers = file.tag.composers;
+    if (composers.length) {
+      return splitNames(composers);
+    }
+    const conductor = file.tag.conductor;
+    if (!conductor) return [];
+    return splitNames([conductor]);
+  }
+  async setNarrators(narrators) {
+    const file = await this.getFile();
+    file.tag.composers = narrators;
+    file.tag.conductor = narrators.join(";");
+  }
+  async getCoverArt() {
+    const file = await this.getFile();
+    return file.tag.pictures.find(
+      (picture) => picture.type === PictureType.FrontCover
+    ) ?? null;
+  }
+  async setCoverArt(picture) {
+    const file = await this.getFile();
+    const pictures = file.tag.pictures;
+    const frontCover = pictures.find(
+      (picture2) => picture2.type === PictureType.FrontCover
+    );
+    if (frontCover) {
+      Object.assign(frontCover, picture);
+    } else {
+      pictures.push(picture);
+    }
+    file.tag.pictures = pictures;
+  }
+  async getPublisher() {
+    const file = await this.getFile();
+    return file.tag.publisher;
+  }
+  async setPublisher(publisher) {
+    const file = await this.getFile();
+    file.tag.publisher = publisher;
+  }
+  async getReleased() {
+    const file = await this.getFile();
+    return file.tag.year.toString();
+  }
+  async setReleased(released) {
+    const file = await this.getFile();
+    file.tag.year = parseInt(released);
+  }
+  save() {
+    var _a;
+    (_a = this.file) == null ? void 0 : _a.save();
+  }
+}
+class BaseAudiobook {
+  metadata = {};
+  async getFirstValue(getter) {
+    for (const entry of this.entries) {
+      const value = await getter(entry);
+      if (value) return value;
+    }
+    return null;
+  }
+  async setValue(setter) {
+    for (const entry of this.entries) {
+      await setter(entry);
+    }
+  }
+  async getTitle() {
+    if (this.metadata.title) {
+      return this.metadata.title;
+    }
+    const title = await this.getFirstValue((entry) => entry.getTitle());
+    if (title) this.metadata.title = title;
+    return title;
+  }
+  async setTitle(title) {
+    this.metadata.title = title;
+    await this.setValue((entry) => entry.setTitle(title));
+  }
+  async getSubtitle() {
+    if (this.metadata.subtitle) {
+      return this.metadata.subtitle;
+    }
+    const subtitle = await this.getFirstValue((entry) => entry.getSubtitle());
+    if (subtitle) this.metadata.subtitle = subtitle;
+    return subtitle;
+  }
+  async setSubtitle(subtitle) {
+    this.metadata.subtitle = subtitle;
+    await this.setValue((entry) => entry.setSubtitle(subtitle));
+  }
+  async getDescription() {
+    if (this.metadata.description) {
+      return this.metadata.description;
+    }
+    const description = await this.getFirstValue(
+      (entry) => entry.getDescription()
+    );
+    if (description) this.metadata.description = description;
+    return description;
+  }
+  async setDescription(description) {
+    this.metadata.description = description;
+    await this.setValue((entry) => entry.setDescription(description));
+  }
+  async getAuthors() {
+    if (this.metadata.authors) {
+      return this.metadata.authors;
+    }
+    const authors = await this.getFirstValue((entry) => entry.getAuthors());
+    if (authors) this.metadata.authors = authors;
+    return authors ?? [];
+  }
+  async setAuthors(authors) {
+    this.metadata.authors = authors;
+    await this.setValue((entry) => entry.setAuthors(authors));
+  }
+  async getNarrators() {
+    if (this.metadata.narrators) {
+      return this.metadata.narrators;
+    }
+    const narrators = await this.getFirstValue((entry) => entry.getNarrators());
+    if (narrators) this.metadata.narrators = narrators;
+    return narrators ?? [];
+  }
+  async setNarrators(narrators) {
+    this.metadata.narrators = narrators;
+    await this.setValue((entry) => entry.setNarrators(narrators));
+  }
+  async getCoverArt() {
+    if (this.metadata.coverArt) {
+      return this.metadata.coverArt;
+    }
+    const coverArt = await this.getFirstValue((entry) => entry.getCoverArt());
+    if (coverArt) this.metadata.coverArt = coverArt;
+    return coverArt;
+  }
+  async setCoverArt(picture) {
+    this.metadata.coverArt = picture;
+    await this.setValue((entry) => entry.setCoverArt(picture));
+  }
+  async getPublisher() {
+    if (this.metadata.publisher) {
+      return this.metadata.publisher;
+    }
+    const publisher = await this.getFirstValue((entry) => entry.getPublisher());
+    if (publisher) this.metadata.publisher = publisher;
+    return publisher;
+  }
+  async setPublisher(publisher) {
+    this.metadata.publisher = publisher;
+    await this.setValue((entry) => entry.setPublisher(publisher));
+  }
+  async getReleased() {
+    if (this.metadata.released) {
+      return this.metadata.released;
+    }
+    const released = await this.getFirstValue((entry) => entry.getReleased());
+    if (released) this.metadata.released = released;
+    return released;
+  }
+  async setReleased(released) {
+    this.metadata.released = released;
+    await this.setValue((entry) => entry.setReleased(released));
+  }
+}
+export {
+  BaseAudiobook,
+  BaseAudiobookEntry
+};

package/dist/entry.cjs

@@ -0,0 +1,57 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var entry_exports = {};
+__export(entry_exports, {
+  AudiobookEntry: () => AudiobookEntry
+});
+module.exports = __toCommonJS(entry_exports);
+var import_zip = require("@zip.js/zip.js");
+var import_node_taglib_sharp = require("node-taglib-sharp");
+var import_base = require("./base.cjs");
+var import_Uint8ArrayFileAbstraction = require("./taglib/Uint8ArrayFileAbstraction.cjs");
+class AudiobookEntry extends import_base.BaseAudiobookEntry {
+  constructor(entry) {
+    super();
+    this.entry = entry;
+    this.filename = entry.filename;
+  }
+  filename;
+  file = null;
+  async readData() {
+    if ("data" in this.entry) {
+      return this.entry.data;
+    }
+    const writer = new import_zip.Uint8ArrayWriter();
+    return await this.entry.getData(writer);
+  }
+  async getData() {
+    const file = await this.getFile();
+    return file.fileAbstraction.data;
+  }
+  async createFile() {
+    const data = await this.readData();
+    return import_node_taglib_sharp.File.createFromAbstraction(
+      new import_Uint8ArrayFileAbstraction.Uint8ArrayFileAbstraction(this.filename, data)
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AudiobookEntry
+});

package/dist/entry.d.cts

@@ -0,0 +1,19 @@
+import { Entry } from '@zip.js/zip.js';
+import { File } from 'node-taglib-sharp';
+import { BaseAudiobookEntry } from './base.cjs';
+
+interface Uint8ArrayEntry {
+    filename: string;
+    data: Uint8Array;
+}
+declare class AudiobookEntry extends BaseAudiobookEntry {
+    protected entry: Uint8ArrayEntry | Entry;
+    filename: string;
+    protected file: File | null;
+    protected readData(): Promise<Uint8Array<ArrayBufferLike>>;
+    getData(): Promise<Uint8Array<ArrayBufferLike>>;
+    createFile(): Promise<File>;
+    constructor(entry: Uint8ArrayEntry | Entry);
+}
+
+export { AudiobookEntry, type Uint8ArrayEntry };

package/dist/entry.d.ts

@@ -0,0 +1,19 @@
+import { Entry } from '@zip.js/zip.js';
+import { File } from 'node-taglib-sharp';
+import { BaseAudiobookEntry } from './base.js';
+
+interface Uint8ArrayEntry {
+    filename: string;
+    data: Uint8Array;
+}
+declare class AudiobookEntry extends BaseAudiobookEntry {
+    protected entry: Uint8ArrayEntry | Entry;
+    filename: string;
+    protected file: File | null;
+    protected readData(): Promise<Uint8Array<ArrayBufferLike>>;
+    getData(): Promise<Uint8Array<ArrayBufferLike>>;
+    createFile(): Promise<File>;
+    constructor(entry: Uint8ArrayEntry | Entry);
+}
+
+export { AudiobookEntry, type Uint8ArrayEntry };