Book Content

import { getBookPages } from 'komga-sdk';

const result = await getBookPages({ bookId: 'book-123' }, { client });

if (result.error) {
  console.error('Could not load page metadata', result.error);
} else {
  for (const page of result.data ?? []) {
    console.log(`${page.number}: ${page.width ?? 0}x${page.height ?? 0}`);
  }
}

import { getBookPageByNumber } from 'komga-sdk';

const result = await getBookPageByNumber(
  {
    bookId: 'book-123',
    pageNumber: 5,
    convert: 'jpeg',
  },
  { client },
);

if (result.error) {
  console.error('Page request failed', result.error);
} else if (result.data) {
  const imageUrl = URL.createObjectURL(result.data);
  // Display imageUrl, then revoke it when the image is no longer needed.
}

import { getBookPageRawByNumber } from 'komga-sdk';

const result = await getBookPageRawByNumber(
  { bookId: 'book-123', pageNumber: 5 },
  { client },
);

if (result.error) {
  console.error('Raw page request failed', result.error);
} else if (result.data) {
  console.log('Raw page payload:', result.data);
}

import { getBookPageThumbnailByNumber } from 'komga-sdk';

const result = await getBookPageThumbnailByNumber(
  { bookId: 'book-123', pageNumber: 5 },
  { client },
);

if (result.error) {
  console.error('Page thumbnail request failed', result.error);
} else if (result.data) {
  const thumbnailUrl = URL.createObjectURL(result.data);
}

import {
  getBookPositions,
  getBookProgression,
  updateBookProgression,
} from 'komga-sdk';

const positions = await getBookPositions({ bookId: 'book-123' }, { client });
if (positions.error) throw positions.error;
console.log(`${positions.data?.total ?? 0} EPUB positions`);

const progression = await getBookProgression({ bookId: 'book-123' }, { client });
if (progression.error) throw progression.error;
if (progression.data) {
  console.log(progression.data.locator.href);
}

const saved = await updateBookProgression(
  {
    bookId: 'book-123',
    r2Progression: {
      device: { id: 'web-reader', name: 'Web reader' },
      locator: {
        href: 'OEBPS/chapter-2.xhtml',
        type: 'application/xhtml+xml',
        locations: { progression: 0.42 },
      },
      modified: new Date().toISOString(),
    },
  },
  { client },
);
if (saved.error) console.error('Could not save EPUB progression', saved.error);

import { getBookThumbnail } from 'komga-sdk';

const result = await getBookThumbnail({ bookId: 'book-123' }, { client });

if (result.error) {
  console.error('Book thumbnail request failed', result.error);
} else if (result.data) {
  const thumbnailUrl = URL.createObjectURL(result.data);
}

import { getBookThumbnails } from 'komga-sdk';

const result = await getBookThumbnails({ bookId: 'book-123' }, { client });

if (result.error) {
  console.error('Could not list thumbnails', result.error);
} else {
  for (const thumbnail of result.data ?? []) {
    console.log(`${thumbnail.id}: ${thumbnail.selected ? 'selected' : 'available'}`);
  }
}

import { getBookThumbnailById } from 'komga-sdk';

const result = await getBookThumbnailById(
  { bookId: 'book-123', thumbnailId: 'thumb-456' },
  { client },
);

if (result.error) {
  console.error('Thumbnail request failed', result.error);
} else if (result.data) {
  const thumbnailUrl = URL.createObjectURL(result.data);
}

import { addUserUploadedBookThumbnail } from 'komga-sdk';

const file = new File([imageBlob], 'custom-thumb.jpg', { type: 'image/jpeg' });
const result = await addUserUploadedBookThumbnail(
  { bookId: 'book-123', file, selected: true },
  { client },
);

if (result.error) {
  console.error('Thumbnail upload failed', result.error);
} else if (result.data) {
  console.log(`Uploaded thumbnail: ${result.data.id}`);
}

import { deleteUserUploadedBookThumbnail } from 'komga-sdk';

const result = await deleteUserUploadedBookThumbnail(
  { bookId: 'book-123', thumbnailId: 'thumb-456' },
  { client },
);

if (result.error) {
  console.error('Thumbnail deletion failed', result.error);
} else {
  console.log('Thumbnail deleted');
}

import { markBookThumbnailSelected } from 'komga-sdk';

const result = await markBookThumbnailSelected(
  { bookId: 'book-123', thumbnailId: 'thumb-456' },
  { client },
);

if (result.error) {
  console.error('Could not select thumbnail', result.error);
} else {
  console.log('Thumbnail selected');
}

import {
  getBookWebPubManifest,
  getBookWebPubManifestDivina,
  getBookWebPubManifestEpub,
  getBookWebPubManifestPdf,
} from 'komga-sdk';

const generic = await getBookWebPubManifest({ bookId: 'book-123' }, { client });
const divina = await getBookWebPubManifestDivina({ bookId: 'book-123' }, { client });
const epub = await getBookWebPubManifestEpub({ bookId: 'book-123' }, { client });
const pdf = await getBookWebPubManifestPdf({ bookId: 'book-123' }, { client });

for (const [name, result] of Object.entries({ generic, divina, epub, pdf })) {
  if (result.error) {
    console.error(`${name} manifest failed`, result.error);
  } else if (result.data) {
    console.log(`${name} manifest loaded`, result.data);
  }
}

import { getBookEpubResource } from 'komga-sdk';

const result = await getBookEpubResource(
  { bookId: 'book-123', resource: 'OEBPS/images/cover.jpg' },
  { client },
);

if (result.error) {
  console.error('EPUB resource request failed', result.error);
} else if (result.data) {
  console.log(result.data);
}

import { getBookPages, getBookPageByNumber } from 'komga-sdk';

async function createPageViewer(bookId: string) {
  const pagesResult = await getBookPages({ bookId }, { client });
  if (pagesResult.error) throw pagesResult.error;

  const pages = pagesResult.data ?? [];
  let currentPage = 1;

  async function showPage(pageNum: number) {
    if (pageNum < 1 || pageNum > pages.length) return;

    const result = await getBookPageByNumber(
      { bookId, pageNumber: pageNum },
      { client },
    );
    if (result.error) throw result.error;
    if (!result.data) return;

    const imageUrl = URL.createObjectURL(result.data);
    // Display imageUrl in your viewer.
    currentPage = pageNum;
  }

  return {
    showPage,
    nextPage: () => showPage(currentPage + 1),
    prevPage: () => showPage(currentPage - 1),
    totalPages: pages.length,
  };
}

import { getBookThumbnails, getBookThumbnailById } from 'komga-sdk';

async function createThumbnailGallery(bookId: string) {
  const result = await getBookThumbnails({ bookId }, { client });
  if (result.error) throw result.error;

  const thumbnails = [];
  for (const thumbnail of result.data ?? []) {
    const thumbnailResult = await getBookThumbnailById(
      { bookId, thumbnailId: thumbnail.id },
      { client },
    );
    if (thumbnailResult.error) throw thumbnailResult.error;
    if (thumbnailResult.data) {
      thumbnails.push({
        id: thumbnail.id,
        url: URL.createObjectURL(thumbnailResult.data),
        selected: thumbnail.selected,
      });
    }
  }

  return thumbnails;
}

import { getBookWebPubManifest } from 'komga-sdk';

async function loadWebPubReader(bookId: string) {
  const result = await getBookWebPubManifest({ bookId }, { client });
  if (result.error) throw result.error;
  if (!result.data) return;

  // Pass the publication data to a WebPub-compatible reader.
  return result.data;
}