@seriousgaming/sdk-tools 1.4.0 → 1.6.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 (302) hide show
  1. package/dist/bundling/ui-bundler.d.ts +12 -0
  2. package/dist/cli-25RWY5BQ.js +41 -0
  3. package/dist/cli-272KBNJH.js +97 -0
  4. package/dist/cli-2BH7FX27.js +52 -0
  5. package/dist/cli-2GOFEW26.js +81 -0
  6. package/dist/cli-3E3MD5U4.js +21 -0
  7. package/dist/cli-3HE4AVZG.js +115 -0
  8. package/dist/cli-4AKVLEC4.js +1387 -0
  9. package/dist/cli-4BV45LBH.js +126 -0
  10. package/dist/cli-4LKXZQ2B.js +48 -0
  11. package/dist/cli-4UWFQNGF.js +54 -0
  12. package/dist/cli-4YB3ROVR.js +78 -0
  13. package/dist/cli-57RXC3HQ.js +36 -0
  14. package/dist/cli-5JEGTVTG.js +96 -0
  15. package/dist/cli-6AMT3BUO.js +97 -0
  16. package/dist/cli-6RRVEGFB.js +80 -0
  17. package/dist/cli-6WXLXJVX.js +36 -0
  18. package/dist/cli-7OGYADZ3.js +97 -0
  19. package/dist/cli-AK7OIPWY.js +229 -0
  20. package/dist/cli-B4TN6PJP.js +124 -0
  21. package/dist/cli-B6YHEKIJ.js +248 -0
  22. package/dist/cli-BPYMTOUL.js +89 -0
  23. package/dist/cli-BWX5E7TQ.js +23 -0
  24. package/dist/cli-BYJWFFCF.js +37 -0
  25. package/dist/cli-C3NVCKO6.js +43 -0
  26. package/dist/cli-C47GJATR.js +42 -0
  27. package/dist/cli-C5QOJJWX.js +46 -0
  28. package/dist/cli-C6TH5S7K.js +6417 -0
  29. package/dist/cli-DL2CVMRF.js +89 -0
  30. package/dist/cli-DMW2OQIJ.js +76 -0
  31. package/dist/cli-DZW3XD5F.js +143 -0
  32. package/dist/cli-E2NLWIFE.js +1331 -0
  33. package/dist/cli-E33CJRRQ.js +36 -0
  34. package/dist/cli-E6DJIMYD.js +142 -0
  35. package/dist/cli-EEFJKIGL.js +151 -0
  36. package/dist/cli-EVFS55WN.js +185 -0
  37. package/dist/cli-F2D4GGUA.js +549 -0
  38. package/dist/cli-FBTRTIZJ.js +226 -0
  39. package/dist/cli-FWFRKQNE.js +11 -0
  40. package/dist/cli-FYINNRML.js +760 -0
  41. package/dist/cli-G522CPRL.js +88 -0
  42. package/dist/cli-G6KELFSX.js +2847 -0
  43. package/dist/cli-G6UE5NL4.js +90 -0
  44. package/dist/cli-GBFM76BF.js +16 -0
  45. package/dist/cli-GDQ6ILJY.js +101 -0
  46. package/dist/cli-GFBGYFYD.js +50 -0
  47. package/dist/cli-GGPDQNM3.js +35 -0
  48. package/dist/cli-GTSGLN3Z.js +307 -0
  49. package/dist/cli-GUXKQMJ7.js +13641 -0
  50. package/dist/cli-GXD36NF2.js +60 -0
  51. package/dist/cli-HCRTYQQS.js +16 -0
  52. package/dist/cli-HYY64SUD.js +185 -0
  53. package/dist/cli-I355WTAF.js +463 -0
  54. package/dist/cli-IDKYF5XB.js +59 -0
  55. package/dist/cli-ILKCQNM6.js +8 -0
  56. package/dist/cli-IRZ5KB7D.js +36 -0
  57. package/dist/cli-IUS2YCD3.js +31 -0
  58. package/dist/cli-J4DKUUTK.js +138 -0
  59. package/dist/cli-JFU22EJ2.js +187 -0
  60. package/dist/cli-JMZLT65J.js +226 -0
  61. package/dist/cli-JZM7XTNV.js +89 -0
  62. package/dist/cli-K2B6WHKA.js +81 -0
  63. package/dist/cli-KL3756X6.js +126 -0
  64. package/dist/cli-KNOOKGYW.js +88 -0
  65. package/dist/cli-LFGRFIEO.js +226 -0
  66. package/dist/cli-LFM7GJHI.js +0 -0
  67. package/dist/cli-LMDJCHHD.js +304 -0
  68. package/dist/cli-LXYPE3L5.js +99 -0
  69. package/dist/cli-M6BCQRID.js +153 -0
  70. package/dist/cli-MBNMPVDC.js +367 -0
  71. package/dist/cli-MJUYJIEP.js +13 -0
  72. package/dist/cli-MMN4BPO4.js +145 -0
  73. package/dist/cli-MYJGMA6U.js +40 -0
  74. package/dist/cli-N6H6T2E2.js +616 -0
  75. package/dist/cli-O5KP4OVN.js +61 -0
  76. package/dist/cli-O6PWMJTZ.js +25 -0
  77. package/dist/cli-ORIG557O.js +141 -0
  78. package/dist/cli-PFFCNGHI.js +243 -0
  79. package/dist/cli-PNLYX6R6.js +131 -0
  80. package/dist/cli-PQBXVLEU.js +649 -0
  81. package/dist/cli-PTT5RGKO.js +62 -0
  82. package/dist/cli-Q2XJF5AS.js +127 -0
  83. package/dist/cli-QEVDDBNO.js +60 -0
  84. package/dist/cli-QEVE5HUM.js +167 -0
  85. package/dist/cli-QUIJCBYB.js +391 -0
  86. package/dist/cli-QUNIRH7A.js +57 -0
  87. package/dist/cli-QVASWX2A.js +187 -0
  88. package/dist/cli-QWQMPCL6.js +253 -0
  89. package/dist/cli-R4PCG5YX.js +131 -0
  90. package/dist/cli-RA673NGF.js +53 -0
  91. package/dist/cli-RN6IWTL2.js +36 -0
  92. package/dist/cli-ROT3DRKU.js +145 -0
  93. package/dist/cli-RZITKPJX.js +367 -0
  94. package/dist/cli-S5IVGDDD.js +32 -0
  95. package/dist/cli-S5QDONIQ.js +218 -0
  96. package/dist/cli-SIPDUBFL.js +36 -0
  97. package/dist/cli-SMFSZF2G.js +4009 -0
  98. package/dist/cli-SRHBXZCN.js +159 -0
  99. package/dist/cli-TCY5LJ7E.js +88 -0
  100. package/dist/cli-TDSQSCX4.js +131 -0
  101. package/dist/cli-TIDQ4WUE.js +257 -0
  102. package/dist/cli-TLLA6KAP.js +79 -0
  103. package/dist/cli-TPU4TUR6.js +132 -0
  104. package/dist/cli-U2UE7I7J.js +30 -0
  105. package/dist/cli-UELGBQG7.js +101 -0
  106. package/dist/cli-UHSZBKYO.js +97 -0
  107. package/dist/cli-UJ4UCL2Z.js +38 -0
  108. package/dist/cli-UKQYZYFK.js +31 -0
  109. package/dist/cli-UMFFURZ7.js +81 -0
  110. package/dist/cli-UNAJ2OTE.js +15 -0
  111. package/dist/cli-UNJ5X6BU.js +89 -0
  112. package/dist/cli-UTJU4IYG.js +117 -0
  113. package/dist/cli-V4GHRWOV.js +1837 -0
  114. package/dist/cli-VCI3CG36.js +73 -0
  115. package/dist/cli-VCKOC2EV.js +256 -0
  116. package/dist/cli-VL2P354N.js +46 -0
  117. package/dist/cli-WAE26SVW.js +72 -0
  118. package/dist/cli-WOGIAU2E.js +100 -0
  119. package/dist/cli-WU43JT4T.js +52 -0
  120. package/dist/cli-XCO2VQOH.js +122 -0
  121. package/dist/cli-XSVGKI3R.js +39 -0
  122. package/dist/cli-YOTGR3NB.js +82 -0
  123. package/dist/cli-YVVXUD2G.js +197 -0
  124. package/dist/cli-ZISJ36MM.js +89 -0
  125. package/dist/cli-ZTWOE3ZT.js +65 -0
  126. package/dist/cli-ZVSFYDPQ.js +205 -0
  127. package/dist/cli-ZWPYIXNI.js +68 -0
  128. package/dist/cli.js +171 -42385
  129. package/dist/client/build-surfaces.d.ts +33 -0
  130. package/dist/client/dev-server.d.ts +6 -0
  131. package/dist/client/index.d.ts +1 -0
  132. package/dist/client/playwright.d.ts +62 -0
  133. package/dist/client.js +339 -56
  134. package/dist/core/session.d.ts +15 -1
  135. package/dist/dev/console/assets/{index-BvB-LFQZ.js → index-CuMOOH9m.js} +21 -21
  136. package/dist/dev/console/index.html +1 -1
  137. package/dist/dev/public-origins.d.ts +61 -0
  138. package/dist/dev/shell.d.ts +51 -4
  139. package/dist/dev/surfaces.d.ts +7 -0
  140. package/dist/docs/ai-agents.md +5 -0
  141. package/dist/docs/api/index.md +14 -12
  142. package/dist/docs/api/sdk-tools-client.md +29 -0
  143. package/dist/docs/api/sdk-tools-playwright.md +104 -0
  144. package/dist/docs/changelog-0.x.md +2 -2
  145. package/dist/docs/changelog.md +56 -4
  146. package/dist/docs/cli-and-dev-server.md +79 -0
  147. package/dist/docs/cli-error-codes.md +39 -36
  148. package/dist/docs/cli-reference.md +93 -32
  149. package/dist/docs/environment-variables.md +16 -5
  150. package/dist/docs/guides/ai-facilitation.md +2 -0
  151. package/dist/docs/guides/capabilities.md +2 -0
  152. package/dist/docs/guides/designing-a-game.md +31 -4
  153. package/dist/docs/guides/designing-screens.md +133 -0
  154. package/dist/docs/guides/endpoints.md +2 -0
  155. package/dist/docs/guides/engine-testing.md +5 -1
  156. package/dist/docs/guides/engine.md +2 -0
  157. package/dist/docs/guides/file-handling.md +3 -1
  158. package/dist/docs/guides/games.md +3 -1
  159. package/dist/docs/guides/global-settings.md +2 -0
  160. package/dist/docs/guides/guide.md +2 -0
  161. package/dist/docs/guides/hooks.md +2 -0
  162. package/dist/docs/guides/index.md +9 -0
  163. package/dist/docs/guides/internationalization.md +2 -0
  164. package/dist/docs/guides/llm-integration.md +4 -2
  165. package/dist/docs/guides/multi-team-games.md +3 -1
  166. package/dist/docs/guides/patterns.md +2 -0
  167. package/dist/docs/guides/presentation.md +1 -1
  168. package/dist/docs/guides/production-constraints.md +2 -0
  169. package/dist/docs/guides/scenario-editor.md +2 -0
  170. package/dist/docs/guides/scenarios.md +6 -2
  171. package/dist/docs/guides/session-game-flow.md +365 -0
  172. package/dist/docs/guides/session-hooks.md +205 -0
  173. package/dist/docs/guides/session.md +27 -565
  174. package/dist/docs/guides/settings.md +2 -0
  175. package/dist/docs/guides/setup.md +3 -1
  176. package/dist/docs/guides/speech-generation.md +2 -0
  177. package/dist/docs/guides/starter-game.md +63 -23
  178. package/dist/docs/guides/testing.md +35 -18
  179. package/dist/docs/guides/tick-controller.md +3 -1
  180. package/dist/docs/guides/type-safety.md +2 -0
  181. package/dist/docs/guides/ui-files-and-llms.md +328 -0
  182. package/dist/docs/guides/ui-participants.md +281 -0
  183. package/dist/docs/guides/ui-styling.md +263 -0
  184. package/dist/docs/guides/ui-ticks.md +247 -0
  185. package/dist/docs/guides/ui.md +11 -1092
  186. package/dist/docs/guides/upgrading.md +2 -0
  187. package/dist/docs/guides/validators.md +2 -0
  188. package/dist/docs/guides/waiting-room.md +1 -1
  189. package/dist/docs/index.md +2 -1
  190. package/dist/docs/page-index.md +146 -0
  191. package/dist/docs/recipes/adapt-a-game-for-walkthroughs.md +1 -1
  192. package/dist/docs/recipes/adapt-ui-for-observers.md +1 -1
  193. package/dist/docs/recipes/create-presentation.md +11 -0
  194. package/dist/docs/recipes/create-scenario-editor.md +1 -0
  195. package/dist/docs/recipes/create-session-ui.md +2 -1
  196. package/dist/docs/recipes/create-setup.md +1 -0
  197. package/dist/docs/recipes/create-user-interface.md +1 -0
  198. package/dist/docs/recipes/create-waiting-room-ui.md +1 -0
  199. package/dist/docs/recipes/design-state-for-concurrent-writes.md +1 -1
  200. package/dist/docs/recipes/e2e-testing.md +19 -20
  201. package/dist/docs/recipes/fix-duplicate-packages.md +2 -2
  202. package/dist/docs/recipes/index.md +3 -0
  203. package/dist/docs/recipes/screenshot-a-surface.md +80 -0
  204. package/dist/docs/recipes/test-a-multi-role-game.md +1 -1
  205. package/dist/docs/recipes/use-request-tick.md +2 -2
  206. package/dist/execution/config-resolver.d.ts +4 -1
  207. package/dist/playwright.js +32232 -0
  208. package/dist/runtime/manifest-version.d.ts +1 -1
  209. package/dist/runtime.js +1 -1
  210. package/dist/templates/package/CLAUDE.md.template +14 -5
  211. package/dist/templates/package/DESIGN.md.liquid +39 -7
  212. package/dist/templates/package/README.md.liquid +1 -1
  213. package/dist/templates/package/claude/rules/workflow-create-user-interface.md +1 -1
  214. package/dist/templates/package/claude/rules/workflow-test-engine-or-ui.md +1 -1
  215. package/dist/templates/package/global-setup.ts.template +7 -18
  216. package/dist/templates/package/playwright.config.ts.liquid +8 -11
  217. package/dist/templates/package/pnpm-workspace.yaml.template +13 -0
  218. package/dist/templates/starter-game/capabilities/pacing/capability.sdk.json +18 -0
  219. package/dist/templates/starter-game/package.json +2 -0
  220. package/dist/templates/starter-game/playwright.config.ts +8 -11
  221. package/dist/templates/starter-game/presentation/defaults.ts +52 -0
  222. package/dist/templates/starter-game/presentation/index.html +20 -0
  223. package/dist/templates/starter-game/presentation/presentation.sdk.json +10 -0
  224. package/dist/templates/starter-game/presentation/src/App.tsx +55 -0
  225. package/dist/templates/starter-game/presentation/src/Band.tsx +40 -0
  226. package/dist/templates/starter-game/presentation/src/Slides.tsx +415 -0
  227. package/dist/templates/starter-game/presentation/src/WeatherIcon.tsx +21 -0
  228. package/dist/templates/starter-game/presentation/src/i18n.ts +88 -0
  229. package/dist/templates/starter-game/presentation/src/main.tsx +15 -0
  230. package/dist/templates/starter-game/presentation/src/stalls.test.ts +196 -0
  231. package/dist/templates/starter-game/presentation/src/stalls.ts +199 -0
  232. package/dist/templates/starter-game/presentation/types.ts +94 -0
  233. package/dist/templates/starter-game/seriousgaming.sdk.json +2 -1
  234. package/dist/templates/starter-game/session/defaults.ts +6 -0
  235. package/dist/templates/starter-game/session/index.html +1 -1
  236. package/dist/templates/starter-game/session/session.sdk.json +2 -2
  237. package/dist/templates/starter-game/session/src/App.test.tsx +436 -115
  238. package/dist/templates/starter-game/session/src/App.tsx +372 -222
  239. package/dist/templates/starter-game/session/src/JoinCodes.tsx +184 -0
  240. package/dist/templates/starter-game/session/src/ManagePanel.tsx +188 -0
  241. package/dist/templates/starter-game/session/src/Results.tsx +340 -0
  242. package/dist/templates/starter-game/session/src/SessionBar.tsx +179 -0
  243. package/dist/templates/starter-game/session/src/SessionPanels.tsx +105 -0
  244. package/dist/templates/starter-game/session/src/SidePanel.tsx +89 -0
  245. package/dist/templates/starter-game/session/src/StallCard.tsx +253 -0
  246. package/dist/templates/starter-game/session/src/TopBar.tsx +36 -0
  247. package/dist/templates/starter-game/session/src/i18n.ts +91 -24
  248. package/dist/templates/starter-game/session/src/status.ts +28 -0
  249. package/dist/templates/starter-game/session/types.ts +8 -2
  250. package/dist/templates/starter-game/shared/Awning.tsx +31 -0
  251. package/dist/templates/starter-game/shared/HostLogo.test.tsx +38 -0
  252. package/dist/templates/starter-game/shared/HostLogo.tsx +48 -0
  253. package/dist/templates/starter-game/shared/StallIcons.tsx +83 -0
  254. package/dist/templates/starter-game/shared/days.ts +11 -0
  255. package/dist/templates/starter-game/shared/format.test.ts +13 -0
  256. package/dist/templates/starter-game/{ui/src → shared}/format.ts +1 -1
  257. package/dist/templates/starter-game/testing/e2e/game.spec.ts +43 -9
  258. package/dist/templates/starter-game/testing/e2e/global-setup.ts +7 -18
  259. package/dist/templates/starter-game/ui/defaults.ts +3 -0
  260. package/dist/templates/starter-game/ui/src/App.test.tsx +197 -29
  261. package/dist/templates/starter-game/ui/src/App.tsx +176 -99
  262. package/dist/templates/starter-game/ui/src/DayBar.test.tsx +50 -7
  263. package/dist/templates/starter-game/ui/src/DayBar.tsx +96 -38
  264. package/dist/templates/starter-game/ui/src/DaysTable.tsx +69 -0
  265. package/dist/templates/starter-game/ui/src/FirstDay.tsx +37 -0
  266. package/dist/templates/starter-game/ui/src/Header.tsx +257 -0
  267. package/dist/templates/starter-game/ui/src/Lesson.tsx +63 -0
  268. package/dist/templates/starter-game/ui/src/MakeRow.tsx +98 -71
  269. package/dist/templates/starter-game/ui/src/Notices.tsx +59 -0
  270. package/dist/templates/starter-game/ui/src/PastDay.tsx +88 -0
  271. package/dist/templates/starter-game/ui/src/Section.tsx +26 -26
  272. package/dist/templates/starter-game/ui/src/ThemeToggle.tsx +25 -11
  273. package/dist/templates/starter-game/ui/src/TodayPanel.test.tsx +37 -33
  274. package/dist/templates/starter-game/ui/src/TodayPanel.tsx +66 -52
  275. package/dist/templates/starter-game/ui/src/WeatherCard.tsx +47 -0
  276. package/dist/templates/starter-game/ui/src/WeekOver.tsx +145 -0
  277. package/dist/templates/starter-game/ui/src/YesterdayPanel.tsx +65 -114
  278. package/dist/templates/starter-game/ui/src/days.ts +58 -0
  279. package/dist/templates/starter-game/ui/src/i18n.ts +86 -32
  280. package/dist/templates/starter-game/ui/src/test-helpers.ts +1 -0
  281. package/dist/templates/starter-game/ui/src/theme.ts +8 -8
  282. package/dist/templates/starter-game/ui/types.ts +6 -0
  283. package/dist/templates/starter-game/ui/ui.sdk.json +1 -1
  284. package/dist/templates/starter-game/validators/daylimit/defaults.ts +13 -0
  285. package/dist/templates/starter-game/validators/daylimit/logic/logic.test.ts +20 -0
  286. package/dist/templates/starter-game/validators/daylimit/logic/logic.ts +23 -0
  287. package/dist/templates/starter-game/validators/daylimit/types.ts +23 -0
  288. package/dist/templates/starter-game/validators/daylimit/validator.sdk.json +10 -0
  289. package/dist/templates/starter-game/waiting_room/src/App.test.tsx +83 -5
  290. package/dist/templates/starter-game/waiting_room/src/App.tsx +262 -119
  291. package/dist/templates/starter-game/waiting_room/src/i18n.ts +8 -4
  292. package/dist/utils/error-codes.d.ts +12 -0
  293. package/dist/utils/prompt.d.ts +5 -5
  294. package/dist/utils/resource-scan.d.ts +39 -0
  295. package/package.json +15 -4
  296. package/dist/templates/starter-game/session/src/Section.tsx +0 -37
  297. package/dist/templates/starter-game/session/src/TeamDoor.tsx +0 -96
  298. package/dist/templates/starter-game/session/src/format.ts +0 -8
  299. package/dist/templates/starter-game/ui/src/HistoryPanel.test.tsx +0 -74
  300. package/dist/templates/starter-game/ui/src/HistoryPanel.tsx +0 -120
  301. package/dist/templates/starter-game/ui/src/HostLogo.test.tsx +0 -25
  302. package/dist/templates/starter-game/ui/src/HostLogo.tsx +0 -38
@@ -0,0 +1,97 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ resolvePatchedDefinition
4
+ } from "./cli-UJ4UCL2Z.js";
5
+ import "./cli-S5IVGDDD.js";
6
+ import {
7
+ readAuthoredBundle
8
+ } from "./cli-YVVXUD2G.js";
9
+ import {
10
+ resolveInputSource
11
+ } from "./cli-4UWFQNGF.js";
12
+ import {
13
+ updateTickControllerFiles
14
+ } from "./cli-FYINNRML.js";
15
+ import "./cli-IUS2YCD3.js";
16
+ import "./cli-QUNIRH7A.js";
17
+ import "./cli-BYJWFFCF.js";
18
+ import {
19
+ loadPackageContext
20
+ } from "./cli-XSVGKI3R.js";
21
+ import "./cli-MBNMPVDC.js";
22
+ import "./cli-GFBGYFYD.js";
23
+ import {
24
+ operationError,
25
+ printOperationResult,
26
+ regenerateTypes
27
+ } from "./cli-UELGBQG7.js";
28
+ import "./cli-4BV45LBH.js";
29
+ import "./cli-4AKVLEC4.js";
30
+ import "./cli-VCKOC2EV.js";
31
+ import "./cli-E2NLWIFE.js";
32
+ import "./cli-25RWY5BQ.js";
33
+ import "./cli-QWQMPCL6.js";
34
+ import {
35
+ validateSDKTickController
36
+ } from "./cli-SMFSZF2G.js";
37
+ import "./cli-F2D4GGUA.js";
38
+ import {
39
+ logger
40
+ } from "./cli-4YB3ROVR.js";
41
+ import {
42
+ CliError
43
+ } from "./cli-N6H6T2E2.js";
44
+
45
+ // cli/commands/resources/tick-controller/update.ts
46
+ async function updateTickController(definitionInput, options) {
47
+ logger.info("\nUpdating tick controller...\n");
48
+ const identifier = "tick_controller";
49
+ loadPackageContext(options.workingDir);
50
+ let jsonDefinition = null;
51
+ if (options.patch) {
52
+ jsonDefinition = resolvePatchedDefinition({
53
+ patch: options.patch,
54
+ workingDir: options.workingDir,
55
+ type: "tick_controller",
56
+ identifier,
57
+ resourceLabel: "Tick controller"
58
+ });
59
+ } else {
60
+ const inputSource = await resolveInputSource(definitionInput, options.file);
61
+ if (inputSource.kind === "json") jsonDefinition = inputSource.json;
62
+ }
63
+ if (jsonDefinition) {
64
+ const tcInput = readAuthoredBundle({
65
+ json: jsonDefinition,
66
+ type: "tick_controller",
67
+ command: "update",
68
+ validate: validateSDKTickController,
69
+ identifier
70
+ });
71
+ logger.info("Updating tick controller files...\n");
72
+ const result = updateTickControllerFiles({
73
+ packagePath: options.workingDir,
74
+ oldIdentifier: identifier,
75
+ newDefinition: tcInput.definition
76
+ });
77
+ if (!result.success) {
78
+ throw operationError(result, "Failed to update tick controller files");
79
+ }
80
+ logger.success("Tick controller updated successfully!");
81
+ printOperationResult(result);
82
+ await regenerateTypes(options.workingDir);
83
+ return;
84
+ }
85
+ throw new CliError(
86
+ "USAGE_MISSING_INPUT",
87
+ `A tick controller takes no interactive input: a game holds one, so there is
88
+ nothing to name and nothing to pick.
89
+
90
+ Edit it with a definition or a patch:
91
+ $ seriousgaming-sdk update tick-controller '{"definition":{...}}'
92
+ $ seriousgaming-sdk update tick-controller --patch '[...]'`
93
+ );
94
+ }
95
+ export {
96
+ updateTickController
97
+ };
@@ -0,0 +1,229 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ loadResourceIdentifiers
4
+ } from "./cli-GGPDQNM3.js";
5
+ import {
6
+ resolvePatchedDefinition
7
+ } from "./cli-UJ4UCL2Z.js";
8
+ import {
9
+ readAuthoredBundle
10
+ } from "./cli-YVVXUD2G.js";
11
+ import {
12
+ resolveInputSource
13
+ } from "./cli-4UWFQNGF.js";
14
+ import {
15
+ createSettingsEditorFiles,
16
+ deleteSettingsEditorFiles,
17
+ findSettingsEditorReferences,
18
+ updateSettingsEditorFiles
19
+ } from "./cli-FYINNRML.js";
20
+ import {
21
+ loadPackageContext
22
+ } from "./cli-XSVGKI3R.js";
23
+ import {
24
+ BUILD_COMMAND,
25
+ generateTypes,
26
+ operationError,
27
+ printOperationResult,
28
+ recordOperationResult,
29
+ regenerateTypes
30
+ } from "./cli-UELGBQG7.js";
31
+ import {
32
+ checkbox,
33
+ confirmAction
34
+ } from "./cli-ZTWOE3ZT.js";
35
+ import {
36
+ generateCommand
37
+ } from "./cli-4BV45LBH.js";
38
+ import {
39
+ getResourceMeta,
40
+ validateSDKScenarioEditor,
41
+ validateSDKSetup
42
+ } from "./cli-SMFSZF2G.js";
43
+ import {
44
+ resourceExample
45
+ } from "./cli-F2D4GGUA.js";
46
+ import {
47
+ logger
48
+ } from "./cli-4YB3ROVR.js";
49
+ import {
50
+ CliError
51
+ } from "./cli-N6H6T2E2.js";
52
+
53
+ // cli/commands/resources/shared/settings-editor.ts
54
+ var VALIDATORS = {
55
+ setup: validateSDKSetup,
56
+ scenario_editor: validateSDKScenarioEditor
57
+ };
58
+ var TITLES = {
59
+ setup: "Setup",
60
+ scenario_editor: "Scenario editor"
61
+ };
62
+ function noun(slot) {
63
+ return getResourceMeta(slot).label.toLowerCase();
64
+ }
65
+ async function createSettingsEditor(slot, definitionInput, options) {
66
+ const label = noun(slot);
67
+ logger.info(`
68
+ Creating the ${label}...
69
+ `);
70
+ loadPackageContext(options.workingDir, { suggestNewPackage: true });
71
+ const inputSource = await resolveInputSource(definitionInput, options.file);
72
+ let configures;
73
+ let endpoints;
74
+ if (inputSource.kind === "json") {
75
+ const bundle = readAuthoredBundle({
76
+ json: inputSource.json,
77
+ type: slot,
78
+ command: "new",
79
+ validate: VALIDATORS[slot]
80
+ });
81
+ configures = bundle.definition.configures ?? [];
82
+ endpoints = bundle.definition.endpoints ?? [];
83
+ } else {
84
+ logger.info("No JSON definition provided. Starting interactive mode...\n");
85
+ const available = loadResourceIdentifiers(options.workingDir, "settings");
86
+ configures = [];
87
+ endpoints = [];
88
+ if (available.length > 0) {
89
+ logger.info(`Select the settings the ${label} will edit.
90
+ `);
91
+ configures.push(
92
+ ...await checkbox({
93
+ message: "Settings to edit:",
94
+ choices: available.map((id) => ({ name: id, value: id })),
95
+ pageSize: 10
96
+ })
97
+ );
98
+ logger.info("");
99
+ } else {
100
+ logger.info("No settings resources found in this package.");
101
+ logger.info('You can add one using "seriousgaming-sdk new settings".\n');
102
+ }
103
+ }
104
+ logger.info(`Creating ${label} files...
105
+ `);
106
+ const result = await createSettingsEditorFiles({
107
+ packagePath: options.workingDir,
108
+ slot,
109
+ name: TITLES[slot],
110
+ configures,
111
+ endpoints
112
+ });
113
+ if (!result.success) {
114
+ throw operationError(result, `Failed to create ${label} files`);
115
+ }
116
+ logger.success(`${TITLES[slot]} created successfully!`);
117
+ printOperationResult(result);
118
+ await generateTypes(options.workingDir);
119
+ logger.info("Next steps:");
120
+ logger.info(` 1. Edit the screen: ${slot}/src/App.tsx`);
121
+ logger.info(` 2. Run "${BUILD_COMMAND}" to build your package`);
122
+ }
123
+ async function updateSettingsEditor(slot, definitionInput, options) {
124
+ const label = noun(slot);
125
+ logger.info(`
126
+ Updating the ${label}...
127
+ `);
128
+ const identifier = slot;
129
+ loadPackageContext(options.workingDir);
130
+ let jsonDefinition = null;
131
+ if (options.patch) {
132
+ jsonDefinition = resolvePatchedDefinition({
133
+ patch: options.patch,
134
+ workingDir: options.workingDir,
135
+ type: slot,
136
+ identifier,
137
+ resourceLabel: getResourceMeta(slot).label
138
+ });
139
+ } else {
140
+ const inputSource = await resolveInputSource(definitionInput, options.file);
141
+ if (inputSource.kind === "json") jsonDefinition = inputSource.json;
142
+ }
143
+ if (!jsonDefinition) {
144
+ throw new CliError(
145
+ "USAGE_MISSING_INPUT",
146
+ `The ${label} takes no interactive input: a game holds one, so there is nothing
147
+ to name and nothing to pick.
148
+
149
+ Edit it with a definition or a patch.
150
+
151
+ Expected format:
152
+ ${resourceExample(slot, "update")}`
153
+ );
154
+ }
155
+ const bundle = readAuthoredBundle({
156
+ json: jsonDefinition,
157
+ type: slot,
158
+ command: "update",
159
+ validate: VALIDATORS[slot],
160
+ identifier
161
+ });
162
+ logger.info(`Updating ${label} files...
163
+ `);
164
+ const result = updateSettingsEditorFiles(slot, {
165
+ packagePath: options.workingDir,
166
+ oldIdentifier: identifier,
167
+ newDefinition: bundle.definition
168
+ });
169
+ if (!result.success) {
170
+ throw operationError(result, `Failed to update ${label} files`);
171
+ }
172
+ logger.success(`${TITLES[slot]} updated successfully!`);
173
+ printOperationResult(result);
174
+ await regenerateTypes(options.workingDir);
175
+ }
176
+ async function deleteSettingsEditor(slot, options) {
177
+ const label = noun(slot);
178
+ logger.info(`
179
+ Deleting the ${label}...
180
+ `);
181
+ const identifier = slot;
182
+ loadPackageContext(options.workingDir);
183
+ const references = findSettingsEditorReferences(slot, {
184
+ packagePath: options.workingDir,
185
+ identifier
186
+ });
187
+ if (references.length > 0) {
188
+ logger.info(`
189
+ The ${label} is referenced by:`);
190
+ for (const ref of references) logger.info(` - ${ref}`);
191
+ logger.info("\nThese references will be removed.");
192
+ }
193
+ const confirmed = await confirmAction(
194
+ { message: `Are you sure you want to delete the ${label}?` },
195
+ options.yes
196
+ );
197
+ if (!confirmed) {
198
+ logger.info("\nDeletion cancelled.\n");
199
+ return;
200
+ }
201
+ logger.info("");
202
+ const result = deleteSettingsEditorFiles(slot, {
203
+ packagePath: options.workingDir,
204
+ identifier
205
+ });
206
+ if (!result.success) {
207
+ throw operationError(result, `Failed to delete ${label} files`);
208
+ }
209
+ recordOperationResult(result);
210
+ for (const file of result.filesDeleted || []) logger.info(` \u2713 Deleted: ${file}`);
211
+ for (const ref of result.referencesRemoved || []) {
212
+ logger.info(` \u2713 Removed reference from: ${ref}`);
213
+ }
214
+ logger.info("\nRegenerating TypeScript types...\n");
215
+ try {
216
+ await generateCommand({ workingDir: options.workingDir });
217
+ logger.success("TypeScript types regenerated successfully!");
218
+ } catch (error) {
219
+ logger.warn("\nWarning: Failed to regenerate TypeScript types:");
220
+ logger.warn(error instanceof Error ? error.message : "Unknown error");
221
+ }
222
+ logger.success(`${TITLES[slot]} deleted successfully!`);
223
+ }
224
+
225
+ export {
226
+ createSettingsEditor,
227
+ updateSettingsEditor,
228
+ deleteSettingsEditor
229
+ };
@@ -0,0 +1,124 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ resolveSession
4
+ } from "./cli-GTSGLN3Z.js";
5
+ import {
6
+ emit,
7
+ participantsFromArgument,
8
+ raiseIfRefused,
9
+ requireScenario,
10
+ sessionSummary,
11
+ teamCountFromFlag,
12
+ teamIndexFromArgument,
13
+ tickReport
14
+ } from "./cli-PFFCNGHI.js";
15
+ import {
16
+ applyJsonPatch
17
+ } from "./cli-S5IVGDDD.js";
18
+ import {
19
+ CliError
20
+ } from "./cli-N6H6T2E2.js";
21
+
22
+ // cli/commands/tick.ts
23
+ import dotenv from "dotenv";
24
+ dotenv.config({ path: ".env", debug: false, quiet: true });
25
+ async function tickCommand(options) {
26
+ const session = await resolveSession({
27
+ packagePath: options.workingDir,
28
+ ...options.walkthrough ? { runKind: "walkthrough" } : {},
29
+ ...options.server === false ? { noServer: true } : {},
30
+ ...options.teams === void 0 ? {} : { teams: teamCountFromFlag(options.teams) },
31
+ ...options.participants === void 0 ? {} : { participants: participantsFromArgument(options.participants) },
32
+ ...options.scenario === void 0 ? {} : { scenarioId: requireScenario(options.workingDir, options.scenario) },
33
+ ...options.locale === void 0 ? {} : { locale: options.locale }
34
+ });
35
+ try {
36
+ let state = await session.state();
37
+ const teamIndex = teamIndexFromArgument(state, options.team);
38
+ if (options.team !== void 0 && state.teams.length <= 1) {
39
+ throw new CliError(
40
+ "USAGE_NOT_APPLICABLE",
41
+ "--team can only be used with multi-team games (started with --teams N)"
42
+ );
43
+ }
44
+ if (options.patch && state.teams.length > 1 && teamIndex === void 0) {
45
+ throw new CliError(
46
+ "USAGE_MISSING_ARGUMENT",
47
+ "--team is required when using --patch with a multi-team game"
48
+ );
49
+ }
50
+ if (options.patch) {
51
+ await submitPatch(session, state, options.patch, teamIndex);
52
+ }
53
+ const result = await session.send({
54
+ type: "tick",
55
+ ...teamIndex === void 0 ? {} : { teamIndex }
56
+ });
57
+ raiseIfRefused(result);
58
+ state = await session.state();
59
+ if (state.session.complete) {
60
+ console.error("Game complete after this tick \u2014 no further ticks will be allowed");
61
+ }
62
+ emit(options.summary ? sessionSummary(state) : tickReport(state));
63
+ } finally {
64
+ await session.close();
65
+ }
66
+ }
67
+ async function submitSharedPatch(session, state, patch) {
68
+ let operations;
69
+ try {
70
+ operations = JSON.parse(patch);
71
+ } catch (error) {
72
+ throw new CliError("INPUT_INVALID", `Failed to apply patch: ${error.message}`);
73
+ }
74
+ if (operations.some((operation) => operation.op === "remove")) {
75
+ throw new CliError(
76
+ "INPUT_INVALID",
77
+ "A shared write merges into the store, so it cannot remove a value. Replace it instead"
78
+ );
79
+ }
80
+ let patched;
81
+ try {
82
+ patched = applyJsonPatch(state.shared, operations);
83
+ } catch (error) {
84
+ throw new CliError("INPUT_INVALID", `Failed to apply patch: ${error.message}`);
85
+ }
86
+ const touched = new Set(
87
+ operations.map(
88
+ (operation) => (operation.path.split("/")[1] ?? "").replace(/~1/g, "/").replace(/~0/g, "~")
89
+ )
90
+ );
91
+ const payload = Object.fromEntries(
92
+ [...touched].filter((id) => id in patched).map((id) => [id, patched[id]])
93
+ );
94
+ raiseIfRefused(await session.send({ type: "updateSharedContext", payload }));
95
+ }
96
+ async function submitPatch(session, state, patch, teamIndex) {
97
+ let operations;
98
+ try {
99
+ operations = JSON.parse(patch);
100
+ } catch (error) {
101
+ throw new CliError("INPUT_INVALID", `Failed to apply patch: ${error.message}`);
102
+ }
103
+ const team = teamIndex === void 0 ? [...state.teams].sort((a, b) => a.index - b.index)[0] : state.teams.find((candidate) => candidate.index === teamIndex);
104
+ let payload;
105
+ try {
106
+ payload = applyJsonPatch(team?.context ?? {}, operations);
107
+ } catch (error) {
108
+ throw new CliError("INPUT_INVALID", `Failed to apply patch: ${error.message}`);
109
+ }
110
+ const deletes = operations.filter((operation) => operation.op === "remove").map((operation) => operation.path.split("/").filter((segment) => segment.length > 0));
111
+ const result = await session.send({
112
+ type: "updateContext",
113
+ payload,
114
+ ...deletes.length === 0 ? {} : { deletes },
115
+ ...teamIndex === void 0 ? {} : { teamIndex }
116
+ });
117
+ raiseIfRefused(result);
118
+ }
119
+
120
+ export {
121
+ tickCommand,
122
+ submitSharedPatch,
123
+ submitPatch
124
+ };
@@ -0,0 +1,248 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ bundlePackage
4
+ } from "./cli-J4DKUUTK.js";
5
+ import {
6
+ loadEnvironmentConfig
7
+ } from "./cli-TDSQSCX4.js";
8
+ import "./cli-MMN4BPO4.js";
9
+ import {
10
+ DEFAULT_PLATFORM_HOST,
11
+ formatPlatformErrors,
12
+ normalisePlatformHost
13
+ } from "./cli-25RWY5BQ.js";
14
+ import {
15
+ logger
16
+ } from "./cli-4YB3ROVR.js";
17
+ import {
18
+ CliError,
19
+ reportResult
20
+ } from "./cli-N6H6T2E2.js";
21
+
22
+ // cli/commands/package-publish.ts
23
+ import { existsSync, readFileSync, statSync } from "fs";
24
+ import { readFile } from "fs/promises";
25
+ import { join, resolve } from "path";
26
+ function buildApiPath(publisherSlug) {
27
+ return `/api/v0/admin/publishers/${encodeURIComponent(publisherSlug)}/packages`;
28
+ }
29
+ function readSdkConfig(workingDir) {
30
+ const sdkPath = resolve(workingDir, "seriousgaming.sdk.json");
31
+ if (!existsSync(sdkPath)) {
32
+ throw new CliError(
33
+ "MANIFEST_NOT_FOUND",
34
+ `seriousgaming.sdk.json not found at ${sdkPath}. Run this command in a Serious Gaming package directory.`
35
+ );
36
+ }
37
+ let raw;
38
+ try {
39
+ raw = readFileSync(sdkPath, "utf-8");
40
+ } catch (error) {
41
+ const message = error instanceof Error ? error.message : String(error);
42
+ throw new CliError("MANIFEST_INVALID", `Failed to read ${sdkPath}: ${message}`);
43
+ }
44
+ let parsed;
45
+ try {
46
+ parsed = JSON.parse(raw);
47
+ } catch (error) {
48
+ const message = error instanceof Error ? error.message : String(error);
49
+ throw new CliError("MANIFEST_INVALID", `Failed to parse ${sdkPath}: ${message}`);
50
+ }
51
+ const identifier = parsed.identifier;
52
+ if (typeof identifier !== "string" || identifier === "") {
53
+ throw new CliError(
54
+ "MANIFEST_INVALID",
55
+ `seriousgaming.sdk.json at ${sdkPath} is missing its identifier.`
56
+ );
57
+ }
58
+ const packageJsonPath = resolve(workingDir, "package.json");
59
+ if (!existsSync(packageJsonPath)) {
60
+ throw new CliError(
61
+ "MANIFEST_NOT_FOUND",
62
+ `package.json not found at ${packageJsonPath}. Publishing needs a version, and package.json is where it lives.`
63
+ );
64
+ }
65
+ let version;
66
+ try {
67
+ version = JSON.parse(readFileSync(packageJsonPath, "utf-8")).version;
68
+ } catch (error) {
69
+ const message = error instanceof Error ? error.message : String(error);
70
+ throw new CliError("MANIFEST_INVALID", `Failed to parse ${packageJsonPath}: ${message}`);
71
+ }
72
+ if (typeof version !== "string" || version === "") {
73
+ throw new CliError(
74
+ "MANIFEST_INVALID",
75
+ `package.json at ${packageJsonPath} is missing a version.`
76
+ );
77
+ }
78
+ return { identifier, version };
79
+ }
80
+ function mapErrorCode(status) {
81
+ switch (status) {
82
+ case 400:
83
+ return "PLATFORM_REJECTED";
84
+ case 401:
85
+ case 403:
86
+ return "PLATFORM_UNAUTHORISED";
87
+ case 409:
88
+ return "VERSION_EXISTS";
89
+ default:
90
+ return "PLATFORM_ERROR";
91
+ }
92
+ }
93
+ function mapErrorMessage(status, parsedBody, identifier, version) {
94
+ switch (status) {
95
+ case 400: {
96
+ const detail = parsedBody ? formatPlatformErrors(parsedBody) : "";
97
+ return detail ? `Package upload rejected (400): ${detail}` : "Package upload rejected (400). The server did not return an errors array.";
98
+ }
99
+ case 401:
100
+ return "Invalid API key. Check $SERIOUSGAMING_API_KEY and that it has not been revoked.";
101
+ case 403:
102
+ return "The account that created this API key does not have publishing access. Ask Serious Gaming support to grant it.";
103
+ case 409:
104
+ return `Version ${version} of ${identifier} already exists. Bump it with \`seriousgaming-sdk package version patch\` and try again.`;
105
+ default: {
106
+ const detail = parsedBody ? formatPlatformErrors(parsedBody) : "";
107
+ return detail ? `Package upload failed (${status}): ${detail}` : `Package upload failed with HTTP ${status}.`;
108
+ }
109
+ }
110
+ }
111
+ async function packagePublishCommand(zip, options) {
112
+ const fail = (code, message) => {
113
+ throw new CliError(code, message);
114
+ };
115
+ const sdkConfig = readSdkConfig(options.workingDir);
116
+ const buildDirAbs = resolve(options.workingDir, options.buildDir);
117
+ const defaultZipPath = join(buildDirAbs, `${sdkConfig.identifier}-${sdkConfig.version}.zip`);
118
+ let zipPath;
119
+ if (zip) {
120
+ zipPath = resolve(options.workingDir, zip);
121
+ if (!existsSync(zipPath)) {
122
+ fail("FILE_NOT_FOUND", `Zip file not found at ${zipPath}.`);
123
+ return;
124
+ }
125
+ } else {
126
+ if (!existsSync(defaultZipPath)) {
127
+ if (!options.autoBundle) {
128
+ fail(
129
+ "BUILD_NOT_FOUND",
130
+ `Bundle not found at ${defaultZipPath}. Run \`seriousgaming-sdk package bundle\` first, or omit \`--no-auto-bundle\`.`
131
+ );
132
+ return;
133
+ }
134
+ logger.info(`Bundle not found at ${defaultZipPath}. Running "package bundle"\u2026`);
135
+ try {
136
+ await bundlePackage({
137
+ workingDir: options.workingDir,
138
+ buildDir: options.buildDir
139
+ });
140
+ } catch (error) {
141
+ if (!(error instanceof CliError)) throw error;
142
+ throw new CliError(error.code, `Auto-bundle failed: ${error.message}`, {
143
+ cause: error
144
+ });
145
+ }
146
+ if (!existsSync(defaultZipPath)) {
147
+ fail(
148
+ "BUILD_NOT_FOUND",
149
+ `Auto-bundle did not produce the expected zip at ${defaultZipPath}. Check the build directory and re-run \`seriousgaming-sdk package bundle\`.`
150
+ );
151
+ return;
152
+ }
153
+ }
154
+ zipPath = defaultZipPath;
155
+ }
156
+ const env = loadEnvironmentConfig(options.workingDir, {
157
+ seriousGamingApiKey: options.apiKey,
158
+ seriousGamingApiHost: options.host,
159
+ defaultPublisher: options.publisher
160
+ });
161
+ const apiKey = env.seriousGamingApiKey;
162
+ if (!apiKey) {
163
+ fail(
164
+ "API_KEY_MISSING",
165
+ "No API key configured. Set SERIOUSGAMING_API_KEY in your environment or .env file, or pass it with --api-key."
166
+ );
167
+ return;
168
+ }
169
+ const publisher = env.defaultPublisher;
170
+ if (!publisher) {
171
+ fail(
172
+ "PUBLISHER_MISSING",
173
+ "No publisher configured. Set one with --publisher <slug>, the SERIOUSGAMING_PUBLISHER environment variable, or platform.defaultPublisher in your global settings (seriousgaming-sdk config set platform.defaultPublisher <slug>)."
174
+ );
175
+ return;
176
+ }
177
+ const host = normalisePlatformHost(env.seriousGamingApiHost ?? DEFAULT_PLATFORM_HOST);
178
+ const endpoint = `${host}${buildApiPath(publisher)}`;
179
+ let zipBuffer;
180
+ try {
181
+ zipBuffer = await readFile(zipPath);
182
+ } catch (error) {
183
+ fail(
184
+ "FILE_NOT_FOUND",
185
+ `Failed to read zip at ${zipPath}: ${error instanceof Error ? error.message : String(error)}`
186
+ );
187
+ return;
188
+ }
189
+ const zipSize = statSync(zipPath).size;
190
+ const form = new FormData();
191
+ const blob = new Blob([new Uint8Array(zipBuffer)], { type: "application/zip" });
192
+ form.append("body", blob, `${sdkConfig.identifier}-${sdkConfig.version}.zip`);
193
+ let response;
194
+ try {
195
+ response = await fetch(endpoint, {
196
+ method: "POST",
197
+ headers: { Authorization: `Bearer ${apiKey}` },
198
+ body: form
199
+ });
200
+ } catch (error) {
201
+ const message = error instanceof Error ? error.message : String(error);
202
+ fail("PLATFORM_UNREACHABLE", `Network error contacting ${endpoint}: ${message}`);
203
+ return;
204
+ }
205
+ const rawBody = await response.text();
206
+ let parsedBody = null;
207
+ if (rawBody) {
208
+ try {
209
+ parsedBody = JSON.parse(rawBody);
210
+ } catch {
211
+ parsedBody = null;
212
+ }
213
+ }
214
+ if (!response.ok) {
215
+ const message = mapErrorMessage(
216
+ response.status,
217
+ parsedBody ?? null,
218
+ sdkConfig.identifier,
219
+ sdkConfig.version
220
+ );
221
+ fail(mapErrorCode(response.status), message);
222
+ return;
223
+ }
224
+ if (!parsedBody || typeof parsedBody !== "object") {
225
+ fail(
226
+ "PLATFORM_ERROR",
227
+ `Server returned HTTP ${response.status} but the body was not a JSON object. Cannot confirm the upload succeeded.`
228
+ );
229
+ return;
230
+ }
231
+ const result = parsedBody;
232
+ reportResult(result, () => {
233
+ logger.success(`Published ${sdkConfig.identifier} ${sdkConfig.version}`);
234
+ console.log(` handle: ${result.handle}`);
235
+ console.log(` packageHandle: ${result.packageHandle}`);
236
+ console.log(` packageName: ${result.packageName}`);
237
+ console.log(` version: ${result.version}`);
238
+ console.log(` createdAt: ${result.createdAt}`);
239
+ if (Array.isArray(result.games) && result.games.length > 0) {
240
+ const ids = result.games.map((g) => g.identifier).join(", ");
241
+ console.log(` games: ${ids}`);
242
+ }
243
+ console.log(` size: ${zipSize} bytes`);
244
+ });
245
+ }
246
+ export {
247
+ packagePublishCommand
248
+ };