e8d4c11434
Refactor TTS segment identification to support canonical segment keys, decoupling segment IDs from locator and index for more robust deduplication and handoff. Add `segmentKey` to segment types, manifest, and ensure route. Implement natural sorting for EPUB CFI locations and segment locators using new comparison utilities. Update sidebar and manifest helpers to use locator-aware sorting. Add foundational modules for EPUB word highlighting, TTS segment planning, and EPUB handoff logic. Expand types and tests to cover new canonical segment and locator behaviors. BREAKING CHANGE: TTS segment IDs now support canonical segment keys; APIs and manifest consumers must handle `segmentKey` and updated locator comparison logic.
116 lines
3.4 KiB
TypeScript
116 lines
3.4 KiB
TypeScript
import { expect, test } from '@playwright/test';
|
|
import {
|
|
buildProportionalAlignment,
|
|
buildTtsSegmentId,
|
|
buildTtsSegmentSettingsHash,
|
|
buildTtsSegmentTextHash,
|
|
locatorFingerprint,
|
|
normalizeLocator,
|
|
normalizeSegmentText,
|
|
} from '../../src/lib/server/tts/segments';
|
|
|
|
test.describe('tts segment helpers', () => {
|
|
test('builds stable settings hash', () => {
|
|
const a = buildTtsSegmentSettingsHash({
|
|
ttsProvider: 'openai',
|
|
ttsModel: 'gpt-4o-mini-tts',
|
|
voice: 'alloy',
|
|
nativeSpeed: 1,
|
|
ttsInstructions: 'calm',
|
|
});
|
|
const b = buildTtsSegmentSettingsHash({
|
|
ttsProvider: 'openai',
|
|
ttsModel: 'gpt-4o-mini-tts',
|
|
voice: 'alloy',
|
|
nativeSpeed: 1,
|
|
ttsInstructions: 'calm',
|
|
});
|
|
expect(a).toBe(b);
|
|
});
|
|
|
|
test('builds deterministic segment id', () => {
|
|
const id1 = buildTtsSegmentId({
|
|
documentId: 'doc',
|
|
documentVersion: 1,
|
|
settingsHash: 'abc',
|
|
segmentIndex: 2,
|
|
normalizedText: 'hello world',
|
|
locatorFingerprint: 'loc',
|
|
});
|
|
const id2 = buildTtsSegmentId({
|
|
documentId: 'doc',
|
|
documentVersion: 1,
|
|
settingsHash: 'abc',
|
|
segmentIndex: 2,
|
|
normalizedText: 'hello world',
|
|
locatorFingerprint: 'loc',
|
|
});
|
|
const id3 = buildTtsSegmentId({
|
|
documentId: 'doc',
|
|
documentVersion: 1,
|
|
settingsHash: 'abc',
|
|
segmentIndex: 3,
|
|
normalizedText: 'hello world',
|
|
locatorFingerprint: 'loc',
|
|
});
|
|
expect(id1).toBe(id2);
|
|
expect(id1).not.toBe(id3);
|
|
});
|
|
|
|
test('canonical segment key makes id independent of locator and index', () => {
|
|
const id1 = buildTtsSegmentId({
|
|
documentId: 'doc',
|
|
documentVersion: 1,
|
|
settingsHash: 'abc',
|
|
segmentIndex: 2,
|
|
segmentKey: 'doc:v1:segment-a',
|
|
normalizedText: 'hello world',
|
|
locatorFingerprint: 'loc-a',
|
|
});
|
|
const id2 = buildTtsSegmentId({
|
|
documentId: 'doc',
|
|
documentVersion: 1,
|
|
settingsHash: 'abc',
|
|
segmentIndex: 99,
|
|
segmentKey: 'doc:v1:segment-a',
|
|
normalizedText: 'hello world',
|
|
locatorFingerprint: 'loc-b',
|
|
});
|
|
const id3 = buildTtsSegmentId({
|
|
documentId: 'doc',
|
|
documentVersion: 1,
|
|
settingsHash: 'abc',
|
|
segmentIndex: 2,
|
|
segmentKey: 'doc:v1:segment-b',
|
|
normalizedText: 'hello world',
|
|
locatorFingerprint: 'loc-a',
|
|
});
|
|
expect(id1).toBe(id2);
|
|
expect(id1).not.toBe(id3);
|
|
});
|
|
|
|
test('does not leak plaintext via text hash', () => {
|
|
const hash = buildTtsSegmentTextHash('plain sentence', 'secret');
|
|
expect(hash).not.toContain('plain');
|
|
expect(hash).toHaveLength(64);
|
|
});
|
|
|
|
test('normalizes locators and creates fingerprints', () => {
|
|
const locator = normalizeLocator({ page: 2.9, location: ' cfi(1) ', readerType: 'epub' });
|
|
expect(locator).toEqual({ page: 2, location: 'cfi(1)', readerType: 'epub' });
|
|
expect(locatorFingerprint(locator)).toHaveLength(64);
|
|
});
|
|
|
|
test('builds proportional alignment preserving order', () => {
|
|
const alignment = buildProportionalAlignment({
|
|
sentence: normalizeSegmentText('Hello world again'),
|
|
sentenceIndex: 5,
|
|
durationMs: 1500,
|
|
});
|
|
expect(alignment.sentenceIndex).toBe(5);
|
|
expect(alignment.words.length).toBe(3);
|
|
expect(alignment.words[0].startSec).toBe(0);
|
|
expect(alignment.words[2].endSec).toBeGreaterThan(1.4);
|
|
expect(alignment.words[1].charStart).toBeGreaterThan(alignment.words[0].charStart);
|
|
});
|
|
});
|