@silverfish-app/sdk 1.0.0

package/dist/index.js

@@ -0,0 +1,329 @@
+import { createClient, createConfig, formDataBodySerializer } from './chunk-IUKKL5SW.js';
+
+// src/client.gen.ts
+var client = createClient(createConfig());
+
+// src/sdk.gen.ts
+var HeyApiClient = class {
+  client;
+  constructor(args) {
+    this.client = args?.client ?? client;
+  }
+};
+var HeyApiRegistry = class {
+  defaultKey = "default";
+  instances = /* @__PURE__ */ new Map();
+  get(key) {
+    const instance = this.instances.get(key ?? this.defaultKey);
+    if (!instance) {
+      throw new Error(`No SDK client found. Create one with "new Sdk()" to fix this error.`);
+    }
+    return instance;
+  }
+  set(value, key) {
+    this.instances.set(key ?? this.defaultKey, value);
+  }
+};
+var Sdk = class _Sdk extends HeyApiClient {
+  static __registry = new HeyApiRegistry();
+  constructor(args) {
+    super(args);
+    _Sdk.__registry.set(this, args?.key);
+  }
+  /**
+   * List Books
+   *
+   * List books, paginated and sorted.
+   *
+   * Returns a page of books controlled by `page` and `page_size`, ordered by
+   * `sort` field in the given `direction`. Out-of-range pagination values are
+   * rejected with `422`.
+   */
+  listBooks(options) {
+    return (options?.client ?? this.client).get({ url: "/books", ...options });
+  }
+  /**
+   * Upload Book
+   *
+   * Upload a book file and create a new book.
+   *
+   * Accepts a multipart `file` whose extension must be one of the allowed
+   * upload formats; metadata is extracted from the file on import. Returns the
+   * created book with `201`, `400` if the file is rejected (unsupported
+   * extension or unreadable content), or `413` if it exceeds the upload size
+   * limit.
+   */
+  uploadBook(options) {
+    return (options.client ?? this.client).post({
+      ...formDataBodySerializer,
+      url: "/books",
+      ...options,
+      headers: {
+        "Content-Type": null,
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * Delete Book
+   *
+   * Delete a book and all of its files.
+   *
+   * Removes the book identified by `book_id` along with its stored formats and
+   * cover, returning `204` with no body on success. Responds with `404` when the
+   * book does not exist.
+   */
+  deleteBook(options) {
+    return (options.client ?? this.client).delete({ url: "/books/{book_id}", ...options });
+  }
+  /**
+   * Get Book
+   *
+   * Get a single book by its public id.
+   *
+   * Looks up the book identified by `book_id` (the book's public id) and returns
+   * its full metadata. Responds with `404` when no such book exists.
+   */
+  getBook(options) {
+    return (options.client ?? this.client).get({ url: "/books/{book_id}", ...options });
+  }
+  /**
+   * Update Book
+   *
+   * Partially update a book's metadata.
+   *
+   * Applies only the fields explicitly set in the request body, leaving omitted
+   * fields untouched, and returns the updated book. Responds with `400` when the
+   * patch is empty or violates a domain rule (e.g. an out-of-range `rating`),
+   * and `404` when the book does not exist.
+   */
+  updateBook(options) {
+    return (options.client ?? this.client).patch({
+      url: "/books/{book_id}",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * Convert Book
+   *
+   * Convert a book to another format.
+   *
+   * Enqueues a background conversion to `target_format`, optionally from an
+   * explicit `source_format` (otherwise the best available source is chosen), and
+   * returns `202` with a job to poll at `/jobs/{id}`. Responds with `404` if the
+   * book is missing, `503` if `ebook-convert` is unavailable, `409` if the target
+   * format already exists or an identical conversion is already in progress, and
+   * `400` if no suitable source format is available.
+   */
+  convertBook(options) {
+    return (options.client ?? this.client).post({
+      url: "/books/{book_id}/convert",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * Get Book Cover
+   *
+   * Download a book's cover image.
+   *
+   * Returns the cover bytes as `image/jpeg` for the book identified by
+   * `book_id`. Responds with `404` when the book has no recorded cover or the
+   * cover file is missing from storage.
+   */
+  getBookCover(options) {
+    return (options.client ?? this.client).get({ url: "/books/{book_id}/cover", ...options });
+  }
+  /**
+   * Delete Book Format
+   *
+   * Delete one format of a book.
+   *
+   * Removes the file for the given `book_format` of the book identified by
+   * `book_id`, returning `204` with no body on success. Responds with `404` when
+   * the book does not exist or it has no such format.
+   */
+  deleteBookFormat(options) {
+    return (options.client ?? this.client).delete({ url: "/books/{book_id}/formats/{book_format}", ...options });
+  }
+  /**
+   * Download Book Format
+   *
+   * Download one format of a book.
+   *
+   * Returns the file for the given `book_format` of the book identified by
+   * `book_id` as an `application/octet-stream` attachment, with the stored
+   * filename in the `Content-Disposition` header. Responds with `404` when the
+   * book lacks that format or the file is missing from storage.
+   */
+  downloadBookFormat(options) {
+    return (options.client ?? this.client).get({ url: "/books/{book_id}/formats/{book_format}", ...options });
+  }
+  /**
+   * Refresh Metadata
+   *
+   * Re-extract metadata from a book file and return the updated book.
+   *
+   * Reads metadata afresh from the book's `source_format` file and merges it in:
+   * fields the extraction produced replace the current ones, fields it could not
+   * read are kept. Responds with `404` when the book or requested format is not
+   * found, and `400` for any other refresh failure.
+   */
+  refreshMetadata(options) {
+    return (options.client ?? this.client).post({
+      url: "/books/{book_id}/refresh-metadata",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * Send Book
+   *
+   * Email a book to a recipient.
+   *
+   * Enqueues a background job to send the book to `to_email` in the requested
+   * `format` (or the best available sendable format if unspecified), and returns
+   * `202` with a job to poll at `/jobs/{id}`. Responds with `404` if the book is
+   * missing, `503` if SMTP is not configured, and `400` if the book has no
+   * matching or sendable format.
+   */
+  sendBook(options) {
+    return (options.client ?? this.client).post({
+      url: "/books/{book_id}/send",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * Get Email Config
+   *
+   * Return the non-secret SMTP settings for display.
+   *
+   * Reports whether SMTP is `configured` along with `host`, `port`,
+   * `from_address` (falling back to the username when no explicit from is set)
+   * and `security`. The password is never read or returned.
+   */
+  getEmailConfig(options) {
+    return (options?.client ?? this.client).get({ url: "/config/email", ...options });
+  }
+  /**
+   * Test Email Config
+   *
+   * Send a test email to verify SMTP connectivity.
+   *
+   * Sends a test message to `to_email` and returns 204 on success. Responds 503
+   * if SMTP is not configured, or 502 if the connection, authentication or send
+   * fails.
+   */
+  testEmailConfig(options) {
+    return (options.client ?? this.client).post({
+      url: "/config/email/test",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * Start Export
+   *
+   * Start an async Calibre export; the download link is emailed when ready.
+   *
+   * Enqueues a background job that snapshots the requested books (or the whole
+   * library when `book_ids` is omitted) to a zip and emails a time-limited link
+   * to `to_email`, returning 202 with the new job. Responds 503 when export is
+   * unavailable (the calibredb binary is missing, SMTP is not configured, or no
+   * public base URL is set for an absolute link), and 400 for a malformed book id.
+   */
+  startExport(options) {
+    return (options.client ?? this.client).post({
+      url: "/export/calibre",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * Download Export
+   *
+   * Stream a finished export zip for a valid, unexpired token.
+   *
+   * Served via ``FileResponse``, which streams the file and honours HTTP Range
+   * requests, so a large download is memory-light and resumable.
+   */
+  downloadExport(options) {
+    return (options.client ?? this.client).get({ url: "/export/download/{token}", ...options });
+  }
+  /**
+   * Health
+   *
+   * Report liveness and the availability of optional dependencies.
+   *
+   * Always returns `status` ``"ok"`` and the API `version`, plus the
+   * Calibre binary availability (`convert_available`, `metadata_available`)
+   * and whether send-to-ereader is usable (`send_available`, true when SMTP
+   * is configured).
+   */
+  health(options) {
+    return (options?.client ?? this.client).get({ url: "/health", ...options });
+  }
+  /**
+   * Get Job
+   *
+   * Return the current status and progress of a single job.
+   *
+   * Looks up the job by `job_id` and returns its latest state for one-shot
+   * polling. Responds 404 if no job with that id exists; use `/jobs/{job_id}/stream`
+   * instead to follow progress live.
+   */
+  getJob(options) {
+    return (options.client ?? this.client).get({ url: "/jobs/{job_id}", ...options });
+  }
+  /**
+   * Stream Job
+   *
+   * Stream a job's status/progress as Server-Sent Events until it finishes.
+   *
+   * One open connection replaces repeated polling. Updates are event-driven: the
+   * stream blocks (in a threadpool, so the event loop stays free) until the job
+   * actually changes, then emits — so it reflects each new binary output, not a
+   * fixed tick.
+   */
+  streamJob(options) {
+    return (options.client ?? this.client).get({ url: "/jobs/{job_id}/stream", ...options });
+  }
+  /**
+   * Search Books
+   *
+   * Search books by a text query and filters.
+   *
+   * Returns a paginated page of books whose title, author, series or tags match
+   * the query `q` (case-insensitive substring match), narrowed by the optional
+   * `include_tags`, `exclude_tags`, `languages`, `formats`, and
+   * `rating_min`/`rating_max` filters. Out-of-range pagination or rating values
+   * are rejected with `422`.
+   */
+  searchBooks(options) {
+    return (options?.client ?? this.client).get({ url: "/search", ...options });
+  }
+};
+
+export { Sdk };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.gen.ts","../src/sdk.gen.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// This file is auto-generated by @hey-api/openapi-ts\n\nimport { type Client, type ClientOptions, type Config, createClient, createConfig } from './client';\nimport type { ClientOptions as ClientOptions2 } from './types.gen';\n\n/**\n * The `createClientConfig()` function will be called on client initialization\n * and the returned object will become the client's initial configuration.\n *\n * You may want to initialize your client this way instead of calling\n * `setConfig()`. This is useful for example if you're using Next.js\n * to ensure your client always has the correct values.\n */\nexport type CreateClientConfig<T extends ClientOptions = ClientOptions2> = (override?: Config<ClientOptions & T>) => Config<Required<ClientOptions> & T>;\n\nexport const client: Client = createClient(createConfig<ClientOptions2>());\n","// This file is auto-generated by @hey-api/openapi-ts\n\nimport { type Client, type ClientMeta, formDataBodySerializer, type Options as Options2, type RequestResult, type TDataShape } from './client';\nimport { client } from './client.gen';\nimport type { ConvertBookData, ConvertBookErrors, ConvertBookResponses, DeleteBookData, DeleteBookErrors, DeleteBookFormatData, DeleteBookFormatErrors, DeleteBookFormatResponses, DeleteBookResponses, DownloadBookFormatData, DownloadBookFormatErrors, DownloadBookFormatResponses, DownloadExportData, DownloadExportErrors, DownloadExportResponses, GetBookCoverData, GetBookCoverErrors, GetBookCoverResponses, GetBookData, GetBookErrors, GetBookResponses, GetEmailConfigData, GetEmailConfigErrors, GetEmailConfigResponses, GetJobData, GetJobErrors, GetJobResponses, HealthData, HealthErrors, HealthResponses, ListBooksData, ListBooksErrors, ListBooksResponses, RefreshMetadataData, RefreshMetadataErrors, RefreshMetadataResponses, SearchBooksData, SearchBooksErrors, SearchBooksResponses, SendBookData, SendBookErrors, SendBookResponses, StartExportData, StartExportErrors, StartExportResponses, StreamJobData, StreamJobErrors, StreamJobResponses, TestEmailConfigData, TestEmailConfigErrors, TestEmailConfigResponses, UpdateBookData, UpdateBookErrors, UpdateBookResponses, UploadBookData, UploadBookErrors, UploadBookResponses } from './types.gen';\n\nexport type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options2<TData, ThrowOnError, TResponse> & {\n    /**\n     * You can provide a client instance returned by `createClient()` instead of\n     * individual options. This might be also useful if you want to implement a\n     * custom client.\n     */\n    client?: Client;\n    /**\n     * You can pass arbitrary values through the `meta` object. This can be\n     * used to access values that aren't defined as part of the SDK function.\n     */\n    meta?: keyof ClientMeta extends never ? Record<string, unknown> : ClientMeta;\n};\n\nclass HeyApiClient {\n    protected client: Client;\n    \n    constructor(args?: {\n        client?: Client;\n    }) {\n        this.client = args?.client ?? client;\n    }\n}\n\nclass HeyApiRegistry<T> {\n    private readonly defaultKey = 'default';\n    \n    private readonly instances: Map<string, T> = new Map();\n    \n    get(key?: string): T {\n        const instance = this.instances.get(key ?? this.defaultKey);\n        if (!instance) {\n            throw new Error(`No SDK client found. Create one with \"new Sdk()\" to fix this error.`);\n        }\n        return instance;\n    }\n    \n    set(value: T, key?: string): void {\n        this.instances.set(key ?? this.defaultKey, value);\n    }\n}\n\nexport class Sdk extends HeyApiClient {\n    public static readonly __registry: HeyApiRegistry<Sdk> = new HeyApiRegistry<Sdk>();\n    \n    constructor(args?: {\n        client?: Client;\n        key?: string;\n    }) {\n        super(args);\n        Sdk.__registry.set(this, args?.key);\n    }\n    \n    /**\n     * List Books\n     *\n     * List books, paginated and sorted.\n     *\n     * Returns a page of books controlled by `page` and `page_size`, ordered by\n     * `sort` field in the given `direction`. Out-of-range pagination values are\n     * rejected with `422`.\n     */\n    public listBooks<ThrowOnError extends boolean = false>(options?: Options<ListBooksData, ThrowOnError>): RequestResult<ListBooksResponses, ListBooksErrors, ThrowOnError> {\n        return (options?.client ?? this.client).get<ListBooksResponses, ListBooksErrors, ThrowOnError>({ url: '/books', ...options });\n    }\n    \n    /**\n     * Upload Book\n     *\n     * Upload a book file and create a new book.\n     *\n     * Accepts a multipart `file` whose extension must be one of the allowed\n     * upload formats; metadata is extracted from the file on import. Returns the\n     * created book with `201`, `400` if the file is rejected (unsupported\n     * extension or unreadable content), or `413` if it exceeds the upload size\n     * limit.\n     */\n    public uploadBook<ThrowOnError extends boolean = false>(options: Options<UploadBookData, ThrowOnError>): RequestResult<UploadBookResponses, UploadBookErrors, ThrowOnError> {\n        return (options.client ?? this.client).post<UploadBookResponses, UploadBookErrors, ThrowOnError>({\n            ...formDataBodySerializer,\n            url: '/books',\n            ...options,\n            headers: {\n                'Content-Type': null,\n                ...options.headers\n            }\n        });\n    }\n    \n    /**\n     * Delete Book\n     *\n     * Delete a book and all of its files.\n     *\n     * Removes the book identified by `book_id` along with its stored formats and\n     * cover, returning `204` with no body on success. Responds with `404` when the\n     * book does not exist.\n     */\n    public deleteBook<ThrowOnError extends boolean = false>(options: Options<DeleteBookData, ThrowOnError>): RequestResult<DeleteBookResponses, DeleteBookErrors, ThrowOnError> {\n        return (options.client ?? this.client).delete<DeleteBookResponses, DeleteBookErrors, ThrowOnError>({ url: '/books/{book_id}', ...options });\n    }\n    \n    /**\n     * Get Book\n     *\n     * Get a single book by its public id.\n     *\n     * Looks up the book identified by `book_id` (the book's public id) and returns\n     * its full metadata. Responds with `404` when no such book exists.\n     */\n    public getBook<ThrowOnError extends boolean = false>(options: Options<GetBookData, ThrowOnError>): RequestResult<GetBookResponses, GetBookErrors, ThrowOnError> {\n        return (options.client ?? this.client).get<GetBookResponses, GetBookErrors, ThrowOnError>({ url: '/books/{book_id}', ...options });\n    }\n    \n    /**\n     * Update Book\n     *\n     * Partially update a book's metadata.\n     *\n     * Applies only the fields explicitly set in the request body, leaving omitted\n     * fields untouched, and returns the updated book. Responds with `400` when the\n     * patch is empty or violates a domain rule (e.g. an out-of-range `rating`),\n     * and `404` when the book does not exist.\n     */\n    public updateBook<ThrowOnError extends boolean = false>(options: Options<UpdateBookData, ThrowOnError>): RequestResult<UpdateBookResponses, UpdateBookErrors, ThrowOnError> {\n        return (options.client ?? this.client).patch<UpdateBookResponses, UpdateBookErrors, ThrowOnError>({\n            url: '/books/{book_id}',\n            ...options,\n            headers: {\n                'Content-Type': 'application/json',\n                ...options.headers\n            }\n        });\n    }\n    \n    /**\n     * Convert Book\n     *\n     * Convert a book to another format.\n     *\n     * Enqueues a background conversion to `target_format`, optionally from an\n     * explicit `source_format` (otherwise the best available source is chosen), and\n     * returns `202` with a job to poll at `/jobs/{id}`. Responds with `404` if the\n     * book is missing, `503` if `ebook-convert` is unavailable, `409` if the target\n     * format already exists or an identical conversion is already in progress, and\n     * `400` if no suitable source format is available.\n     */\n    public convertBook<ThrowOnError extends boolean = false>(options: Options<ConvertBookData, ThrowOnError>): RequestResult<ConvertBookResponses, ConvertBookErrors, ThrowOnError> {\n        return (options.client ?? this.client).post<ConvertBookResponses, ConvertBookErrors, ThrowOnError>({\n            url: '/books/{book_id}/convert',\n            ...options,\n            headers: {\n                'Content-Type': 'application/json',\n                ...options.headers\n            }\n        });\n    }\n    \n    /**\n     * Get Book Cover\n     *\n     * Download a book's cover image.\n     *\n     * Returns the cover bytes as `image/jpeg` for the book identified by\n     * `book_id`. Responds with `404` when the book has no recorded cover or the\n     * cover file is missing from storage.\n     */\n    public getBookCover<ThrowOnError extends boolean = false>(options: Options<GetBookCoverData, ThrowOnError>): RequestResult<GetBookCoverResponses, GetBookCoverErrors, ThrowOnError> {\n        return (options.client ?? this.client).get<GetBookCoverResponses, GetBookCoverErrors, ThrowOnError>({ url: '/books/{book_id}/cover', ...options });\n    }\n    \n    /**\n     * Delete Book Format\n     *\n     * Delete one format of a book.\n     *\n     * Removes the file for the given `book_format` of the book identified by\n     * `book_id`, returning `204` with no body on success. Responds with `404` when\n     * the book does not exist or it has no such format.\n     */\n    public deleteBookFormat<ThrowOnError extends boolean = false>(options: Options<DeleteBookFormatData, ThrowOnError>): RequestResult<DeleteBookFormatResponses, DeleteBookFormatErrors, ThrowOnError> {\n        return (options.client ?? this.client).delete<DeleteBookFormatResponses, DeleteBookFormatErrors, ThrowOnError>({ url: '/books/{book_id}/formats/{book_format}', ...options });\n    }\n    \n    /**\n     * Download Book Format\n     *\n     * Download one format of a book.\n     *\n     * Returns the file for the given `book_format` of the book identified by\n     * `book_id` as an `application/octet-stream` attachment, with the stored\n     * filename in the `Content-Disposition` header. Responds with `404` when the\n     * book lacks that format or the file is missing from storage.\n     */\n    public downloadBookFormat<ThrowOnError extends boolean = false>(options: Options<DownloadBookFormatData, ThrowOnError>): RequestResult<DownloadBookFormatResponses, DownloadBookFormatErrors, ThrowOnError> {\n        return (options.client ?? this.client).get<DownloadBookFormatResponses, DownloadBookFormatErrors, ThrowOnError>({ url: '/books/{book_id}/formats/{book_format}', ...options });\n    }\n    \n    /**\n     * Refresh Metadata\n     *\n     * Re-extract metadata from a book file and return the updated book.\n     *\n     * Reads metadata afresh from the book's `source_format` file and merges it in:\n     * fields the extraction produced replace the current ones, fields it could not\n     * read are kept. Responds with `404` when the book or requested format is not\n     * found, and `400` for any other refresh failure.\n     */\n    public refreshMetadata<ThrowOnError extends boolean = false>(options: Options<RefreshMetadataData, ThrowOnError>): RequestResult<RefreshMetadataResponses, RefreshMetadataErrors, ThrowOnError> {\n        return (options.client ?? this.client).post<RefreshMetadataResponses, RefreshMetadataErrors, ThrowOnError>({\n            url: '/books/{book_id}/refresh-metadata',\n            ...options,\n            headers: {\n                'Content-Type': 'application/json',\n                ...options.headers\n            }\n        });\n    }\n    \n    /**\n     * Send Book\n     *\n     * Email a book to a recipient.\n     *\n     * Enqueues a background job to send the book to `to_email` in the requested\n     * `format` (or the best available sendable format if unspecified), and returns\n     * `202` with a job to poll at `/jobs/{id}`. Responds with `404` if the book is\n     * missing, `503` if SMTP is not configured, and `400` if the book has no\n     * matching or sendable format.\n     */\n    public sendBook<ThrowOnError extends boolean = false>(options: Options<SendBookData, ThrowOnError>): RequestResult<SendBookResponses, SendBookErrors, ThrowOnError> {\n        return (options.client ?? this.client).post<SendBookResponses, SendBookErrors, ThrowOnError>({\n            url: '/books/{book_id}/send',\n            ...options,\n            headers: {\n                'Content-Type': 'application/json',\n                ...options.headers\n            }\n        });\n    }\n    \n    /**\n     * Get Email Config\n     *\n     * Return the non-secret SMTP settings for display.\n     *\n     * Reports whether SMTP is `configured` along with `host`, `port`,\n     * `from_address` (falling back to the username when no explicit from is set)\n     * and `security`. The password is never read or returned.\n     */\n    public getEmailConfig<ThrowOnError extends boolean = false>(options?: Options<GetEmailConfigData, ThrowOnError>): RequestResult<GetEmailConfigResponses, GetEmailConfigErrors, ThrowOnError> {\n        return (options?.client ?? this.client).get<GetEmailConfigResponses, GetEmailConfigErrors, ThrowOnError>({ url: '/config/email', ...options });\n    }\n    \n    /**\n     * Test Email Config\n     *\n     * Send a test email to verify SMTP connectivity.\n     *\n     * Sends a test message to `to_email` and returns 204 on success. Responds 503\n     * if SMTP is not configured, or 502 if the connection, authentication or send\n     * fails.\n     */\n    public testEmailConfig<ThrowOnError extends boolean = false>(options: Options<TestEmailConfigData, ThrowOnError>): RequestResult<TestEmailConfigResponses, TestEmailConfigErrors, ThrowOnError> {\n        return (options.client ?? this.client).post<TestEmailConfigResponses, TestEmailConfigErrors, ThrowOnError>({\n            url: '/config/email/test',\n            ...options,\n            headers: {\n                'Content-Type': 'application/json',\n                ...options.headers\n            }\n        });\n    }\n    \n    /**\n     * Start Export\n     *\n     * Start an async Calibre export; the download link is emailed when ready.\n     *\n     * Enqueues a background job that snapshots the requested books (or the whole\n     * library when `book_ids` is omitted) to a zip and emails a time-limited link\n     * to `to_email`, returning 202 with the new job. Responds 503 when export is\n     * unavailable (the calibredb binary is missing, SMTP is not configured, or no\n     * public base URL is set for an absolute link), and 400 for a malformed book id.\n     */\n    public startExport<ThrowOnError extends boolean = false>(options: Options<StartExportData, ThrowOnError>): RequestResult<StartExportResponses, StartExportErrors, ThrowOnError> {\n        return (options.client ?? this.client).post<StartExportResponses, StartExportErrors, ThrowOnError>({\n            url: '/export/calibre',\n            ...options,\n            headers: {\n                'Content-Type': 'application/json',\n                ...options.headers\n            }\n        });\n    }\n    \n    /**\n     * Download Export\n     *\n     * Stream a finished export zip for a valid, unexpired token.\n     *\n     * Served via ``FileResponse``, which streams the file and honours HTTP Range\n     * requests, so a large download is memory-light and resumable.\n     */\n    public downloadExport<ThrowOnError extends boolean = false>(options: Options<DownloadExportData, ThrowOnError>): RequestResult<DownloadExportResponses, DownloadExportErrors, ThrowOnError> {\n        return (options.client ?? this.client).get<DownloadExportResponses, DownloadExportErrors, ThrowOnError>({ url: '/export/download/{token}', ...options });\n    }\n    \n    /**\n     * Health\n     *\n     * Report liveness and the availability of optional dependencies.\n     *\n     * Always returns `status` ``\"ok\"`` and the API `version`, plus the\n     * Calibre binary availability (`convert_available`, `metadata_available`)\n     * and whether send-to-ereader is usable (`send_available`, true when SMTP\n     * is configured).\n     */\n    public health<ThrowOnError extends boolean = false>(options?: Options<HealthData, ThrowOnError>): RequestResult<HealthResponses, HealthErrors, ThrowOnError> {\n        return (options?.client ?? this.client).get<HealthResponses, HealthErrors, ThrowOnError>({ url: '/health', ...options });\n    }\n    \n    /**\n     * Get Job\n     *\n     * Return the current status and progress of a single job.\n     *\n     * Looks up the job by `job_id` and returns its latest state for one-shot\n     * polling. Responds 404 if no job with that id exists; use `/jobs/{job_id}/stream`\n     * instead to follow progress live.\n     */\n    public getJob<ThrowOnError extends boolean = false>(options: Options<GetJobData, ThrowOnError>): RequestResult<GetJobResponses, GetJobErrors, ThrowOnError> {\n        return (options.client ?? this.client).get<GetJobResponses, GetJobErrors, ThrowOnError>({ url: '/jobs/{job_id}', ...options });\n    }\n    \n    /**\n     * Stream Job\n     *\n     * Stream a job's status/progress as Server-Sent Events until it finishes.\n     *\n     * One open connection replaces repeated polling. Updates are event-driven: the\n     * stream blocks (in a threadpool, so the event loop stays free) until the job\n     * actually changes, then emits — so it reflects each new binary output, not a\n     * fixed tick.\n     */\n    public streamJob<ThrowOnError extends boolean = false>(options: Options<StreamJobData, ThrowOnError>): RequestResult<StreamJobResponses, StreamJobErrors, ThrowOnError> {\n        return (options.client ?? this.client).get<StreamJobResponses, StreamJobErrors, ThrowOnError>({ url: '/jobs/{job_id}/stream', ...options });\n    }\n    \n    /**\n     * Search Books\n     *\n     * Search books by a text query and filters.\n     *\n     * Returns a paginated page of books whose title, author, series or tags match\n     * the query `q` (case-insensitive substring match), narrowed by the optional\n     * `include_tags`, `exclude_tags`, `languages`, `formats`, and\n     * `rating_min`/`rating_max` filters. Out-of-range pagination or rating values\n     * are rejected with `422`.\n     */\n    public searchBooks<ThrowOnError extends boolean = false>(options?: Options<SearchBooksData, ThrowOnError>): RequestResult<SearchBooksResponses, SearchBooksErrors, ThrowOnError> {\n        return (options?.client ?? this.client).get<SearchBooksResponses, SearchBooksErrors, ThrowOnError>({ url: '/search', ...options });\n    }\n}\n"]}