@starpak/error 0.1.0 → 0.1.5
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/lib/codes.d.ts +13 -0
- package/lib/codes.d.ts.map +1 -1
- package/lib/codes.js +13 -0
- package/lib/codes.js.map +1 -1
- package/lib/definitions.d.ts.map +1 -1
- package/lib/definitions.js +14 -1
- package/lib/definitions.js.map +1 -1
- package/package.json +1 -1
- package/src/codes.ts +13 -0
- package/src/definitions.ts +31 -2
package/lib/codes.d.ts
CHANGED
|
@@ -25,6 +25,7 @@ export declare const CODES: {
|
|
|
25
25
|
readonly PAK_VERSION_UNSUPPORTED: "SPAK-2005";
|
|
26
26
|
readonly PAK_MANIFEST_INVALID: "SPAK-2006";
|
|
27
27
|
readonly PAK_TRUNCATED: "SPAK-2007";
|
|
28
|
+
readonly INTEGRITY_MISMATCH: "SPAK-2010";
|
|
28
29
|
readonly OUTPUT_NOT_WRITABLE: "SPAK-2008";
|
|
29
30
|
readonly DISK_FULL: "SPAK-2009";
|
|
30
31
|
readonly MANIFEST_INVALID: "SPAK-3001";
|
|
@@ -34,6 +35,9 @@ export declare const CODES: {
|
|
|
34
35
|
readonly ENTRY_UNSUPPORTED: "SPAK-3005";
|
|
35
36
|
readonly SPK_COMPILE_FAILED: "SPAK-3006";
|
|
36
37
|
readonly VERSION_MISMATCH: "SPAK-3007";
|
|
38
|
+
readonly CONFIG_INVALID: "SPAK-3008";
|
|
39
|
+
readonly INSTALL_FAILED: "SPAK-3009";
|
|
40
|
+
readonly SIGNATURE_INVALID: "SPAK-3010";
|
|
37
41
|
readonly UNCAUGHT_EXCEPTION: "SPAK-4001";
|
|
38
42
|
readonly UNHANDLED_REJECTION: "SPAK-4002";
|
|
39
43
|
readonly PORT_IN_USE: "SPAK-4003";
|
|
@@ -41,6 +45,15 @@ export declare const CODES: {
|
|
|
41
45
|
readonly ROUTE_DUPLICATE: "SPAK-4005";
|
|
42
46
|
readonly HANDLER_THREW: "SPAK-4006";
|
|
43
47
|
readonly BODY_TOO_LARGE: "SPAK-4007";
|
|
48
|
+
readonly UNKNOWN_COMMAND: "SPAK-4008";
|
|
49
|
+
readonly MISSING_ARGUMENT: "SPAK-4009";
|
|
50
|
+
readonly INVALID_OPTION: "SPAK-4010";
|
|
51
|
+
readonly SERVICE_STOP_FAILED: "SPAK-4011";
|
|
52
|
+
readonly INVALID_PATH: "SPAK-4012";
|
|
53
|
+
readonly AUTH_FAILED: "SPAK-4013";
|
|
54
|
+
readonly COMMAND_EXTENSION_MISSING: "SPAK-4014";
|
|
55
|
+
readonly COMMAND_EXTENSION_HINT: "SPAK-4015";
|
|
56
|
+
readonly SYSTEM_PACKAGE_IWANT: "SPAK-4016";
|
|
44
57
|
readonly PERMISSION_UNDECLARED: "SPAK-5001";
|
|
45
58
|
readonly FS_DENIED: "SPAK-5002";
|
|
46
59
|
readonly NETWORK_DENIED: "SPAK-5003";
|
package/lib/codes.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../src/codes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,KAAK
|
|
1
|
+
{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../src/codes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiGR,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,MAAM,OAAO,KAAK,CAAC,CAAA;AAExD,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD"}
|
package/lib/codes.js
CHANGED
|
@@ -32,6 +32,7 @@ exports.CODES = {
|
|
|
32
32
|
PAK_VERSION_UNSUPPORTED: 'SPAK-2005',
|
|
33
33
|
PAK_MANIFEST_INVALID: 'SPAK-2006',
|
|
34
34
|
PAK_TRUNCATED: 'SPAK-2007',
|
|
35
|
+
INTEGRITY_MISMATCH: 'SPAK-2010',
|
|
35
36
|
OUTPUT_NOT_WRITABLE: 'SPAK-2008',
|
|
36
37
|
DISK_FULL: 'SPAK-2009',
|
|
37
38
|
// ---- 3xxx mods / apps ---------------------------------------------------
|
|
@@ -42,6 +43,9 @@ exports.CODES = {
|
|
|
42
43
|
ENTRY_UNSUPPORTED: 'SPAK-3005',
|
|
43
44
|
SPK_COMPILE_FAILED: 'SPAK-3006',
|
|
44
45
|
VERSION_MISMATCH: 'SPAK-3007',
|
|
46
|
+
CONFIG_INVALID: 'SPAK-3008',
|
|
47
|
+
INSTALL_FAILED: 'SPAK-3009',
|
|
48
|
+
SIGNATURE_INVALID: 'SPAK-3010',
|
|
45
49
|
// ---- 4xxx runtime -------------------------------------------------------
|
|
46
50
|
UNCAUGHT_EXCEPTION: 'SPAK-4001',
|
|
47
51
|
UNHANDLED_REJECTION: 'SPAK-4002',
|
|
@@ -50,6 +54,15 @@ exports.CODES = {
|
|
|
50
54
|
ROUTE_DUPLICATE: 'SPAK-4005',
|
|
51
55
|
HANDLER_THREW: 'SPAK-4006',
|
|
52
56
|
BODY_TOO_LARGE: 'SPAK-4007',
|
|
57
|
+
UNKNOWN_COMMAND: 'SPAK-4008',
|
|
58
|
+
MISSING_ARGUMENT: 'SPAK-4009',
|
|
59
|
+
INVALID_OPTION: 'SPAK-4010',
|
|
60
|
+
SERVICE_STOP_FAILED: 'SPAK-4011',
|
|
61
|
+
INVALID_PATH: 'SPAK-4012',
|
|
62
|
+
AUTH_FAILED: 'SPAK-4013',
|
|
63
|
+
COMMAND_EXTENSION_MISSING: 'SPAK-4014',
|
|
64
|
+
COMMAND_EXTENSION_HINT: 'SPAK-4015',
|
|
65
|
+
SYSTEM_PACKAGE_IWANT: 'SPAK-4016',
|
|
53
66
|
// ---- 5xxx permission ----------------------------------------------------
|
|
54
67
|
PERMISSION_UNDECLARED: 'SPAK-5001',
|
|
55
68
|
FS_DENIED: 'SPAK-5002',
|
package/lib/codes.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"codes.js","sourceRoot":"","sources":["../src/codes.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;
|
|
1
|
+
{"version":3,"file":"codes.js","sourceRoot":"","sources":["../src/codes.ts"],"names":[],"mappings":"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"}
|
package/lib/definitions.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../src/definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;AAC7D,MAAM,MAAM,QAAQ,GAChB,UAAU,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,GACxC,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAA;AAErD,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,EAAE,QAAQ,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;
|
|
1
|
+
{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../src/definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;AAC7D,MAAM,MAAM,QAAQ,GAChB,UAAU,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,GACxC,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAA;AAErD,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,EAAE,QAAQ,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAiMD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAEvD,CAAA;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEvE;AAED,wBAAgB,cAAc,IAAI,eAAe,EAAE,CAElD;AAED,4EAA4E;AAC5E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG7C"}
|
package/lib/definitions.js
CHANGED
|
@@ -28,12 +28,13 @@ const LIST = [
|
|
|
28
28
|
D(codes_1.CODES.ZERO_BASED_INDEX, '1 基索引误用', 'error', 'language', 'Spak 的序列下标从 1 开始，`list[0]` 取不到元素。', ['把 `list[0]` 改成 `list[1]`', '遍历优先用 `for x in list` 而不是手写下标']),
|
|
29
29
|
// ---------------- 2xxx build ----------------
|
|
30
30
|
D(codes_1.CODES.BUILD_FAILED, '构建失败', 'error', 'build', '打包器（esbuild/SEA/容器封装）在某个阶段返回了错误。', ['看构建日志里的第一条错误，后面通常是连锁反应', '`spm build` 加 `--target` 明确目标']),
|
|
31
|
-
D(codes_1.CODES.ENTRY_NOT_FOUND, '入口文件不存在', 'error', 'build', '
|
|
31
|
+
D(codes_1.CODES.ENTRY_NOT_FOUND, '入口文件不存在', 'error', 'build', '给定路径不存在，或目录里没有清单与默认入口文件。', ['检查 `-i` 路径是否存在（文件或目录都可以）', '传目录时会自动查找清单与 index.* 入口', '构建当前目录可直接用 `spm build -i .`']),
|
|
32
32
|
D(codes_1.CODES.UNKNOWN_TARGET, '未知构建目标', 'error', 'build', '`--target` 传了当前构建器不支持的名字。', ['可用目标：node / server / app / web / gal', '`spm build --help` 查看当次构建器支持列表']),
|
|
33
33
|
D(codes_1.CODES.PAK_MAGIC_INVALID, '不是有效的 SPAK 包', 'error', 'build', '文件头不是 `SPAK`，可能不是包或下载被截断。', ['确认文件来源', '重新下载；必要时用 `parsePak` 校验']),
|
|
34
34
|
D(codes_1.CODES.PAK_VERSION_UNSUPPORTED, '包版本不支持', 'error', 'build', '容器版本高于当前运行时能读的版本。', ['升级 Spak 运行时', '或让打包方使用 v2 格式']),
|
|
35
35
|
D(codes_1.CODES.PAK_MANIFEST_INVALID, '包清单损坏', 'error', 'build', '容器里的 manifest 不是合法 JSON 或缺少必填字段。', ['重新打包', '检查打包脚本是否写入了空清单']),
|
|
36
36
|
D(codes_1.CODES.PAK_TRUNCATED, '包被截断', 'error', 'build', '文件长度小于 manifest 声明的长度，传输不完整。', ['重新下载', '校验文件大小与哈希']),
|
|
37
|
+
D(codes_1.CODES.INTEGRITY_MISMATCH, '完整性校验失败', 'error', 'build', '下载内容的 sha512 与索引声明不一致，可能被篡改或传输损坏。', ['重新下载；仍失败则联系发布者', '不要跳过校验强行安装']),
|
|
37
38
|
D(codes_1.CODES.OUTPUT_NOT_WRITABLE, '输出目录不可写', 'error', 'build', '目标目录不存在或当前用户没有写权限。', ['换到有写权限的目录', '检查挂载点是否只读']),
|
|
38
39
|
D(codes_1.CODES.DISK_FULL, '磁盘空间不足', 'error', 'build', '写入产物时文件系统返回 ENOSPC。', ['清理 `dist/`、缓存与旧版本产物', '换更大的磁盘或挂载点']),
|
|
39
40
|
// ---------------- 3xxx mods / apps ----------------
|
|
@@ -44,6 +45,9 @@ const LIST = [
|
|
|
44
45
|
D(codes_1.CODES.ENTRY_UNSUPPORTED, '入口类型不支持', 'error', 'mod', '入口扩展名不在支持列表内。', ['支持 .spk / .js / .mjs / .cjs', '把入口改成 `index.spk` 或编译为 `.mjs`']),
|
|
45
46
|
D(codes_1.CODES.SPK_COMPILE_FAILED, '模组 .spk 编译失败', 'error', 'mod', '模组源码没通过类型检查或代码生成。', ['按诊断修源码', '先用 `spm run <file>` 单独跑通']),
|
|
46
47
|
D(codes_1.CODES.VERSION_MISMATCH, '版本不兼容', 'error', 'mod', '模组要求的 SDK / OS 版本与当前宿主不符。', ['升级宿主或降低模组要求', '检查 `sdk` / `os.min` 字段']),
|
|
48
|
+
D(codes_1.CODES.CONFIG_INVALID, '配置无效', 'error', 'mod', '配置文件无法解析，或字段类型/取值不合法。', ['检查 `spak.config.yml` 的缩进与字段名', '端口必须是 0-65535 的整数']),
|
|
49
|
+
D(codes_1.CODES.SIGNATURE_INVALID, '签名校验失败', 'error', 'mod', '官方条目的 ed25519 签名与内置公钥不匹配，或签名缺失。', ['确认来源是官方索引', '不要安装未通过验签的官方包']),
|
|
50
|
+
D(codes_1.CODES.INSTALL_FAILED, '安装或升级失败', 'error', 'mod', 'npm 安装/升级命令返回了非零状态，或目标包不可用。', ['检查 npm 登录状态：`npm whoami`', '确认包名与版本存在，或改用镜像重试']),
|
|
47
51
|
// ---------------- 4xxx runtime ----------------
|
|
48
52
|
D(codes_1.CODES.UNCAUGHT_EXCEPTION, '未捕获异常', 'fatal', 'runtime', '异常逃出了所有 try/catch，进程即将退出。', ['按堆栈定位第一行业务代码', '在该层加 `try/catch` 并给出可读错误']),
|
|
49
53
|
D(codes_1.CODES.UNHANDLED_REJECTION, '未处理的 Promise 拒绝', 'fatal', 'runtime', '异步调用失败但没有任何 catch。', ['给 Promise 加 `.catch()` 或用 `try/await`', '加全局 `process.on("unhandledRejection")` 兜底上报']),
|
|
@@ -52,6 +56,15 @@ const LIST = [
|
|
|
52
56
|
D(codes_1.CODES.ROUTE_DUPLICATE, '路由重复注册', 'warning', 'runtime', '同一 method + path 被注册两次，后注册的会覆盖前者。', ['合并处理函数', '给不同模组的路由加前缀']),
|
|
53
57
|
D(codes_1.CODES.HANDLER_THREW, '请求处理函数抛错', 'error', 'runtime', '路由 handler 内部异常，已返回 500。', ['看服务日志里的原始堆栈', '把可能失败的 IO 放进 try/catch']),
|
|
54
58
|
D(codes_1.CODES.BODY_TOO_LARGE, '请求体过大', 'warning', 'runtime', '请求体超过 1 MB 上限，已被拒绝（413）。', ['改传文件而不是塞进 JSON', '或调大宿主的上限配置']),
|
|
59
|
+
D(codes_1.CODES.UNKNOWN_COMMAND, '未知命令', 'error', 'runtime', '输入的命令不在当前 CLI 的注册表里。', ['运行 `spm --help` 查看全部命令', '或用 `spm help <命令>` 查看某个命令的用法']),
|
|
60
|
+
D(codes_1.CODES.COMMAND_EXTENSION_MISSING, '命令需要扩展', 'error', 'runtime', '这个命令由扩展提供，但当前没有安装该扩展。', ['安装扩展：`spm iwant -i <扩展id>`', '查看已安装扩展：`spm iwant --list`']),
|
|
61
|
+
D(codes_1.CODES.COMMAND_EXTENSION_HINT, '命令可能在扩展里', 'error', 'runtime', '输入的命令不存在，但和某个扩展提供的命令非常相似。', ['如果你想用这个命令，先安装对应扩展：`spm iwant -i <扩展id>`', '查看可用扩展：`spm iwant --list`']),
|
|
62
|
+
D(codes_1.CODES.SYSTEM_PACKAGE_IWANT, '系统包只能用 iwant 安装', 'error', 'runtime', '系统级包（@starpak/*）不允许用 install 直接安装；它们属于扩展能力，由 iwant 管理。', ['安装扩展：`spm iwant -i <扩展id>`', '升级用 `spm update`（系统包与扩展都支持）', '查看扩展：`spm iwant --list`']),
|
|
63
|
+
D(codes_1.CODES.MISSING_ARGUMENT, '缺少参数', 'error', 'runtime', '命令需要的参数或参数值没有提供。', ['按提示补齐参数', '用 `<命令> --help` 查看必填项与示例']),
|
|
64
|
+
D(codes_1.CODES.INVALID_OPTION, '未知参数', 'error', 'runtime', '传入了当前命令不认识的选项。', ['检查拼写与短选项', '用 `<命令> --help` 查看可用选项']),
|
|
65
|
+
D(codes_1.CODES.SERVICE_STOP_FAILED, '停止服务失败', 'error', 'runtime', '终止服务进程时出错（pid 不存在、无权限或信号发送失败）。', ['确认进程是否还在：`ps -p <pid>`', '权限不足时用相同用户或管理员身份重试']),
|
|
66
|
+
D(codes_1.CODES.AUTH_FAILED, '凭据验证失败', 'error', 'permission', 'npm token 无效、被吊销，或权限不足（需 Read and write + Bypass 2FA）。', ['重新生成 token 并更新 ~/.config/starpak/credentials.json', '确认 scope 属于当前账号']),
|
|
67
|
+
D(codes_1.CODES.INVALID_PATH, '路径不合法', 'error', 'fs', '传入了相对路径、不存在的位置，或不满足命令要求的路径形式。', ['改用绝对路径（以 / 开头）', '确认文件/目录存在且有权限']),
|
|
55
68
|
// ---------------- 5xxx permission ----------------
|
|
56
69
|
D(codes_1.CODES.PERMISSION_UNDECLARED, '权限未声明', 'error', 'permission', '调用了清单里没有声明的能力。', ['在 `permissions` 里显式声明（fs / network / childProcess）', '最小权限原则：只开需要的']),
|
|
57
70
|
D(codes_1.CODES.FS_DENIED, '文件访问被拒绝', 'error', 'permission', '模组/应用没有 fs 权限，或只读却尝试写入。', ['申请 `fs: read` 或 `fs: write`', '把要读的文件放进允许的目录']),
|
package/lib/definitions.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../src/definitions.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;
|
|
1
|
+
{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../src/definitions.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
package/src/codes.ts
CHANGED
|
@@ -29,6 +29,7 @@ export const CODES = {
|
|
|
29
29
|
PAK_VERSION_UNSUPPORTED: 'SPAK-2005',
|
|
30
30
|
PAK_MANIFEST_INVALID: 'SPAK-2006',
|
|
31
31
|
PAK_TRUNCATED: 'SPAK-2007',
|
|
32
|
+
INTEGRITY_MISMATCH: 'SPAK-2010',
|
|
32
33
|
OUTPUT_NOT_WRITABLE: 'SPAK-2008',
|
|
33
34
|
DISK_FULL: 'SPAK-2009',
|
|
34
35
|
|
|
@@ -40,6 +41,9 @@ export const CODES = {
|
|
|
40
41
|
ENTRY_UNSUPPORTED: 'SPAK-3005',
|
|
41
42
|
SPK_COMPILE_FAILED: 'SPAK-3006',
|
|
42
43
|
VERSION_MISMATCH: 'SPAK-3007',
|
|
44
|
+
CONFIG_INVALID: 'SPAK-3008',
|
|
45
|
+
INSTALL_FAILED: 'SPAK-3009',
|
|
46
|
+
SIGNATURE_INVALID: 'SPAK-3010',
|
|
43
47
|
|
|
44
48
|
// ---- 4xxx runtime -------------------------------------------------------
|
|
45
49
|
UNCAUGHT_EXCEPTION: 'SPAK-4001',
|
|
@@ -49,6 +53,15 @@ export const CODES = {
|
|
|
49
53
|
ROUTE_DUPLICATE: 'SPAK-4005',
|
|
50
54
|
HANDLER_THREW: 'SPAK-4006',
|
|
51
55
|
BODY_TOO_LARGE: 'SPAK-4007',
|
|
56
|
+
UNKNOWN_COMMAND: 'SPAK-4008',
|
|
57
|
+
MISSING_ARGUMENT: 'SPAK-4009',
|
|
58
|
+
INVALID_OPTION: 'SPAK-4010',
|
|
59
|
+
SERVICE_STOP_FAILED: 'SPAK-4011',
|
|
60
|
+
INVALID_PATH: 'SPAK-4012',
|
|
61
|
+
AUTH_FAILED: 'SPAK-4013',
|
|
62
|
+
COMMAND_EXTENSION_MISSING: 'SPAK-4014',
|
|
63
|
+
COMMAND_EXTENSION_HINT: 'SPAK-4015',
|
|
64
|
+
SYSTEM_PACKAGE_IWANT: 'SPAK-4016',
|
|
52
65
|
|
|
53
66
|
// ---- 5xxx permission ----------------------------------------------------
|
|
54
67
|
PERMISSION_UNDECLARED: 'SPAK-5001',
|
package/src/definitions.ts
CHANGED
|
@@ -71,8 +71,8 @@ const LIST: ErrorDefinition[] = [
|
|
|
71
71
|
// ---------------- 2xxx build ----------------
|
|
72
72
|
D(CODES.BUILD_FAILED, '构建失败', 'error', 'build', '打包器（esbuild/SEA/容器封装）在某个阶段返回了错误。',
|
|
73
73
|
['看构建日志里的第一条错误，后面通常是连锁反应', '`spm build` 加 `--target` 明确目标']),
|
|
74
|
-
D(CODES.ENTRY_NOT_FOUND, '入口文件不存在', 'error', 'build', '
|
|
75
|
-
['检查 `
|
|
74
|
+
D(CODES.ENTRY_NOT_FOUND, '入口文件不存在', 'error', 'build', '给定路径不存在，或目录里没有清单与默认入口文件。',
|
|
75
|
+
['检查 `-i` 路径是否存在（文件或目录都可以）', '传目录时会自动查找清单与 index.* 入口', '构建当前目录可直接用 `spm build -i .`']),
|
|
76
76
|
D(CODES.UNKNOWN_TARGET, '未知构建目标', 'error', 'build', '`--target` 传了当前构建器不支持的名字。',
|
|
77
77
|
['可用目标：node / server / app / web / gal', '`spm build --help` 查看当次构建器支持列表']),
|
|
78
78
|
D(CODES.PAK_MAGIC_INVALID, '不是有效的 SPAK 包', 'error', 'build', '文件头不是 `SPAK`，可能不是包或下载被截断。',
|
|
@@ -83,6 +83,8 @@ const LIST: ErrorDefinition[] = [
|
|
|
83
83
|
['重新打包', '检查打包脚本是否写入了空清单']),
|
|
84
84
|
D(CODES.PAK_TRUNCATED, '包被截断', 'error', 'build', '文件长度小于 manifest 声明的长度，传输不完整。',
|
|
85
85
|
['重新下载', '校验文件大小与哈希']),
|
|
86
|
+
D(CODES.INTEGRITY_MISMATCH, '完整性校验失败', 'error', 'build', '下载内容的 sha512 与索引声明不一致，可能被篡改或传输损坏。',
|
|
87
|
+
['重新下载；仍失败则联系发布者', '不要跳过校验强行安装']),
|
|
86
88
|
D(CODES.OUTPUT_NOT_WRITABLE, '输出目录不可写', 'error', 'build', '目标目录不存在或当前用户没有写权限。',
|
|
87
89
|
['换到有写权限的目录', '检查挂载点是否只读']),
|
|
88
90
|
D(CODES.DISK_FULL, '磁盘空间不足', 'error', 'build', '写入产物时文件系统返回 ENOSPC。',
|
|
@@ -103,6 +105,12 @@ const LIST: ErrorDefinition[] = [
|
|
|
103
105
|
['按诊断修源码', '先用 `spm run <file>` 单独跑通']),
|
|
104
106
|
D(CODES.VERSION_MISMATCH, '版本不兼容', 'error', 'mod', '模组要求的 SDK / OS 版本与当前宿主不符。',
|
|
105
107
|
['升级宿主或降低模组要求', '检查 `sdk` / `os.min` 字段']),
|
|
108
|
+
D(CODES.CONFIG_INVALID, '配置无效', 'error', 'mod', '配置文件无法解析，或字段类型/取值不合法。',
|
|
109
|
+
['检查 `spak.config.yml` 的缩进与字段名', '端口必须是 0-65535 的整数']),
|
|
110
|
+
D(CODES.SIGNATURE_INVALID, '签名校验失败', 'error', 'mod', '官方条目的 ed25519 签名与内置公钥不匹配，或签名缺失。',
|
|
111
|
+
['确认来源是官方索引', '不要安装未通过验签的官方包']),
|
|
112
|
+
D(CODES.INSTALL_FAILED, '安装或升级失败', 'error', 'mod', 'npm 安装/升级命令返回了非零状态，或目标包不可用。',
|
|
113
|
+
['检查 npm 登录状态：`npm whoami`', '确认包名与版本存在，或改用镜像重试']),
|
|
106
114
|
|
|
107
115
|
// ---------------- 4xxx runtime ----------------
|
|
108
116
|
D(CODES.UNCAUGHT_EXCEPTION, '未捕获异常', 'fatal', 'runtime', '异常逃出了所有 try/catch，进程即将退出。',
|
|
@@ -119,6 +127,27 @@ const LIST: ErrorDefinition[] = [
|
|
|
119
127
|
['看服务日志里的原始堆栈', '把可能失败的 IO 放进 try/catch']),
|
|
120
128
|
D(CODES.BODY_TOO_LARGE, '请求体过大', 'warning', 'runtime', '请求体超过 1 MB 上限，已被拒绝（413）。',
|
|
121
129
|
['改传文件而不是塞进 JSON', '或调大宿主的上限配置']),
|
|
130
|
+
D(CODES.UNKNOWN_COMMAND, '未知命令', 'error', 'runtime', '输入的命令不在当前 CLI 的注册表里。',
|
|
131
|
+
['运行 `spm --help` 查看全部命令', '或用 `spm help <命令>` 查看某个命令的用法']),
|
|
132
|
+
D(CODES.COMMAND_EXTENSION_MISSING, '命令需要扩展', 'error', 'runtime',
|
|
133
|
+
'这个命令由扩展提供，但当前没有安装该扩展。',
|
|
134
|
+
['安装扩展：`spm iwant -i <扩展id>`', '查看已安装扩展：`spm iwant --list`']),
|
|
135
|
+
D(CODES.COMMAND_EXTENSION_HINT, '命令可能在扩展里', 'error', 'runtime',
|
|
136
|
+
'输入的命令不存在，但和某个扩展提供的命令非常相似。',
|
|
137
|
+
['如果你想用这个命令，先安装对应扩展：`spm iwant -i <扩展id>`', '查看可用扩展：`spm iwant --list`']),
|
|
138
|
+
D(CODES.SYSTEM_PACKAGE_IWANT, '系统包只能用 iwant 安装', 'error', 'runtime',
|
|
139
|
+
'系统级包（@starpak/*）不允许用 install 直接安装；它们属于扩展能力，由 iwant 管理。',
|
|
140
|
+
['安装扩展：`spm iwant -i <扩展id>`', '升级用 `spm update`（系统包与扩展都支持）', '查看扩展：`spm iwant --list`']),
|
|
141
|
+
D(CODES.MISSING_ARGUMENT, '缺少参数', 'error', 'runtime', '命令需要的参数或参数值没有提供。',
|
|
142
|
+
['按提示补齐参数', '用 `<命令> --help` 查看必填项与示例']),
|
|
143
|
+
D(CODES.INVALID_OPTION, '未知参数', 'error', 'runtime', '传入了当前命令不认识的选项。',
|
|
144
|
+
['检查拼写与短选项', '用 `<命令> --help` 查看可用选项']),
|
|
145
|
+
D(CODES.SERVICE_STOP_FAILED, '停止服务失败', 'error', 'runtime', '终止服务进程时出错（pid 不存在、无权限或信号发送失败）。',
|
|
146
|
+
['确认进程是否还在：`ps -p <pid>`', '权限不足时用相同用户或管理员身份重试']),
|
|
147
|
+
D(CODES.AUTH_FAILED, '凭据验证失败', 'error', 'permission', 'npm token 无效、被吊销，或权限不足（需 Read and write + Bypass 2FA）。',
|
|
148
|
+
['重新生成 token 并更新 ~/.config/starpak/credentials.json', '确认 scope 属于当前账号']),
|
|
149
|
+
D(CODES.INVALID_PATH, '路径不合法', 'error', 'fs', '传入了相对路径、不存在的位置，或不满足命令要求的路径形式。',
|
|
150
|
+
['改用绝对路径（以 / 开头）', '确认文件/目录存在且有权限']),
|
|
122
151
|
|
|
123
152
|
// ---------------- 5xxx permission ----------------
|
|
124
153
|
D(CODES.PERMISSION_UNDECLARED, '权限未声明', 'error', 'permission', '调用了清单里没有声明的能力。',
|