videobook-engine 2.0.1 → 4.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (148) hide show
  1. package/README.md +87 -41
  2. package/dist/artifact-names.d.ts +6 -0
  3. package/dist/artifact-names.d.ts.map +1 -0
  4. package/dist/artifact-names.js +56 -0
  5. package/dist/artifact-names.js.map +1 -0
  6. package/dist/artifacts.d.ts.map +1 -1
  7. package/dist/artifacts.js +57 -23
  8. package/dist/artifacts.js.map +1 -1
  9. package/dist/books.js +2 -1
  10. package/dist/books.js.map +1 -1
  11. package/dist/cas.d.ts +27 -1
  12. package/dist/cas.d.ts.map +1 -1
  13. package/dist/cas.js +78 -6
  14. package/dist/cas.js.map +1 -1
  15. package/dist/catalog-metadata.d.ts +56 -0
  16. package/dist/catalog-metadata.d.ts.map +1 -0
  17. package/dist/catalog-metadata.js +42 -0
  18. package/dist/catalog-metadata.js.map +1 -0
  19. package/dist/communications.js +4 -2
  20. package/dist/communications.js.map +1 -1
  21. package/dist/context.d.ts +6 -1
  22. package/dist/context.d.ts.map +1 -1
  23. package/dist/context.js +35 -6
  24. package/dist/context.js.map +1 -1
  25. package/dist/domain.d.ts +4 -0
  26. package/dist/domain.d.ts.map +1 -1
  27. package/dist/domain.js +870 -58
  28. package/dist/domain.js.map +1 -1
  29. package/dist/edit-policy.d.ts +3 -0
  30. package/dist/edit-policy.d.ts.map +1 -0
  31. package/dist/edit-policy.js +6 -0
  32. package/dist/edit-policy.js.map +1 -0
  33. package/dist/edits.d.ts +10 -0
  34. package/dist/edits.d.ts.map +1 -0
  35. package/dist/edits.js +1392 -0
  36. package/dist/edits.js.map +1 -0
  37. package/dist/engine-types.d.ts +110 -60
  38. package/dist/engine-types.d.ts.map +1 -1
  39. package/dist/engine-types.js +33 -0
  40. package/dist/engine-types.js.map +1 -1
  41. package/dist/engine.d.ts +69 -8
  42. package/dist/engine.d.ts.map +1 -1
  43. package/dist/engine.js +24 -18
  44. package/dist/engine.js.map +1 -1
  45. package/dist/files.d.ts.map +1 -1
  46. package/dist/files.js +31 -27
  47. package/dist/files.js.map +1 -1
  48. package/dist/fork.d.ts +147 -0
  49. package/dist/fork.d.ts.map +1 -0
  50. package/dist/fork.js +609 -0
  51. package/dist/fork.js.map +1 -0
  52. package/dist/history.d.ts +0 -4
  53. package/dist/history.d.ts.map +1 -1
  54. package/dist/history.js +166 -595
  55. package/dist/history.js.map +1 -1
  56. package/dist/index.d.ts +16 -4
  57. package/dist/index.d.ts.map +1 -1
  58. package/dist/index.js +12 -2
  59. package/dist/index.js.map +1 -1
  60. package/dist/job-queue.d.ts +2 -0
  61. package/dist/job-queue.d.ts.map +1 -1
  62. package/dist/job-queue.js +29 -2
  63. package/dist/job-queue.js.map +1 -1
  64. package/dist/media.d.ts.map +1 -1
  65. package/dist/media.js +1 -0
  66. package/dist/media.js.map +1 -1
  67. package/dist/merge-policy.d.ts +99 -0
  68. package/dist/merge-policy.d.ts.map +1 -0
  69. package/dist/merge-policy.js +310 -0
  70. package/dist/merge-policy.js.map +1 -0
  71. package/dist/metadata.d.ts.map +1 -1
  72. package/dist/metadata.js +15 -20
  73. package/dist/metadata.js.map +1 -1
  74. package/dist/migration.d.ts +9 -0
  75. package/dist/migration.d.ts.map +1 -0
  76. package/dist/migration.js +534 -0
  77. package/dist/migration.js.map +1 -0
  78. package/dist/mvp-contract-fixtures.d.ts +244 -0
  79. package/dist/mvp-contract-fixtures.d.ts.map +1 -0
  80. package/dist/mvp-contract-fixtures.js +556 -0
  81. package/dist/mvp-contract-fixtures.js.map +1 -0
  82. package/dist/mvp-contracts.d.ts +761 -0
  83. package/dist/mvp-contracts.d.ts.map +1 -0
  84. package/dist/mvp-contracts.js +59 -0
  85. package/dist/mvp-contracts.js.map +1 -0
  86. package/dist/mvp-time.d.ts +54 -0
  87. package/dist/mvp-time.d.ts.map +1 -0
  88. package/dist/mvp-time.js +148 -0
  89. package/dist/mvp-time.js.map +1 -0
  90. package/dist/notebook/types.d.ts +113 -8
  91. package/dist/notebook/types.d.ts.map +1 -1
  92. package/dist/order-keys.d.ts +22 -0
  93. package/dist/order-keys.d.ts.map +1 -0
  94. package/dist/order-keys.js +262 -0
  95. package/dist/order-keys.js.map +1 -0
  96. package/dist/runtime-services.js +4 -2
  97. package/dist/runtime-services.js.map +1 -1
  98. package/dist/schema.d.ts +24 -5
  99. package/dist/schema.d.ts.map +1 -1
  100. package/dist/schema.js +644 -132
  101. package/dist/schema.js.map +1 -1
  102. package/dist/search-benchmark.d.ts +4 -0
  103. package/dist/search-benchmark.d.ts.map +1 -0
  104. package/dist/search-benchmark.js +144 -0
  105. package/dist/search-benchmark.js.map +1 -0
  106. package/dist/sequences.d.ts +20 -0
  107. package/dist/sequences.d.ts.map +1 -0
  108. package/dist/sequences.js +825 -0
  109. package/dist/sequences.js.map +1 -0
  110. package/dist/similarity.js +1 -1
  111. package/dist/storage.d.ts +3 -1
  112. package/dist/storage.d.ts.map +1 -1
  113. package/dist/storage.js +388 -7
  114. package/dist/storage.js.map +1 -1
  115. package/dist/store.d.ts +63 -2
  116. package/dist/store.d.ts.map +1 -1
  117. package/dist/store.js +351 -65
  118. package/dist/store.js.map +1 -1
  119. package/dist/streams.d.ts +10 -0
  120. package/dist/streams.d.ts.map +1 -0
  121. package/dist/streams.js +183 -0
  122. package/dist/streams.js.map +1 -0
  123. package/dist/temporal-models.d.ts +48 -0
  124. package/dist/temporal-models.d.ts.map +1 -0
  125. package/dist/temporal-models.js +278 -0
  126. package/dist/temporal-models.js.map +1 -0
  127. package/dist/temporal-search.d.ts +29 -0
  128. package/dist/temporal-search.d.ts.map +1 -0
  129. package/dist/temporal-search.js +1507 -0
  130. package/dist/temporal-search.js.map +1 -0
  131. package/dist/transcripts.d.ts +16 -0
  132. package/dist/transcripts.d.ts.map +1 -0
  133. package/dist/transcripts.js +519 -0
  134. package/dist/transcripts.js.map +1 -0
  135. package/docs/engine-layout.md +346 -106
  136. package/docs/mvp-prd.md +918 -0
  137. package/fixtures/media/vancat.mp4 +0 -0
  138. package/fixtures/media/vancat_profile.jpg +0 -0
  139. package/fixtures/v5/contract-fixtures.json +1532 -0
  140. package/package.json +30 -5
  141. package/dist/history-types.d.ts +0 -74
  142. package/dist/history-types.d.ts.map +0 -1
  143. package/dist/history-types.js +0 -2
  144. package/dist/history-types.js.map +0 -1
  145. package/dist/timeline.d.ts +0 -9
  146. package/dist/timeline.d.ts.map +0 -1
  147. package/dist/timeline.js +0 -236
  148. package/dist/timeline.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,eAAe;IACf,MAAM;IACN,WAAW;IACX,SAAS;IACT,gBAAgB;IAChB,eAAe;IACf,mBAAmB;IACnB,UAAU;IACV,WAAW;IACX,OAAO;IACP,OAAO;IACP,MAAM;IACN,UAAU;IACV,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,gBAAgB;IAChB,UAAU;IACV,YAAY;IACZ,SAAS;IACT,eAAe;IACf,gBAAgB;IAChB,kBAAkB;IAClB,kBAAkB;IAClB,UAAU;CACF,CAAC;AAIX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,cAAc;IACd,cAAc;IACd,yBAAyB;IACzB,6BAA6B;IAC7B,2BAA2B;IAC3B,wBAAwB;IACxB,uBAAuB;IACvB,2BAA2B;IAC3B,kBAAkB;IAClB,cAAc;IACd,uBAAuB;IACvB,+BAA+B;IAC/B,mCAAmC;IACnC,gCAAgC;CACxB,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgRlC,CAAC;AAEF,MAAM,6BAA6B,GAAG;;;;;;;;;;;;;;;;;;CAkBrC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiI9B,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0ChC,CAAC"}
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { SearchBenchmarkCase, SearchBenchmarkReport, SearchPage } from "./mvp-contracts.js";
2
+ export declare function evaluateSearchBenchmark(corpusVersion: string, manifestIds: string[], cases: SearchBenchmarkCase[], search: (item: SearchBenchmarkCase) => Promise<SearchPage>): Promise<SearchBenchmarkReport>;
3
+ export declare function compareSearchBenchmarks(baseline: SearchBenchmarkReport, candidate: SearchBenchmarkReport, maximumRegression?: number): string[];
4
+ //# sourceMappingURL=search-benchmark.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search-benchmark.d.ts","sourceRoot":"","sources":["../src/search-benchmark.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAInB,qBAAqB,EAErB,UAAU,EACX,MAAM,oBAAoB,CAAC;AAoB5B,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,mBAAmB,EAAE,EAC5B,MAAM,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,UAAU,CAAC,GACzD,OAAO,CAAC,qBAAqB,CAAC,CA+DhC;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,qBAAqB,EAC/B,SAAS,EAAE,qBAAqB,EAChC,iBAAiB,SAAO,GACvB,MAAM,EAAE,CAiBV"}
@@ -0,0 +1,144 @@
1
+ const CLASSES = [
2
+ "natural-language-visual",
3
+ "quoted-speech-ocr",
4
+ "reverse-image-exact",
5
+ "reverse-image-semantic",
6
+ "reverse-video",
7
+ "audio",
8
+ ];
9
+ const RECALL_THRESHOLDS = {
10
+ "natural-language-visual": 0.8,
11
+ "quoted-speech-ocr": 0.95,
12
+ "reverse-image-semantic": 0.85,
13
+ "reverse-video": 0.75,
14
+ audio: 0.8,
15
+ };
16
+ export async function evaluateSearchBenchmark(corpusVersion, manifestIds, cases, search) {
17
+ const caseResults = [];
18
+ for (const item of cases) {
19
+ const started = performance.now();
20
+ const page = await search(item);
21
+ const latencyMs = performance.now() - started;
22
+ const hits = page.hits.slice(0, 5);
23
+ const relevant = hits.filter((hit) => item.judgments.some((judgment) => hitMatches(hit, judgment)));
24
+ const boundaryErrors = hits.flatMap((hit) => item.judgments.flatMap((judgment) => {
25
+ const error = boundaryErrorMs(hit, judgment.range);
26
+ return error === undefined ? [] : [error];
27
+ }));
28
+ caseResults.push({
29
+ caseId: item.caseId,
30
+ class: item.class,
31
+ latencyMs,
32
+ recallAt5: item.judgments.length === 0
33
+ ? 0
34
+ : Math.min(1, relevant.length / item.judgments.length),
35
+ top1Correct: page.hits[0] !== undefined
36
+ && item.judgments.some((judgment) => hitMatches(page.hits[0], judgment)),
37
+ ...(boundaryErrors.length > 0
38
+ ? { boundaryErrorMs: Math.min(...boundaryErrors) }
39
+ : {}),
40
+ });
41
+ }
42
+ const classes = CLASSES.flatMap((className) => {
43
+ const values = caseResults.filter((item) => item.class === className);
44
+ return values.length === 0 ? [] : [classMetrics(className, values)];
45
+ });
46
+ const latencies = caseResults.map((item) => item.latencyMs);
47
+ const boundaryErrors = caseResults.flatMap((item) => item.boundaryErrorMs === undefined ? [] : [item.boundaryErrorMs]);
48
+ const latencyP50Ms = percentile(latencies, 0.5);
49
+ const latencyP95Ms = percentile(latencies, 0.95);
50
+ const medianBoundaryErrorMs = boundaryErrors.length > 0 ? percentile(boundaryErrors, 0.5) : undefined;
51
+ const failures = reportFailures(classes, latencyP50Ms, latencyP95Ms, medianBoundaryErrorMs);
52
+ return {
53
+ corpusVersion,
54
+ manifestIds: [...manifestIds].sort(),
55
+ caseResults,
56
+ classes,
57
+ latencyP50Ms,
58
+ latencyP95Ms,
59
+ ...(medianBoundaryErrorMs === undefined ? {} : { medianBoundaryErrorMs }),
60
+ passed: failures.length === 0,
61
+ failures,
62
+ };
63
+ }
64
+ export function compareSearchBenchmarks(baseline, candidate, maximumRegression = 0.05) {
65
+ const failures = [];
66
+ for (const current of candidate.classes) {
67
+ const prior = baseline.classes.find((item) => item.class === current.class);
68
+ if (!prior)
69
+ continue;
70
+ if (prior.recallAt5 - current.recallAt5 > maximumRegression) {
71
+ failures.push(`${current.class} recall@5 regressed by ${(prior.recallAt5 - current.recallAt5).toFixed(3)}`);
72
+ }
73
+ if (prior.top1Accuracy - current.top1Accuracy > maximumRegression) {
74
+ failures.push(`${current.class} top-1 regressed by ${(prior.top1Accuracy - current.top1Accuracy).toFixed(3)}`);
75
+ }
76
+ }
77
+ return failures;
78
+ }
79
+ function classMetrics(className, values) {
80
+ return {
81
+ class: className,
82
+ caseCount: values.length,
83
+ recallAt5: values.reduce((sum, item) => sum + item.recallAt5, 0) / values.length,
84
+ top1Accuracy: values.filter((item) => item.top1Correct).length / values.length,
85
+ };
86
+ }
87
+ function hitMatches(hit, judgment) {
88
+ if (hit.artifactId !== judgment.artifactId)
89
+ return false;
90
+ if (!judgment.range)
91
+ return true;
92
+ if (hit.location.kind !== "timed")
93
+ return false;
94
+ const range = hit.location.range;
95
+ if (range.streamId !== judgment.range.streamId)
96
+ return false;
97
+ return (range.startTick < judgment.range.startTick + judgment.range.durationTicks
98
+ && judgment.range.startTick < range.startTick + range.durationTicks);
99
+ }
100
+ function boundaryErrorMs(hit, judgment) {
101
+ if (!judgment || hit.location.kind !== "timed")
102
+ return undefined;
103
+ const range = hit.location.range;
104
+ if (range.streamId !== judgment.streamId)
105
+ return undefined;
106
+ const startError = Math.abs(range.startTick - judgment.startTick);
107
+ const endError = Math.abs(range.startTick
108
+ + range.durationTicks
109
+ - judgment.startTick
110
+ - judgment.durationTicks);
111
+ return (((startError + endError) / 2)
112
+ * judgment.timeBase.numerator
113
+ * 1_000
114
+ / judgment.timeBase.denominator);
115
+ }
116
+ function reportFailures(classes, latencyP50Ms, latencyP95Ms, medianBoundaryErrorMs) {
117
+ const failures = [];
118
+ for (const metrics of classes) {
119
+ const threshold = RECALL_THRESHOLDS[metrics.class];
120
+ if (threshold !== undefined && metrics.recallAt5 < threshold) {
121
+ failures.push(`${metrics.class} recall@5 ${metrics.recallAt5.toFixed(3)} is below ${threshold.toFixed(2)}`);
122
+ }
123
+ if (metrics.class === "reverse-image-exact"
124
+ && metrics.top1Accuracy < 0.95) {
125
+ failures.push(`reverse-image-exact top-1 ${metrics.top1Accuracy.toFixed(3)} is below 0.95`);
126
+ }
127
+ }
128
+ if (latencyP50Ms >= 500)
129
+ failures.push("Warm search p50 is not under 500 ms");
130
+ if (latencyP95Ms >= 1_500)
131
+ failures.push("Warm search p95 is not under 1.5 s");
132
+ if (medianBoundaryErrorMs !== undefined && medianBoundaryErrorMs >= 1_000) {
133
+ failures.push("Median boundary error is not under 1.0 s");
134
+ }
135
+ return failures;
136
+ }
137
+ function percentile(values, quantile) {
138
+ if (values.length === 0)
139
+ return 0;
140
+ const sorted = [...values].sort((left, right) => left - right);
141
+ const index = Math.min(sorted.length - 1, Math.max(0, Math.ceil(sorted.length * quantile) - 1));
142
+ return sorted[index];
143
+ }
144
+ //# sourceMappingURL=search-benchmark.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search-benchmark.js","sourceRoot":"","sources":["../src/search-benchmark.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,GAA2B;IACtC,yBAAyB;IACzB,mBAAmB;IACnB,qBAAqB;IACrB,wBAAwB;IACxB,eAAe;IACf,OAAO;CACR,CAAC;AAEF,MAAM,iBAAiB,GAAkD;IACvE,yBAAyB,EAAE,GAAG;IAC9B,mBAAmB,EAAE,IAAI;IACzB,wBAAwB,EAAE,IAAI;IAC9B,eAAe,EAAE,IAAI;IACrB,KAAK,EAAE,GAAG;CACX,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,aAAqB,EACrB,WAAqB,EACrB,KAA4B,EAC5B,MAA0D;IAE1D,MAAM,WAAW,GAAgC,EAAE,CAAC;IACpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CACnC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAC7D,CAAC;QACF,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAC1C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAClC,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YACnD,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC,CAAC,CACH,CAAC;QACF,WAAW,CAAC,IAAI,CAAC;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS;YACT,SAAS,EACP,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;gBACzB,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YAC1D,WAAW,EACT,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;mBACvB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAClC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,QAAQ,CAAC,CACpC;YACH,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;gBAC3B,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,EAAE;gBAClD,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;QACtE,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5D,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAClD,IAAI,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CACjE,CAAC;IACF,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,qBAAqB,GACzB,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,MAAM,QAAQ,GAAG,cAAc,CAC7B,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,qBAAqB,CACtB,CAAC;IACF,OAAO;QACL,aAAa;QACb,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,EAAE;QACpC,WAAW;QACX,OAAO;QACP,YAAY;QACZ,YAAY;QACZ,GAAG,CAAC,qBAAqB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC;QACzE,MAAM,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC7B,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAA+B,EAC/B,SAAgC,EAChC,iBAAiB,GAAG,IAAI;IAExB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,IAAI,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,GAAG,iBAAiB,EAAE,CAAC;YAC5D,QAAQ,CAAC,IAAI,CACX,GAAG,OAAO,CAAC,KAAK,0BAA0B,CAAC,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAC7F,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,GAAG,iBAAiB,EAAE,CAAC;YAClE,QAAQ,CAAC,IAAI,CACX,GAAG,OAAO,CAAC,KAAK,uBAAuB,CAAC,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAChG,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CACnB,SAA+B,EAC/B,MAAmC;IAEnC,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,SAAS,EAAE,MAAM,CAAC,MAAM;QACxB,SAAS,EACP,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM;QACvE,YAAY,EACV,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;KACnE,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,GAAc,EACd,QAAqD;IAErD,IAAI,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IACzD,IAAI,CAAC,QAAQ,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;IACjC,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,KAAK,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC7D,OAAO,CACL,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,aAAa;WACtE,QAAQ,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,aAAa,CACpE,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,GAAc,EACd,QAAiC;IAEjC,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IACjE,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;IACjC,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CACvB,KAAK,CAAC,SAAS;UACX,KAAK,CAAC,aAAa;UACnB,QAAQ,CAAC,SAAS;UAClB,QAAQ,CAAC,aAAa,CAC3B,CAAC;IACF,OAAO,CACL,CAAC,CAAC,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;UAC3B,QAAQ,CAAC,QAAQ,CAAC,SAAS;UAC3B,KAAK;UACL,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAChC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,OAAsC,EACtC,YAAoB,EACpB,YAAoB,EACpB,qBAAyC;IAEzC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,SAAS,EAAE,CAAC;YAC7D,QAAQ,CAAC,IAAI,CACX,GAAG,OAAO,CAAC,KAAK,aAAa,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAC7F,CAAC;QACJ,CAAC;QACD,IACE,OAAO,CAAC,KAAK,KAAK,qBAAqB;eACpC,OAAO,CAAC,YAAY,GAAG,IAAI,EAC9B,CAAC;YACD,QAAQ,CAAC,IAAI,CACX,6BAA6B,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAC7E,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,YAAY,IAAI,GAAG;QAAE,QAAQ,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAC9E,IAAI,YAAY,IAAI,KAAK;QAAE,QAAQ,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IAC/E,IAAI,qBAAqB,KAAK,SAAS,IAAI,qBAAqB,IAAI,KAAK,EAAE,CAAC;QAC1E,QAAQ,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,UAAU,CAAC,MAAgB,EAAE,QAAgB;IACpD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,MAAM,CAAC,MAAM,GAAG,CAAC,EACjB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CACrD,CAAC;IACF,OAAO,MAAM,CAAC,KAAK,CAAE,CAAC;AACxB,CAAC"}
@@ -0,0 +1,20 @@
1
+ import type { EngineError, Result } from "./engine-types.js";
2
+ import type { CreateSequenceTrackInput, CreateSequenceInput, Sequence, UpdateSequenceCanvasInput, UpdateSequenceTrackInput } from "./mvp-contracts.js";
3
+ import { EngineContext } from "./context.js";
4
+ export declare function createSequencesApi(context: EngineContext): {
5
+ create: (input: CreateSequenceInput) => Promise<Result<Sequence, EngineError>>;
6
+ list: () => Sequence[];
7
+ get: (sequenceId: string) => Result<Sequence, EngineError>;
8
+ getPrimary: () => Sequence;
9
+ getAtRevision: (sequenceId: string, revision: string) => Result<Sequence, EngineError>;
10
+ rename: (sequenceId: string, name: string) => Promise<Result<Sequence, EngineError>>;
11
+ updateCanvas: (sequenceId: string, input: UpdateSequenceCanvasInput) => Promise<Result<Sequence, EngineError>>;
12
+ updateTrack: (trackId: string, input: UpdateSequenceTrackInput) => Promise<Result<Sequence, EngineError>>;
13
+ addTrack: (sequenceId: string, input: CreateSequenceTrackInput) => Promise<Result<Sequence, EngineError>>;
14
+ moveTrack: (trackId: string, toOrdinal: number) => Promise<Result<Sequence, EngineError>>;
15
+ removeTrack: (trackId: string) => Promise<Result<Sequence, EngineError>>;
16
+ delete: (sequenceId: string) => Promise<Result<{
17
+ sequenceId: string;
18
+ }, EngineError>>;
19
+ };
20
+ //# sourceMappingURL=sequences.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sequences.d.ts","sourceRoot":"","sources":["../src/sequences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,KAAK,EAMV,wBAAwB,EACxB,mBAAmB,EACnB,QAAQ,EAKR,yBAAyB,EACzB,wBAAwB,EAEzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAA0B,MAAM,cAAc,CAAC;AA6GrE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa;oBAG5C,mBAAmB,KACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;gBAC/B,QAAQ,EAAE;sBACF,MAAM,KAAG,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC;sBAExC,QAAQ;gCAEV,MAAM,YACR,MAAM,KACf,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC;yBAGlB,MAAM,QACZ,MAAM,KACX,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;+BAG3B,MAAM,SACX,yBAAyB,KAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;2BAG9B,MAAM,SACR,wBAAwB,KAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;2BAG3B,MAAM,SACX,wBAAwB,KAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;yBAG9B,MAAM,aACJ,MAAM,KAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;2BAElB,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;yBAGxD,MAAM,KACjB,OAAO,CAAC,MAAM,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,WAAW,CAAC,CAAC;EAG1D"}