Workflows

import { getSeries, updateSeriesMetadata } from 'komga-sdk';

const listed = await getSeries(
  {
    page: 0,
    size: 50,
    seriesSearch: { fullTextSearch: 'classic' },
  },
  { client },
);

if (listed.error) throw listed.error;

for (const series of listed.data?.content ?? []) {
  const updated = await updateSeriesMetadata(
    {
      seriesId: series.id,
      seriesMetadataUpdateDto: {
        summary: 'Curated collection',
      },
    },
    { client },
  );
  if (updated.error) console.error(series.id, updated.error);
}

import { getBooks, updateBookMetadata } from 'komga-sdk';

const listed = await getBooks(
  {
    page: 0,
    size: 50,
    sort: ['metadata.title,asc'],
    bookSearch: { fullTextSearch: 'classic' },
  },
  { client },
);
if (listed.error) throw listed.error;

const updatedIds: string[] = [];
for (const book of listed.data?.content ?? []) {
  const updated = await updateBookMetadata(
    {
      bookId: book.id,
      bookMetadataUpdateDto: { summary: 'Curated collection' },
    },
    { client },
  );
  if (updated.error) {
    console.error(`Could not update ${book.id}`, updated.error);
  } else {
    updatedIds.push(book.id);
  }
}
console.log(`Updated ${updatedIds.length} books`);

import { getLibraries, libraryScan, getBooks } from 'komga-sdk';

const libraries = await getLibraries({ client });
const library = libraries.data?.[0];
if (!library) throw new Error('No accessible library');

const scan = await libraryScan(
  { libraryId: library.id, deep: false },
  { client },
);
if (scan.error) throw scan.error;
// A scan is accepted asynchronously (HTTP 202); it has no useful data payload.

const books = await getBooks(
  {
    page: 0,
    size: 20,
    sort: ['metadata.releaseDate,desc'],
    bookSearch: {},
  },
  { client },
);
console.log(books.data?.content.map((book) => book.metadata.title) ?? []);

import { getBookThumbnail } from 'komga-sdk';

async function loadThumbnail(bookId: string): Promise<string | undefined> {
  const result = await getBookThumbnail({ bookId }, { client });
  if (result.error || !result.data) return undefined;
  return URL.createObjectURL(result.data);
}

const thumbnailUrl = await loadThumbnail('book-123');
if (thumbnailUrl) console.log(thumbnailUrl);

import { getLibraries, KomgaApiError, unwrap } from 'komga-sdk';

try {
  const libraries = unwrap(await getLibraries({ client }));
  console.log(libraries);
} catch (error) {
  if (error instanceof KomgaApiError) {
    console.error(error.status, error.body);
  } else {
    throw error;
  }
}