@scanly/core 2.0.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 (226) hide show
  1. package/README.md +3 -0
  2. package/dist/barcode/contracts.d.ts +44 -0
  3. package/dist/barcode/contracts.d.ts.map +1 -0
  4. package/dist/barcode/contracts.js +33 -0
  5. package/dist/barcode/contracts.js.map +1 -0
  6. package/dist/barcode/format-selection.d.ts +12 -0
  7. package/dist/barcode/format-selection.d.ts.map +1 -0
  8. package/dist/barcode/format-selection.js +32 -0
  9. package/dist/barcode/format-selection.js.map +1 -0
  10. package/dist/barcode/format.d.ts +7 -0
  11. package/dist/barcode/format.d.ts.map +1 -0
  12. package/dist/barcode/format.js +20 -0
  13. package/dist/barcode/format.js.map +1 -0
  14. package/dist/barcode/index.d.ts +5 -0
  15. package/dist/barcode/index.d.ts.map +1 -0
  16. package/dist/barcode/index.js +5 -0
  17. package/dist/barcode/index.js.map +1 -0
  18. package/dist/barcode/retail.d.ts +16 -0
  19. package/dist/barcode/retail.d.ts.map +1 -0
  20. package/dist/barcode/retail.js +95 -0
  21. package/dist/barcode/retail.js.map +1 -0
  22. package/dist/contracts/engine.d.ts +84 -0
  23. package/dist/contracts/engine.d.ts.map +1 -0
  24. package/dist/contracts/engine.js +2 -0
  25. package/dist/contracts/engine.js.map +1 -0
  26. package/dist/contracts/errors.d.ts +17 -0
  27. package/dist/contracts/errors.d.ts.map +1 -0
  28. package/dist/contracts/errors.js +31 -0
  29. package/dist/contracts/errors.js.map +1 -0
  30. package/dist/contracts/frame.d.ts +37 -0
  31. package/dist/contracts/frame.d.ts.map +1 -0
  32. package/dist/contracts/frame.js +77 -0
  33. package/dist/contracts/frame.js.map +1 -0
  34. package/dist/contracts/operator.d.ts +46 -0
  35. package/dist/contracts/operator.d.ts.map +1 -0
  36. package/dist/contracts/operator.js +14 -0
  37. package/dist/contracts/operator.js.map +1 -0
  38. package/dist/contracts/result.d.ts +135 -0
  39. package/dist/contracts/result.d.ts.map +1 -0
  40. package/dist/contracts/result.js +2 -0
  41. package/dist/contracts/result.js.map +1 -0
  42. package/dist/contracts/validator.d.ts +15 -0
  43. package/dist/contracts/validator.d.ts.map +1 -0
  44. package/dist/contracts/validator.js +2 -0
  45. package/dist/contracts/validator.js.map +1 -0
  46. package/dist/index.d.ts +29 -0
  47. package/dist/index.d.ts.map +1 -0
  48. package/dist/index.js +28 -0
  49. package/dist/index.js.map +1 -0
  50. package/dist/industrial/candidate-region.d.ts +15 -0
  51. package/dist/industrial/candidate-region.d.ts.map +1 -0
  52. package/dist/industrial/candidate-region.js +108 -0
  53. package/dist/industrial/candidate-region.js.map +1 -0
  54. package/dist/industrial/coordinate-transform.d.ts +9 -0
  55. package/dist/industrial/coordinate-transform.d.ts.map +1 -0
  56. package/dist/industrial/coordinate-transform.js +42 -0
  57. package/dist/industrial/coordinate-transform.js.map +1 -0
  58. package/dist/industrial/decode-candidate-conflict.d.ts +8 -0
  59. package/dist/industrial/decode-candidate-conflict.d.ts.map +1 -0
  60. package/dist/industrial/decode-candidate-conflict.js +97 -0
  61. package/dist/industrial/decode-candidate-conflict.js.map +1 -0
  62. package/dist/industrial/difficulty-diagnosis.d.ts +15 -0
  63. package/dist/industrial/difficulty-diagnosis.d.ts.map +1 -0
  64. package/dist/industrial/difficulty-diagnosis.js +291 -0
  65. package/dist/industrial/difficulty-diagnosis.js.map +1 -0
  66. package/dist/industrial/index.d.ts +13 -0
  67. package/dist/industrial/index.d.ts.map +1 -0
  68. package/dist/industrial/index.js +13 -0
  69. package/dist/industrial/index.js.map +1 -0
  70. package/dist/industrial/memory.d.ts +28 -0
  71. package/dist/industrial/memory.d.ts.map +1 -0
  72. package/dist/industrial/memory.js +65 -0
  73. package/dist/industrial/memory.js.map +1 -0
  74. package/dist/industrial/pixels.d.ts +44 -0
  75. package/dist/industrial/pixels.d.ts.map +1 -0
  76. package/dist/industrial/pixels.js +295 -0
  77. package/dist/industrial/pixels.js.map +1 -0
  78. package/dist/industrial/recovery-pipeline.d.ts +26 -0
  79. package/dist/industrial/recovery-pipeline.d.ts.map +1 -0
  80. package/dist/industrial/recovery-pipeline.js +149 -0
  81. package/dist/industrial/recovery-pipeline.js.map +1 -0
  82. package/dist/industrial/recovery-planner.d.ts +10 -0
  83. package/dist/industrial/recovery-planner.d.ts.map +1 -0
  84. package/dist/industrial/recovery-planner.js +107 -0
  85. package/dist/industrial/recovery-planner.js.map +1 -0
  86. package/dist/industrial/recovery-route-registry.d.ts +12 -0
  87. package/dist/industrial/recovery-route-registry.d.ts.map +1 -0
  88. package/dist/industrial/recovery-route-registry.js +15 -0
  89. package/dist/industrial/recovery-route-registry.js.map +1 -0
  90. package/dist/industrial/recovery-routes.d.ts +89 -0
  91. package/dist/industrial/recovery-routes.d.ts.map +1 -0
  92. package/dist/industrial/recovery-routes.js +280 -0
  93. package/dist/industrial/recovery-routes.js.map +1 -0
  94. package/dist/industrial/scan-evidence.d.ts +5 -0
  95. package/dist/industrial/scan-evidence.d.ts.map +1 -0
  96. package/dist/industrial/scan-evidence.js +63 -0
  97. package/dist/industrial/scan-evidence.js.map +1 -0
  98. package/dist/industrial/scanner-diagnostics.d.ts +19 -0
  99. package/dist/industrial/scanner-diagnostics.d.ts.map +1 -0
  100. package/dist/industrial/scanner-diagnostics.js +35 -0
  101. package/dist/industrial/scanner-diagnostics.js.map +1 -0
  102. package/dist/industrial/types.d.ts +189 -0
  103. package/dist/industrial/types.d.ts.map +1 -0
  104. package/dist/industrial/types.js +2 -0
  105. package/dist/industrial/types.js.map +1 -0
  106. package/dist/node.d.ts +2 -0
  107. package/dist/node.d.ts.map +1 -0
  108. package/dist/node.js +2 -0
  109. package/dist/node.js.map +1 -0
  110. package/dist/qr/candidate-dedupe.d.ts +6 -0
  111. package/dist/qr/candidate-dedupe.d.ts.map +1 -0
  112. package/dist/qr/candidate-dedupe.js +27 -0
  113. package/dist/qr/candidate-dedupe.js.map +1 -0
  114. package/dist/qr/candidate-generation.d.ts +46 -0
  115. package/dist/qr/candidate-generation.d.ts.map +1 -0
  116. package/dist/qr/candidate-generation.js +277 -0
  117. package/dist/qr/candidate-generation.js.map +1 -0
  118. package/dist/qr/decode-pipeline.d.ts +14 -0
  119. package/dist/qr/decode-pipeline.d.ts.map +1 -0
  120. package/dist/qr/decode-pipeline.js +615 -0
  121. package/dist/qr/decode-pipeline.js.map +1 -0
  122. package/dist/qr/geometry.d.ts +24 -0
  123. package/dist/qr/geometry.d.ts.map +1 -0
  124. package/dist/qr/geometry.js +64 -0
  125. package/dist/qr/geometry.js.map +1 -0
  126. package/dist/qr/grayscale.d.ts +13 -0
  127. package/dist/qr/grayscale.d.ts.map +1 -0
  128. package/dist/qr/grayscale.js +46 -0
  129. package/dist/qr/grayscale.js.map +1 -0
  130. package/dist/qr/image-loader-node.d.ts +4 -0
  131. package/dist/qr/image-loader-node.d.ts.map +1 -0
  132. package/dist/qr/image-loader-node.js +26 -0
  133. package/dist/qr/image-loader-node.js.map +1 -0
  134. package/dist/qr/index.d.ts +15 -0
  135. package/dist/qr/index.d.ts.map +1 -0
  136. package/dist/qr/index.js +15 -0
  137. package/dist/qr/index.js.map +1 -0
  138. package/dist/qr/jsqr-decoder.d.ts +10 -0
  139. package/dist/qr/jsqr-decoder.d.ts.map +1 -0
  140. package/dist/qr/jsqr-decoder.js +18 -0
  141. package/dist/qr/jsqr-decoder.js.map +1 -0
  142. package/dist/qr/preprocess.d.ts +18 -0
  143. package/dist/qr/preprocess.d.ts.map +1 -0
  144. package/dist/qr/preprocess.js +165 -0
  145. package/dist/qr/preprocess.js.map +1 -0
  146. package/dist/qr/region-detection.d.ts +25 -0
  147. package/dist/qr/region-detection.d.ts.map +1 -0
  148. package/dist/qr/region-detection.js +129 -0
  149. package/dist/qr/region-detection.js.map +1 -0
  150. package/dist/qr/result-normalizer.d.ts +9 -0
  151. package/dist/qr/result-normalizer.d.ts.map +1 -0
  152. package/dist/qr/result-normalizer.js +70 -0
  153. package/dist/qr/result-normalizer.js.map +1 -0
  154. package/dist/qr/rotate.d.ts +5 -0
  155. package/dist/qr/rotate.d.ts.map +1 -0
  156. package/dist/qr/rotate.js +51 -0
  157. package/dist/qr/rotate.js.map +1 -0
  158. package/dist/qr/types.d.ts +186 -0
  159. package/dist/qr/types.d.ts.map +1 -0
  160. package/dist/qr/types.js +67 -0
  161. package/dist/qr/types.js.map +1 -0
  162. package/dist/qr/zxing-decoder.d.ts +8 -0
  163. package/dist/qr/zxing-decoder.d.ts.map +1 -0
  164. package/dist/qr/zxing-decoder.js +33 -0
  165. package/dist/qr/zxing-decoder.js.map +1 -0
  166. package/dist/runtime/artifacts.d.ts +16 -0
  167. package/dist/runtime/artifacts.d.ts.map +1 -0
  168. package/dist/runtime/artifacts.js +52 -0
  169. package/dist/runtime/artifacts.js.map +1 -0
  170. package/dist/runtime/builtin-operators.d.ts +12 -0
  171. package/dist/runtime/builtin-operators.d.ts.map +1 -0
  172. package/dist/runtime/builtin-operators.js +487 -0
  173. package/dist/runtime/builtin-operators.js.map +1 -0
  174. package/dist/runtime/capabilities.d.ts +32 -0
  175. package/dist/runtime/capabilities.d.ts.map +1 -0
  176. package/dist/runtime/capabilities.js +18 -0
  177. package/dist/runtime/capabilities.js.map +1 -0
  178. package/dist/runtime/engine-registry.d.ts +19 -0
  179. package/dist/runtime/engine-registry.d.ts.map +1 -0
  180. package/dist/runtime/engine-registry.js +136 -0
  181. package/dist/runtime/engine-registry.js.map +1 -0
  182. package/dist/runtime/execution-budget.d.ts +25 -0
  183. package/dist/runtime/execution-budget.d.ts.map +1 -0
  184. package/dist/runtime/execution-budget.js +41 -0
  185. package/dist/runtime/execution-budget.js.map +1 -0
  186. package/dist/runtime/frame-lease.d.ts +10 -0
  187. package/dist/runtime/frame-lease.d.ts.map +1 -0
  188. package/dist/runtime/frame-lease.js +17 -0
  189. package/dist/runtime/frame-lease.js.map +1 -0
  190. package/dist/runtime/frame-normalization.d.ts +13 -0
  191. package/dist/runtime/frame-normalization.d.ts.map +1 -0
  192. package/dist/runtime/frame-normalization.js +21 -0
  193. package/dist/runtime/frame-normalization.js.map +1 -0
  194. package/dist/runtime/memory-budget.d.ts +32 -0
  195. package/dist/runtime/memory-budget.d.ts.map +1 -0
  196. package/dist/runtime/memory-budget.js +109 -0
  197. package/dist/runtime/memory-budget.js.map +1 -0
  198. package/dist/runtime/operator-registry.d.ts +11 -0
  199. package/dist/runtime/operator-registry.d.ts.map +1 -0
  200. package/dist/runtime/operator-registry.js +19 -0
  201. package/dist/runtime/operator-registry.js.map +1 -0
  202. package/dist/runtime/result-policies.d.ts +21 -0
  203. package/dist/runtime/result-policies.d.ts.map +1 -0
  204. package/dist/runtime/result-policies.js +62 -0
  205. package/dist/runtime/result-policies.js.map +1 -0
  206. package/dist/runtime/router.d.ts +45 -0
  207. package/dist/runtime/router.d.ts.map +1 -0
  208. package/dist/runtime/router.js +202 -0
  209. package/dist/runtime/router.js.map +1 -0
  210. package/dist/runtime/scenario-compiler.d.ts +32 -0
  211. package/dist/runtime/scenario-compiler.d.ts.map +1 -0
  212. package/dist/runtime/scenario-compiler.js +131 -0
  213. package/dist/runtime/scenario-compiler.js.map +1 -0
  214. package/dist/runtime/scenario-runtime.d.ts +4 -0
  215. package/dist/runtime/scenario-runtime.d.ts.map +1 -0
  216. package/dist/runtime/scenario-runtime.js +32 -0
  217. package/dist/runtime/scenario-runtime.js.map +1 -0
  218. package/dist/runtime/session.d.ts +40 -0
  219. package/dist/runtime/session.d.ts.map +1 -0
  220. package/dist/runtime/session.js +117 -0
  221. package/dist/runtime/session.js.map +1 -0
  222. package/dist/runtime/validator-registry.d.ts +11 -0
  223. package/dist/runtime/validator-registry.d.ts.map +1 -0
  224. package/dist/runtime/validator-registry.js +16 -0
  225. package/dist/runtime/validator-registry.js.map +1 -0
  226. package/package.json +39 -0
@@ -0,0 +1,62 @@
1
+ /** Session-scoped, bounded duplicate suppression for continuous sources. */
2
+ export class DuplicateSuppressionPolicy {
3
+ windowMs;
4
+ identity;
5
+ seen = new Map();
6
+ maxEntries;
7
+ constructor(windowMs, identity = {}) {
8
+ this.windowMs = windowMs;
9
+ this.identity = identity;
10
+ this.maxEntries = Math.max(1, Math.min(10_000, identity.maxEntries ?? 256));
11
+ }
12
+ updateWindow(windowMs) {
13
+ this.windowMs = Math.max(0, windowMs);
14
+ this.clear();
15
+ }
16
+ filter(outcome, nowMs = Date.now()) {
17
+ this.prune(nowMs);
18
+ if (!outcome.ok || this.windowMs === 0)
19
+ return outcome;
20
+ const results = outcome.results.filter((result) => {
21
+ const key = this.key(result);
22
+ const previous = this.seen.get(key);
23
+ this.seen.delete(key);
24
+ this.seen.set(key, nowMs);
25
+ return previous === undefined || nowMs - previous >= this.windowMs;
26
+ });
27
+ if (!results.length) {
28
+ return {
29
+ ok: false,
30
+ error: { code: "no_symbol_found", category: "input", message: "Results were suppressed by the active duplicate policy.", retryable: true },
31
+ frameId: outcome.frameId,
32
+ scenarioId: outcome.scenarioId,
33
+ attemptCount: outcome.attemptCount,
34
+ timing: outcome.timing,
35
+ ...(outcome.trace ? { trace: outcome.trace } : {}),
36
+ ...(outcome.attempts ? { attempts: outcome.attempts } : {}),
37
+ };
38
+ }
39
+ const nonEmpty = results;
40
+ return { ...outcome, results: nonEmpty, primary: nonEmpty[0] };
41
+ }
42
+ clear() { this.seen.clear(); }
43
+ get size() { return this.seen.size; }
44
+ key(result) {
45
+ return [
46
+ result.rawText,
47
+ this.identity.includeFormat === false ? "" : result.format,
48
+ this.identity.includeSpatialTrack ? result.trackId ?? result.cornerPoints?.map((point) => `${Math.round(point.x)},${Math.round(point.y)}`).join(";") ?? "" : "",
49
+ ].join("\u001f");
50
+ }
51
+ prune(nowMs) {
52
+ for (const [key, at] of this.seen) {
53
+ if (nowMs - at >= this.windowMs || this.seen.size > this.maxEntries)
54
+ this.seen.delete(key);
55
+ else
56
+ break;
57
+ }
58
+ while (this.seen.size >= this.maxEntries)
59
+ this.seen.delete(this.seen.keys().next().value);
60
+ }
61
+ }
62
+ //# sourceMappingURL=result-policies.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"result-policies.js","sourceRoot":"","sources":["../../src/runtime/result-policies.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ import { type BarcodeFormat, type ScenarioDefinition } from "@scanly/scenario-schema";
2
+ import { type NormalizedFrame } from "../contracts/frame.js";
3
+ import type { ScanOutcome } from "../contracts/result.js";
4
+ import { EngineRegistry } from "./engine-registry.js";
5
+ import { OperatorRegistry } from "./operator-registry.js";
6
+ import { ScenarioCompiler } from "./scenario-compiler.js";
7
+ import { scenarioToPipelineConfig } from "./scenario-runtime.js";
8
+ import { ValidatorRegistry } from "./validator-registry.js";
9
+ import { type ScanlyCapabilities } from "./capabilities.js";
10
+ import { type FormatSelection } from "../barcode/format-selection.js";
11
+ export interface CaptureRouterOptions {
12
+ scenario?: ScenarioDefinition;
13
+ /** Explicit format opt-in. Omitted means the scenario's QR-only default. */
14
+ formats?: FormatSelection | readonly BarcodeFormat[];
15
+ engines?: EngineRegistry;
16
+ operators?: OperatorRegistry;
17
+ validators?: ValidatorRegistry;
18
+ compiler?: ScenarioCompiler;
19
+ now?: () => number;
20
+ }
21
+ export declare class CaptureRouter {
22
+ private scenario;
23
+ private readonly now;
24
+ readonly engines: EngineRegistry;
25
+ readonly operators: OperatorRegistry;
26
+ readonly validators: ValidatorRegistry;
27
+ readonly compiler: ScenarioCompiler;
28
+ private activeFrames;
29
+ private state;
30
+ private readonly activeOperations;
31
+ private disposePromise?;
32
+ constructor(options?: CaptureRouterOptions);
33
+ updateScenario(scenario: ScenarioDefinition): void;
34
+ getScenario(): ScenarioDefinition;
35
+ getCapabilities(): ScanlyCapabilities;
36
+ scan(frame: NormalizedFrame, options?: {
37
+ signal?: AbortSignal;
38
+ scenario?: ScenarioDefinition;
39
+ formats?: FormatSelection | readonly BarcodeFormat[];
40
+ }): Promise<ScanOutcome>;
41
+ dispose(): Promise<void>;
42
+ private assertUsable;
43
+ }
44
+ export { scenarioToPipelineConfig };
45
+ //# sourceMappingURL=router.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/runtime/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE5H,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5E,OAAO,KAAK,EAAgC,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGxF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAKhG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,4EAA4E;IAC5E,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,aAAa,EAAE,CAAC;IACrD,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AA+BD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,KAAK,CAAiD;IAC9D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6C;IAC9E,OAAO,CAAC,cAAc,CAAC,CAAgB;gBAE3B,OAAO,GAAE,oBAAyB;IAU9C,cAAc,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAQlD,WAAW,IAAI,kBAAkB;IACjC,eAAe,IAAI,kBAAkB;IAE/B,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;QAAC,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,aAAa,EAAE,CAAA;KAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAqG/K,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B,OAAO,CAAC,YAAY;CAGrB;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}
@@ -0,0 +1,202 @@
1
+ import { getBuiltinScenario, validateScenario } from "@scanly/scenario-schema";
2
+ import { SdkException, sdkError } from "../contracts/errors.js";
3
+ import { validateFrame } from "../contracts/frame.js";
4
+ import { BoundedFrameArtifactStore } from "./artifacts.js";
5
+ import { createDefaultOperatorRegistry } from "./builtin-operators.js";
6
+ import { EngineRegistry } from "./engine-registry.js";
7
+ import { FrameLease } from "./frame-lease.js";
8
+ import { OperatorRegistry } from "./operator-registry.js";
9
+ import { ScenarioCompiler } from "./scenario-compiler.js";
10
+ import { scenarioToPipelineConfig } from "./scenario-runtime.js";
11
+ import { ValidatorRegistry } from "./validator-registry.js";
12
+ import { ExecutionBudget, monotonicNow } from "./execution-budget.js";
13
+ import { FrameMemoryBudget } from "./memory-budget.js";
14
+ import { inspectCapabilities } from "./capabilities.js";
15
+ import { normalizeFormatSelection } from "../barcode/format-selection.js";
16
+ const MAX_TRACE_EVENTS = 256;
17
+ const MAX_TRACE_DETAIL_LENGTH = 512;
18
+ function failure(frameId, scenarioId, code, message, totalMs, trace, cause) {
19
+ return {
20
+ ok: false,
21
+ error: sdkError(code, message.slice(0, 2_048), undefined, cause),
22
+ frameId,
23
+ scenarioId,
24
+ attemptCount: 0,
25
+ timing: { totalMs },
26
+ ...(trace ? { trace } : {}),
27
+ };
28
+ }
29
+ function errorCode(error, signal, timedOut) {
30
+ if (timedOut)
31
+ return "timeout";
32
+ if (signal?.aborted)
33
+ return "cancelled";
34
+ if (error instanceof SdkException)
35
+ return error.error.code;
36
+ const code = error && typeof error === "object" && "code" in error ? String(error.code) : "";
37
+ if (code === "resource_limit_exceeded" || code === "unsupported_format" || code === "invalid_configuration" || code === "internal_invariant_failure")
38
+ return code;
39
+ return "engine_execution_failure";
40
+ }
41
+ export class CaptureRouter {
42
+ scenario;
43
+ now;
44
+ engines;
45
+ operators;
46
+ validators;
47
+ compiler;
48
+ activeFrames = 0;
49
+ state = "active";
50
+ activeOperations = new Map();
51
+ disposePromise;
52
+ constructor(options = {}) {
53
+ const initial = options.scenario ?? getBuiltinScenario("balanced");
54
+ this.scenario = options.formats ? { ...initial, acceptedFormats: [...normalizeFormatSelection(options.formats).formats] } : initial;
55
+ this.now = options.now ?? monotonicNow;
56
+ this.engines = options.engines ?? new EngineRegistry();
57
+ this.operators = options.operators ?? createDefaultOperatorRegistry();
58
+ this.validators = options.validators ?? new ValidatorRegistry();
59
+ this.compiler = options.compiler ?? new ScenarioCompiler(this.operators, this.engines, this.validators);
60
+ }
61
+ updateScenario(scenario) {
62
+ this.assertUsable();
63
+ const validated = validateScenario(scenario);
64
+ if (!validated.ok)
65
+ throw new SdkException(sdkError("malformed_scenario", validated.message, { issueCount: validated.issues.length }));
66
+ this.compiler.compile(validated.value);
67
+ this.scenario = validated.value;
68
+ }
69
+ getScenario() { return JSON.parse(JSON.stringify(this.scenario)); }
70
+ getCapabilities() { return inspectCapabilities(this.engines, this.operators); }
71
+ async scan(frame, options = {}) {
72
+ const lease = new FrameLease(frame);
73
+ let scenario = options.scenario ?? this.scenario;
74
+ if (options.formats)
75
+ scenario = { ...scenario, acceptedFormats: [...normalizeFormatSelection(options.formats).formats] };
76
+ const frameId = frame && typeof frame === "object" && typeof frame.id === "string" && frame.id ? frame.id : "invalid-frame";
77
+ const scenarioId = scenario && typeof scenario === "object" && typeof scenario.id === "string" ? scenario.id : "invalid";
78
+ const started = this.now();
79
+ const operationController = new AbortController();
80
+ let settleOperation;
81
+ const settledOperation = new Promise((resolve) => { settleOperation = resolve; });
82
+ this.activeOperations.set(operationController, settledOperation);
83
+ const trace = [];
84
+ const record = (stage, detail) => {
85
+ if (trace.length >= MAX_TRACE_EVENTS)
86
+ return;
87
+ trace.push({
88
+ atMs: Math.max(0, this.now() - started),
89
+ stage: stage.slice(0, 96),
90
+ ...(detail ? { detail: detail.slice(0, MAX_TRACE_DETAIL_LENGTH) } : {}),
91
+ });
92
+ };
93
+ const traceOutput = () => scenario?.output?.includeDebugTrace ? trace : undefined;
94
+ let active = false;
95
+ let artifacts;
96
+ let memoryBudget;
97
+ const memoryObservation = { currentControlledBytes: 0, peakControlledBytes: 0, retainedArtifactBytes: 0, retainedCacheBytes: 0, transientScratchBytes: 0 };
98
+ let timeoutId;
99
+ let timedOut = false;
100
+ let onAbort;
101
+ const phaseTimings = {};
102
+ try {
103
+ if (this.state !== "active")
104
+ return failure(frameId, scenarioId, "session_disposed", "Capture router is disposing or has been disposed.", this.now() - started, traceOutput());
105
+ const scenarioValidation = validateScenario(scenario);
106
+ if (!scenarioValidation.ok)
107
+ return failure(frameId, scenarioId, "malformed_scenario", scenarioValidation.message, this.now() - started, traceOutput());
108
+ const validatedScenario = scenarioValidation.value;
109
+ const frameIssues = validateFrame(frame);
110
+ if (frameIssues.length)
111
+ return failure(frameId, validatedScenario.id, "invalid_image", frameIssues.map((issue) => `${issue.path}: ${issue.message}`).join("\n"), this.now() - started, traceOutput());
112
+ if (!validatedScenario.input.preferredPixelFormats.includes(frame.pixelFormat)) {
113
+ return failure(frameId, validatedScenario.id, "unsupported_format", `Frame pixel format '${frame.pixelFormat}' is not enabled by input.preferredPixelFormats.`, this.now() - started, traceOutput());
114
+ }
115
+ if (frame.width * frame.height > validatedScenario.budgets.maxPixels) {
116
+ return failure(frameId, validatedScenario.id, "resource_limit_exceeded", `Frame has ${frame.width * frame.height} pixels; scenario limit is ${validatedScenario.budgets.maxPixels}.`, this.now() - started, traceOutput());
117
+ }
118
+ if (this.activeFrames >= validatedScenario.budgets.maxConcurrentFrames) {
119
+ return failure(frameId, validatedScenario.id, "concurrent_call_rejected", `Router concurrency limit is ${validatedScenario.budgets.maxConcurrentFrames} frame(s).`, this.now() - started, traceOutput());
120
+ }
121
+ const graph = this.compiler.compile(validatedScenario);
122
+ this.activeFrames += 1;
123
+ active = true;
124
+ memoryBudget = new FrameMemoryBudget(validatedScenario.budgets.maxIntermediateBytes);
125
+ artifacts = new BoundedFrameArtifactStore(validatedScenario.budgets.maxIntermediateAllocations, validatedScenario.budgets.maxIntermediateBytes, memoryBudget);
126
+ artifacts.set("input.frame", frame);
127
+ onAbort = () => operationController.abort();
128
+ options.signal?.addEventListener("abort", onAbort, { once: true });
129
+ if (options.signal?.aborted)
130
+ operationController.abort();
131
+ const deadlineMs = started + validatedScenario.budgets.maxExecutionMs;
132
+ timeoutId = setTimeout(() => { timedOut = true; operationController.abort(); }, validatedScenario.budgets.maxExecutionMs);
133
+ record("frame.accepted", `${frame.pixelFormat} ${frame.width}x${frame.height}`);
134
+ const budget = new ExecutionBudget({ signal: operationController.signal, deadlineMs, now: this.now, memory: memoryBudget, totalAttempts: validatedScenario.budgets.maxAttempts });
135
+ const context = { signal: operationController.signal, artifacts, budget, phaseTimings, trace: record };
136
+ await graph.execute(context);
137
+ const outcome = artifacts.get("scan.final");
138
+ if (!outcome)
139
+ return failure(frameId, validatedScenario.id, "internal_invariant_failure", "Capture graph completed without a final outcome.", this.now() - started, traceOutput());
140
+ const result = { ...outcome, timing: {
141
+ ...outcome.timing,
142
+ totalMs: this.now() - started,
143
+ frameNormalizationMs: phaseTimings["scanly.frame-normalization"],
144
+ roiMs: phaseTimings["scanly.roi"],
145
+ localizationMs: phaseTimings["scanly.localization"],
146
+ candidateGenerationMs: phaseTimings["scanly.candidate-generation"],
147
+ candidateDeduplicationMs: phaseTimings["scanly.candidate-deduplication"],
148
+ validationMs: phaseTimings["scanly.validation"],
149
+ semanticParsingMs: phaseTimings["scanly.semantic-parsing"],
150
+ controlledMemory: memoryObservation,
151
+ } };
152
+ return validatedScenario.output.includeDebugTrace ? { ...result, trace } : result;
153
+ }
154
+ catch (error) {
155
+ const code = errorCode(error, operationController.signal, timedOut);
156
+ const message = error instanceof SdkException ? error.error.message : error instanceof Error ? error.message : String(error);
157
+ const failed = failure(frameId, scenarioId, code, message, this.now() - started, traceOutput(), error);
158
+ failed.timing.controlledMemory = memoryObservation;
159
+ return failed;
160
+ }
161
+ finally {
162
+ if (timeoutId !== undefined)
163
+ clearTimeout(timeoutId);
164
+ if (onAbort)
165
+ options.signal?.removeEventListener("abort", onAbort);
166
+ if (memoryBudget) {
167
+ const peakControlledBytes = memoryBudget.observation.peakControlledBytes;
168
+ artifacts?.dispose();
169
+ memoryBudget.releaseAll();
170
+ Object.assign(memoryObservation, memoryBudget.observation, { peakControlledBytes });
171
+ }
172
+ else {
173
+ artifacts?.dispose();
174
+ }
175
+ if (active)
176
+ this.activeFrames -= 1;
177
+ lease.release();
178
+ this.activeOperations.delete(operationController);
179
+ settleOperation();
180
+ }
181
+ }
182
+ async dispose() {
183
+ if (this.disposePromise)
184
+ return this.disposePromise;
185
+ this.state = "disposing";
186
+ this.disposePromise = (async () => {
187
+ for (const controller of this.activeOperations.keys())
188
+ controller.abort();
189
+ await Promise.allSettled([...this.activeOperations.values()]);
190
+ this.compiler.clearCache();
191
+ await this.engines.disposeAll();
192
+ this.state = "disposed";
193
+ })();
194
+ return this.disposePromise;
195
+ }
196
+ assertUsable() {
197
+ if (this.state !== "active")
198
+ throw new SdkException(sdkError("session_disposed", "Capture router is disposing or has been disposed."));
199
+ }
200
+ }
201
+ export { scenarioToPipelineConfig };
202
+ //# sourceMappingURL=router.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/runtime/router.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ import { type ScenarioDefinition } from "@scanly/scenario-schema";
2
+ import { type OperatorContext, type TaskGraphNode } from "../contracts/operator.js";
3
+ import { type RuntimeOperatorConfiguration } from "./builtin-operators.js";
4
+ import type { EngineRegistry } from "./engine-registry.js";
5
+ import type { OperatorRegistry } from "./operator-registry.js";
6
+ import type { ValidatorRegistry } from "./validator-registry.js";
7
+ export declare class CompiledScenarioGraph {
8
+ readonly scenario: ScenarioDefinition;
9
+ readonly nodes: readonly TaskGraphNode[];
10
+ private readonly configuration;
11
+ constructor(scenario: ScenarioDefinition, nodes: readonly TaskGraphNode[], configuration: RuntimeOperatorConfiguration);
12
+ execute(context: OperatorContext): Promise<void>;
13
+ getConfiguration(): Readonly<RuntimeOperatorConfiguration>;
14
+ }
15
+ export interface ScenarioCompilerOptions {
16
+ maxCacheEntries?: number;
17
+ }
18
+ export declare class ScenarioCompiler {
19
+ private readonly operators;
20
+ private readonly engines;
21
+ private readonly validators;
22
+ private readonly cache;
23
+ private readonly maxCacheEntries;
24
+ constructor(operators: OperatorRegistry, engines: EngineRegistry, validators: ValidatorRegistry, options?: ScenarioCompilerOptions);
25
+ compile(input: ScenarioDefinition): CompiledScenarioGraph;
26
+ clearCache(): void;
27
+ get cacheSize(): number;
28
+ private validateCapabilities;
29
+ private validateGraph;
30
+ private cacheKey;
31
+ }
32
+ //# sourceMappingURL=scenario-compiler.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scenario-compiler.d.ts","sourceRoot":"","sources":["../../src/runtime/scenario-compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEpF,OAAO,EAAoB,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACtG,OAAO,EAAwB,KAAK,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,qBAAa,qBAAqB;IAE9B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAFrB,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,SAAS,aAAa,EAAE,EACvB,aAAa,EAAE,4BAA4B;IAG9D,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,gBAAgB,IAAI,QAAQ,CAAC,4BAA4B,CAAC;CAC3D;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4C;IAClE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAGtB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,iBAAiB,EAC9C,OAAO,GAAE,uBAA4B;IAKvC,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,qBAAqB;IA6CzD,UAAU,IAAI,IAAI;IAClB,IAAI,SAAS,IAAI,MAAM,CAA4B;IAEnD,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,QAAQ;CAQjB"}
@@ -0,0 +1,131 @@
1
+ import { validateScenario } from "@scanly/scenario-schema";
2
+ import { SdkException, sdkError } from "../contracts/errors.js";
3
+ import { executeTaskGraph } from "../contracts/operator.js";
4
+ import { BUILTIN_OPERATOR_IDS } from "./builtin-operators.js";
5
+ import { monotonicNow } from "./execution-budget.js";
6
+ export class CompiledScenarioGraph {
7
+ scenario;
8
+ nodes;
9
+ configuration;
10
+ constructor(scenario, nodes, configuration) {
11
+ this.scenario = scenario;
12
+ this.nodes = nodes;
13
+ this.configuration = configuration;
14
+ }
15
+ execute(context) {
16
+ return executeTaskGraph([...this.nodes], context, "parallel");
17
+ }
18
+ getConfiguration() { return this.configuration; }
19
+ }
20
+ export class ScenarioCompiler {
21
+ operators;
22
+ engines;
23
+ validators;
24
+ cache = new Map();
25
+ maxCacheEntries;
26
+ constructor(operators, engines, validators, options = {}) {
27
+ this.operators = operators;
28
+ this.engines = engines;
29
+ this.validators = validators;
30
+ this.maxCacheEntries = Math.max(1, Math.min(128, options.maxCacheEntries ?? 32));
31
+ }
32
+ compile(input) {
33
+ const validated = validateScenario(input);
34
+ if (!validated.ok) {
35
+ throw new SdkException(sdkError("malformed_scenario", validated.message, { issueCount: validated.issues.length }));
36
+ }
37
+ const scenario = validated.value;
38
+ this.validateCapabilities(scenario);
39
+ const key = this.cacheKey(scenario);
40
+ const cached = this.cache.get(key);
41
+ if (cached) {
42
+ this.cache.delete(key);
43
+ this.cache.set(key, cached);
44
+ return cached;
45
+ }
46
+ const configuration = { scenario, engines: this.engines, validators: this.validators };
47
+ const selected = BUILTIN_OPERATOR_IDS.map((id) => {
48
+ const operator = this.operators.get(id);
49
+ if (!operator) {
50
+ throw new SdkException(sdkError("invalid_configuration", `Required operator '${id}' is not registered.`, { operatorId: id }));
51
+ }
52
+ return operator;
53
+ });
54
+ const producers = new Map();
55
+ for (const operator of selected)
56
+ for (const artifact of operator.descriptor.produces)
57
+ producers.set(artifact, operator.descriptor.id);
58
+ const nodes = selected.map((operator) => ({
59
+ id: operator.descriptor.id,
60
+ dependencies: [...new Set(operator.descriptor.accepts.flatMap((artifact) => {
61
+ const producer = producers.get(artifact);
62
+ return producer && producer !== operator.descriptor.id ? [producer] : [];
63
+ }))],
64
+ run: async (context) => {
65
+ context.budget?.throwIfExceeded(operator.descriptor.id);
66
+ const started = monotonicNow();
67
+ await operator.execute(undefined, configuration, context);
68
+ if (context.phaseTimings)
69
+ context.phaseTimings[operator.descriptor.id] = (context.phaseTimings[operator.descriptor.id] ?? 0) + monotonicNow() - started;
70
+ },
71
+ }));
72
+ this.validateGraph(nodes);
73
+ const graph = new CompiledScenarioGraph(scenario, nodes, configuration);
74
+ this.cache.set(key, graph);
75
+ while (this.cache.size > this.maxCacheEntries)
76
+ this.cache.delete(this.cache.keys().next().value);
77
+ return graph;
78
+ }
79
+ clearCache() { this.cache.clear(); }
80
+ get cacheSize() { return this.cache.size; }
81
+ validateCapabilities(scenario) {
82
+ if (scenario.multiCode.deduplication === "tracked-instance") {
83
+ throw new SdkException(sdkError("invalid_configuration", "tracked-instance requires a temporal tracking operator, which is not registered."));
84
+ }
85
+ const requested = scenario.decoders.order.map((id) => {
86
+ const engine = this.engines.get(id);
87
+ if (!engine)
88
+ throw new SdkException(sdkError("invalid_configuration", `Scenario '${scenario.id}' requires decoder engine '${id}', but it is not registered.`, { scenarioId: scenario.id, engineId: id }));
89
+ return engine;
90
+ });
91
+ const unsupported = scenario.acceptedFormats.filter((format) => !requested.some((engine) => engine.capabilities.formats.includes(format)));
92
+ if (unsupported.length) {
93
+ throw new SdkException(sdkError("unsupported_format", `No requested decoder engine supports: ${unsupported.join(", ")}.`, { scenarioId: scenario.id, formats: unsupported.join(",") }));
94
+ }
95
+ const missingValidators = scenario.validation.filter((entry) => entry.required && !this.validators.get(entry.id)).map((entry) => entry.id);
96
+ if (missingValidators.length) {
97
+ throw new SdkException(sdkError("invalid_configuration", `Required validator(s) are not registered: ${missingValidators.join(", ")}.`, { validatorIds: missingValidators.join(",") }));
98
+ }
99
+ if (scenario.quality.minimumHeuristicQuality !== undefined) {
100
+ throw new SdkException(sdkError("invalid_configuration", "quality.minimumHeuristicQuality is unsupported because the installed pipeline does not provide a defensible quality signal."));
101
+ }
102
+ }
103
+ validateGraph(nodes) {
104
+ const ids = new Set(nodes.map((node) => node.id));
105
+ for (const node of nodes) {
106
+ const missing = node.dependencies.filter((id) => !ids.has(id));
107
+ if (missing.length)
108
+ throw new SdkException(sdkError("invalid_configuration", `Operator '${node.id}' has missing dependencies: ${missing.join(", ")}.`));
109
+ }
110
+ const pending = new Map(nodes.map((node) => [node.id, node.dependencies]));
111
+ const complete = new Set();
112
+ while (pending.size) {
113
+ const ready = [...pending].filter(([, dependencies]) => dependencies.every((id) => complete.has(id)));
114
+ if (!ready.length)
115
+ throw new SdkException(sdkError("invalid_configuration", "Operator graph contains a dependency cycle."));
116
+ for (const [id] of ready) {
117
+ pending.delete(id);
118
+ complete.add(id);
119
+ }
120
+ }
121
+ }
122
+ cacheKey(scenario) {
123
+ return JSON.stringify({
124
+ scenario,
125
+ engines: this.engines.list().map((engine) => [engine.id, engine.version, engine.capabilities.threadSafe]),
126
+ operators: this.operators.list().map((operator) => [operator.descriptor.id, operator.descriptor.version]),
127
+ validators: this.validators.list().map((validator) => validator.id),
128
+ });
129
+ }
130
+ }
131
+ //# sourceMappingURL=scenario-compiler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scenario-compiler.js","sourceRoot":"","sources":["../../src/runtime/scenario-compiler.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { ScenarioDefinition } from "@scanly/scenario-schema";
2
+ import type { PipelineConfig } from "../qr/types.js";
3
+ export declare function scenarioToPipelineConfig(scenario: ScenarioDefinition): Partial<PipelineConfig>;
4
+ //# sourceMappingURL=scenario-runtime.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scenario-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/scenario-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,gBAAgB,CAAC;AAEvE,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CA8B9F"}
@@ -0,0 +1,32 @@
1
+ export function scenarioToPipelineConfig(scenario) {
2
+ const enhancements = scenario.ablation.enhancement
3
+ ? ["original", ...scenario.enhancement.operators]
4
+ : ["original"];
5
+ const decoderOrder = scenario.ablation.multiEngineFallback ? scenario.decoders.order : scenario.decoders.order.slice(0, 1);
6
+ return {
7
+ formats: [...scenario.acceptedFormats],
8
+ maxCandidates: Math.min(scenario.localization.maxCandidates, scenario.budgets.maxCandidates),
9
+ maxAttempts: scenario.budgets.maxAttempts,
10
+ timeoutMs: scenario.budgets.maxExecutionMs,
11
+ maxPixels: scenario.budgets.maxPixels,
12
+ findMultiple: scenario.multiCode.enabled,
13
+ maxMultipleResults: scenario.multiCode.maxResults,
14
+ resultDeduplication: scenario.multiCode.deduplication,
15
+ stallCandidateLimit: scenario.multiCode.enabled ? 16 : 1,
16
+ scales: scenario.ablation.multiScale ? scenario.localization.scales : [1],
17
+ paddings: scenario.localization.cropPaddings,
18
+ rotations: scenario.ablation.rotations ? scenario.enhancement.rotations : [0],
19
+ preprocessOrder: enhancements,
20
+ decoders: { order: decoderOrder, execution: scenario.decoders.execution, failurePolicy: scenario.decoders.failurePolicy ?? "success-wins" },
21
+ // Comparison/ablation runners clone scenario IDs, so use the latency
22
+ // budget rather than a mutable label to preserve Fast's cold-start policy.
23
+ fallbackTiming: scenario.budgets.maxAttempts <= 18 ? "final" : "after-cheap",
24
+ enableLocalization: scenario.ablation.localization && scenario.localization.strategy === "edge-density",
25
+ enableFullImageFallback: true,
26
+ enableSplitImageFallback: scenario.ablation.splitImageFallback,
27
+ enableGridImageFallback: scenario.multiCode.enabled && scenario.ablation.splitImageFallback,
28
+ maxIntermediateAllocations: scenario.budgets.maxIntermediateAllocations,
29
+ maxIntermediateBytes: scenario.budgets.maxIntermediateBytes,
30
+ };
31
+ }
32
+ //# sourceMappingURL=scenario-runtime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scenario-runtime.js","sourceRoot":"","sources":["../../src/runtime/scenario-runtime.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,wBAAwB,CAAC,QAA4B;IACnE,MAAM,YAAY,GAAuB,QAAQ,CAAC,QAAQ,CAAC,WAAW;QACpE,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC;QACjD,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACjB,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3H,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,eAAe,CAAC;QACtC,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC;QAC5F,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW;QACzC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc;QAC1C,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS;QACrC,YAAY,EAAE,QAAQ,CAAC,SAAS,CAAC,OAAO;QACxC,kBAAkB,EAAE,QAAQ,CAAC,SAAS,CAAC,UAAU;QACjD,mBAAmB,EAAE,QAAQ,CAAC,SAAS,CAAC,aAAa;QACrD,mBAAmB,EAAE,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,YAAY;QAC5C,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,eAAe,EAAE,YAAY;QAC7B,QAAQ,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa,IAAI,cAAc,EAAE;QAC3I,qEAAqE;QACrE,2EAA2E;QAC3E,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa;QAC5E,kBAAkB,EAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY,CAAC,QAAQ,KAAK,cAAc;QACvG,uBAAuB,EAAE,IAAI;QAC7B,wBAAwB,EAAE,QAAQ,CAAC,QAAQ,CAAC,kBAAkB;QAC9D,uBAAuB,EAAE,QAAQ,CAAC,SAAS,CAAC,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,kBAAkB;QAC3F,0BAA0B,EAAE,QAAQ,CAAC,OAAO,CAAC,0BAA0B;QACvE,oBAAoB,EAAE,QAAQ,CAAC,OAAO,CAAC,oBAAoB;KAC5D,CAAC;AACJ,CAAC"}
@@ -0,0 +1,40 @@
1
+ import { type ScenarioDefinition } from "@scanly/scenario-schema";
2
+ import type { FrameSourceType, NormalizedFrame } from "../contracts/frame.js";
3
+ import type { ScanOutcome } from "../contracts/result.js";
4
+ import { CaptureRouter } from "./router.js";
5
+ export type CaptureSessionState = "idle" | "initialized" | "running" | "stopped" | "error" | "disposed";
6
+ export type ConcurrentCallPolicy = "replace" | "reject";
7
+ export interface CaptureSessionOptions {
8
+ router?: CaptureRouter;
9
+ scenario?: ScenarioDefinition;
10
+ concurrentCallPolicy?: ConcurrentCallPolicy;
11
+ disposeRouter?: boolean;
12
+ applyDuplicateSuppression?: boolean;
13
+ }
14
+ export declare class CaptureSession {
15
+ private state;
16
+ private readonly router;
17
+ private readonly concurrentPolicy;
18
+ private activeController;
19
+ private ownership;
20
+ private source;
21
+ private readonly ownsRouter;
22
+ private duplicatePolicy;
23
+ private readonly applyDuplicateSuppression;
24
+ constructor(options?: CaptureSessionOptions);
25
+ getState(): CaptureSessionState;
26
+ getSource(): FrameSourceType | null;
27
+ initialize(): void;
28
+ start(source?: FrameSourceType): void;
29
+ stop(): void;
30
+ cancel(): void;
31
+ updateConfiguration(scenario: ScenarioDefinition): void;
32
+ switchSource(source: FrameSourceType): void;
33
+ scan(frame: NormalizedFrame, options?: {
34
+ signal?: AbortSignal;
35
+ }): Promise<ScanOutcome>;
36
+ dispose(): Promise<void>;
37
+ private assertNotDisposed;
38
+ private lifecycleFailure;
39
+ }
40
+ //# sourceMappingURL=session.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/runtime/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEpF,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AACxG,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,QAAQ,CAAC;AACxD,MAAM,WAAW,qBAAqB;IAAG,MAAM,CAAC,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAAC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,yBAAyB,CAAC,EAAE,OAAO,CAAA;CAAE;AAE3M,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuB;IACxD,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAU;gBACxC,OAAO,GAAE,qBAA0B;IAQ/C,QAAQ,IAAI,mBAAmB;IAC/B,SAAS,IAAI,eAAe,GAAG,IAAI;IACnC,UAAU,IAAI,IAAI;IAIlB,KAAK,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI;IAMrC,IAAI,IAAI,IAAI;IAMZ,MAAM,IAAI,IAAI;IAKd,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAQvD,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAOrC,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAuB1F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,OAAO,CAAC,iBAAiB;IAGzB,OAAO,CAAC,gBAAgB;CAIzB"}