@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,32 @@
1
+ import type { BarcodeFormat } from "@scanly/scenario-schema";
2
+ import type { EngineCapabilities } from "../contracts/engine.js";
3
+ import type { FramePixelFormat } from "../contracts/frame.js";
4
+ import type { OperatorDescriptor } from "../contracts/operator.js";
5
+ import type { EngineRegistry } from "./engine-registry.js";
6
+ import type { OperatorRegistry } from "./operator-registry.js";
7
+ export interface EngineCapabilityReport {
8
+ id: string;
9
+ version: string;
10
+ capabilities: EngineCapabilities;
11
+ }
12
+ export interface OperatorCapabilityReport {
13
+ id: string;
14
+ version: string;
15
+ descriptor: OperatorDescriptor;
16
+ }
17
+ export interface ScanlyCapabilities {
18
+ formats: BarcodeFormat[];
19
+ pixelFormats: FramePixelFormat[];
20
+ scenarioFeatures: {
21
+ roi: boolean;
22
+ parallelEngines: boolean;
23
+ spatialDeduplication: boolean;
24
+ temporalTracking: boolean;
25
+ heuristicQuality: boolean;
26
+ yuvNormalization: boolean;
27
+ };
28
+ engines: EngineCapabilityReport[];
29
+ operators: OperatorCapabilityReport[];
30
+ }
31
+ export declare function inspectCapabilities(engines: EngineRegistry, operators: OperatorRegistry): ScanlyCapabilities;
32
+ //# sourceMappingURL=capabilities.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/runtime/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,kBAAkB,CAAC;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,gBAAgB,EAAE;QAChB,GAAG,EAAE,OAAO,CAAC;QACb,eAAe,EAAE,OAAO,CAAC;QACzB,oBAAoB,EAAE,OAAO,CAAC;QAC9B,gBAAgB,EAAE,OAAO,CAAC;QAC1B,gBAAgB,EAAE,OAAO,CAAC;QAC1B,gBAAgB,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,SAAS,EAAE,wBAAwB,EAAE,CAAC;CACvC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,gBAAgB,GAAG,kBAAkB,CAgB5G"}
@@ -0,0 +1,18 @@
1
+ export function inspectCapabilities(engines, operators) {
2
+ const registered = engines.list();
3
+ return {
4
+ formats: [...new Set(registered.flatMap((engine) => engine.capabilities.formats))].sort(),
5
+ pixelFormats: ["rgba8888", "rgb888", "gray8"],
6
+ scenarioFeatures: {
7
+ roi: true,
8
+ parallelEngines: registered.length > 1,
9
+ spatialDeduplication: true,
10
+ temporalTracking: false,
11
+ heuristicQuality: false,
12
+ yuvNormalization: false,
13
+ },
14
+ engines: registered.map((engine) => ({ id: engine.id, version: engine.version, capabilities: { ...engine.capabilities, formats: [...engine.capabilities.formats] } })),
15
+ operators: operators.list().map((operator) => ({ id: operator.descriptor.id, version: operator.descriptor.version, descriptor: { ...operator.descriptor } })),
16
+ };
17
+ }
18
+ //# sourceMappingURL=capabilities.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/runtime/capabilities.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,mBAAmB,CAAC,OAAuB,EAAE,SAA2B;IACtF,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAClC,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;QACzF,YAAY,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC;QAC7C,gBAAgB,EAAE;YAChB,GAAG,EAAE,IAAI;YACT,eAAe,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC;YACtC,oBAAoB,EAAE,IAAI;YAC1B,gBAAgB,EAAE,KAAK;YACvB,gBAAgB,EAAE,KAAK;YACvB,gBAAgB,EAAE,KAAK;SACxB;QACD,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,GAAG,MAAM,CAAC,YAAY,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACtK,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;KAC9J,CAAC;AACJ,CAAC"}
@@ -0,0 +1,19 @@
1
+ import type { BarcodeFormat } from "@scanly/scenario-schema";
2
+ import type { DecoderEngine, EngineDecodeOptions, EngineOutcome, EngineRegistrationOptions, EngineRegistryContract } from "../contracts/engine.js";
3
+ import type { NormalizedFrame } from "../contracts/frame.js";
4
+ export declare class EngineRegistry implements EngineRegistryContract {
5
+ private readonly records;
6
+ private disposed;
7
+ register(engine: DecoderEngine, options?: EngineRegistrationOptions): void;
8
+ unregister(id: string): void;
9
+ get(id: string): DecoderEngine | undefined;
10
+ list(): readonly DecoderEngine[];
11
+ resolve(formats: readonly BarcodeFormat[]): readonly DecoderEngine[];
12
+ initializeAll(): Promise<void>;
13
+ decode(id: string, frame: NormalizedFrame, options: EngineDecodeOptions): Promise<EngineOutcome>;
14
+ disposeAll(): Promise<void>;
15
+ get isDisposed(): boolean;
16
+ private initialize;
17
+ private assertUsable;
18
+ }
19
+ //# sourceMappingURL=engine-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine-registry.d.ts","sourceRoot":"","sources":["../../src/runtime/engine-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAuB7D,qBAAa,cAAe,YAAW,sBAAsB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAS;IAEzB,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,yBAA8B,GAAG,IAAI;IAe9E,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAU5B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C,IAAI,IAAI,SAAS,aAAa,EAAE;IAIhC,OAAO,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,aAAa,EAAE;IAQ9D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAkChG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBjC,IAAI,UAAU,IAAI,OAAO,CAA0B;YAErC,UAAU;IAuBxB,OAAO,CAAC,YAAY;CAGrB"}
@@ -0,0 +1,136 @@
1
+ import { SdkException, sdkError } from "../contracts/errors.js";
2
+ function initializationFailure(engine, cause) {
3
+ return new SdkException(sdkError("engine_initialization_failure", `Decoder engine '${engine.id}' failed to initialize.`, { engineId: engine.id, engineVersion: engine.version }, cause));
4
+ }
5
+ export class EngineRegistry {
6
+ records = new Map();
7
+ disposed = false;
8
+ register(engine, options = {}) {
9
+ this.assertUsable();
10
+ if (!engine || typeof engine.id !== "string" || !engine.id.trim()) {
11
+ throw new SdkException(sdkError("invalid_configuration", "Decoder engine id must be a non-empty string."));
12
+ }
13
+ const prior = this.records.get(engine.id);
14
+ if (prior && !options.replace) {
15
+ throw new SdkException(sdkError("invalid_configuration", `Decoder engine '${engine.id}' is already registered.`, { engineId: engine.id }));
16
+ }
17
+ if (prior && prior.state !== "registered") {
18
+ throw new SdkException(sdkError("invalid_configuration", `Initialized decoder engine '${engine.id}' cannot be replaced; unregister or dispose it first.`, { engineId: engine.id }));
19
+ }
20
+ this.records.set(engine.id, { engine, state: "registered", tail: Promise.resolve(), active: new Set() });
21
+ }
22
+ unregister(id) {
23
+ this.assertUsable();
24
+ const record = this.records.get(id);
25
+ if (!record)
26
+ return;
27
+ if (record.state !== "registered") {
28
+ throw new SdkException(sdkError("invalid_configuration", `Decoder engine '${id}' is active and cannot be unregistered without disposal.`, { engineId: id }));
29
+ }
30
+ this.records.delete(id);
31
+ }
32
+ get(id) {
33
+ return this.records.get(id)?.engine;
34
+ }
35
+ list() {
36
+ return Object.freeze([...this.records.values()].map((record) => record.engine));
37
+ }
38
+ resolve(formats) {
39
+ const requested = new Set(formats);
40
+ if (requested.size === 0)
41
+ throw new SdkException(sdkError("unsupported_format", "At least one barcode format must be requested."));
42
+ const resolved = this.list().filter((engine) => engine.capabilities.formats.some((format) => requested.has(format)));
43
+ if (!resolved.length)
44
+ throw new SdkException(sdkError("unsupported_format", `No registered engine supports: ${[...requested].join(", ")}.`));
45
+ return Object.freeze(resolved);
46
+ }
47
+ async initializeAll() {
48
+ this.assertUsable();
49
+ await Promise.all([...this.records.values()].map((record) => this.initialize(record)));
50
+ }
51
+ async decode(id, frame, options) {
52
+ this.assertUsable();
53
+ const record = this.records.get(id);
54
+ if (!record) {
55
+ throw new SdkException(sdkError("invalid_configuration", `Decoder engine '${id}' is not registered.`, { engineId: id }));
56
+ }
57
+ await this.initialize(record);
58
+ this.assertUsable();
59
+ if (record.state !== "ready")
60
+ throw initializationFailure(record.engine, new Error("Engine is not ready."));
61
+ const execute = async () => {
62
+ if (this.disposed || record.state === "disposed") {
63
+ throw new SdkException(sdkError("session_disposed", `Decoder engine '${id}' has been disposed.`, { engineId: id }));
64
+ }
65
+ return record.engine.decode(frame, options);
66
+ };
67
+ const track = (operation) => {
68
+ record.active.add(operation);
69
+ void operation.finally(() => record.active.delete(operation)).catch(() => undefined);
70
+ return operation;
71
+ };
72
+ if (record.engine.capabilities.threadSafe)
73
+ return track(execute());
74
+ const previous = record.tail;
75
+ let release;
76
+ record.tail = new Promise((resolve) => { release = resolve; });
77
+ await previous;
78
+ try {
79
+ return await track(execute());
80
+ }
81
+ finally {
82
+ release();
83
+ }
84
+ }
85
+ async disposeAll() {
86
+ if (this.disposed) {
87
+ await Promise.all([...this.records.values()].map((record) => record.disposePromise));
88
+ return;
89
+ }
90
+ this.disposed = true;
91
+ await Promise.all([...this.records.values()].map(async (record) => {
92
+ if (record.disposePromise)
93
+ return record.disposePromise;
94
+ record.disposePromise = (async () => {
95
+ await record.initializePromise?.catch(() => undefined);
96
+ await record.tail;
97
+ await Promise.allSettled([...record.active]);
98
+ if (record.state !== "disposed")
99
+ await record.engine.dispose?.();
100
+ record.state = "disposed";
101
+ })();
102
+ return record.disposePromise;
103
+ }));
104
+ }
105
+ get isDisposed() { return this.disposed; }
106
+ async initialize(record) {
107
+ if (record.state === "ready")
108
+ return;
109
+ if (record.state === "disposed" || this.disposed)
110
+ this.assertUsable();
111
+ if (!record.initializePromise) {
112
+ record.state = "initializing";
113
+ const promise = Promise.resolve()
114
+ .then(() => record.engine.initialize?.())
115
+ .then(() => { record.state = "ready"; })
116
+ .catch((cause) => {
117
+ record.state = "failed";
118
+ throw initializationFailure(record.engine, cause);
119
+ })
120
+ .finally(() => {
121
+ // Failed engines may define their own bounded retry/circuit-breaker policy.
122
+ // Clearing only the failed promise preserves in-flight deduplication while
123
+ // allowing a later decode to make one explicit retry.
124
+ if (record.state === "failed" && record.initializePromise === promise)
125
+ record.initializePromise = undefined;
126
+ });
127
+ record.initializePromise = promise;
128
+ }
129
+ await record.initializePromise;
130
+ }
131
+ assertUsable() {
132
+ if (this.disposed)
133
+ throw new SdkException(sdkError("session_disposed", "Decoder engine registry has been disposed."));
134
+ }
135
+ }
136
+ //# sourceMappingURL=engine-registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine-registry.js","sourceRoot":"","sources":["../../src/runtime/engine-registry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ import type { FrameMemoryBudget } from "./memory-budget.js";
2
+ export declare function monotonicNow(): number;
3
+ export interface ExecutionBudgetOptions {
4
+ signal?: AbortSignal;
5
+ deadlineMs: number;
6
+ now?: () => number;
7
+ remainingAttempts?: () => number;
8
+ memory?: FrameMemoryBudget;
9
+ totalAttempts?: number;
10
+ }
11
+ export declare class ExecutionBudget {
12
+ readonly signal?: AbortSignal;
13
+ readonly deadlineMs: number;
14
+ readonly memory?: FrameMemoryBudget;
15
+ private readonly clock;
16
+ private readonly attempts;
17
+ private remaining;
18
+ constructor(options: ExecutionBudgetOptions);
19
+ now(): number;
20
+ remainingAttempts(): number;
21
+ tryConsumeAttempt(): boolean;
22
+ remainingIntermediateBytes(): number;
23
+ throwIfExceeded(stage: string): void;
24
+ }
25
+ //# sourceMappingURL=execution-budget.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-budget.d.ts","sourceRoot":"","sources":["../../src/runtime/execution-budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,wBAAgB,YAAY,IAAI,MAAM,CAIrC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAC;IACjC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,eAAe;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,SAAS,CAAgB;gBAErB,OAAO,EAAE,sBAAsB;IAS3C,GAAG,IAAI,MAAM;IACb,iBAAiB,IAAI,MAAM;IAC3B,iBAAiB,IAAI,OAAO;IAM5B,0BAA0B,IAAI,MAAM;IAEpC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAQrC"}
@@ -0,0 +1,41 @@
1
+ export function monotonicNow() {
2
+ return typeof performance !== "undefined" && typeof performance.now === "function"
3
+ ? performance.now()
4
+ : Date.now();
5
+ }
6
+ export class ExecutionBudget {
7
+ signal;
8
+ deadlineMs;
9
+ memory;
10
+ clock;
11
+ attempts;
12
+ remaining;
13
+ constructor(options) {
14
+ this.signal = options.signal;
15
+ this.deadlineMs = options.deadlineMs;
16
+ this.clock = options.now ?? monotonicNow;
17
+ this.attempts = options.remainingAttempts ?? (() => Number.POSITIVE_INFINITY);
18
+ this.remaining = options.totalAttempts === undefined ? null : Math.max(0, Math.floor(options.totalAttempts));
19
+ this.memory = options.memory;
20
+ }
21
+ now() { return this.clock(); }
22
+ remainingAttempts() { return this.remaining ?? Math.max(0, this.attempts()); }
23
+ tryConsumeAttempt() {
24
+ if (this.remaining === null)
25
+ return this.attempts() > 0;
26
+ if (this.remaining <= 0)
27
+ return false;
28
+ this.remaining -= 1;
29
+ return true;
30
+ }
31
+ remainingIntermediateBytes() { return this.memory?.remainingBytes ?? Number.POSITIVE_INFINITY; }
32
+ throwIfExceeded(stage) {
33
+ if (this.signal?.aborted) {
34
+ throw Object.assign(new Error(`Execution cancelled during ${stage}.`), { name: "AbortError", code: "cancelled", stage });
35
+ }
36
+ if (this.clock() >= this.deadlineMs) {
37
+ throw Object.assign(new Error(`Execution deadline exceeded during ${stage}.`), { name: "TimeoutError", code: "timeout", stage });
38
+ }
39
+ }
40
+ }
41
+ //# sourceMappingURL=execution-budget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-budget.js","sourceRoot":"","sources":["../../src/runtime/execution-budget.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,WAAW,KAAK,WAAW,IAAI,OAAO,WAAW,CAAC,GAAG,KAAK,UAAU;QAChF,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE;QACnB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;AACjB,CAAC;AAWD,MAAM,OAAO,eAAe;IACjB,MAAM,CAAe;IACrB,UAAU,CAAS;IACnB,MAAM,CAAqB;IACnB,KAAK,CAAe;IACpB,QAAQ,CAAe;IAChC,SAAS,CAAgB;IAEjC,YAAY,OAA+B;QACzC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,IAAI,YAAY,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,iBAAiB,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC9E,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QAC7G,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,GAAG,KAAa,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACtC,iBAAiB,KAAa,OAAO,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IACtF,iBAAiB;QACf,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACxD,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACtC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,0BAA0B,KAAa,OAAO,IAAI,CAAC,MAAM,EAAE,cAAc,IAAI,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAExG,eAAe,CAAC,KAAa;QAC3B,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACzB,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,8BAA8B,KAAK,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3H,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpC,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sCAAsC,KAAK,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACnI,CAAC;IACH,CAAC;CACF"}
@@ -0,0 +1,10 @@
1
+ import type { NormalizedFrame } from "../contracts/frame.js";
2
+ /** Owns the exactly-once release boundary for a frame, including preflight failures. */
3
+ export declare class FrameLease {
4
+ readonly frame: NormalizedFrame;
5
+ private released;
6
+ constructor(frame: NormalizedFrame);
7
+ release(): void;
8
+ get isReleased(): boolean;
9
+ }
10
+ //# sourceMappingURL=frame-lease.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frame-lease.d.ts","sourceRoot":"","sources":["../../src/runtime/frame-lease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,wFAAwF;AACxF,qBAAa,UAAU;IAET,QAAQ,CAAC,KAAK,EAAE,eAAe;IAD3C,OAAO,CAAC,QAAQ,CAAS;gBACJ,KAAK,EAAE,eAAe;IAE3C,OAAO,IAAI,IAAI;IAMf,IAAI,UAAU,IAAI,OAAO,CAA0B;CACpD"}
@@ -0,0 +1,17 @@
1
+ /** Owns the exactly-once release boundary for a frame, including preflight failures. */
2
+ export class FrameLease {
3
+ frame;
4
+ released = false;
5
+ constructor(frame) {
6
+ this.frame = frame;
7
+ }
8
+ release() {
9
+ if (this.released)
10
+ return;
11
+ this.released = true;
12
+ if (this.frame?.ownership !== "borrowed")
13
+ this.frame?.dispose?.();
14
+ }
15
+ get isReleased() { return this.released; }
16
+ }
17
+ //# sourceMappingURL=frame-lease.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frame-lease.js","sourceRoot":"","sources":["../../src/runtime/frame-lease.ts"],"names":[],"mappings":"AAEA,wFAAwF;AACxF,MAAM,OAAO,UAAU;IAEA;IADb,QAAQ,GAAG,KAAK,CAAC;IACzB,YAAqB,KAAsB;QAAtB,UAAK,GAAL,KAAK,CAAiB;IAAG,CAAC;IAE/C,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,IAAI,CAAC,KAAK,EAAE,SAAS,KAAK,UAAU;YAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;IACpE,CAAC;IAED,IAAI,UAAU,KAAc,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;CACpD"}
@@ -0,0 +1,13 @@
1
+ import type { FrameOrientation } from "../contracts/frame.js";
2
+ import type { PixelBuffer } from "../qr/types.js";
3
+ import { type CoordinateTransform, type Matrix3x3 } from "../qr/geometry.js";
4
+ import type { ExecutionBudget } from "./execution-budget.js";
5
+ export interface OrientationNormalization {
6
+ buffer: PixelBuffer;
7
+ sourceToUpright: CoordinateTransform;
8
+ sourceOrientation: FrameOrientation;
9
+ }
10
+ export declare function sourceToUprightMatrix(orientation: FrameOrientation, width: number, height: number): Matrix3x3;
11
+ /** Converts source-buffer pixels to canonical upright RGBA coordinates. */
12
+ export declare function normalizeRgbaOrientation(buffer: PixelBuffer, orientation: FrameOrientation, budget?: ExecutionBudget): OrientationNormalization;
13
+ //# sourceMappingURL=frame-normalization.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frame-normalization.d.ts","sourceRoot":"","sources":["../../src/runtime/frame-normalization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAA8C,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEzH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,WAAW,CAAC;IACpB,eAAe,EAAE,mBAAmB,CAAC;IACrC,iBAAiB,EAAE,gBAAgB,CAAC;CACrC;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAK7G;AAED,2EAA2E;AAC3E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,wBAAwB,CAa/I"}
@@ -0,0 +1,21 @@
1
+ import { createCoordinateTransform, IDENTITY_MATRIX } from "../qr/geometry.js";
2
+ import { rotateBuffer } from "../qr/rotate.js";
3
+ export function sourceToUprightMatrix(orientation, width, height) {
4
+ if (orientation === 90)
5
+ return [0, -1, height - 1, 1, 0, 0, 0, 0, 1];
6
+ if (orientation === 180)
7
+ return [-1, 0, width - 1, 0, -1, height - 1, 0, 0, 1];
8
+ if (orientation === 270)
9
+ return [0, 1, 0, -1, 0, width - 1, 0, 0, 1];
10
+ return IDENTITY_MATRIX;
11
+ }
12
+ /** Converts source-buffer pixels to canonical upright RGBA coordinates. */
13
+ export function normalizeRgbaOrientation(buffer, orientation, budget) {
14
+ const upright = orientation === 0 ? buffer : rotateBuffer(buffer, orientation, budget);
15
+ return {
16
+ buffer: upright,
17
+ sourceOrientation: orientation,
18
+ sourceToUpright: createCoordinateTransform(sourceToUprightMatrix(orientation, buffer.width, buffer.height), buffer.width, buffer.height, upright.width, upright.height),
19
+ };
20
+ }
21
+ //# sourceMappingURL=frame-normalization.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frame-normalization.js","sourceRoot":"","sources":["../../src/runtime/frame-normalization.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAA4C,MAAM,mBAAmB,CAAC;AACzH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAS/C,MAAM,UAAU,qBAAqB,CAAC,WAA6B,EAAE,KAAa,EAAE,MAAc;IAChG,IAAI,WAAW,KAAK,EAAE;QAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACrE,IAAI,WAAW,KAAK,GAAG;QAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/E,IAAI,WAAW,KAAK,GAAG;QAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACrE,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,wBAAwB,CAAC,MAAmB,EAAE,WAA6B,EAAE,MAAwB;IACnH,MAAM,OAAO,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IACvF,OAAO;QACL,MAAM,EAAE,OAAO;QACf,iBAAiB,EAAE,WAAW;QAC9B,eAAe,EAAE,yBAAyB,CACxC,qBAAqB,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAC/D,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,MAAM,EACb,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,MAAM,CACf;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,32 @@
1
+ export interface MemoryLease {
2
+ readonly bytes: number;
3
+ readonly label: string;
4
+ readonly kind: MemoryLeaseKind;
5
+ readonly released: boolean;
6
+ reclassify(kind: MemoryLeaseKind, label?: string): void;
7
+ release(): void;
8
+ }
9
+ export type MemoryLeaseKind = "artifact" | "cache" | "scratch";
10
+ export interface MemoryObservation {
11
+ currentControlledBytes: number;
12
+ peakControlledBytes: number;
13
+ retainedArtifactBytes: number;
14
+ retainedCacheBytes: number;
15
+ transientScratchBytes: number;
16
+ }
17
+ export declare class FrameMemoryBudget {
18
+ readonly limitBytes: number;
19
+ private bytes;
20
+ private peakBytes;
21
+ private readonly byKind;
22
+ private leases;
23
+ constructor(limitBytes: number);
24
+ get retainedBytes(): number;
25
+ get remainingBytes(): number;
26
+ get observation(): MemoryObservation;
27
+ reserve(bytes: number, label: string, kind?: MemoryLeaseKind): MemoryLease;
28
+ reserveScratch(bytes: number, label: string): MemoryLease;
29
+ resize(lease: MemoryLease, bytes: number): void;
30
+ releaseAll(): void;
31
+ }
32
+ //# sourceMappingURL=memory-budget.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-budget.d.ts","sourceRoot":"","sources":["../../src/runtime/memory-budget.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,iBAAiB;IAKhB,QAAQ,CAAC,UAAU,EAAE,MAAM;IAJvC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0E;IACjG,OAAO,CAAC,MAAM,CAA8B;gBACvB,UAAU,EAAE,MAAM;IAIvC,IAAI,aAAa,IAAI,MAAM,CAAuB;IAClD,IAAI,cAAc,IAAI,MAAM,CAAsD;IAClF,IAAI,WAAW,IAAI,iBAAiB,CAQnC;IAED,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,eAA4B,GAAG,WAAW;IA0BtF,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW;IAIzD,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAgB/C,UAAU,IAAI,IAAI;CAGnB"}
@@ -0,0 +1,109 @@
1
+ export class FrameMemoryBudget {
2
+ limitBytes;
3
+ bytes = 0;
4
+ peakBytes = 0;
5
+ byKind = { artifact: 0, cache: 0, scratch: 0 };
6
+ leases = new Set();
7
+ constructor(limitBytes) {
8
+ this.limitBytes = limitBytes;
9
+ if (!Number.isFinite(limitBytes) || limitBytes < 1)
10
+ throw new RangeError("Frame memory limit must be positive.");
11
+ }
12
+ get retainedBytes() { return this.bytes; }
13
+ get remainingBytes() { return Math.max(0, this.limitBytes - this.bytes); }
14
+ get observation() {
15
+ return {
16
+ currentControlledBytes: this.bytes,
17
+ peakControlledBytes: this.peakBytes,
18
+ retainedArtifactBytes: this.byKind.artifact,
19
+ retainedCacheBytes: this.byKind.cache,
20
+ transientScratchBytes: this.byKind.scratch,
21
+ };
22
+ }
23
+ reserve(bytes, label, kind = "artifact") {
24
+ const normalized = Math.max(0, Math.ceil(bytes));
25
+ if (this.bytes + normalized > this.limitBytes) {
26
+ throw Object.assign(new Error(`Frame memory budget exceeded while reserving '${label}'.`), {
27
+ code: "resource_limit_exceeded",
28
+ requestedBytes: normalized,
29
+ retainedBytes: this.bytes,
30
+ limitBytes: this.limitBytes,
31
+ });
32
+ }
33
+ const lease = new MemoryLeaseImpl(normalized, label, kind, (released) => {
34
+ if (!this.leases.delete(lease))
35
+ return;
36
+ this.bytes = Math.max(0, this.bytes - released.bytes);
37
+ this.byKind[released.kind] = Math.max(0, this.byKind[released.kind] - released.bytes);
38
+ }, (target, nextKind, priorKind) => {
39
+ if (!this.leases.has(target) || nextKind === priorKind)
40
+ return;
41
+ this.byKind[priorKind] = Math.max(0, this.byKind[priorKind] - target.bytes);
42
+ this.byKind[nextKind] += target.bytes;
43
+ });
44
+ this.bytes += normalized;
45
+ this.byKind[kind] += normalized;
46
+ this.peakBytes = Math.max(this.peakBytes, this.bytes);
47
+ this.leases.add(lease);
48
+ return lease;
49
+ }
50
+ reserveScratch(bytes, label) {
51
+ return this.reserve(bytes, label, "scratch");
52
+ }
53
+ resize(lease, bytes) {
54
+ const target = lease;
55
+ if (!this.leases.has(target) || target.released)
56
+ throw new Error("Cannot resize a released or foreign memory lease.");
57
+ const normalized = Math.max(0, Math.ceil(bytes));
58
+ const delta = normalized - target.bytes;
59
+ if (delta > this.remainingBytes) {
60
+ throw Object.assign(new Error(`Frame memory budget exceeded while resizing '${target.label}'.`), {
61
+ code: "resource_limit_exceeded", requestedBytes: delta, retainedBytes: this.bytes, limitBytes: this.limitBytes,
62
+ });
63
+ }
64
+ this.bytes += delta;
65
+ this.byKind[target.kind] += delta;
66
+ target.setBytes(normalized);
67
+ this.peakBytes = Math.max(this.peakBytes, this.bytes);
68
+ }
69
+ releaseAll() {
70
+ for (const lease of [...this.leases])
71
+ lease.release();
72
+ }
73
+ }
74
+ class MemoryLeaseImpl {
75
+ onRelease;
76
+ onReclassify;
77
+ done = false;
78
+ byteCount;
79
+ leaseLabel;
80
+ leaseKind;
81
+ constructor(bytes, label, kind, onRelease, onReclassify) {
82
+ this.onRelease = onRelease;
83
+ this.onReclassify = onReclassify;
84
+ this.byteCount = bytes;
85
+ this.leaseLabel = label;
86
+ this.leaseKind = kind;
87
+ }
88
+ get bytes() { return this.byteCount; }
89
+ get label() { return this.leaseLabel; }
90
+ get kind() { return this.leaseKind; }
91
+ get released() { return this.done; }
92
+ setBytes(bytes) { this.byteCount = bytes; }
93
+ reclassify(kind, label) {
94
+ if (this.done)
95
+ throw new Error("Cannot reclassify a released memory lease.");
96
+ const prior = this.leaseKind;
97
+ this.onReclassify(this, kind, prior);
98
+ this.leaseKind = kind;
99
+ if (label)
100
+ this.leaseLabel = label;
101
+ }
102
+ release() {
103
+ if (this.done)
104
+ return;
105
+ this.done = true;
106
+ this.onRelease(this);
107
+ }
108
+ }
109
+ //# sourceMappingURL=memory-budget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-budget.js","sourceRoot":"","sources":["../../src/runtime/memory-budget.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import type { Operator } from "../contracts/operator.js";
2
+ export declare class OperatorRegistry {
3
+ private readonly operators;
4
+ register<I, O, C>(operator: Operator<I, O, C>, options?: {
5
+ replace?: boolean;
6
+ }): void;
7
+ unregister(id: string): void;
8
+ get<I = unknown, O = unknown, C = unknown>(id: string): Operator<I, O, C> | undefined;
9
+ list(): readonly Operator<unknown, unknown, unknown>[];
10
+ }
11
+ //# sourceMappingURL=operator-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"operator-registry.d.ts","sourceRoot":"","sources":["../../src/runtime/operator-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0D;IAEpF,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IASzF,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAC5B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS;IAGrF,IAAI,IAAI,SAAS,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;CACvD"}
@@ -0,0 +1,19 @@
1
+ import { SdkException, sdkError } from "../contracts/errors.js";
2
+ export class OperatorRegistry {
3
+ operators = new Map();
4
+ register(operator, options = {}) {
5
+ const id = operator.descriptor.id;
6
+ if (!id.trim())
7
+ throw new SdkException(sdkError("invalid_configuration", "Operator id must be non-empty."));
8
+ if (this.operators.has(id) && !options.replace) {
9
+ throw new SdkException(sdkError("invalid_configuration", `Operator '${id}' is already registered.`, { operatorId: id }));
10
+ }
11
+ this.operators.set(id, operator);
12
+ }
13
+ unregister(id) { this.operators.delete(id); }
14
+ get(id) {
15
+ return this.operators.get(id);
16
+ }
17
+ list() { return Object.freeze([...this.operators.values()]); }
18
+ }
19
+ //# sourceMappingURL=operator-registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"operator-registry.js","sourceRoot":"","sources":["../../src/runtime/operator-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGhE,MAAM,OAAO,gBAAgB;IACV,SAAS,GAAG,IAAI,GAAG,EAA+C,CAAC;IAEpF,QAAQ,CAAU,QAA2B,EAAE,UAAiC,EAAE;QAChF,MAAM,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,YAAY,CAAC,QAAQ,CAAC,uBAAuB,EAAE,gCAAgC,CAAC,CAAC,CAAC;QAC5G,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC/C,MAAM,IAAI,YAAY,CAAC,QAAQ,CAAC,uBAAuB,EAAE,aAAa,EAAE,0BAA0B,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC3H,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,QAA+C,CAAC,CAAC;IAC1E,CAAC;IAED,UAAU,CAAC,EAAU,IAAU,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3D,GAAG,CAAwC,EAAU;QACnD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAkC,CAAC;IACjE,CAAC;IACD,IAAI,KAAqD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/G"}
@@ -0,0 +1,21 @@
1
+ import type { ScanOutcome } from "../contracts/result.js";
2
+ export interface DuplicateIdentityOptions {
3
+ includeFormat?: boolean;
4
+ includeSpatialTrack?: boolean;
5
+ maxEntries?: number;
6
+ }
7
+ /** Session-scoped, bounded duplicate suppression for continuous sources. */
8
+ export declare class DuplicateSuppressionPolicy {
9
+ private windowMs;
10
+ private readonly identity;
11
+ private readonly seen;
12
+ private readonly maxEntries;
13
+ constructor(windowMs: number, identity?: DuplicateIdentityOptions);
14
+ updateWindow(windowMs: number): void;
15
+ filter(outcome: ScanOutcome, nowMs?: number): ScanOutcome;
16
+ clear(): void;
17
+ get size(): number;
18
+ private key;
19
+ private prune;
20
+ }
21
+ //# sourceMappingURL=result-policies.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"result-policies.d.ts","sourceRoot":"","sources":["../../src/runtime/result-policies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,wBAAwB,CAAC;AAEtE,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4EAA4E;AAC5E,qBAAa,0BAA0B;IAGzB,OAAO,CAAC,QAAQ;IAAU,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAF/D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAChB,QAAQ,EAAE,MAAM,EAAmB,QAAQ,GAAE,wBAA6B;IAI9F,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,SAAa,GAAG,WAAW;IA0B7D,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI,MAAM,CAA2B;IAE7C,OAAO,CAAC,GAAG;IAQX,OAAO,CAAC,KAAK;CAOd"}