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