@principal-ai/subsystems-core 0.29.0 → 0.30.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 (553) hide show
  1. package/README.md +15 -110
  2. package/dist/index.d.ts +7 -75
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +21 -205
  5. package/dist/index.js.map +1 -1
  6. package/dist/node.d.ts +7 -62
  7. package/dist/node.d.ts.map +1 -1
  8. package/dist/node.js +11 -146
  9. package/dist/node.js.map +1 -1
  10. package/dist/types/index.d.ts +3 -348
  11. package/dist/types/index.d.ts.map +1 -1
  12. package/dist/types/index.js +3 -19
  13. package/dist/types/index.js.map +1 -1
  14. package/package.json +7 -24
  15. package/src/index.ts +7 -580
  16. package/src/node.ts +21 -262
  17. package/src/types/index.ts +3 -456
  18. package/dist/ConfigurationLoader.d.ts +0 -76
  19. package/dist/ConfigurationLoader.d.ts.map +0 -1
  20. package/dist/ConfigurationLoader.js +0 -148
  21. package/dist/ConfigurationLoader.js.map +0 -1
  22. package/dist/ConfigurationValidator.d.ts +0 -31
  23. package/dist/ConfigurationValidator.d.ts.map +0 -1
  24. package/dist/ConfigurationValidator.js +0 -239
  25. package/dist/ConfigurationValidator.js.map +0 -1
  26. package/dist/EventProcessor.d.ts +0 -49
  27. package/dist/EventProcessor.d.ts.map +0 -1
  28. package/dist/EventProcessor.js +0 -220
  29. package/dist/EventProcessor.js.map +0 -1
  30. package/dist/EventRecorderService.d.ts +0 -305
  31. package/dist/EventRecorderService.d.ts.map +0 -1
  32. package/dist/EventRecorderService.js +0 -467
  33. package/dist/EventRecorderService.js.map +0 -1
  34. package/dist/LibraryLoader.d.ts +0 -65
  35. package/dist/LibraryLoader.d.ts.map +0 -1
  36. package/dist/LibraryLoader.js +0 -197
  37. package/dist/LibraryLoader.js.map +0 -1
  38. package/dist/PathBasedEventProcessor.d.ts +0 -77
  39. package/dist/PathBasedEventProcessor.d.ts.map +0 -1
  40. package/dist/PathBasedEventProcessor.js +0 -136
  41. package/dist/PathBasedEventProcessor.js.map +0 -1
  42. package/dist/SessionManager.d.ts +0 -194
  43. package/dist/SessionManager.d.ts.map +0 -1
  44. package/dist/SessionManager.js +0 -302
  45. package/dist/SessionManager.js.map +0 -1
  46. package/dist/ValidationEngine.d.ts +0 -31
  47. package/dist/ValidationEngine.d.ts.map +0 -1
  48. package/dist/ValidationEngine.js +0 -162
  49. package/dist/ValidationEngine.js.map +0 -1
  50. package/dist/auxiliary/AuxiliaryManifestValidator.d.ts +0 -41
  51. package/dist/auxiliary/AuxiliaryManifestValidator.d.ts.map +0 -1
  52. package/dist/auxiliary/AuxiliaryManifestValidator.js +0 -100
  53. package/dist/auxiliary/AuxiliaryManifestValidator.js.map +0 -1
  54. package/dist/auxiliary/index.d.ts +0 -9
  55. package/dist/auxiliary/index.d.ts.map +0 -1
  56. package/dist/auxiliary/index.js +0 -14
  57. package/dist/auxiliary/index.js.map +0 -1
  58. package/dist/auxiliary/validateAreaScopeDisjoint.d.ts +0 -24
  59. package/dist/auxiliary/validateAreaScopeDisjoint.d.ts.map +0 -1
  60. package/dist/auxiliary/validateAreaScopeDisjoint.js +0 -61
  61. package/dist/auxiliary/validateAreaScopeDisjoint.js.map +0 -1
  62. package/dist/cli/codegen.d.ts +0 -41
  63. package/dist/cli/codegen.d.ts.map +0 -1
  64. package/dist/cli/codegen.js +0 -257
  65. package/dist/cli/codegen.js.map +0 -1
  66. package/dist/codegen/type-generator.d.ts +0 -123
  67. package/dist/codegen/type-generator.d.ts.map +0 -1
  68. package/dist/codegen/type-generator.js +0 -433
  69. package/dist/codegen/type-generator.js.map +0 -1
  70. package/dist/codegen/usage-example.d.ts +0 -103
  71. package/dist/codegen/usage-example.d.ts.map +0 -1
  72. package/dist/codegen/usage-example.js +0 -258
  73. package/dist/codegen/usage-example.js.map +0 -1
  74. package/dist/dashboard/DashboardValidator.d.ts +0 -85
  75. package/dist/dashboard/DashboardValidator.d.ts.map +0 -1
  76. package/dist/dashboard/DashboardValidator.js +0 -775
  77. package/dist/dashboard/DashboardValidator.js.map +0 -1
  78. package/dist/dashboard/index.d.ts +0 -6
  79. package/dist/dashboard/index.d.ts.map +0 -1
  80. package/dist/dashboard/index.js +0 -10
  81. package/dist/dashboard/index.js.map +0 -1
  82. package/dist/discovery/CanvasDiscovery.d.ts +0 -160
  83. package/dist/discovery/CanvasDiscovery.d.ts.map +0 -1
  84. package/dist/discovery/CanvasDiscovery.js +0 -865
  85. package/dist/discovery/CanvasDiscovery.js.map +0 -1
  86. package/dist/discovery/CanvasFileManifest.d.ts +0 -86
  87. package/dist/discovery/CanvasFileManifest.d.ts.map +0 -1
  88. package/dist/discovery/CanvasFileManifest.js +0 -338
  89. package/dist/discovery/CanvasFileManifest.js.map +0 -1
  90. package/dist/discovery/LibraryDiscovery.d.ts +0 -108
  91. package/dist/discovery/LibraryDiscovery.d.ts.map +0 -1
  92. package/dist/discovery/LibraryDiscovery.js +0 -263
  93. package/dist/discovery/LibraryDiscovery.js.map +0 -1
  94. package/dist/discovery/types.d.ts +0 -403
  95. package/dist/discovery/types.d.ts.map +0 -1
  96. package/dist/discovery/types.js +0 -6
  97. package/dist/discovery/types.js.map +0 -1
  98. package/dist/events/EventsCanvasValidator.d.ts +0 -139
  99. package/dist/events/EventsCanvasValidator.d.ts.map +0 -1
  100. package/dist/events/EventsCanvasValidator.js +0 -281
  101. package/dist/events/EventsCanvasValidator.js.map +0 -1
  102. package/dist/events/NamespacePathIndex.d.ts +0 -61
  103. package/dist/events/NamespacePathIndex.d.ts.map +0 -1
  104. package/dist/events/NamespacePathIndex.js +0 -74
  105. package/dist/events/NamespacePathIndex.js.map +0 -1
  106. package/dist/events/OtelEventPathsValidator.d.ts +0 -75
  107. package/dist/events/OtelEventPathsValidator.d.ts.map +0 -1
  108. package/dist/events/OtelEventPathsValidator.js +0 -126
  109. package/dist/events/OtelEventPathsValidator.js.map +0 -1
  110. package/dist/events/ScopeEventsValidator.d.ts +0 -68
  111. package/dist/events/ScopeEventsValidator.d.ts.map +0 -1
  112. package/dist/events/ScopeEventsValidator.js +0 -91
  113. package/dist/events/ScopeEventsValidator.js.map +0 -1
  114. package/dist/events/index.d.ts +0 -9
  115. package/dist/events/index.d.ts.map +0 -1
  116. package/dist/events/index.js +0 -12
  117. package/dist/events/index.js.map +0 -1
  118. package/dist/events/path-helpers.d.ts +0 -33
  119. package/dist/events/path-helpers.d.ts.map +0 -1
  120. package/dist/events/path-helpers.js +0 -59
  121. package/dist/events/path-helpers.js.map +0 -1
  122. package/dist/execution/ExecutionLoader.d.ts +0 -135
  123. package/dist/execution/ExecutionLoader.d.ts.map +0 -1
  124. package/dist/execution/ExecutionLoader.js +0 -266
  125. package/dist/execution/ExecutionLoader.js.map +0 -1
  126. package/dist/execution/ExecutionValidator.d.ts +0 -94
  127. package/dist/execution/ExecutionValidator.d.ts.map +0 -1
  128. package/dist/execution/ExecutionValidator.js +0 -503
  129. package/dist/execution/ExecutionValidator.js.map +0 -1
  130. package/dist/generated/graph-converter-execution.types.d.ts +0 -177
  131. package/dist/generated/graph-converter-execution.types.d.ts.map +0 -1
  132. package/dist/generated/graph-converter-execution.types.js +0 -12
  133. package/dist/generated/graph-converter-execution.types.js.map +0 -1
  134. package/dist/helpers/GraphInstrumentationHelper.d.ts +0 -93
  135. package/dist/helpers/GraphInstrumentationHelper.d.ts.map +0 -1
  136. package/dist/helpers/GraphInstrumentationHelper.js +0 -252
  137. package/dist/helpers/GraphInstrumentationHelper.js.map +0 -1
  138. package/dist/matchers/SpanMatcher.d.ts +0 -107
  139. package/dist/matchers/SpanMatcher.d.ts.map +0 -1
  140. package/dist/matchers/SpanMatcher.js +0 -274
  141. package/dist/matchers/SpanMatcher.js.map +0 -1
  142. package/dist/orchestration/TraceOrchestrator.d.ts +0 -71
  143. package/dist/orchestration/TraceOrchestrator.d.ts.map +0 -1
  144. package/dist/orchestration/TraceOrchestrator.js +0 -416
  145. package/dist/orchestration/TraceOrchestrator.js.map +0 -1
  146. package/dist/parsers/OtlpTraceParser.d.ts +0 -131
  147. package/dist/parsers/OtlpTraceParser.d.ts.map +0 -1
  148. package/dist/parsers/OtlpTraceParser.js +0 -310
  149. package/dist/parsers/OtlpTraceParser.js.map +0 -1
  150. package/dist/registry/CompositeRegistry.d.ts +0 -71
  151. package/dist/registry/CompositeRegistry.d.ts.map +0 -1
  152. package/dist/registry/CompositeRegistry.js +0 -113
  153. package/dist/registry/CompositeRegistry.js.map +0 -1
  154. package/dist/registry/EventRegistry.d.ts +0 -79
  155. package/dist/registry/EventRegistry.d.ts.map +0 -1
  156. package/dist/registry/EventRegistry.js +0 -165
  157. package/dist/registry/EventRegistry.js.map +0 -1
  158. package/dist/registry/LocalRegistry.d.ts +0 -111
  159. package/dist/registry/LocalRegistry.d.ts.map +0 -1
  160. package/dist/registry/LocalRegistry.js +0 -335
  161. package/dist/registry/LocalRegistry.js.map +0 -1
  162. package/dist/registry/RemoteRegistry.d.ts +0 -122
  163. package/dist/registry/RemoteRegistry.d.ts.map +0 -1
  164. package/dist/registry/RemoteRegistry.js +0 -399
  165. package/dist/registry/RemoteRegistry.js.map +0 -1
  166. package/dist/registry/VersionRegistry.d.ts +0 -51
  167. package/dist/registry/VersionRegistry.d.ts.map +0 -1
  168. package/dist/registry/VersionRegistry.js +0 -105
  169. package/dist/registry/VersionRegistry.js.map +0 -1
  170. package/dist/rules/config.d.ts +0 -57
  171. package/dist/rules/config.d.ts.map +0 -1
  172. package/dist/rules/config.js +0 -382
  173. package/dist/rules/config.js.map +0 -1
  174. package/dist/rules/engine.d.ts +0 -70
  175. package/dist/rules/engine.d.ts.map +0 -1
  176. package/dist/rules/engine.js +0 -373
  177. package/dist/rules/engine.js.map +0 -1
  178. package/dist/rules/implementations/connection-type-references.d.ts +0 -7
  179. package/dist/rules/implementations/connection-type-references.d.ts.map +0 -1
  180. package/dist/rules/implementations/connection-type-references.js +0 -107
  181. package/dist/rules/implementations/connection-type-references.js.map +0 -1
  182. package/dist/rules/implementations/dead-end-states.d.ts +0 -17
  183. package/dist/rules/implementations/dead-end-states.d.ts.map +0 -1
  184. package/dist/rules/implementations/dead-end-states.js +0 -75
  185. package/dist/rules/implementations/dead-end-states.js.map +0 -1
  186. package/dist/rules/implementations/index.d.ts +0 -23
  187. package/dist/rules/implementations/index.d.ts.map +0 -1
  188. package/dist/rules/implementations/index.js +0 -73
  189. package/dist/rules/implementations/index.js.map +0 -1
  190. package/dist/rules/implementations/minimum-node-sources.d.ts +0 -24
  191. package/dist/rules/implementations/minimum-node-sources.d.ts.map +0 -1
  192. package/dist/rules/implementations/minimum-node-sources.js +0 -59
  193. package/dist/rules/implementations/minimum-node-sources.js.map +0 -1
  194. package/dist/rules/implementations/no-unknown-fields.d.ts +0 -7
  195. package/dist/rules/implementations/no-unknown-fields.d.ts.map +0 -1
  196. package/dist/rules/implementations/no-unknown-fields.js +0 -216
  197. package/dist/rules/implementations/no-unknown-fields.js.map +0 -1
  198. package/dist/rules/implementations/orphaned-edge-types.d.ts +0 -7
  199. package/dist/rules/implementations/orphaned-edge-types.d.ts.map +0 -1
  200. package/dist/rules/implementations/orphaned-edge-types.js +0 -50
  201. package/dist/rules/implementations/orphaned-edge-types.js.map +0 -1
  202. package/dist/rules/implementations/orphaned-node-types.d.ts +0 -7
  203. package/dist/rules/implementations/orphaned-node-types.d.ts.map +0 -1
  204. package/dist/rules/implementations/orphaned-node-types.js +0 -53
  205. package/dist/rules/implementations/orphaned-node-types.js.map +0 -1
  206. package/dist/rules/implementations/required-metadata.d.ts +0 -7
  207. package/dist/rules/implementations/required-metadata.d.ts.map +0 -1
  208. package/dist/rules/implementations/required-metadata.js +0 -48
  209. package/dist/rules/implementations/required-metadata.js.map +0 -1
  210. package/dist/rules/implementations/state-transition-references.d.ts +0 -7
  211. package/dist/rules/implementations/state-transition-references.d.ts.map +0 -1
  212. package/dist/rules/implementations/state-transition-references.js +0 -138
  213. package/dist/rules/implementations/state-transition-references.js.map +0 -1
  214. package/dist/rules/implementations/unreachable-states.d.ts +0 -7
  215. package/dist/rules/implementations/unreachable-states.d.ts.map +0 -1
  216. package/dist/rules/implementations/unreachable-states.js +0 -83
  217. package/dist/rules/implementations/unreachable-states.js.map +0 -1
  218. package/dist/rules/implementations/valid-action-patterns.d.ts +0 -17
  219. package/dist/rules/implementations/valid-action-patterns.d.ts.map +0 -1
  220. package/dist/rules/implementations/valid-action-patterns.js +0 -112
  221. package/dist/rules/implementations/valid-action-patterns.js.map +0 -1
  222. package/dist/rules/implementations/valid-color-format.d.ts +0 -7
  223. package/dist/rules/implementations/valid-color-format.d.ts.map +0 -1
  224. package/dist/rules/implementations/valid-color-format.js +0 -94
  225. package/dist/rules/implementations/valid-color-format.js.map +0 -1
  226. package/dist/rules/implementations/valid-edge-types.d.ts +0 -7
  227. package/dist/rules/implementations/valid-edge-types.d.ts.map +0 -1
  228. package/dist/rules/implementations/valid-edge-types.js +0 -248
  229. package/dist/rules/implementations/valid-edge-types.js.map +0 -1
  230. package/dist/rules/implementations/valid-node-types.d.ts +0 -7
  231. package/dist/rules/implementations/valid-node-types.d.ts.map +0 -1
  232. package/dist/rules/implementations/valid-node-types.js +0 -187
  233. package/dist/rules/implementations/valid-node-types.js.map +0 -1
  234. package/dist/rules/index.d.ts +0 -28
  235. package/dist/rules/index.d.ts.map +0 -1
  236. package/dist/rules/index.js +0 -70
  237. package/dist/rules/index.js.map +0 -1
  238. package/dist/rules/types.d.ts +0 -309
  239. package/dist/rules/types.d.ts.map +0 -1
  240. package/dist/rules/types.js +0 -40
  241. package/dist/rules/types.js.map +0 -1
  242. package/dist/scopes/ScopePathIndex.d.ts +0 -56
  243. package/dist/scopes/ScopePathIndex.d.ts.map +0 -1
  244. package/dist/scopes/ScopePathIndex.js +0 -67
  245. package/dist/scopes/ScopePathIndex.js.map +0 -1
  246. package/dist/scopes/ScopesCanvasValidator.d.ts +0 -76
  247. package/dist/scopes/ScopesCanvasValidator.d.ts.map +0 -1
  248. package/dist/scopes/ScopesCanvasValidator.js +0 -221
  249. package/dist/scopes/ScopesCanvasValidator.js.map +0 -1
  250. package/dist/scopes/index.d.ts +0 -12
  251. package/dist/scopes/index.d.ts.map +0 -1
  252. package/dist/scopes/index.js +0 -30
  253. package/dist/scopes/index.js.map +0 -1
  254. package/dist/scopes/utils.d.ts +0 -85
  255. package/dist/scopes/utils.d.ts.map +0 -1
  256. package/dist/scopes/utils.js +0 -143
  257. package/dist/scopes/utils.js.map +0 -1
  258. package/dist/scopes/validateScopeNamespaceNesting.d.ts +0 -38
  259. package/dist/scopes/validateScopeNamespaceNesting.d.ts.map +0 -1
  260. package/dist/scopes/validateScopeNamespaceNesting.js +0 -69
  261. package/dist/scopes/validateScopeNamespaceNesting.js.map +0 -1
  262. package/dist/spans/index.d.ts +0 -12
  263. package/dist/spans/index.d.ts.map +0 -1
  264. package/dist/spans/index.js +0 -25
  265. package/dist/spans/index.js.map +0 -1
  266. package/dist/spans/utils.d.ts +0 -70
  267. package/dist/spans/utils.d.ts.map +0 -1
  268. package/dist/spans/utils.js +0 -205
  269. package/dist/spans/utils.js.map +0 -1
  270. package/dist/storyboard/builder.d.ts +0 -135
  271. package/dist/storyboard/builder.d.ts.map +0 -1
  272. package/dist/storyboard/builder.js +0 -235
  273. package/dist/storyboard/builder.js.map +0 -1
  274. package/dist/storyboard/index.d.ts +0 -9
  275. package/dist/storyboard/index.d.ts.map +0 -1
  276. package/dist/storyboard/index.js +0 -18
  277. package/dist/storyboard/index.js.map +0 -1
  278. package/dist/storyboard/types.d.ts +0 -101
  279. package/dist/storyboard/types.d.ts.map +0 -1
  280. package/dist/storyboard/types.js +0 -10
  281. package/dist/storyboard/types.js.map +0 -1
  282. package/dist/telemetry/coverage.d.ts +0 -92
  283. package/dist/telemetry/coverage.d.ts.map +0 -1
  284. package/dist/telemetry/coverage.js +0 -335
  285. package/dist/telemetry/coverage.js.map +0 -1
  286. package/dist/telemetry/event-validator.d.ts +0 -86
  287. package/dist/telemetry/event-validator.d.ts.map +0 -1
  288. package/dist/telemetry/event-validator.js +0 -257
  289. package/dist/telemetry/event-validator.js.map +0 -1
  290. package/dist/types/audit.d.ts +0 -236
  291. package/dist/types/audit.d.ts.map +0 -1
  292. package/dist/types/audit.js +0 -53
  293. package/dist/types/audit.js.map +0 -1
  294. package/dist/types/auxiliary.d.ts +0 -54
  295. package/dist/types/auxiliary.d.ts.map +0 -1
  296. package/dist/types/auxiliary.js +0 -27
  297. package/dist/types/auxiliary.js.map +0 -1
  298. package/dist/types/canvas-scope.d.ts +0 -156
  299. package/dist/types/canvas-scope.d.ts.map +0 -1
  300. package/dist/types/canvas-scope.js +0 -62
  301. package/dist/types/canvas-scope.js.map +0 -1
  302. package/dist/types/canvas.d.ts +0 -1138
  303. package/dist/types/canvas.d.ts.map +0 -1
  304. package/dist/types/canvas.js +0 -178
  305. package/dist/types/canvas.js.map +0 -1
  306. package/dist/types/dashboard.d.ts +0 -170
  307. package/dist/types/dashboard.d.ts.map +0 -1
  308. package/dist/types/dashboard.js +0 -14
  309. package/dist/types/dashboard.js.map +0 -1
  310. package/dist/types/library.d.ts +0 -227
  311. package/dist/types/library.d.ts.map +0 -1
  312. package/dist/types/library.js +0 -16
  313. package/dist/types/library.js.map +0 -1
  314. package/dist/types/otel.d.ts +0 -465
  315. package/dist/types/otel.d.ts.map +0 -1
  316. package/dist/types/otel.js +0 -163
  317. package/dist/types/otel.js.map +0 -1
  318. package/dist/types/path-based-config.d.ts +0 -235
  319. package/dist/types/path-based-config.d.ts.map +0 -1
  320. package/dist/types/path-based-config.js +0 -11
  321. package/dist/types/path-based-config.js.map +0 -1
  322. package/dist/types/registered-trace.d.ts +0 -337
  323. package/dist/types/registered-trace.d.ts.map +0 -1
  324. package/dist/types/registered-trace.js +0 -16
  325. package/dist/types/registered-trace.js.map +0 -1
  326. package/dist/types/resource-match.d.ts +0 -207
  327. package/dist/types/resource-match.d.ts.map +0 -1
  328. package/dist/types/resource-match.js +0 -74
  329. package/dist/types/resource-match.js.map +0 -1
  330. package/dist/types/version-registry.d.ts +0 -137
  331. package/dist/types/version-registry.d.ts.map +0 -1
  332. package/dist/types/version-registry.js +0 -10
  333. package/dist/types/version-registry.js.map +0 -1
  334. package/dist/utils/CanvasConverter.d.ts +0 -148
  335. package/dist/utils/CanvasConverter.d.ts.map +0 -1
  336. package/dist/utils/CanvasConverter.js +0 -530
  337. package/dist/utils/CanvasConverter.js.map +0 -1
  338. package/dist/utils/GraphConverter.d.ts +0 -18
  339. package/dist/utils/GraphConverter.d.ts.map +0 -1
  340. package/dist/utils/GraphConverter.js +0 -80
  341. package/dist/utils/GraphConverter.js.map +0 -1
  342. package/dist/utils/PathMatcher.d.ts +0 -55
  343. package/dist/utils/PathMatcher.d.ts.map +0 -1
  344. package/dist/utils/PathMatcher.js +0 -178
  345. package/dist/utils/PathMatcher.js.map +0 -1
  346. package/dist/utils/TraceToCanvas.d.ts +0 -83
  347. package/dist/utils/TraceToCanvas.d.ts.map +0 -1
  348. package/dist/utils/TraceToCanvas.js +0 -336
  349. package/dist/utils/TraceToCanvas.js.map +0 -1
  350. package/dist/utils/YamlParser.d.ts +0 -36
  351. package/dist/utils/YamlParser.d.ts.map +0 -1
  352. package/dist/utils/YamlParser.js +0 -92
  353. package/dist/utils/YamlParser.js.map +0 -1
  354. package/dist/utils/registeredTraceHelpers.d.ts +0 -76
  355. package/dist/utils/registeredTraceHelpers.d.ts.map +0 -1
  356. package/dist/utils/registeredTraceHelpers.js +0 -203
  357. package/dist/utils/registeredTraceHelpers.js.map +0 -1
  358. package/dist/utils/traceAggregation.d.ts +0 -25
  359. package/dist/utils/traceAggregation.d.ts.map +0 -1
  360. package/dist/utils/traceAggregation.js +0 -140
  361. package/dist/utils/traceAggregation.js.map +0 -1
  362. package/dist/validation/OtelCanvasValidator.d.ts +0 -40
  363. package/dist/validation/OtelCanvasValidator.d.ts.map +0 -1
  364. package/dist/validation/OtelCanvasValidator.js +0 -59
  365. package/dist/validation/OtelCanvasValidator.js.map +0 -1
  366. package/dist/validation/index.d.ts +0 -8
  367. package/dist/validation/index.d.ts.map +0 -1
  368. package/dist/validation/index.js +0 -13
  369. package/dist/validation/index.js.map +0 -1
  370. package/dist/validation/libraryValidation.d.ts +0 -53
  371. package/dist/validation/libraryValidation.d.ts.map +0 -1
  372. package/dist/validation/libraryValidation.js +0 -115
  373. package/dist/validation/libraryValidation.js.map +0 -1
  374. package/dist/workflow/edge-derivation.d.ts +0 -111
  375. package/dist/workflow/edge-derivation.d.ts.map +0 -1
  376. package/dist/workflow/edge-derivation.js +0 -174
  377. package/dist/workflow/edge-derivation.js.map +0 -1
  378. package/dist/workflow/edge-validation.d.ts +0 -170
  379. package/dist/workflow/edge-validation.d.ts.map +0 -1
  380. package/dist/workflow/edge-validation.js +0 -332
  381. package/dist/workflow/edge-validation.js.map +0 -1
  382. package/dist/workflow/example.d.ts +0 -11
  383. package/dist/workflow/example.d.ts.map +0 -1
  384. package/dist/workflow/example.js +0 -310
  385. package/dist/workflow/example.js.map +0 -1
  386. package/dist/workflow/index.d.ts +0 -20
  387. package/dist/workflow/index.d.ts.map +0 -1
  388. package/dist/workflow/index.js +0 -49
  389. package/dist/workflow/index.js.map +0 -1
  390. package/dist/workflow/scenario-matcher.d.ts +0 -63
  391. package/dist/workflow/scenario-matcher.d.ts.map +0 -1
  392. package/dist/workflow/scenario-matcher.js +0 -215
  393. package/dist/workflow/scenario-matcher.js.map +0 -1
  394. package/dist/workflow/template-parser.d.ts +0 -73
  395. package/dist/workflow/template-parser.d.ts.map +0 -1
  396. package/dist/workflow/template-parser.js +0 -280
  397. package/dist/workflow/template-parser.js.map +0 -1
  398. package/dist/workflow/template-renderer.d.ts +0 -45
  399. package/dist/workflow/template-renderer.d.ts.map +0 -1
  400. package/dist/workflow/template-renderer.js +0 -401
  401. package/dist/workflow/template-renderer.js.map +0 -1
  402. package/dist/workflow/types.d.ts +0 -393
  403. package/dist/workflow/types.d.ts.map +0 -1
  404. package/dist/workflow/types.js +0 -40
  405. package/dist/workflow/types.js.map +0 -1
  406. package/dist/workflow/validator.d.ts +0 -363
  407. package/dist/workflow/validator.d.ts.map +0 -1
  408. package/dist/workflow/validator.js +0 -2283
  409. package/dist/workflow/validator.js.map +0 -1
  410. package/schemas/auxiliary.manifest.schema.json +0 -56
  411. package/src/ConfigurationLoader.test.ts +0 -466
  412. package/src/ConfigurationLoader.ts +0 -184
  413. package/src/ConfigurationValidator.test.ts +0 -200
  414. package/src/ConfigurationValidator.ts +0 -273
  415. package/src/EventProcessor.test.ts +0 -405
  416. package/src/EventProcessor.ts +0 -256
  417. package/src/EventRecorderService.test.ts +0 -543
  418. package/src/EventRecorderService.ts +0 -741
  419. package/src/LibraryLoader.ts +0 -194
  420. package/src/PathBasedEventProcessor.test.ts +0 -336
  421. package/src/PathBasedEventProcessor.ts +0 -196
  422. package/src/SessionManager.test.ts +0 -424
  423. package/src/SessionManager.ts +0 -471
  424. package/src/ValidationEngine.test.ts +0 -520
  425. package/src/ValidationEngine.ts +0 -200
  426. package/src/auxiliary/AuxiliaryManifestValidator.test.ts +0 -93
  427. package/src/auxiliary/AuxiliaryManifestValidator.ts +0 -132
  428. package/src/auxiliary/index.ts +0 -18
  429. package/src/auxiliary/validateAreaScopeDisjoint.test.ts +0 -85
  430. package/src/auxiliary/validateAreaScopeDisjoint.ts +0 -72
  431. package/src/cli/codegen.ts +0 -286
  432. package/src/codegen/type-generator.test.ts +0 -219
  433. package/src/codegen/type-generator.ts +0 -560
  434. package/src/codegen/usage-example.ts +0 -357
  435. package/src/dashboard/DashboardValidator.ts +0 -904
  436. package/src/dashboard/index.ts +0 -14
  437. package/src/discovery/CanvasDiscovery.test.ts +0 -691
  438. package/src/discovery/CanvasDiscovery.ts +0 -1114
  439. package/src/discovery/CanvasFileManifest.test.ts +0 -521
  440. package/src/discovery/CanvasFileManifest.ts +0 -419
  441. package/src/discovery/LibraryDiscovery.test.ts +0 -329
  442. package/src/discovery/LibraryDiscovery.ts +0 -386
  443. package/src/discovery/types.ts +0 -453
  444. package/src/events/EventsCanvasValidator.test.ts +0 -191
  445. package/src/events/EventsCanvasValidator.ts +0 -428
  446. package/src/events/NamespacePathIndex.test.ts +0 -97
  447. package/src/events/NamespacePathIndex.ts +0 -100
  448. package/src/events/OtelEventPathsValidator.test.ts +0 -243
  449. package/src/events/OtelEventPathsValidator.ts +0 -191
  450. package/src/events/ScopeEventsValidator.test.ts +0 -173
  451. package/src/events/ScopeEventsValidator.ts +0 -158
  452. package/src/events/index.ts +0 -27
  453. package/src/events/path-helpers.ts +0 -53
  454. package/src/execution/ExecutionLoader.test.ts +0 -378
  455. package/src/execution/ExecutionLoader.ts +0 -331
  456. package/src/execution/ExecutionValidator.test.ts +0 -503
  457. package/src/execution/ExecutionValidator.ts +0 -617
  458. package/src/generated/graph-converter-execution.types.ts +0 -193
  459. package/src/helpers/GraphInstrumentationHelper.test.ts +0 -364
  460. package/src/helpers/GraphInstrumentationHelper.ts +0 -323
  461. package/src/matchers/SpanMatcher.test.ts +0 -1105
  462. package/src/matchers/SpanMatcher.ts +0 -381
  463. package/src/orchestration/TraceOrchestrator.ts +0 -560
  464. package/src/orchestration/__tests__/TraceOrchestrator.test.ts +0 -1098
  465. package/src/parsers/OtlpTraceParser.ts +0 -401
  466. package/src/parsers/__tests__/OtlpTraceParser.test.ts +0 -197
  467. package/src/registry/CompositeRegistry.ts +0 -140
  468. package/src/registry/EventRegistry.test.ts +0 -387
  469. package/src/registry/EventRegistry.ts +0 -191
  470. package/src/registry/LocalRegistry.ts +0 -416
  471. package/src/registry/RemoteRegistry.ts +0 -499
  472. package/src/registry/VersionRegistry.test.ts +0 -223
  473. package/src/registry/VersionRegistry.ts +0 -121
  474. package/src/rules/config.test.ts +0 -277
  475. package/src/rules/config.ts +0 -450
  476. package/src/rules/engine.test.ts +0 -331
  477. package/src/rules/engine.ts +0 -448
  478. package/src/rules/implementations/connection-type-references.ts +0 -117
  479. package/src/rules/implementations/dead-end-states.ts +0 -101
  480. package/src/rules/implementations/index.ts +0 -66
  481. package/src/rules/implementations/minimum-node-sources.ts +0 -84
  482. package/src/rules/implementations/no-unknown-fields.ts +0 -372
  483. package/src/rules/implementations/orphaned-edge-types.ts +0 -55
  484. package/src/rules/implementations/orphaned-node-types.ts +0 -58
  485. package/src/rules/implementations/required-metadata.ts +0 -52
  486. package/src/rules/implementations/state-transition-references.ts +0 -155
  487. package/src/rules/implementations/unreachable-states.ts +0 -94
  488. package/src/rules/implementations/valid-action-patterns.ts +0 -140
  489. package/src/rules/implementations/valid-color-format.ts +0 -152
  490. package/src/rules/implementations/valid-edge-types.ts +0 -273
  491. package/src/rules/implementations/valid-node-types.ts +0 -200
  492. package/src/rules/index.ts +0 -92
  493. package/src/rules/types.ts +0 -426
  494. package/src/scopes/ScopePathIndex.test.ts +0 -94
  495. package/src/scopes/ScopePathIndex.ts +0 -89
  496. package/src/scopes/ScopesCanvasValidator.test.ts +0 -127
  497. package/src/scopes/ScopesCanvasValidator.ts +0 -305
  498. package/src/scopes/__tests__/utils.test.ts +0 -383
  499. package/src/scopes/index.ts +0 -42
  500. package/src/scopes/utils.ts +0 -182
  501. package/src/scopes/validateScopeNamespaceNesting.test.ts +0 -127
  502. package/src/scopes/validateScopeNamespaceNesting.ts +0 -88
  503. package/src/spans/index.ts +0 -24
  504. package/src/spans/utils.ts +0 -249
  505. package/src/storyboard/builder.ts +0 -308
  506. package/src/storyboard/index.ts +0 -26
  507. package/src/storyboard/types.ts +0 -117
  508. package/src/telemetry/coverage.ts +0 -480
  509. package/src/telemetry/event-validator.ts +0 -312
  510. package/src/types/audit.ts +0 -314
  511. package/src/types/auxiliary.ts +0 -63
  512. package/src/types/canvas-scope.ts +0 -190
  513. package/src/types/canvas.test.ts +0 -199
  514. package/src/types/canvas.ts +0 -1395
  515. package/src/types/dashboard.ts +0 -257
  516. package/src/types/library.ts +0 -283
  517. package/src/types/otel.test.ts +0 -219
  518. package/src/types/otel.ts +0 -620
  519. package/src/types/path-based-config.ts +0 -285
  520. package/src/types/registered-trace.ts +0 -432
  521. package/src/types/resource-match.ts +0 -263
  522. package/src/types/version-registry.ts +0 -150
  523. package/src/utils/CanvasConverter.ts +0 -670
  524. package/src/utils/GraphConverter.test.ts +0 -322
  525. package/src/utils/GraphConverter.ts +0 -84
  526. package/src/utils/PathMatcher.test.ts +0 -139
  527. package/src/utils/PathMatcher.ts +0 -185
  528. package/src/utils/TraceToCanvas.test.ts +0 -310
  529. package/src/utils/TraceToCanvas.ts +0 -510
  530. package/src/utils/YamlParser.ts +0 -77
  531. package/src/utils/registeredTraceHelpers.ts +0 -251
  532. package/src/utils/traceAggregation.test.ts +0 -385
  533. package/src/utils/traceAggregation.ts +0 -173
  534. package/src/validation/OtelCanvasValidator.ts +0 -86
  535. package/src/validation/index.ts +0 -17
  536. package/src/validation/libraryValidation.ts +0 -206
  537. package/src/workflow/README.md +0 -408
  538. package/src/workflow/__tests__/edge-derivation.test.ts +0 -449
  539. package/src/workflow/__tests__/edge-validation.test.ts +0 -417
  540. package/src/workflow/__tests__/scenario-matcher.test.ts +0 -225
  541. package/src/workflow/__tests__/template-parser.test.ts +0 -276
  542. package/src/workflow/__tests__/template-renderer.test.ts +0 -509
  543. package/src/workflow/__tests__/types.test.ts +0 -187
  544. package/src/workflow/__tests__/validator.test.ts +0 -3225
  545. package/src/workflow/edge-derivation.ts +0 -265
  546. package/src/workflow/edge-validation.ts +0 -503
  547. package/src/workflow/example.ts +0 -330
  548. package/src/workflow/index.ts +0 -86
  549. package/src/workflow/scenario-matcher.ts +0 -253
  550. package/src/workflow/template-parser.ts +0 -350
  551. package/src/workflow/template-renderer.ts +0 -453
  552. package/src/workflow/types.ts +0 -511
  553. package/src/workflow/validator.ts +0 -2737
@@ -1,433 +0,0 @@
1
- "use strict";
2
- /**
3
- * Type Generator
4
- *
5
- * Generates TypeScript types from canvas event schemas.
6
- * Similar to how GraphQL Code Generator works for GraphQL schemas,
7
- * or how OpenAPI generators work for API specs.
8
- *
9
- * Precedents:
10
- * - GraphQL Code Generator: graphql-code-generator.com
11
- * - OpenAPI Generator: openapi-generator.tech
12
- * - Protobuf: generates code from .proto files
13
- * - Zod: runtime validation with TypeScript inference
14
- */
15
- Object.defineProperty(exports, "__esModule", { value: true });
16
- exports.generatorRegistry = exports.generateTypes = exports.TypeScriptGenerator = void 0;
17
- const canvas_1 = require("../types/canvas");
18
- /**
19
- * TypeScript Type Generator
20
- *
21
- * Generates TypeScript types from canvas event schemas.
22
- * Similar to GraphQL Code Generator but for canvas schemas.
23
- */
24
- class TypeScriptGenerator {
25
- constructor() {
26
- this.language = 'typescript';
27
- }
28
- generate(canvas, options, library) {
29
- const opts = {
30
- readonly: options?.style?.readonly ?? false,
31
- strictNullChecks: options?.style?.strictNullChecks ?? true,
32
- includeDocComments: options?.style?.includeDocComments ?? true,
33
- namespace: options?.namespace,
34
- };
35
- const lines = [];
36
- // File header
37
- lines.push('/**');
38
- lines.push(` * Generated types from canvas: ${canvas.name || canvas.pv?.name || 'Untitled'}`);
39
- lines.push(' *');
40
- lines.push(' * DO NOT EDIT MANUALLY - This file is auto-generated');
41
- lines.push(' * Generated by @principal-ai/subsystems-core');
42
- lines.push(' *');
43
- lines.push(` * Canvas: ${canvas.pv?.description || 'No description'}`);
44
- lines.push(' */');
45
- lines.push('');
46
- // Namespace (if specified)
47
- if (opts.namespace) {
48
- lines.push(`export namespace ${opts.namespace} {`);
49
- }
50
- // Group nodes by base ID (strip numeric suffixes like -1, -2, etc.)
51
- // This allows multiple nodes representing states of the same component
52
- // to be grouped into a single namespace
53
- if (canvas.nodes) {
54
- const nodeGroups = new Map();
55
- for (const node of canvas.nodes) {
56
- let eventSchema;
57
- // Check for OTEL event node (top-level event/eventRef fields)
58
- if ((0, canvas_1.isOtelEventNode)(node)) {
59
- if (node.event) {
60
- eventSchema = node.event;
61
- }
62
- else if (node.eventRef) {
63
- eventSchema = this.resolveLibraryEvent(node.eventRef, library);
64
- if (!eventSchema) {
65
- console.warn(`Node '${node.id}' references unknown library event '${node.eventRef}'`);
66
- continue;
67
- }
68
- }
69
- }
70
- // Check for standard node with pv.event/pv.eventRef
71
- else if ((0, canvas_1.isStandardCanvasNode)(node)) {
72
- if (node.pv?.event) {
73
- eventSchema = node.pv.event;
74
- }
75
- else if (node.pv?.eventRef) {
76
- eventSchema = this.resolveLibraryEvent(node.pv.eventRef, library);
77
- if (!eventSchema) {
78
- console.warn(`Node '${node.id}' references unknown library event '${node.pv.eventRef}'`);
79
- continue;
80
- }
81
- }
82
- }
83
- if (eventSchema) {
84
- // Group by base ID (e.g., "graph-converter-1" -> "graph-converter")
85
- const baseId = node.id.replace(/-\d+$/, '');
86
- if (!nodeGroups.has(baseId)) {
87
- nodeGroups.set(baseId, []);
88
- }
89
- nodeGroups.get(baseId).push({ nodeId: node.id, eventSchema });
90
- }
91
- }
92
- // Generate types for each component group
93
- for (const [baseId, nodes] of nodeGroups) {
94
- lines.push(...this.generateComponentTypes(baseId, nodes, opts));
95
- lines.push('');
96
- }
97
- }
98
- // Generate union type of all event names
99
- lines.push(...this.generateEventNameUnion(canvas, opts, library));
100
- lines.push('');
101
- // Generate event emitter helper type
102
- lines.push(...this.generateEmitterTypes(canvas, opts));
103
- // Close namespace
104
- if (opts.namespace) {
105
- lines.push('}');
106
- }
107
- const code = lines.join('\n');
108
- const filename = this.generateFilename(canvas);
109
- return {
110
- code,
111
- extension: 'ts',
112
- filename,
113
- };
114
- }
115
- /**
116
- * Generate types for a component (group of related nodes)
117
- * Groups multiple node instances (e.g., graph-converter-1, graph-converter-2)
118
- * into a single namespace with all their events
119
- */
120
- generateComponentTypes(baseId, nodes, opts) {
121
- const lines = [];
122
- const typeName = this.nodeIdToTypeName(baseId);
123
- if (opts.includeDocComments) {
124
- lines.push(`/**`);
125
- lines.push(` * Event types for component: ${baseId}`);
126
- lines.push(` */`);
127
- }
128
- lines.push(`export namespace ${typeName} {`);
129
- // Generate interface for each event in the component
130
- const interfaceNames = [];
131
- const eventNames = [];
132
- for (const { eventSchema } of nodes) {
133
- lines.push(...this.generateEventInterface(eventSchema.name, eventSchema, opts));
134
- lines.push('');
135
- interfaceNames.push(this.eventNameToTypeName(eventSchema.name));
136
- eventNames.push(eventSchema.name);
137
- }
138
- // Export union of all event types
139
- if (opts.includeDocComments) {
140
- lines.push(' /**');
141
- lines.push(` * All event types for ${baseId}`);
142
- lines.push(' */');
143
- }
144
- if (interfaceNames.length === 1) {
145
- lines.push(` export type Event = ${interfaceNames[0]};`);
146
- }
147
- else {
148
- lines.push(` export type Event = ${interfaceNames.join(' | ')};`);
149
- }
150
- lines.push('');
151
- // Generate event name union
152
- if (opts.includeDocComments) {
153
- lines.push(' /**');
154
- lines.push(` * All event names for ${baseId}`);
155
- lines.push(' */');
156
- }
157
- if (eventNames.length === 1) {
158
- lines.push(` export type EventName = '${eventNames[0]}';`);
159
- }
160
- else {
161
- lines.push(` export type EventName = ${eventNames.map(n => `'${n}'`).join(' | ')};`);
162
- }
163
- lines.push('}');
164
- return lines;
165
- }
166
- generateNodeTypes(nodeId, eventSchema, opts) {
167
- const lines = [];
168
- const typeName = this.nodeIdToTypeName(nodeId);
169
- if (opts.includeDocComments) {
170
- lines.push(`/**`);
171
- lines.push(` * Event type for node: ${nodeId}`);
172
- lines.push(` */`);
173
- }
174
- lines.push(`export namespace ${typeName} {`);
175
- // Generate interface for the single event
176
- lines.push(...this.generateEventInterface(eventSchema.name, eventSchema, opts));
177
- lines.push('');
178
- // Export the event type directly (no union needed for single event)
179
- const interfaceName = this.eventNameToTypeName(eventSchema.name);
180
- lines.push(' /**');
181
- lines.push(` * Event type for ${nodeId}`);
182
- lines.push(' */');
183
- lines.push(` export type Event = ${interfaceName};`);
184
- lines.push('');
185
- // Generate event name literal
186
- lines.push(' /**');
187
- lines.push(` * Event name for ${nodeId}`);
188
- lines.push(' */');
189
- lines.push(` export type EventName = '${eventSchema.name}';`);
190
- lines.push('}');
191
- return lines;
192
- }
193
- generateEventInterface(eventName, schema, opts) {
194
- const lines = [];
195
- const interfaceName = this.eventNameToTypeName(eventName);
196
- const readonly = opts.readonly ? 'readonly ' : '';
197
- if (opts.includeDocComments) {
198
- lines.push(' /**');
199
- lines.push(` * ${schema.description}`);
200
- lines.push(' */');
201
- }
202
- lines.push(` export interface ${interfaceName} {`);
203
- // Event name as literal type
204
- lines.push(` ${readonly}name: '${eventName}';`);
205
- // Attributes
206
- lines.push(` ${readonly}attributes: {`);
207
- for (const [fieldName, fieldSchema] of Object.entries(schema.attributes)) {
208
- const optional = !fieldSchema.required && opts.strictNullChecks ? '?' : '';
209
- const type = this.fieldTypeToTsType(fieldSchema);
210
- if (opts.includeDocComments && fieldSchema.description) {
211
- lines.push(` /** ${fieldSchema.description} */`);
212
- }
213
- lines.push(` ${readonly}'${fieldName}'${optional}: ${type};`);
214
- }
215
- lines.push(' };');
216
- lines.push(' }');
217
- return lines;
218
- }
219
- generateEventNameUnion(canvas, opts, library) {
220
- const lines = [];
221
- const allEventNames = new Set();
222
- if (canvas.nodes) {
223
- for (const node of canvas.nodes) {
224
- // Check for OTEL event node (top-level event/eventRef fields)
225
- if ((0, canvas_1.isOtelEventNode)(node)) {
226
- if (node.event?.name) {
227
- allEventNames.add(node.event.name);
228
- }
229
- else if (node.eventRef) {
230
- const eventSchema = this.resolveLibraryEvent(node.eventRef, library);
231
- if (eventSchema) {
232
- allEventNames.add(eventSchema.name);
233
- }
234
- }
235
- }
236
- // Check for standard node with pv.event/pv.eventRef
237
- else if ((0, canvas_1.isStandardCanvasNode)(node)) {
238
- if (node.pv?.event?.name) {
239
- allEventNames.add(node.pv.event.name);
240
- }
241
- else if (node.pv?.eventRef) {
242
- const eventSchema = this.resolveLibraryEvent(node.pv.eventRef, library);
243
- if (eventSchema) {
244
- allEventNames.add(eventSchema.name);
245
- }
246
- }
247
- }
248
- }
249
- }
250
- if (allEventNames.size === 0) {
251
- return lines;
252
- }
253
- if (opts.includeDocComments) {
254
- lines.push('/**');
255
- lines.push(' * Union of all event names in the canvas');
256
- lines.push(' */');
257
- }
258
- lines.push(`export type AllEventNames = ${Array.from(allEventNames).map(n => `'${n}'`).join(' | ')};`);
259
- return lines;
260
- }
261
- generateEmitterTypes(canvas, opts) {
262
- const lines = [];
263
- if (opts.includeDocComments) {
264
- lines.push('/**');
265
- lines.push(' * Type-safe event emitter for a specific node');
266
- lines.push(' *');
267
- lines.push(' * @example');
268
- lines.push(' * ```typescript');
269
- lines.push(' * const emit: NodeEmitter<GraphConverter.EventName, GraphConverter.Event> = ...');
270
- lines.push(" * emit('conversion.started', {");
271
- lines.push(" * name: 'conversion.started',");
272
- lines.push(' * attributes: { ... }');
273
- lines.push(' * });');
274
- lines.push(' * ```');
275
- lines.push(' */');
276
- }
277
- lines.push('export type NodeEmitter<');
278
- lines.push(' TEventName extends string,');
279
- lines.push(' TEvent extends { name: TEventName; attributes: Record<string, any> }');
280
- lines.push('> = (event: TEvent) => void;');
281
- lines.push('');
282
- if (opts.includeDocComments) {
283
- lines.push('/**');
284
- lines.push(' * Type-safe event emitter by event name');
285
- lines.push(' *');
286
- lines.push(' * @example');
287
- lines.push(' * ```typescript');
288
- lines.push(' * const emit: NodeEmitterByName<GraphConverter.Event> = ...');
289
- lines.push(" * emit('conversion.started', {");
290
- lines.push(" * 'config.nodeTypes': 2,");
291
- lines.push(" * 'config.edgeTypes': 1");
292
- lines.push(' * });');
293
- lines.push(' * ```');
294
- lines.push(' */');
295
- }
296
- lines.push('export type NodeEmitterByName<');
297
- lines.push(' TEvent extends { name: string; attributes: Record<string, any> }');
298
- lines.push('> = <TName extends TEvent[\'name\']>(');
299
- lines.push(' eventName: TName,');
300
- lines.push(' attributes: Extract<TEvent, { name: TName }>[\'attributes\']');
301
- lines.push(') => void;');
302
- return lines;
303
- }
304
- nodeIdToTypeName(nodeId) {
305
- // Convert kebab-case or snake_case to PascalCase
306
- return nodeId
307
- .split(/[-_]/)
308
- .map(part => part.charAt(0).toUpperCase() + part.slice(1))
309
- .join('');
310
- }
311
- eventNameToTypeName(eventName) {
312
- // Convert "conversion.started" to "ConversionStarted"
313
- return eventName
314
- .split('.')
315
- .map(part => part.charAt(0).toUpperCase() + part.slice(1))
316
- .join('');
317
- }
318
- fieldTypeToTsType(fieldSchema) {
319
- switch (fieldSchema.type) {
320
- case 'string':
321
- return 'string';
322
- case 'number':
323
- return 'number';
324
- case 'boolean':
325
- return 'boolean';
326
- case 'array':
327
- return 'any[]';
328
- case 'object':
329
- return 'Record<string, any>';
330
- default:
331
- return 'any';
332
- }
333
- }
334
- generateFilename(canvas) {
335
- const name = canvas.pv?.name || 'canvas';
336
- // Convert to kebab-case
337
- const kebab = name
338
- .toLowerCase()
339
- .replace(/\s+/g, '-')
340
- .replace(/[^a-z0-9-]/g, '');
341
- return `${kebab}.types.ts`;
342
- }
343
- /**
344
- * Resolve an event schema from library by event name
345
- */
346
- resolveLibraryEvent(eventName, library) {
347
- if (!library?.eventSchemas) {
348
- return undefined;
349
- }
350
- const librarySchema = library.eventSchemas[eventName];
351
- if (!librarySchema) {
352
- return undefined;
353
- }
354
- // Convert library schema (without name) to full PVEventSchema
355
- return {
356
- name: eventName,
357
- description: librarySchema.description,
358
- attributes: librarySchema.attributes,
359
- };
360
- }
361
- }
362
- exports.TypeScriptGenerator = TypeScriptGenerator;
363
- /**
364
- * Generate types from canvas
365
- *
366
- * @example
367
- * ```typescript
368
- * import fs from 'fs';
369
- * import { generateTypes } from '@principal-ai/subsystems-core';
370
- *
371
- * const canvas = JSON.parse(fs.readFileSync('my-flow.canvas', 'utf-8'));
372
- * const result = generateTypes(canvas, { language: 'typescript' });
373
- *
374
- * fs.writeFileSync(result.filename, result.code);
375
- * ```
376
- */
377
- function generateTypes(canvas, options = { language: 'typescript' }, library) {
378
- const generator = getGenerator(options.language);
379
- return generator.generate(canvas, options, library);
380
- }
381
- exports.generateTypes = generateTypes;
382
- /**
383
- * Get code generator for a language
384
- */
385
- function getGenerator(language) {
386
- switch (language) {
387
- case 'typescript':
388
- return new TypeScriptGenerator();
389
- case 'python':
390
- // TODO: Implement Python generator
391
- throw new Error('Python generator not yet implemented. See TypeScriptGenerator as reference.');
392
- case 'go':
393
- // TODO: Implement Go generator
394
- throw new Error('Go generator not yet implemented. See TypeScriptGenerator as reference.');
395
- case 'rust':
396
- // TODO: Implement Rust generator
397
- throw new Error('Rust generator not yet implemented. See TypeScriptGenerator as reference.');
398
- default:
399
- throw new Error(`Unsupported language: ${language}`);
400
- }
401
- }
402
- /**
403
- * Registry of available generators
404
- *
405
- * This allows external packages to register custom generators:
406
- *
407
- * @example
408
- * ```typescript
409
- * import { generatorRegistry } from '@principal-ai/subsystems-core';
410
- *
411
- * class PythonGenerator implements CodeGenerator {
412
- * language = 'python';
413
- * generate(canvas, options) { ... }
414
- * }
415
- *
416
- * generatorRegistry.register(new PythonGenerator());
417
- * ```
418
- */
419
- exports.generatorRegistry = {
420
- generators: new Map([
421
- ['typescript', new TypeScriptGenerator()],
422
- ]),
423
- register(generator) {
424
- this.generators.set(generator.language, generator);
425
- },
426
- get(language) {
427
- return this.generators.get(language);
428
- },
429
- list() {
430
- return Array.from(this.generators.keys());
431
- },
432
- };
433
- //# sourceMappingURL=type-generator.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"type-generator.js","sourceRoot":"","sources":["../../src/codegen/type-generator.ts"],"names":[],"mappings":"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"}
@@ -1,103 +0,0 @@
1
- /**
2
- * Example: Using Generated Types
3
- *
4
- * This demonstrates how to use generated types for type-safe event emission.
5
- * Types are generated from canvas schemas using the type generator.
6
- *
7
- * Similar to:
8
- * - GraphQL Code Generator usage
9
- * - OpenAPI generated client usage
10
- * - Protobuf generated message usage
11
- *
12
- * NOTE: In real code, you would import from the generated types file:
13
- * ```typescript
14
- * import type {
15
- * GraphConverter,
16
- * Validation,
17
- * NodeEmitterByName,
18
- * } from '@generated/graph-converter-execution.types';
19
- * ```
20
- *
21
- * For this example file, we define the types inline to avoid import errors.
22
- */
23
- declare namespace GraphConverter {
24
- interface ConversionStarted {
25
- name: 'conversion.started';
26
- attributes: {
27
- 'config.nodeTypes': number;
28
- 'config.edgeTypes': number;
29
- };
30
- }
31
- interface ConversionComplete {
32
- name: 'conversion.complete';
33
- attributes: {
34
- 'result.nodes.count': number;
35
- 'result.edges.count': number;
36
- 'duration.ms'?: number;
37
- };
38
- }
39
- interface ConversionError {
40
- name: 'conversion.error';
41
- attributes: {
42
- 'error.message': string;
43
- 'error.phase'?: string;
44
- };
45
- }
46
- interface ConversionProcessingNodes {
47
- name: 'conversion.processingNodes';
48
- attributes: {
49
- 'nodes.count': number;
50
- };
51
- }
52
- interface ConversionProcessingEdges {
53
- name: 'conversion.processingEdges';
54
- attributes: {
55
- 'edges.count': number;
56
- };
57
- }
58
- type Event = ConversionStarted | ConversionComplete | ConversionError | ConversionProcessingNodes | ConversionProcessingEdges;
59
- type EventName = 'conversion.started' | 'conversion.processingNodes' | 'conversion.processingEdges' | 'conversion.complete' | 'conversion.error';
60
- }
61
- type NodeEmitterByName<TEvent extends {
62
- name: string;
63
- attributes: Record<string, any>;
64
- }> = <TName extends TEvent['name']>(eventName: TName, attributes: Extract<TEvent, {
65
- name: TName;
66
- }>['attributes']) => void;
67
- /**
68
- * Example 1: Type-safe event emitter with full event objects
69
- */
70
- declare function exampleFullEventEmitter(): void;
71
- /**
72
- * Example 2: Type-safe event emitter by name (more ergonomic)
73
- */
74
- declare function exampleEventEmitterByName(): void;
75
- /**
76
- * Example 3: Production service with type-safe telemetry
77
- */
78
- declare class GraphConverterService {
79
- private emit;
80
- constructor(emitter: NodeEmitterByName<GraphConverter.Event>);
81
- convert(config: {
82
- nodeTypes: string[];
83
- edgeTypes: string[];
84
- }): void;
85
- }
86
- /**
87
- * Example 4: Multiple node types
88
- */
89
- declare function exampleMultipleNodes(): void;
90
- /**
91
- * Example 5: Generic event handler with type narrowing
92
- */
93
- declare function exampleEventHandler(event: GraphConverter.Event): void;
94
- /**
95
- * Example 6: Type-safe event name checking
96
- */
97
- declare function exampleEventNameChecking(eventName: string): void;
98
- /**
99
- * Example 7: Integration with event validator
100
- */
101
- declare function exampleWithValidator(): Promise<void>;
102
- export { exampleFullEventEmitter, exampleEventEmitterByName, GraphConverterService, exampleMultipleNodes, exampleEventHandler, exampleEventNameChecking, exampleWithValidator, };
103
- //# sourceMappingURL=usage-example.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"usage-example.d.ts","sourceRoot":"","sources":["../../src/codegen/usage-example.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,kBAAU,cAAc,CAAC;IACvB,UAAiB,iBAAiB;QAChC,IAAI,EAAE,oBAAoB,CAAC;QAC3B,UAAU,EAAE;YACV,kBAAkB,EAAE,MAAM,CAAC;YAC3B,kBAAkB,EAAE,MAAM,CAAC;SAC5B,CAAC;KACH;IAED,UAAiB,kBAAkB;QACjC,IAAI,EAAE,qBAAqB,CAAC;QAC5B,UAAU,EAAE;YACV,oBAAoB,EAAE,MAAM,CAAC;YAC7B,oBAAoB,EAAE,MAAM,CAAC;YAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;SACxB,CAAC;KACH;IAED,UAAiB,eAAe;QAC9B,IAAI,EAAE,kBAAkB,CAAC;QACzB,UAAU,EAAE;YACV,eAAe,EAAE,MAAM,CAAC;YACxB,aAAa,CAAC,EAAE,MAAM,CAAC;SACxB,CAAC;KACH;IAED,UAAiB,yBAAyB;QACxC,IAAI,EAAE,4BAA4B,CAAC;QACnC,UAAU,EAAE;YACV,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC;KACH;IAED,UAAiB,yBAAyB;QACxC,IAAI,EAAE,4BAA4B,CAAC;QACnC,UAAU,EAAE;YACV,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC;KACH;IAED,KAAY,KAAK,GACb,iBAAiB,GACjB,kBAAkB,GAClB,eAAe,GACf,yBAAyB,GACzB,yBAAyB,CAAC;IAE9B,KAAY,SAAS,GACjB,oBAAoB,GACpB,4BAA4B,GAC5B,4BAA4B,GAC5B,qBAAqB,GACrB,kBAAkB,CAAC;CACxB;AAsBD,KAAK,iBAAiB,CAAC,MAAM,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,IAAI,CACzF,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EAE5B,SAAS,EAAE,KAAK,EAChB,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC,YAAY,CAAC,KACvD,IAAI,CAAC;AAEV;;GAEG;AACH,iBAAS,uBAAuB,SAiD/B;AAED;;GAEG;AACH,iBAAS,yBAAyB,SAiCjC;AAED;;GAEG;AACH,cAAM,qBAAqB;IACzB,OAAO,CAAC,IAAI,CAA0C;gBAE1C,OAAO,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,CAAC;IAI5D,OAAO,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE;CAuB7D;AAED;;GAEG;AACH,iBAAS,oBAAoB,SAwB5B;AAED;;GAEG;AACH,iBAAS,mBAAmB,CAAC,KAAK,EAAE,cAAc,CAAC,KAAK,QAsBvD;AAED;;GAEG;AACH,iBAAS,wBAAwB,CAAC,SAAS,EAAE,MAAM,QAMlD;AAaD;;GAEG;AACH,iBAAe,oBAAoB,kBA+BlC;AAED,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,GACrB,CAAC"}