@redseat/api 0.4.5 → 0.5.0

package/dist/interfaces.d.ts

@@ -202,6 +202,7 @@ export interface ServerLibraryForUpdate {
     settings?: ServerLibrarySettings;
     credentials?: string;
     plugin?: string;
+    password?: string;
 }
 export interface ILibrary {
     id?: string;
@@ -216,6 +217,7 @@ export interface ILibrary {
     plugin?: string;
     hidden?: boolean;
     status?: string;
+    password?: string;
 }
 export interface ITag {
     id: string;
@@ -451,6 +453,7 @@ export interface ExternalImage {
     voteAverage?: number;
     voteCount?: number;
     width?: number;
+    matchType?: RsLookupMatchType;
 }
 export interface Relations {
     peopleDetails?: IPerson[];
@@ -478,6 +481,7 @@ export interface SearchRelations {
 export interface SearchStreamResultBase {
     relations?: SearchRelations;
     images?: ExternalImage[];
+    matchType?: RsLookupMatchType;
 }
 export type SearchStreamResult<K extends string, T> = SearchStreamResultBase & {
     metadata?: Partial<Record<K, T>>;
@@ -490,9 +494,15 @@ export type BookSearchStreamResult = SearchStreamResult<'book', IBook>;
 export type MovieSearchStreamResult = SearchStreamResult<'movie', IMovie>;
 export type SerieSearchStreamResult = SearchStreamResult<'serie', ISerie>;
 export type LookupSearchStreamResult = SearchStreamResult<'book' | 'movie' | 'serie', IBook | IMovie | ISerie>;
-export type GroupedSearchStreamPayload<T> = Record<string, T[]>;
+export type RsLookupMatchType = 'exactId' | 'exactText';
+export interface SseSearchStreamEvent<T> {
+    sourceId: string;
+    sourceName: string;
+    results: T[];
+    nextPageKey?: string | null;
+}
 export interface SearchStreamCallbacks<T> {
-    onResults?: (results: GroupedSearchStreamPayload<T>) => void;
+    onResults?: (event: SseSearchStreamEvent<T>) => void;
     onFinished?: () => void;
     onError?: (error: unknown) => void;
 }
@@ -927,6 +937,7 @@ export interface RsGroupDownload {
     groupMime?: string;
     requests: RsRequest[];
     infos?: MediaForUpdate;
+    matchType?: RsLookupMatchType;
 }
 /**
  * Request processing status from plugin-based download/processing.

package/dist/library.d.ts

@@ -1,6 +1,6 @@
 import { Observable } from 'rxjs';
 import type { AxiosResponse } from 'axios';
-import { IFile, ITag, IPerson, ISerie, IMovie, IBook, MediaRequest, IEpisode, ExternalImage, IBackupFile, ILibrary, DeletedQuery, RsDeleted, MovieSort, BookSort, RsSort, SqlOrder, RsRequest, DetectedFaceResult, UnassignFaceResponse, RsGroupDownload, IViewProgress, IWatched, IRsRequestProcessing, BookSearchStreamResult, MovieSearchStreamResult, SerieSearchStreamResult, BookSearchResult, MovieSearchResult, SerieSearchResult, ItemWithRelations, SearchStreamCallbacks, MediaForUpdate, IChannelUpdate } from './interfaces.js';
+import { IFile, ITag, IPerson, ISerie, IMovie, IBook, MediaRequest, IEpisode, ExternalImage, IBackupFile, ILibrary, DeletedQuery, RsDeleted, MovieSort, BookSort, RsSort, SqlOrder, RsRequest, DetectedFaceResult, UnassignFaceResponse, RsGroupDownload, IViewProgress, IWatched, IRsRequestProcessing, BookSearchStreamResult, MovieSearchStreamResult, SerieSearchStreamResult, LookupSearchStreamResult, BookSearchResult, MovieSearchResult, SerieSearchResult, ItemWithRelations, SearchStreamCallbacks, MediaForUpdate, IChannelUpdate } from './interfaces.js';
 import { SSEMediasEvent, SSEUploadProgressEvent, SSEConvertProgressEvent, SSEEpisodesEvent, SSESeriesEvent, SSEMoviesEvent, SSEBooksEvent, SSEPeopleEvent, SSETagsEvent, SSELibraryStatusEvent, SSEMediaRatingEvent, SSEMediaProgressEvent, SSERequestProcessingEvent } from './sse-types.js';
 import { EncryptFileOptions, EncryptedFile } from './encryption.js';
 export interface LibraryHttpClient {
@@ -78,6 +78,10 @@ export declare class LibraryApi {
     setKey(passPhrase: string): Promise<void>;
     private getUrl;
     private openSearchStream;
+    searchAllStream(name: string, callbacks: SearchStreamCallbacks<LookupSearchStreamResult>, options?: {
+        source?: string[];
+        pageKey?: string;
+    }): () => void;
     getTags(query?: {
         name?: string;
         parent?: string;
@@ -127,6 +131,8 @@ export declare class LibraryApi {
     tagMerge(fromId: string, intoId: string): Promise<ITag>;
     tagAddAlt(tagId: string, alt: string): Promise<ITag>;
     tagRemoveAlt(tagId: string, alt: string): Promise<ITag>;
+    tagAddOtherId(tagId: string, otherId: string): Promise<ITag>;
+    tagRemoveOtherId(tagId: string, otherId: string): Promise<ITag>;
     mediaTransfer(formData: FormData): Promise<void>;
     mediaTransferMany(medias: string[], deleteOriginal: boolean, toLibraryId: string): Promise<void>;
     mediaTransferSingle(mediaId: string, toLibraryId: string, formData: FormData, params?: Map<string, string>): Promise<void>;
@@ -158,7 +164,10 @@ export declare class LibraryApi {
     getMovieProgress(movieId: string): Promise<IViewProgress>;
     setMovieProgress(movieId: string, progress: number): Promise<void>;
     searchMovies(name: string): Promise<MovieSearchResult[]>;
-    searchMoviesStream(name: string, callbacks: SearchStreamCallbacks<MovieSearchStreamResult>): () => void;
+    searchMoviesStream(name: string, callbacks: SearchStreamCallbacks<MovieSearchStreamResult>, options?: {
+        source?: string[];
+        pageKey?: string;
+    }): () => void;
     movieRename(movieId: string, newName: string): Promise<IMovie>;
     updateMoviePoster(movieId: string, poster: FormData, type: string): Promise<void>;
     updateMovieImageFetch(movieId: string, image: ExternalImage): Promise<void>;
@@ -178,7 +187,10 @@ export declare class LibraryApi {
     removeBook(bookId: string): Promise<void>;
     updateBook(bookId: string, updates: Partial<IBook>): Promise<IBook>;
     searchBooks(name: string): Promise<BookSearchResult[]>;
-    searchBooksStream(name: string, callbacks: SearchStreamCallbacks<BookSearchStreamResult>): () => void;
+    searchBooksStream(name: string, callbacks: SearchStreamCallbacks<BookSearchStreamResult>, options?: {
+        source?: string[];
+        pageKey?: string;
+    }): () => void;
     bookRename(bookId: string, newName: string): Promise<IBook>;
     getBookImages(bookId: string): Promise<ExternalImage[]>;
     updateBookPoster(bookId: string, poster: FormData): Promise<void>;
@@ -193,12 +205,17 @@ export declare class LibraryApi {
     personRemoveAlt(personId: string, alt: string): Promise<IPerson>;
     personAddSocial(personId: string, social: any): Promise<IPerson>;
     personRemoveSocial(personId: string, social: any): Promise<IPerson>;
+    personAddOtherId(personId: string, otherId: string): Promise<IPerson>;
+    personRemoveOtherId(personId: string, otherId: string): Promise<IPerson>;
     serieRename(serieId: string, newName: string): Promise<ISerie>;
     serieAddAlt(serieId: string, alt: string): Promise<ISerie>;
     serieRemoveAlt(serieId: string, alt: string): Promise<ISerie>;
     updatePersonPortrait(personId: string, portrait: FormData): Promise<void>;
     searchSeries(name: string): Promise<SerieSearchResult[]>;
-    searchSeriesStream(name: string, callbacks: SearchStreamCallbacks<SerieSearchStreamResult>): () => void;
+    searchSeriesStream(name: string, callbacks: SearchStreamCallbacks<SerieSearchStreamResult>, options?: {
+        source?: string[];
+        pageKey?: string;
+    }): () => void;
     setEpisodeWatched(serieId: string, season: number, number: number, date: number): Promise<void>;
     getEpisodeWatched(serieId: string, season: number, episode: number): Promise<IWatched>;
     getEpisodeProgress(serieId: string, season: number, episode: number): Promise<IViewProgress>;
@@ -287,6 +304,14 @@ export declare class LibraryApi {
      * @returns Raw axios response with stream data - use response.data for the stream
      */
     processRequestStream(request: RsRequest): Promise<AxiosResponse>;
+    /**
+     * Process a request and return the response as a Blob.
+     * Use this in environments where ReadableStream is not supported (e.g. React Native).
+     * Same endpoint as processRequestStream but with responseType 'blob'.
+     * @param request - The request to process and retrieve as a blob
+     * @returns The response blob (e.g. image data)
+     */
+    processRequestBlob(request: RsRequest): Promise<Blob>;
     /**
      * Add a request to the processing queue.
      * @param request - The request to add for processing

package/dist/library.js

@@ -124,6 +124,14 @@ export class LibraryApi {
             }
         }, finish, (error) => callbacks.onError?.(error));
     }
+    searchAllStream(name, callbacks, options) {
+        const params = { name };
+        if (options?.source?.length)
+            params.source = options.source.join(',');
+        if (options?.pageKey)
+            params.pageKey = options.pageKey;
+        return this.openSearchStream(this.getUrl('/searchstream'), params, callbacks);
+    }
     async getTags(query) {
         const params = {};
         if (query) {
@@ -295,6 +303,14 @@ export class LibraryApi {
         const res = await this.client.patch(this.getUrl(`/tags/${tagId}`), { removeAlts: [alt] });
         return res.data;
     }
+    async tagAddOtherId(tagId, otherId) {
+        const res = await this.client.patch(this.getUrl(`/tags/${tagId}`), { addOtherids: [otherId] });
+        return res.data;
+    }
+    async tagRemoveOtherId(tagId, otherId) {
+        const res = await this.client.patch(this.getUrl(`/tags/${tagId}`), { removeOtherids: [otherId] });
+        return res.data;
+    }
     async mediaTransfer(formData) {
         await this.client.put(this.getUrl('/medias/transfert'), formData);
     }
@@ -417,8 +433,13 @@ export class LibraryApi {
         const res = await this.client.get(this.getUrl(`/movies/search?name=${name}`));
         return res.data;
     }
-    searchMoviesStream(name, callbacks) {
-        return this.openSearchStream(this.getUrl('/movies/searchstream'), { name }, callbacks);
+    searchMoviesStream(name, callbacks, options) {
+        const params = { name };
+        if (options?.source?.length)
+            params.source = options.source.join(',');
+        if (options?.pageKey)
+            params.pageKey = options.pageKey;
+        return this.openSearchStream(this.getUrl('/movies/searchstream'), params, callbacks);
     }
     async movieRename(movieId, newName) {
         const res = await this.client.patch(this.getUrl(`/movies/${movieId}`), {
@@ -485,8 +506,13 @@ export class LibraryApi {
         const res = await this.client.get(this.getUrl(`/books/search?name=${name}`));
         return res.data;
     }
-    searchBooksStream(name, callbacks) {
-        return this.openSearchStream(this.getUrl('/books/searchstream'), { name }, callbacks);
+    searchBooksStream(name, callbacks, options) {
+        const params = { name };
+        if (options?.source?.length)
+            params.source = options.source.join(',');
+        if (options?.pageKey)
+            params.pageKey = options.pageKey;
+        return this.openSearchStream(this.getUrl('/books/searchstream'), params, callbacks);
     }
     async bookRename(bookId, newName) {
         const res = await this.client.patch(this.getUrl(`/books/${bookId}`), {
@@ -552,6 +578,18 @@ export class LibraryApi {
         });
         return res.data;
     }
+    async personAddOtherId(personId, otherId) {
+        const res = await this.client.patch(this.getUrl(`/people/${personId}`), {
+            addOtherids: [otherId]
+        });
+        return res.data;
+    }
+    async personRemoveOtherId(personId, otherId) {
+        const res = await this.client.patch(this.getUrl(`/people/${personId}`), {
+            removeOtherids: [otherId]
+        });
+        return res.data;
+    }
     async serieRename(serieId, newName) {
         const res = await this.client.patch(this.getUrl(`/series/${serieId}`), {
             name: newName
@@ -577,8 +615,13 @@ export class LibraryApi {
         const res = await this.client.get(this.getUrl(`/series/search?name=${name}`));
         return res.data;
     }
-    searchSeriesStream(name, callbacks) {
-        return this.openSearchStream(this.getUrl('/series/searchstream'), { name }, callbacks);
+    searchSeriesStream(name, callbacks, options) {
+        const params = { name };
+        if (options?.source?.length)
+            params.source = options.source.join(',');
+        if (options?.pageKey)
+            params.pageKey = options.pageKey;
+        return this.openSearchStream(this.getUrl('/series/searchstream'), params, callbacks);
     }
     async setEpisodeWatched(serieId, season, number, date) {
         await this.client.post(this.getUrl(`/series/${serieId}/seasons/${season}/episodes/${number}/watched`), { date });
@@ -708,6 +751,17 @@ export class LibraryApi {
     async processRequestStream(request) {
         return this.client.post(this.getUrl('/plugins/requests/process/stream'), request, { responseType: 'stream' });
     }
+    /**
+     * Process a request and return the response as a Blob.
+     * Use this in environments where ReadableStream is not supported (e.g. React Native).
+     * Same endpoint as processRequestStream but with responseType 'blob'.
+     * @param request - The request to process and retrieve as a blob
+     * @returns The response blob (e.g. image data)
+     */
+    async processRequestBlob(request) {
+        const res = await this.client.post(this.getUrl('/plugins/requests/process/stream'), request, { responseType: 'blob' });
+        return res.data;
+    }
     /**
      * Add a request to the processing queue.
      * @param request - The request to add for processing

package/dist/server.d.ts

@@ -15,7 +15,10 @@ export declare class ServerApi {
     updateLibrary(libraryId: string, library: ServerLibraryForUpdate): Promise<ILibrary>;
     deleteLibrary(libraryId: string, deleteMediaContent?: boolean): Promise<void>;
     getPlugins(): Promise<IPlugin[]>;
-    searchLookupStream(query: string, type: string, callbacks: SearchStreamCallbacks<LookupSearchStreamResult>): () => void;
+    searchLookupStream(query: string, type: string, callbacks: SearchStreamCallbacks<LookupSearchStreamResult>, options?: {
+        source?: string[];
+        pageKey?: string;
+    }): () => void;
     getCredentials(): Promise<ICredential[]>;
     saveCredential(credential: ICredential): Promise<ICredential>;
     updateCredential(credential: ICredential): Promise<ICredential>;

package/dist/server.js

@@ -73,8 +73,13 @@ export class ServerApi {
         const res = await this.client.get('/plugins');
         return res.data;
     }
-    searchLookupStream(query, type, callbacks) {
-        return this.openSearchStream('/plugins/lookup/searchstream', { q: query, type }, callbacks);
+    searchLookupStream(query, type, callbacks, options) {
+        const params = { q: query, type };
+        if (options?.source?.length)
+            params.source = options.source.join(',');
+        if (options?.pageKey)
+            params.pageKey = options.pageKey;
+        return this.openSearchStream('/plugins/lookup/searchstream', params, callbacks);
     }
     async getCredentials() {
         const res = await this.client.get('/credentials');

package/dist/sse-fetch.d.ts

@@ -10,6 +10,7 @@ export interface RawSSEEvent {
 /**
  * Parses a raw SSE buffer into discrete events, returning any incomplete trailing data.
  * Follows the SSE spec: events are separated by blank lines, fields are `field: value`.
+ * Handles \r\n, \r, and \n line endings per the SSE specification.
  */
 export declare function parseSSEBuffer(buffer: string): {
     events: RawSSEEvent[];

package/dist/sse-fetch.js

@@ -1,58 +1,60 @@
 /**
  * Parses a raw SSE buffer into discrete events, returning any incomplete trailing data.
  * Follows the SSE spec: events are separated by blank lines, fields are `field: value`.
+ * Handles \r\n, \r, and \n line endings per the SSE specification.
  */
 export function parseSSEBuffer(buffer) {
     const events = [];
-    const lines = buffer.split('\n');
-    let processedUpTo = 0;
-    let eventType = '';
-    let eventData = '';
-    let eventId;
-    let eventRetry;
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        // Incomplete last line — keep in buffer
-        if (i === lines.length - 1 && !buffer.endsWith('\n')) {
+    const normalised = buffer.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    // Split into blocks separated by blank lines (\n\n).
+    // Only complete blocks (followed by \n\n) are processed;
+    // any trailing incomplete block stays in the buffer.
+    let lastEventEnd = 0;
+    const blockBoundary = '\n\n';
+    let searchFrom = 0;
+    while (true) {
+        const idx = normalised.indexOf(blockBoundary, searchFrom);
+        if (idx === -1)
             break;
-        }
-        processedUpTo += line.length + 1; // +1 for '\n'
-        if (line === '') {
-            // Blank line = end of event
-            if (eventType) {
-                events.push({ event: eventType, data: eventData, id: eventId, retry: eventRetry });
+        const block = normalised.slice(lastEventEnd, idx);
+        lastEventEnd = idx + blockBoundary.length;
+        searchFrom = lastEventEnd;
+        let eventType = '';
+        let eventData = '';
+        let eventId;
+        let eventRetry;
+        for (const line of block.split('\n')) {
+            if (line === '' || line.startsWith(':'))
+                continue;
+            const colonIdx = line.indexOf(':');
+            if (colonIdx === -1)
+                continue;
+            const field = line.slice(0, colonIdx);
+            let value = line.slice(colonIdx + 1);
+            if (value.startsWith(' '))
+                value = value.slice(1);
+            switch (field) {
+                case 'event':
+                    eventType = value;
+                    break;
+                case 'data':
+                    eventData = eventData ? eventData + '\n' + value : value;
+                    break;
+                case 'id':
+                    eventId = value;
+                    break;
+                case 'retry':
+                    eventRetry = parseInt(value, 10);
+                    break;
             }
-            eventType = '';
-            eventData = '';
-            eventId = undefined;
-            eventRetry = undefined;
-            continue;
         }
-        if (line.startsWith(':'))
-            continue; // SSE comment
-        const colonIdx = line.indexOf(':');
-        if (colonIdx === -1)
-            continue;
-        const field = line.slice(0, colonIdx);
-        let value = line.slice(colonIdx + 1);
-        if (value.startsWith(' '))
-            value = value.slice(1);
-        switch (field) {
-            case 'event':
-                eventType = value;
-                break;
-            case 'data':
-                eventData = eventData ? eventData + '\n' + value : value;
-                break;
-            case 'id':
-                eventId = value;
-                break;
-            case 'retry':
-                eventRetry = parseInt(value, 10);
-                break;
+        if (eventType) {
+            events.push({ event: eventType, data: eventData, id: eventId, retry: eventRetry });
         }
     }
-    return { events, remainingBuffer: buffer.slice(processedUpTo) };
+    // Note: remainingBuffer is from the normalised string. Callers must replace
+    // their buffer entirely (not use offset-based splicing on the original input).
+    return { events, remainingBuffer: normalised.slice(lastEventEnd) };
 }
 /**
  * Opens a one-shot fetch-based SSE stream (no reconnection).
@@ -87,6 +89,14 @@ export function openFetchSSEStream(url, onEvent, onDone, onError) {
             while (true) {
                 const { done, value } = await reader.read();
                 if (done) {
+                    // Flush any remaining buffered event when the stream closes
+                    // (server may close without a trailing blank line)
+                    if (buffer.trim()) {
+                        const { events: finalEvents } = parseSSEBuffer(buffer + '\n\n');
+                        for (const event of finalEvents) {
+                            onEvent(event.event, event.data);
+                        }
+                    }
                     onDone?.();
                     break;
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@redseat/api",
-    "version": "0.4.5",
+    "version": "0.5.0",
     "description": "TypeScript API client library for interacting with Redseat servers",
     "type": "module",
     "main": "./dist/index.js",