@animastor/player 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.1.1 (2026-10-17)
+
+BOOK-RECOVER registry gate (stage 59, released via stage 61): the scene
+storyboard read path self-healed PG for any disk book — when no PG durations
+existed it computed them and upserted `image_units` keyed only on disk
+presence, re-creating rows for deleted books on every client poll.
+
+### Fixed
+
+- `GET /scene/:b/:ch/:sc/storyboard` — the `image_units` PG upsert
+  (duration self-heal) now runs only when the book is still registered
+  (owns a `books` row). Durations are still computed and returned in the
+  response; only the PG WRITE is suppressed for unregistered books.
+
+### API
+
+- No breaking changes. The gate rides on the existing injection seam:
+  `playerRoutes(app, redis, deps)` accepts an optional
+  `deps.isBookRegistered(bookId) → Promise<boolean>` and threads it into the
+  shared contour context (`playerShared.isBookRegistered`). When the host
+  does not inject it, behavior is identical to 0.1.0 (fail-open, legacy
+  recovery). Root exports unchanged.
+
 ## 0.1.0 — 2026-09-08
 
 ### Release preparation (npm publication)

package/README.md

@@ -11,9 +11,9 @@ Model and the read-side artifact-naming grammar.
 **Status: EXTRACTED (0.1.0).** The playback contour physically lives in this
 package (`src/`); the host backend consumes it only through the package
 entrypoint. See
-[`docs/architecture/PLAYER_ROUTE_SPLIT_CHECKLIST.md`](https://github.com/Animastor/animastor/blob/main/docs/architecture/PLAYER_ROUTE_SPLIT_CHECKLIST.md)
+[`docs/architecture/PLAYER_ROUTE_SPLIT_CHECKLIST.md`](https://github.com/Animastor/animastor-backend/blob/main/docs/architecture/PLAYER_ROUTE_SPLIT_CHECKLIST.md)
 (physical move COMPLETE) and
-[`docs/architecture/PLAYER_PACKAGE_EXTRACTION_READINESS_AUDIT.md`](https://github.com/Animastor/animastor/blob/main/docs/architecture/PLAYER_PACKAGE_EXTRACTION_READINESS_AUDIT.md).
+[`docs/architecture/PLAYER_PACKAGE_EXTRACTION_READINESS_AUDIT.md`](https://github.com/Animastor/animastor-backend/blob/main/docs/architecture/PLAYER_PACKAGE_EXTRACTION_READINESS_AUDIT.md).
 
 ## Requirements
 
@@ -87,8 +87,8 @@ GET  /api/v1/preview/:b/:ch/:sc/:iuId      GET  /api/v1/book/:bookId/chunks
 GET  /api/v1/book/:bookId/assets-state
 ```
 
-Guards: [`backend/tests/architecture/player-route-split.test.js`](https://github.com/Animastor/animastor/blob/main/backend/tests/architecture/player-route-split.test.js) (P1–P9) and
-[`backend/tests/architecture/phase6-editor-player.test.js`](https://github.com/Animastor/animastor/blob/main/backend/tests/architecture/phase6-editor-player.test.js) (T1–T7).
+Guards: [`backend/tests/architecture/player-route-split.test.js`](https://github.com/Animastor/animastor-backend/blob/main/backend/tests/architecture/player-route-split.test.js) (P1–P9) and
+[`backend/tests/architecture/phase6-editor-player.test.js`](https://github.com/Animastor/animastor-backend/blob/main/backend/tests/architecture/phase6-editor-player.test.js) (T1–T7).
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@animastor/player",
-    "version": "0.1.0",
+    "version": "0.1.1",
     "description": "Animastor Player — playback HTTP contour: scene media serving (Range/206/ETag/If-Range), scene data (status/storyboard/timings/waveform), IU media, playback queue and assets-state. Reads book content only through the injected playerModel (VBook boundary); every host dependency arrives as an injected port — no config, no generation, no workflows, no Redis/PG/Redis internals in the package.",
     "keywords": [
         "animastor",
@@ -31,12 +31,12 @@
     },
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/Animastor/animastor.git",
+        "url": "git+https://github.com/Animastor/animastor-backend.git",
         "directory": "packages/animastor-player"
     },
-    "homepage": "https://github.com/Animastor/animastor/tree/main/packages/animastor-player#readme",
+    "homepage": "https://github.com/Animastor/animastor-backend/tree/main/packages/animastor-player#readme",
     "bugs": {
-        "url": "https://github.com/Animastor/animastor/issues"
+        "url": "https://github.com/Animastor/animastor-backend/issues"
     },
     "dependencies": {
         "@animastor/vbook-runtime": "^0.1.0"

package/src/player-routes.cjs

@@ -51,6 +51,9 @@ module.exports = function(app, redis, deps) {
         getChunk, getAllChunks, getBookWindowStatus,
         activeScenes, placeholderAudio, layerConfig, iuRepo,
         sceneAssetsRepo, playerModel,
+        // Book-registry gate (read-time self-heal must not persist for a
+        // deleted/unregistered book):
+        isBookRegistered,
         // Player-route seams (composition root provides them):
         outputRoot,            // = config.OUTPUT_DIR (injected)
         playerPorts,           // { assertBookAccess, computeVideoStartMs, computeWaveform }
@@ -73,6 +76,7 @@ module.exports = function(app, redis, deps) {
         redis,
         getChunk,
         iuRepo,
+        isBookRegistered,
         log,
     });
 

package/src/player-shared.cjs

@@ -37,7 +37,7 @@ const naming = require('./artifact-naming.cjs');
  *   - playerPorts: { assertBookAccess, computeVideoStartMs, computeWaveform }
  */
 function createPlayerShared(deps) {
-    const { playerModel, playerPorts, redis, getChunk, iuRepo, log } = deps;
+    const { playerModel, playerPorts, redis, getChunk, iuRepo, isBookRegistered, log } = deps;
     const outputRoot = deps.outputRoot;
     const ports = playerPorts || {};
 
@@ -222,6 +222,7 @@ function createPlayerShared(deps) {
         get redis() { return redis; },
         get getChunk() { return getChunk; },
         get iuRepo() { return iuRepo; },
+        get isBookRegistered() { return isBookRegistered; },
         get outputRoot() { return outputRoot; },
         get log() { return log; },
     };

package/src/scene-data.cjs

@@ -157,18 +157,28 @@ module.exports = function(app, ctx, deps) {
                     iu._end_ms = endMs;
                     cursorMs = endMs;
                 }
-                for (const [idx, iu] of ius.entries()) {
-                    try {
-                        await ctx.iuRepo.upsertImageUnit(buildId, bookId, chapterId, sceneId, iu.unit_id, {
-                            scene_order: idx, text: iu.text, text_length: (iu.text || '').length,
-                            text_proportion: iu.text_proportion || 0, scene_duration_sec: sceneDuration || 0,
-                            estimated_duration_sec: iu.estimated_duration_sec || 0,
-                            scene_audio_file: naming.sceneAudioName(bookId, chapterId, sceneId),
-                            start_ms: iu._start_ms != null ? iu._start_ms : null,
-                            end_ms: iu._end_ms != null ? iu._end_ms : null,
-                        });
-                    } catch (pgErr) {
-                        console.warn('[SCENE STORYBOARD] Failed to persist IU to PG:', pgErr.message);
+                // Registration gate: only persist the duration self-heal for a
+                // book that is still in the registry. A deleted book whose disk
+                // book.json remains would otherwise get its image_units rows
+                // re-created here every time a client polls the scene storyboard.
+                // The in-memory durations are still computed and returned; only
+                // the PG write is suppressed.
+                const registered = typeof ctx.isBookRegistered !== 'function'
+                    ? true : await ctx.isBookRegistered(bookId);
+                if (registered) {
+                    for (const [idx, iu] of ius.entries()) {
+                        try {
+                            await ctx.iuRepo.upsertImageUnit(buildId, bookId, chapterId, sceneId, iu.unit_id, {
+                                scene_order: idx, text: iu.text, text_length: (iu.text || '').length,
+                                text_proportion: iu.text_proportion || 0, scene_duration_sec: sceneDuration || 0,
+                                estimated_duration_sec: iu.estimated_duration_sec || 0,
+                                scene_audio_file: naming.sceneAudioName(bookId, chapterId, sceneId),
+                                start_ms: iu._start_ms != null ? iu._start_ms : null,
+                                end_ms: iu._end_ms != null ? iu._end_ms : null,
+                            });
+                        } catch (pgErr) {
+                            console.warn('[SCENE STORYBOARD] Failed to persist IU to PG:', pgErr.message);
+                        }
                     }
                 }
             }