@operato/board 10.0.0-beta.4 → 10.0.0-beta.40

package/dist/src/graphql/playback-buffer.test.js

@@ -0,0 +1,261 @@
+import { PlaybackBuffer, CHUNK_DURATION } from './playback-buffer';
+// --- 테스트 헬퍼 ---
+const BASE_TIME = new Date('2026-04-12T10:00:00Z').getTime();
+const ONE_HOUR = 3600000;
+const ONE_MIN = 60000;
+function makeSnapshots(fromMs, toMs, intervalMs = 1000) {
+    const snaps = [];
+    for (let t = fromMs; t < toMs; t += intervalMs) {
+        snaps.push({
+            timestamp: t,
+            data: { vehicle: { id: 'AGV01', position: t - fromMs } }
+        });
+    }
+    return snaps;
+}
+function createMockFetcher(allSnapshots) {
+    const calls = [];
+    const fetcher = async (from, to) => {
+        calls.push({ from: from.getTime(), to: to.getTime() });
+        if (allSnapshots) {
+            return allSnapshots.filter(s => s.timestamp >= from.getTime() && s.timestamp < to.getTime());
+        }
+        // 기본: 1초 간격 스냅샷 생성
+        return makeSnapshots(from.getTime(), to.getTime());
+    };
+    return { fetcher, calls };
+}
+// --- PlaybackBuffer 단위 테스트 ---
+describe('PlaybackBuffer', () => {
+    const totalRange = {
+        from: new Date(BASE_TIME),
+        to: new Date(BASE_TIME + ONE_HOUR)
+    };
+    describe('loadInitial', () => {
+        test('10분 청크를 로드한다', async () => {
+            const { fetcher, calls } = createMockFetcher();
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            expect(calls).toHaveLength(1);
+            expect(calls[0].from).toBe(BASE_TIME);
+            expect(calls[0].to).toBe(BASE_TIME + CHUNK_DURATION);
+        });
+        test('기존 버퍼를 폐기하고 새로 로드한다', async () => {
+            const { fetcher, calls } = createMockFetcher();
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            await buffer.loadInitial(BASE_TIME + 30 * ONE_MIN);
+            expect(calls).toHaveLength(2);
+            expect(buffer.getBufferedRanges()).toHaveLength(1);
+            expect(buffer.getBufferedRanges()[0].from).toBe(BASE_TIME + 30 * ONE_MIN);
+        });
+    });
+    describe('getSnapshotAt', () => {
+        test('playHead 이하인 가장 가까운 스냅샷을 반환한다', async () => {
+            const snaps = makeSnapshots(BASE_TIME, BASE_TIME + CHUNK_DURATION, 5000);
+            const { fetcher } = createMockFetcher(snaps);
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            const snap = buffer.getSnapshotAt(BASE_TIME + 7000);
+            expect(snap).not.toBeNull();
+            expect(snap.timestamp).toBe(BASE_TIME + 5000); // 5초 스냅샷 (7초 이하 중 가장 가까운)
+        });
+        test('버퍼에 데이터가 없으면 null', async () => {
+            const { fetcher } = createMockFetcher([]);
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            expect(buffer.getSnapshotAt(BASE_TIME + 5000)).toBeNull();
+        });
+        test('playHead가 첫 스냅샷보다 이전이면 null', async () => {
+            const snaps = makeSnapshots(BASE_TIME + 10000, BASE_TIME + CHUNK_DURATION, 5000);
+            const { fetcher } = createMockFetcher(snaps);
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            expect(buffer.getSnapshotAt(BASE_TIME + 5000)).toBeNull();
+        });
+    });
+    describe('getNextSnapshotTime', () => {
+        test('현재 이후 가장 가까운 스냅샷 시간을 반환한다', async () => {
+            const snaps = makeSnapshots(BASE_TIME, BASE_TIME + CHUNK_DURATION, 5000);
+            const { fetcher } = createMockFetcher(snaps);
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            expect(buffer.getNextSnapshotTime(BASE_TIME + 3000)).toBe(BASE_TIME + 5000);
+        });
+        test('마지막 스냅샷 이후면 null', async () => {
+            const snaps = makeSnapshots(BASE_TIME, BASE_TIME + 10000, 5000);
+            const { fetcher } = createMockFetcher(snaps);
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            expect(buffer.getNextSnapshotTime(BASE_TIME + 10000)).toBeNull();
+        });
+    });
+    describe('checkPrefetch', () => {
+        test('남은 버퍼가 1분 이하이면 다음 청크를 prefetch한다', async () => {
+            const { fetcher, calls } = createMockFetcher();
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            expect(calls).toHaveLength(1);
+            // playHead를 9분 위치로 (남은 1분)
+            await buffer.checkPrefetch(BASE_TIME + 9 * ONE_MIN);
+            expect(calls).toHaveLength(2);
+            expect(calls[1].from).toBe(BASE_TIME + CHUNK_DURATION); // 10분 후부터
+        });
+        test('남은 버퍼가 1분 초과이면 prefetch하지 않는다', async () => {
+            const { fetcher, calls } = createMockFetcher();
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            // playHead를 5분 위치로 (남은 5분)
+            await buffer.checkPrefetch(BASE_TIME + 5 * ONE_MIN);
+            expect(calls).toHaveLength(1); // 추가 fetch 없음
+        });
+        test('전체 범위 끝에 도달하면 prefetch하지 않는다', async () => {
+            const shortRange = {
+                from: new Date(BASE_TIME),
+                to: new Date(BASE_TIME + CHUNK_DURATION) // 전체 10분
+            };
+            const { fetcher, calls } = createMockFetcher();
+            const buffer = new PlaybackBuffer(fetcher, shortRange);
+            await buffer.loadInitial(BASE_TIME);
+            // 9분 위치 — 하지만 전체 범위가 10분이므로 더 가져올 게 없음
+            await buffer.checkPrefetch(BASE_TIME + 9 * ONE_MIN);
+            expect(calls).toHaveLength(1);
+        });
+        test('중복 prefetch를 방지한다', async () => {
+            let resolveSecond;
+            let fetchCount = 0;
+            const slowFetcher = async (from, to) => {
+                fetchCount++;
+                if (fetchCount === 2) {
+                    // 두 번째 fetch는 느리게
+                    await new Promise(r => { resolveSecond = r; });
+                }
+                return makeSnapshots(from.getTime(), to.getTime());
+            };
+            const buffer = new PlaybackBuffer(slowFetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            // 동시에 두 번 checkPrefetch
+            const p1 = buffer.checkPrefetch(BASE_TIME + 9 * ONE_MIN);
+            const p2 = buffer.checkPrefetch(BASE_TIME + 9 * ONE_MIN);
+            resolveSecond();
+            await Promise.all([p1, p2]);
+            // 초기 1 + prefetch 1 = 2 (중복 방지)
+            expect(fetchCount).toBe(2);
+        });
+    });
+    describe('seek', () => {
+        test('기존 버퍼를 폐기하고 새 위치에서 로드한다', async () => {
+            const { fetcher, calls } = createMockFetcher();
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            expect(buffer.getBufferedRanges()).toHaveLength(1);
+            await buffer.seek(BASE_TIME + 30 * ONE_MIN);
+            expect(buffer.getBufferedRanges()).toHaveLength(1); // 이전 버퍼 폐기, 새 청크 1개
+            expect(buffer.getBufferedRanges()[0].from).toBe(BASE_TIME + 30 * ONE_MIN);
+        });
+        test('seek 후 이전 데이터에 접근 불가', async () => {
+            const snaps = makeSnapshots(BASE_TIME, BASE_TIME + ONE_HOUR, 5000);
+            const { fetcher } = createMockFetcher(snaps);
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            expect(buffer.getSnapshotAt(BASE_TIME + 5000)).not.toBeNull();
+            await buffer.seek(BASE_TIME + 30 * ONE_MIN);
+            expect(buffer.getSnapshotAt(BASE_TIME + 5000)).toBeNull(); // 이전 데이터 없음
+        });
+    });
+    describe('getBufferedRanges', () => {
+        test('로드된 청크들의 시간 범위를 반환한다', async () => {
+            const { fetcher } = createMockFetcher();
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            await buffer.checkPrefetch(BASE_TIME + 9 * ONE_MIN); // prefetch 트리거
+            const ranges = buffer.getBufferedRanges();
+            expect(ranges).toHaveLength(2);
+            expect(ranges[0].from).toBe(BASE_TIME);
+            expect(ranges[0].to).toBe(BASE_TIME + CHUNK_DURATION);
+            expect(ranges[1].from).toBe(BASE_TIME + CHUNK_DURATION);
+            expect(ranges[1].to).toBe(BASE_TIME + 2 * CHUNK_DURATION);
+        });
+    });
+    describe('hasDataAt', () => {
+        test('버퍼 내 시점은 true', async () => {
+            const { fetcher } = createMockFetcher();
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            expect(buffer.hasDataAt(BASE_TIME + 5 * ONE_MIN)).toBe(true);
+        });
+        test('버퍼 외 시점은 false', async () => {
+            const { fetcher } = createMockFetcher();
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            expect(buffer.hasDataAt(BASE_TIME + 15 * ONE_MIN)).toBe(false);
+        });
+    });
+    describe('clear', () => {
+        test('모든 버퍼를 폐기한다', async () => {
+            const { fetcher } = createMockFetcher();
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            expect(buffer.getBufferedRanges()).toHaveLength(1);
+            buffer.clear();
+            expect(buffer.getBufferedRanges()).toHaveLength(0);
+        });
+    });
+    describe('연속 재생 시나리오', () => {
+        test('10분 → prefetch → 20분 연속 재생', async () => {
+            const { fetcher, calls } = createMockFetcher();
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            // 1. 초기 로드 (0~10분)
+            await buffer.loadInitial(BASE_TIME);
+            expect(calls).toHaveLength(1);
+            // 2. 5분 위치 — prefetch 안 함
+            await buffer.checkPrefetch(BASE_TIME + 5 * ONE_MIN);
+            expect(calls).toHaveLength(1);
+            // 3. 9분 위치 — prefetch 트리거 (10~20분)
+            await buffer.checkPrefetch(BASE_TIME + 9 * ONE_MIN);
+            expect(calls).toHaveLength(2);
+            // 4. 15분 위치 — 두 번째 청크에서 데이터 조회 가능
+            expect(buffer.hasDataAt(BASE_TIME + 15 * ONE_MIN)).toBe(true);
+            // 5. 19분 위치 — 다시 prefetch (20~30분)
+            await buffer.checkPrefetch(BASE_TIME + 19 * ONE_MIN);
+            expect(calls).toHaveLength(3);
+        });
+        test('seek 후 prefetch 정상 동작', async () => {
+            const { fetcher, calls } = createMockFetcher();
+            const buffer = new PlaybackBuffer(fetcher, totalRange);
+            await buffer.loadInitial(BASE_TIME);
+            // seek to 40분
+            await buffer.seek(BASE_TIME + 40 * ONE_MIN);
+            expect(calls).toHaveLength(2); // initial + seek
+            // 49분 위치 — prefetch (50~60분)
+            await buffer.checkPrefetch(BASE_TIME + 49 * ONE_MIN);
+            expect(calls).toHaveLength(3);
+            expect(calls[2].from).toBe(BASE_TIME + 50 * ONE_MIN);
+        });
+    });
+    describe('경계 조건', () => {
+        test('전체 범위가 10분 미만', async () => {
+            const shortRange = {
+                from: new Date(BASE_TIME),
+                to: new Date(BASE_TIME + 5 * ONE_MIN)
+            };
+            const { fetcher, calls } = createMockFetcher();
+            const buffer = new PlaybackBuffer(fetcher, shortRange);
+            await buffer.loadInitial(BASE_TIME);
+            expect(calls).toHaveLength(1);
+            expect(calls[0].to).toBe(BASE_TIME + 5 * ONE_MIN); // 5분까지만
+        });
+        test('끝 경계에서 청크 크기 조정', async () => {
+            const range55min = {
+                from: new Date(BASE_TIME),
+                to: new Date(BASE_TIME + 55 * ONE_MIN)
+            };
+            const { fetcher, calls } = createMockFetcher();
+            const buffer = new PlaybackBuffer(fetcher, range55min);
+            // 50분 위치에서 시작
+            await buffer.loadInitial(BASE_TIME + 50 * ONE_MIN);
+            expect(calls[0].to).toBe(BASE_TIME + 55 * ONE_MIN); // 55분까지만 (10분이 아닌 5분)
+        });
+    });
+});
+//# sourceMappingURL=playback-buffer.test.js.map

package/dist/src/graphql/playback-buffer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playback-buffer.test.js","sourceRoot":"","sources":["../../../src/graphql/playback-buffer.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { PlaybackBuffer, PlaybackSnapshot, CHUNK_DURATION, PREFETCH_THRESHOLD } from './playback-buffer'\n\n// --- 테스트 헬퍼 ---\n\nconst BASE_TIME = new Date('2026-04-12T10:00:00Z').getTime()\nconst ONE_HOUR = 3600000\nconst ONE_MIN = 60000\n\nfunction makeSnapshots(fromMs: number, toMs: number, intervalMs: number = 1000): PlaybackSnapshot[] {\n  const snaps: PlaybackSnapshot[] = []\n  for (let t = fromMs; t < toMs; t += intervalMs) {\n    snaps.push({\n      timestamp: t,\n      data: { vehicle: { id: 'AGV01', position: t - fromMs } }\n    })\n  }\n  return snaps\n}\n\nfunction createMockFetcher(allSnapshots?: PlaybackSnapshot[]) {\n  const calls: { from: number; to: number }[] = []\n\n  const fetcher = async (from: Date, to: Date) => {\n    calls.push({ from: from.getTime(), to: to.getTime() })\n\n    if (allSnapshots) {\n      return allSnapshots.filter(s => s.timestamp >= from.getTime() && s.timestamp < to.getTime())\n    }\n\n    // 기본: 1초 간격 스냅샷 생성\n    return makeSnapshots(from.getTime(), to.getTime())\n  }\n\n  return { fetcher, calls }\n}\n\n// --- PlaybackBuffer 단위 테스트 ---\n\ndescribe('PlaybackBuffer', () => {\n  const totalRange = {\n    from: new Date(BASE_TIME),\n    to: new Date(BASE_TIME + ONE_HOUR)\n  }\n\n  describe('loadInitial', () => {\n    test('10분 청크를 로드한다', async () => {\n      const { fetcher, calls } = createMockFetcher()\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n\n      expect(calls).toHaveLength(1)\n      expect(calls[0].from).toBe(BASE_TIME)\n      expect(calls[0].to).toBe(BASE_TIME + CHUNK_DURATION)\n    })\n\n    test('기존 버퍼를 폐기하고 새로 로드한다', async () => {\n      const { fetcher, calls } = createMockFetcher()\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n      await buffer.loadInitial(BASE_TIME + 30 * ONE_MIN)\n\n      expect(calls).toHaveLength(2)\n      expect(buffer.getBufferedRanges()).toHaveLength(1)\n      expect(buffer.getBufferedRanges()[0].from).toBe(BASE_TIME + 30 * ONE_MIN)\n    })\n  })\n\n  describe('getSnapshotAt', () => {\n    test('playHead 이하인 가장 가까운 스냅샷을 반환한다', async () => {\n      const snaps = makeSnapshots(BASE_TIME, BASE_TIME + CHUNK_DURATION, 5000)\n      const { fetcher } = createMockFetcher(snaps)\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n\n      const snap = buffer.getSnapshotAt(BASE_TIME + 7000)\n      expect(snap).not.toBeNull()\n      expect(snap!.timestamp).toBe(BASE_TIME + 5000) // 5초 스냅샷 (7초 이하 중 가장 가까운)\n    })\n\n    test('버퍼에 데이터가 없으면 null', async () => {\n      const { fetcher } = createMockFetcher([])\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n\n      expect(buffer.getSnapshotAt(BASE_TIME + 5000)).toBeNull()\n    })\n\n    test('playHead가 첫 스냅샷보다 이전이면 null', async () => {\n      const snaps = makeSnapshots(BASE_TIME + 10000, BASE_TIME + CHUNK_DURATION, 5000)\n      const { fetcher } = createMockFetcher(snaps)\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n\n      expect(buffer.getSnapshotAt(BASE_TIME + 5000)).toBeNull()\n    })\n  })\n\n  describe('getNextSnapshotTime', () => {\n    test('현재 이후 가장 가까운 스냅샷 시간을 반환한다', async () => {\n      const snaps = makeSnapshots(BASE_TIME, BASE_TIME + CHUNK_DURATION, 5000)\n      const { fetcher } = createMockFetcher(snaps)\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n\n      expect(buffer.getNextSnapshotTime(BASE_TIME + 3000)).toBe(BASE_TIME + 5000)\n    })\n\n    test('마지막 스냅샷 이후면 null', async () => {\n      const snaps = makeSnapshots(BASE_TIME, BASE_TIME + 10000, 5000)\n      const { fetcher } = createMockFetcher(snaps)\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n\n      expect(buffer.getNextSnapshotTime(BASE_TIME + 10000)).toBeNull()\n    })\n  })\n\n  describe('checkPrefetch', () => {\n    test('남은 버퍼가 1분 이하이면 다음 청크를 prefetch한다', async () => {\n      const { fetcher, calls } = createMockFetcher()\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n      expect(calls).toHaveLength(1)\n\n      // playHead를 9분 위치로 (남은 1분)\n      await buffer.checkPrefetch(BASE_TIME + 9 * ONE_MIN)\n\n      expect(calls).toHaveLength(2)\n      expect(calls[1].from).toBe(BASE_TIME + CHUNK_DURATION) // 10분 후부터\n    })\n\n    test('남은 버퍼가 1분 초과이면 prefetch하지 않는다', async () => {\n      const { fetcher, calls } = createMockFetcher()\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n\n      // playHead를 5분 위치로 (남은 5분)\n      await buffer.checkPrefetch(BASE_TIME + 5 * ONE_MIN)\n\n      expect(calls).toHaveLength(1) // 추가 fetch 없음\n    })\n\n    test('전체 범위 끝에 도달하면 prefetch하지 않는다', async () => {\n      const shortRange = {\n        from: new Date(BASE_TIME),\n        to: new Date(BASE_TIME + CHUNK_DURATION) // 전체 10분\n      }\n      const { fetcher, calls } = createMockFetcher()\n      const buffer = new PlaybackBuffer(fetcher, shortRange)\n\n      await buffer.loadInitial(BASE_TIME)\n\n      // 9분 위치 — 하지만 전체 범위가 10분이므로 더 가져올 게 없음\n      await buffer.checkPrefetch(BASE_TIME + 9 * ONE_MIN)\n\n      expect(calls).toHaveLength(1)\n    })\n\n    test('중복 prefetch를 방지한다', async () => {\n      let resolveSecond: () => void\n      let fetchCount = 0\n\n      const slowFetcher = async (from: Date, to: Date) => {\n        fetchCount++\n        if (fetchCount === 2) {\n          // 두 번째 fetch는 느리게\n          await new Promise<void>(r => { resolveSecond = r })\n        }\n        return makeSnapshots(from.getTime(), to.getTime())\n      }\n\n      const buffer = new PlaybackBuffer(slowFetcher, totalRange)\n      await buffer.loadInitial(BASE_TIME)\n\n      // 동시에 두 번 checkPrefetch\n      const p1 = buffer.checkPrefetch(BASE_TIME + 9 * ONE_MIN)\n      const p2 = buffer.checkPrefetch(BASE_TIME + 9 * ONE_MIN)\n\n      resolveSecond!()\n      await Promise.all([p1, p2])\n\n      // 초기 1 + prefetch 1 = 2 (중복 방지)\n      expect(fetchCount).toBe(2)\n    })\n  })\n\n  describe('seek', () => {\n    test('기존 버퍼를 폐기하고 새 위치에서 로드한다', async () => {\n      const { fetcher, calls } = createMockFetcher()\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n      expect(buffer.getBufferedRanges()).toHaveLength(1)\n\n      await buffer.seek(BASE_TIME + 30 * ONE_MIN)\n\n      expect(buffer.getBufferedRanges()).toHaveLength(1) // 이전 버퍼 폐기, 새 청크 1개\n      expect(buffer.getBufferedRanges()[0].from).toBe(BASE_TIME + 30 * ONE_MIN)\n    })\n\n    test('seek 후 이전 데이터에 접근 불가', async () => {\n      const snaps = makeSnapshots(BASE_TIME, BASE_TIME + ONE_HOUR, 5000)\n      const { fetcher } = createMockFetcher(snaps)\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n      expect(buffer.getSnapshotAt(BASE_TIME + 5000)).not.toBeNull()\n\n      await buffer.seek(BASE_TIME + 30 * ONE_MIN)\n      expect(buffer.getSnapshotAt(BASE_TIME + 5000)).toBeNull() // 이전 데이터 없음\n    })\n  })\n\n  describe('getBufferedRanges', () => {\n    test('로드된 청크들의 시간 범위를 반환한다', async () => {\n      const { fetcher } = createMockFetcher()\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n      await buffer.checkPrefetch(BASE_TIME + 9 * ONE_MIN) // prefetch 트리거\n\n      const ranges = buffer.getBufferedRanges()\n      expect(ranges).toHaveLength(2)\n      expect(ranges[0].from).toBe(BASE_TIME)\n      expect(ranges[0].to).toBe(BASE_TIME + CHUNK_DURATION)\n      expect(ranges[1].from).toBe(BASE_TIME + CHUNK_DURATION)\n      expect(ranges[1].to).toBe(BASE_TIME + 2 * CHUNK_DURATION)\n    })\n  })\n\n  describe('hasDataAt', () => {\n    test('버퍼 내 시점은 true', async () => {\n      const { fetcher } = createMockFetcher()\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n\n      expect(buffer.hasDataAt(BASE_TIME + 5 * ONE_MIN)).toBe(true)\n    })\n\n    test('버퍼 외 시점은 false', async () => {\n      const { fetcher } = createMockFetcher()\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n\n      expect(buffer.hasDataAt(BASE_TIME + 15 * ONE_MIN)).toBe(false)\n    })\n  })\n\n  describe('clear', () => {\n    test('모든 버퍼를 폐기한다', async () => {\n      const { fetcher } = createMockFetcher()\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n      expect(buffer.getBufferedRanges()).toHaveLength(1)\n\n      buffer.clear()\n      expect(buffer.getBufferedRanges()).toHaveLength(0)\n    })\n  })\n\n  describe('연속 재생 시나리오', () => {\n    test('10분 → prefetch → 20분 연속 재생', async () => {\n      const { fetcher, calls } = createMockFetcher()\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      // 1. 초기 로드 (0~10분)\n      await buffer.loadInitial(BASE_TIME)\n      expect(calls).toHaveLength(1)\n\n      // 2. 5분 위치 — prefetch 안 함\n      await buffer.checkPrefetch(BASE_TIME + 5 * ONE_MIN)\n      expect(calls).toHaveLength(1)\n\n      // 3. 9분 위치 — prefetch 트리거 (10~20분)\n      await buffer.checkPrefetch(BASE_TIME + 9 * ONE_MIN)\n      expect(calls).toHaveLength(2)\n\n      // 4. 15분 위치 — 두 번째 청크에서 데이터 조회 가능\n      expect(buffer.hasDataAt(BASE_TIME + 15 * ONE_MIN)).toBe(true)\n\n      // 5. 19분 위치 — 다시 prefetch (20~30분)\n      await buffer.checkPrefetch(BASE_TIME + 19 * ONE_MIN)\n      expect(calls).toHaveLength(3)\n    })\n\n    test('seek 후 prefetch 정상 동작', async () => {\n      const { fetcher, calls } = createMockFetcher()\n      const buffer = new PlaybackBuffer(fetcher, totalRange)\n\n      await buffer.loadInitial(BASE_TIME)\n\n      // seek to 40분\n      await buffer.seek(BASE_TIME + 40 * ONE_MIN)\n      expect(calls).toHaveLength(2) // initial + seek\n\n      // 49분 위치 — prefetch (50~60분)\n      await buffer.checkPrefetch(BASE_TIME + 49 * ONE_MIN)\n      expect(calls).toHaveLength(3)\n      expect(calls[2].from).toBe(BASE_TIME + 50 * ONE_MIN)\n    })\n  })\n\n  describe('경계 조건', () => {\n    test('전체 범위가 10분 미만', async () => {\n      const shortRange = {\n        from: new Date(BASE_TIME),\n        to: new Date(BASE_TIME + 5 * ONE_MIN)\n      }\n      const { fetcher, calls } = createMockFetcher()\n      const buffer = new PlaybackBuffer(fetcher, shortRange)\n\n      await buffer.loadInitial(BASE_TIME)\n\n      expect(calls).toHaveLength(1)\n      expect(calls[0].to).toBe(BASE_TIME + 5 * ONE_MIN) // 5분까지만\n    })\n\n    test('끝 경계에서 청크 크기 조정', async () => {\n      const range55min = {\n        from: new Date(BASE_TIME),\n        to: new Date(BASE_TIME + 55 * ONE_MIN)\n      }\n      const { fetcher, calls } = createMockFetcher()\n      const buffer = new PlaybackBuffer(fetcher, range55min)\n\n      // 50분 위치에서 시작\n      await buffer.loadInitial(BASE_TIME + 50 * ONE_MIN)\n\n      expect(calls[0].to).toBe(BASE_TIME + 55 * ONE_MIN) // 55분까지만 (10분이 아닌 5분)\n    })\n  })\n})\n"]}

package/dist/src/graphql/playback-subscription.d.ts

@@ -0,0 +1,89 @@
+import { Component, DataSubscriptionProvider } from '@hatiolab/things-scene';
+export type PlaybackState = 'idle' | 'playing' | 'paused' | 'stopped';
+export interface PlaybackStatus {
+    state: PlaybackState;
+    currentTime: string;
+    speed: number;
+    bufferedRanges?: {
+        from: number;
+        to: number;
+    }[];
+}
+export interface PlaybackConfig {
+    /** 플레이백 가능한 시간 범위 */
+    timeRange?: {
+        from: Date;
+        to: Date;
+    };
+}
+/**
+ * PlaybackProvider — YouTube 스트리밍 방식의 청크 기반 플레이백
+ *
+ * - 10분 단위로 데이터를 fetch하여 버퍼에 적재
+ * - 남은 데이터 1분 이하 시 다음 10분 prefetch
+ * - seek 시 기존 버퍼 전체 폐기 후 fresh fetch
+ * - requestAnimationFrame 기반 재생 루프
+ */
+export declare class PlaybackProvider implements DataSubscriptionProvider {
+    private _components;
+    private _buffer;
+    private _state;
+    private _speed;
+    private _playHead;
+    private _lastFrameTime;
+    private _rafId;
+    private _lastDistributedSnapshot;
+    private _onStatusChange?;
+    private _totalRange;
+    constructor(onStatusChange?: (status: PlaybackStatus) => void);
+    get state(): PlaybackState;
+    get speed(): number;
+    get currentTime(): string;
+    /**
+     * DataSubscriptionProvider.subscribe 구현
+     */
+    subscribe(tag: string, component: Component): Promise<{
+        unsubscribe: () => void;
+    }>;
+    /**
+     * 플레이백 시작
+     */
+    start(fromTime: Date, speed?: number, totalRange?: {
+        from: Date;
+        to: Date;
+    }): Promise<void>;
+    /**
+     * 일시정지
+     */
+    pause(): void;
+    /**
+     * 재개
+     */
+    resume(): void;
+    /**
+     * seek — 기존 버퍼 폐기 + 새 위치에서 fresh fetch
+     */
+    seek(toTime: Date): Promise<void>;
+    /**
+     * 배속 변경
+     */
+    setSpeed(speed: number): void;
+    /**
+     * 중지
+     */
+    stop(): void;
+    /**
+     * DataSubscriptionProvider.dispose 구현
+     */
+    dispose(): void;
+    private _startPlayLoop;
+    private _stopPlayLoop;
+    private _playLoop;
+    private _distributeSnapshot;
+    private _createFetcher;
+    /**
+     * 백엔드 응답을 PlaybackSnapshot[] 형식으로 변환
+     */
+    private _parsePlaybackResponse;
+    private _notifyStatus;
+}

package/dist/src/graphql/playback-subscription.js

@@ -0,0 +1,258 @@
+import gql from 'graphql-tag';
+import { PlaybackBuffer } from './playback-buffer.js';
+/**
+ * PlaybackProvider — YouTube 스트리밍 방식의 청크 기반 플레이백
+ *
+ * - 10분 단위로 데이터를 fetch하여 버퍼에 적재
+ * - 남은 데이터 1분 이하 시 다음 10분 prefetch
+ * - seek 시 기존 버퍼 전체 폐기 후 fresh fetch
+ * - requestAnimationFrame 기반 재생 루프
+ */
+export class PlaybackProvider {
+    constructor(onStatusChange) {
+        this._components = new Map();
+        this._buffer = null;
+        this._state = 'idle';
+        this._speed = 1;
+        this._playHead = 0;
+        this._lastFrameTime = 0;
+        this._rafId = 0;
+        this._lastDistributedSnapshot = null;
+        this._totalRange = null;
+        this._playLoop = (now) => {
+            if (this._state !== 'playing' || !this._buffer)
+                return;
+            const delta = (now - this._lastFrameTime) * this._speed;
+            this._lastFrameTime = now;
+            this._playHead += delta;
+            // 전체 범위 끝 도달 체크
+            if (this._totalRange && this._playHead >= this._totalRange.to.getTime()) {
+                this._playHead = this._totalRange.to.getTime();
+                this._state = 'stopped';
+                this._notifyStatus();
+                return;
+            }
+            // 현재 스냅샷 배포
+            const snap = this._buffer.getSnapshotAt(this._playHead);
+            if (snap && snap !== this._lastDistributedSnapshot) {
+                this._distributeSnapshot(snap.data);
+                this._lastDistributedSnapshot = snap;
+            }
+            // prefetch 체크 (비동기, 루프 블로킹 안 함)
+            this._buffer.checkPrefetch(this._playHead);
+            this._notifyStatus();
+            // 다음 프레임
+            this._rafId = requestAnimationFrame(this._playLoop);
+        };
+        this._onStatusChange = onStatusChange;
+    }
+    get state() { return this._state; }
+    get speed() { return this._speed; }
+    get currentTime() { return this._playHead ? new Date(this._playHead).toISOString() : ''; }
+    /**
+     * DataSubscriptionProvider.subscribe 구현
+     */
+    async subscribe(tag, component) {
+        if (!this._components.has(tag)) {
+            this._components.set(tag, new Set());
+        }
+        this._components.get(tag).add(component);
+        return {
+            unsubscribe: () => {
+                const components = this._components.get(tag);
+                if (components) {
+                    components.delete(component);
+                    if (components.size === 0) {
+                        this._components.delete(tag);
+                    }
+                }
+            }
+        };
+    }
+    /**
+     * 플레이백 시작
+     */
+    async start(fromTime, speed = 1, totalRange) {
+        this.stop();
+        this._speed = speed;
+        this._totalRange = totalRange || { from: fromTime, to: new Date(fromTime.getTime() + 3600000) };
+        // 버퍼 생성 + 초기 로드
+        this._buffer = new PlaybackBuffer(this._createFetcher(), this._totalRange);
+        await this._buffer.loadInitial(fromTime.getTime());
+        this._playHead = fromTime.getTime();
+        this._state = 'playing';
+        this._lastFrameTime = performance.now();
+        this._startPlayLoop();
+        this._notifyStatus();
+    }
+    /**
+     * 일시정지
+     */
+    pause() {
+        if (this._state !== 'playing')
+            return;
+        this._state = 'paused';
+        this._stopPlayLoop();
+        this._notifyStatus();
+    }
+    /**
+     * 재개
+     */
+    resume() {
+        if (this._state !== 'paused')
+            return;
+        this._state = 'playing';
+        this._lastFrameTime = performance.now();
+        this._startPlayLoop();
+        this._notifyStatus();
+    }
+    /**
+     * seek — 기존 버퍼 폐기 + 새 위치에서 fresh fetch
+     */
+    async seek(toTime) {
+        if (!this._buffer)
+            return;
+        const wasPlaying = this._state === 'playing';
+        this._stopPlayLoop();
+        // 버퍼 전체 폐기 + 새 위치 로드
+        await this._buffer.seek(toTime.getTime());
+        this._playHead = toTime.getTime();
+        this._lastDistributedSnapshot = null;
+        // 새 위치의 첫 스냅샷 즉시 배포
+        const snap = this._buffer.getSnapshotAt(this._playHead);
+        if (snap) {
+            this._distributeSnapshot(snap.data);
+            this._lastDistributedSnapshot = snap;
+        }
+        if (wasPlaying) {
+            this._state = 'playing';
+            this._lastFrameTime = performance.now();
+            this._startPlayLoop();
+        }
+        this._notifyStatus();
+    }
+    /**
+     * 배속 변경
+     */
+    setSpeed(speed) {
+        this._speed = speed;
+        this._notifyStatus();
+    }
+    /**
+     * 중지
+     */
+    stop() {
+        var _a;
+        this._stopPlayLoop();
+        (_a = this._buffer) === null || _a === void 0 ? void 0 : _a.clear();
+        this._buffer = null;
+        this._state = 'stopped';
+        this._playHead = 0;
+        this._lastDistributedSnapshot = null;
+        this._notifyStatus();
+    }
+    /**
+     * DataSubscriptionProvider.dispose 구현
+     */
+    dispose() {
+        this.stop();
+        this._state = 'idle';
+        this._components.clear();
+    }
+    // --- 재생 루프 ---
+    _startPlayLoop() {
+        this._rafId = requestAnimationFrame(this._playLoop);
+    }
+    _stopPlayLoop() {
+        if (this._rafId) {
+            cancelAnimationFrame(this._rafId);
+            this._rafId = 0;
+        }
+    }
+    // --- 데이터 배포 ---
+    _distributeSnapshot(snapshotData) {
+        if (!snapshotData || typeof snapshotData !== 'object')
+            return;
+        for (const [tag, value] of Object.entries(snapshotData)) {
+            const components = this._components.get(tag);
+            if (components) {
+                for (const component of components) {
+                    component.data = value;
+                }
+            }
+        }
+    }
+    // --- 데이터 fetcher ---
+    _createFetcher() {
+        return async (fromTime, toTime) => {
+            var _a;
+            try {
+                const { client } = await import('@operato/graphql');
+                const response = await client.query({
+                    query: gql `
+            query PlaybackChunk($startTime: String!, $endTime: String!) {
+              playback(startTime: $startTime, endTime: $endTime) {
+                status
+                playback {
+                  scenarios {
+                    scenarioName
+                    snapshots {
+                      type
+                      time
+                      data
+                    }
+                  }
+                }
+              }
+            }
+          `,
+                    variables: {
+                        startTime: fromTime.toISOString().replace('T', ' ').replace(/\.\d+Z$/, ''),
+                        endTime: toTime.toISOString().replace('T', ' ').replace(/\.\d+Z$/, '')
+                    },
+                    fetchPolicy: 'no-cache'
+                });
+                return this._parsePlaybackResponse((_a = response.data) === null || _a === void 0 ? void 0 : _a.playback);
+            }
+            catch (e) {
+                console.error('[PlaybackProvider] chunk fetch error:', e);
+                return [];
+            }
+        };
+    }
+    /**
+     * 백엔드 응답을 PlaybackSnapshot[] 형식으로 변환
+     */
+    _parsePlaybackResponse(response) {
+        var _a;
+        if (!(response === null || response === void 0 ? void 0 : response.status) || !((_a = response === null || response === void 0 ? void 0 : response.playback) === null || _a === void 0 ? void 0 : _a.scenarios))
+            return [];
+        const snapshotMap = new Map();
+        for (const scenario of response.playback.scenarios) {
+            for (const record of scenario.snapshots) {
+                const time = new Date(record.time.replace(' ', 'T')).getTime();
+                const data = typeof record.data === 'string' ? JSON.parse(record.data) : record.data;
+                if (!snapshotMap.has(time)) {
+                    snapshotMap.set(time, {});
+                }
+                const merged = snapshotMap.get(time);
+                // scenarioName을 tag로 사용
+                merged[scenario.scenarioName] = data;
+            }
+        }
+        return Array.from(snapshotMap.entries())
+            .map(([timestamp, data]) => ({ timestamp, data }))
+            .sort((a, b) => a.timestamp - b.timestamp);
+    }
+    // --- 상태 통보 ---
+    _notifyStatus() {
+        var _a, _b;
+        (_a = this._onStatusChange) === null || _a === void 0 ? void 0 : _a.call(this, {
+            state: this._state,
+            currentTime: this._playHead ? new Date(this._playHead).toISOString() : '',
+            speed: this._speed,
+            bufferedRanges: (_b = this._buffer) === null || _b === void 0 ? void 0 : _b.getBufferedRanges()
+        });
+    }
+}
+//# sourceMappingURL=playback-subscription.js.map