@astrale-os/sdk 0.5.0-beta.11 → 0.5.0-beta.12
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.
|
@@ -16,15 +16,19 @@ export type FunctionInputValidationDetails = ValueObject & {
|
|
|
16
16
|
};
|
|
17
17
|
/** Structured reason attached to a Protocol VALIDATION_ERROR for Function input. */
|
|
18
18
|
export type FunctionInputValidationReason = errors.ErrorReason<'FUNCTION_INPUT_INVALID', FunctionInputValidationDetails>;
|
|
19
|
-
|
|
19
|
+
/** Protocol classifications a Domain handler may author as an expected failure. */
|
|
20
|
+
export type InvocationErrorCode = Extract<keyof typeof errors.CODES, 'VALIDATION_ERROR' | 'ACCESS_DENIED' | 'NOT_FOUND' | 'CONFLICT' | 'UNSUPPORTED' | 'LIMIT_EXCEEDED' | 'BACKEND_UNAVAILABLE'>;
|
|
20
21
|
export interface InvocationErrorOptions extends ErrorOptions {
|
|
21
|
-
readonly
|
|
22
|
+
readonly reason?: errors.ErrorReason;
|
|
22
23
|
}
|
|
23
|
-
/**
|
|
24
|
+
/**
|
|
25
|
+
* Public, handler-authored expected failure from one Domain invocation.
|
|
26
|
+
* The message and optional reason are caller-visible and must contain no private data.
|
|
27
|
+
*/
|
|
24
28
|
export declare class InvocationError extends Error {
|
|
25
29
|
readonly code: InvocationErrorCode;
|
|
26
30
|
readonly name = "InvocationError";
|
|
27
|
-
readonly
|
|
31
|
+
readonly reason?: errors.ErrorReason;
|
|
28
32
|
constructor(code: InvocationErrorCode, message: string, options?: InvocationErrorOptions);
|
|
29
33
|
}
|
|
30
34
|
export type InvocationInternalErrorCode = 'FUNCTION_DEPLOYMENT_MISMATCH' | 'FUNCTION_DEPLOYMENT_MISSING' | 'FUNCTION_HANDLER_INVALID' | 'INVOCATION_OUTPUT_INVALID' | 'INVOCATION_RESULT_CONTRACT_VIOLATION' | 'INVOCATION_TARGET_INVALID';
|
|
@@ -38,6 +42,6 @@ export declare function protocolError(code: keyof typeof errors.CODES, message:
|
|
|
38
42
|
export declare function functionInputValidationError(callable: Key.Callable, diagnostics: readonly DomainDiagnostic[]): errors.ProtocolError;
|
|
39
43
|
/** Project only already-public Client failures at an SDK Server boundary. */
|
|
40
44
|
export declare function projectClientError(input: unknown): errors.ProtocolError | undefined;
|
|
41
|
-
/** Project recognized SDK application failures without exposing private Domain
|
|
45
|
+
/** Project recognized SDK application failures without exposing private Domain defects. */
|
|
42
46
|
export declare function projectApplicationError(input: unknown): errors.ProtocolError;
|
|
43
47
|
//# sourceMappingURL=error.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/invocation/error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,IAAI,WAAW,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAA;AAQhF,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAA;AAMpD,2EAA2E;AAC3E,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,yEAAyE;AACzE,MAAM,MAAM,8BAA8B,GAAG,WAAW,GAAG;IACzD,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,uBAAuB,EAAE,CAAA;IACxD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B,CAAA;AAED,oFAAoF;AACpF,MAAM,MAAM,6BAA6B,GAAG,MAAM,CAAC,WAAW,CAC5D,wBAAwB,EACxB,8BAA8B,CAC/B,CAAA;AAED,MAAM,MAAM,mBAAmB,
|
|
1
|
+
{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/invocation/error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,IAAI,WAAW,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAA;AAQhF,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAA;AAMpD,2EAA2E;AAC3E,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,yEAAyE;AACzE,MAAM,MAAM,8BAA8B,GAAG,WAAW,GAAG;IACzD,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,uBAAuB,EAAE,CAAA;IACxD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B,CAAA;AAED,oFAAoF;AACpF,MAAM,MAAM,6BAA6B,GAAG,MAAM,CAAC,WAAW,CAC5D,wBAAwB,EACxB,8BAA8B,CAC/B,CAAA;AAED,mFAAmF;AACnF,MAAM,MAAM,mBAAmB,GAAG,OAAO,CACvC,MAAM,OAAO,MAAM,CAAC,KAAK,EACvB,kBAAkB,GAClB,eAAe,GACf,WAAW,GACX,UAAU,GACV,aAAa,GACb,gBAAgB,GAChB,qBAAqB,CACxB,CAAA;AAED,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAA;CACrC;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAKtC,QAAQ,CAAC,IAAI,EAAE,mBAAmB;IAJpC,QAAQ,CAAC,IAAI,qBAAoB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAA;IAEpC,YACW,IAAI,EAAE,mBAAmB,EAClC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,sBAA2B,EAOrC;CACF;AAED,MAAM,MAAM,2BAA2B,GACnC,8BAA8B,GAC9B,6BAA6B,GAC7B,0BAA0B,GAC1B,2BAA2B,GAC3B,sCAAsC,GACtC,2BAA2B,CAAA;AAE/B,2EAA2E;AAC3E,qBAAa,uBAAwB,SAAQ,KAAK;IAE9C,QAAQ,CAAC,IAAI,EAAE,2BAA2B;IAD5C,YACW,IAAI,EAAE,2BAA2B,EAC1C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EAIvB;CACF;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,OAAO,MAAM,CAAC,KAAK,EAC/B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,KAAK,GACX,MAAM,CAAC,aAAa,CAMtB;AAED,mFAAmF;AACnF,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,GAAG,CAAC,QAAQ,EACtB,WAAW,EAAE,SAAS,gBAAgB,EAAE,GACvC,MAAM,CAAC,aAAa,CA6BtB;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,aAAa,GAAG,SAAS,CAoBnF;AAED,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,aAAa,CAM5E"}
|
package/dist/invocation/error.js
CHANGED
|
@@ -3,15 +3,21 @@ import { errors } from '@astrale-os/kernel-protocol';
|
|
|
3
3
|
const FUNCTION_INPUT_REASON = 'FUNCTION_INPUT_INVALID';
|
|
4
4
|
const MAX_PUBLIC_INPUT_DIAGNOSTICS = 32;
|
|
5
5
|
const PUBLIC_INPUT_DIAGNOSTIC_CODES = new Set(['VALUE_SCHEMA_INSTANCE_INVALID', 'VS_NUMBER_DOMAIN']);
|
|
6
|
-
/**
|
|
6
|
+
/**
|
|
7
|
+
* Public, handler-authored expected failure from one Domain invocation.
|
|
8
|
+
* The message and optional reason are caller-visible and must contain no private data.
|
|
9
|
+
*/
|
|
7
10
|
export class InvocationError extends Error {
|
|
8
11
|
code;
|
|
9
12
|
name = 'InvocationError';
|
|
10
|
-
|
|
13
|
+
reason;
|
|
11
14
|
constructor(code, message, options = {}) {
|
|
12
15
|
super(message, options);
|
|
13
16
|
this.code = code;
|
|
14
|
-
this.
|
|
17
|
+
this.reason =
|
|
18
|
+
options.reason === undefined
|
|
19
|
+
? undefined
|
|
20
|
+
: errors.acceptReason(options.reason, 'InvocationError reason');
|
|
15
21
|
}
|
|
16
22
|
}
|
|
17
23
|
/** Private SDK defect marker. Kernel Server seals it as INTERNAL_ERROR. */
|
|
@@ -70,7 +76,7 @@ export function projectClientError(input) {
|
|
|
70
76
|
}
|
|
71
77
|
return undefined;
|
|
72
78
|
}
|
|
73
|
-
/** Project recognized SDK application failures without exposing private Domain
|
|
79
|
+
/** Project recognized SDK application failures without exposing private Domain defects. */
|
|
74
80
|
export function projectApplicationError(input) {
|
|
75
81
|
if (input instanceof errors.ProtocolError)
|
|
76
82
|
return input;
|
|
@@ -82,28 +88,6 @@ export function projectApplicationError(input) {
|
|
|
82
88
|
throw input;
|
|
83
89
|
}
|
|
84
90
|
function projectInvocationError(input) {
|
|
85
|
-
|
|
86
|
-
case 'FUNCTION_INVOCATION_INVALID':
|
|
87
|
-
case 'FUNCTION_INPUT_INVALID':
|
|
88
|
-
return protocolError('VALIDATION_ERROR', 'Function invocation is invalid.');
|
|
89
|
-
case 'FUNCTION_CONFLICT':
|
|
90
|
-
return protocolError('CONFLICT', 'Function execution conflicts with current state.');
|
|
91
|
-
case 'FUNCTION_UNAVAILABLE':
|
|
92
|
-
case 'FUNCTION_MISS':
|
|
93
|
-
return protocolError('METHOD_NOT_FOUND', 'Callable was not found.');
|
|
94
|
-
case 'FUNCTION_DENIED':
|
|
95
|
-
return protocolError('ACCESS_DENIED', 'Access denied.');
|
|
96
|
-
case 'FUNCTION_BINDING_UNAVAILABLE':
|
|
97
|
-
return protocolError('BACKEND_UNAVAILABLE', 'Callable execution is unavailable.');
|
|
98
|
-
case 'FUNCTION_CANCELLED':
|
|
99
|
-
return protocolError('CANCELLED', 'Function invocation was cancelled.');
|
|
100
|
-
case 'FUNCTION_DEADLINE_EXCEEDED':
|
|
101
|
-
return protocolError('DEADLINE_EXCEEDED', 'Function invocation deadline exceeded.');
|
|
102
|
-
case 'FUNCTION_EXECUTION_FAILED':
|
|
103
|
-
case 'FUNCTION_OUTPUT_INVALID':
|
|
104
|
-
case 'FUNCTION_BINDING_INVALID':
|
|
105
|
-
case 'RESULT_CONTRACT_VIOLATION':
|
|
106
|
-
return protocolError('INTERNAL_ERROR', 'Internal application error.');
|
|
107
|
-
}
|
|
91
|
+
return protocolError(input.code, input.message, input.reason);
|
|
108
92
|
}
|
|
109
93
|
//# sourceMappingURL=error.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/invocation/error.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,WAAW,EACX,aAAa,IAAI,mBAAmB,EACpC,aAAa,EACb,cAAc,GACf,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAA;AAEpD,MAAM,qBAAqB,GAAG,wBAAwB,CAAA;AACtD,MAAM,4BAA4B,GAAG,EAAE,CAAA;AACvC,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAC,CAAC,+BAA+B,EAAE,kBAAkB,CAAC,CAAC,CAAA;
|
|
1
|
+
{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/invocation/error.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,WAAW,EACX,aAAa,IAAI,mBAAmB,EACpC,aAAa,EACb,cAAc,GACf,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAA;AAEpD,MAAM,qBAAqB,GAAG,wBAAwB,CAAA;AACtD,MAAM,4BAA4B,GAAG,EAAE,CAAA;AACvC,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAC,CAAC,+BAA+B,EAAE,kBAAkB,CAAC,CAAC,CAAA;AAsCpG;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAK7B,IAAI;IAJN,IAAI,GAAG,iBAAiB,CAAA;IACxB,MAAM,CAAqB;IAEpC,YACW,IAAyB,EAClC,OAAe,EACf,OAAO,GAA2B,EAAE;QAEpC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;oBAJd,IAAI;QAKb,IAAI,CAAC,MAAM;YACT,OAAO,CAAC,MAAM,KAAK,SAAS;gBAC1B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;IACrE,CAAC;CACF;AAUD,2EAA2E;AAC3E,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAErC,IAAI;IADf,YACW,IAAiC,EAC1C,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;oBAJd,IAAI;QAKb,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACvC,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAC3B,IAA+B,EAC/B,OAAe,EACf,IAAY;IAEZ,OAAO,IAAI,MAAM,CAAC,aAAa,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QACxB,OAAO;QACP,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;KACxC,CAAC,CAAA;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,4BAA4B,CAC1C,QAAsB,EACtB,WAAwC;IAExC,IACE,WAAW,CAAC,MAAM,KAAK,CAAC;QACxB,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,6BAA6B,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EACrF,CAAC;QACD,MAAM,IAAI,uBAAuB,CAC/B,sCAAsC,EACtC,kEAAkE,CACnE,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAC7B,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,4BAA4B,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CACpE,MAAM,CAAC,MAAM,CAAC;QACZ,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,GAAG,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;QACnE,OAAO,EAAE,UAAU,CAAC,OAAO;KAC5B,CAAC,CACH,CACF,CAAA;IACD,MAAM,MAAM,GAAkC,MAAM,CAAC,MAAM,CAAC;QAC1D,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;YACrB,QAAQ;YACR,WAAW,EAAE,SAAS;YACtB,SAAS,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM;SACjD,CAAC;KACH,CAAC,CAAA;IACF,OAAO,aAAa,CAAC,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,CAAC,CAAA;AAChF,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;QACnC,OAAO,IAAI,MAAM,CAAC,aAAa,CAAC;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SAC1D,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO,aAAa,CAClB,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,qBAAqB,EACvE,KAAK,CAAC,KAAK,KAAK,SAAS;YACvB,CAAC,CAAC,0CAA0C;YAC5C,CAAC,CAAC,+BAA+B,CACpC,CAAA;IACH,CAAC;IACD,IAAI,KAAK,YAAY,mBAAmB,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACzE,OAAO,aAAa,CAAC,qBAAqB,EAAE,+BAA+B,CAAC,CAAA;IAC9E,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,KAAK,YAAY,MAAM,CAAC,aAAa;QAAE,OAAO,KAAK,CAAA;IACvD,IAAI,KAAK,YAAY,eAAe;QAAE,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAA;IAC1E,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAC3C,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC7C,MAAM,KAAK,CAAA;AACb,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAsB;IACpD,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;AAC/D,CAAC"}
|