@aephia/atlas-kit 0.6.0-next.9 → 0.6.0-next.90

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 (578) hide show
  1. package/README.md +3 -1
  2. package/dist/cargo/actions/deposit.d.ts +1 -1
  3. package/dist/cargo/actions/deposit.d.ts.map +1 -1
  4. package/dist/cargo/actions/deposit.js +25 -12
  5. package/dist/cargo/actions/deposit.js.map +1 -1
  6. package/dist/cargo/actions/index.d.ts.map +1 -1
  7. package/dist/cargo/actions/index.js +3 -2
  8. package/dist/cargo/actions/index.js.map +1 -1
  9. package/dist/cargo/actions/wallet-token.d.ts +1 -1
  10. package/dist/cargo/actions/wallet-token.d.ts.map +1 -1
  11. package/dist/cargo/actions/wallet-token.js +1 -9
  12. package/dist/cargo/actions/wallet-token.js.map +1 -1
  13. package/dist/cargo/actions/withdrawal.d.ts.map +1 -1
  14. package/dist/cargo/actions/withdrawal.js +28 -27
  15. package/dist/cargo/actions/withdrawal.js.map +1 -1
  16. package/dist/claim-stakes/actions/index.d.ts +13 -0
  17. package/dist/claim-stakes/actions/index.d.ts.map +1 -1
  18. package/dist/claim-stakes/actions/index.js +95 -44
  19. package/dist/claim-stakes/actions/index.js.map +1 -1
  20. package/dist/claim-stakes/index.d.ts +14 -0
  21. package/dist/claim-stakes/index.d.ts.map +1 -1
  22. package/dist/claim-stakes/index.js +23 -2
  23. package/dist/claim-stakes/index.js.map +1 -1
  24. package/dist/client/context.d.ts.map +1 -1
  25. package/dist/client/context.js +1 -1
  26. package/dist/client/context.js.map +1 -1
  27. package/dist/client/contracts.d.ts +16 -6
  28. package/dist/client/contracts.d.ts.map +1 -1
  29. package/dist/client/errors.d.ts +6 -2
  30. package/dist/client/errors.d.ts.map +1 -1
  31. package/dist/client/errors.js +31 -1
  32. package/dist/client/errors.js.map +1 -1
  33. package/dist/client/index.d.ts +35 -0
  34. package/dist/client/index.d.ts.map +1 -1
  35. package/dist/client/index.js +35 -0
  36. package/dist/client/index.js.map +1 -1
  37. package/dist/client/rpc-subscription-provider.d.ts +35 -0
  38. package/dist/client/rpc-subscription-provider.d.ts.map +1 -0
  39. package/dist/client/rpc-subscription-provider.js +190 -0
  40. package/dist/client/rpc-subscription-provider.js.map +1 -0
  41. package/dist/combat/actions/index.d.ts.map +1 -1
  42. package/dist/combat/actions/index.js +98 -50
  43. package/dist/combat/actions/index.js.map +1 -1
  44. package/dist/crafting/actions/index.d.ts +11 -0
  45. package/dist/crafting/actions/index.d.ts.map +1 -1
  46. package/dist/crafting/actions/index.js +63 -36
  47. package/dist/crafting/actions/index.js.map +1 -1
  48. package/dist/crafting/index.d.ts +33 -3
  49. package/dist/crafting/index.d.ts.map +1 -1
  50. package/dist/crafting/index.js +44 -15
  51. package/dist/crafting/index.js.map +1 -1
  52. package/dist/factions/actions/index.d.ts +1 -0
  53. package/dist/factions/actions/index.d.ts.map +1 -1
  54. package/dist/factions/actions/index.js +2 -1
  55. package/dist/factions/actions/index.js.map +1 -1
  56. package/dist/factions/index.d.ts +1 -1
  57. package/dist/factions/index.d.ts.map +1 -1
  58. package/dist/factions/index.js +14 -8
  59. package/dist/factions/index.js.map +1 -1
  60. package/dist/factions/profile-faction.d.ts +20 -8
  61. package/dist/factions/profile-faction.d.ts.map +1 -1
  62. package/dist/factions/profile-faction.js +20 -8
  63. package/dist/factions/profile-faction.js.map +1 -1
  64. package/dist/fleets/actions/add-ship.d.ts +35 -0
  65. package/dist/fleets/actions/add-ship.d.ts.map +1 -0
  66. package/dist/fleets/actions/add-ship.js +149 -0
  67. package/dist/fleets/actions/add-ship.js.map +1 -0
  68. package/dist/fleets/actions/create-fleet.d.ts +36 -0
  69. package/dist/fleets/actions/create-fleet.d.ts.map +1 -0
  70. package/dist/fleets/actions/create-fleet.js +138 -0
  71. package/dist/fleets/actions/create-fleet.js.map +1 -0
  72. package/dist/fleets/actions/crew-transfer.d.ts +41 -0
  73. package/dist/fleets/actions/crew-transfer.d.ts.map +1 -0
  74. package/dist/fleets/actions/crew-transfer.js +114 -0
  75. package/dist/fleets/actions/crew-transfer.js.map +1 -0
  76. package/dist/fleets/actions/dock-bounds.d.ts +38 -0
  77. package/dist/fleets/actions/dock-bounds.d.ts.map +1 -0
  78. package/dist/fleets/actions/dock-bounds.js +46 -0
  79. package/dist/fleets/actions/dock-bounds.js.map +1 -0
  80. package/dist/fleets/actions/index.d.ts +34 -15
  81. package/dist/fleets/actions/index.d.ts.map +1 -1
  82. package/dist/fleets/actions/index.js +227 -118
  83. package/dist/fleets/actions/index.js.map +1 -1
  84. package/dist/fleets/actions/respawn.d.ts +38 -0
  85. package/dist/fleets/actions/respawn.d.ts.map +1 -0
  86. package/dist/fleets/actions/respawn.js +122 -0
  87. package/dist/fleets/actions/respawn.js.map +1 -0
  88. package/dist/fleets/actions/ship-import.d.ts.map +1 -1
  89. package/dist/fleets/actions/ship-import.js +41 -13
  90. package/dist/fleets/actions/ship-import.js.map +1 -1
  91. package/dist/fleets/cooldown.d.ts +44 -0
  92. package/dist/fleets/cooldown.d.ts.map +1 -0
  93. package/dist/fleets/cooldown.js +43 -0
  94. package/dist/fleets/cooldown.js.map +1 -0
  95. package/dist/fleets/coordinate-warp-estimate.d.ts +70 -0
  96. package/dist/fleets/coordinate-warp-estimate.d.ts.map +1 -0
  97. package/dist/fleets/coordinate-warp-estimate.js +46 -0
  98. package/dist/fleets/coordinate-warp-estimate.js.map +1 -0
  99. package/dist/fleets/index.d.ts +34 -0
  100. package/dist/fleets/index.d.ts.map +1 -1
  101. package/dist/fleets/index.js +51 -2
  102. package/dist/fleets/index.js.map +1 -1
  103. package/dist/fleets/movement-arithmetic.d.ts +21 -0
  104. package/dist/fleets/movement-arithmetic.d.ts.map +1 -0
  105. package/dist/fleets/movement-arithmetic.js +41 -0
  106. package/dist/fleets/movement-arithmetic.js.map +1 -0
  107. package/dist/fleets/subwarp-estimate.d.ts +70 -0
  108. package/dist/fleets/subwarp-estimate.d.ts.map +1 -0
  109. package/dist/fleets/subwarp-estimate.js +38 -0
  110. package/dist/fleets/subwarp-estimate.js.map +1 -0
  111. package/dist/fleets/warp-lane-estimate.d.ts +59 -0
  112. package/dist/fleets/warp-lane-estimate.d.ts.map +1 -0
  113. package/dist/fleets/warp-lane-estimate.js +36 -0
  114. package/dist/fleets/warp-lane-estimate.js.map +1 -0
  115. package/dist/fleets/warp-lane-policy.d.ts +68 -0
  116. package/dist/fleets/warp-lane-policy.d.ts.map +1 -0
  117. package/dist/fleets/warp-lane-policy.js +91 -0
  118. package/dist/fleets/warp-lane-policy.js.map +1 -0
  119. package/dist/fleets/warp-lane-toll.d.ts +55 -0
  120. package/dist/fleets/warp-lane-toll.d.ts.map +1 -0
  121. package/dist/fleets/warp-lane-toll.js +79 -0
  122. package/dist/fleets/warp-lane-toll.js.map +1 -0
  123. package/dist/identity/actions/create-profile.d.ts +2 -0
  124. package/dist/identity/actions/create-profile.d.ts.map +1 -1
  125. package/dist/identity/actions/create-profile.js +14 -9
  126. package/dist/identity/actions/create-profile.js.map +1 -1
  127. package/dist/identity/actions/index.d.ts +3 -3
  128. package/dist/identity/actions/index.d.ts.map +1 -1
  129. package/dist/identity/actions/index.js +48 -27
  130. package/dist/identity/actions/index.js.map +1 -1
  131. package/dist/identity/index.d.ts +15 -0
  132. package/dist/identity/index.d.ts.map +1 -1
  133. package/dist/identity/index.js +15 -0
  134. package/dist/identity/index.js.map +1 -1
  135. package/dist/identity/permissions.d.ts +124 -0
  136. package/dist/identity/permissions.d.ts.map +1 -0
  137. package/dist/identity/permissions.js +171 -0
  138. package/dist/identity/permissions.js.map +1 -0
  139. package/dist/index.d.ts +24 -0
  140. package/dist/index.d.ts.map +1 -1
  141. package/dist/index.js +20 -3
  142. package/dist/index.js.map +1 -1
  143. package/dist/internal/c4/cargo-bytes-config.d.ts +7 -0
  144. package/dist/internal/c4/cargo-bytes-config.d.ts.map +1 -0
  145. package/dist/internal/c4/cargo-bytes-config.js +19 -0
  146. package/dist/internal/c4/cargo-bytes-config.js.map +1 -0
  147. package/dist/internal/c4/character-registration.d.ts +2 -0
  148. package/dist/internal/c4/character-registration.d.ts.map +1 -1
  149. package/dist/internal/c4/character-registration.js +2 -0
  150. package/dist/internal/c4/character-registration.js.map +1 -1
  151. package/dist/internal/c4/claim-stake.d.ts +4 -27
  152. package/dist/internal/c4/claim-stake.d.ts.map +1 -1
  153. package/dist/internal/c4/claim-stake.js +25 -38
  154. package/dist/internal/c4/claim-stake.js.map +1 -1
  155. package/dist/internal/c4/combat.d.ts +0 -27
  156. package/dist/internal/c4/combat.d.ts.map +1 -1
  157. package/dist/internal/c4/combat.js +0 -33
  158. package/dist/internal/c4/combat.js.map +1 -1
  159. package/dist/internal/c4/crafting-process-codec.d.ts +13 -0
  160. package/dist/internal/c4/crafting-process-codec.d.ts.map +1 -0
  161. package/dist/internal/c4/crafting-process-codec.js +34 -0
  162. package/dist/internal/c4/crafting-process-codec.js.map +1 -0
  163. package/dist/internal/c4/crafting.d.ts +12 -32
  164. package/dist/internal/c4/crafting.d.ts.map +1 -1
  165. package/dist/internal/c4/crafting.js +31 -44
  166. package/dist/internal/c4/crafting.js.map +1 -1
  167. package/dist/internal/c4/docking-funding.d.ts +4 -0
  168. package/dist/internal/c4/docking-funding.d.ts.map +1 -0
  169. package/dist/internal/c4/docking-funding.js +11 -0
  170. package/dist/internal/c4/docking-funding.js.map +1 -0
  171. package/dist/internal/c4/faction-adapter.d.ts +12 -0
  172. package/dist/internal/c4/faction-adapter.d.ts.map +1 -0
  173. package/dist/internal/c4/faction-adapter.js +52 -0
  174. package/dist/internal/c4/faction-adapter.js.map +1 -0
  175. package/dist/internal/c4/faction-epoch-meter.d.ts +10 -0
  176. package/dist/internal/c4/faction-epoch-meter.d.ts.map +1 -0
  177. package/dist/internal/c4/faction-epoch-meter.js +31 -0
  178. package/dist/internal/c4/faction-epoch-meter.js.map +1 -0
  179. package/dist/internal/c4/faction-treasury.d.ts +23 -0
  180. package/dist/internal/c4/faction-treasury.d.ts.map +1 -0
  181. package/dist/internal/c4/faction-treasury.js +48 -0
  182. package/dist/internal/c4/faction-treasury.js.map +1 -0
  183. package/dist/internal/c4/factions.d.ts +9 -57
  184. package/dist/internal/c4/factions.d.ts.map +1 -1
  185. package/dist/internal/c4/factions.js +21 -139
  186. package/dist/internal/c4/factions.js.map +1 -1
  187. package/dist/internal/c4/fleet-arrival.d.ts +28 -0
  188. package/dist/internal/c4/fleet-arrival.d.ts.map +1 -0
  189. package/dist/internal/c4/fleet-arrival.js +42 -0
  190. package/dist/internal/c4/fleet-arrival.js.map +1 -0
  191. package/dist/internal/c4/fleet-creation.d.ts +7 -0
  192. package/dist/internal/c4/fleet-creation.d.ts.map +1 -0
  193. package/dist/internal/c4/fleet-creation.js +180 -0
  194. package/dist/internal/c4/fleet-creation.js.map +1 -0
  195. package/dist/internal/c4/fleet-crew-binding.d.ts +9 -0
  196. package/dist/internal/c4/fleet-crew-binding.d.ts.map +1 -1
  197. package/dist/internal/c4/fleet-crew-binding.js +15 -0
  198. package/dist/internal/c4/fleet-crew-binding.js.map +1 -1
  199. package/dist/internal/c4/fleet-respawn.d.ts +19 -0
  200. package/dist/internal/c4/fleet-respawn.d.ts.map +1 -0
  201. package/dist/internal/c4/fleet-respawn.js +91 -0
  202. package/dist/internal/c4/fleet-respawn.js.map +1 -0
  203. package/dist/internal/c4/fleet-ship-assembly.d.ts +11 -0
  204. package/dist/internal/c4/fleet-ship-assembly.d.ts.map +1 -0
  205. package/dist/internal/c4/fleet-ship-assembly.js +44 -0
  206. package/dist/internal/c4/fleet-ship-assembly.js.map +1 -0
  207. package/dist/internal/c4/fleet.d.ts +45 -19
  208. package/dist/internal/c4/fleet.d.ts.map +1 -1
  209. package/dist/internal/c4/fleet.js +26 -7
  210. package/dist/internal/c4/fleet.js.map +1 -1
  211. package/dist/internal/c4/game.d.ts +36 -9
  212. package/dist/internal/c4/game.d.ts.map +1 -1
  213. package/dist/internal/c4/game.js +147 -14
  214. package/dist/internal/c4/game.js.map +1 -1
  215. package/dist/internal/c4/identity.d.ts +4 -8
  216. package/dist/internal/c4/identity.d.ts.map +1 -1
  217. package/dist/internal/c4/identity.js +3 -24
  218. package/dist/internal/c4/identity.js.map +1 -1
  219. package/dist/internal/c4/local-market-order.d.ts +31 -0
  220. package/dist/internal/c4/local-market-order.d.ts.map +1 -0
  221. package/dist/internal/c4/local-market-order.js +47 -0
  222. package/dist/internal/c4/local-market-order.js.map +1 -0
  223. package/dist/internal/c4/loyalty.d.ts +0 -27
  224. package/dist/internal/c4/loyalty.d.ts.map +1 -1
  225. package/dist/internal/c4/loyalty.js +0 -33
  226. package/dist/internal/c4/loyalty.js.map +1 -1
  227. package/dist/internal/c4/market.d.ts +2 -38
  228. package/dist/internal/c4/market.d.ts.map +1 -1
  229. package/dist/internal/c4/market.js +13 -51
  230. package/dist/internal/c4/market.js.map +1 -1
  231. package/dist/internal/c4/mining-instructions.d.ts +2 -0
  232. package/dist/internal/c4/mining-instructions.d.ts.map +1 -0
  233. package/dist/internal/c4/mining-instructions.js +3 -0
  234. package/dist/internal/c4/mining-instructions.js.map +1 -0
  235. package/dist/internal/c4/open-signal.d.ts +8 -0
  236. package/dist/internal/c4/open-signal.d.ts.map +1 -0
  237. package/dist/internal/c4/open-signal.js +37 -0
  238. package/dist/internal/c4/open-signal.js.map +1 -0
  239. package/dist/internal/c4/profile-permissions.d.ts +14 -0
  240. package/dist/internal/c4/profile-permissions.d.ts.map +1 -0
  241. package/dist/internal/c4/profile-permissions.js +81 -0
  242. package/dist/internal/c4/profile-permissions.js.map +1 -0
  243. package/dist/internal/c4/region-geometry.d.ts +8 -0
  244. package/dist/internal/c4/region-geometry.d.ts.map +1 -0
  245. package/dist/internal/c4/region-geometry.js +43 -0
  246. package/dist/internal/c4/region-geometry.js.map +1 -0
  247. package/dist/internal/c4/rewards.d.ts +0 -27
  248. package/dist/internal/c4/rewards.d.ts.map +1 -1
  249. package/dist/internal/c4/rewards.js +0 -33
  250. package/dist/internal/c4/rewards.js.map +1 -1
  251. package/dist/internal/c4/runtime-bindings.d.ts +3 -0
  252. package/dist/internal/c4/runtime-bindings.d.ts.map +1 -0
  253. package/dist/internal/c4/runtime-bindings.js +4 -0
  254. package/dist/internal/c4/runtime-bindings.js.map +1 -0
  255. package/dist/internal/c4/scan-detection-codecs.d.ts +3 -0
  256. package/dist/internal/c4/scan-detection-codecs.d.ts.map +1 -0
  257. package/dist/internal/c4/scan-detection-codecs.js +3 -0
  258. package/dist/internal/c4/scan-detection-codecs.js.map +1 -0
  259. package/dist/internal/c4/scan-lifecycle.d.ts +306 -0
  260. package/dist/internal/c4/scan-lifecycle.d.ts.map +1 -0
  261. package/dist/internal/c4/scan-lifecycle.js +258 -0
  262. package/dist/internal/c4/scan-lifecycle.js.map +1 -0
  263. package/dist/internal/c4/scanning.d.ts +1 -28
  264. package/dist/internal/c4/scanning.d.ts.map +1 -1
  265. package/dist/internal/c4/scanning.js +2 -33
  266. package/dist/internal/c4/scanning.js.map +1 -1
  267. package/dist/internal/c4/ship-import.d.ts +4 -0
  268. package/dist/internal/c4/ship-import.d.ts.map +1 -0
  269. package/dist/internal/c4/ship-import.js +13 -0
  270. package/dist/internal/c4/ship-import.js.map +1 -0
  271. package/dist/internal/c4/ship-stats.d.ts.map +1 -1
  272. package/dist/internal/c4/ship-stats.js +25 -21
  273. package/dist/internal/c4/ship-stats.js.map +1 -1
  274. package/dist/internal/c4/starbase.d.ts +0 -32
  275. package/dist/internal/c4/starbase.d.ts.map +1 -1
  276. package/dist/internal/c4/starbase.js +3 -41
  277. package/dist/internal/c4/starbase.js.map +1 -1
  278. package/dist/internal/c4/world.d.ts +36 -7
  279. package/dist/internal/c4/world.d.ts.map +1 -1
  280. package/dist/internal/c4/world.js +58 -25
  281. package/dist/internal/c4/world.js.map +1 -1
  282. package/dist/internal/cargo.d.ts +2 -0
  283. package/dist/internal/cargo.d.ts.map +1 -1
  284. package/dist/internal/cargo.js +8 -0
  285. package/dist/internal/cargo.js.map +1 -1
  286. package/dist/internal/fleet.d.ts +1 -0
  287. package/dist/internal/fleet.d.ts.map +1 -1
  288. package/dist/internal/fleet.js +3 -1
  289. package/dist/internal/fleet.js.map +1 -1
  290. package/dist/internal/loyalty-atlas-bank-state.d.ts +16 -0
  291. package/dist/internal/loyalty-atlas-bank-state.d.ts.map +1 -0
  292. package/dist/internal/loyalty-atlas-bank-state.js +10 -0
  293. package/dist/internal/loyalty-atlas-bank-state.js.map +1 -0
  294. package/dist/internal/planning/action-runtime.d.ts +38 -0
  295. package/dist/internal/planning/action-runtime.d.ts.map +1 -0
  296. package/dist/internal/planning/action-runtime.js +63 -0
  297. package/dist/internal/planning/action-runtime.js.map +1 -0
  298. package/dist/internal/planning/arrival-guards.d.ts +20 -0
  299. package/dist/internal/planning/arrival-guards.d.ts.map +1 -0
  300. package/dist/internal/planning/arrival-guards.js +187 -0
  301. package/dist/internal/planning/arrival-guards.js.map +1 -0
  302. package/dist/internal/planning/authorization-adapter.d.ts +10 -7
  303. package/dist/internal/planning/authorization-adapter.d.ts.map +1 -1
  304. package/dist/internal/planning/authorization-adapter.js +87 -16
  305. package/dist/internal/planning/authorization-adapter.js.map +1 -1
  306. package/dist/internal/planning/character-registration-guard.d.ts +4 -0
  307. package/dist/internal/planning/character-registration-guard.d.ts.map +1 -0
  308. package/dist/internal/planning/character-registration-guard.js +58 -0
  309. package/dist/internal/planning/character-registration-guard.js.map +1 -0
  310. package/dist/internal/planning/character-registration.d.ts +23 -0
  311. package/dist/internal/planning/character-registration.d.ts.map +1 -0
  312. package/dist/internal/planning/character-registration.js +86 -0
  313. package/dist/internal/planning/character-registration.js.map +1 -0
  314. package/dist/internal/planning/democracy-history.d.ts +50 -0
  315. package/dist/internal/planning/democracy-history.d.ts.map +1 -0
  316. package/dist/internal/planning/democracy-history.js +198 -0
  317. package/dist/internal/planning/democracy-history.js.map +1 -0
  318. package/dist/internal/planning/faction-enrollment.d.ts +0 -2
  319. package/dist/internal/planning/faction-enrollment.d.ts.map +1 -1
  320. package/dist/internal/planning/faction-enrollment.js +1 -22
  321. package/dist/internal/planning/faction-enrollment.js.map +1 -1
  322. package/dist/internal/planning/faction-trade-guards.d.ts +30 -0
  323. package/dist/internal/planning/faction-trade-guards.d.ts.map +1 -0
  324. package/dist/internal/planning/faction-trade-guards.js +15 -0
  325. package/dist/internal/planning/faction-trade-guards.js.map +1 -0
  326. package/dist/internal/planning/faction-trade-state.d.ts +16 -0
  327. package/dist/internal/planning/faction-trade-state.d.ts.map +1 -0
  328. package/dist/internal/planning/faction-trade-state.js +43 -0
  329. package/dist/internal/planning/faction-trade-state.js.map +1 -0
  330. package/dist/internal/planning/fleet-arrival.d.ts +40 -0
  331. package/dist/internal/planning/fleet-arrival.d.ts.map +1 -0
  332. package/dist/internal/planning/fleet-arrival.js +105 -0
  333. package/dist/internal/planning/fleet-arrival.js.map +1 -0
  334. package/dist/internal/planning/fleet-attack-xp.d.ts +20 -0
  335. package/dist/internal/planning/fleet-attack-xp.d.ts.map +1 -0
  336. package/dist/internal/planning/fleet-attack-xp.js +110 -0
  337. package/dist/internal/planning/fleet-attack-xp.js.map +1 -0
  338. package/dist/internal/planning/fleet-creation.d.ts +30 -0
  339. package/dist/internal/planning/fleet-creation.d.ts.map +1 -0
  340. package/dist/internal/planning/fleet-creation.js +108 -0
  341. package/dist/internal/planning/fleet-creation.js.map +1 -0
  342. package/dist/internal/planning/fleet-crew-guard.d.ts +28 -0
  343. package/dist/internal/planning/fleet-crew-guard.d.ts.map +1 -0
  344. package/dist/internal/planning/fleet-crew-guard.js +47 -0
  345. package/dist/internal/planning/fleet-crew-guard.js.map +1 -0
  346. package/dist/internal/planning/fleet-crew-transfer.d.ts +7 -0
  347. package/dist/internal/planning/fleet-crew-transfer.d.ts.map +1 -0
  348. package/dist/internal/planning/fleet-crew-transfer.js +131 -0
  349. package/dist/internal/planning/fleet-crew-transfer.js.map +1 -0
  350. package/dist/internal/planning/fleet-dock-funding-guard.d.ts +42 -0
  351. package/dist/internal/planning/fleet-dock-funding-guard.d.ts.map +1 -0
  352. package/dist/internal/planning/fleet-dock-funding-guard.js +225 -0
  353. package/dist/internal/planning/fleet-dock-funding-guard.js.map +1 -0
  354. package/dist/internal/planning/fleet-dock-funding.d.ts +9 -0
  355. package/dist/internal/planning/fleet-dock-funding.d.ts.map +1 -0
  356. package/dist/internal/planning/fleet-dock-funding.js +153 -0
  357. package/dist/internal/planning/fleet-dock-funding.js.map +1 -0
  358. package/dist/internal/planning/fleet-docking-guard.d.ts +4 -0
  359. package/dist/internal/planning/fleet-docking-guard.d.ts.map +1 -0
  360. package/dist/internal/planning/fleet-docking-guard.js +42 -0
  361. package/dist/internal/planning/fleet-docking-guard.js.map +1 -0
  362. package/dist/internal/planning/fleet-docking.d.ts +10 -0
  363. package/dist/internal/planning/fleet-docking.d.ts.map +1 -0
  364. package/dist/internal/planning/fleet-docking.js +85 -0
  365. package/dist/internal/planning/fleet-docking.js.map +1 -0
  366. package/dist/internal/planning/fleet-respawn.d.ts +28 -0
  367. package/dist/internal/planning/fleet-respawn.d.ts.map +1 -0
  368. package/dist/internal/planning/fleet-respawn.js +165 -0
  369. package/dist/internal/planning/fleet-respawn.js.map +1 -0
  370. package/dist/internal/planning/fleet-ship-assembly.d.ts +36 -0
  371. package/dist/internal/planning/fleet-ship-assembly.d.ts.map +1 -0
  372. package/dist/internal/planning/fleet-ship-assembly.js +137 -0
  373. package/dist/internal/planning/fleet-ship-assembly.js.map +1 -0
  374. package/dist/internal/planning/governance-fees.d.ts +64 -0
  375. package/dist/internal/planning/governance-fees.d.ts.map +1 -0
  376. package/dist/internal/planning/governance-fees.js +239 -0
  377. package/dist/internal/planning/governance-fees.js.map +1 -0
  378. package/dist/internal/planning/local-market-order-funding.d.ts +8 -0
  379. package/dist/internal/planning/local-market-order-funding.d.ts.map +1 -0
  380. package/dist/internal/planning/local-market-order-funding.js +126 -0
  381. package/dist/internal/planning/local-market-order-funding.js.map +1 -0
  382. package/dist/internal/planning/local-market-order.d.ts +40 -0
  383. package/dist/internal/planning/local-market-order.d.ts.map +1 -0
  384. package/dist/internal/planning/local-market-order.js +166 -0
  385. package/dist/internal/planning/local-market-order.js.map +1 -0
  386. package/dist/internal/planning/mining-stop.d.ts +14 -0
  387. package/dist/internal/planning/mining-stop.d.ts.map +1 -0
  388. package/dist/internal/planning/mining-stop.js +41 -0
  389. package/dist/internal/planning/mining-stop.js.map +1 -0
  390. package/dist/internal/planning/movement-character.d.ts +7 -0
  391. package/dist/internal/planning/movement-character.d.ts.map +1 -0
  392. package/dist/internal/planning/movement-character.js +41 -0
  393. package/dist/internal/planning/movement-character.js.map +1 -0
  394. package/dist/internal/planning/movement-xp-guard.d.ts +4 -0
  395. package/dist/internal/planning/movement-xp-guard.d.ts.map +1 -0
  396. package/dist/internal/planning/movement-xp-guard.js +103 -0
  397. package/dist/internal/planning/movement-xp-guard.js.map +1 -0
  398. package/dist/internal/planning/open-signal-guard.d.ts +3 -0
  399. package/dist/internal/planning/open-signal-guard.d.ts.map +1 -0
  400. package/dist/internal/planning/open-signal-guard.js +31 -0
  401. package/dist/internal/planning/open-signal-guard.js.map +1 -0
  402. package/dist/internal/planning/open-signal.d.ts +31 -0
  403. package/dist/internal/planning/open-signal.d.ts.map +1 -0
  404. package/dist/internal/planning/open-signal.js +85 -0
  405. package/dist/internal/planning/open-signal.js.map +1 -0
  406. package/dist/internal/planning/rent.d.ts +19 -0
  407. package/dist/internal/planning/rent.d.ts.map +1 -0
  408. package/dist/internal/planning/rent.js +35 -0
  409. package/dist/internal/planning/rent.js.map +1 -0
  410. package/dist/internal/planning/respawn-guards.d.ts +3 -0
  411. package/dist/internal/planning/respawn-guards.d.ts.map +1 -0
  412. package/dist/internal/planning/respawn-guards.js +41 -0
  413. package/dist/internal/planning/respawn-guards.js.map +1 -0
  414. package/dist/internal/planning/runtime-guards.d.ts +43 -0
  415. package/dist/internal/planning/runtime-guards.d.ts.map +1 -0
  416. package/dist/internal/planning/runtime-guards.js +636 -0
  417. package/dist/internal/planning/runtime-guards.js.map +1 -0
  418. package/dist/internal/planning/scan-completion-guard.d.ts +43 -0
  419. package/dist/internal/planning/scan-completion-guard.d.ts.map +1 -0
  420. package/dist/internal/planning/scan-completion-guard.js +94 -0
  421. package/dist/internal/planning/scan-completion-guard.js.map +1 -0
  422. package/dist/internal/planning/scan-completion.d.ts +20 -0
  423. package/dist/internal/planning/scan-completion.d.ts.map +1 -0
  424. package/dist/internal/planning/scan-completion.js +196 -0
  425. package/dist/internal/planning/scan-completion.js.map +1 -0
  426. package/dist/internal/planning/scan-detect-guard.d.ts +34 -0
  427. package/dist/internal/planning/scan-detect-guard.d.ts.map +1 -0
  428. package/dist/internal/planning/scan-detect-guard.js +77 -0
  429. package/dist/internal/planning/scan-detect-guard.js.map +1 -0
  430. package/dist/internal/planning/scan-detect.d.ts +24 -0
  431. package/dist/internal/planning/scan-detect.d.ts.map +1 -0
  432. package/dist/internal/planning/scan-detect.js +244 -0
  433. package/dist/internal/planning/scan-detect.js.map +1 -0
  434. package/dist/internal/planning/scan-input.d.ts +9 -0
  435. package/dist/internal/planning/scan-input.d.ts.map +1 -0
  436. package/dist/internal/planning/scan-input.js +58 -0
  437. package/dist/internal/planning/scan-input.js.map +1 -0
  438. package/dist/internal/planning/ship-import-funding.d.ts +22 -0
  439. package/dist/internal/planning/ship-import-funding.d.ts.map +1 -0
  440. package/dist/internal/planning/ship-import-funding.js +52 -0
  441. package/dist/internal/planning/ship-import-funding.js.map +1 -0
  442. package/dist/internal/planning/ship-token.d.ts +0 -1
  443. package/dist/internal/planning/ship-token.d.ts.map +1 -1
  444. package/dist/internal/planning/ship-token.js +2 -5
  445. package/dist/internal/planning/ship-token.js.map +1 -1
  446. package/dist/internal/planning/starbase-system-guard.d.ts +6 -0
  447. package/dist/internal/planning/starbase-system-guard.d.ts.map +1 -0
  448. package/dist/internal/planning/starbase-system-guard.js +93 -0
  449. package/dist/internal/planning/starbase-system-guard.js.map +1 -0
  450. package/dist/internal/planning/starbase-system.d.ts +12 -0
  451. package/dist/internal/planning/starbase-system.d.ts.map +1 -0
  452. package/dist/internal/planning/starbase-system.js +22 -0
  453. package/dist/internal/planning/starbase-system.js.map +1 -0
  454. package/dist/internal/planning/token-mint.d.ts +4 -0
  455. package/dist/internal/planning/token-mint.d.ts.map +1 -0
  456. package/dist/internal/planning/token-mint.js +15 -0
  457. package/dist/internal/planning/token-mint.js.map +1 -0
  458. package/dist/internal/planning/trade-faction-market.d.ts +20 -0
  459. package/dist/internal/planning/trade-faction-market.d.ts.map +1 -0
  460. package/dist/internal/planning/trade-faction-market.js +56 -0
  461. package/dist/internal/planning/trade-faction-market.js.map +1 -0
  462. package/dist/internal/planning/xp-runtime.d.ts +36 -0
  463. package/dist/internal/planning/xp-runtime.d.ts.map +1 -0
  464. package/dist/internal/planning/xp-runtime.js +126 -0
  465. package/dist/internal/planning/xp-runtime.js.map +1 -0
  466. package/dist/internal/system-program.d.ts +4 -0
  467. package/dist/internal/system-program.d.ts.map +1 -0
  468. package/dist/internal/system-program.js +3 -0
  469. package/dist/internal/system-program.js.map +1 -0
  470. package/dist/loyalty/actions/index.d.ts.map +1 -1
  471. package/dist/loyalty/actions/index.js +4 -3
  472. package/dist/loyalty/actions/index.js.map +1 -1
  473. package/dist/loyalty/index.d.ts.map +1 -1
  474. package/dist/loyalty/index.js +2 -6
  475. package/dist/loyalty/index.js.map +1 -1
  476. package/dist/markets/actions/index.d.ts +61 -3
  477. package/dist/markets/actions/index.d.ts.map +1 -1
  478. package/dist/markets/actions/index.js +137 -25
  479. package/dist/markets/actions/index.js.map +1 -1
  480. package/dist/markets/actions/trade-faction-market.d.ts +43 -0
  481. package/dist/markets/actions/trade-faction-market.d.ts.map +1 -0
  482. package/dist/markets/actions/trade-faction-market.js +291 -0
  483. package/dist/markets/actions/trade-faction-market.js.map +1 -0
  484. package/dist/markets/index.d.ts +38 -7
  485. package/dist/markets/index.d.ts.map +1 -1
  486. package/dist/markets/index.js +57 -10
  487. package/dist/markets/index.js.map +1 -1
  488. package/dist/mining/actions/index.d.ts +84 -0
  489. package/dist/mining/actions/index.d.ts.map +1 -0
  490. package/dist/mining/actions/index.js +328 -0
  491. package/dist/mining/actions/index.js.map +1 -0
  492. package/dist/mining/estimate.d.ts +114 -0
  493. package/dist/mining/estimate.d.ts.map +1 -0
  494. package/dist/mining/estimate.js +127 -0
  495. package/dist/mining/estimate.js.map +1 -0
  496. package/dist/mining/index.d.ts +8 -2
  497. package/dist/mining/index.d.ts.map +1 -1
  498. package/dist/mining/index.js +6 -2
  499. package/dist/mining/index.js.map +1 -1
  500. package/dist/planning/assembly.d.ts.map +1 -1
  501. package/dist/planning/assembly.js +24 -0
  502. package/dist/planning/assembly.js.map +1 -1
  503. package/dist/planning/execution.d.ts.map +1 -1
  504. package/dist/planning/execution.js +459 -17
  505. package/dist/planning/execution.js.map +1 -1
  506. package/dist/planning/index.d.ts +181 -149
  507. package/dist/planning/index.d.ts.map +1 -1
  508. package/dist/planning/index.js +869 -121
  509. package/dist/planning/index.js.map +1 -1
  510. package/dist/planning/plan-sequence.d.ts.map +1 -1
  511. package/dist/planning/plan-sequence.js +8 -1
  512. package/dist/planning/plan-sequence.js.map +1 -1
  513. package/dist/planning/simulation.d.ts +25 -1
  514. package/dist/planning/simulation.d.ts.map +1 -1
  515. package/dist/planning/simulation.js +111 -11
  516. package/dist/planning/simulation.js.map +1 -1
  517. package/dist/registry/cargo.d.ts +6 -11
  518. package/dist/registry/cargo.d.ts.map +1 -1
  519. package/dist/registry/cargo.js +19 -19
  520. package/dist/registry/cargo.js.map +1 -1
  521. package/dist/registry/docking.d.ts +13 -0
  522. package/dist/registry/docking.d.ts.map +1 -0
  523. package/dist/registry/docking.js +19 -0
  524. package/dist/registry/docking.js.map +1 -0
  525. package/dist/registry/index.d.ts +4 -0
  526. package/dist/registry/index.d.ts.map +1 -1
  527. package/dist/registry/index.js.map +1 -1
  528. package/dist/registry/onboarding.d.ts +8 -1
  529. package/dist/registry/onboarding.d.ts.map +1 -1
  530. package/dist/registry/onboarding.js +18 -5
  531. package/dist/registry/onboarding.js.map +1 -1
  532. package/dist/registry/scanning.d.ts +7 -0
  533. package/dist/registry/scanning.d.ts.map +1 -0
  534. package/dist/registry/scanning.js +13 -0
  535. package/dist/registry/scanning.js.map +1 -0
  536. package/dist/registry/ship-stats-snapshot.js +19 -19
  537. package/dist/registry/ship-stats-snapshot.js.map +1 -1
  538. package/dist/registry/ships.d.ts +22 -2
  539. package/dist/registry/ships.d.ts.map +1 -1
  540. package/dist/registry/ships.js +28 -4
  541. package/dist/registry/ships.js.map +1 -1
  542. package/dist/registry/xp-runtime.d.ts +4 -0
  543. package/dist/registry/xp-runtime.d.ts.map +1 -0
  544. package/dist/registry/xp-runtime.js +14 -0
  545. package/dist/registry/xp-runtime.js.map +1 -0
  546. package/dist/scanning/actions/index.d.ts +116 -0
  547. package/dist/scanning/actions/index.d.ts.map +1 -0
  548. package/dist/scanning/actions/index.js +185 -0
  549. package/dist/scanning/actions/index.js.map +1 -0
  550. package/dist/scanning/index.d.ts +4 -1
  551. package/dist/scanning/index.d.ts.map +1 -1
  552. package/dist/scanning/index.js +12 -8
  553. package/dist/scanning/index.js.map +1 -1
  554. package/dist/scanning/lifecycle.d.ts +77 -0
  555. package/dist/scanning/lifecycle.d.ts.map +1 -0
  556. package/dist/scanning/lifecycle.js +93 -0
  557. package/dist/scanning/lifecycle.js.map +1 -0
  558. package/dist/scanning/odds.d.ts +111 -0
  559. package/dist/scanning/odds.d.ts.map +1 -0
  560. package/dist/scanning/odds.js +294 -0
  561. package/dist/scanning/odds.js.map +1 -0
  562. package/dist/scanning/signals.d.ts +121 -0
  563. package/dist/scanning/signals.d.ts.map +1 -0
  564. package/dist/scanning/signals.js +171 -0
  565. package/dist/scanning/signals.js.map +1 -0
  566. package/dist/world/index.d.ts +110 -5
  567. package/dist/world/index.d.ts.map +1 -1
  568. package/dist/world/index.js +109 -4
  569. package/dist/world/index.js.map +1 -1
  570. package/dist/world/planet-claim-stake-plots.d.ts +130 -0
  571. package/dist/world/planet-claim-stake-plots.d.ts.map +1 -0
  572. package/dist/world/planet-claim-stake-plots.js +110 -0
  573. package/dist/world/planet-claim-stake-plots.js.map +1 -0
  574. package/dist/world/starbase-status.d.ts +176 -0
  575. package/dist/world/starbase-status.d.ts.map +1 -0
  576. package/dist/world/starbase-status.js +153 -0
  577. package/dist/world/starbase-status.js.map +1 -0
  578. package/package.json +10 -2
@@ -1,9 +1,24 @@
1
+ import { normalizeFleetDockFundingGuard, dockFundingGuardToJSON, validateFleetDockFundingGuards, } from '../internal/planning/fleet-dock-funding-guard.js';
2
+ import { normalizeLocalMarketOrderGuard, localMarketOrderGuardToJSON, validateLocalMarketOrderInstructions, } from '../internal/planning/local-market-order.js';
3
+ import { validateCrewTransferInstructions, } from '../internal/planning/fleet-crew-guard.js';
4
+ import { validateCompletionInstructions, scanCompletionDiscriminators, } from '../internal/planning/scan-completion-guard.js';
5
+ import { validateOpenSignalInstructions } from '../internal/planning/open-signal-guard.js';
6
+ import { validateDetectInstructions, } from '../internal/planning/scan-detect-guard.js';
7
+ import { validateRespawnInstructions } from '../internal/planning/respawn-guards.js';
8
+ import { validateFleetAttackInstructions, } from '../internal/planning/fleet-attack-xp.js';
9
+ import { validateMovementXpInstructions } from '../internal/planning/movement-xp-guard.js';
10
+ import { validateFleetDockingGuards } from '../internal/planning/fleet-docking-guard.js';
11
+ import { validateStarbaseSystemInstructions, validateStarbaseSystemGuards, } from '../internal/planning/starbase-system-guard.js';
12
+ import { validateCharacterRegistrationInstructions } from '../internal/planning/character-registration-guard.js';
13
+ import { normalizeArrivalGuard, arrivalGuardToJSON, validateArrivalInstructions, } from '../internal/planning/arrival-guards.js';
14
+ import { isRuntimeGuard, normalizeRuntimeGuard, runtimeGuardToJSON, validateRuntimeInstructions, } from '../internal/planning/runtime-guards.js';
15
+ import { isTradeBuyGuard, isTradeSellGuard, isTradeMeterGuard, isFactionTradeGuard, } from '../internal/planning/faction-trade-guards.js';
1
16
  import { AccountRole, getBase64Decoder, getBase64Encoder, isAddress, isWritableRole, } from '@solana/kit';
2
- import { InvalidActionInputError } from '../client/errors.js';
17
+ import { InvalidActionInputError, SageSdkError } from '../client/errors.js';
3
18
  import { deepFreeze } from '../internal/immutable-tree.js';
19
+ import { validateMiningStopInstructions } from '../internal/planning/mining-stop.js';
4
20
  import { validatePlanComposition } from './composition.js';
5
21
  import { isPlanInstance, registerPlanInstance } from './plan-instances.js';
6
- const PLAN_BRAND = Symbol('AephiaSagePlan');
7
22
  const BASE64_PATTERN = /^(?:[A-Za-z\d+/]{4})*(?:[A-Za-z\d+/]{2}==|[A-Za-z\d+/]{3}=)?$/u;
8
23
  const DATA_HASH_PATTERN = /^[\da-f]{64}$/u;
9
24
  const ACCOUNT_ROLES = new Set([
@@ -138,7 +153,7 @@ function normalizeSemanticFact(value, field) {
138
153
  if (semantic.scope !== 'transaction') {
139
154
  return invalid(`${field}.scope`, semantic.scope, 'the token "transaction"');
140
155
  }
141
- return { kind: 'exclusive', scope: 'transaction' };
156
+ return Object.freeze({ kind: 'exclusive', scope: 'transaction' });
142
157
  }
143
158
  if (semantic.kind === 'requires' || semantic.kind === 'invalidates') {
144
159
  assertKeys(semantic, field, ['kind', 'resource', 'fact']);
@@ -159,9 +174,604 @@ function normalizeSemanticFact(value, field) {
159
174
  }
160
175
  return invalid(`${field}.kind`, semantic.kind, 'one of exclusive, requires, invalidates, or transition');
161
176
  }
162
- function normalizePrecondition(value, field, version = 6) {
177
+ function normalizePrecondition(value, field) {
163
178
  const precondition = readRecord(value, field);
164
- if (version >= 6 && precondition.kind === 'game-ship-config') {
179
+ if (precondition.kind === 'fleet-arrival')
180
+ return normalizeArrivalGuard(precondition, field);
181
+ if (isRuntimeGuard(precondition))
182
+ return normalizeRuntimeGuard(precondition, field);
183
+ if (precondition.kind === 'character-registration') {
184
+ assertKeys(precondition, field, [
185
+ 'kind',
186
+ 'address',
187
+ 'game',
188
+ 'profile',
189
+ 'profileDataHash',
190
+ 'funder',
191
+ 'xpBudget',
192
+ 'xpBudgetConfig',
193
+ 'maximumFunderDebit',
194
+ 'characterSize',
195
+ 'initializationHash',
196
+ 'characterLamports',
197
+ 'budgetLamports',
198
+ 'describes',
199
+ ]);
200
+ if (typeof precondition.characterSize !== 'number' ||
201
+ !Number.isSafeInteger(precondition.characterSize) ||
202
+ precondition.characterSize < 423)
203
+ invalid(`${field}.characterSize`, precondition.characterSize, 'a qualified Character allocation of at least 423 bytes');
204
+ for (const key of ['characterLamports', 'budgetLamports'])
205
+ if (typeof precondition[key] !== 'bigint' || precondition[key] < 0n)
206
+ invalid(`${field}.${key}`, precondition[key], 'a nonnegative bigint');
207
+ const maximumFunderDebit = precondition.maximumFunderDebit;
208
+ if (typeof maximumFunderDebit !== 'bigint' || maximumFunderDebit < 0n)
209
+ invalid(`${field}.maximumFunderDebit`, maximumFunderDebit, 'a nonnegative bigint');
210
+ return Object.freeze({
211
+ kind: 'character-registration',
212
+ address: readAddress(precondition.address, `${field}.address`),
213
+ game: readAddress(precondition.game, `${field}.game`),
214
+ profile: readAddress(precondition.profile, `${field}.profile`),
215
+ profileDataHash: readDataHash(precondition.profileDataHash, `${field}.profileDataHash`),
216
+ funder: readAddress(precondition.funder, `${field}.funder`),
217
+ xpBudget: readAddress(precondition.xpBudget, `${field}.xpBudget`),
218
+ xpBudgetConfig: readAddress(precondition.xpBudgetConfig, `${field}.xpBudgetConfig`),
219
+ maximumFunderDebit,
220
+ characterLamports: precondition.characterLamports,
221
+ budgetLamports: precondition.budgetLamports,
222
+ characterSize: precondition.characterSize,
223
+ initializationHash: readDataHash(precondition.initializationHash, `${field}.initializationHash`),
224
+ describes: readString(precondition.describes, `${field}.describes`),
225
+ });
226
+ }
227
+ if (precondition.kind === 'ship-import-funding') {
228
+ assertKeys(precondition, field, [
229
+ 'kind',
230
+ 'address',
231
+ 'game',
232
+ 'profile',
233
+ 'system',
234
+ 'shipId',
235
+ 'maximumProfileDebit',
236
+ 'describes',
237
+ ]);
238
+ const shipId = precondition.shipId;
239
+ if (typeof shipId !== 'number' ||
240
+ !Number.isInteger(shipId) ||
241
+ shipId < 0 ||
242
+ shipId > 65535)
243
+ invalid(`${field}.shipId`, shipId, 'an unsigned u16 ship configuration ID');
244
+ const maximumProfileDebit = precondition.maximumProfileDebit;
245
+ if (typeof maximumProfileDebit !== 'bigint' || maximumProfileDebit < 0n)
246
+ invalid(`${field}.maximumProfileDebit`, maximumProfileDebit, 'a nonnegative bigint');
247
+ return Object.freeze({
248
+ kind: 'ship-import-funding',
249
+ address: readAddress(precondition.address, `${field}.address`),
250
+ game: readAddress(precondition.game, `${field}.game`),
251
+ profile: readAddress(precondition.profile, `${field}.profile`),
252
+ system: readAddress(precondition.system, `${field}.system`),
253
+ shipId,
254
+ maximumProfileDebit,
255
+ describes: readString(precondition.describes, `${field}.describes`),
256
+ });
257
+ }
258
+ if (precondition.kind === 'fleet-attack') {
259
+ assertKeys(precondition, field, [
260
+ 'kind',
261
+ 'address',
262
+ 'defender',
263
+ 'game',
264
+ 'profile',
265
+ 'defenderProfile',
266
+ 'instructionKey',
267
+ 'describes',
268
+ ]);
269
+ return Object.freeze({
270
+ kind: 'fleet-attack',
271
+ address: readAddress(precondition.address, `${field}.address`),
272
+ defender: readAddress(precondition.defender, `${field}.defender`),
273
+ game: readAddress(precondition.game, `${field}.game`),
274
+ profile: readAddress(precondition.profile, `${field}.profile`),
275
+ defenderProfile: readAddress(precondition.defenderProfile, `${field}.defenderProfile`),
276
+ instructionKey: readString(precondition.instructionKey, `${field}.instructionKey`),
277
+ describes: readString(precondition.describes, `${field}.describes`),
278
+ });
279
+ }
280
+ if (precondition.kind === 'movement-character') {
281
+ assertKeys(precondition, field, [
282
+ 'kind',
283
+ 'address',
284
+ 'game',
285
+ 'profile',
286
+ 'stateHash',
287
+ 'describes',
288
+ ]);
289
+ return Object.freeze({
290
+ kind: 'movement-character',
291
+ address: readAddress(precondition.address, `${field}.address`),
292
+ game: readAddress(precondition.game, `${field}.game`),
293
+ profile: readAddress(precondition.profile, `${field}.profile`),
294
+ stateHash: readDataHash(precondition.stateHash, `${field}.stateHash`),
295
+ describes: readString(precondition.describes, `${field}.describes`),
296
+ });
297
+ }
298
+ if (precondition.kind === 'fleet-docking-policy') {
299
+ assertKeys(precondition, field, [
300
+ 'kind',
301
+ 'address',
302
+ 'game',
303
+ 'system',
304
+ 'ownership',
305
+ 'describes',
306
+ ]);
307
+ return Object.freeze({
308
+ kind: 'fleet-docking-policy',
309
+ address: readAddress(precondition.address, `${field}.address`),
310
+ game: readAddress(precondition.game, `${field}.game`),
311
+ system: readAddress(precondition.system, `${field}.system`),
312
+ ownership: readAddress(precondition.ownership, `${field}.ownership`),
313
+ describes: readString(precondition.describes, `${field}.describes`),
314
+ });
315
+ }
316
+ if (precondition.kind === 'starbase-system') {
317
+ assertKeys(precondition, field, ['kind', 'address', 'game', 'starbaseSequenceId', 'describes'], ['requireCss']);
318
+ if (precondition.requireCss !== undefined &&
319
+ precondition.requireCss !== true)
320
+ invalid(`${field}.requireCss`, precondition.requireCss, 'true when CSS access is required, otherwise omitted');
321
+ const sequence = precondition.starbaseSequenceId;
322
+ if (typeof sequence !== 'bigint' ||
323
+ sequence < 0n ||
324
+ sequence > 18446744073709551615n)
325
+ invalid(`${field}.starbaseSequenceId`, sequence, 'an unsigned u64 Starbase sequence');
326
+ return Object.freeze({
327
+ kind: 'starbase-system',
328
+ address: readAddress(precondition.address, `${field}.address`),
329
+ game: readAddress(precondition.game, `${field}.game`),
330
+ starbaseSequenceId: sequence,
331
+ ...(precondition.requireCss === undefined
332
+ ? {}
333
+ : { requireCss: true }),
334
+ describes: readString(precondition.describes, `${field}.describes`),
335
+ });
336
+ }
337
+ if (precondition.kind === 'fleet-mining') {
338
+ assertKeys(precondition, field, [
339
+ 'kind',
340
+ 'address',
341
+ 'game',
342
+ 'profile',
343
+ 'asteroid',
344
+ 'describes',
345
+ ]);
346
+ return Object.freeze({
347
+ kind: 'fleet-mining',
348
+ address: readAddress(precondition.address, `${field}.address`),
349
+ game: readAddress(precondition.game, `${field}.game`),
350
+ profile: readAddress(precondition.profile, `${field}.profile`),
351
+ asteroid: readAddress(precondition.asteroid, `${field}.asteroid`),
352
+ describes: readString(precondition.describes, `${field}.describes`),
353
+ });
354
+ }
355
+ if (isFactionTradeGuard(precondition)) {
356
+ const kind = precondition.kind;
357
+ assertKeys(precondition, field, [
358
+ 'kind',
359
+ 'address',
360
+ 'game',
361
+ 'factionId',
362
+ 'describes',
363
+ 'schemaVersion',
364
+ ...(isTradeBuyGuard(precondition)
365
+ ? ['cargoId', 'floorRaw']
366
+ : isTradeSellGuard(precondition)
367
+ ? ['atlasOutCapPerEpochRaw', 'epochLengthSeconds']
368
+ : []),
369
+ ]);
370
+ const unsigned = (key, max = 65535) => {
371
+ const n = precondition[key];
372
+ if (typeof n !== 'number' || !Number.isInteger(n) || n < 0 || n > max)
373
+ invalid(`${field}.${key}`, n, `an unsigned ${max === 255 ? 'u8' : 'u16'} integer`);
374
+ return n;
375
+ };
376
+ const integer = (key, signed = false) => {
377
+ const n = precondition[key];
378
+ const min = signed ? -(1n << 63n) : 0n;
379
+ const max = signed ? (1n << 63n) - 1n : (1n << 64n) - 1n;
380
+ if (typeof n !== 'bigint' || n < min || n > max)
381
+ invalid(`${field}.${key}`, n, signed ? 'an i64 bigint' : 'a u64 bigint');
382
+ return n;
383
+ };
384
+ const common = {
385
+ address: readAddress(precondition.address, `${field}.address`),
386
+ game: readAddress(precondition.game, `${field}.game`),
387
+ factionId: unsigned('factionId'),
388
+ schemaVersion: unsigned('schemaVersion', 255),
389
+ describes: readString(precondition.describes, `${field}.describes`),
390
+ };
391
+ if (isTradeBuyGuard(precondition))
392
+ return Object.freeze({
393
+ kind,
394
+ ...common,
395
+ cargoId: unsigned('cargoId'),
396
+ floorRaw: integer('floorRaw'),
397
+ });
398
+ if (isTradeSellGuard(precondition))
399
+ return Object.freeze({
400
+ kind,
401
+ ...common,
402
+ atlasOutCapPerEpochRaw: integer('atlasOutCapPerEpochRaw'),
403
+ epochLengthSeconds: integer('epochLengthSeconds', true),
404
+ });
405
+ return Object.freeze({ kind, ...common });
406
+ }
407
+ if (precondition.kind === 'fleet-add-ship') {
408
+ assertKeys(precondition, field, [
409
+ 'kind',
410
+ 'address',
411
+ 'game',
412
+ 'profile',
413
+ 'authority',
414
+ 'system',
415
+ 'shipId',
416
+ 'amount',
417
+ 'keyIndex',
418
+ 'configHash',
419
+ 'maximumProfileDebit',
420
+ 'describes',
421
+ ]);
422
+ const keyIndex = precondition.keyIndex;
423
+ if (typeof keyIndex !== 'number' ||
424
+ !Number.isInteger(keyIndex) ||
425
+ keyIndex < 0 ||
426
+ keyIndex > 65535)
427
+ invalid(`${field}.keyIndex`, keyIndex, 'an integer from 0 through 65535');
428
+ const shipId = precondition.shipId;
429
+ if (typeof shipId !== 'number' ||
430
+ !Number.isInteger(shipId) ||
431
+ shipId < 0 ||
432
+ shipId > 65535)
433
+ invalid(`${field}.shipId`, shipId, 'a u16 ship configuration ID');
434
+ const amount = precondition.amount;
435
+ if (typeof amount !== 'bigint' || amount < 1n || amount > 255n)
436
+ invalid(`${field}.amount`, amount, 'a whole ship quantity from 1n through 255n');
437
+ const maximumProfileDebit = precondition.maximumProfileDebit;
438
+ if (typeof maximumProfileDebit !== 'bigint' || maximumProfileDebit < 0n)
439
+ invalid(`${field}.maximumProfileDebit`, maximumProfileDebit, 'a nonnegative bigint');
440
+ return Object.freeze({
441
+ kind: 'fleet-add-ship',
442
+ address: readAddress(precondition.address, `${field}.address`),
443
+ game: readAddress(precondition.game, `${field}.game`),
444
+ profile: readAddress(precondition.profile, `${field}.profile`),
445
+ authority: readAddress(precondition.authority, `${field}.authority`),
446
+ system: readAddress(precondition.system, `${field}.system`),
447
+ keyIndex,
448
+ shipId,
449
+ amount,
450
+ maximumProfileDebit,
451
+ configHash: readDataHash(precondition.configHash, `${field}.configHash`),
452
+ describes: readString(precondition.describes, `${field}.describes`),
453
+ });
454
+ }
455
+ if (precondition.kind === 'scan-completion') {
456
+ const addresses = [
457
+ 'address',
458
+ 'game',
459
+ 'signal',
460
+ 'profile',
461
+ 'character',
462
+ 'authority',
463
+ 'policy',
464
+ 'loot',
465
+ 'xpBudget',
466
+ 'xpConfig',
467
+ ];
468
+ assertKeys(precondition, field, [
469
+ 'kind',
470
+ 'operation',
471
+ ...addresses,
472
+ 'keyIndex',
473
+ 'status',
474
+ 'expectedSequence',
475
+ 'configHash',
476
+ 'describes',
477
+ ]);
478
+ if (typeof precondition.operation !== 'string' ||
479
+ !Object.hasOwn(scanCompletionDiscriminators, precondition.operation))
480
+ invalid(field, precondition.operation, 'a supported scan lifecycle operation');
481
+ const keyIndex = precondition.keyIndex, status = precondition.status, sequence = precondition.expectedSequence;
482
+ if (typeof keyIndex !== 'number' ||
483
+ !Number.isInteger(keyIndex) ||
484
+ keyIndex < 0 ||
485
+ keyIndex > 65535)
486
+ invalid(field, keyIndex, 'a u16 key index');
487
+ if (typeof status !== 'number' ||
488
+ !Number.isInteger(status) ||
489
+ status < 1 ||
490
+ status > 6)
491
+ invalid(field, status, 'a current nonempty signal state');
492
+ if (typeof sequence !== 'bigint' ||
493
+ sequence < 0n ||
494
+ sequence > 18446744073709551615n)
495
+ invalid(field, sequence, 'a u64 sequence');
496
+ const parsed = Object.fromEntries(addresses.map((k) => [k, readAddress(precondition[k], `${field}.${k}`)]));
497
+ return Object.freeze({
498
+ kind: 'scan-completion',
499
+ operation: precondition.operation,
500
+ ...parsed,
501
+ keyIndex,
502
+ status,
503
+ expectedSequence: sequence,
504
+ configHash: readDataHash(precondition.configHash, field),
505
+ describes: readString(precondition.describes, field),
506
+ });
507
+ }
508
+ if (precondition.kind === 'scan-detect') {
509
+ assertKeys(precondition, field, [
510
+ 'kind',
511
+ 'address',
512
+ 'game',
513
+ 'profile',
514
+ 'authority',
515
+ 'character',
516
+ 'signal',
517
+ 'pattern',
518
+ 'policy',
519
+ 'loot',
520
+ 'tracker',
521
+ 'keyIndex',
522
+ 'patternId',
523
+ 'focus',
524
+ 'expectedSequence',
525
+ 'policyRevision',
526
+ 'profileRevision',
527
+ 'configHash',
528
+ 'describes',
529
+ ]);
530
+ const numbers = {};
531
+ for (const [key, max] of [
532
+ ['keyIndex', 65535],
533
+ ['patternId', 65535],
534
+ ['focus', 4],
535
+ ['policyRevision', 4294967295],
536
+ ['profileRevision', 4294967295],
537
+ ]) {
538
+ const value = precondition[key];
539
+ if (typeof value !== 'number' ||
540
+ !Number.isInteger(value) ||
541
+ value < 0 ||
542
+ value > max)
543
+ invalid(`${field}.${key}`, value, `an integer from zero through ${max}`);
544
+ numbers[key] = value;
545
+ }
546
+ const sequence = precondition.expectedSequence;
547
+ if (typeof sequence !== 'bigint' ||
548
+ sequence < 0n ||
549
+ sequence > 18446744073709551615n)
550
+ invalid(`${field}.expectedSequence`, sequence, 'a u64 bigint');
551
+ return Object.freeze({
552
+ kind: 'scan-detect',
553
+ address: readAddress(precondition.address, field),
554
+ game: readAddress(precondition.game, field),
555
+ profile: readAddress(precondition.profile, field),
556
+ authority: readAddress(precondition.authority, field),
557
+ character: readAddress(precondition.character, field),
558
+ signal: readAddress(precondition.signal, field),
559
+ pattern: readAddress(precondition.pattern, field),
560
+ policy: readAddress(precondition.policy, field),
561
+ loot: readAddress(precondition.loot, field),
562
+ tracker: readAddress(precondition.tracker, field),
563
+ keyIndex: numbers.keyIndex,
564
+ patternId: numbers.patternId,
565
+ focus: numbers.focus,
566
+ policyRevision: numbers.policyRevision,
567
+ profileRevision: numbers.profileRevision,
568
+ expectedSequence: sequence,
569
+ configHash: readDataHash(precondition.configHash, field),
570
+ describes: readString(precondition.describes, field),
571
+ });
572
+ }
573
+ if (precondition.kind === 'fleet-crew-transfer') {
574
+ assertKeys(precondition, field, [
575
+ 'kind',
576
+ 'direction',
577
+ 'address',
578
+ 'game',
579
+ 'profile',
580
+ 'authority',
581
+ 'system',
582
+ 'starbasePlayer',
583
+ 'keyIndex',
584
+ 'count',
585
+ 'systemSequenceId',
586
+ 'describes',
587
+ ]);
588
+ for (const key of ['count', 'keyIndex']) {
589
+ const n = precondition[key];
590
+ if (typeof n !== 'number' ||
591
+ !Number.isInteger(n) ||
592
+ n < (key === 'count' ? 1 : 0) ||
593
+ n > 65535)
594
+ invalid(field, n, 'a positive u16 count and u16 key index');
595
+ }
596
+ const direction = precondition.direction, sequence = precondition.systemSequenceId;
597
+ if (direction !== 'load' && direction !== 'unload')
598
+ invalid(field, direction, 'load or unload');
599
+ if (typeof sequence !== 'bigint' ||
600
+ sequence < 0n ||
601
+ sequence > (1n << 64n) - 1n)
602
+ invalid(field, sequence, 'a u64 System generation');
603
+ return Object.freeze({
604
+ kind: 'fleet-crew-transfer',
605
+ direction,
606
+ address: readAddress(precondition.address, field),
607
+ game: readAddress(precondition.game, field),
608
+ profile: readAddress(precondition.profile, field),
609
+ authority: readAddress(precondition.authority, field),
610
+ system: readAddress(precondition.system, field),
611
+ starbasePlayer: readAddress(precondition.starbasePlayer, field),
612
+ count: precondition.count,
613
+ keyIndex: precondition.keyIndex,
614
+ systemSequenceId: sequence,
615
+ describes: readString(precondition.describes, field),
616
+ });
617
+ }
618
+ if (precondition.kind === 'fleet-respawn') {
619
+ assertKeys(precondition, field, [
620
+ 'kind',
621
+ 'address',
622
+ 'game',
623
+ 'profile',
624
+ 'authority',
625
+ 'system',
626
+ 'keyIndex',
627
+ 'phase',
628
+ 'fleetHash',
629
+ 'maximumRecoveryFee',
630
+ 'maximumProfileDebit',
631
+ 'describes',
632
+ ]);
633
+ const keyIndex = precondition.keyIndex;
634
+ if (typeof keyIndex !== 'number' ||
635
+ !Number.isInteger(keyIndex) ||
636
+ keyIndex < 0 ||
637
+ keyIndex > 65535)
638
+ invalid(`${field}.keyIndex`, keyIndex, 'a u16 key index');
639
+ const phase = precondition.phase;
640
+ if (phase !== 'start' && phase !== 'complete')
641
+ invalid(`${field}.phase`, phase, 'start or complete');
642
+ const maximumRecoveryFee = precondition.maximumRecoveryFee, maximumProfileDebit = precondition.maximumProfileDebit;
643
+ for (const value of [maximumRecoveryFee, maximumProfileDebit])
644
+ if (typeof value !== 'bigint' || value < 0n || value > (1n << 64n) - 1n)
645
+ invalid(field, value, 'a nonnegative u64 funding ceiling');
646
+ return Object.freeze({
647
+ kind: 'fleet-respawn',
648
+ address: readAddress(precondition.address, field),
649
+ game: readAddress(precondition.game, field),
650
+ profile: readAddress(precondition.profile, field),
651
+ authority: readAddress(precondition.authority, field),
652
+ system: readAddress(precondition.system, field),
653
+ keyIndex,
654
+ phase,
655
+ fleetHash: readDataHash(precondition.fleetHash, field),
656
+ maximumRecoveryFee: maximumRecoveryFee,
657
+ maximumProfileDebit: maximumProfileDebit,
658
+ describes: readString(precondition.describes, field),
659
+ });
660
+ }
661
+ if (precondition.kind === 'fleet-dock-funding')
662
+ return normalizeFleetDockFundingGuard(precondition);
663
+ if (precondition.kind === 'local-market-order')
664
+ return normalizeLocalMarketOrderGuard(precondition);
665
+ if (precondition.kind === 'scan-signal-open') {
666
+ assertKeys(precondition, field, [
667
+ 'kind',
668
+ 'address',
669
+ 'game',
670
+ 'fleet',
671
+ 'profile',
672
+ 'authority',
673
+ 'character',
674
+ 'keyIndex',
675
+ 'authorityHash',
676
+ 'maximumProfileDebit',
677
+ 'describes',
678
+ ]);
679
+ const keyIndex = precondition.keyIndex;
680
+ if (typeof keyIndex !== 'number' ||
681
+ !Number.isInteger(keyIndex) ||
682
+ keyIndex < 0 ||
683
+ keyIndex > 65535)
684
+ invalid(field, keyIndex, 'a u16 key index');
685
+ const maximumProfileDebit = precondition.maximumProfileDebit;
686
+ if (typeof maximumProfileDebit !== 'bigint' ||
687
+ maximumProfileDebit < 0n ||
688
+ maximumProfileDebit > 0xffffffffffffffffn)
689
+ invalid(field, maximumProfileDebit, 'a nonnegative u64 funding ceiling');
690
+ return Object.freeze({
691
+ kind: 'scan-signal-open',
692
+ authorityHash: readDataHash(precondition.authorityHash, field),
693
+ address: readAddress(precondition.address, field),
694
+ game: readAddress(precondition.game, field),
695
+ fleet: readAddress(precondition.fleet, field),
696
+ profile: readAddress(precondition.profile, field),
697
+ authority: readAddress(precondition.authority, field),
698
+ character: readAddress(precondition.character, field),
699
+ keyIndex,
700
+ maximumProfileDebit,
701
+ describes: readString(precondition.describes, field),
702
+ });
703
+ }
704
+ if (precondition.kind === 'fleet-create') {
705
+ assertKeys(precondition, field, [
706
+ 'kind',
707
+ 'address',
708
+ 'game',
709
+ 'profile',
710
+ 'authority',
711
+ 'system',
712
+ 'keyIndex',
713
+ 'label',
714
+ 'maximumProfileDebit',
715
+ 'describes',
716
+ ]);
717
+ const keyIndex = precondition.keyIndex;
718
+ if (typeof keyIndex !== 'number' ||
719
+ !Number.isSafeInteger(keyIndex) ||
720
+ keyIndex < 0 ||
721
+ keyIndex > 65_535)
722
+ invalid(`${field}.keyIndex`, keyIndex, 'an integer from 0 through 65535');
723
+ const label = readString(precondition.label, `${field}.label`);
724
+ const bytes = new TextEncoder().encode(label);
725
+ if (label.trim().length === 0 ||
726
+ label.includes('\0') ||
727
+ bytes.length > 64 ||
728
+ new TextDecoder('utf-8', { ignoreBOM: true }).decode(bytes) !== label)
729
+ invalid(`${field}.label`, label, 'a nonblank, NUL-free Unicode label of at most 64 UTF-8 bytes');
730
+ const maximumProfileDebit = precondition.maximumProfileDebit;
731
+ if (typeof maximumProfileDebit !== 'bigint' || maximumProfileDebit < 0n)
732
+ invalid(`${field}.maximumProfileDebit`, maximumProfileDebit, 'a nonnegative bigint');
733
+ return Object.freeze({
734
+ kind: 'fleet-create',
735
+ address: readAddress(precondition.address, `${field}.address`),
736
+ game: readAddress(precondition.game, `${field}.game`),
737
+ profile: readAddress(precondition.profile, `${field}.profile`),
738
+ authority: readAddress(precondition.authority, `${field}.authority`),
739
+ system: readAddress(precondition.system, `${field}.system`),
740
+ keyIndex,
741
+ label,
742
+ maximumProfileDebit,
743
+ describes: readString(precondition.describes, `${field}.describes`),
744
+ });
745
+ }
746
+ if (precondition.kind === 'system-account-or-absent') {
747
+ assertKeys(precondition, field, ['kind', 'address', 'describes']);
748
+ return Object.freeze({
749
+ kind: 'system-account-or-absent',
750
+ address: readAddress(precondition.address, `${field}.address`),
751
+ describes: readString(precondition.describes, `${field}.describes`),
752
+ });
753
+ }
754
+ if (precondition.kind === 'token-mint') {
755
+ assertKeys(precondition, field, [
756
+ 'kind',
757
+ 'address',
758
+ 'decimals',
759
+ 'describes',
760
+ ]);
761
+ const decimals = precondition.decimals;
762
+ if (typeof decimals !== 'number' ||
763
+ !Number.isInteger(decimals) ||
764
+ decimals < 0 ||
765
+ decimals > 255)
766
+ invalid(`${field}.decimals`, decimals, 'an unsigned u8 mint decimals value');
767
+ return Object.freeze({
768
+ kind: 'token-mint',
769
+ address: readAddress(precondition.address, `${field}.address`),
770
+ decimals,
771
+ describes: readString(precondition.describes, `${field}.describes`),
772
+ });
773
+ }
774
+ if (precondition.kind === 'game-ship-config') {
165
775
  assertKeys(precondition, field, [
166
776
  'kind',
167
777
  'address',
@@ -180,7 +790,7 @@ function normalizePrecondition(value, field, version = 6) {
180
790
  describes: readString(precondition.describes, `${field}.describes`),
181
791
  });
182
792
  }
183
- if (version >= 5 && precondition.kind === 'game-account') {
793
+ if (precondition.kind === 'game-account') {
184
794
  assertKeys(precondition, field, ['kind', 'address', 'describes']);
185
795
  return Object.freeze({
186
796
  kind: 'game-account',
@@ -188,8 +798,7 @@ function normalizePrecondition(value, field, version = 6) {
188
798
  describes: readString(precondition.describes, `${field}.describes`),
189
799
  });
190
800
  }
191
- if (version >= 4 &&
192
- ['token-account', 'game-cargo-config', 'cargo-cache'].includes(String(precondition.kind))) {
801
+ if (['game-cargo-bytes-config', 'token-account', 'cargo-cache'].includes(String(precondition.kind))) {
193
802
  const base = {
194
803
  address: readAddress(precondition.address, `${field}.address`),
195
804
  describes: readString(precondition.describes, `${field}.describes`),
@@ -216,7 +825,7 @@ function normalizePrecondition(value, field, version = 6) {
216
825
  minimumBalance: amount,
217
826
  });
218
827
  }
219
- if (precondition.kind === 'game-cargo-config') {
828
+ if (precondition.kind === 'game-cargo-bytes-config') {
220
829
  assertKeys(precondition, field, [
221
830
  'kind',
222
831
  'address',
@@ -232,7 +841,7 @@ function normalizePrecondition(value, field, version = 6) {
232
841
  invalid(`${field}.cargoId`, id, 'a u16 cargo ID');
233
842
  return Object.freeze({
234
843
  ...base,
235
- kind: 'game-cargo-config',
844
+ kind: precondition.kind,
236
845
  cargoId: id,
237
846
  configHash: readDataHash(precondition.configHash, `${field}.configHash`),
238
847
  });
@@ -257,7 +866,7 @@ function normalizePrecondition(value, field, version = 6) {
257
866
  bump,
258
867
  });
259
868
  }
260
- if (precondition.kind === 'token-account-or-absent' && version >= 3) {
869
+ if (precondition.kind === 'token-account-or-absent') {
261
870
  assertKeys(precondition, field, [
262
871
  'kind',
263
872
  'address',
@@ -273,7 +882,7 @@ function normalizePrecondition(value, field, version = 6) {
273
882
  describes: readString(precondition.describes, `${field}.describes`),
274
883
  });
275
884
  }
276
- if (precondition.kind === 'account-absent' && version !== 1) {
885
+ if (precondition.kind === 'account-absent') {
277
886
  assertKeys(precondition, field, ['kind', 'address', 'describes']);
278
887
  return Object.freeze({
279
888
  kind: 'account-absent',
@@ -282,17 +891,7 @@ function normalizePrecondition(value, field, version = 6) {
282
891
  });
283
892
  }
284
893
  if (precondition.kind !== 'account-state') {
285
- invalid(`${field}.kind`, precondition.kind, version === 6
286
- ? 'one of account-state, account-absent, token-account-or-absent, token-account, game-cargo-config, cargo-cache, game-account, or game-ship-config'
287
- : version === 5
288
- ? 'one of account-state, account-absent, token-account-or-absent, token-account, game-cargo-config, cargo-cache, or game-account'
289
- : version === 4
290
- ? 'one of account-state, account-absent, token-account-or-absent, token-account, game-cargo-config, or cargo-cache'
291
- : version === 3
292
- ? 'one of account-state, account-absent, or token-account-or-absent'
293
- : version === 2
294
- ? 'one of account-state or account-absent'
295
- : 'the value account-state');
894
+ invalid(`${field}.kind`, precondition.kind, 'a supported current Plan guard; recreate the Plan using the current capability planner');
296
895
  }
297
896
  assertKeys(precondition, field, ['kind', 'address', 'dataHash', 'describes']);
298
897
  return Object.freeze({
@@ -328,84 +927,76 @@ function instructionToJSON(instruction) {
328
927
  return deepFreeze(value);
329
928
  }
330
929
  function planToJSON(plan) {
331
- const hasSemantics = plan.steps.some((step) => (step.semantics?.length ?? 0) > 0);
332
- const hasAbsentPrecondition = plan.preconditions.some(({ kind }) => kind === 'account-absent');
333
- const common = {
930
+ return deepFreeze({
931
+ v: 27,
334
932
  kind: plan.kind,
335
933
  summary: plan.summary,
336
934
  affected: [...plan.affected],
337
935
  requiredSigners: [...plan.requiredSigners],
338
- };
339
- const steps = plan.steps.map((step) => ({
340
- instruction: instructionToJSON(step.instruction),
341
- describes: step.describes,
342
- ...((step.semantics?.length ?? 0) > 0
343
- ? { semantics: step.semantics.map((semantic) => ({ ...semantic })) }
344
- : {}),
345
- signers: [...step.signers],
346
- }));
347
- if (plan.preconditions.some(({ kind }) => kind === 'game-ship-config')) {
348
- return deepFreeze({
349
- v: 6,
350
- ...common,
351
- steps,
352
- preconditions: plan.preconditions.map((guard) => guard.kind === 'token-account'
353
- ? { ...guard, minimumBalance: String(guard.minimumBalance) }
354
- : { ...guard }),
355
- });
356
- }
357
- if (plan.preconditions.some(({ kind }) => kind === 'game-account')) {
358
- return deepFreeze({
359
- v: 5,
360
- ...common,
361
- steps,
362
- preconditions: plan.preconditions.map((guard) => guard.kind === 'token-account'
363
- ? { ...guard, minimumBalance: String(guard.minimumBalance) }
364
- : { ...guard }),
365
- });
366
- }
367
- if (plan.preconditions.some(({ kind }) => kind === 'token-account' ||
368
- kind === 'game-cargo-config' ||
369
- kind === 'cargo-cache')) {
370
- return deepFreeze({
371
- v: 4,
372
- ...common,
373
- steps,
374
- preconditions: plan.preconditions.map((guard) => guard.kind === 'token-account'
375
- ? { ...guard, minimumBalance: String(guard.minimumBalance) }
376
- : { ...guard }),
377
- });
378
- }
379
- if (plan.preconditions.some(({ kind }) => kind === 'token-account-or-absent')) {
380
- return deepFreeze({
381
- v: 3,
382
- ...common,
383
- steps,
384
- preconditions: plan.preconditions.map((guard) => ({
385
- ...guard,
386
- })),
387
- });
388
- }
389
- if (hasSemantics || hasAbsentPrecondition) {
390
- return deepFreeze({
391
- v: 2,
392
- ...common,
393
- steps,
394
- preconditions: plan.preconditions.map((guard) => ({
395
- ...guard,
396
- })),
397
- });
398
- }
399
- return deepFreeze({
400
- v: 1,
401
- ...common,
402
- steps,
403
- preconditions: plan.preconditions.map((precondition) => ({
404
- kind: 'account-state',
405
- address: precondition.address,
406
- dataHash: precondition.dataHash,
407
- describes: precondition.describes,
936
+ steps: plan.steps.map((step) => ({
937
+ instruction: instructionToJSON(step.instruction),
938
+ describes: step.describes,
939
+ ...((step.semantics?.length ?? 0) > 0
940
+ ? { semantics: step.semantics.map((semantic) => ({ ...semantic })) }
941
+ : {}),
942
+ signers: [...step.signers],
408
943
  })),
944
+ preconditions: plan.preconditions.map((guard) => {
945
+ if (guard.kind === 'scan-detect' || guard.kind === 'scan-completion')
946
+ return { ...guard, expectedSequence: String(guard.expectedSequence) };
947
+ if (guard.kind === 'fleet-dock-funding')
948
+ return dockFundingGuardToJSON(guard);
949
+ if (guard.kind === 'fleet-arrival')
950
+ return arrivalGuardToJSON(guard);
951
+ if (guard.kind === 'fleet-crew-transfer')
952
+ return { ...guard, systemSequenceId: String(guard.systemSequenceId) };
953
+ if (guard.kind === 'fleet-respawn')
954
+ return {
955
+ ...guard,
956
+ maximumRecoveryFee: String(guard.maximumRecoveryFee),
957
+ maximumProfileDebit: String(guard.maximumProfileDebit),
958
+ };
959
+ if (isRuntimeGuard(guard))
960
+ return runtimeGuardToJSON(guard);
961
+ if (isTradeBuyGuard(guard))
962
+ return { ...guard, floorRaw: String(guard.floorRaw) };
963
+ if (isTradeSellGuard(guard))
964
+ return {
965
+ ...guard,
966
+ atlasOutCapPerEpochRaw: String(guard.atlasOutCapPerEpochRaw),
967
+ epochLengthSeconds: String(guard.epochLengthSeconds),
968
+ };
969
+ if (guard.kind === 'fleet-add-ship')
970
+ return {
971
+ ...guard,
972
+ amount: String(guard.amount),
973
+ maximumProfileDebit: String(guard.maximumProfileDebit),
974
+ };
975
+ if (guard.kind === 'character-registration')
976
+ return {
977
+ ...guard,
978
+ maximumFunderDebit: String(guard.maximumFunderDebit),
979
+ characterLamports: String(guard.characterLamports),
980
+ budgetLamports: String(guard.budgetLamports),
981
+ };
982
+ if (guard.kind === 'scan-signal-open' ||
983
+ guard.kind === 'fleet-create' ||
984
+ guard.kind === 'ship-import-funding')
985
+ return {
986
+ ...guard,
987
+ maximumProfileDebit: String(guard.maximumProfileDebit),
988
+ };
989
+ if (guard.kind === 'starbase-system')
990
+ return {
991
+ ...guard,
992
+ starbaseSequenceId: String(guard.starbaseSequenceId),
993
+ };
994
+ if (guard.kind === 'local-market-order')
995
+ return localMarketOrderGuardToJSON(guard);
996
+ if (guard.kind === 'token-account')
997
+ return { ...guard, minimumBalance: String(guard.minimumBalance) };
998
+ return { ...guard };
999
+ }),
409
1000
  });
410
1001
  }
411
1002
  /** Creates an inert branded Plan while deriving every aggregate field.
@@ -427,6 +1018,16 @@ export function createPlan(input) {
427
1018
  assertKeys(value, 'plan', ['kind', 'summary', 'steps', 'preconditions']);
428
1019
  const steps = Object.freeze(readArray(value.steps, 'plan.steps').map((step, index) => normalizeStep(step, `plan.steps[${String(index)}]`)));
429
1020
  const preconditions = Object.freeze(readArray(value.preconditions, 'plan.preconditions').map((precondition, index) => normalizePrecondition(precondition, `plan.preconditions[${String(index)}]`)));
1021
+ validateShipImportFundingComposition(preconditions);
1022
+ validateStarbaseSystemGuards(steps, preconditions);
1023
+ validateFleetDockingGuards(steps, preconditions);
1024
+ validateFleetDockFundingGuards(steps, preconditions);
1025
+ validateDetectInstructions(steps, preconditions);
1026
+ validateCompletionInstructions(steps, preconditions);
1027
+ validateRespawnInstructions(steps, preconditions);
1028
+ validateCrewTransferInstructions(steps, preconditions);
1029
+ validateOpenSignalInstructions(steps, preconditions);
1030
+ validateLocalMarketOrderInstructions(steps, preconditions);
430
1031
  const descriptions = Object.freeze(steps.map((step) => step.describes));
431
1032
  const plan = {
432
1033
  kind: readString(value.kind, 'plan.kind'),
@@ -438,7 +1039,6 @@ export function createPlan(input) {
438
1039
  describe: () => descriptions,
439
1040
  toJSON: () => planToJSON(plan),
440
1041
  };
441
- Object.defineProperty(plan, PLAN_BRAND, { value: true });
442
1042
  registerPlanInstance(plan);
443
1043
  return Object.freeze(plan);
444
1044
  }
@@ -473,7 +1073,7 @@ function sameAddresses(actual, encoded) {
473
1073
  *
474
1074
  * @example
475
1075
  * ```ts
476
- * declare const wire: PlanJsonV1 | PlanJsonV2 | PlanJsonV3 | PlanJsonV4 | PlanJsonV5 | PlanJsonV6;
1076
+ * declare const wire: PlanJson;
477
1077
  * const plan = planFromJSON(wire);
478
1078
  * console.log(plan.describe());
479
1079
  * ```
@@ -489,34 +1089,116 @@ export function planFromJSON(json) {
489
1089
  'affected',
490
1090
  'requiredSigners',
491
1091
  ]);
492
- if (value.v !== 1 &&
493
- value.v !== 2 &&
494
- value.v !== 3 &&
495
- value.v !== 4 &&
496
- value.v !== 5 &&
497
- value.v !== 6) {
498
- invalid('planJson.v', value.v, 'the Plan wire version 1, 2, 3, 4, 5, or 6');
499
- }
500
- const version = value.v;
501
- if (version >= 4 && Array.isArray(value.preconditions)) {
502
- value.preconditions = value.preconditions.map((entry) => {
503
- const guard = readRecord(entry, 'precondition');
504
- if (guard.kind !== 'token-account')
505
- return guard;
506
- if (typeof guard.minimumBalance !== 'string' ||
507
- !/^(0|[1-9][0-9]*)$/.test(guard.minimumBalance))
508
- invalid('minimumBalance', guard.minimumBalance, 'a canonical unsigned decimal string');
509
- return { ...guard, minimumBalance: BigInt(guard.minimumBalance) };
510
- });
1092
+ if (value.v !== 27) {
1093
+ throw new InvalidActionInputError('planJson.v', value.v, 'the current Plan wire version 27', 'Recreate the Plan using the current capability planner; do not change its saved version or migrate its guards.');
511
1094
  }
1095
+ value.preconditions = readArray(value.preconditions, 'planJson.preconditions').map((entry) => {
1096
+ const guard = readRecord(entry, 'precondition');
1097
+ if (guard.kind === 'fleet-dock-funding')
1098
+ return normalizeFleetDockFundingGuard(guard, true);
1099
+ if (guard.kind === 'local-market-order')
1100
+ return normalizeLocalMarketOrderGuard(guard, true);
1101
+ if (guard.kind === 'scan-detect' || guard.kind === 'scan-completion') {
1102
+ if (typeof guard.expectedSequence !== 'string' ||
1103
+ !/^(0|[1-9][0-9]*)$/.test(guard.expectedSequence))
1104
+ invalid('expectedSequence', guard.expectedSequence, 'a canonical unsigned decimal string');
1105
+ return { ...guard, expectedSequence: BigInt(guard.expectedSequence) };
1106
+ }
1107
+ if (guard.kind === 'fleet-arrival')
1108
+ return normalizeArrivalGuard(guard, 'precondition', true);
1109
+ if (isRuntimeGuard(guard))
1110
+ return normalizeRuntimeGuard(guard, 'precondition', true);
1111
+ if (isTradeBuyGuard(guard) || isTradeSellGuard(guard)) {
1112
+ const keys = isTradeBuyGuard(guard)
1113
+ ? ['floorRaw']
1114
+ : ['atlasOutCapPerEpochRaw', 'epochLengthSeconds'];
1115
+ const decoded = { ...guard };
1116
+ for (const key of keys) {
1117
+ const raw = guard[key];
1118
+ const pattern = key === 'epochLengthSeconds'
1119
+ ? /^(0|[1-9][0-9]*|-[1-9][0-9]*)$/
1120
+ : /^(0|[1-9][0-9]*)$/;
1121
+ if (typeof raw !== 'string' || !pattern.test(raw))
1122
+ invalid(key, raw, 'a canonical decimal string');
1123
+ decoded[key] = BigInt(raw);
1124
+ }
1125
+ return decoded;
1126
+ }
1127
+ if (guard.kind === 'fleet-add-ship') {
1128
+ for (const field of ['amount', 'maximumProfileDebit'])
1129
+ if (typeof guard[field] !== 'string' ||
1130
+ !/^(0|[1-9][0-9]*)$/.test(guard[field]))
1131
+ invalid(field, guard[field], 'a canonical unsigned decimal string');
1132
+ return {
1133
+ ...guard,
1134
+ amount: BigInt(guard.amount),
1135
+ maximumProfileDebit: BigInt(guard.maximumProfileDebit),
1136
+ };
1137
+ }
1138
+ if (guard.kind === 'character-registration') {
1139
+ for (const key of ['characterLamports', 'budgetLamports'])
1140
+ if (typeof guard[key] !== 'string' ||
1141
+ !/^(0|[1-9][0-9]*)$/.test(guard[key]))
1142
+ invalid(key, guard[key], 'a canonical unsigned decimal string');
1143
+ if (typeof guard.maximumFunderDebit !== 'string' ||
1144
+ !/^(0|[1-9][0-9]*)$/.test(guard.maximumFunderDebit))
1145
+ invalid('maximumFunderDebit', guard.maximumFunderDebit, 'a canonical unsigned decimal string');
1146
+ return {
1147
+ ...guard,
1148
+ maximumFunderDebit: BigInt(guard.maximumFunderDebit),
1149
+ characterLamports: BigInt(guard.characterLamports),
1150
+ budgetLamports: BigInt(guard.budgetLamports),
1151
+ };
1152
+ }
1153
+ if (guard.kind === 'fleet-crew-transfer') {
1154
+ if (typeof guard.systemSequenceId !== 'string' ||
1155
+ !/^(0|[1-9][0-9]*)$/.test(guard.systemSequenceId))
1156
+ invalid('systemSequenceId', guard.systemSequenceId, 'a canonical unsigned decimal string');
1157
+ return { ...guard, systemSequenceId: BigInt(guard.systemSequenceId) };
1158
+ }
1159
+ if (guard.kind === 'fleet-respawn') {
1160
+ for (const key of ['maximumRecoveryFee', 'maximumProfileDebit'])
1161
+ if (typeof guard[key] !== 'string' ||
1162
+ !/^(0|[1-9][0-9]*)$/.test(guard[key]))
1163
+ invalid(key, guard[key], 'a canonical unsigned decimal string');
1164
+ return {
1165
+ ...guard,
1166
+ maximumRecoveryFee: BigInt(guard.maximumRecoveryFee),
1167
+ maximumProfileDebit: BigInt(guard.maximumProfileDebit),
1168
+ };
1169
+ }
1170
+ if (guard.kind === 'scan-signal-open' ||
1171
+ guard.kind === 'fleet-create' ||
1172
+ guard.kind === 'ship-import-funding') {
1173
+ if (typeof guard.maximumProfileDebit !== 'string' ||
1174
+ !/^(0|[1-9][0-9]*)$/.test(guard.maximumProfileDebit))
1175
+ invalid('maximumProfileDebit', guard.maximumProfileDebit, 'a canonical unsigned decimal string');
1176
+ return {
1177
+ ...guard,
1178
+ maximumProfileDebit: BigInt(guard.maximumProfileDebit),
1179
+ };
1180
+ }
1181
+ if (guard.kind === 'starbase-system') {
1182
+ if (typeof guard.starbaseSequenceId !== 'string' ||
1183
+ !/^(0|[1-9][0-9]*)$/.test(guard.starbaseSequenceId))
1184
+ invalid('starbaseSequenceId', guard.starbaseSequenceId, 'a canonical unsigned decimal string');
1185
+ return { ...guard, starbaseSequenceId: BigInt(guard.starbaseSequenceId) };
1186
+ }
1187
+ if (guard.kind !== 'token-account')
1188
+ return guard;
1189
+ if (typeof guard.minimumBalance !== 'string' ||
1190
+ !/^(0|[1-9][0-9]*)$/.test(guard.minimumBalance))
1191
+ invalid('minimumBalance', guard.minimumBalance, 'a canonical unsigned decimal string');
1192
+ return { ...guard, minimumBalance: BigInt(guard.minimumBalance) };
1193
+ });
512
1194
  const steps = readArray(value.steps, 'planJson.steps').map((candidate, index) => {
513
1195
  const field = `planJson.steps[${String(index)}]`;
514
1196
  const step = readRecord(candidate, field);
515
- assertKeys(step, field, ['instruction', 'describes', 'signers'], version !== 1 ? ['semantics'] : []);
1197
+ assertKeys(step, field, ['instruction', 'describes', 'signers'], ['semantics']);
516
1198
  return {
517
1199
  instruction: readWireInstruction(step.instruction, `${field}.instruction`),
518
1200
  describes: readString(step.describes, `${field}.describes`),
519
- ...(version !== 1 && step.semantics !== undefined
1201
+ ...(step.semantics !== undefined
520
1202
  ? {
521
1203
  semantics: readArray(step.semantics, `${field}.semantics`).map((semantic, semanticIndex) => normalizeSemanticFact(semantic, `${field}.semantics[${String(semanticIndex)}]`)),
522
1204
  }
@@ -524,7 +1206,7 @@ export function planFromJSON(json) {
524
1206
  signers: readArray(step.signers, `${field}.signers`).map((signer, signerIndex) => readAddress(signer, `${field}.signers[${String(signerIndex)}]`)),
525
1207
  };
526
1208
  });
527
- const preconditions = readArray(value.preconditions, 'planJson.preconditions').map((candidate, index) => normalizePrecondition(candidate, `planJson.preconditions[${String(index)}]`, version));
1209
+ const preconditions = readArray(value.preconditions, 'planJson.preconditions').map((candidate, index) => normalizePrecondition(candidate, `planJson.preconditions[${String(index)}]`));
528
1210
  const affected = readArray(value.affected, 'planJson.affected').map((candidate, index) => readAddress(candidate, `planJson.affected[${String(index)}]`));
529
1211
  const requiredSigners = readArray(value.requiredSigners, 'planJson.requiredSigners').map((candidate, index) => readAddress(candidate, `planJson.requiredSigners[${String(index)}]`));
530
1212
  const plan = createPlan({
@@ -533,6 +1215,12 @@ export function planFromJSON(json) {
533
1215
  steps,
534
1216
  preconditions,
535
1217
  });
1218
+ validateStarbaseSystemInstructions(plan.steps, plan.preconditions);
1219
+ validateFleetDockingGuards(plan.steps, plan.preconditions);
1220
+ validateFleetDockFundingGuards(plan.steps, plan.preconditions);
1221
+ validateMovementXpInstructions(plan.steps, plan.preconditions);
1222
+ validateFleetAttackInstructions(plan.steps, plan.preconditions);
1223
+ validateCharacterRegistrationInstructions(plan.steps, plan.preconditions);
536
1224
  if (!sameAddresses(plan.affected, affected)) {
537
1225
  invalid('planJson.affected', value.affected, 'the first-seen union of writable instruction account addresses');
538
1226
  }
@@ -549,6 +1237,49 @@ function assertPlan(value, index) {
549
1237
  function combinedSummary(steps) {
550
1238
  return steps.map((step) => step.describes).join(' ');
551
1239
  }
1240
+ function validateShipImportFundingComposition(guards) {
1241
+ const targets = new Map();
1242
+ for (const guard of guards) {
1243
+ if (guard.kind !== 'ship-import-funding')
1244
+ continue;
1245
+ const identity = `${guard.game}:${guard.profile}:${guard.system}:${String(guard.shipId)}`;
1246
+ const previous = targets.get(guard.address);
1247
+ if (previous !== undefined && previous !== identity)
1248
+ throw new SageSdkError('INCOMPATIBLE_PLAN_COMPOSITION', 'Ship imports retain conflicting identities or different configurations for one StarbasePlayer. Use separate confirmed imports, then refresh inventory and replan; prefunding cannot be shared across independently estimated storage growth.');
1249
+ targets.set(guard.address, identity);
1250
+ }
1251
+ }
1252
+ function validateFactionGuardComposition(guards) {
1253
+ const retained = new Map();
1254
+ for (const guard of guards) {
1255
+ if (!isFactionTradeGuard(guard))
1256
+ continue;
1257
+ const constraints = [
1258
+ [
1259
+ `${isTradeMeterGuard(guard) ? 'meter' : 'treasury'}:${guard.address}:identity`,
1260
+ `${guard.game}:${String(guard.factionId)}`,
1261
+ ],
1262
+ ];
1263
+ if (!isTradeMeterGuard(guard)) {
1264
+ constraints.push(isTradeBuyGuard(guard)
1265
+ ? [
1266
+ `${guard.address}:buy:${String(guard.cargoId)}`,
1267
+ String(guard.floorRaw),
1268
+ ]
1269
+ : [
1270
+ `${guard.address}:sell`,
1271
+ `${String(guard.atlasOutCapPerEpochRaw)}:${String(guard.epochLengthSeconds)}`,
1272
+ ]);
1273
+ }
1274
+ constraints.push([`${guard.address}:schema`, String(guard.schemaVersion)]);
1275
+ for (const [key, value] of constraints) {
1276
+ const previous = retained.get(key);
1277
+ if (previous !== undefined && previous !== value)
1278
+ throw new SageSdkError('INCOMPATIBLE_PLAN_COMPOSITION', 'Faction Market Plans retain incompatible Treasury policy or shared account identity. Refresh the affected Markets and prepare compatible Plans, or use separate confirmed transactions.');
1279
+ retained.set(key, value);
1280
+ }
1281
+ }
1282
+ }
552
1283
  /** Combines one or more Plans with deterministic associative flattening.
553
1284
  *
554
1285
  * Semantic validation is eager. Conflict indices are relative to the flattened
@@ -569,11 +1300,28 @@ export function combinePlans(...plans) {
569
1300
  plans.forEach(assertPlan);
570
1301
  const steps = plans.flatMap((plan) => plan.steps);
571
1302
  validatePlanComposition(steps);
1303
+ const preconditions = plans.flatMap((plan) => plan.preconditions);
1304
+ validateFactionGuardComposition(preconditions);
1305
+ validateMiningStopInstructions(steps, preconditions);
1306
+ validateStarbaseSystemInstructions(steps, preconditions);
1307
+ validateFleetDockingGuards(steps, preconditions);
1308
+ validateFleetDockFundingGuards(steps, preconditions);
1309
+ validateCharacterRegistrationInstructions(steps, preconditions);
1310
+ validateArrivalInstructions(steps, preconditions);
1311
+ validateDetectInstructions(steps, preconditions);
1312
+ validateCompletionInstructions(steps, preconditions);
1313
+ validateRespawnInstructions(steps, preconditions);
1314
+ validateCrewTransferInstructions(steps, preconditions);
1315
+ validateOpenSignalInstructions(steps, preconditions);
1316
+ validateLocalMarketOrderInstructions(steps, preconditions);
1317
+ validateRuntimeInstructions(steps, preconditions);
1318
+ validateMovementXpInstructions(steps, preconditions);
1319
+ validateFleetAttackInstructions(steps, preconditions);
572
1320
  return createPlan({
573
1321
  kind: 'combined',
574
1322
  summary: combinedSummary(steps),
575
1323
  steps,
576
- preconditions: plans.flatMap((plan) => plan.preconditions),
1324
+ preconditions,
577
1325
  });
578
1326
  }
579
1327
  export { assemblePlan } from './assembly.js';