@seriousgaming/sdk-tools 1.5.0 → 1.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (169) hide show
  1. package/dist/agent/guidance.md +350 -0
  2. package/dist/bundling/ui-bundler.d.ts +12 -0
  3. package/dist/cli-25RWY5BQ.js +41 -0
  4. package/dist/cli-2BH7FX27.js +52 -0
  5. package/dist/cli-2GZYGRVL.js +36 -0
  6. package/dist/cli-2NU2LPEE.js +97 -0
  7. package/dist/cli-3BRC32CP.js +132 -0
  8. package/dist/cli-3D3ZXWOV.js +111 -0
  9. package/dist/cli-3ZKWV3PN.js +96 -0
  10. package/dist/cli-45OCBG53.js +60 -0
  11. package/dist/cli-4LKXZQ2B.js +48 -0
  12. package/dist/cli-4PXNOJQX.js +81 -0
  13. package/dist/cli-4SIWLHQO.js +717 -0
  14. package/dist/cli-4UWFQNGF.js +54 -0
  15. package/dist/cli-4VFZHLDG.js +202 -0
  16. package/dist/cli-4YB3ROVR.js +78 -0
  17. package/dist/cli-5ACDPCXI.js +21 -0
  18. package/dist/cli-5IAW3LIF.js +38 -0
  19. package/dist/cli-5SM367K7.js +30 -0
  20. package/dist/cli-64AB62PM.js +25 -0
  21. package/dist/cli-6K3VQQUS.js +307 -0
  22. package/dist/cli-6QB2VFPY.js +80 -0
  23. package/dist/cli-6SGCYEEC.js +649 -0
  24. package/dist/cli-6UTPHWRQ.js +207 -0
  25. package/dist/cli-6VNKQ3OX.js +391 -0
  26. package/dist/cli-72XDEFU3.js +61 -0
  27. package/dist/cli-7A6MKCUJ.js +463 -0
  28. package/dist/cli-7XLHO2FE.js +226 -0
  29. package/dist/cli-AV2FYC5G.js +225 -0
  30. package/dist/cli-B6YHEKIJ.js +248 -0
  31. package/dist/cli-BJMS3VX3.js +1837 -0
  32. package/dist/cli-BUQI5UU4.js +43 -0
  33. package/dist/cli-BWX5E7TQ.js +23 -0
  34. package/dist/cli-BYCHKSSH.js +1331 -0
  35. package/dist/cli-C3CMJSNL.js +89 -0
  36. package/dist/cli-C47GJATR.js +42 -0
  37. package/dist/cli-C5QOJJWX.js +46 -0
  38. package/dist/cli-C6ZLPK2U.js +124 -0
  39. package/dist/cli-CD5CIJZI.js +72 -0
  40. package/dist/cli-DDJYUKQG.js +36 -0
  41. package/dist/cli-DFBTZEBX.js +167 -0
  42. package/dist/cli-DOXRQ3S5.js +60 -0
  43. package/dist/cli-EVI36HEM.js +79 -0
  44. package/dist/cli-F2D4GGUA.js +549 -0
  45. package/dist/cli-FQRVFGN6.js +0 -0
  46. package/dist/cli-FWFRKQNE.js +11 -0
  47. package/dist/cli-G6CANSPL.js +88 -0
  48. package/dist/cli-GFNDW2DL.js +124 -0
  49. package/dist/cli-HCRTYQQS.js +16 -0
  50. package/dist/cli-HFX3YPUL.js +76 -0
  51. package/dist/cli-HKORECAG.js +53 -0
  52. package/dist/cli-HOE3WLFH.js +73 -0
  53. package/dist/cli-HSIHDN6K.js +187 -0
  54. package/dist/cli-HW53ICZC.js +89 -0
  55. package/dist/cli-IDVUHGKG.js +218 -0
  56. package/dist/cli-IEMKI7J7.js +1387 -0
  57. package/dist/cli-ILFDANBR.js +101 -0
  58. package/dist/cli-ILKCQNM6.js +8 -0
  59. package/dist/cli-IP4RXGHM.js +2847 -0
  60. package/dist/cli-IUS2YCD3.js +31 -0
  61. package/dist/cli-J4DKUUTK.js +138 -0
  62. package/dist/cli-J4UBELKF.js +37 -0
  63. package/dist/cli-JJSWBW4H.js +89 -0
  64. package/dist/cli-JVI24FI6.js +68 -0
  65. package/dist/cli-JZCLIT3O.js +135 -0
  66. package/dist/cli-JZOZOEZM.js +131 -0
  67. package/dist/cli-KGM6RRQW.js +185 -0
  68. package/dist/cli-KGT5L7VZ.js +13641 -0
  69. package/dist/cli-KOGRWFN7.js +89 -0
  70. package/dist/cli-KSGB2ZLK.js +101 -0
  71. package/dist/cli-L7VYSXQK.js +243 -0
  72. package/dist/cli-LK3V4RI5.js +36 -0
  73. package/dist/cli-LQOHATY2.js +126 -0
  74. package/dist/cli-MJUYJIEP.js +13 -0
  75. package/dist/cli-MJV47HKI.js +143 -0
  76. package/dist/cli-MMN4BPO4.js +145 -0
  77. package/dist/cli-MOPSZ3CS.js +88 -0
  78. package/dist/cli-MU5LB43S.js +136 -0
  79. package/dist/cli-MYJGMA6U.js +40 -0
  80. package/dist/cli-N24OHSAN.js +36 -0
  81. package/dist/cli-N45DREM4.js +99 -0
  82. package/dist/cli-N6H6T2E2.js +616 -0
  83. package/dist/cli-NROTDF5Y.js +182 -0
  84. package/dist/cli-O5ABH2WK.js +226 -0
  85. package/dist/cli-OMWC75CC.js +256 -0
  86. package/dist/cli-OXAUOWCN.js +50 -0
  87. package/dist/cli-PGCIHPU7.js +143 -0
  88. package/dist/cli-Q6ZBZYK2.js +35 -0
  89. package/dist/cli-QUNIRH7A.js +57 -0
  90. package/dist/cli-QUSCIUOM.js +142 -0
  91. package/dist/cli-QVASWX2A.js +187 -0
  92. package/dist/cli-QWQMPCL6.js +253 -0
  93. package/dist/cli-QY5NZAR7.js +97 -0
  94. package/dist/cli-R2MUZQE2.js +62 -0
  95. package/dist/cli-RCIWBCXD.js +36 -0
  96. package/dist/cli-RLEGRWFM.js +81 -0
  97. package/dist/cli-RSW6EBBD.js +89 -0
  98. package/dist/cli-RZITKPJX.js +367 -0
  99. package/dist/cli-S5IVGDDD.js +32 -0
  100. package/dist/cli-SRHBXZCN.js +159 -0
  101. package/dist/cli-TDSQSCX4.js +131 -0
  102. package/dist/cli-TIDQ4WUE.js +257 -0
  103. package/dist/cli-TT36JCU5.js +370 -0
  104. package/dist/cli-TTKICM5P.js +100 -0
  105. package/dist/cli-TTMBBEJC.js +131 -0
  106. package/dist/cli-UMEBPAZQ.js +16 -0
  107. package/dist/cli-UNAJ2OTE.js +15 -0
  108. package/dist/cli-UZZFNXRX.js +226 -0
  109. package/dist/cli-VDBW23SS.js +81 -0
  110. package/dist/cli-VL2P354N.js +46 -0
  111. package/dist/cli-VPRRICZA.js +304 -0
  112. package/dist/cli-VQ6HVQW4.js +4010 -0
  113. package/dist/cli-WR3NOY74.js +36 -0
  114. package/dist/cli-WU43JT4T.js +52 -0
  115. package/dist/cli-XAT25PRU.js +117 -0
  116. package/dist/cli-XOTNXEJA.js +124 -0
  117. package/dist/cli-XSLNH5PR.js +6417 -0
  118. package/dist/cli-XSVGKI3R.js +39 -0
  119. package/dist/cli-XZCJIKIV.js +124 -0
  120. package/dist/cli-Y3DDNMPX.js +97 -0
  121. package/dist/cli-Y3O5F4JN.js +90 -0
  122. package/dist/cli-YOTGR3NB.js +82 -0
  123. package/dist/cli-Z56ZIVA6.js +97 -0
  124. package/dist/cli-ZBN5KAIB.js +59 -0
  125. package/dist/cli-ZDOTXEKL.js +31 -0
  126. package/dist/cli-ZDUADFBY.js +88 -0
  127. package/dist/cli-ZJFQ7EEA.js +131 -0
  128. package/dist/cli-ZTWOE3ZT.js +65 -0
  129. package/dist/cli.js +148 -43093
  130. package/dist/client/build-surfaces.d.ts +33 -0
  131. package/dist/client/dev-server.d.ts +6 -0
  132. package/dist/client/index.d.ts +1 -0
  133. package/dist/client/playwright.d.ts +62 -0
  134. package/dist/client.js +228 -48
  135. package/dist/core/session.d.ts +15 -1
  136. package/dist/dev/console/assets/{index-BVF8exas.js → index-CuMOOH9m.js} +1 -1
  137. package/dist/dev/console/index.html +1 -1
  138. package/dist/dev/shell.d.ts +19 -0
  139. package/dist/dev/surfaces.d.ts +7 -0
  140. package/dist/docs/ai-agents.md +1 -1
  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.md +34 -0
  145. package/dist/docs/cli-and-dev-server.md +21 -0
  146. package/dist/docs/cli-reference.md +45 -31
  147. package/dist/docs/environment-variables.md +6 -0
  148. package/dist/docs/getting-started.md +1 -1
  149. package/dist/docs/guides/designing-a-game.md +29 -4
  150. package/dist/docs/guides/starter-game.md +3 -3
  151. package/dist/docs/guides/testing.md +33 -18
  152. package/dist/docs/guides/upgrading.md +19 -2
  153. package/dist/docs/page-index.md +10 -9
  154. package/dist/docs/recipes/e2e-testing.md +19 -20
  155. package/dist/playwright.js +32232 -0
  156. package/dist/templates/package/CLAUDE.md.template +7 -346
  157. package/dist/templates/package/claude/rules/workflow-create-engine.md +2 -2
  158. package/dist/templates/package/claude/rules/workflow-create-guide.md +2 -2
  159. package/dist/templates/package/claude/rules/workflow-create-user-interface.md +1 -1
  160. package/dist/templates/package/claude/rules/workflow-test-engine-or-ui.md +1 -1
  161. package/dist/templates/package/claude/rules/workflow-update-sdk-version.md +3 -3
  162. package/dist/templates/package/global-setup.ts.template +7 -18
  163. package/dist/templates/package/playwright.config.ts.liquid +8 -11
  164. package/dist/templates/starter-game/playwright.config.ts +8 -11
  165. package/dist/templates/starter-game/testing/e2e/game.spec.ts +1 -1
  166. package/dist/templates/starter-game/testing/e2e/global-setup.ts +7 -18
  167. package/dist/utils/prompt.d.ts +5 -5
  168. package/dist/utils/resource-scan.d.ts +39 -0
  169. package/package.json +7 -3
@@ -0,0 +1,225 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ loadResourceIdentifiers
4
+ } from "./cli-Q6ZBZYK2.js";
5
+ import {
6
+ resolvePatchedDefinition
7
+ } from "./cli-5IAW3LIF.js";
8
+ import {
9
+ readAuthoredBundle
10
+ } from "./cli-4VFZHLDG.js";
11
+ import {
12
+ resolveInputSource
13
+ } from "./cli-4UWFQNGF.js";
14
+ import {
15
+ createSettingsEditorFiles,
16
+ deleteSettingsEditorFiles,
17
+ findSettingsEditorReferences,
18
+ updateSettingsEditorFiles
19
+ } from "./cli-4SIWLHQO.js";
20
+ import {
21
+ loadPackageContext
22
+ } from "./cli-XSVGKI3R.js";
23
+ import {
24
+ BUILD_COMMAND,
25
+ generateTypes,
26
+ operationError,
27
+ printOperationResult,
28
+ recordOperationResult,
29
+ regenerateTypes
30
+ } from "./cli-KSGB2ZLK.js";
31
+ import {
32
+ checkbox,
33
+ confirmAction
34
+ } from "./cli-ZTWOE3ZT.js";
35
+ import {
36
+ generateCommand
37
+ } from "./cli-LQOHATY2.js";
38
+ import {
39
+ getResourceMeta,
40
+ validateSDKScenarioEditor,
41
+ validateSDKSetup
42
+ } from "./cli-VQ6HVQW4.js";
43
+ import {
44
+ resourceExample
45
+ } from "./cli-F2D4GGUA.js";
46
+ import {
47
+ logger
48
+ } from "./cli-4YB3ROVR.js";
49
+ import {
50
+ CliError
51
+ } from "./cli-N6H6T2E2.js";
52
+
53
+ // cli/commands/resources/shared/settings-editor.ts
54
+ var VALIDATORS = {
55
+ setup: validateSDKSetup,
56
+ scenario_editor: validateSDKScenarioEditor
57
+ };
58
+ var TITLES = {
59
+ setup: "Setup",
60
+ scenario_editor: "Scenario editor"
61
+ };
62
+ function noun(slot) {
63
+ return getResourceMeta(slot).label.toLowerCase();
64
+ }
65
+ async function createSettingsEditor(slot, definitionInput, options) {
66
+ const label = noun(slot);
67
+ logger.info(`
68
+ Creating the ${label}...
69
+ `);
70
+ loadPackageContext(options.workingDir, { suggestNewPackage: true });
71
+ const inputSource = await resolveInputSource(definitionInput, options.file);
72
+ let definition;
73
+ if (inputSource.kind === "json") {
74
+ definition = readAuthoredBundle({
75
+ json: inputSource.json,
76
+ type: slot,
77
+ command: "new",
78
+ validate: VALIDATORS[slot]
79
+ }).definition;
80
+ } else {
81
+ logger.info("No JSON definition provided. Starting interactive mode...\n");
82
+ const available = loadResourceIdentifiers(options.workingDir, "settings");
83
+ const configures = [];
84
+ definition = { configures };
85
+ if (available.length > 0) {
86
+ logger.info(`Select the settings the ${label} will edit.
87
+ `);
88
+ configures.push(
89
+ ...await checkbox({
90
+ message: "Settings to edit:",
91
+ choices: available.map((id) => ({ name: id, value: id })),
92
+ pageSize: 10
93
+ })
94
+ );
95
+ logger.info("");
96
+ } else {
97
+ logger.info("No settings resources found in this package.");
98
+ logger.info('You can add one using "seriousgaming-sdk new settings".\n');
99
+ }
100
+ }
101
+ logger.info(`Creating ${label} files...
102
+ `);
103
+ const result = await createSettingsEditorFiles({
104
+ packagePath: options.workingDir,
105
+ slot,
106
+ name: TITLES[slot],
107
+ definition
108
+ });
109
+ if (!result.success) {
110
+ throw operationError(result, `Failed to create ${label} files`);
111
+ }
112
+ logger.success(`${TITLES[slot]} created successfully!`);
113
+ printOperationResult(result);
114
+ await generateTypes(options.workingDir);
115
+ logger.info("Next steps:");
116
+ logger.info(` 1. Edit the screen: ${slot}/src/App.tsx`);
117
+ logger.info(` 2. Run "${BUILD_COMMAND}" to build your package`);
118
+ }
119
+ async function updateSettingsEditor(slot, definitionInput, options) {
120
+ const label = noun(slot);
121
+ logger.info(`
122
+ Updating the ${label}...
123
+ `);
124
+ const identifier = slot;
125
+ loadPackageContext(options.workingDir);
126
+ let jsonDefinition = null;
127
+ if (options.patch) {
128
+ jsonDefinition = resolvePatchedDefinition({
129
+ patch: options.patch,
130
+ workingDir: options.workingDir,
131
+ type: slot,
132
+ identifier,
133
+ resourceLabel: getResourceMeta(slot).label
134
+ });
135
+ } else {
136
+ const inputSource = await resolveInputSource(definitionInput, options.file);
137
+ if (inputSource.kind === "json") jsonDefinition = inputSource.json;
138
+ }
139
+ if (!jsonDefinition) {
140
+ throw new CliError(
141
+ "USAGE_MISSING_INPUT",
142
+ `The ${label} takes no interactive input: a game holds one, so there is nothing
143
+ to name and nothing to pick.
144
+
145
+ Edit it with a definition or a patch.
146
+
147
+ Expected format:
148
+ ${resourceExample(slot, "update")}`
149
+ );
150
+ }
151
+ const bundle = readAuthoredBundle({
152
+ json: jsonDefinition,
153
+ type: slot,
154
+ command: "update",
155
+ validate: VALIDATORS[slot],
156
+ identifier
157
+ });
158
+ logger.info(`Updating ${label} files...
159
+ `);
160
+ const result = updateSettingsEditorFiles(slot, {
161
+ packagePath: options.workingDir,
162
+ oldIdentifier: identifier,
163
+ newDefinition: bundle.definition
164
+ });
165
+ if (!result.success) {
166
+ throw operationError(result, `Failed to update ${label} files`);
167
+ }
168
+ logger.success(`${TITLES[slot]} updated successfully!`);
169
+ printOperationResult(result);
170
+ await regenerateTypes(options.workingDir);
171
+ }
172
+ async function deleteSettingsEditor(slot, options) {
173
+ const label = noun(slot);
174
+ logger.info(`
175
+ Deleting the ${label}...
176
+ `);
177
+ const identifier = slot;
178
+ loadPackageContext(options.workingDir);
179
+ const references = findSettingsEditorReferences(slot, {
180
+ packagePath: options.workingDir,
181
+ identifier
182
+ });
183
+ if (references.length > 0) {
184
+ logger.info(`
185
+ The ${label} is referenced by:`);
186
+ for (const ref of references) logger.info(` - ${ref}`);
187
+ logger.info("\nThese references will be removed.");
188
+ }
189
+ const confirmed = await confirmAction(
190
+ { message: `Are you sure you want to delete the ${label}?` },
191
+ options.yes
192
+ );
193
+ if (!confirmed) {
194
+ logger.info("\nDeletion cancelled.\n");
195
+ return;
196
+ }
197
+ logger.info("");
198
+ const result = deleteSettingsEditorFiles(slot, {
199
+ packagePath: options.workingDir,
200
+ identifier
201
+ });
202
+ if (!result.success) {
203
+ throw operationError(result, `Failed to delete ${label} files`);
204
+ }
205
+ recordOperationResult(result);
206
+ for (const file of result.filesDeleted || []) logger.info(` \u2713 Deleted: ${file}`);
207
+ for (const ref of result.referencesRemoved || []) {
208
+ logger.info(` \u2713 Removed reference from: ${ref}`);
209
+ }
210
+ logger.info("\nRegenerating TypeScript types...\n");
211
+ try {
212
+ await generateCommand({ workingDir: options.workingDir });
213
+ logger.success("TypeScript types regenerated successfully!");
214
+ } catch (error) {
215
+ logger.warn("\nWarning: Failed to regenerate TypeScript types:");
216
+ logger.warn(error instanceof Error ? error.message : "Unknown error");
217
+ }
218
+ logger.success(`${TITLES[slot]} deleted successfully!`);
219
+ }
220
+
221
+ export {
222
+ createSettingsEditor,
223
+ updateSettingsEditor,
224
+ deleteSettingsEditor
225
+ };
@@ -0,0 +1,248 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ bundlePackage
4
+ } from "./cli-J4DKUUTK.js";
5
+ import {
6
+ loadEnvironmentConfig
7
+ } from "./cli-TDSQSCX4.js";
8
+ import "./cli-MMN4BPO4.js";
9
+ import {
10
+ DEFAULT_PLATFORM_HOST,
11
+ formatPlatformErrors,
12
+ normalisePlatformHost
13
+ } from "./cli-25RWY5BQ.js";
14
+ import {
15
+ logger
16
+ } from "./cli-4YB3ROVR.js";
17
+ import {
18
+ CliError,
19
+ reportResult
20
+ } from "./cli-N6H6T2E2.js";
21
+
22
+ // cli/commands/package-publish.ts
23
+ import { existsSync, readFileSync, statSync } from "fs";
24
+ import { readFile } from "fs/promises";
25
+ import { join, resolve } from "path";
26
+ function buildApiPath(publisherSlug) {
27
+ return `/api/v0/admin/publishers/${encodeURIComponent(publisherSlug)}/packages`;
28
+ }
29
+ function readSdkConfig(workingDir) {
30
+ const sdkPath = resolve(workingDir, "seriousgaming.sdk.json");
31
+ if (!existsSync(sdkPath)) {
32
+ throw new CliError(
33
+ "MANIFEST_NOT_FOUND",
34
+ `seriousgaming.sdk.json not found at ${sdkPath}. Run this command in a Serious Gaming package directory.`
35
+ );
36
+ }
37
+ let raw;
38
+ try {
39
+ raw = readFileSync(sdkPath, "utf-8");
40
+ } catch (error) {
41
+ const message = error instanceof Error ? error.message : String(error);
42
+ throw new CliError("MANIFEST_INVALID", `Failed to read ${sdkPath}: ${message}`);
43
+ }
44
+ let parsed;
45
+ try {
46
+ parsed = JSON.parse(raw);
47
+ } catch (error) {
48
+ const message = error instanceof Error ? error.message : String(error);
49
+ throw new CliError("MANIFEST_INVALID", `Failed to parse ${sdkPath}: ${message}`);
50
+ }
51
+ const identifier = parsed.identifier;
52
+ if (typeof identifier !== "string" || identifier === "") {
53
+ throw new CliError(
54
+ "MANIFEST_INVALID",
55
+ `seriousgaming.sdk.json at ${sdkPath} is missing its identifier.`
56
+ );
57
+ }
58
+ const packageJsonPath = resolve(workingDir, "package.json");
59
+ if (!existsSync(packageJsonPath)) {
60
+ throw new CliError(
61
+ "MANIFEST_NOT_FOUND",
62
+ `package.json not found at ${packageJsonPath}. Publishing needs a version, and package.json is where it lives.`
63
+ );
64
+ }
65
+ let version;
66
+ try {
67
+ version = JSON.parse(readFileSync(packageJsonPath, "utf-8")).version;
68
+ } catch (error) {
69
+ const message = error instanceof Error ? error.message : String(error);
70
+ throw new CliError("MANIFEST_INVALID", `Failed to parse ${packageJsonPath}: ${message}`);
71
+ }
72
+ if (typeof version !== "string" || version === "") {
73
+ throw new CliError(
74
+ "MANIFEST_INVALID",
75
+ `package.json at ${packageJsonPath} is missing a version.`
76
+ );
77
+ }
78
+ return { identifier, version };
79
+ }
80
+ function mapErrorCode(status) {
81
+ switch (status) {
82
+ case 400:
83
+ return "PLATFORM_REJECTED";
84
+ case 401:
85
+ case 403:
86
+ return "PLATFORM_UNAUTHORISED";
87
+ case 409:
88
+ return "VERSION_EXISTS";
89
+ default:
90
+ return "PLATFORM_ERROR";
91
+ }
92
+ }
93
+ function mapErrorMessage(status, parsedBody, identifier, version) {
94
+ switch (status) {
95
+ case 400: {
96
+ const detail = parsedBody ? formatPlatformErrors(parsedBody) : "";
97
+ return detail ? `Package upload rejected (400): ${detail}` : "Package upload rejected (400). The server did not return an errors array.";
98
+ }
99
+ case 401:
100
+ return "Invalid API key. Check $SERIOUSGAMING_API_KEY and that it has not been revoked.";
101
+ case 403:
102
+ return "The account that created this API key does not have publishing access. Ask Serious Gaming support to grant it.";
103
+ case 409:
104
+ return `Version ${version} of ${identifier} already exists. Bump it with \`seriousgaming-sdk package version patch\` and try again.`;
105
+ default: {
106
+ const detail = parsedBody ? formatPlatformErrors(parsedBody) : "";
107
+ return detail ? `Package upload failed (${status}): ${detail}` : `Package upload failed with HTTP ${status}.`;
108
+ }
109
+ }
110
+ }
111
+ async function packagePublishCommand(zip, options) {
112
+ const fail = (code, message) => {
113
+ throw new CliError(code, message);
114
+ };
115
+ const sdkConfig = readSdkConfig(options.workingDir);
116
+ const buildDirAbs = resolve(options.workingDir, options.buildDir);
117
+ const defaultZipPath = join(buildDirAbs, `${sdkConfig.identifier}-${sdkConfig.version}.zip`);
118
+ let zipPath;
119
+ if (zip) {
120
+ zipPath = resolve(options.workingDir, zip);
121
+ if (!existsSync(zipPath)) {
122
+ fail("FILE_NOT_FOUND", `Zip file not found at ${zipPath}.`);
123
+ return;
124
+ }
125
+ } else {
126
+ if (!existsSync(defaultZipPath)) {
127
+ if (!options.autoBundle) {
128
+ fail(
129
+ "BUILD_NOT_FOUND",
130
+ `Bundle not found at ${defaultZipPath}. Run \`seriousgaming-sdk package bundle\` first, or omit \`--no-auto-bundle\`.`
131
+ );
132
+ return;
133
+ }
134
+ logger.info(`Bundle not found at ${defaultZipPath}. Running "package bundle"\u2026`);
135
+ try {
136
+ await bundlePackage({
137
+ workingDir: options.workingDir,
138
+ buildDir: options.buildDir
139
+ });
140
+ } catch (error) {
141
+ if (!(error instanceof CliError)) throw error;
142
+ throw new CliError(error.code, `Auto-bundle failed: ${error.message}`, {
143
+ cause: error
144
+ });
145
+ }
146
+ if (!existsSync(defaultZipPath)) {
147
+ fail(
148
+ "BUILD_NOT_FOUND",
149
+ `Auto-bundle did not produce the expected zip at ${defaultZipPath}. Check the build directory and re-run \`seriousgaming-sdk package bundle\`.`
150
+ );
151
+ return;
152
+ }
153
+ }
154
+ zipPath = defaultZipPath;
155
+ }
156
+ const env = loadEnvironmentConfig(options.workingDir, {
157
+ seriousGamingApiKey: options.apiKey,
158
+ seriousGamingApiHost: options.host,
159
+ defaultPublisher: options.publisher
160
+ });
161
+ const apiKey = env.seriousGamingApiKey;
162
+ if (!apiKey) {
163
+ fail(
164
+ "API_KEY_MISSING",
165
+ "No API key configured. Set SERIOUSGAMING_API_KEY in your environment or .env file, or pass it with --api-key."
166
+ );
167
+ return;
168
+ }
169
+ const publisher = env.defaultPublisher;
170
+ if (!publisher) {
171
+ fail(
172
+ "PUBLISHER_MISSING",
173
+ "No publisher configured. Set one with --publisher <slug>, the SERIOUSGAMING_PUBLISHER environment variable, or platform.defaultPublisher in your global settings (seriousgaming-sdk config set platform.defaultPublisher <slug>)."
174
+ );
175
+ return;
176
+ }
177
+ const host = normalisePlatformHost(env.seriousGamingApiHost ?? DEFAULT_PLATFORM_HOST);
178
+ const endpoint = `${host}${buildApiPath(publisher)}`;
179
+ let zipBuffer;
180
+ try {
181
+ zipBuffer = await readFile(zipPath);
182
+ } catch (error) {
183
+ fail(
184
+ "FILE_NOT_FOUND",
185
+ `Failed to read zip at ${zipPath}: ${error instanceof Error ? error.message : String(error)}`
186
+ );
187
+ return;
188
+ }
189
+ const zipSize = statSync(zipPath).size;
190
+ const form = new FormData();
191
+ const blob = new Blob([new Uint8Array(zipBuffer)], { type: "application/zip" });
192
+ form.append("body", blob, `${sdkConfig.identifier}-${sdkConfig.version}.zip`);
193
+ let response;
194
+ try {
195
+ response = await fetch(endpoint, {
196
+ method: "POST",
197
+ headers: { Authorization: `Bearer ${apiKey}` },
198
+ body: form
199
+ });
200
+ } catch (error) {
201
+ const message = error instanceof Error ? error.message : String(error);
202
+ fail("PLATFORM_UNREACHABLE", `Network error contacting ${endpoint}: ${message}`);
203
+ return;
204
+ }
205
+ const rawBody = await response.text();
206
+ let parsedBody = null;
207
+ if (rawBody) {
208
+ try {
209
+ parsedBody = JSON.parse(rawBody);
210
+ } catch {
211
+ parsedBody = null;
212
+ }
213
+ }
214
+ if (!response.ok) {
215
+ const message = mapErrorMessage(
216
+ response.status,
217
+ parsedBody ?? null,
218
+ sdkConfig.identifier,
219
+ sdkConfig.version
220
+ );
221
+ fail(mapErrorCode(response.status), message);
222
+ return;
223
+ }
224
+ if (!parsedBody || typeof parsedBody !== "object") {
225
+ fail(
226
+ "PLATFORM_ERROR",
227
+ `Server returned HTTP ${response.status} but the body was not a JSON object. Cannot confirm the upload succeeded.`
228
+ );
229
+ return;
230
+ }
231
+ const result = parsedBody;
232
+ reportResult(result, () => {
233
+ logger.success(`Published ${sdkConfig.identifier} ${sdkConfig.version}`);
234
+ console.log(` handle: ${result.handle}`);
235
+ console.log(` packageHandle: ${result.packageHandle}`);
236
+ console.log(` packageName: ${result.packageName}`);
237
+ console.log(` version: ${result.version}`);
238
+ console.log(` createdAt: ${result.createdAt}`);
239
+ if (Array.isArray(result.games) && result.games.length > 0) {
240
+ const ids = result.games.map((g) => g.identifier).join(", ");
241
+ console.log(` games: ${ids}`);
242
+ }
243
+ console.log(` size: ${zipSize} bytes`);
244
+ });
245
+ }
246
+ export {
247
+ packagePublishCommand
248
+ };