@redseat/api 0.3.5 → 0.3.7

package/libraries.md

@@ -899,12 +899,19 @@ const results = await libraryApi.searchSeries('Breaking');
 
 Marks an episode as watched.
 
+**How it works:** This method uses the local series/episode IDs from the library. The server automatically resolves these to external IDs (IMDb, Trakt, etc.) and stores the watch entry in the **global history** system. This means:
+- Watch status syncs across different servers
+- Watch status is accessible via `ServerApi.getHistory()`
+- External services can sync with your watch history
+
+See [server.md - Watch History API](server.md#watch-history-api) for details on the global history system.
+
 **Parameters:**
 
-- `serieId`: The ID of the series
+- `serieId`: The ID of the series (local library ID)
 - `season`: Season number
 - `number`: Episode number
-- `date`: Timestamp of when it was watched
+- `date`: Timestamp of when it was watched (unix milliseconds)
 
 **Example:**
 
@@ -912,6 +919,73 @@ Marks an episode as watched.
 await libraryApi.setEpisodeWatched('serie-id', 1, 1, Date.now());
 ```
 
+### `getEpisodeWatched(serieId: string, season: number, episode: number): Promise<IWatched>`
+
+Gets the watched status for an episode.
+
+**Parameters:**
+
+- `serieId`: The ID of the series (local library ID)
+- `season`: Season number
+- `episode`: Episode number
+
+**Returns:** Promise resolving to an `IWatched` object containing:
+- `type`: Always `'episode'`
+- `id`: External ID in format `provider:value` (e.g., `imdb:tt0959621`)
+- `date`: Timestamp when watched
+- `modified`: Timestamp when entry was modified
+
+**Example:**
+
+```typescript
+const watched = await libraryApi.getEpisodeWatched('serie-id', 1, 1);
+console.log(`Watched on: ${new Date(watched.date).toLocaleDateString()}`);
+console.log(`External ID: ${watched.id}`); // e.g., "imdb:tt0959621"
+```
+
+### `getEpisodeProgress(serieId: string, season: number, episode: number): Promise<IViewProgress>`
+
+Gets the view progress for an episode. Progress is stored in the global history system.
+
+**Parameters:**
+
+- `serieId`: The ID of the series (local library ID)
+- `season`: Season number
+- `episode`: Episode number
+
+**Returns:** Promise resolving to an `IViewProgress` object containing:
+- `type`: Always `'episode'`
+- `id`: External ID in format `provider:value`
+- `progress`: Playback position in milliseconds
+- `parent`: Series external ID (if available)
+- `modified`: Timestamp when progress was last updated
+
+**Example:**
+
+```typescript
+const progress = await libraryApi.getEpisodeProgress('serie-id', 1, 1);
+console.log(`Progress: ${progress.progress}ms`);
+console.log(`Episode ID: ${progress.id}`);
+```
+
+### `setEpisodeProgress(serieId: string, season: number, episode: number, progress: number): Promise<void>`
+
+Sets the view progress for an episode. Progress is stored in the global history system using external IDs.
+
+**Parameters:**
+
+- `serieId`: The ID of the series (local library ID)
+- `season`: Season number
+- `episode`: Episode number
+- `progress`: Progress value in milliseconds (video playback position)
+
+**Example:**
+
+```typescript
+// Save progress at 30 minutes
+await libraryApi.setEpisodeProgress('serie-id', 1, 1, 1800000);
+```
+
 ---
 
 ## Movies
@@ -1023,10 +1097,17 @@ const images = await libraryApi.getMovieImages('movie-id');
 
 Marks a movie as watched.
 
+**How it works:** This method uses the local movie ID from the library. The server automatically resolves this to an external ID (IMDb, Trakt, TMDb, etc.) and stores the watch entry in the **global history** system. This means:
+- Watch status syncs across different servers
+- Watch status is accessible via `ServerApi.getHistory()`
+- External services can sync with your watch history
+
+See [server.md - Watch History API](server.md#watch-history-api) for details on the global history system.
+
 **Parameters:**
 
-- `movieId`: The ID of the movie
-- `date`: Timestamp of when it was watched
+- `movieId`: The ID of the movie (local library ID)
+- `date`: Timestamp of when it was watched (unix milliseconds)
 
 **Example:**
 
@@ -1034,6 +1115,66 @@ Marks a movie as watched.
 await libraryApi.setMovieWatched('movie-id', Date.now());
 ```
 
+### `getMovieWatched(movieId: string): Promise<IWatched>`
+
+Gets the watched status for a movie.
+
+**Parameters:**
+
+- `movieId`: The ID of the movie (local library ID)
+
+**Returns:** Promise resolving to an `IWatched` object containing:
+- `type`: Always `'movie'`
+- `id`: External ID in format `provider:value` (e.g., `imdb:tt0111161`)
+- `date`: Timestamp when watched
+- `modified`: Timestamp when entry was modified
+
+**Example:**
+
+```typescript
+const watched = await libraryApi.getMovieWatched('movie-id');
+console.log(`Watched on: ${new Date(watched.date).toLocaleDateString()}`);
+console.log(`External ID: ${watched.id}`); // e.g., "imdb:tt0111161"
+```
+
+### `getMovieProgress(movieId: string): Promise<IViewProgress>`
+
+Gets the view progress for a movie. Progress is stored in the global history system.
+
+**Parameters:**
+
+- `movieId`: The ID of the movie (local library ID)
+
+**Returns:** Promise resolving to an `IViewProgress` object containing:
+- `type`: Always `'movie'`
+- `id`: External ID in format `provider:value`
+- `progress`: Playback position in milliseconds
+- `modified`: Timestamp when progress was last updated
+
+**Example:**
+
+```typescript
+const progress = await libraryApi.getMovieProgress('movie-id');
+console.log(`Progress: ${progress.progress}ms`);
+console.log(`External ID: ${progress.id}`);
+```
+
+### `setMovieProgress(movieId: string, progress: number): Promise<void>`
+
+Sets the view progress for a movie. Progress is stored in the global history system using external IDs.
+
+**Parameters:**
+
+- `movieId`: The ID of the movie (local library ID)
+- `progress`: Progress value in milliseconds (video playback position)
+
+**Example:**
+
+```typescript
+// Save progress at 45 minutes
+await libraryApi.setMovieProgress('movie-id', 2700000);
+```
+
 ### `searchMovies(name: string): Promise<IMovie[]>`
 
 Searches for movies by name.

package/package.json

@@ -1,50 +1,50 @@
-{
-    "name": "@redseat/api",
-    "version": "0.3.5",
-    "description": "TypeScript API client library for interacting with Redseat servers",
-    "type": "module",
-    "main": "./dist/index.js",
-    "module": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "exports": {
-        ".": {
-            "import": "./dist/index.js",
-            "types": "./dist/index.d.ts"
-        }
-    },
-    "files": [
-        "dist/**/*",
-        "README.md",
-        "*.md"
-    ],
-    "keywords": [
-        "redseat",
-        "api",
-        "client",
-        "typescript"
-    ],
-    "author": "Arnaud JEZEQUEL <arnaud.jezequel@gmail.com>",
-    "license": "MIT",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/yourusername/redseat-svelte.git",
-        "directory": "packages/api"
-    },
-    "scripts": {
-        "build": "tsc",
-        "test": "vitest run",
-        "test:watch": "vitest"
-    },
-    "dependencies": {
-        "axios": "^1.11.0",
-        "rxjs": "^7.8.2"
-    },
-    "devDependencies": {
-        "typescript": "^5.8.3",
-        "vite": "^7.3.0",
-        "vitest": "^4.0.16"
-    },
-    "publishConfig": {
-        "access": "public"
-    }
+{
+    "name": "@redseat/api",
+    "version": "0.3.7",
+    "description": "TypeScript API client library for interacting with Redseat servers",
+    "type": "module",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "files": [
+        "dist/**/*",
+        "README.md",
+        "*.md"
+    ],
+    "keywords": [
+        "redseat",
+        "api",
+        "client",
+        "typescript"
+    ],
+    "author": "Arnaud JEZEQUEL <arnaud.jezequel@gmail.com>",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/yourusername/redseat-svelte.git",
+        "directory": "packages/api"
+    },
+    "scripts": {
+        "build": "tsc",
+        "test": "vitest run",
+        "test:watch": "vitest"
+    },
+    "dependencies": {
+        "axios": "^1.11.0",
+        "rxjs": "^7.8.2"
+    },
+    "devDependencies": {
+        "typescript": "^5.8.3",
+        "vite": "^7.3.0",
+        "vitest": "^4.0.16"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
 }