@nwire/forge 0.9.2 → 0.10.1

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 (291) hide show
  1. package/README.md +133 -155
  2. package/dist/foundation.d.ts +0 -13
  3. package/dist/foundation.js +2 -13
  4. package/dist/framework-events.d.ts +51 -54
  5. package/dist/framework-events.js +18 -65
  6. package/dist/{cli-runner.d.ts → helpers/cli-runner.d.ts} +2 -3
  7. package/dist/{cli-runner.js → helpers/cli-runner.js} +11 -27
  8. package/dist/{public-marker.d.ts → helpers/public-marker.d.ts} +0 -1
  9. package/dist/{public-marker.js → helpers/public-marker.js} +0 -1
  10. package/dist/{response.d.ts → helpers/response.d.ts} +0 -1
  11. package/dist/{response.js → helpers/response.js} +0 -1
  12. package/dist/helpers/retry-helpers.d.ts +22 -0
  13. package/dist/helpers/retry-helpers.js +43 -0
  14. package/dist/{validate.d.ts → helpers/validate.d.ts} +0 -1
  15. package/dist/{validate.js → helpers/validate.js} +0 -1
  16. package/dist/index.d.ts +42 -48
  17. package/dist/index.js +47 -55
  18. package/dist/{event-message.d.ts → messages/event-message.d.ts} +0 -1
  19. package/dist/{event-message.js → messages/event-message.js} +0 -1
  20. package/dist/{dev-logger.d.ts → observability/dev-logger.d.ts} +2 -2
  21. package/dist/{dev-logger.js → observability/dev-logger.js} +0 -30
  22. package/dist/{define-action.d.ts → primitives/define-action.d.ts} +0 -1
  23. package/dist/{define-action.js → primitives/define-action.js} +0 -1
  24. package/dist/{define-actor.d.ts → primitives/define-actor.d.ts} +0 -1
  25. package/dist/{define-actor.js → primitives/define-actor.js} +0 -1
  26. package/dist/{define-cron.d.ts → primitives/define-cron.d.ts} +0 -1
  27. package/dist/{define-cron.js → primitives/define-cron.js} +0 -1
  28. package/dist/{define-error.d.ts → primitives/define-error.d.ts} +0 -1
  29. package/dist/{define-error.js → primitives/define-error.js} +0 -1
  30. package/dist/{define-external-call.d.ts → primitives/define-external-call.d.ts} +0 -1
  31. package/dist/{define-external-call.js → primitives/define-external-call.js} +0 -1
  32. package/dist/{define-handler.d.ts → primitives/define-handler.d.ts} +29 -2
  33. package/dist/{define-handler.js → primitives/define-handler.js} +13 -2
  34. package/dist/{define-inbound-webhook.d.ts → primitives/define-inbound-webhook.d.ts} +1 -2
  35. package/dist/{define-inbound-webhook.js → primitives/define-inbound-webhook.js} +1 -2
  36. package/dist/{define-inbox.d.ts → primitives/define-inbox.d.ts} +0 -1
  37. package/dist/{define-inbox.js → primitives/define-inbox.js} +0 -1
  38. package/dist/{define-outbox.d.ts → primitives/define-outbox.d.ts} +0 -1
  39. package/dist/{define-outbox.js → primitives/define-outbox.js} +0 -1
  40. package/dist/{define-projection.d.ts → primitives/define-projection.d.ts} +0 -1
  41. package/dist/{define-projection.js → primitives/define-projection.js} +0 -1
  42. package/dist/{define-query.d.ts → primitives/define-query.d.ts} +1 -2
  43. package/dist/{define-query.js → primitives/define-query.js} +1 -2
  44. package/dist/{define-schema.d.ts → primitives/define-schema.d.ts} +1 -2
  45. package/dist/{define-schema.js → primitives/define-schema.js} +1 -2
  46. package/dist/{define-upcaster.d.ts → primitives/define-upcaster.d.ts} +0 -1
  47. package/dist/{define-upcaster.js → primitives/define-upcaster.js} +0 -1
  48. package/dist/{define-workflow.d.ts → primitives/define-workflow.d.ts} +2 -3
  49. package/dist/{define-workflow.js → primitives/define-workflow.js} +2 -3
  50. package/dist/runtime/create-forge-app.d.ts +64 -0
  51. package/dist/runtime/create-forge-app.js +78 -0
  52. package/dist/runtime/forge-dispatcher.d.ts +148 -0
  53. package/dist/{runtime.js → runtime/forge-dispatcher.js} +242 -571
  54. package/dist/runtime/forge-plugin.d.ts +59 -0
  55. package/dist/runtime/forge-plugin.js +121 -0
  56. package/dist/runtime/forge-types.d.ts +204 -0
  57. package/dist/runtime/forge-types.js +5 -0
  58. package/dist/{actor-store.d.ts → stores/actor-store.d.ts} +1 -2
  59. package/dist/{actor-store.js → stores/actor-store.js} +0 -1
  60. package/dist/{idempotency-store.d.ts → stores/idempotency-store.d.ts} +0 -1
  61. package/dist/{idempotency-store.js → stores/idempotency-store.js} +0 -1
  62. package/dist/{projection-store.d.ts → stores/projection-store.d.ts} +0 -1
  63. package/dist/{projection-store.js → stores/projection-store.js} +0 -1
  64. package/dist/{workflow-timer-store.d.ts → stores/workflow-timer-store.d.ts} +0 -1
  65. package/dist/{workflow-timer-store.js → stores/workflow-timer-store.js} +0 -1
  66. package/package.json +11 -11
  67. package/dist/__tests__/action-hooks.test.d.ts +0 -8
  68. package/dist/__tests__/action-hooks.test.d.ts.map +0 -1
  69. package/dist/__tests__/action-hooks.test.js +0 -95
  70. package/dist/__tests__/action-hooks.test.js.map +0 -1
  71. package/dist/__tests__/actor-methods.test.d.ts +0 -9
  72. package/dist/__tests__/actor-methods.test.d.ts.map +0 -1
  73. package/dist/__tests__/actor-methods.test.js +0 -210
  74. package/dist/__tests__/actor-methods.test.js.map +0 -1
  75. package/dist/__tests__/actor-schema-bound.test.d.ts +0 -6
  76. package/dist/__tests__/actor-schema-bound.test.d.ts.map +0 -1
  77. package/dist/__tests__/actor-schema-bound.test.js +0 -112
  78. package/dist/__tests__/actor-schema-bound.test.js.map +0 -1
  79. package/dist/__tests__/actor-workflow-hooks.test.d.ts +0 -8
  80. package/dist/__tests__/actor-workflow-hooks.test.d.ts.map +0 -1
  81. package/dist/__tests__/actor-workflow-hooks.test.js +0 -106
  82. package/dist/__tests__/actor-workflow-hooks.test.js.map +0 -1
  83. package/dist/__tests__/app-capabilities.test.d.ts +0 -19
  84. package/dist/__tests__/app-capabilities.test.d.ts.map +0 -1
  85. package/dist/__tests__/app-capabilities.test.js +0 -57
  86. package/dist/__tests__/app-capabilities.test.js.map +0 -1
  87. package/dist/__tests__/cli-runner.test.d.ts +0 -6
  88. package/dist/__tests__/cli-runner.test.d.ts.map +0 -1
  89. package/dist/__tests__/cli-runner.test.js +0 -158
  90. package/dist/__tests__/cli-runner.test.js.map +0 -1
  91. package/dist/__tests__/create-app.test.d.ts +0 -18
  92. package/dist/__tests__/create-app.test.d.ts.map +0 -1
  93. package/dist/__tests__/create-app.test.js +0 -189
  94. package/dist/__tests__/create-app.test.js.map +0 -1
  95. package/dist/__tests__/cross-service-bus.test.d.ts +0 -8
  96. package/dist/__tests__/cross-service-bus.test.d.ts.map +0 -1
  97. package/dist/__tests__/cross-service-bus.test.js +0 -139
  98. package/dist/__tests__/cross-service-bus.test.js.map +0 -1
  99. package/dist/__tests__/define-schema.test.d.ts +0 -5
  100. package/dist/__tests__/define-schema.test.d.ts.map +0 -1
  101. package/dist/__tests__/define-schema.test.js +0 -83
  102. package/dist/__tests__/define-schema.test.js.map +0 -1
  103. package/dist/__tests__/dev-logger.test.d.ts +0 -9
  104. package/dist/__tests__/dev-logger.test.d.ts.map +0 -1
  105. package/dist/__tests__/dev-logger.test.js +0 -126
  106. package/dist/__tests__/dev-logger.test.js.map +0 -1
  107. package/dist/__tests__/external-call.test.d.ts +0 -14
  108. package/dist/__tests__/external-call.test.d.ts.map +0 -1
  109. package/dist/__tests__/external-call.test.js +0 -99
  110. package/dist/__tests__/external-call.test.js.map +0 -1
  111. package/dist/__tests__/framework-events.test.d.ts +0 -13
  112. package/dist/__tests__/framework-events.test.d.ts.map +0 -1
  113. package/dist/__tests__/framework-events.test.js +0 -204
  114. package/dist/__tests__/framework-events.test.js.map +0 -1
  115. package/dist/__tests__/inline-handler.test.d.ts +0 -8
  116. package/dist/__tests__/inline-handler.test.d.ts.map +0 -1
  117. package/dist/__tests__/inline-handler.test.js +0 -101
  118. package/dist/__tests__/inline-handler.test.js.map +0 -1
  119. package/dist/__tests__/lifecycle-logging.test.d.ts +0 -12
  120. package/dist/__tests__/lifecycle-logging.test.d.ts.map +0 -1
  121. package/dist/__tests__/lifecycle-logging.test.js +0 -114
  122. package/dist/__tests__/lifecycle-logging.test.js.map +0 -1
  123. package/dist/__tests__/middleware.test.d.ts +0 -7
  124. package/dist/__tests__/middleware.test.d.ts.map +0 -1
  125. package/dist/__tests__/middleware.test.js +0 -109
  126. package/dist/__tests__/middleware.test.js.map +0 -1
  127. package/dist/__tests__/module-needs.test.d.ts +0 -10
  128. package/dist/__tests__/module-needs.test.d.ts.map +0 -1
  129. package/dist/__tests__/module-needs.test.js +0 -77
  130. package/dist/__tests__/module-needs.test.js.map +0 -1
  131. package/dist/__tests__/module-topo-sort.test.d.ts +0 -15
  132. package/dist/__tests__/module-topo-sort.test.d.ts.map +0 -1
  133. package/dist/__tests__/module-topo-sort.test.js +0 -105
  134. package/dist/__tests__/module-topo-sort.test.js.map +0 -1
  135. package/dist/__tests__/multi-tenancy.test.d.ts +0 -10
  136. package/dist/__tests__/multi-tenancy.test.d.ts.map +0 -1
  137. package/dist/__tests__/multi-tenancy.test.js +0 -122
  138. package/dist/__tests__/multi-tenancy.test.js.map +0 -1
  139. package/dist/__tests__/needs-topology.test.d.ts +0 -11
  140. package/dist/__tests__/needs-topology.test.d.ts.map +0 -1
  141. package/dist/__tests__/needs-topology.test.js +0 -82
  142. package/dist/__tests__/needs-topology.test.js.map +0 -1
  143. package/dist/__tests__/plugin-app-narrow.test.d.ts +0 -12
  144. package/dist/__tests__/plugin-app-narrow.test.d.ts.map +0 -1
  145. package/dist/__tests__/plugin-app-narrow.test.js +0 -77
  146. package/dist/__tests__/plugin-app-narrow.test.js.map +0 -1
  147. package/dist/__tests__/plugin-closure.test.d.ts +0 -15
  148. package/dist/__tests__/plugin-closure.test.d.ts.map +0 -1
  149. package/dist/__tests__/plugin-closure.test.js +0 -140
  150. package/dist/__tests__/plugin-closure.test.js.map +0 -1
  151. package/dist/__tests__/plugin-stress.test.d.ts +0 -21
  152. package/dist/__tests__/plugin-stress.test.d.ts.map +0 -1
  153. package/dist/__tests__/plugin-stress.test.js +0 -203
  154. package/dist/__tests__/plugin-stress.test.js.map +0 -1
  155. package/dist/__tests__/plugin.test.d.ts +0 -10
  156. package/dist/__tests__/plugin.test.d.ts.map +0 -1
  157. package/dist/__tests__/plugin.test.js +0 -225
  158. package/dist/__tests__/plugin.test.js.map +0 -1
  159. package/dist/__tests__/primitives.test.d.ts +0 -9
  160. package/dist/__tests__/primitives.test.d.ts.map +0 -1
  161. package/dist/__tests__/primitives.test.js +0 -434
  162. package/dist/__tests__/primitives.test.js.map +0 -1
  163. package/dist/__tests__/production-readiness.test.d.ts +0 -22
  164. package/dist/__tests__/production-readiness.test.d.ts.map +0 -1
  165. package/dist/__tests__/production-readiness.test.js +0 -196
  166. package/dist/__tests__/production-readiness.test.js.map +0 -1
  167. package/dist/__tests__/provider.test.d.ts +0 -6
  168. package/dist/__tests__/provider.test.d.ts.map +0 -1
  169. package/dist/__tests__/provider.test.js +0 -122
  170. package/dist/__tests__/provider.test.js.map +0 -1
  171. package/dist/__tests__/public-marker.test.d.ts +0 -7
  172. package/dist/__tests__/public-marker.test.d.ts.map +0 -1
  173. package/dist/__tests__/public-marker.test.js +0 -58
  174. package/dist/__tests__/public-marker.test.js.map +0 -1
  175. package/dist/__tests__/retry-dlq.test.d.ts +0 -6
  176. package/dist/__tests__/retry-dlq.test.d.ts.map +0 -1
  177. package/dist/__tests__/retry-dlq.test.js +0 -68
  178. package/dist/__tests__/retry-dlq.test.js.map +0 -1
  179. package/dist/__tests__/validate.test.d.ts +0 -5
  180. package/dist/__tests__/validate.test.d.ts.map +0 -1
  181. package/dist/__tests__/validate.test.js +0 -53
  182. package/dist/__tests__/validate.test.js.map +0 -1
  183. package/dist/__tests__/workflow-saga.test.d.ts +0 -7
  184. package/dist/__tests__/workflow-saga.test.d.ts.map +0 -1
  185. package/dist/__tests__/workflow-saga.test.js +0 -265
  186. package/dist/__tests__/workflow-saga.test.js.map +0 -1
  187. package/dist/actor-store.d.ts.map +0 -1
  188. package/dist/actor-store.js.map +0 -1
  189. package/dist/cli-runner.d.ts.map +0 -1
  190. package/dist/cli-runner.js.map +0 -1
  191. package/dist/create-app.d.ts +0 -146
  192. package/dist/create-app.d.ts.map +0 -1
  193. package/dist/create-app.js +0 -703
  194. package/dist/create-app.js.map +0 -1
  195. package/dist/define-action.d.ts.map +0 -1
  196. package/dist/define-action.js.map +0 -1
  197. package/dist/define-actor.d.ts.map +0 -1
  198. package/dist/define-actor.js.map +0 -1
  199. package/dist/define-app.d.ts +0 -104
  200. package/dist/define-app.d.ts.map +0 -1
  201. package/dist/define-app.js +0 -49
  202. package/dist/define-app.js.map +0 -1
  203. package/dist/define-cron.d.ts.map +0 -1
  204. package/dist/define-cron.js.map +0 -1
  205. package/dist/define-error.d.ts.map +0 -1
  206. package/dist/define-error.js.map +0 -1
  207. package/dist/define-external-call.d.ts.map +0 -1
  208. package/dist/define-external-call.js.map +0 -1
  209. package/dist/define-handler.d.ts.map +0 -1
  210. package/dist/define-handler.js.map +0 -1
  211. package/dist/define-inbound-webhook.d.ts.map +0 -1
  212. package/dist/define-inbound-webhook.js.map +0 -1
  213. package/dist/define-inbox.d.ts.map +0 -1
  214. package/dist/define-inbox.js.map +0 -1
  215. package/dist/define-initializer.d.ts +0 -54
  216. package/dist/define-initializer.d.ts.map +0 -1
  217. package/dist/define-initializer.js +0 -38
  218. package/dist/define-initializer.js.map +0 -1
  219. package/dist/define-middleware.d.ts +0 -8
  220. package/dist/define-middleware.d.ts.map +0 -1
  221. package/dist/define-middleware.js +0 -8
  222. package/dist/define-middleware.js.map +0 -1
  223. package/dist/define-model.d.ts +0 -10
  224. package/dist/define-model.d.ts.map +0 -1
  225. package/dist/define-model.js +0 -13
  226. package/dist/define-model.js.map +0 -1
  227. package/dist/define-module.d.ts +0 -160
  228. package/dist/define-module.d.ts.map +0 -1
  229. package/dist/define-module.js +0 -63
  230. package/dist/define-module.js.map +0 -1
  231. package/dist/define-outbox.d.ts.map +0 -1
  232. package/dist/define-outbox.js.map +0 -1
  233. package/dist/define-plugin.d.ts +0 -195
  234. package/dist/define-plugin.d.ts.map +0 -1
  235. package/dist/define-plugin.js +0 -220
  236. package/dist/define-plugin.js.map +0 -1
  237. package/dist/define-projection.d.ts.map +0 -1
  238. package/dist/define-projection.js.map +0 -1
  239. package/dist/define-provider.d.ts +0 -49
  240. package/dist/define-provider.d.ts.map +0 -1
  241. package/dist/define-provider.js +0 -45
  242. package/dist/define-provider.js.map +0 -1
  243. package/dist/define-query.d.ts.map +0 -1
  244. package/dist/define-query.js.map +0 -1
  245. package/dist/define-resolver.d.ts +0 -111
  246. package/dist/define-resolver.d.ts.map +0 -1
  247. package/dist/define-resolver.js +0 -146
  248. package/dist/define-resolver.js.map +0 -1
  249. package/dist/define-schema.d.ts.map +0 -1
  250. package/dist/define-schema.js.map +0 -1
  251. package/dist/define-upcaster.d.ts.map +0 -1
  252. package/dist/define-upcaster.js.map +0 -1
  253. package/dist/define-workflow.d.ts.map +0 -1
  254. package/dist/define-workflow.js.map +0 -1
  255. package/dist/dev-logger.d.ts.map +0 -1
  256. package/dist/dev-logger.js.map +0 -1
  257. package/dist/event-message.d.ts.map +0 -1
  258. package/dist/event-message.js.map +0 -1
  259. package/dist/foundation.d.ts.map +0 -1
  260. package/dist/foundation.js.map +0 -1
  261. package/dist/framework-event-bus.d.ts +0 -13
  262. package/dist/framework-event-bus.d.ts.map +0 -1
  263. package/dist/framework-event-bus.js +0 -13
  264. package/dist/framework-event-bus.js.map +0 -1
  265. package/dist/framework-events.d.ts.map +0 -1
  266. package/dist/framework-events.js.map +0 -1
  267. package/dist/idempotency-store.d.ts.map +0 -1
  268. package/dist/idempotency-store.js.map +0 -1
  269. package/dist/index.d.ts.map +0 -1
  270. package/dist/index.js.map +0 -1
  271. package/dist/module-surface.d.ts +0 -47
  272. package/dist/module-surface.d.ts.map +0 -1
  273. package/dist/module-surface.js +0 -65
  274. package/dist/module-surface.js.map +0 -1
  275. package/dist/projection-store.d.ts.map +0 -1
  276. package/dist/projection-store.js.map +0 -1
  277. package/dist/public-marker.d.ts.map +0 -1
  278. package/dist/public-marker.js.map +0 -1
  279. package/dist/response.d.ts.map +0 -1
  280. package/dist/response.js.map +0 -1
  281. package/dist/runtime.d.ts +0 -621
  282. package/dist/runtime.d.ts.map +0 -1
  283. package/dist/runtime.js.map +0 -1
  284. package/dist/validate.d.ts.map +0 -1
  285. package/dist/validate.js.map +0 -1
  286. package/dist/when.d.ts +0 -101
  287. package/dist/when.d.ts.map +0 -1
  288. package/dist/when.js +0 -57
  289. package/dist/when.js.map +0 -1
  290. package/dist/workflow-timer-store.d.ts.map +0 -1
  291. package/dist/workflow-timer-store.js.map +0 -1
@@ -1,210 +0,0 @@
1
- /**
2
- * Actor methods + `ctx.use(Actor, id)` — pure invariant-enforcers + event
3
- * minters bound to the loaded state. Methods take state, return events or
4
- * read values, throw on invariant violation. `ctx.use` loads the actor from
5
- * the store and returns a view with state, stateName, key, and pre-bound
6
- * methods. The view is a snapshot — the loaded state is frozen for that view.
7
- */
8
- import { describe, it, expect } from "vitest";
9
- import { z } from "zod";
10
- import { defineEvent } from "@nwire/messages";
11
- import { defineAction, defineActor, defineModule, createApp, eventFactory, } from "../foundation.js";
12
- const SubmissionSchema = z.object({
13
- studentId: z.string(),
14
- answer: z.string(),
15
- flags: z.number(),
16
- });
17
- const SubmittedEventDef = defineEvent({
18
- name: "sub.submitted",
19
- schema: z.object({
20
- submissionId: z.string(),
21
- studentId: z.string(),
22
- answer: z.string(),
23
- submittedAt: z.string(),
24
- }),
25
- });
26
- const Submitted = eventFactory(SubmittedEventDef);
27
- const FlaggedEventDef = defineEvent({
28
- name: "sub.flagged",
29
- schema: z.object({
30
- submissionId: z.string(),
31
- reason: z.string(),
32
- flaggedAt: z.string(),
33
- }),
34
- });
35
- const Flagged = eventFactory(FlaggedEventDef);
36
- const GradedEventDef = defineEvent({
37
- name: "sub.graded",
38
- schema: z.object({
39
- submissionId: z.string(),
40
- verdict: z.enum(["correct", "incorrect"]),
41
- gradedAt: z.string(),
42
- }),
43
- });
44
- const Graded = eventFactory(GradedEventDef);
45
- const Submission = defineActor("submission", {
46
- schema: SubmissionSchema,
47
- key: "submissionId",
48
- initial: "pending",
49
- states: {
50
- pending: {
51
- on: {
52
- [SubmittedEventDef.name]: {
53
- target: "pending",
54
- assign: (_, event) => {
55
- const e = event;
56
- return { studentId: e.studentId, answer: e.answer, flags: 0 };
57
- },
58
- },
59
- [FlaggedEventDef.name]: {
60
- target: "flagged",
61
- assign: (state) => ({ flags: (state.flags ?? 0) + 1 }),
62
- },
63
- [GradedEventDef.name]: { target: "graded" },
64
- },
65
- },
66
- flagged: {
67
- on: {
68
- [GradedEventDef.name]: { target: "graded" },
69
- },
70
- },
71
- graded: { final: true },
72
- },
73
- methods: {
74
- flagForReview(state, reason) {
75
- if (reason.length < 3) {
76
- throw new Error("reason too short");
77
- }
78
- return Flagged({
79
- submissionId: "placeholder", // handler injects the real id
80
- reason,
81
- flaggedAt: new Date().toISOString(),
82
- });
83
- },
84
- isGradable(state) {
85
- return state.flags === 0;
86
- },
87
- flagCount(state) {
88
- return state.flags;
89
- },
90
- },
91
- });
92
- const submitAnswer = defineAction({
93
- name: "sub.submit-answer",
94
- schema: z.object({ submissionId: z.string(), studentId: z.string(), answer: z.string() }),
95
- handler: async (input) => Submitted({
96
- submissionId: input.submissionId,
97
- studentId: input.studentId,
98
- answer: input.answer,
99
- submittedAt: new Date().toISOString(),
100
- }),
101
- });
102
- const flagForReview = defineAction({
103
- name: "sub.flag-for-review",
104
- schema: z.object({ submissionId: z.string(), reason: z.string() }),
105
- handler: async (input, ctx) => {
106
- const submission = await ctx.use(Submission, input.submissionId);
107
- // methods return an event — handler returns it for the runtime to apply.
108
- const event = submission.flagForReview(input.reason);
109
- // Inject the real submissionId (the method had a placeholder).
110
- return {
111
- ...event,
112
- payload: { ...event.payload, submissionId: input.submissionId },
113
- };
114
- },
115
- });
116
- const checkGradable = defineAction({
117
- name: "sub.check-gradable",
118
- schema: z.object({ submissionId: z.string() }),
119
- handler: async (input, ctx) => {
120
- const submission = await ctx.use(Submission, input.submissionId);
121
- if (!submission.isGradable()) {
122
- throw new Error(`not gradable; ${submission.flagCount()} flags`);
123
- }
124
- return undefined;
125
- },
126
- });
127
- describe("actor methods + ctx.use", () => {
128
- it("ctx.use loads the actor and exposes state + stateName + key", async () => {
129
- const app = createApp({
130
- modules: [
131
- defineModule("m", {
132
- actors: [Submission],
133
- actions: [submitAnswer, checkGradable],
134
- events: [SubmittedEventDef, FlaggedEventDef, GradedEventDef],
135
- }),
136
- ],
137
- });
138
- await app.runtime.dispatch(submitAnswer, {
139
- submissionId: "s1",
140
- studentId: "avi",
141
- answer: "4",
142
- });
143
- // checkGradable handler reads state + invokes methods; no throw = gradable.
144
- await app.runtime.dispatch(checkGradable, { submissionId: "s1" });
145
- });
146
- it("a method returning an event flows through the handler into the runtime", async () => {
147
- const app = createApp({
148
- modules: [
149
- defineModule("m", {
150
- actors: [Submission],
151
- actions: [submitAnswer, flagForReview],
152
- events: [SubmittedEventDef, FlaggedEventDef, GradedEventDef],
153
- }),
154
- ],
155
- });
156
- await app.runtime.dispatch(submitAnswer, {
157
- submissionId: "s2",
158
- studentId: "avi",
159
- answer: "4",
160
- });
161
- await app.runtime.dispatch(flagForReview, {
162
- submissionId: "s2",
163
- reason: "contains profanity",
164
- });
165
- const stored = await app.runtime.getActorStore().load("submission", "s2", "");
166
- expect(stored?.state).toBe("flagged");
167
- expect((stored?.data).flags).toBe(1);
168
- });
169
- it("a method that throws an invariant error bubbles up from the handler", async () => {
170
- const app = createApp({
171
- modules: [
172
- defineModule("m", {
173
- actors: [Submission],
174
- actions: [submitAnswer, flagForReview],
175
- events: [SubmittedEventDef, FlaggedEventDef, GradedEventDef],
176
- }),
177
- ],
178
- });
179
- await app.runtime.dispatch(submitAnswer, {
180
- submissionId: "s3",
181
- studentId: "avi",
182
- answer: "4",
183
- });
184
- await expect(app.runtime.dispatch(flagForReview, { submissionId: "s3", reason: "ok" })).rejects.toThrow(/reason too short/);
185
- });
186
- it("ctx.use returns a virgin view when the instance has never received an event", async () => {
187
- // Phase 42.1 + 42.2 canonicalized the "virgin instance" pattern so that
188
- // `create` methods can bootstrap a brand-new aggregate. ctx.use does
189
- // NOT throw on a missing instance — it returns the initial state and
190
- // lets the handler decide whether that's an error.
191
- const app = createApp({
192
- modules: [
193
- defineModule("m", {
194
- actors: [Submission],
195
- actions: [checkGradable],
196
- events: [SubmittedEventDef],
197
- }),
198
- ],
199
- });
200
- await expect(app.runtime.dispatch(checkGradable, { submissionId: "never-existed" })).rejects.toThrow(/not gradable/);
201
- });
202
- it("ctx.use throws a helpful error when the actor TYPE is not registered", async () => {
203
- // Actor type missing from the module manifest → boot-time framework
204
- // problem, not a runtime data problem. Distinct from the virgin-
205
- // instance case above.
206
- const app = createApp({ modules: [defineModule("m", { actions: [checkGradable] })] });
207
- await expect(app.runtime.dispatch(checkGradable, { submissionId: "x" })).rejects.toThrow(/not registered/);
208
- });
209
- });
210
- //# sourceMappingURL=actor-methods.test.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"actor-methods.test.js","sourceRoot":"","sources":["../../src/__tests__/actor-methods.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EACL,YAAY,EACZ,WAAW,EAEX,YAAY,EACZ,SAAS,EACT,YAAY,GAEb,MAAM,eAAe,CAAC;AAEvB,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAGH,MAAM,iBAAiB,GAAG,WAAW,CAAC;IACpC,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;KACxB,CAAC;CACH,CAAC,CAAC;AACH,MAAM,SAAS,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;AAElD,MAAM,eAAe,GAAG,WAAW,CAAC;IAClC,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;CACH,CAAC,CAAC;AACH,MAAM,OAAO,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAE9C,MAAM,cAAc,GAAG,WAAW,CAAC;IACjC,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACzC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC;CACH,CAAC,CAAC;AACH,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;AAE5C,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,EAAE;IAC3C,MAAM,EAAE,gBAAgB;IACxB,GAAG,EAAE,cAAc;IACnB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE;QACN,OAAO,EAAE;YACP,EAAE,EAAE;gBACF,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE;oBACxB,MAAM,EAAE,SAAS;oBACjB,MAAM,EAAE,CAAC,CAAC,EAAE,KAAc,EAAE,EAAE;wBAC5B,MAAM,CAAC,GAAG,KAA8C,CAAC;wBACzD,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;oBAChE,CAAC;iBACF;gBACD,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE;oBACtB,MAAM,EAAE,SAAS;oBACjB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;iBACvD;gBACD,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;aAC5C;SACF;QACD,OAAO,EAAE;YACP,EAAE,EAAE;gBACF,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;aAC5C;SACF;QACD,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;KACxB;IACD,OAAO,EAAE;QACP,aAAa,CAAC,KAAsB,EAAE,MAAc;YAClD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACtC,CAAC;YACD,OAAO,OAAO,CAAC;gBACb,YAAY,EAAE,aAAa,EAAE,8BAA8B;gBAC3D,MAAM;gBACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;QACD,UAAU,CAAC,KAAsB;YAC/B,OAAO,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,SAAS,CAAC,KAAsB;YAC9B,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,CAAC;KACF;CACF,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,YAAY,CAAC;IAChC,IAAI,EAAE,mBAAmB;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IACzF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CACvB,SAAS,CAAC;QACR,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;CACL,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,YAAY,CAAC;IACjC,IAAI,EAAE,qBAAqB;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAClE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5B,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QACjE,yEAAyE;QACzE,MAAM,KAAK,GAAG,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAiB,CAAC;QACrE,+DAA+D;QAC/D,OAAO;YACL,GAAG,KAAK;YACR,OAAO,EAAE,EAAE,GAAI,KAAK,CAAC,OAAkB,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE;SAC5D,CAAC;IACpB,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,YAAY,CAAC;IACjC,IAAI,EAAE,oBAAoB;IAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC9C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5B,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QACjE,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,iBAAiB,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,GAAG,GAAG,SAAS,CAAC;YACpB,OAAO,EAAE;gBACP,YAAY,CAAC,GAAG,EAAE;oBAChB,MAAM,EAAE,CAAC,UAAU,CAAC;oBACpB,OAAO,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;oBACtC,MAAM,EAAE,CAAC,iBAAiB,EAAE,eAAe,EAAE,cAAc,CAAC;iBAC7D,CAAC;aACH;SACF,CAAC,CAAC;QAEH,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE;YACvC,YAAY,EAAE,IAAI;YAClB,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,GAAG;SACZ,CAAC,CAAC;QAEH,4EAA4E;QAC5E,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,GAAG,GAAG,SAAS,CAAC;YACpB,OAAO,EAAE;gBACP,YAAY,CAAC,GAAG,EAAE;oBAChB,MAAM,EAAE,CAAC,UAAU,CAAC;oBACpB,OAAO,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;oBACtC,MAAM,EAAE,CAAC,iBAAiB,EAAE,eAAe,EAAE,cAAc,CAAC;iBAC7D,CAAC;aACH;SACF,CAAC,CAAC;QAEH,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE;YACvC,YAAY,EAAE,IAAI;YAClB,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,GAAG;SACZ,CAAC,CAAC;QACH,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE;YACxC,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,oBAAoB;SAC7B,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9E,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,CAAC,CAAC,MAAM,EAAE,IAAwB,CAAA,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,GAAG,GAAG,SAAS,CAAC;YACpB,OAAO,EAAE;gBACP,YAAY,CAAC,GAAG,EAAE;oBAChB,MAAM,EAAE,CAAC,UAAU,CAAC;oBACpB,OAAO,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;oBACtC,MAAM,EAAE,CAAC,iBAAiB,EAAE,eAAe,EAAE,cAAc,CAAC;iBAC7D,CAAC;aACH;SACF,CAAC,CAAC;QAEH,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE;YACvC,YAAY,EAAE,IAAI;YAClB,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,GAAG;SACZ,CAAC,CAAC;QAEH,MAAM,MAAM,CACV,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAC1E,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC3F,wEAAwE;QACxE,qEAAqE;QACrE,qEAAqE;QACrE,mDAAmD;QACnD,MAAM,GAAG,GAAG,SAAS,CAAC;YACpB,OAAO,EAAE;gBACP,YAAY,CAAC,GAAG,EAAE;oBAChB,MAAM,EAAE,CAAC,UAAU,CAAC;oBACpB,OAAO,EAAE,CAAC,aAAa,CAAC;oBACxB,MAAM,EAAE,CAAC,iBAAiB,CAAC;iBAC5B,CAAC;aACH;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,CACV,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,CACvE,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,oEAAoE;QACpE,iEAAiE;QACjE,uBAAuB;QACvB,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACtF,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACtF,gBAAgB,CACjB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -1,6 +0,0 @@
1
- /**
2
- * defineActor — schema-bound form. The schema provides key/initial/final;
3
- * the actor provides transitions per state.
4
- */
5
- export {};
6
- //# sourceMappingURL=actor-schema-bound.test.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"actor-schema-bound.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/actor-schema-bound.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
@@ -1,112 +0,0 @@
1
- /**
2
- * defineActor — schema-bound form. The schema provides key/initial/final;
3
- * the actor provides transitions per state.
4
- */
5
- import { describe, it, expect } from "vitest";
6
- import { z } from "zod";
7
- import { defineEvent } from "@nwire/messages";
8
- import { defineActor } from "../define-actor.js";
9
- import { defineSchema } from "../define-schema.js";
10
- const AnswerWasSubmitted = defineEvent({
11
- name: "submissions.answer-was-submitted",
12
- schema: z.object({ submissionId: z.string(), answer: z.string() }),
13
- });
14
- const AnswerWasFlagged = defineEvent({
15
- name: "submissions.answer-was-flagged",
16
- schema: z.object({ submissionId: z.string(), confidence: z.number() }),
17
- });
18
- const SubmissionWasManuallyGraded = defineEvent({
19
- name: "submissions.was-manually-graded",
20
- schema: z.object({ submissionId: z.string(), verdict: z.string() }),
21
- });
22
- const SubmissionData = defineSchema({
23
- name: "submission",
24
- key: "submissionId",
25
- fields: {
26
- submissionId: z.string(),
27
- answer: z.string().optional(),
28
- confidence: z.number().optional(),
29
- verdict: z.string().optional(),
30
- },
31
- states: {
32
- submitted: { initial: true },
33
- "under-review": {},
34
- graded: { final: true },
35
- },
36
- });
37
- describe("defineActor (schema-bound)", () => {
38
- it("derives name, key, initial, and final states from the schema", () => {
39
- const Submission = defineActor({
40
- schema: SubmissionData,
41
- states: {
42
- submitted: {
43
- on: {
44
- [AnswerWasSubmitted.name]: {
45
- assign: (_s, e) => ({ answer: e.answer }),
46
- },
47
- [AnswerWasFlagged.name]: {
48
- target: "under-review",
49
- assign: (_s, e) => ({ confidence: e.confidence }),
50
- },
51
- },
52
- },
53
- "under-review": {
54
- on: {
55
- [SubmissionWasManuallyGraded.name]: {
56
- target: "graded",
57
- assign: (_s, e) => ({ verdict: e.verdict }),
58
- },
59
- },
60
- },
61
- },
62
- });
63
- expect(Submission.name).toBe("submission");
64
- expect(Submission.key).toBe("submissionId");
65
- expect(Submission.initial).toBe("submitted");
66
- expect(Submission.states.graded?.final).toBe(true);
67
- expect(Submission.eventIndex.size).toBe(3);
68
- });
69
- it("allows a custom name to override the schema's", () => {
70
- const Renamed = defineActor({
71
- name: "my-submission",
72
- schema: SubmissionData,
73
- });
74
- expect(Renamed.name).toBe("my-submission");
75
- });
76
- it("rejects transitions for states not in the schema", () => {
77
- expect(() => defineActor({
78
- schema: SubmissionData,
79
- states: {
80
- unknown: { on: { [AnswerWasSubmitted.name]: {} } },
81
- },
82
- })).toThrow(/state "unknown" is not declared in schema/);
83
- });
84
- it("rejects on: reactions on final states", () => {
85
- expect(() => defineActor({
86
- schema: SubmissionData,
87
- states: {
88
- graded: { on: { [AnswerWasSubmitted.name]: {} } },
89
- },
90
- })).toThrow(/is final in schema/);
91
- });
92
- it("typed methods are still callable from the actor instance view", () => {
93
- const Submission = defineActor({
94
- schema: SubmissionData,
95
- methods: {
96
- isGraded: (state) => state.verdict !== undefined,
97
- },
98
- });
99
- expect(Submission.methods?.isGraded).toBeTypeOf("function");
100
- });
101
- it("classic positional form still works", () => {
102
- const Legacy = defineActor("legacy", {
103
- schema: z.object({ id: z.string() }),
104
- key: "id",
105
- initial: "open",
106
- states: { open: {}, closed: { final: true } },
107
- });
108
- expect(Legacy.name).toBe("legacy");
109
- expect(Legacy.initial).toBe("open");
110
- });
111
- });
112
- //# sourceMappingURL=actor-schema-bound.test.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"actor-schema-bound.test.js","sourceRoot":"","sources":["../../src/__tests__/actor-schema-bound.test.ts"],"names":[],"mappings":"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"}
@@ -1,8 +0,0 @@
1
- /**
2
- * Per-actor `actor.transition:<name>` and per-workflow `workflow.fire:<name>`
3
- * hooks (A7). Proves both:
4
- * - hooks appear in listHooks() right after registerActor/Workflow
5
- * - chain steps observe transitions / fires during real dispatch
6
- */
7
- export {};
8
- //# sourceMappingURL=actor-workflow-hooks.test.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"actor-workflow-hooks.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/actor-workflow-hooks.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
@@ -1,106 +0,0 @@
1
- /**
2
- * Per-actor `actor.transition:<name>` and per-workflow `workflow.fire:<name>`
3
- * hooks (A7). Proves both:
4
- * - hooks appear in listHooks() right after registerActor/Workflow
5
- * - chain steps observe transitions / fires during real dispatch
6
- */
7
- import { describe, it, expect } from "vitest";
8
- import { z } from "zod";
9
- import { defineEvent } from "@nwire/messages";
10
- import { listHooks } from "@nwire/hooks";
11
- import { createApp, defineAction, defineActor, defineModule, defineWorkflow, eventFactory, } from "../foundation.js";
12
- // ─── Domain ────────────────────────────────────────────────────────
13
- const OrderState = z.object({ orderId: z.string(), total: z.number() });
14
- const Placed = defineEvent({
15
- name: "orders.placed",
16
- schema: z.object({ orderId: z.string(), total: z.number() }),
17
- });
18
- const Confirmed = defineEvent({
19
- name: "orders.confirmed",
20
- schema: z.object({ orderId: z.string() }),
21
- });
22
- const PlacedEvent = eventFactory(Placed);
23
- const ConfirmedEvent = eventFactory(Confirmed);
24
- const Order = defineActor("order", {
25
- schema: OrderState,
26
- key: "orderId",
27
- initial: "draft",
28
- states: {
29
- draft: {
30
- on: { [Placed.name]: { target: "placed", assign: (_, e) => ({ ...e }) } },
31
- },
32
- placed: { on: { [Confirmed.name]: { target: "confirmed" } } },
33
- confirmed: {},
34
- },
35
- });
36
- const placeOrder = defineAction({
37
- name: "orders.place",
38
- schema: z.object({ orderId: z.string(), total: z.number() }),
39
- handler: async (input) => PlacedEvent(input),
40
- });
41
- const confirmOrder = defineAction({
42
- name: "orders.confirm",
43
- schema: z.object({ orderId: z.string() }),
44
- handler: async (input) => ConfirmedEvent({ orderId: input.orderId }),
45
- });
46
- let workflowFiredCount = 0;
47
- const notifyOnPlace = defineWorkflow("notify-on-place", ({ on }) => {
48
- on(Placed, async () => {
49
- workflowFiredCount++;
50
- });
51
- });
52
- const mod = defineModule("orders", {
53
- actors: [Order],
54
- actions: [placeOrder, confirmOrder],
55
- events: [Placed, Confirmed],
56
- workflows: [notifyOnPlace],
57
- });
58
- // ─── Tests ─────────────────────────────────────────────────────────
59
- describe("per-actor + per-workflow hooks", () => {
60
- it("registerActor + registerWorkflow create named hooks visible in listHooks", async () => {
61
- const app = createApp({ appName: "actor-workflow-hooks-list", modules: [mod] });
62
- await app.start();
63
- const names = listHooks().map((h) => h.name);
64
- expect(names).toContain("actor.transition:order");
65
- expect(names).toContain("workflow.fire:notify-on-place");
66
- await app.stop();
67
- });
68
- it("actor.transition hook observes state changes during real dispatch", async () => {
69
- const transitions = [];
70
- const app = createApp({ appName: "actor-transition-test", modules: [mod] });
71
- await app.start();
72
- app.runtime.ensureActorTransitionHook("order").use(async (hctx, next) => {
73
- transitions.push({ from: hctx.fromState, to: hctx.toState });
74
- await next();
75
- }, { name: "observer" });
76
- await app.runtime.dispatch(placeOrder, { orderId: "o1", total: 100 });
77
- expect(transitions).toEqual([{ from: "draft", to: "placed" }]);
78
- await app.runtime.dispatch(confirmOrder, { orderId: "o1" });
79
- expect(transitions).toEqual([
80
- { from: "draft", to: "placed" },
81
- { from: "placed", to: "confirmed" },
82
- ]);
83
- await app.stop();
84
- });
85
- it("workflow.fire hook observes saga invocations", async () => {
86
- const fires = [];
87
- workflowFiredCount = 0;
88
- const app = createApp({ appName: "workflow-fire-test", modules: [mod] });
89
- await app.start();
90
- app.runtime.ensureWorkflowFireHook("notify-on-place").use(async (hctx, next) => {
91
- fires.push({
92
- workflow: hctx.workflow.name,
93
- event: hctx.event.eventName,
94
- correlationKey: hctx.correlationKey,
95
- });
96
- await next();
97
- }, { name: "observer" });
98
- await app.runtime.dispatch(placeOrder, { orderId: "o2", total: 50 });
99
- expect(fires).toHaveLength(1);
100
- expect(fires[0].workflow).toBe("notify-on-place");
101
- expect(fires[0].event).toBe("orders.placed");
102
- expect(workflowFiredCount).toBe(1);
103
- await app.stop();
104
- });
105
- });
106
- //# sourceMappingURL=actor-workflow-hooks.test.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"actor-workflow-hooks.test.js","sourceRoot":"","sources":["../../src/__tests__/actor-workflow-hooks.test.ts"],"names":[],"mappings":"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"}
@@ -1,19 +0,0 @@
1
- /**
2
- * `createApp` registers app capabilities (`execute`, `send`, `useProjection`)
3
- * on the container so handlers in any transport — http, queue, cli —
4
- * can resolve them as plain functions:
5
- *
6
- * const execute = ctx.resolve<ExecuteFn>("execute");
7
- * const result = await execute(myAction, input);
8
- *
9
- * Each capability seeds a fresh envelope. Use cases:
10
- * - HTTP handler dispatching an action from an external request
11
- * - Queue worker processing a job that triggers an action
12
- * - CLI command invoking app behavior
13
- *
14
- * Inside a handler/workflow with an existing envelope, the in-flight
15
- * ctx.request / ctx.send / ctx.query still inherit the parent envelope
16
- * — those are unaffected.
17
- */
18
- export {};
19
- //# sourceMappingURL=app-capabilities.test.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"app-capabilities.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/app-capabilities.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}
@@ -1,57 +0,0 @@
1
- /**
2
- * `createApp` registers app capabilities (`execute`, `send`, `useProjection`)
3
- * on the container so handlers in any transport — http, queue, cli —
4
- * can resolve them as plain functions:
5
- *
6
- * const execute = ctx.resolve<ExecuteFn>("execute");
7
- * const result = await execute(myAction, input);
8
- *
9
- * Each capability seeds a fresh envelope. Use cases:
10
- * - HTTP handler dispatching an action from an external request
11
- * - Queue worker processing a job that triggers an action
12
- * - CLI command invoking app behavior
13
- *
14
- * Inside a handler/workflow with an existing envelope, the in-flight
15
- * ctx.request / ctx.send / ctx.query still inherit the parent envelope
16
- * — those are unaffected.
17
- */
18
- import { describe, it, expect } from "vitest";
19
- import { z } from "zod";
20
- import { defineAction, defineModule, createApp } from "../foundation.js";
21
- describe("createApp app capabilities on container", () => {
22
- it("execute resolves and dispatches an action", async () => {
23
- let sum = 0;
24
- const sumAction = defineAction({
25
- name: "sum",
26
- schema: z.object({ a: z.number(), b: z.number() }),
27
- handler: async (input) => {
28
- sum = input.a + input.b;
29
- return undefined;
30
- },
31
- });
32
- const app = createApp({ modules: [defineModule("m", { actions: [sumAction] })] });
33
- await app.start();
34
- const execute = app.runtime.getContainer().resolve("execute");
35
- await execute(sumAction, { a: 2, b: 3 });
36
- expect(sum).toBe(5);
37
- await app.stop();
38
- });
39
- it("send dispatches fire-and-forget", async () => {
40
- let seen;
41
- const recordAction = defineAction({
42
- name: "record",
43
- schema: z.object({ tag: z.string() }),
44
- handler: async (input) => {
45
- seen = input;
46
- return undefined;
47
- },
48
- });
49
- const app = createApp({ modules: [defineModule("m", { actions: [recordAction] })] });
50
- await app.start();
51
- const send = app.runtime.getContainer().resolve("send");
52
- await send(recordAction, { tag: "hello" });
53
- expect(seen).toEqual({ tag: "hello" });
54
- await app.stop();
55
- });
56
- });
57
- //# sourceMappingURL=app-capabilities.test.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"app-capabilities.test.js","sourceRoot":"","sources":["../../src/__tests__/app-capabilities.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAOtE,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACvD,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,MAAM,SAAS,GAAG,YAAY,CAAC;YAC7B,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YAClD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACvB,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;gBACxB,OAAO,SAAS,CAAC;YACnB,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAClF,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAElB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,OAAO,CAAY,SAAS,CAAC,CAAC;QACzE,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,IAAI,IAAa,CAAC;QAClB,MAAM,YAAY,GAAG,YAAY,CAAC;YAChC,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACvB,IAAI,GAAG,KAAK,CAAC;gBACb,OAAO,SAAS,CAAC;YACnB,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACrF,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAElB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,OAAO,CAAY,MAAM,CAAC,CAAC;QACnE,MAAM,IAAI,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAEvC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -1,6 +0,0 @@
1
- /**
2
- * CLI runner — contract test. Verifies argv parsing → action/query dispatch
3
- * → stdout/stderr capture, with no actual process spawning.
4
- */
5
- export {};
6
- //# sourceMappingURL=cli-runner.test.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"cli-runner.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cli-runner.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}