@spine-event-engine/server 2.0.0-snapshot.11

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 (378) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +209 -0
  3. package/REFERENCE.md +760 -0
  4. package/dist/browser/browser-server.d.ts +95 -0
  5. package/dist/browser/browser-server.d.ts.map +1 -0
  6. package/dist/browser/browser-server.js +719 -0
  7. package/dist/browser/browser-server.js.map +1 -0
  8. package/dist/browser/durable-subscription-bindings.d.ts +122 -0
  9. package/dist/browser/durable-subscription-bindings.d.ts.map +1 -0
  10. package/dist/browser/durable-subscription-bindings.js +524 -0
  11. package/dist/browser/durable-subscription-bindings.js.map +1 -0
  12. package/dist/browser/index.d.ts +12 -0
  13. package/dist/browser/index.d.ts.map +1 -0
  14. package/dist/browser/index.js +24 -0
  15. package/dist/browser/index.js.map +1 -0
  16. package/dist/browser/options.d.ts +183 -0
  17. package/dist/browser/options.d.ts.map +1 -0
  18. package/dist/browser/options.js +15 -0
  19. package/dist/browser/options.js.map +1 -0
  20. package/dist/bus/command-bus.d.ts +63 -0
  21. package/dist/bus/command-bus.d.ts.map +1 -0
  22. package/dist/bus/command-bus.js +236 -0
  23. package/dist/bus/command-bus.js.map +1 -0
  24. package/dist/bus/command-dispatcher-registry.d.ts +33 -0
  25. package/dist/bus/command-dispatcher-registry.d.ts.map +1 -0
  26. package/dist/bus/command-dispatcher-registry.js +75 -0
  27. package/dist/bus/command-dispatcher-registry.js.map +1 -0
  28. package/dist/bus/command-dispatcher.d.ts +25 -0
  29. package/dist/bus/command-dispatcher.d.ts.map +1 -0
  30. package/dist/bus/command-dispatcher.js +15 -0
  31. package/dist/bus/command-dispatcher.js.map +1 -0
  32. package/dist/bus/command-errors.d.ts +23 -0
  33. package/dist/bus/command-errors.d.ts.map +1 -0
  34. package/dist/bus/command-errors.js +52 -0
  35. package/dist/bus/command-errors.js.map +1 -0
  36. package/dist/bus/event-bus.d.ts +113 -0
  37. package/dist/bus/event-bus.d.ts.map +1 -0
  38. package/dist/bus/event-bus.js +518 -0
  39. package/dist/bus/event-bus.js.map +1 -0
  40. package/dist/bus/event-dispatcher-origin-schemas.d.ts +17 -0
  41. package/dist/bus/event-dispatcher-origin-schemas.d.ts.map +1 -0
  42. package/dist/bus/event-dispatcher-origin-schemas.js +32 -0
  43. package/dist/bus/event-dispatcher-origin-schemas.js.map +1 -0
  44. package/dist/bus/event-dispatcher-registry.d.ts +48 -0
  45. package/dist/bus/event-dispatcher-registry.d.ts.map +1 -0
  46. package/dist/bus/event-dispatcher-registry.js +176 -0
  47. package/dist/bus/event-dispatcher-registry.js.map +1 -0
  48. package/dist/bus/event-dispatcher.d.ts +48 -0
  49. package/dist/bus/event-dispatcher.d.ts.map +1 -0
  50. package/dist/bus/event-dispatcher.js +15 -0
  51. package/dist/bus/event-dispatcher.js.map +1 -0
  52. package/dist/context/bounded-context.d.ts +592 -0
  53. package/dist/context/bounded-context.d.ts.map +1 -0
  54. package/dist/context/bounded-context.js +1897 -0
  55. package/dist/context/bounded-context.js.map +1 -0
  56. package/dist/context/entity-inbox.d.ts +63 -0
  57. package/dist/context/entity-inbox.d.ts.map +1 -0
  58. package/dist/context/entity-inbox.js +387 -0
  59. package/dist/context/entity-inbox.js.map +1 -0
  60. package/dist/context/local-inbox-handoff.d.ts +248 -0
  61. package/dist/context/local-inbox-handoff.d.ts.map +1 -0
  62. package/dist/context/local-inbox-handoff.js +340 -0
  63. package/dist/context/local-inbox-handoff.js.map +1 -0
  64. package/dist/context/projection-handoff.d.ts +46 -0
  65. package/dist/context/projection-handoff.d.ts.map +1 -0
  66. package/dist/context/projection-handoff.js +177 -0
  67. package/dist/context/projection-handoff.js.map +1 -0
  68. package/dist/context/tenant-index.d.ts +41 -0
  69. package/dist/context/tenant-index.d.ts.map +1 -0
  70. package/dist/context/tenant-index.js +93 -0
  71. package/dist/context/tenant-index.js.map +1 -0
  72. package/dist/delivery/conditional-pickup.d.ts +25 -0
  73. package/dist/delivery/conditional-pickup.d.ts.map +1 -0
  74. package/dist/delivery/conditional-pickup.js +26 -0
  75. package/dist/delivery/conditional-pickup.js.map +1 -0
  76. package/dist/delivery/delivery-builder.d.ts +216 -0
  77. package/dist/delivery/delivery-builder.d.ts.map +1 -0
  78. package/dist/delivery/delivery-builder.js +323 -0
  79. package/dist/delivery/delivery-builder.js.map +1 -0
  80. package/dist/delivery/delivery-lease.d.ts +15 -0
  81. package/dist/delivery/delivery-lease.d.ts.map +1 -0
  82. package/dist/delivery/delivery-lease.js +44 -0
  83. package/dist/delivery/delivery-lease.js.map +1 -0
  84. package/dist/delivery/delivery-loop.d.ts +113 -0
  85. package/dist/delivery/delivery-loop.d.ts.map +1 -0
  86. package/dist/delivery/delivery-loop.js +119 -0
  87. package/dist/delivery/delivery-loop.js.map +1 -0
  88. package/dist/delivery/delivery-monitor.d.ts +165 -0
  89. package/dist/delivery/delivery-monitor.d.ts.map +1 -0
  90. package/dist/delivery/delivery-monitor.js +168 -0
  91. package/dist/delivery/delivery-monitor.js.map +1 -0
  92. package/dist/delivery/delivery-ports.d.ts +151 -0
  93. package/dist/delivery/delivery-ports.d.ts.map +1 -0
  94. package/dist/delivery/delivery-ports.js +15 -0
  95. package/dist/delivery/delivery-ports.js.map +1 -0
  96. package/dist/delivery/delivery-run-control.d.ts +50 -0
  97. package/dist/delivery/delivery-run-control.d.ts.map +1 -0
  98. package/dist/delivery/delivery-run-control.js +66 -0
  99. package/dist/delivery/delivery-run-control.js.map +1 -0
  100. package/dist/delivery/delivery-run-coordinator.d.ts +218 -0
  101. package/dist/delivery/delivery-run-coordinator.d.ts.map +1 -0
  102. package/dist/delivery/delivery-run-coordinator.js +609 -0
  103. package/dist/delivery/delivery-run-coordinator.js.map +1 -0
  104. package/dist/delivery/delivery-storage-error.d.ts +13 -0
  105. package/dist/delivery/delivery-storage-error.d.ts.map +1 -0
  106. package/dist/delivery/delivery-storage-error.js +30 -0
  107. package/dist/delivery/delivery-storage-error.js.map +1 -0
  108. package/dist/delivery/delivery-supervisor.d.ts +175 -0
  109. package/dist/delivery/delivery-supervisor.d.ts.map +1 -0
  110. package/dist/delivery/delivery-supervisor.js +469 -0
  111. package/dist/delivery/delivery-supervisor.js.map +1 -0
  112. package/dist/delivery/delivery-worker.d.ts +180 -0
  113. package/dist/delivery/delivery-worker.d.ts.map +1 -0
  114. package/dist/delivery/delivery-worker.js +232 -0
  115. package/dist/delivery/delivery-worker.js.map +1 -0
  116. package/dist/delivery/delivery.d.ts +236 -0
  117. package/dist/delivery/delivery.d.ts.map +1 -0
  118. package/dist/delivery/delivery.js +539 -0
  119. package/dist/delivery/delivery.js.map +1 -0
  120. package/dist/delivery/inbox-records.d.ts +19 -0
  121. package/dist/delivery/inbox-records.d.ts.map +1 -0
  122. package/dist/delivery/inbox-records.js +291 -0
  123. package/dist/delivery/inbox-records.js.map +1 -0
  124. package/dist/delivery/inbox-storage.d.ts +83 -0
  125. package/dist/delivery/inbox-storage.d.ts.map +1 -0
  126. package/dist/delivery/inbox-storage.js +336 -0
  127. package/dist/delivery/inbox-storage.js.map +1 -0
  128. package/dist/delivery/inbox.d.ts +272 -0
  129. package/dist/delivery/inbox.d.ts.map +1 -0
  130. package/dist/delivery/inbox.js +183 -0
  131. package/dist/delivery/inbox.js.map +1 -0
  132. package/dist/delivery/parked-delivery-obligations.d.ts +182 -0
  133. package/dist/delivery/parked-delivery-obligations.d.ts.map +1 -0
  134. package/dist/delivery/parked-delivery-obligations.js +390 -0
  135. package/dist/delivery/parked-delivery-obligations.js.map +1 -0
  136. package/dist/delivery/shard-index.d.ts +41 -0
  137. package/dist/delivery/shard-index.d.ts.map +1 -0
  138. package/dist/delivery/shard-index.js +67 -0
  139. package/dist/delivery/shard-index.js.map +1 -0
  140. package/dist/delivery/sharded-work-registry.d.ts +114 -0
  141. package/dist/delivery/sharded-work-registry.d.ts.map +1 -0
  142. package/dist/delivery/sharded-work-registry.js +361 -0
  143. package/dist/delivery/sharded-work-registry.js.map +1 -0
  144. package/dist/entity/entity-metadata.d.ts +173 -0
  145. package/dist/entity/entity-metadata.d.ts.map +1 -0
  146. package/dist/entity/entity-metadata.js +187 -0
  147. package/dist/entity/entity-metadata.js.map +1 -0
  148. package/dist/entity/entity-storage-descriptor.d.ts +64 -0
  149. package/dist/entity/entity-storage-descriptor.d.ts.map +1 -0
  150. package/dist/entity/entity-storage-descriptor.js +227 -0
  151. package/dist/entity/entity-storage-descriptor.js.map +1 -0
  152. package/dist/entity/entity-transaction.d.ts +372 -0
  153. package/dist/entity/entity-transaction.d.ts.map +1 -0
  154. package/dist/entity/entity-transaction.js +413 -0
  155. package/dist/entity/entity-transaction.js.map +1 -0
  156. package/dist/entity/entity-transition-validation.d.ts +47 -0
  157. package/dist/entity/entity-transition-validation.d.ts.map +1 -0
  158. package/dist/entity/entity-transition-validation.js +327 -0
  159. package/dist/entity/entity-transition-validation.js.map +1 -0
  160. package/dist/entity/entity.d.ts +605 -0
  161. package/dist/entity/entity.d.ts.map +1 -0
  162. package/dist/entity/entity.js +981 -0
  163. package/dist/entity/entity.js.map +1 -0
  164. package/dist/entity/implicit-required-id.d.ts +15 -0
  165. package/dist/entity/implicit-required-id.d.ts.map +1 -0
  166. package/dist/entity/implicit-required-id.js +123 -0
  167. package/dist/entity/implicit-required-id.js.map +1 -0
  168. package/dist/entity/spec-scanner.d.ts +14 -0
  169. package/dist/entity/spec-scanner.d.ts.map +1 -0
  170. package/dist/entity/spec-scanner.js +37 -0
  171. package/dist/entity/spec-scanner.js.map +1 -0
  172. package/dist/handler/command-registration-readiness.d.ts +99 -0
  173. package/dist/handler/command-registration-readiness.d.ts.map +1 -0
  174. package/dist/handler/command-registration-readiness.js +120 -0
  175. package/dist/handler/command-registration-readiness.js.map +1 -0
  176. package/dist/handler/declared-rejections.d.ts +11 -0
  177. package/dist/handler/declared-rejections.d.ts.map +1 -0
  178. package/dist/handler/declared-rejections.js +34 -0
  179. package/dist/handler/declared-rejections.js.map +1 -0
  180. package/dist/handler/event-handler-filter.d.ts +43 -0
  181. package/dist/handler/event-handler-filter.d.ts.map +1 -0
  182. package/dist/handler/event-handler-filter.js +128 -0
  183. package/dist/handler/event-handler-filter.js.map +1 -0
  184. package/dist/handler/event-registration-readiness.d.ts +196 -0
  185. package/dist/handler/event-registration-readiness.d.ts.map +1 -0
  186. package/dist/handler/event-registration-readiness.js +187 -0
  187. package/dist/handler/event-registration-readiness.js.map +1 -0
  188. package/dist/handler/external.d.ts +10 -0
  189. package/dist/handler/external.d.ts.map +1 -0
  190. package/dist/handler/external.js +15 -0
  191. package/dist/handler/external.js.map +1 -0
  192. package/dist/handler/generated-handler-registry.d.ts +185 -0
  193. package/dist/handler/generated-handler-registry.d.ts.map +1 -0
  194. package/dist/handler/generated-handler-registry.js +439 -0
  195. package/dist/handler/generated-handler-registry.js.map +1 -0
  196. package/dist/handler/generated-registry-discovery.d.ts +94 -0
  197. package/dist/handler/generated-registry-discovery.d.ts.map +1 -0
  198. package/dist/handler/generated-registry-discovery.js +226 -0
  199. package/dist/handler/generated-registry-discovery.js.map +1 -0
  200. package/dist/handler/handler-decorators.d.ts +151 -0
  201. package/dist/handler/handler-decorators.d.ts.map +1 -0
  202. package/dist/handler/handler-decorators.js +275 -0
  203. package/dist/handler/handler-decorators.js.map +1 -0
  204. package/dist/handler/handler-metadata.d.ts +553 -0
  205. package/dist/handler/handler-metadata.d.ts.map +1 -0
  206. package/dist/handler/handler-metadata.js +437 -0
  207. package/dist/handler/handler-metadata.js.map +1 -0
  208. package/dist/handler/registration-readiness-metadata.d.ts +68 -0
  209. package/dist/handler/registration-readiness-metadata.d.ts.map +1 -0
  210. package/dist/handler/registration-readiness-metadata.js +171 -0
  211. package/dist/handler/registration-readiness-metadata.js.map +1 -0
  212. package/dist/handler/rejection-source.d.ts +11 -0
  213. package/dist/handler/rejection-source.d.ts.map +1 -0
  214. package/dist/handler/rejection-source.js +25 -0
  215. package/dist/handler/rejection-source.js.map +1 -0
  216. package/dist/handler/standalone.d.ts +25 -0
  217. package/dist/handler/standalone.d.ts.map +1 -0
  218. package/dist/handler/standalone.js +38 -0
  219. package/dist/handler/standalone.js.map +1 -0
  220. package/dist/index.d.ts +46 -0
  221. package/dist/index.d.ts.map +1 -0
  222. package/dist/index.js +54 -0
  223. package/dist/index.js.map +1 -0
  224. package/dist/integration/external-messages.d.ts +49 -0
  225. package/dist/integration/external-messages.d.ts.map +1 -0
  226. package/dist/integration/external-messages.js +112 -0
  227. package/dist/integration/external-messages.js.map +1 -0
  228. package/dist/integration/integration-broker.d.ts +74 -0
  229. package/dist/integration/integration-broker.d.ts.map +1 -0
  230. package/dist/integration/integration-broker.js +444 -0
  231. package/dist/integration/integration-broker.js.map +1 -0
  232. package/dist/integration/third-party-context.d.ts +56 -0
  233. package/dist/integration/third-party-context.d.ts.map +1 -0
  234. package/dist/integration/third-party-context.js +130 -0
  235. package/dist/integration/third-party-context.js.map +1 -0
  236. package/dist/repository/command-errors.d.ts +25 -0
  237. package/dist/repository/command-errors.d.ts.map +1 -0
  238. package/dist/repository/command-errors.js +43 -0
  239. package/dist/repository/command-errors.js.map +1 -0
  240. package/dist/repository/command-routing.d.ts +72 -0
  241. package/dist/repository/command-routing.d.ts.map +1 -0
  242. package/dist/repository/command-routing.js +98 -0
  243. package/dist/repository/command-routing.js.map +1 -0
  244. package/dist/repository/commit-fence.d.ts +22 -0
  245. package/dist/repository/commit-fence.d.ts.map +1 -0
  246. package/dist/repository/commit-fence.js +37 -0
  247. package/dist/repository/commit-fence.js.map +1 -0
  248. package/dist/repository/event-routing.d.ts +71 -0
  249. package/dist/repository/event-routing.d.ts.map +1 -0
  250. package/dist/repository/event-routing.js +96 -0
  251. package/dist/repository/event-routing.js.map +1 -0
  252. package/dist/repository/primitive-id.d.ts +75 -0
  253. package/dist/repository/primitive-id.d.ts.map +1 -0
  254. package/dist/repository/primitive-id.js +85 -0
  255. package/dist/repository/primitive-id.js.map +1 -0
  256. package/dist/repository/repository.d.ts +667 -0
  257. package/dist/repository/repository.d.ts.map +1 -0
  258. package/dist/repository/repository.js +3510 -0
  259. package/dist/repository/repository.js.map +1 -0
  260. package/dist/repository/routing-declarations.d.ts +75 -0
  261. package/dist/repository/routing-declarations.d.ts.map +1 -0
  262. package/dist/repository/routing-declarations.js +101 -0
  263. package/dist/repository/routing-declarations.js.map +1 -0
  264. package/dist/repository/state-update-routing.d.ts +66 -0
  265. package/dist/repository/state-update-routing.d.ts.map +1 -0
  266. package/dist/repository/state-update-routing.js +91 -0
  267. package/dist/repository/state-update-routing.js.map +1 -0
  268. package/dist/runtime/runtime.d.ts +156 -0
  269. package/dist/runtime/runtime.d.ts.map +1 -0
  270. package/dist/runtime/runtime.js +215 -0
  271. package/dist/runtime/runtime.js.map +1 -0
  272. package/dist/runtime/signal-intake.d.ts +84 -0
  273. package/dist/runtime/signal-intake.d.ts.map +1 -0
  274. package/dist/runtime/signal-intake.js +94 -0
  275. package/dist/runtime/signal-intake.js.map +1 -0
  276. package/dist/runtime/signal-metadata.d.ts +217 -0
  277. package/dist/runtime/signal-metadata.d.ts.map +1 -0
  278. package/dist/runtime/signal-metadata.js +333 -0
  279. package/dist/runtime/signal-metadata.js.map +1 -0
  280. package/dist/runtime/signal-publisher.d.ts +144 -0
  281. package/dist/runtime/signal-publisher.d.ts.map +1 -0
  282. package/dist/runtime/signal-publisher.js +248 -0
  283. package/dist/runtime/signal-publisher.js.map +1 -0
  284. package/dist/runtime/standalone-handler-runtime.d.ts +114 -0
  285. package/dist/runtime/standalone-handler-runtime.d.ts.map +1 -0
  286. package/dist/runtime/standalone-handler-runtime.js +307 -0
  287. package/dist/runtime/standalone-handler-runtime.js.map +1 -0
  288. package/dist/server/environment-attachment.d.ts +356 -0
  289. package/dist/server/environment-attachment.d.ts.map +1 -0
  290. package/dist/server/environment-attachment.js +2062 -0
  291. package/dist/server/environment-attachment.js.map +1 -0
  292. package/dist/server/environment-delivery-records.d.ts +77 -0
  293. package/dist/server/environment-delivery-records.d.ts.map +1 -0
  294. package/dist/server/environment-delivery-records.js +282 -0
  295. package/dist/server/environment-delivery-records.js.map +1 -0
  296. package/dist/server/environment-delivery-worker.d.ts +161 -0
  297. package/dist/server/environment-delivery-worker.d.ts.map +1 -0
  298. package/dist/server/environment-delivery-worker.js +673 -0
  299. package/dist/server/environment-delivery-worker.js.map +1 -0
  300. package/dist/server/environment.d.ts +43 -0
  301. package/dist/server/environment.d.ts.map +1 -0
  302. package/dist/server/environment.js +90 -0
  303. package/dist/server/environment.js.map +1 -0
  304. package/dist/server/managed-child-subscription.d.ts +11 -0
  305. package/dist/server/managed-child-subscription.d.ts.map +1 -0
  306. package/dist/server/managed-child-subscription.js +44 -0
  307. package/dist/server/managed-child-subscription.js.map +1 -0
  308. package/dist/server/managed-server-application.d.ts +327 -0
  309. package/dist/server/managed-server-application.d.ts.map +1 -0
  310. package/dist/server/managed-server-application.js +937 -0
  311. package/dist/server/managed-server-application.js.map +1 -0
  312. package/dist/server/node-coordinator.d.ts +191 -0
  313. package/dist/server/node-coordinator.d.ts.map +1 -0
  314. package/dist/server/node-coordinator.js +552 -0
  315. package/dist/server/node-coordinator.js.map +1 -0
  316. package/dist/server/process-server-coordinator.d.ts +15 -0
  317. package/dist/server/process-server-coordinator.d.ts.map +1 -0
  318. package/dist/server/process-server-coordinator.js +112 -0
  319. package/dist/server/process-server-coordinator.js.map +1 -0
  320. package/dist/server/reserved-spine-rpc-paths.json +8 -0
  321. package/dist/server/retryable-close.d.ts +28 -0
  322. package/dist/server/retryable-close.d.ts.map +1 -0
  323. package/dist/server/retryable-close.js +129 -0
  324. package/dist/server/retryable-close.js.map +1 -0
  325. package/dist/server/server-environment.d.ts +180 -0
  326. package/dist/server/server-environment.d.ts.map +1 -0
  327. package/dist/server/server-environment.js +418 -0
  328. package/dist/server/server-environment.js.map +1 -0
  329. package/dist/server/server-log.d.ts +18 -0
  330. package/dist/server/server-log.d.ts.map +1 -0
  331. package/dist/server/server-log.js +100 -0
  332. package/dist/server/server-log.js.map +1 -0
  333. package/dist/server/server.d.ts +221 -0
  334. package/dist/server/server.d.ts.map +1 -0
  335. package/dist/server/server.js +704 -0
  336. package/dist/server/server.js.map +1 -0
  337. package/dist/services/query-reader.d.ts +19 -0
  338. package/dist/services/query-reader.d.ts.map +1 -0
  339. package/dist/services/query-reader.js +43 -0
  340. package/dist/services/query-reader.js.map +1 -0
  341. package/dist/services/spine-services.d.ts +88 -0
  342. package/dist/services/spine-services.d.ts.map +1 -0
  343. package/dist/services/spine-services.js +1582 -0
  344. package/dist/services/spine-services.js.map +1 -0
  345. package/dist/spi/delivery.d.ts +5 -0
  346. package/dist/spi/delivery.d.ts.map +1 -0
  347. package/dist/spi/delivery.js +18 -0
  348. package/dist/spi/delivery.js.map +1 -0
  349. package/dist/spi/handler-registry.d.ts +8 -0
  350. package/dist/spi/handler-registry.d.ts.map +1 -0
  351. package/dist/spi/handler-registry.js +15 -0
  352. package/dist/spi/handler-registry.js.map +1 -0
  353. package/dist/stand/stand.d.ts +294 -0
  354. package/dist/stand/stand.d.ts.map +1 -0
  355. package/dist/stand/stand.js +681 -0
  356. package/dist/stand/stand.js.map +1 -0
  357. package/dist/stand/subscription-observer.d.ts +53 -0
  358. package/dist/stand/subscription-observer.d.ts.map +1 -0
  359. package/dist/stand/subscription-observer.js +444 -0
  360. package/dist/stand/subscription-observer.js.map +1 -0
  361. package/dist/stand/subscription-records.d.ts +12 -0
  362. package/dist/stand/subscription-records.d.ts.map +1 -0
  363. package/dist/stand/subscription-records.js +99 -0
  364. package/dist/stand/subscription-records.js.map +1 -0
  365. package/dist/stand/subscription-registry.d.ts +285 -0
  366. package/dist/stand/subscription-registry.d.ts.map +1 -0
  367. package/dist/stand/subscription-registry.js +403 -0
  368. package/dist/stand/subscription-registry.js.map +1 -0
  369. package/dist/stand/subscription-runtime.d.ts +102 -0
  370. package/dist/stand/subscription-runtime.d.ts.map +1 -0
  371. package/dist/stand/subscription-runtime.js +380 -0
  372. package/dist/stand/subscription-runtime.js.map +1 -0
  373. package/dist/testing/index.d.ts +36 -0
  374. package/dist/testing/index.d.ts.map +1 -0
  375. package/dist/testing/index.js +54 -0
  376. package/dist/testing/index.js.map +1 -0
  377. package/dist/tsconfig.tsbuildinfo +1 -0
  378. package/package.json +76 -0
@@ -0,0 +1,217 @@
1
+ import { type Any, type Timestamp } from "@bufbuild/protobuf/wkt";
2
+ import { type ActorContext, type Command, type CommandContext, type CommandId, type Event, type EventContext, type EventId, type Origin, type Version } from "@spine-event-engine/proto";
3
+ /**
4
+ * Supplies the current wall-clock time for signal metadata.
5
+ */
6
+ export interface Clock {
7
+ /**
8
+ * Returns the current wall-clock time.
9
+ *
10
+ * @returns Current time as a `Date`.
11
+ */
12
+ now(): Date;
13
+ }
14
+ /**
15
+ * Supplies system wall-clock time.
16
+ */
17
+ export declare class SystemClock implements Clock {
18
+ /**
19
+ * Returns the current system time.
20
+ *
21
+ * @returns Current system time.
22
+ */
23
+ now(): Date;
24
+ }
25
+ /**
26
+ * Supplies a fixed wall-clock time for deterministic work.
27
+ */
28
+ export declare class FixedClock implements Clock {
29
+ #private;
30
+ /**
31
+ * Creates a clock fixed at one time.
32
+ *
33
+ * @param value Finite time to return from `now()`.
34
+ */
35
+ constructor(value: Date);
36
+ /**
37
+ * Returns a fresh date at the configured time.
38
+ *
39
+ * @returns Fixed time.
40
+ */
41
+ now(): Date;
42
+ }
43
+ /**
44
+ * Configures the clock used to create signal metadata.
45
+ */
46
+ export interface SignalMetadataOptions {
47
+ /**
48
+ * Supplies timestamps; defaults to {@link SystemClock}.
49
+ */
50
+ readonly clock?: Clock;
51
+ }
52
+ /**
53
+ * Supplies optional actor and tenant data for a signal context.
54
+ */
55
+ export interface ActorContextInput {
56
+ /**
57
+ * Identifies the acting user.
58
+ */
59
+ readonly actor?: ActorContext["actor"];
60
+ /**
61
+ * Identifies the tenant that contains the signal.
62
+ */
63
+ readonly tenantId?: ActorContext["tenantId"];
64
+ }
65
+ /**
66
+ * Supplies actor and origin data for a command context.
67
+ */
68
+ export interface CommandContextInput extends ActorContextInput {
69
+ /**
70
+ * Provides a prebuilt actor context in preference to separate actor fields.
71
+ */
72
+ readonly actorContext?: ActorContext;
73
+ /**
74
+ * Provides the signal origin.
75
+ */
76
+ readonly origin?: Origin;
77
+ }
78
+ /**
79
+ * Supplies producer, version, and origin data for an event context.
80
+ */
81
+ export interface EventContextInput {
82
+ /**
83
+ * Identifies the event producer with a supported scalar identifier.
84
+ */
85
+ readonly producerId?: string | number | bigint | boolean;
86
+ /**
87
+ * Declares the signed 32-bit event version.
88
+ */
89
+ readonly version?: number;
90
+ /**
91
+ * Provides the origin signal.
92
+ */
93
+ readonly origin?: Origin;
94
+ }
95
+ /**
96
+ * Creates immutable metadata for commands and events.
97
+ */
98
+ export declare class SignalMetadata {
99
+ #private;
100
+ /**
101
+ * Creates a metadata factory.
102
+ *
103
+ * @param options Optional clock.
104
+ */
105
+ constructor(options?: SignalMetadataOptions);
106
+ /**
107
+ * Creates a command identifier.
108
+ *
109
+ * @returns Fresh command identifier.
110
+ */
111
+ commandId(): CommandId;
112
+ /**
113
+ * Creates an event identifier.
114
+ *
115
+ * @returns Fresh event identifier.
116
+ */
117
+ eventId(): EventId;
118
+ /**
119
+ * Creates a Protobuf timestamp from a finite date.
120
+ *
121
+ * @param value Date to convert; defaults to the configured clock.
122
+ * @returns Protobuf timestamp.
123
+ */
124
+ timestamp(value?: Date): Timestamp;
125
+ /**
126
+ * Creates an actor context from actor and tenant input.
127
+ *
128
+ * @param input Optional actor and tenant values.
129
+ * @returns Cloned actor context.
130
+ */
131
+ actorContext(input?: ActorContextInput): ActorContext;
132
+ /**
133
+ * Creates a command context from actor and origin input.
134
+ *
135
+ * @param input Optional actor context and origin values.
136
+ * @returns Cloned command context.
137
+ */
138
+ commandContext(input?: CommandContextInput): CommandContext;
139
+ /**
140
+ * Creates an event context with a timestamp and optional causal data.
141
+ *
142
+ * @param input Optional producer, version, and origin values.
143
+ * @returns Event context.
144
+ */
145
+ eventContext(input?: EventContextInput): EventContext;
146
+ /**
147
+ * Creates an origin from a command.
148
+ *
149
+ * @param command Source command.
150
+ * @returns Origin that preserves actor and grand-origin context.
151
+ */
152
+ originFromCommand(command: Command): Origin;
153
+ /**
154
+ * Creates an origin from an event.
155
+ *
156
+ * @param event Source event.
157
+ * @returns Origin that preserves causal context.
158
+ */
159
+ originFromEvent(event: Event): Origin;
160
+ /**
161
+ * Packs a supported finite scalar producer identifier.
162
+ *
163
+ * @param value Candidate producer identifier.
164
+ * @returns Packed value, or `undefined` when it is unsupported.
165
+ */
166
+ producerId(value: string | number | bigint | boolean | undefined): Any | undefined;
167
+ /**
168
+ * Creates a signed 32-bit event version.
169
+ *
170
+ * @param number Finite integer version.
171
+ * @returns Protobuf version.
172
+ */
173
+ version(number: number): Version;
174
+ /**
175
+ * Creates command metadata from an event.
176
+ *
177
+ * @param event Source event.
178
+ * @returns Fresh command identifier and derived context.
179
+ */
180
+ commandFromEvent(event: Event): {
181
+ readonly id: CommandId;
182
+ readonly context: CommandContext;
183
+ };
184
+ /**
185
+ * Creates command metadata from a command substitution.
186
+ *
187
+ * @param command Source command.
188
+ * @returns Fresh command identifier and derived context.
189
+ */
190
+ commandFromCommand(command: Command): {
191
+ readonly id: CommandId;
192
+ readonly context: CommandContext;
193
+ };
194
+ /**
195
+ * Creates event metadata from a command.
196
+ *
197
+ * @param command Source command.
198
+ * @param input Additional event context input.
199
+ * @returns Fresh event identifier and derived context.
200
+ */
201
+ eventFromCommand(command: Command, input: EventContextInput): {
202
+ readonly id: EventId;
203
+ readonly context: EventContext;
204
+ };
205
+ /**
206
+ * Creates event metadata from an event.
207
+ *
208
+ * @param event Source event.
209
+ * @param input Additional event context input.
210
+ * @returns Fresh event identifier and derived context.
211
+ */
212
+ eventFromEvent(event: Event, input: EventContextInput): {
213
+ readonly id: EventId;
214
+ readonly context: EventContext;
215
+ };
216
+ }
217
+ //# sourceMappingURL=signal-metadata.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"signal-metadata.d.ts","sourceRoot":"","sources":["../../src/runtime/signal-metadata.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,333 @@
1
+ /*
2
+ * Copyright 2026, CodeMatters. All rights reserved.
3
+ *
4
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
5
+ * in compliance with the License. You may obtain a copy of the License at
6
+ *
7
+ * https://www.apache.org/licenses/LICENSE-2.0
8
+ *
9
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
10
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
11
+ * or implied. See the License for the specific language governing permissions and limitations under
12
+ * the License.
13
+ */
14
+ import { randomUUID } from "node:crypto";
15
+ import { clone, create } from "@bufbuild/protobuf";
16
+ import { BoolValueSchema, DoubleValueSchema, Int64ValueSchema, StringValueSchema, TimestampSchema, } from "@bufbuild/protobuf/wkt";
17
+ import { AnyMessages } from "@spine-event-engine/core";
18
+ import { ActorContextSchema, CommandContextSchema, CommandIdSchema, EventContextSchema, EventIdSchema, MessageIdSchema, OriginSchema, TenantIdSchema, UserIdSchema, VersionSchema, } from "@spine-event-engine/proto";
19
+ /**
20
+ * Supplies system wall-clock time.
21
+ */
22
+ export class SystemClock {
23
+ // prettier-ignore
24
+ /**
25
+ * Returns the current system time.
26
+ *
27
+ * @returns Current system time.
28
+ */
29
+ now() {
30
+ return new Date();
31
+ }
32
+ }
33
+ /**
34
+ * Supplies a fixed wall-clock time for deterministic work.
35
+ */
36
+ export class FixedClock {
37
+ #value;
38
+ /**
39
+ * Creates a clock fixed at one time.
40
+ *
41
+ * @param value Finite time to return from `now()`.
42
+ */
43
+ constructor(value) {
44
+ this.#value = SignalValues.time(value).getTime();
45
+ }
46
+ /**
47
+ * Returns a fresh date at the configured time.
48
+ *
49
+ * @returns Fixed time.
50
+ */
51
+ now() {
52
+ return new Date(this.#value);
53
+ }
54
+ }
55
+ /**
56
+ * Creates immutable metadata for commands and events.
57
+ */
58
+ export class SignalMetadata {
59
+ #clock;
60
+ /**
61
+ * Creates a metadata factory.
62
+ *
63
+ * @param options Optional clock.
64
+ */
65
+ constructor(options = {}) {
66
+ this.#clock = options.clock ?? new SystemClock();
67
+ }
68
+ /**
69
+ * Creates a command identifier.
70
+ *
71
+ * @returns Fresh command identifier.
72
+ */
73
+ commandId() {
74
+ return create(CommandIdSchema, { uuid: randomUUID() });
75
+ }
76
+ /**
77
+ * Creates an event identifier.
78
+ *
79
+ * @returns Fresh event identifier.
80
+ */
81
+ eventId() {
82
+ return create(EventIdSchema, { value: randomUUID() });
83
+ }
84
+ /**
85
+ * Creates a Protobuf timestamp from a finite date.
86
+ *
87
+ * @param value Date to convert; defaults to the configured clock.
88
+ * @returns Protobuf timestamp.
89
+ */
90
+ timestamp(value = this.#clock.now()) {
91
+ const date = SignalValues.time(value);
92
+ const milliseconds = date.getTime();
93
+ const seconds = Math.floor(milliseconds / 1_000);
94
+ const nanos = (milliseconds - seconds * 1_000) * 1_000_000;
95
+ return create(TimestampSchema, {
96
+ seconds: BigInt(seconds),
97
+ nanos,
98
+ });
99
+ }
100
+ /**
101
+ * Creates an actor context from actor and tenant input.
102
+ *
103
+ * @param input Optional actor and tenant values.
104
+ * @returns Cloned actor context.
105
+ */
106
+ actorContext(input = {}) {
107
+ return create(ActorContextSchema, {
108
+ ...(input.actor === undefined ? {} : { actor: clone(UserIdSchema, input.actor) }),
109
+ ...(input.tenantId === undefined ? {} : { tenantId: clone(TenantIdSchema, input.tenantId) }),
110
+ });
111
+ }
112
+ /**
113
+ * Creates a command context from actor and origin input.
114
+ *
115
+ * @param input Optional actor context and origin values.
116
+ * @returns Cloned command context.
117
+ */
118
+ commandContext(input = {}) {
119
+ const actorContext = input.actorContext ?? this.#actorContext(input);
120
+ return create(CommandContextSchema, {
121
+ ...(actorContext === undefined
122
+ ? {}
123
+ : { actorContext: clone(ActorContextSchema, actorContext) }),
124
+ ...(input.origin === undefined ? {} : { origin: clone(OriginSchema, input.origin) }),
125
+ });
126
+ }
127
+ /**
128
+ * Creates an event context with a timestamp and optional causal data.
129
+ *
130
+ * @param input Optional producer, version, and origin values.
131
+ * @returns Event context.
132
+ */
133
+ eventContext(input = {}) {
134
+ const producerId = this.producerId(input.producerId);
135
+ return create(EventContextSchema, {
136
+ timestamp: this.timestamp(),
137
+ ...(producerId === undefined ? {} : { producerId }),
138
+ ...(input.version === undefined ? {} : { version: this.version(input.version) }),
139
+ ...(input.origin === undefined
140
+ ? {}
141
+ : {
142
+ origin: {
143
+ case: "pastMessage",
144
+ value: clone(OriginSchema, input.origin),
145
+ },
146
+ }),
147
+ });
148
+ }
149
+ /**
150
+ * Creates an origin from a command.
151
+ *
152
+ * @param command Source command.
153
+ * @returns Origin that preserves actor and grand-origin context.
154
+ */
155
+ originFromCommand(command) {
156
+ return create(OriginSchema, {
157
+ message: this.#messageId(AnyMessages.pack(CommandIdSchema, this.#commandId(command)), command.message?.typeUrl),
158
+ ...(command.context?.actorContext === undefined
159
+ ? {}
160
+ : { actorContext: clone(ActorContextSchema, command.context.actorContext) }),
161
+ ...(command.context?.origin === undefined
162
+ ? {}
163
+ : { grandOrigin: clone(OriginSchema, command.context.origin) }),
164
+ });
165
+ }
166
+ /**
167
+ * Creates an origin from an event.
168
+ *
169
+ * @param event Source event.
170
+ * @returns Origin that preserves causal context.
171
+ */
172
+ originFromEvent(event) {
173
+ const actorContext = this.#eventActor(event);
174
+ const grandOrigin = this.#grandOrigin(event);
175
+ return create(OriginSchema, {
176
+ message: this.#messageId(AnyMessages.pack(EventIdSchema, this.#eventId(event)), event.message?.typeUrl),
177
+ ...(actorContext === undefined ? {} : { actorContext }),
178
+ ...(grandOrigin === undefined ? {} : { grandOrigin }),
179
+ });
180
+ }
181
+ /**
182
+ * Packs a supported finite scalar producer identifier.
183
+ *
184
+ * @param value Candidate producer identifier.
185
+ * @returns Packed value, or `undefined` when it is unsupported.
186
+ */
187
+ producerId(value) {
188
+ switch (typeof value) {
189
+ case "string":
190
+ return AnyMessages.pack(StringValueSchema, create(StringValueSchema, { value }));
191
+ case "boolean":
192
+ return AnyMessages.pack(BoolValueSchema, create(BoolValueSchema, { value }));
193
+ case "number":
194
+ return Number.isFinite(value)
195
+ ? AnyMessages.pack(DoubleValueSchema, create(DoubleValueSchema, { value }))
196
+ : undefined;
197
+ case "bigint":
198
+ return AnyMessages.pack(Int64ValueSchema, create(Int64ValueSchema, { value }));
199
+ default:
200
+ return undefined;
201
+ }
202
+ }
203
+ /**
204
+ * Creates a signed 32-bit event version.
205
+ *
206
+ * @param number Finite integer version.
207
+ * @returns Protobuf version.
208
+ */
209
+ version(number) {
210
+ if (!Number.isInteger(number) || number < -2_147_483_648 || number > 2_147_483_647) {
211
+ throw new Error("Signal metadata versions require a finite int32 number.");
212
+ }
213
+ return create(VersionSchema, { number });
214
+ }
215
+ /**
216
+ * Creates command metadata from an event.
217
+ *
218
+ * @param event Source event.
219
+ * @returns Fresh command identifier and derived context.
220
+ */
221
+ commandFromEvent(event) {
222
+ const actorContext = this.#eventActor(event);
223
+ return {
224
+ id: this.commandId(),
225
+ context: this.commandContext({
226
+ ...(actorContext === undefined ? {} : { actorContext }),
227
+ origin: this.originFromEvent(event),
228
+ }),
229
+ };
230
+ }
231
+ /**
232
+ * Creates command metadata from a command substitution.
233
+ *
234
+ * @param command Source command.
235
+ * @returns Fresh command identifier and derived context.
236
+ */
237
+ commandFromCommand(command) {
238
+ return {
239
+ id: this.commandId(),
240
+ context: this.commandContext({
241
+ ...(command.context?.actorContext === undefined
242
+ ? {}
243
+ : { actorContext: command.context.actorContext }),
244
+ origin: this.originFromCommand(command),
245
+ }),
246
+ };
247
+ }
248
+ /**
249
+ * Creates event metadata from a command.
250
+ *
251
+ * @param command Source command.
252
+ * @param input Additional event context input.
253
+ * @returns Fresh event identifier and derived context.
254
+ */
255
+ eventFromCommand(command, input) {
256
+ const context = {
257
+ ...(input.producerId === undefined ? {} : { producerId: input.producerId }),
258
+ ...(input.version === undefined ? {} : { version: input.version }),
259
+ origin: this.originFromCommand(command),
260
+ };
261
+ return {
262
+ id: this.eventId(),
263
+ context: this.eventContext(context),
264
+ };
265
+ }
266
+ /**
267
+ * Creates event metadata from an event.
268
+ *
269
+ * @param event Source event.
270
+ * @param input Additional event context input.
271
+ * @returns Fresh event identifier and derived context.
272
+ */
273
+ eventFromEvent(event, input) {
274
+ const context = {
275
+ ...(input.producerId === undefined ? {} : { producerId: input.producerId }),
276
+ ...(input.version === undefined ? {} : { version: input.version }),
277
+ origin: this.originFromEvent(event),
278
+ };
279
+ return {
280
+ id: this.eventId(),
281
+ context: this.eventContext(context),
282
+ };
283
+ }
284
+ #messageId(id, typeUrl) {
285
+ return create(MessageIdSchema, {
286
+ id,
287
+ typeUrl: typeUrl ?? "",
288
+ });
289
+ }
290
+ #actorContext(input) {
291
+ return input.actor === undefined && input.tenantId === undefined
292
+ ? undefined
293
+ : this.actorContext(input);
294
+ }
295
+ #eventActor(event) {
296
+ switch (event.context?.origin.case) {
297
+ case "importContext":
298
+ return clone(ActorContextSchema, event.context.origin.value);
299
+ case "pastMessage":
300
+ return event.context.origin.value.actorContext === undefined
301
+ ? undefined
302
+ : clone(ActorContextSchema, event.context.origin.value.actorContext);
303
+ default:
304
+ return undefined;
305
+ }
306
+ }
307
+ #grandOrigin(event) {
308
+ return event.context?.origin.case === "pastMessage"
309
+ ? clone(OriginSchema, event.context.origin.value)
310
+ : undefined;
311
+ }
312
+ #commandId(command) {
313
+ if (command.id === undefined || command.id.uuid.trim().length === 0)
314
+ throw new Error("Signal metadata requires a non-empty source command ID.");
315
+ return command.id;
316
+ }
317
+ #eventId(event) {
318
+ if (event.id === undefined || event.id.value.trim().length === 0)
319
+ throw new Error("Signal metadata requires a non-empty source event ID.");
320
+ return event.id;
321
+ }
322
+ }
323
+ /**
324
+ * Validates values shared by clock metadata.
325
+ */
326
+ const SignalValues = Object.freeze({
327
+ time(value) {
328
+ if (!Number.isFinite(value.getTime()))
329
+ throw new TypeError("Signal metadata timestamps require a finite Date instance.");
330
+ return value;
331
+ },
332
+ });
333
+ //# sourceMappingURL=signal-metadata.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"signal-metadata.js","sourceRoot":"","sources":["../../src/runtime/signal-metadata.ts"],"names":[],"mappings":"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"}