@storyteller-platform/audiobook 0.3.4 → 0.3.6

package/dist/entry.cjs

@@ -144,9 +144,28 @@ class AudiobookEntry {
       start: chapter.startTime
     }));
   }
+  async setChapters(chapters) {
+    const info = await this.getInfo();
+    const duration = await this.getDuration();
+    const ffmpegChapters = [];
+    for (let i = 0; i < ffmpegChapters.length; i++) {
+      const chapter = chapters[i];
+      const prevFfmpegChapter = ffmpegChapters[i - 1];
+      ffmpegChapters.push({
+        id: i,
+        startTime: chapter.start ?? 0,
+        title: chapter.title ?? `ch${i}`,
+        endTime: duration
+      });
+      if (prevFfmpegChapter) {
+        prevFfmpegChapter.endTime = chapter.start ?? 0;
+      }
+    }
+    info.chapters = ffmpegChapters;
+  }
   async saveAndClose() {
     const info = await this.getInfo();
-    await (0, import_ffmpeg.writeTrackMetadata)(this.filename, info.tags, info.attachedPic);
+    await (0, import_ffmpeg.writeTrackMetadata)(this.filename, info);
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/entry.d.cts

@@ -33,6 +33,7 @@ declare class AudiobookEntry {
     getBitRate(): Promise<number | undefined>;
     getResource(): Promise<AudiobookResource>;
     getChapters(): Promise<AudiobookChapter[]>;
+    setChapters(chapters: AudiobookChapter[]): Promise<void>;
     saveAndClose(): Promise<void>;
 }
 

package/dist/entry.d.ts

@@ -33,6 +33,7 @@ declare class AudiobookEntry {
     getBitRate(): Promise<number | undefined>;
     getResource(): Promise<AudiobookResource>;
     getChapters(): Promise<AudiobookChapter[]>;
+    setChapters(chapters: AudiobookChapter[]): Promise<void>;
     saveAndClose(): Promise<void>;
 }
 

package/dist/entry.js

@@ -125,9 +125,28 @@ class AudiobookEntry {
       start: chapter.startTime
     }));
   }
+  async setChapters(chapters) {
+    const info = await this.getInfo();
+    const duration = await this.getDuration();
+    const ffmpegChapters = [];
+    for (let i = 0; i < ffmpegChapters.length; i++) {
+      const chapter = chapters[i];
+      const prevFfmpegChapter = ffmpegChapters[i - 1];
+      ffmpegChapters.push({
+        id: i,
+        startTime: chapter.start ?? 0,
+        title: chapter.title ?? `ch${i}`,
+        endTime: duration
+      });
+      if (prevFfmpegChapter) {
+        prevFfmpegChapter.endTime = chapter.start ?? 0;
+      }
+    }
+    info.chapters = ffmpegChapters;
+  }
   async saveAndClose() {
     const info = await this.getInfo();
-    await writeTrackMetadata(this.filename, info.tags, info.attachedPic);
+    await writeTrackMetadata(this.filename, info);
   }
 }
 export {

package/dist/ffmpeg.cjs

@@ -90,11 +90,19 @@ function lookup(codecName) {
   }
 }
 async function getTrackMetadata(path) {
-  var _a, _b;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
   const stdout = await execCmd(
     `ffprobe -i ${quotePath(path)} -v quiet -show_format -show_chapters -show_streams -output_format json`
   );
   const { chapters, streams, format } = JSON.parse(stdout);
+  let id3v2Version = null;
+  if ((0, import_path.extname)(path).toLowerCase() === ".mp3") {
+    const { stderr: id3v2VersionOut } = await execPromise(
+      `ffprobe -i ${quotePath(path)} -v debug`
+    );
+    const id3v2VersionMatch = id3v2VersionOut.match(/id3v2 ver:(3|4)/);
+    id3v2Version = (id3v2VersionMatch == null ? void 0 : id3v2VersionMatch[1]) ?? null;
+  }
   const attachedPicStream = streams.find(
     (stream) => !!stream.disposition.attached_pic
   );
@@ -121,20 +129,21 @@ async function getTrackMetadata(path) {
     ])
   };
   return {
+    id3v2Version,
     duration: parseFloat(format.duration),
     bitRate: format.bit_rate !== void 0 ? parseFloat(format.bit_rate) : format.bit_rate,
     tags: {
-      title: format.tags.title ?? format.tags.Title,
-      subtitle: format.tags.subtitle ?? format.tags.Subtitle,
-      date: format.tags.date ?? format.tags.Date,
-      album: format.tags.album ?? format.tags.Album,
-      albumArtist: format.tags.album_artist ?? format.tags.Album_Artist,
-      artist: format.tags.artist ?? format.tags.Artist,
-      performer: format.tags.performer ?? format.tags.Performer,
-      composer: format.tags.composer ?? format.tags.Composer,
-      comment: format.tags.comment ?? format.tags.Comment,
-      description: format.tags.description ?? format.tags.Description,
-      publisher: format.tags.publisher ?? format.tags.Publisher
+      title: ((_c = format.tags) == null ? void 0 : _c.title) ?? ((_d = format.tags) == null ? void 0 : _d.Title),
+      subtitle: ((_e = format.tags) == null ? void 0 : _e.subtitle) ?? ((_f = format.tags) == null ? void 0 : _f.Subtitle),
+      date: ((_g = format.tags) == null ? void 0 : _g.date) ?? ((_h = format.tags) == null ? void 0 : _h.Date),
+      album: ((_i = format.tags) == null ? void 0 : _i.album) ?? ((_j = format.tags) == null ? void 0 : _j.Album),
+      albumArtist: ((_k = format.tags) == null ? void 0 : _k.album_artist) ?? ((_l = format.tags) == null ? void 0 : _l.Album_Artist),
+      artist: ((_m = format.tags) == null ? void 0 : _m.artist) ?? ((_n = format.tags) == null ? void 0 : _n.Artist),
+      performer: ((_o = format.tags) == null ? void 0 : _o.performer) ?? ((_p = format.tags) == null ? void 0 : _p.Performer),
+      composer: ((_q = format.tags) == null ? void 0 : _q.composer) ?? ((_r = format.tags) == null ? void 0 : _r.Composer),
+      comment: ((_s = format.tags) == null ? void 0 : _s.comment) ?? ((_t = format.tags) == null ? void 0 : _t.Comment),
+      description: ((_u = format.tags) == null ? void 0 : _u.description) ?? ((_v = format.tags) == null ? void 0 : _v.Description),
+      publisher: ((_w = format.tags) == null ? void 0 : _w.publisher) ?? ((_x = format.tags) == null ? void 0 : _x.Publisher)
     },
     chapters: chapters.map(
       (chapter) => ({
@@ -147,9 +156,16 @@ async function getTrackMetadata(path) {
     attachedPic
   };
 }
-async function writeTrackMetadata(path, metadata, attachedPic) {
+function escapeFfmetadata(str) {
+  return str.replaceAll(/\\/g, "\\\\").replaceAll(/=/g, "\\=").replaceAll(/;/g, "\\;").replaceAll(/#/g, "\\#").replaceAll(/\n/g, "\\n");
+}
+async function writeTrackMetadata(path, trackInfo) {
+  const { tags: metadata, id3v2Version, chapters, attachedPic } = trackInfo;
   const args = [];
   const metadataArgs = [];
+  if (id3v2Version) {
+    metadataArgs.push(`-id3v2_version ${id3v2Version}`);
+  }
   if (metadata.title) {
     metadataArgs.push(`-metadata title="${escapeQuotes(metadata.title)}"`);
   }
@@ -191,13 +207,34 @@ async function writeTrackMetadata(path, metadata, attachedPic) {
       `-metadata publisher="${escapeQuotes(metadata.publisher)}"`
     );
   }
+  metadataArgs.push("-map 0:a -map_metadata 0");
   const ext = (0, import_path.extname)(path);
   const tmpPath = (0, import_node_path.join)(
     (0, import_node_os.tmpdir)(),
     `storyteller-platform-audiobook-${(0, import_node_crypto.randomUUID)()}${ext}`
   );
+  const chapterFilePath = (0, import_node_path.join)(
+    (0, import_node_os.tmpdir)(),
+    `storyteller-platform-audiobook-${(0, import_node_crypto.randomUUID)()}.txt`
+  );
   let picPath = null;
   try {
+    let chapterFileContents = ";FFMETADATA1\n\n";
+    for (const chapter of chapters) {
+      chapterFileContents += `[CHAPTER]
+TIMEBASE=1/1000
+START=${Math.floor(chapter.startTime * 1e3)}
+END=${Math.floor(chapter.endTime * 1e3)}
+`;
+      if (chapter.title) {
+        chapterFileContents += `TITLE=${escapeFfmetadata(chapter.title)}
+`;
+      }
+      chapterFileContents += "\n";
+    }
+    await (0, import_promises.writeFile)(chapterFilePath, chapterFileContents);
+    args.push(`-i ${chapterFilePath}`);
+    metadataArgs.push(`-map_chapters 1`);
     if (attachedPic) {
       const imageExt = attachedPic.mimeType.split("/")[1];
       picPath = (0, import_node_path.join)(
@@ -205,9 +242,9 @@ async function writeTrackMetadata(path, metadata, attachedPic) {
         `storyteller-platform-audiobook-${(0, import_node_crypto.randomUUID)()}.${imageExt}`
       );
       await (0, import_promises.writeFile)(picPath, attachedPic.data);
-      args.push(`-i ${quotePath(picPath)}`);
-      args.push(`-map 0:a -map 1:v`);
-      args.push(`-disposition:v:0 attached_pic`);
+      args.push(`-i ${picPath}`);
+      metadataArgs.push(`-map 2:v`);
+      metadataArgs.push(`-disposition:v:0 attached_pic`);
       if (attachedPic.name) {
         metadataArgs.push(
           `-metadata:s:v title="${escapeQuotes(attachedPic.name)}"`

package/dist/ffmpeg.d.cts

@@ -15,6 +15,7 @@ type AttachedPic = {
     description?: string | undefined;
 };
 declare function getTrackMetadata(path: string): Promise<{
+    id3v2Version: 3 | 4 | null;
     duration: number;
     bitRate: number | undefined;
     tags: {
@@ -38,8 +39,9 @@ declare function getTrackMetadata(path: string): Promise<{
     }[];
     attachedPic: AttachedPic | undefined;
 }>;
-declare function writeTrackMetadata(path: string, metadata: TrackInfo["tags"], attachedPic: AttachedPic | undefined): Promise<void>;
+declare function writeTrackMetadata(path: string, trackInfo: TrackInfo): Promise<void>;
 declare function getTrackMetadataFromBuffer(buffer: Uint8Array): Promise<{
+    id3v2Version: 3 | 4 | null;
     duration: number;
     bitRate: number | undefined;
     tags: {

package/dist/ffmpeg.d.ts

@@ -15,6 +15,7 @@ type AttachedPic = {
     description?: string | undefined;
 };
 declare function getTrackMetadata(path: string): Promise<{
+    id3v2Version: 3 | 4 | null;
     duration: number;
     bitRate: number | undefined;
     tags: {
@@ -38,8 +39,9 @@ declare function getTrackMetadata(path: string): Promise<{
     }[];
     attachedPic: AttachedPic | undefined;
 }>;
-declare function writeTrackMetadata(path: string, metadata: TrackInfo["tags"], attachedPic: AttachedPic | undefined): Promise<void>;
+declare function writeTrackMetadata(path: string, trackInfo: TrackInfo): Promise<void>;
 declare function getTrackMetadataFromBuffer(buffer: Uint8Array): Promise<{
+    id3v2Version: 3 | 4 | null;
     duration: number;
     bitRate: number | undefined;
     tags: {

package/dist/ffmpeg.js

@@ -64,11 +64,19 @@ function lookup(codecName) {
   }
 }
 async function getTrackMetadata(path) {
-  var _a, _b;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
   const stdout = await execCmd(
     `ffprobe -i ${quotePath(path)} -v quiet -show_format -show_chapters -show_streams -output_format json`
   );
   const { chapters, streams, format } = JSON.parse(stdout);
+  let id3v2Version = null;
+  if (extname(path).toLowerCase() === ".mp3") {
+    const { stderr: id3v2VersionOut } = await execPromise(
+      `ffprobe -i ${quotePath(path)} -v debug`
+    );
+    const id3v2VersionMatch = id3v2VersionOut.match(/id3v2 ver:(3|4)/);
+    id3v2Version = (id3v2VersionMatch == null ? void 0 : id3v2VersionMatch[1]) ?? null;
+  }
   const attachedPicStream = streams.find(
     (stream) => !!stream.disposition.attached_pic
   );
@@ -95,20 +103,21 @@ async function getTrackMetadata(path) {
     ])
   };
   return {
+    id3v2Version,
     duration: parseFloat(format.duration),
     bitRate: format.bit_rate !== void 0 ? parseFloat(format.bit_rate) : format.bit_rate,
     tags: {
-      title: format.tags.title ?? format.tags.Title,
-      subtitle: format.tags.subtitle ?? format.tags.Subtitle,
-      date: format.tags.date ?? format.tags.Date,
-      album: format.tags.album ?? format.tags.Album,
-      albumArtist: format.tags.album_artist ?? format.tags.Album_Artist,
-      artist: format.tags.artist ?? format.tags.Artist,
-      performer: format.tags.performer ?? format.tags.Performer,
-      composer: format.tags.composer ?? format.tags.Composer,
-      comment: format.tags.comment ?? format.tags.Comment,
-      description: format.tags.description ?? format.tags.Description,
-      publisher: format.tags.publisher ?? format.tags.Publisher
+      title: ((_c = format.tags) == null ? void 0 : _c.title) ?? ((_d = format.tags) == null ? void 0 : _d.Title),
+      subtitle: ((_e = format.tags) == null ? void 0 : _e.subtitle) ?? ((_f = format.tags) == null ? void 0 : _f.Subtitle),
+      date: ((_g = format.tags) == null ? void 0 : _g.date) ?? ((_h = format.tags) == null ? void 0 : _h.Date),
+      album: ((_i = format.tags) == null ? void 0 : _i.album) ?? ((_j = format.tags) == null ? void 0 : _j.Album),
+      albumArtist: ((_k = format.tags) == null ? void 0 : _k.album_artist) ?? ((_l = format.tags) == null ? void 0 : _l.Album_Artist),
+      artist: ((_m = format.tags) == null ? void 0 : _m.artist) ?? ((_n = format.tags) == null ? void 0 : _n.Artist),
+      performer: ((_o = format.tags) == null ? void 0 : _o.performer) ?? ((_p = format.tags) == null ? void 0 : _p.Performer),
+      composer: ((_q = format.tags) == null ? void 0 : _q.composer) ?? ((_r = format.tags) == null ? void 0 : _r.Composer),
+      comment: ((_s = format.tags) == null ? void 0 : _s.comment) ?? ((_t = format.tags) == null ? void 0 : _t.Comment),
+      description: ((_u = format.tags) == null ? void 0 : _u.description) ?? ((_v = format.tags) == null ? void 0 : _v.Description),
+      publisher: ((_w = format.tags) == null ? void 0 : _w.publisher) ?? ((_x = format.tags) == null ? void 0 : _x.Publisher)
     },
     chapters: chapters.map(
       (chapter) => ({
@@ -121,9 +130,16 @@ async function getTrackMetadata(path) {
     attachedPic
   };
 }
-async function writeTrackMetadata(path, metadata, attachedPic) {
+function escapeFfmetadata(str) {
+  return str.replaceAll(/\\/g, "\\\\").replaceAll(/=/g, "\\=").replaceAll(/;/g, "\\;").replaceAll(/#/g, "\\#").replaceAll(/\n/g, "\\n");
+}
+async function writeTrackMetadata(path, trackInfo) {
+  const { tags: metadata, id3v2Version, chapters, attachedPic } = trackInfo;
   const args = [];
   const metadataArgs = [];
+  if (id3v2Version) {
+    metadataArgs.push(`-id3v2_version ${id3v2Version}`);
+  }
   if (metadata.title) {
     metadataArgs.push(`-metadata title="${escapeQuotes(metadata.title)}"`);
   }
@@ -165,13 +181,34 @@ async function writeTrackMetadata(path, metadata, attachedPic) {
       `-metadata publisher="${escapeQuotes(metadata.publisher)}"`
     );
   }
+  metadataArgs.push("-map 0:a -map_metadata 0");
   const ext = extname(path);
   const tmpPath = join(
     tmpdir(),
     `storyteller-platform-audiobook-${randomUUID()}${ext}`
   );
+  const chapterFilePath = join(
+    tmpdir(),
+    `storyteller-platform-audiobook-${randomUUID()}.txt`
+  );
   let picPath = null;
   try {
+    let chapterFileContents = ";FFMETADATA1\n\n";
+    for (const chapter of chapters) {
+      chapterFileContents += `[CHAPTER]
+TIMEBASE=1/1000
+START=${Math.floor(chapter.startTime * 1e3)}
+END=${Math.floor(chapter.endTime * 1e3)}
+`;
+      if (chapter.title) {
+        chapterFileContents += `TITLE=${escapeFfmetadata(chapter.title)}
+`;
+      }
+      chapterFileContents += "\n";
+    }
+    await writeFile(chapterFilePath, chapterFileContents);
+    args.push(`-i ${chapterFilePath}`);
+    metadataArgs.push(`-map_chapters 1`);
     if (attachedPic) {
       const imageExt = attachedPic.mimeType.split("/")[1];
       picPath = join(
@@ -179,9 +216,9 @@ async function writeTrackMetadata(path, metadata, attachedPic) {
         `storyteller-platform-audiobook-${randomUUID()}.${imageExt}`
       );
       await writeFile(picPath, attachedPic.data);
-      args.push(`-i ${quotePath(picPath)}`);
-      args.push(`-map 0:a -map 1:v`);
-      args.push(`-disposition:v:0 attached_pic`);
+      args.push(`-i ${picPath}`);
+      metadataArgs.push(`-map 2:v`);
+      metadataArgs.push(`-disposition:v:0 attached_pic`);
       if (attachedPic.name) {
         metadataArgs.push(
           `-metadata:s:v title="${escapeQuotes(attachedPic.name)}"`

package/dist/index.cjs

@@ -331,6 +331,13 @@ class Audiobook {
     this.metadata.chapters = chapters;
     return chapters;
   }
+  async setChapters(chapters) {
+    if (this.entries.length > 1) {
+      throw new Error("Unable to set chapters for multi-file audiobook");
+    }
+    this.metadata.chapters = chapters;
+    await this.setValue((entry) => entry.setChapters(chapters));
+  }
   async getResources() {
     if (this.metadata.resources) return this.metadata.resources;
     const resources = [];

package/dist/index.d.cts

@@ -55,6 +55,7 @@ declare class Audiobook {
     setReleaseDate(date: Date): Promise<void>;
     getDuration(): Promise<number>;
     getChapters(): Promise<AudiobookChapter[]>;
+    setChapters(chapters: AudiobookChapter[]): Promise<void>;
     getResources(): Promise<AudiobookResource[]>;
     saveAndClose(): Promise<void>;
     discardAndClose(): void;

package/dist/index.d.ts

@@ -55,6 +55,7 @@ declare class Audiobook {
     setReleaseDate(date: Date): Promise<void>;
     getDuration(): Promise<number>;
     getChapters(): Promise<AudiobookChapter[]>;
+    setChapters(chapters: AudiobookChapter[]): Promise<void>;
     getResources(): Promise<AudiobookResource[]>;
     saveAndClose(): Promise<void>;
     discardAndClose(): void;

package/dist/index.js

@@ -245,6 +245,13 @@ class Audiobook {
     this.metadata.chapters = chapters;
     return chapters;
   }
+  async setChapters(chapters) {
+    if (this.entries.length > 1) {
+      throw new Error("Unable to set chapters for multi-file audiobook");
+    }
+    this.metadata.chapters = chapters;
+    await this.setValue((entry) => entry.setChapters(chapters));
+  }
   async getResources() {
     if (this.metadata.resources) return this.metadata.resources;
     const resources = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storyteller-platform/audiobook",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "type": "module",
   "license": "MIT",
   "module": "dist/index.js",