@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,253 @@
1
+ #!/usr/bin/env node
2
+
3
+ // cli/storage/blob-store.ts
4
+ import { randomUUID } from "crypto";
5
+ import { existsSync } from "fs";
6
+ import { mkdir, readdir, readFile, rm, stat, writeFile } from "fs/promises";
7
+ import { join, resolve } from "path";
8
+ var MAX_BLOB_SIZE = 20 * 1024 * 1024;
9
+ var redirected = /* @__PURE__ */ new Map();
10
+ function getBlobsDir(packagePath) {
11
+ return redirected.get(resolve(packagePath)) ?? join(packagePath, ".seriousgaming-sdk", "blobs");
12
+ }
13
+ function redirectBlobs(packagePath, dir) {
14
+ const key = resolve(packagePath);
15
+ redirected.set(key, dir);
16
+ return () => {
17
+ if (redirected.get(key) === dir) redirected.delete(key);
18
+ };
19
+ }
20
+ var BLOB_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
21
+ function blobPath(dir, id, suffix) {
22
+ if (!BLOB_ID.test(id)) throw new Error(`Blob not found: ${id}`);
23
+ return join(dir, `${id}${suffix}`);
24
+ }
25
+ function metaPath(dir, id) {
26
+ return blobPath(dir, id, ".meta.json");
27
+ }
28
+ function binPath(dir, id) {
29
+ return blobPath(dir, id, ".bin");
30
+ }
31
+ async function storeBlob(packagePath, data, name, mimeType, retention) {
32
+ if (data.length > MAX_BLOB_SIZE) {
33
+ throw new Error(
34
+ `Blob exceeds maximum size of 20 MB (got ${(data.length / 1024 / 1024).toFixed(1)} MB)`
35
+ );
36
+ }
37
+ const dir = getBlobsDir(packagePath);
38
+ await mkdir(dir, { recursive: true });
39
+ const id = randomUUID();
40
+ const meta = { name, mimeType, retention };
41
+ await writeFile(binPath(dir, id), data);
42
+ await writeFile(metaPath(dir, id), JSON.stringify(meta, null, 2), "utf-8");
43
+ return id;
44
+ }
45
+ async function readBlob(packagePath, id) {
46
+ const dir = getBlobsDir(packagePath);
47
+ const mp = metaPath(dir, id);
48
+ const bp = binPath(dir, id);
49
+ if (!existsSync(mp) || !existsSync(bp)) {
50
+ throw new Error(`Blob not found: ${id}`);
51
+ }
52
+ const [metaRaw, data] = await Promise.all([readFile(mp, "utf-8"), readFile(bp)]);
53
+ const meta = JSON.parse(metaRaw);
54
+ return { ...meta, data };
55
+ }
56
+ async function describeBlob(packagePath, id) {
57
+ const dir = getBlobsDir(packagePath);
58
+ try {
59
+ const [metaRaw, bin] = await Promise.all([
60
+ readFile(metaPath(dir, id), "utf-8"),
61
+ stat(binPath(dir, id))
62
+ ]);
63
+ return { ...JSON.parse(metaRaw), size: bin.size };
64
+ } catch {
65
+ return void 0;
66
+ }
67
+ }
68
+ async function deleteBlobs(packagePath, retentions) {
69
+ const dir = getBlobsDir(packagePath);
70
+ let entries;
71
+ try {
72
+ entries = await readdir(dir);
73
+ } catch {
74
+ return;
75
+ }
76
+ const ids = entries.filter((entry) => entry.endsWith(".meta.json")).map((entry) => entry.slice(0, -".meta.json".length)).filter((id) => BLOB_ID.test(id));
77
+ await Promise.all(
78
+ ids.map(async (id) => {
79
+ let meta;
80
+ try {
81
+ meta = JSON.parse(await readFile(metaPath(dir, id), "utf-8"));
82
+ } catch {
83
+ return;
84
+ }
85
+ if (!retentions.includes(meta.retention)) return;
86
+ await rm(binPath(dir, id), { force: true });
87
+ await rm(metaPath(dir, id), { force: true });
88
+ })
89
+ );
90
+ }
91
+
92
+ // cli/storage/asset-resolver.ts
93
+ import { readFile as readFile2, stat as stat2 } from "fs/promises";
94
+ import { basename, isAbsolute, normalize, resolve as resolvePath, sep } from "path";
95
+ var ASSET_PREFIX = "asset:";
96
+ var SHARED_PREFIX = "shared:";
97
+ var BLOB_PREFIX = "blob:";
98
+ var EXTENSION_MEDIA_TYPES = {
99
+ aac: "audio/aac",
100
+ avif: "image/avif",
101
+ bmp: "image/bmp",
102
+ css: "text/css",
103
+ csv: "text/csv",
104
+ doc: "application/msword",
105
+ docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
106
+ flac: "audio/flac",
107
+ gif: "image/gif",
108
+ htm: "text/html",
109
+ html: "text/html",
110
+ ico: "image/x-icon",
111
+ jpeg: "image/jpeg",
112
+ jpg: "image/jpeg",
113
+ js: "text/javascript",
114
+ json: "application/json",
115
+ m4a: "audio/mp4",
116
+ m4v: "video/mp4",
117
+ md: "text/markdown",
118
+ mjs: "text/javascript",
119
+ mov: "video/quicktime",
120
+ mp3: "audio/mpeg",
121
+ mp4: "video/mp4",
122
+ odp: "application/vnd.oasis.opendocument.presentation",
123
+ ods: "application/vnd.oasis.opendocument.spreadsheet",
124
+ odt: "application/vnd.oasis.opendocument.text",
125
+ ogg: "audio/ogg",
126
+ opus: "audio/ogg",
127
+ otf: "font/otf",
128
+ pdf: "application/pdf",
129
+ png: "image/png",
130
+ ppt: "application/vnd.ms-powerpoint",
131
+ pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
132
+ rtf: "application/rtf",
133
+ svg: "image/svg+xml",
134
+ tif: "image/tiff",
135
+ tiff: "image/tiff",
136
+ ttf: "font/ttf",
137
+ txt: "text/plain",
138
+ vtt: "text/vtt",
139
+ wav: "audio/wav",
140
+ webm: "video/webm",
141
+ webp: "image/webp",
142
+ woff: "font/woff",
143
+ woff2: "font/woff2",
144
+ xls: "application/vnd.ms-excel",
145
+ xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
146
+ xml: "application/xml",
147
+ yaml: "application/yaml",
148
+ yml: "application/yaml",
149
+ zip: "application/zip"
150
+ };
151
+ var UNLISTED_MEDIA_TYPE = "application/octet-stream";
152
+ function mediaTypeOf(path) {
153
+ const name = path.slice(Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\")) + 1);
154
+ const dot = name.lastIndexOf(".");
155
+ if (dot < 0) return UNLISTED_MEDIA_TYPE;
156
+ const ext = name.slice(dot + 1).toLowerCase();
157
+ return Object.hasOwn(EXTENSION_MEDIA_TYPES, ext) ? EXTENSION_MEDIA_TYPES[ext] : UNLISTED_MEDIA_TYPE;
158
+ }
159
+ function isAssetReference(value) {
160
+ return typeof value === "string" && (value.startsWith(ASSET_PREFIX) || value.startsWith(SHARED_PREFIX) || value.startsWith(BLOB_PREFIX));
161
+ }
162
+ function scenarioAssetPath(scenarioRootDirectory, path) {
163
+ const assetsRoot = resolvePath(scenarioRootDirectory, "assets");
164
+ const resolvedPath = resolvePath(assetsRoot, normalize(path));
165
+ if (!resolvedPath.startsWith(assetsRoot + sep)) {
166
+ throw new Error(`Asset path escapes scenario assets directory: ${path}`);
167
+ }
168
+ return resolvedPath;
169
+ }
170
+ function sharedAssetPath(packagePath, path) {
171
+ const sharedRoot = resolvePath(packagePath, "shared-assets");
172
+ const resolvedPath = resolvePath(sharedRoot, normalize(path));
173
+ if (!resolvedPath.startsWith(sharedRoot + sep)) {
174
+ throw new Error(`Asset path escapes shared-assets directory: ${path}`);
175
+ }
176
+ return resolvedPath;
177
+ }
178
+ async function resolveAsset(scenarioRootDirectory, path) {
179
+ const resolvedPath = scenarioAssetPath(scenarioRootDirectory, path);
180
+ const data = await readFile2(resolvedPath);
181
+ return {
182
+ data,
183
+ mimeType: mediaTypeOf(resolvedPath),
184
+ name: basename(resolvedPath)
185
+ };
186
+ }
187
+ async function resolveSharedAsset(packagePath, path) {
188
+ const resolvedPath = sharedAssetPath(packagePath, path);
189
+ const data = await readFile2(resolvedPath);
190
+ return {
191
+ data,
192
+ mimeType: mediaTypeOf(resolvedPath),
193
+ name: basename(resolvedPath)
194
+ };
195
+ }
196
+ async function readAssetByReference(packagePath, scenarioRootDirectory, reference) {
197
+ if (reference.startsWith(BLOB_PREFIX)) {
198
+ const id = reference.slice(BLOB_PREFIX.length);
199
+ const blob = await readBlob(packagePath, id);
200
+ return { data: blob.data, mimeType: blob.mimeType, name: blob.name };
201
+ }
202
+ if (reference.startsWith(SHARED_PREFIX)) {
203
+ const path = reference.slice(SHARED_PREFIX.length);
204
+ return resolveSharedAsset(packagePath, path);
205
+ }
206
+ if (reference.startsWith(ASSET_PREFIX)) {
207
+ if (!scenarioRootDirectory) {
208
+ throw new Error(`Cannot resolve asset reference "${reference}": no scenario is active`);
209
+ }
210
+ const path = reference.slice(ASSET_PREFIX.length);
211
+ const root = isAbsolute(scenarioRootDirectory) ? scenarioRootDirectory : resolvePath(packagePath, scenarioRootDirectory);
212
+ return resolveAsset(root, path);
213
+ }
214
+ throw new Error(
215
+ `Invalid asset reference "${reference}": expected an "asset:", "shared:", or "blob:" prefix`
216
+ );
217
+ }
218
+ async function describeAssetByReference(packagePath, scenarioRootDirectory, reference) {
219
+ if (reference.startsWith(BLOB_PREFIX)) {
220
+ const blob = await describeBlob(packagePath, reference.slice(BLOB_PREFIX.length));
221
+ return blob && { mimeType: blob.mimeType, size: blob.size };
222
+ }
223
+ let path;
224
+ if (reference.startsWith(SHARED_PREFIX)) {
225
+ path = sharedAssetPath(packagePath, reference.slice(SHARED_PREFIX.length));
226
+ } else if (reference.startsWith(ASSET_PREFIX)) {
227
+ if (!scenarioRootDirectory) return void 0;
228
+ const root = isAbsolute(scenarioRootDirectory) ? scenarioRootDirectory : resolvePath(packagePath, scenarioRootDirectory);
229
+ path = scenarioAssetPath(root, reference.slice(ASSET_PREFIX.length));
230
+ } else {
231
+ throw new Error(
232
+ `Invalid asset reference "${reference}": expected an "asset:", "shared:", or "blob:" prefix`
233
+ );
234
+ }
235
+ try {
236
+ const file = await stat2(path);
237
+ return file.isFile() ? { mimeType: mediaTypeOf(path), size: file.size } : void 0;
238
+ } catch {
239
+ return void 0;
240
+ }
241
+ }
242
+
243
+ export {
244
+ redirectBlobs,
245
+ storeBlob,
246
+ readBlob,
247
+ describeBlob,
248
+ deleteBlobs,
249
+ mediaTypeOf,
250
+ isAssetReference,
251
+ readAssetByReference,
252
+ describeAssetByReference
253
+ };
@@ -0,0 +1,131 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ resolvePatchedDefinition
4
+ } from "./cli-UJ4UCL2Z.js";
5
+ import "./cli-S5IVGDDD.js";
6
+ import {
7
+ getResourceIdentifierError,
8
+ readAuthoredBundle
9
+ } from "./cli-YVVXUD2G.js";
10
+ import {
11
+ resolveInputSource
12
+ } from "./cli-4UWFQNGF.js";
13
+ import {
14
+ updateValidatorFiles
15
+ } from "./cli-FYINNRML.js";
16
+ import "./cli-IUS2YCD3.js";
17
+ import "./cli-QUNIRH7A.js";
18
+ import "./cli-BYJWFFCF.js";
19
+ import {
20
+ loadPackageContext
21
+ } from "./cli-XSVGKI3R.js";
22
+ import "./cli-MBNMPVDC.js";
23
+ import {
24
+ findBundleFile
25
+ } from "./cli-GFBGYFYD.js";
26
+ import {
27
+ operationError,
28
+ printOperationResult,
29
+ regenerateTypes
30
+ } from "./cli-UELGBQG7.js";
31
+ import {
32
+ input
33
+ } from "./cli-ZTWOE3ZT.js";
34
+ import "./cli-4BV45LBH.js";
35
+ import "./cli-4AKVLEC4.js";
36
+ import "./cli-VCKOC2EV.js";
37
+ import "./cli-E2NLWIFE.js";
38
+ import "./cli-25RWY5BQ.js";
39
+ import "./cli-QWQMPCL6.js";
40
+ import {
41
+ validateSDKValidator
42
+ } from "./cli-SMFSZF2G.js";
43
+ import "./cli-F2D4GGUA.js";
44
+ import {
45
+ logger
46
+ } from "./cli-4YB3ROVR.js";
47
+ import {
48
+ CliError
49
+ } from "./cli-N6H6T2E2.js";
50
+
51
+ // cli/commands/resources/validator/update.ts
52
+ import { readFileSync } from "fs";
53
+ async function updateValidator(identifier, definitionInput, options) {
54
+ logger.info("\nUpdating validator...\n");
55
+ loadPackageContext(options.workingDir);
56
+ let jsonDefinition = null;
57
+ if (options.patch) {
58
+ jsonDefinition = resolvePatchedDefinition({
59
+ patch: options.patch,
60
+ workingDir: options.workingDir,
61
+ type: "validator",
62
+ identifier,
63
+ resourceLabel: "Validator"
64
+ });
65
+ } else {
66
+ const inputSource = await resolveInputSource(definitionInput, options.file);
67
+ if (inputSource.kind === "json") jsonDefinition = inputSource.json;
68
+ }
69
+ if (jsonDefinition) {
70
+ const validatorInput = readAuthoredBundle({
71
+ json: jsonDefinition,
72
+ type: "validator",
73
+ command: "update",
74
+ validate: validateSDKValidator,
75
+ identifier
76
+ });
77
+ logger.info("Updating validator files...\n");
78
+ const result2 = updateValidatorFiles({
79
+ packagePath: options.workingDir,
80
+ oldIdentifier: identifier,
81
+ newDefinition: validatorInput.definition,
82
+ newIdentifier: validatorInput.definition?.identifier
83
+ });
84
+ if (!result2.success) {
85
+ throw operationError(result2, "Failed to update validator files");
86
+ }
87
+ logger.success("Validator updated successfully!");
88
+ printOperationResult(result2);
89
+ await regenerateTypes(options.workingDir);
90
+ return;
91
+ }
92
+ logger.info("No JSON definition provided. Starting interactive mode...\n");
93
+ const validatorFilePath = findBundleFile(options.workingDir, "validator", identifier);
94
+ if (!validatorFilePath) {
95
+ throw new CliError("RESOURCE_NOT_FOUND", `Validator "${identifier}" not found`);
96
+ }
97
+ let existingBundle;
98
+ try {
99
+ existingBundle = JSON.parse(readFileSync(validatorFilePath, "utf-8"));
100
+ } catch {
101
+ throw new CliError("BUNDLE_INVALID", "Could not read validator file");
102
+ }
103
+ const existingDef = { ...existingBundle.definition, identifier };
104
+ logger.info("Current values:");
105
+ logger.info(` Identifier: ${existingDef.identifier}`);
106
+ logger.info("");
107
+ const newIdentifier = await input({
108
+ message: "Validator name:",
109
+ default: existingDef.identifier,
110
+ validate: (value) => {
111
+ const error = getResourceIdentifierError(value);
112
+ return error || true;
113
+ }
114
+ });
115
+ if (newIdentifier !== existingDef.identifier) {
116
+ logger.info("\n\u26A0\uFE0F Changing the identifier will update all game references.\n");
117
+ }
118
+ const result = updateValidatorFiles({
119
+ packagePath: options.workingDir,
120
+ oldIdentifier: identifier,
121
+ newDefinition: { ...existingDef, identifier: newIdentifier }
122
+ });
123
+ if (!result.success) {
124
+ throw operationError(result, "Failed to update validator files");
125
+ }
126
+ logger.success("Validator updated successfully!");
127
+ await regenerateTypes(options.workingDir);
128
+ }
129
+ export {
130
+ updateValidator
131
+ };
@@ -0,0 +1,53 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ createResourceFiles,
4
+ deleteResourceFiles,
5
+ findResourceReferences,
6
+ updateResourceFiles
7
+ } from "./cli-MBNMPVDC.js";
8
+ import {
9
+ getResourceMeta
10
+ } from "./cli-SMFSZF2G.js";
11
+
12
+ // cli/templating/guide.ts
13
+ var guideMeta = getResourceMeta("guide");
14
+ var SCAFFOLD_CHAPTERS = [
15
+ { file: "01-at-a-glance.md", template: "guide/01-at-a-glance.md.liquid" },
16
+ { file: "02-preparation.md", template: "guide/02-preparation.md.liquid" },
17
+ {
18
+ file: "03-running-the-session.md",
19
+ template: "guide/03-running-the-session.md.liquid"
20
+ }
21
+ ];
22
+ function createFacilitatorGuideFiles(options) {
23
+ const { locales, rootDirectory } = options;
24
+ const definition = { locales };
25
+ return createResourceFiles(guideMeta, options, {
26
+ definition,
27
+ rootDirectory,
28
+ directories: ["assets"],
29
+ files: Object.keys(locales).flatMap(
30
+ (locale) => SCAFFOLD_CHAPTERS.map((chapter) => ({
31
+ path: `content/${locale}/${chapter.file}`,
32
+ template: chapter.template,
33
+ data: { name: locales[locale]?.name ?? "guide" }
34
+ }))
35
+ )
36
+ });
37
+ }
38
+ function updateFacilitatorGuideFiles(options) {
39
+ return updateResourceFiles(guideMeta, options);
40
+ }
41
+ function deleteFacilitatorGuideFiles(options) {
42
+ return deleteResourceFiles(guideMeta, options);
43
+ }
44
+ function findFacilitatorGuideReferences(options) {
45
+ return findResourceReferences(guideMeta, options);
46
+ }
47
+
48
+ export {
49
+ createFacilitatorGuideFiles,
50
+ updateFacilitatorGuideFiles,
51
+ deleteFacilitatorGuideFiles,
52
+ findFacilitatorGuideReferences
53
+ };
@@ -0,0 +1,36 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ deleteSettingsEditor
4
+ } from "./cli-AK7OIPWY.js";
5
+ import "./cli-GGPDQNM3.js";
6
+ import "./cli-UJ4UCL2Z.js";
7
+ import "./cli-S5IVGDDD.js";
8
+ import "./cli-YVVXUD2G.js";
9
+ import "./cli-4UWFQNGF.js";
10
+ import "./cli-FYINNRML.js";
11
+ import "./cli-IUS2YCD3.js";
12
+ import "./cli-QUNIRH7A.js";
13
+ import "./cli-BYJWFFCF.js";
14
+ import "./cli-XSVGKI3R.js";
15
+ import "./cli-MBNMPVDC.js";
16
+ import "./cli-GFBGYFYD.js";
17
+ import "./cli-UELGBQG7.js";
18
+ import "./cli-ZTWOE3ZT.js";
19
+ import "./cli-4BV45LBH.js";
20
+ import "./cli-4AKVLEC4.js";
21
+ import "./cli-VCKOC2EV.js";
22
+ import "./cli-E2NLWIFE.js";
23
+ import "./cli-25RWY5BQ.js";
24
+ import "./cli-QWQMPCL6.js";
25
+ import "./cli-SMFSZF2G.js";
26
+ import "./cli-F2D4GGUA.js";
27
+ import "./cli-4YB3ROVR.js";
28
+ import "./cli-N6H6T2E2.js";
29
+
30
+ // cli/commands/resources/setup/delete.ts
31
+ function deleteSetup(options) {
32
+ return deleteSettingsEditor("setup", options);
33
+ }
34
+ export {
35
+ deleteSetup
36
+ };
@@ -0,0 +1,145 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ promptForSchemaProperties
4
+ } from "./cli-RZITKPJX.js";
5
+ import {
6
+ readAuthoredBundle
7
+ } from "./cli-YVVXUD2G.js";
8
+ import {
9
+ resolveInputSource
10
+ } from "./cli-4UWFQNGF.js";
11
+ import {
12
+ createCapabilityFiles
13
+ } from "./cli-FYINNRML.js";
14
+ import "./cli-IUS2YCD3.js";
15
+ import "./cli-QUNIRH7A.js";
16
+ import "./cli-BYJWFFCF.js";
17
+ import {
18
+ loadPackageContext
19
+ } from "./cli-XSVGKI3R.js";
20
+ import "./cli-MBNMPVDC.js";
21
+ import "./cli-GFBGYFYD.js";
22
+ import {
23
+ BUILD_COMMAND,
24
+ generateTypes,
25
+ operationError,
26
+ printOperationResult
27
+ } from "./cli-UELGBQG7.js";
28
+ import {
29
+ input
30
+ } from "./cli-ZTWOE3ZT.js";
31
+ import "./cli-4BV45LBH.js";
32
+ import "./cli-4AKVLEC4.js";
33
+ import "./cli-VCKOC2EV.js";
34
+ import "./cli-E2NLWIFE.js";
35
+ import "./cli-25RWY5BQ.js";
36
+ import "./cli-QWQMPCL6.js";
37
+ import {
38
+ validateSDKCapability
39
+ } from "./cli-SMFSZF2G.js";
40
+ import "./cli-F2D4GGUA.js";
41
+ import {
42
+ logger
43
+ } from "./cli-4YB3ROVR.js";
44
+ import {
45
+ CliError
46
+ } from "./cli-N6H6T2E2.js";
47
+
48
+ // cli/commands/resources/capability/new.ts
49
+ var CAPABILITY_SCOPES = Object.keys({
50
+ team: true,
51
+ "team-readable": true,
52
+ shared: true,
53
+ private: true
54
+ });
55
+ async function createCapability(definitionInput, options) {
56
+ logger.info("\nCreating new capability...\n");
57
+ if (options.scope !== void 0 && !CAPABILITY_SCOPES.includes(options.scope)) {
58
+ throw new CliError(
59
+ "USAGE_BAD_ARGUMENT",
60
+ `Invalid scope "${options.scope}". Must be one of: ${CAPABILITY_SCOPES.join(", ")}.`
61
+ );
62
+ }
63
+ const scopeOption = options.scope;
64
+ loadPackageContext(options.workingDir, {
65
+ suggestNewPackage: true
66
+ });
67
+ const inputSource = await resolveInputSource(definitionInput, options.file);
68
+ const jsonDefinition = inputSource.kind === "json" ? inputSource.json : null;
69
+ if (jsonDefinition) {
70
+ const capabilityInput = readAuthoredBundle({
71
+ json: jsonDefinition,
72
+ type: "capability",
73
+ command: "new",
74
+ validate: validateSDKCapability
75
+ });
76
+ const definition = capabilityInput.definition;
77
+ const identifier2 = definition.identifier;
78
+ const variablesSchema2 = definition.variablesSchema;
79
+ const scope = definition.scope ?? scopeOption;
80
+ logger.info("Creating capability files...\n");
81
+ const result2 = await createCapabilityFiles({
82
+ packagePath: options.workingDir,
83
+ identifier: identifier2,
84
+ variablesSchema: variablesSchema2,
85
+ scope
86
+ });
87
+ if (!result2.success) {
88
+ throw operationError(result2, "Failed to create capability files");
89
+ }
90
+ logger.success("Capability created successfully!");
91
+ printOperationResult(result2);
92
+ await generateTypes(options.workingDir);
93
+ logger.info("Next steps:");
94
+ logger.info(" 1. Use this capability in the engine by adding it to reads or writes");
95
+ logger.info(` 2. Run "${BUILD_COMMAND}" to build your package`);
96
+ return;
97
+ }
98
+ logger.info("No JSON definition provided. Starting interactive mode...\n");
99
+ const capabilityName = await input({
100
+ message: 'Capability name (e.g., "price", "inventory"):',
101
+ default: "mycapability",
102
+ validate: (value) => {
103
+ if (!value.trim()) {
104
+ return "Capability name is required";
105
+ }
106
+ const trimmed = value.trim();
107
+ if (!/^[a-z][a-z0-9_]*$/.test(trimmed)) {
108
+ return "Capability name must start with a lowercase letter and contain only lowercase letters, numbers, and underscores";
109
+ }
110
+ return true;
111
+ }
112
+ });
113
+ const identifier = capabilityName.trim();
114
+ logger.info("\u2713 This capability will be initialized with schema defaults");
115
+ logger.info("");
116
+ const variableProps = await promptForSchemaProperties({
117
+ context: "variable",
118
+ minProperties: 1
119
+ });
120
+ const variablesSchema = {
121
+ type: "object",
122
+ properties: variableProps,
123
+ required: Object.keys(variableProps),
124
+ additionalProperties: false
125
+ };
126
+ logger.info("\nCreating capability files...\n");
127
+ const result = await createCapabilityFiles({
128
+ packagePath: options.workingDir,
129
+ identifier,
130
+ variablesSchema,
131
+ scope: scopeOption
132
+ });
133
+ if (!result.success) {
134
+ throw operationError(result, "Failed to create capability files");
135
+ }
136
+ logger.success("Capability created successfully!");
137
+ printOperationResult(result);
138
+ await generateTypes(options.workingDir);
139
+ logger.info("Next steps:");
140
+ logger.info(" 1. Use this capability in the engine by adding it to reads or writes");
141
+ logger.info(` 2. Run "${BUILD_COMMAND}" to build your package`);
142
+ }
143
+ export {
144
+ createCapability
145
+ };