@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.
- package/dist/agent/guidance.md +350 -0
- package/dist/bundling/ui-bundler.d.ts +12 -0
- package/dist/cli-25RWY5BQ.js +41 -0
- package/dist/cli-2BH7FX27.js +52 -0
- package/dist/cli-2GZYGRVL.js +36 -0
- package/dist/cli-2NU2LPEE.js +97 -0
- package/dist/cli-3BRC32CP.js +132 -0
- package/dist/cli-3D3ZXWOV.js +111 -0
- package/dist/cli-3ZKWV3PN.js +96 -0
- package/dist/cli-45OCBG53.js +60 -0
- package/dist/cli-4LKXZQ2B.js +48 -0
- package/dist/cli-4PXNOJQX.js +81 -0
- package/dist/cli-4SIWLHQO.js +717 -0
- package/dist/cli-4UWFQNGF.js +54 -0
- package/dist/cli-4VFZHLDG.js +202 -0
- package/dist/cli-4YB3ROVR.js +78 -0
- package/dist/cli-5ACDPCXI.js +21 -0
- package/dist/cli-5IAW3LIF.js +38 -0
- package/dist/cli-5SM367K7.js +30 -0
- package/dist/cli-64AB62PM.js +25 -0
- package/dist/cli-6K3VQQUS.js +307 -0
- package/dist/cli-6QB2VFPY.js +80 -0
- package/dist/cli-6SGCYEEC.js +649 -0
- package/dist/cli-6UTPHWRQ.js +207 -0
- package/dist/cli-6VNKQ3OX.js +391 -0
- package/dist/cli-72XDEFU3.js +61 -0
- package/dist/cli-7A6MKCUJ.js +463 -0
- package/dist/cli-7XLHO2FE.js +226 -0
- package/dist/cli-AV2FYC5G.js +225 -0
- package/dist/cli-B6YHEKIJ.js +248 -0
- package/dist/cli-BJMS3VX3.js +1837 -0
- package/dist/cli-BUQI5UU4.js +43 -0
- package/dist/cli-BWX5E7TQ.js +23 -0
- package/dist/cli-BYCHKSSH.js +1331 -0
- package/dist/cli-C3CMJSNL.js +89 -0
- package/dist/cli-C47GJATR.js +42 -0
- package/dist/cli-C5QOJJWX.js +46 -0
- package/dist/cli-C6ZLPK2U.js +124 -0
- package/dist/cli-CD5CIJZI.js +72 -0
- package/dist/cli-DDJYUKQG.js +36 -0
- package/dist/cli-DFBTZEBX.js +167 -0
- package/dist/cli-DOXRQ3S5.js +60 -0
- package/dist/cli-EVI36HEM.js +79 -0
- package/dist/cli-F2D4GGUA.js +549 -0
- package/dist/cli-FQRVFGN6.js +0 -0
- package/dist/cli-FWFRKQNE.js +11 -0
- package/dist/cli-G6CANSPL.js +88 -0
- package/dist/cli-GFNDW2DL.js +124 -0
- package/dist/cli-HCRTYQQS.js +16 -0
- package/dist/cli-HFX3YPUL.js +76 -0
- package/dist/cli-HKORECAG.js +53 -0
- package/dist/cli-HOE3WLFH.js +73 -0
- package/dist/cli-HSIHDN6K.js +187 -0
- package/dist/cli-HW53ICZC.js +89 -0
- package/dist/cli-IDVUHGKG.js +218 -0
- package/dist/cli-IEMKI7J7.js +1387 -0
- package/dist/cli-ILFDANBR.js +101 -0
- package/dist/cli-ILKCQNM6.js +8 -0
- package/dist/cli-IP4RXGHM.js +2847 -0
- package/dist/cli-IUS2YCD3.js +31 -0
- package/dist/cli-J4DKUUTK.js +138 -0
- package/dist/cli-J4UBELKF.js +37 -0
- package/dist/cli-JJSWBW4H.js +89 -0
- package/dist/cli-JVI24FI6.js +68 -0
- package/dist/cli-JZCLIT3O.js +135 -0
- package/dist/cli-JZOZOEZM.js +131 -0
- package/dist/cli-KGM6RRQW.js +185 -0
- package/dist/cli-KGT5L7VZ.js +13641 -0
- package/dist/cli-KOGRWFN7.js +89 -0
- package/dist/cli-KSGB2ZLK.js +101 -0
- package/dist/cli-L7VYSXQK.js +243 -0
- package/dist/cli-LK3V4RI5.js +36 -0
- package/dist/cli-LQOHATY2.js +126 -0
- package/dist/cli-MJUYJIEP.js +13 -0
- package/dist/cli-MJV47HKI.js +143 -0
- package/dist/cli-MMN4BPO4.js +145 -0
- package/dist/cli-MOPSZ3CS.js +88 -0
- package/dist/cli-MU5LB43S.js +136 -0
- package/dist/cli-MYJGMA6U.js +40 -0
- package/dist/cli-N24OHSAN.js +36 -0
- package/dist/cli-N45DREM4.js +99 -0
- package/dist/cli-N6H6T2E2.js +616 -0
- package/dist/cli-NROTDF5Y.js +182 -0
- package/dist/cli-O5ABH2WK.js +226 -0
- package/dist/cli-OMWC75CC.js +256 -0
- package/dist/cli-OXAUOWCN.js +50 -0
- package/dist/cli-PGCIHPU7.js +143 -0
- package/dist/cli-Q6ZBZYK2.js +35 -0
- package/dist/cli-QUNIRH7A.js +57 -0
- package/dist/cli-QUSCIUOM.js +142 -0
- package/dist/cli-QVASWX2A.js +187 -0
- package/dist/cli-QWQMPCL6.js +253 -0
- package/dist/cli-QY5NZAR7.js +97 -0
- package/dist/cli-R2MUZQE2.js +62 -0
- package/dist/cli-RCIWBCXD.js +36 -0
- package/dist/cli-RLEGRWFM.js +81 -0
- package/dist/cli-RSW6EBBD.js +89 -0
- package/dist/cli-RZITKPJX.js +367 -0
- package/dist/cli-S5IVGDDD.js +32 -0
- package/dist/cli-SRHBXZCN.js +159 -0
- package/dist/cli-TDSQSCX4.js +131 -0
- package/dist/cli-TIDQ4WUE.js +257 -0
- package/dist/cli-TT36JCU5.js +370 -0
- package/dist/cli-TTKICM5P.js +100 -0
- package/dist/cli-TTMBBEJC.js +131 -0
- package/dist/cli-UMEBPAZQ.js +16 -0
- package/dist/cli-UNAJ2OTE.js +15 -0
- package/dist/cli-UZZFNXRX.js +226 -0
- package/dist/cli-VDBW23SS.js +81 -0
- package/dist/cli-VL2P354N.js +46 -0
- package/dist/cli-VPRRICZA.js +304 -0
- package/dist/cli-VQ6HVQW4.js +4010 -0
- package/dist/cli-WR3NOY74.js +36 -0
- package/dist/cli-WU43JT4T.js +52 -0
- package/dist/cli-XAT25PRU.js +117 -0
- package/dist/cli-XOTNXEJA.js +124 -0
- package/dist/cli-XSLNH5PR.js +6417 -0
- package/dist/cli-XSVGKI3R.js +39 -0
- package/dist/cli-XZCJIKIV.js +124 -0
- package/dist/cli-Y3DDNMPX.js +97 -0
- package/dist/cli-Y3O5F4JN.js +90 -0
- package/dist/cli-YOTGR3NB.js +82 -0
- package/dist/cli-Z56ZIVA6.js +97 -0
- package/dist/cli-ZBN5KAIB.js +59 -0
- package/dist/cli-ZDOTXEKL.js +31 -0
- package/dist/cli-ZDUADFBY.js +88 -0
- package/dist/cli-ZJFQ7EEA.js +131 -0
- package/dist/cli-ZTWOE3ZT.js +65 -0
- package/dist/cli.js +148 -43093
- package/dist/client/build-surfaces.d.ts +33 -0
- package/dist/client/dev-server.d.ts +6 -0
- package/dist/client/index.d.ts +1 -0
- package/dist/client/playwright.d.ts +62 -0
- package/dist/client.js +228 -48
- package/dist/core/session.d.ts +15 -1
- package/dist/dev/console/assets/{index-BVF8exas.js → index-CuMOOH9m.js} +1 -1
- package/dist/dev/console/index.html +1 -1
- package/dist/dev/shell.d.ts +19 -0
- package/dist/dev/surfaces.d.ts +7 -0
- package/dist/docs/ai-agents.md +1 -1
- package/dist/docs/api/index.md +14 -12
- package/dist/docs/api/sdk-tools-client.md +29 -0
- package/dist/docs/api/sdk-tools-playwright.md +104 -0
- package/dist/docs/changelog.md +34 -0
- package/dist/docs/cli-and-dev-server.md +21 -0
- package/dist/docs/cli-reference.md +45 -31
- package/dist/docs/environment-variables.md +6 -0
- package/dist/docs/getting-started.md +1 -1
- package/dist/docs/guides/designing-a-game.md +29 -4
- package/dist/docs/guides/starter-game.md +3 -3
- package/dist/docs/guides/testing.md +33 -18
- package/dist/docs/guides/upgrading.md +19 -2
- package/dist/docs/page-index.md +10 -9
- package/dist/docs/recipes/e2e-testing.md +19 -20
- package/dist/playwright.js +32232 -0
- package/dist/templates/package/CLAUDE.md.template +7 -346
- package/dist/templates/package/claude/rules/workflow-create-engine.md +2 -2
- package/dist/templates/package/claude/rules/workflow-create-guide.md +2 -2
- package/dist/templates/package/claude/rules/workflow-create-user-interface.md +1 -1
- package/dist/templates/package/claude/rules/workflow-test-engine-or-ui.md +1 -1
- package/dist/templates/package/claude/rules/workflow-update-sdk-version.md +3 -3
- package/dist/templates/package/global-setup.ts.template +7 -18
- package/dist/templates/package/playwright.config.ts.liquid +8 -11
- package/dist/templates/starter-game/playwright.config.ts +8 -11
- package/dist/templates/starter-game/testing/e2e/game.spec.ts +1 -1
- package/dist/templates/starter-game/testing/e2e/global-setup.ts +7 -18
- package/dist/utils/prompt.d.ts +5 -5
- package/dist/utils/resource-scan.d.ts +39 -0
- 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
|
+
};
|