apcore-js 0.21.0 → 0.22.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/README.md +33 -3
- package/dist/acl-file.d.ts +12 -0
- package/dist/acl-file.d.ts.map +1 -0
- package/dist/acl-file.js +46 -0
- package/dist/acl-file.js.map +1 -0
- package/dist/acl-handlers.d.ts.map +1 -1
- package/dist/acl-handlers.js +5 -0
- package/dist/acl-handlers.js.map +1 -1
- package/dist/acl.d.ts.map +1 -1
- package/dist/acl.js +20 -37
- package/dist/acl.js.map +1 -1
- package/dist/async-task.d.ts +49 -14
- package/dist/async-task.d.ts.map +1 -1
- package/dist/async-task.js +134 -39
- package/dist/async-task.js.map +1 -1
- package/dist/bindings.d.ts +1 -1
- package/dist/bindings.d.ts.map +1 -1
- package/dist/bindings.js +10 -26
- package/dist/bindings.js.map +1 -1
- package/dist/browser/index.d.ts +77 -0
- package/dist/browser/index.d.ts.map +1 -0
- package/dist/browser/index.js +78 -0
- package/dist/browser/index.js.map +1 -0
- package/dist/builtin-steps.d.ts +14 -12
- package/dist/builtin-steps.d.ts.map +1 -1
- package/dist/builtin-steps.js +83 -30
- package/dist/builtin-steps.js.map +1 -1
- package/dist/cancel.d.ts +23 -2
- package/dist/cancel.d.ts.map +1 -1
- package/dist/cancel.js +31 -6
- package/dist/cancel.js.map +1 -1
- package/dist/client.d.ts +4 -1
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +19 -7
- package/dist/client.js.map +1 -1
- package/dist/config-defaults.d.ts +30 -0
- package/dist/config-defaults.d.ts.map +1 -0
- package/dist/config-defaults.js +83 -0
- package/dist/config-defaults.js.map +1 -0
- package/dist/config.d.ts +39 -7
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +60 -126
- package/dist/config.js.map +1 -1
- package/dist/context.d.ts +36 -3
- package/dist/context.d.ts.map +1 -1
- package/dist/context.js +94 -11
- package/dist/context.js.map +1 -1
- package/dist/errors.d.ts +64 -1
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +101 -7
- package/dist/errors.js.map +1 -1
- package/dist/events/emitter.d.ts +46 -12
- package/dist/events/emitter.d.ts.map +1 -1
- package/dist/events/emitter.js +146 -56
- package/dist/events/emitter.js.map +1 -1
- package/dist/events/index.d.ts +2 -1
- package/dist/events/index.d.ts.map +1 -1
- package/dist/events/index.js +1 -1
- package/dist/events/index.js.map +1 -1
- package/dist/events/retry.d.ts +35 -0
- package/dist/events/retry.d.ts.map +1 -0
- package/dist/events/retry.js +52 -0
- package/dist/events/retry.js.map +1 -0
- package/dist/events/subscribers.d.ts +52 -9
- package/dist/events/subscribers.d.ts.map +1 -1
- package/dist/events/subscribers.js +96 -63
- package/dist/events/subscribers.js.map +1 -1
- package/dist/executor.d.ts +4 -1
- package/dist/executor.d.ts.map +1 -1
- package/dist/executor.js +143 -16
- package/dist/executor.js.map +1 -1
- package/dist/generated/version.d.ts +1 -1
- package/dist/generated/version.js +1 -1
- package/dist/index.d.ts +15 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +17 -4
- package/dist/index.js.map +1 -1
- package/dist/middleware/circuit-breaker.d.ts +2 -2
- package/dist/middleware/circuit-breaker.d.ts.map +1 -1
- package/dist/middleware/circuit-breaker.js +19 -19
- package/dist/middleware/circuit-breaker.js.map +1 -1
- package/dist/middleware/index.d.ts +1 -1
- package/dist/middleware/index.d.ts.map +1 -1
- package/dist/middleware/index.js +1 -1
- package/dist/middleware/index.js.map +1 -1
- package/dist/middleware/manager.d.ts +6 -2
- package/dist/middleware/manager.d.ts.map +1 -1
- package/dist/middleware/manager.js +36 -1
- package/dist/middleware/manager.js.map +1 -1
- package/dist/middleware/platform-notify.d.ts +2 -3
- package/dist/middleware/platform-notify.d.ts.map +1 -1
- package/dist/middleware/platform-notify.js +5 -6
- package/dist/middleware/platform-notify.js.map +1 -1
- package/dist/middleware/tracing-otel-default.d.ts +16 -0
- package/dist/middleware/tracing-otel-default.d.ts.map +1 -0
- package/dist/middleware/tracing-otel-default.js +25 -0
- package/dist/middleware/tracing-otel-default.js.map +1 -0
- package/dist/middleware/tracing.d.ts.map +1 -1
- package/dist/middleware/tracing.js +9 -10
- package/dist/middleware/tracing.js.map +1 -1
- package/dist/pipeline.d.ts +1 -1
- package/dist/pipeline.js +11 -11
- package/dist/pipeline.js.map +1 -1
- package/dist/registry/metadata-pure.d.ts +13 -0
- package/dist/registry/metadata-pure.d.ts.map +1 -0
- package/dist/registry/metadata-pure.js +67 -0
- package/dist/registry/metadata-pure.js.map +1 -0
- package/dist/registry/metadata.d.ts +8 -4
- package/dist/registry/metadata.d.ts.map +1 -1
- package/dist/registry/metadata.js +9 -70
- package/dist/registry/metadata.js.map +1 -1
- package/dist/registry/multi-class.d.ts +0 -31
- package/dist/registry/multi-class.d.ts.map +1 -1
- package/dist/registry/registry.d.ts +46 -10
- package/dist/registry/registry.d.ts.map +1 -1
- package/dist/registry/registry.js +273 -33
- package/dist/registry/registry.js.map +1 -1
- package/dist/registry/scanner.d.ts.map +1 -1
- package/dist/registry/scanner.js +3 -15
- package/dist/registry/scanner.js.map +1 -1
- package/dist/schema/loader-pure.d.ts +24 -0
- package/dist/schema/loader-pure.d.ts.map +1 -0
- package/dist/schema/loader-pure.js +153 -0
- package/dist/schema/loader-pure.js.map +1 -0
- package/dist/schema/loader.d.ts +14 -30
- package/dist/schema/loader.d.ts.map +1 -1
- package/dist/schema/loader.js +20 -201
- package/dist/schema/loader.js.map +1 -1
- package/dist/schema/ref-resolver.d.ts.map +1 -1
- package/dist/schema/ref-resolver.js +7 -21
- package/dist/schema/ref-resolver.js.map +1 -1
- package/dist/schema/types.d.ts.map +1 -1
- package/dist/schema/types.js +1 -1
- package/dist/schema/types.js.map +1 -1
- package/dist/schema/validator.d.ts.map +1 -1
- package/dist/schema/validator.js +11 -20
- package/dist/schema/validator.js.map +1 -1
- package/dist/streaming.d.ts +21 -0
- package/dist/streaming.d.ts.map +1 -0
- package/dist/streaming.js +32 -0
- package/dist/streaming.js.map +1 -0
- package/dist/sys-modules/control.d.ts +0 -78
- package/dist/sys-modules/control.d.ts.map +1 -1
- package/dist/sys-modules/health.d.ts +0 -138
- package/dist/sys-modules/health.d.ts.map +1 -1
- package/dist/sys-modules/install.d.ts +12 -0
- package/dist/sys-modules/install.d.ts.map +1 -0
- package/dist/sys-modules/install.js +14 -0
- package/dist/sys-modules/install.js.map +1 -0
- package/dist/sys-modules/manifest.d.ts +1 -141
- package/dist/sys-modules/manifest.d.ts.map +1 -1
- package/dist/sys-modules/overrides-file.d.ts +14 -0
- package/dist/sys-modules/overrides-file.d.ts.map +1 -0
- package/dist/sys-modules/overrides-file.js +31 -0
- package/dist/sys-modules/overrides-file.js.map +1 -0
- package/dist/sys-modules/registration.d.ts.map +1 -1
- package/dist/sys-modules/registration.js +40 -20
- package/dist/sys-modules/registration.js.map +1 -1
- package/dist/sys-modules/toggle.d.ts +0 -70
- package/dist/sys-modules/toggle.d.ts.map +1 -1
- package/dist/sys-modules/usage.d.ts +1 -132
- package/dist/sys-modules/usage.d.ts.map +1 -1
- package/dist/utils/index.d.ts +2 -3
- package/dist/utils/index.d.ts.map +1 -1
- package/dist/utils/index.js +3 -11
- package/dist/utils/index.js.map +1 -1
- package/package.json +22 -7
- package/dist/registry/index.d.ts +0 -15
- package/dist/registry/index.d.ts.map +0 -1
- package/dist/registry/index.js +0 -11
- package/dist/registry/index.js.map +0 -1
- package/dist/schema/index.d.ts +0 -11
- package/dist/schema/index.d.ts.map +0 -1
- package/dist/schema/index.js +0 -9
- package/dist/schema/index.js.map +0 -1
package/dist/context.d.ts
CHANGED
|
@@ -4,11 +4,19 @@
|
|
|
4
4
|
import type { CancelToken } from './cancel.js';
|
|
5
5
|
import { ContextLogger } from './observability/context-logger.js';
|
|
6
6
|
import type { TraceParent } from './trace-context.js';
|
|
7
|
-
export
|
|
7
|
+
export declare class Identity {
|
|
8
8
|
readonly id: string;
|
|
9
9
|
readonly type: string;
|
|
10
10
|
readonly roles: readonly string[];
|
|
11
11
|
readonly attrs: Readonly<Record<string, unknown>>;
|
|
12
|
+
constructor(id: string, type?: string, roles?: string[], attrs?: Record<string, unknown>);
|
|
13
|
+
/**
|
|
14
|
+
* Get an attribute value by key.
|
|
15
|
+
*
|
|
16
|
+
* Aligned with apcore D-03. May trigger a fetch if the identity
|
|
17
|
+
* is lazy-loaded (future extension).
|
|
18
|
+
*/
|
|
19
|
+
getAttr<T = unknown>(key: string, defaultValue?: T): T | undefined;
|
|
12
20
|
}
|
|
13
21
|
export declare function createIdentity(id: string, type?: string, roles?: string[], attrs?: Record<string, unknown>): Identity;
|
|
14
22
|
export declare class Context<T = null> {
|
|
@@ -24,10 +32,27 @@ export declare class Context<T = null> {
|
|
|
24
32
|
readonly cancelToken: CancelToken | null;
|
|
25
33
|
readonly globalDeadline: number | null;
|
|
26
34
|
private _logger;
|
|
27
|
-
|
|
35
|
+
/**
|
|
36
|
+
* Never-aborted fallback signal returned when no `cancelToken` is bound.
|
|
37
|
+
* Modules can safely attach this signal to Web APIs (`fetch`, etc.) and
|
|
38
|
+
* rely on it never firing in the no-cancel case. Lazy-created on first
|
|
39
|
+
* read so contexts without cancel support pay no AbortController cost.
|
|
40
|
+
* (D-18, apcore v0.22.0)
|
|
41
|
+
*/
|
|
42
|
+
private static _NEVER_SIGNAL;
|
|
43
|
+
constructor(traceId: string, callerId?: string | null, callChain?: string[], executor?: unknown, identity?: Identity | null, redactedInputs?: Record<string, unknown> | null, data?: Record<string, unknown>, cancelToken?: CancelToken | null, services?: T, globalDeadline?: number | null, redactedOutput?: Record<string, unknown> | null);
|
|
28
44
|
/**
|
|
29
45
|
* Create a new top-level Context with a generated 32-char hex traceId.
|
|
30
46
|
*
|
|
47
|
+
* Per apcore Issue #66 / v0.22.0, the public input list is unified across
|
|
48
|
+
* SDKs to: `identity`, `traceParent`, `cancelToken`, `data`, `services`,
|
|
49
|
+
* `globalDeadline`. `executor` and `callerId` are NOT accepted as inputs:
|
|
50
|
+
* - `executor` is bound to the Context by the Executor on first call()
|
|
51
|
+
* (see {@link _withExecutor}); top-level Contexts created locally
|
|
52
|
+
* therefore have `executor === null` until the Executor binds itself.
|
|
53
|
+
* - `callerId` is managed exclusively by {@link child}; top-level
|
|
54
|
+
* Contexts always have `callerId === null`.
|
|
55
|
+
*
|
|
31
56
|
* When `traceParent` is provided, its `traceId` is accepted only if it is
|
|
32
57
|
* exactly 32 lowercase hex characters and not the W3C-reserved all-zero
|
|
33
58
|
* or all-f value. Otherwise a fresh traceId is generated and a warning
|
|
@@ -35,7 +60,7 @@ export declare class Context<T = null> {
|
|
|
35
60
|
* performed here; such normalization is the responsibility of the
|
|
36
61
|
* TraceParent header parser or the caller's ContextFactory.
|
|
37
62
|
*/
|
|
38
|
-
static create<S = null>(
|
|
63
|
+
static create<S = null>(identity?: Identity | null, traceParent?: TraceParent | null, cancelToken?: CancelToken | null, data?: Record<string, unknown>, services?: S, globalDeadline?: number | null): Context<S>;
|
|
39
64
|
/**
|
|
40
65
|
* Serialize Context to a plain object suitable for JSON encoding.
|
|
41
66
|
*
|
|
@@ -68,6 +93,14 @@ export declare class Context<T = null> {
|
|
|
68
93
|
* Canonical construction from the JSON-decoded wire format.
|
|
69
94
|
*/
|
|
70
95
|
static fromJSON(data: Record<string, unknown>): Context;
|
|
96
|
+
/**
|
|
97
|
+
* The cancel token's `AbortSignal` if a token is bound, else a never-aborted
|
|
98
|
+
* fallback. Modules using standard Web-API I/O (`fetch`, `setTimeout` via
|
|
99
|
+
* `AbortSignal.timeout`, Web Streams) should attach this signal so they
|
|
100
|
+
* participate in real cancellation when callers invoke `cancelToken.cancel()`
|
|
101
|
+
* or `AsyncTaskManager.cancel()` (D-18, apcore v0.22.0).
|
|
102
|
+
*/
|
|
103
|
+
get signal(): AbortSignal;
|
|
71
104
|
/**
|
|
72
105
|
* Lazily-built, cached ContextLogger for this Context. Reuses the same
|
|
73
106
|
* instance on subsequent accesses so middleware that logs repeatedly does
|
package/dist/context.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}
|
package/dist/context.js
CHANGED
|
@@ -2,14 +2,32 @@
|
|
|
2
2
|
* Execution context, identity, and context creation.
|
|
3
3
|
*/
|
|
4
4
|
import { v4 as uuidv4 } from 'uuid';
|
|
5
|
+
import { ContextBindingError } from './errors.js';
|
|
5
6
|
import { ContextLogger } from './observability/context-logger.js';
|
|
7
|
+
export class Identity {
|
|
8
|
+
id;
|
|
9
|
+
type;
|
|
10
|
+
roles;
|
|
11
|
+
attrs;
|
|
12
|
+
constructor(id, type = 'user', roles = [], attrs = {}) {
|
|
13
|
+
this.id = id;
|
|
14
|
+
this.type = type;
|
|
15
|
+
this.roles = Object.freeze([...roles]);
|
|
16
|
+
this.attrs = Object.freeze({ ...attrs });
|
|
17
|
+
Object.freeze(this);
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Get an attribute value by key.
|
|
21
|
+
*
|
|
22
|
+
* Aligned with apcore D-03. May trigger a fetch if the identity
|
|
23
|
+
* is lazy-loaded (future extension).
|
|
24
|
+
*/
|
|
25
|
+
getAttr(key, defaultValue) {
|
|
26
|
+
return this.attrs[key] ?? defaultValue;
|
|
27
|
+
}
|
|
28
|
+
}
|
|
6
29
|
export function createIdentity(id, type = 'user', roles = [], attrs = {}) {
|
|
7
|
-
return
|
|
8
|
-
id,
|
|
9
|
-
type,
|
|
10
|
-
roles: Object.freeze([...roles]),
|
|
11
|
-
attrs: Object.freeze({ ...attrs }),
|
|
12
|
-
});
|
|
30
|
+
return new Identity(id, type, roles, attrs);
|
|
13
31
|
}
|
|
14
32
|
export class Context {
|
|
15
33
|
traceId;
|
|
@@ -24,14 +42,22 @@ export class Context {
|
|
|
24
42
|
cancelToken;
|
|
25
43
|
globalDeadline;
|
|
26
44
|
_logger = null;
|
|
27
|
-
|
|
45
|
+
/**
|
|
46
|
+
* Never-aborted fallback signal returned when no `cancelToken` is bound.
|
|
47
|
+
* Modules can safely attach this signal to Web APIs (`fetch`, etc.) and
|
|
48
|
+
* rely on it never firing in the no-cancel case. Lazy-created on first
|
|
49
|
+
* read so contexts without cancel support pay no AbortController cost.
|
|
50
|
+
* (D-18, apcore v0.22.0)
|
|
51
|
+
*/
|
|
52
|
+
static _NEVER_SIGNAL = null;
|
|
53
|
+
constructor(traceId, callerId = null, callChain = [], executor = null, identity = null, redactedInputs = null, data = {}, cancelToken = null, services = null, globalDeadline = null, redactedOutput = null) {
|
|
28
54
|
this.traceId = traceId;
|
|
29
55
|
this.callerId = callerId;
|
|
30
56
|
this.callChain = Object.freeze([...callChain]);
|
|
31
57
|
this.executor = executor;
|
|
32
58
|
this.identity = identity;
|
|
33
59
|
this.redactedInputs = redactedInputs;
|
|
34
|
-
this.redactedOutput =
|
|
60
|
+
this.redactedOutput = redactedOutput;
|
|
35
61
|
this.data = data;
|
|
36
62
|
this.services = services;
|
|
37
63
|
this.cancelToken = cancelToken;
|
|
@@ -40,6 +66,15 @@ export class Context {
|
|
|
40
66
|
/**
|
|
41
67
|
* Create a new top-level Context with a generated 32-char hex traceId.
|
|
42
68
|
*
|
|
69
|
+
* Per apcore Issue #66 / v0.22.0, the public input list is unified across
|
|
70
|
+
* SDKs to: `identity`, `traceParent`, `cancelToken`, `data`, `services`,
|
|
71
|
+
* `globalDeadline`. `executor` and `callerId` are NOT accepted as inputs:
|
|
72
|
+
* - `executor` is bound to the Context by the Executor on first call()
|
|
73
|
+
* (see {@link _withExecutor}); top-level Contexts created locally
|
|
74
|
+
* therefore have `executor === null` until the Executor binds itself.
|
|
75
|
+
* - `callerId` is managed exclusively by {@link child}; top-level
|
|
76
|
+
* Contexts always have `callerId === null`.
|
|
77
|
+
*
|
|
43
78
|
* When `traceParent` is provided, its `traceId` is accepted only if it is
|
|
44
79
|
* exactly 32 lowercase hex characters and not the W3C-reserved all-zero
|
|
45
80
|
* or all-f value. Otherwise a fresh traceId is generated and a warning
|
|
@@ -47,7 +82,7 @@ export class Context {
|
|
|
47
82
|
* performed here; such normalization is the responsibility of the
|
|
48
83
|
* TraceParent header parser or the caller's ContextFactory.
|
|
49
84
|
*/
|
|
50
|
-
static create(
|
|
85
|
+
static create(identity = null, traceParent = null, cancelToken = null, data, services, globalDeadline) {
|
|
51
86
|
let traceId;
|
|
52
87
|
if (traceParent) {
|
|
53
88
|
const h = traceParent.traceId;
|
|
@@ -75,7 +110,38 @@ export class Context {
|
|
|
75
110
|
if (traceParent != null && !('_apcore.trace.inbound' in ctxData)) {
|
|
76
111
|
ctxData['_apcore.trace.inbound'] = traceParent;
|
|
77
112
|
}
|
|
78
|
-
return new Context(traceId, null, [],
|
|
113
|
+
return new Context(traceId, null, [], null, identity, null, ctxData, cancelToken, services ?? null, globalDeadline ?? null);
|
|
114
|
+
}
|
|
115
|
+
/**
|
|
116
|
+
* @internal SDK-only. Returns a new Context with `executor` bound.
|
|
117
|
+
*
|
|
118
|
+
* Idempotent for the same Executor instance — returns `this` unchanged.
|
|
119
|
+
* Throws {@link ContextBindingError} if the Context is already bound to a
|
|
120
|
+
* different Executor (cross-executor rebind is a programming error per
|
|
121
|
+
* apcore spec §"Contract: Executor binding to Context").
|
|
122
|
+
*/
|
|
123
|
+
_withExecutor(executor) {
|
|
124
|
+
if (this.executor === executor)
|
|
125
|
+
return this;
|
|
126
|
+
if (this.executor != null) {
|
|
127
|
+
throw new ContextBindingError('Context already bound to a different Executor instance');
|
|
128
|
+
}
|
|
129
|
+
return new Context(this.traceId, this.callerId, [...this.callChain], executor, this.identity, this.redactedInputs, this.data, this.cancelToken, this.services, this.globalDeadline, this.redactedOutput);
|
|
130
|
+
}
|
|
131
|
+
/**
|
|
132
|
+
* @internal SDK-only. Returns a new Context with `cancelToken` bound.
|
|
133
|
+
*
|
|
134
|
+
* Idempotent for the same token instance — returns `this` unchanged.
|
|
135
|
+
* Throws {@link ContextBindingError} if the Context is already bound to a
|
|
136
|
+
* different CancelToken.
|
|
137
|
+
*/
|
|
138
|
+
_withCancelToken(cancelToken) {
|
|
139
|
+
if (this.cancelToken === cancelToken)
|
|
140
|
+
return this;
|
|
141
|
+
if (this.cancelToken != null) {
|
|
142
|
+
throw new ContextBindingError('Context already bound to a different CancelToken');
|
|
143
|
+
}
|
|
144
|
+
return new Context(this.traceId, this.callerId, [...this.callChain], this.executor, this.identity, this.redactedInputs, this.data, cancelToken, this.services, this.globalDeadline, this.redactedOutput);
|
|
79
145
|
}
|
|
80
146
|
/**
|
|
81
147
|
* Serialize Context to a plain object suitable for JSON encoding.
|
|
@@ -120,7 +186,8 @@ export class Context {
|
|
|
120
186
|
return new Context(typeof data.trace_id === 'string' ? data.trace_id : '', typeof data.caller_id === 'string' ? data.caller_id : null, Array.isArray(data.call_chain) ? data.call_chain.filter((s) => typeof s === 'string') : [], null, // executor
|
|
121
187
|
identity, data.redacted_inputs ?? null, data.data ? { ...data.data } : {}, null, // cancelToken
|
|
122
188
|
null, // services
|
|
123
|
-
null
|
|
189
|
+
null, // globalDeadline
|
|
190
|
+
data.redacted_output ?? null);
|
|
124
191
|
}
|
|
125
192
|
/**
|
|
126
193
|
* Canonical JSON encoding used by JSON.stringify(context). Produces the
|
|
@@ -164,6 +231,22 @@ export class Context {
|
|
|
164
231
|
static fromJSON(data) {
|
|
165
232
|
return this.deserialize(data);
|
|
166
233
|
}
|
|
234
|
+
/**
|
|
235
|
+
* The cancel token's `AbortSignal` if a token is bound, else a never-aborted
|
|
236
|
+
* fallback. Modules using standard Web-API I/O (`fetch`, `setTimeout` via
|
|
237
|
+
* `AbortSignal.timeout`, Web Streams) should attach this signal so they
|
|
238
|
+
* participate in real cancellation when callers invoke `cancelToken.cancel()`
|
|
239
|
+
* or `AsyncTaskManager.cancel()` (D-18, apcore v0.22.0).
|
|
240
|
+
*/
|
|
241
|
+
get signal() {
|
|
242
|
+
if (this.cancelToken !== null) {
|
|
243
|
+
return this.cancelToken.signal;
|
|
244
|
+
}
|
|
245
|
+
if (Context._NEVER_SIGNAL === null) {
|
|
246
|
+
Context._NEVER_SIGNAL = new AbortController().signal;
|
|
247
|
+
}
|
|
248
|
+
return Context._NEVER_SIGNAL;
|
|
249
|
+
}
|
|
167
250
|
/**
|
|
168
251
|
* Lazily-built, cached ContextLogger for this Context. Reuses the same
|
|
169
252
|
* instance on subsequent accesses so middleware that logs repeatedly does
|
package/dist/context.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;
|
|
1
|
+
{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}
|
package/dist/errors.d.ts
CHANGED
|
@@ -8,6 +8,15 @@ export interface ErrorOptions {
|
|
|
8
8
|
aiGuidance?: string | null;
|
|
9
9
|
userFixable?: boolean | null;
|
|
10
10
|
suggestion?: string | null;
|
|
11
|
+
/**
|
|
12
|
+
* Optional structured details payload. Most subclasses build their own
|
|
13
|
+
* `details` from positional constructor args and ignore this field;
|
|
14
|
+
* subclasses that take no detail-bearing positional args (e.g.
|
|
15
|
+
* InvalidInputError) read it so callers can attach a machine-readable
|
|
16
|
+
* payload (e.g. the STREAM_CHUNK_NOT_OBJECT contract) without changing
|
|
17
|
+
* the existing positional parameter order.
|
|
18
|
+
*/
|
|
19
|
+
details?: Record<string, unknown>;
|
|
11
20
|
}
|
|
12
21
|
export declare class ModuleError extends Error {
|
|
13
22
|
static readonly DEFAULT_RETRYABLE: boolean | null;
|
|
@@ -22,6 +31,16 @@ export declare class ModuleError extends Error {
|
|
|
22
31
|
readonly suggestion: string | null;
|
|
23
32
|
constructor(code: string, message: string, details?: Record<string, unknown>, cause?: Error, traceId?: string, retryable?: boolean | null, aiGuidance?: string | null, userFixable?: boolean | null, suggestion?: string | null);
|
|
24
33
|
toString(): string;
|
|
34
|
+
/**
|
|
35
|
+
* Serialize to the canonical cross-process wire form (A-D-008).
|
|
36
|
+
*
|
|
37
|
+
* Keys are emitted in snake_case — `trace_id`, `ai_guidance`,
|
|
38
|
+
* `user_fixable` — and the `details` object's keys are snake_cased too,
|
|
39
|
+
* so the JSON matches the Python (`errors.py` `to_dict`), Rust (serde),
|
|
40
|
+
* and the spec serialization example. This is the form MCP/A2A bridges
|
|
41
|
+
* put on the wire. Internal TS consumers read the typed properties
|
|
42
|
+
* (`traceId`, `details['callerId']`, ...), not this serialized output.
|
|
43
|
+
*/
|
|
25
44
|
toJSON(): Record<string, unknown>;
|
|
26
45
|
}
|
|
27
46
|
export declare class ConfigNotFoundError extends ModuleError {
|
|
@@ -58,7 +77,7 @@ export declare class ModuleTimeoutError extends ModuleError {
|
|
|
58
77
|
}
|
|
59
78
|
export declare class SchemaValidationError extends ModuleError {
|
|
60
79
|
static readonly DEFAULT_RETRYABLE: boolean | null;
|
|
61
|
-
constructor(message?: string, errors?: Array<Record<string, unknown>>, options?: ErrorOptions);
|
|
80
|
+
constructor(message?: string, errors?: Array<Record<string, unknown>>, options?: ErrorOptions, errorCode?: string);
|
|
62
81
|
}
|
|
63
82
|
export declare class SchemaNotFoundError extends ModuleError {
|
|
64
83
|
static readonly DEFAULT_RETRYABLE: boolean | null;
|
|
@@ -72,6 +91,10 @@ export declare class SchemaCircularRefError extends ModuleError {
|
|
|
72
91
|
static readonly DEFAULT_RETRYABLE: boolean | null;
|
|
73
92
|
constructor(refPath: string, options?: ErrorOptions);
|
|
74
93
|
}
|
|
94
|
+
export declare class SchemaMaxDepthExceededError extends ModuleError {
|
|
95
|
+
static readonly DEFAULT_RETRYABLE: boolean | null;
|
|
96
|
+
constructor(refPath: string, options?: ErrorOptions);
|
|
97
|
+
}
|
|
75
98
|
export declare class CallDepthExceededError extends ModuleError {
|
|
76
99
|
static readonly DEFAULT_RETRYABLE: boolean | null;
|
|
77
100
|
constructor(depth: number, maxDepth: number, callChain: string[], options?: ErrorOptions);
|
|
@@ -264,6 +287,41 @@ export declare class SysModuleRegistrationError extends ModuleError {
|
|
|
264
287
|
static readonly DEFAULT_RETRYABLE: boolean | null;
|
|
265
288
|
constructor(moduleId: string, cause?: Error, options?: ErrorOptions);
|
|
266
289
|
}
|
|
290
|
+
/**
|
|
291
|
+
* Raised when an APCore client method requires sys_modules to be enabled.
|
|
292
|
+
*
|
|
293
|
+
* Cross-language equivalent of Rust's `ModuleError(code=SysModulesDisabled)`
|
|
294
|
+
* and Python's `SysModulesDisabledError`. Replaces bare `Error` in
|
|
295
|
+
* `APCore.on/off/disable/enable` so callers can dispatch on
|
|
296
|
+
* `error.code === 'SYS_MODULES_DISABLED'` instead of catching generic
|
|
297
|
+
* `Error`.
|
|
298
|
+
*/
|
|
299
|
+
export declare class SysModulesDisabledError extends ModuleError {
|
|
300
|
+
static readonly DEFAULT_RETRYABLE: boolean | null;
|
|
301
|
+
constructor(message: string, options?: ErrorOptions);
|
|
302
|
+
}
|
|
303
|
+
export declare class DuplicateModuleIdError extends ModuleError {
|
|
304
|
+
static readonly DEFAULT_RETRYABLE: boolean | null;
|
|
305
|
+
constructor(moduleId: string, options?: ErrorOptions);
|
|
306
|
+
}
|
|
307
|
+
export declare class StreamingInterfaceError extends ModuleError {
|
|
308
|
+
static readonly DEFAULT_RETRYABLE: boolean | null;
|
|
309
|
+
readonly moduleId: string;
|
|
310
|
+
readonly annotationValue: boolean;
|
|
311
|
+
readonly hasStreamMethod: boolean;
|
|
312
|
+
readonly hasMarker: boolean;
|
|
313
|
+
constructor(moduleId: string, annotationValue: boolean, hasStreamMethod: boolean, hasMarker: boolean, options?: ErrorOptions);
|
|
314
|
+
}
|
|
315
|
+
/**
|
|
316
|
+
* Raised when a Context that is already bound to one Executor (or CancelToken)
|
|
317
|
+
* is offered to a different Executor (or CancelToken). Per apcore Issue #66 /
|
|
318
|
+
* v0.22.0 spec "Contract: Executor binding to Context", binding is a one-shot
|
|
319
|
+
* operation: idempotent for the same instance, error for a different one.
|
|
320
|
+
*/
|
|
321
|
+
export declare class ContextBindingError extends ModuleError {
|
|
322
|
+
static readonly DEFAULT_RETRYABLE: boolean | null;
|
|
323
|
+
constructor(message: string, options?: ErrorOptions);
|
|
324
|
+
}
|
|
267
325
|
/**
|
|
268
326
|
* All framework error codes as constants.
|
|
269
327
|
* Use these instead of hardcoding error code strings.
|
|
@@ -291,6 +349,7 @@ export declare const ErrorCodes: Readonly<{
|
|
|
291
349
|
readonly SCHEMA_NOT_FOUND: "SCHEMA_NOT_FOUND";
|
|
292
350
|
readonly SCHEMA_PARSE_ERROR: "SCHEMA_PARSE_ERROR";
|
|
293
351
|
readonly SCHEMA_CIRCULAR_REF: "SCHEMA_CIRCULAR_REF";
|
|
352
|
+
readonly SCHEMA_MAX_DEPTH_EXCEEDED: "SCHEMA_MAX_DEPTH_EXCEEDED";
|
|
294
353
|
readonly CALL_DEPTH_EXCEEDED: "CALL_DEPTH_EXCEEDED";
|
|
295
354
|
readonly CIRCULAR_CALL: "CIRCULAR_CALL";
|
|
296
355
|
readonly CALL_FREQUENCY_EXCEEDED: "CALL_FREQUENCY_EXCEEDED";
|
|
@@ -325,6 +384,10 @@ export declare const ErrorCodes: Readonly<{
|
|
|
325
384
|
readonly CIRCUIT_BREAKER_OPEN: "CIRCUIT_BREAKER_OPEN";
|
|
326
385
|
readonly MODULE_RELOAD_CONFLICT: "MODULE_RELOAD_CONFLICT";
|
|
327
386
|
readonly SYS_MODULE_REGISTRATION_FAILED: "SYS_MODULE_REGISTRATION_FAILED";
|
|
387
|
+
readonly SYS_MODULES_DISABLED: "SYS_MODULES_DISABLED";
|
|
388
|
+
readonly DUPLICATE_MODULE_ID: "DUPLICATE_MODULE_ID";
|
|
389
|
+
readonly STREAMING_INTERFACE_MISMATCH: "STREAMING_INTERFACE_MISMATCH";
|
|
390
|
+
readonly CONTEXT_BINDING_ERROR: "CONTEXT_BINDING_ERROR";
|
|
328
391
|
}>;
|
|
329
392
|
export type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
|
|
330
393
|
//# sourceMappingURL=errors.d.ts.map
|
package/dist/errors.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
|
package/dist/errors.js
CHANGED
|
@@ -31,29 +31,39 @@ export class ModuleError extends Error {
|
|
|
31
31
|
toString() {
|
|
32
32
|
return `[${this.code}] ${this.message}`;
|
|
33
33
|
}
|
|
34
|
+
/**
|
|
35
|
+
* Serialize to the canonical cross-process wire form (A-D-008).
|
|
36
|
+
*
|
|
37
|
+
* Keys are emitted in snake_case — `trace_id`, `ai_guidance`,
|
|
38
|
+
* `user_fixable` — and the `details` object's keys are snake_cased too,
|
|
39
|
+
* so the JSON matches the Python (`errors.py` `to_dict`), Rust (serde),
|
|
40
|
+
* and the spec serialization example. This is the form MCP/A2A bridges
|
|
41
|
+
* put on the wire. Internal TS consumers read the typed properties
|
|
42
|
+
* (`traceId`, `details['callerId']`, ...), not this serialized output.
|
|
43
|
+
*/
|
|
34
44
|
toJSON() {
|
|
35
45
|
const obj = {
|
|
36
46
|
code: this.code,
|
|
37
47
|
message: this.message,
|
|
38
48
|
};
|
|
39
49
|
if (Object.keys(this.details).length > 0) {
|
|
40
|
-
obj.details = this.details;
|
|
50
|
+
obj.details = snakeCaseKeys(this.details);
|
|
41
51
|
}
|
|
42
52
|
if (this.cause !== undefined) {
|
|
43
53
|
obj.cause = this.cause instanceof Error ? this.cause.message : String(this.cause);
|
|
44
54
|
}
|
|
45
55
|
if (this.traceId !== undefined) {
|
|
46
|
-
obj.
|
|
56
|
+
obj.trace_id = this.traceId;
|
|
47
57
|
}
|
|
48
58
|
obj.timestamp = this.timestamp;
|
|
49
59
|
if (this.retryable !== null) {
|
|
50
60
|
obj.retryable = this.retryable;
|
|
51
61
|
}
|
|
52
62
|
if (this.aiGuidance !== null) {
|
|
53
|
-
obj.
|
|
63
|
+
obj.ai_guidance = this.aiGuidance;
|
|
54
64
|
}
|
|
55
65
|
if (this.userFixable !== null) {
|
|
56
|
-
obj.
|
|
66
|
+
obj.user_fixable = this.userFixable;
|
|
57
67
|
}
|
|
58
68
|
if (this.suggestion !== null) {
|
|
59
69
|
obj.suggestion = this.suggestion;
|
|
@@ -61,6 +71,23 @@ export class ModuleError extends Error {
|
|
|
61
71
|
return obj;
|
|
62
72
|
}
|
|
63
73
|
}
|
|
74
|
+
/** Convert a camelCase identifier to snake_case. */
|
|
75
|
+
function camelToSnake(key) {
|
|
76
|
+
return key.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toLowerCase();
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* Return a shallow copy of `details` with top-level keys snake_cased, for
|
|
80
|
+
* cross-process wire output (A-D-008). Values are passed through unchanged —
|
|
81
|
+
* detail values are scalars or arrays of scalars, never nested objects whose
|
|
82
|
+
* keys need conversion.
|
|
83
|
+
*/
|
|
84
|
+
function snakeCaseKeys(details) {
|
|
85
|
+
const out = {};
|
|
86
|
+
for (const [k, v] of Object.entries(details)) {
|
|
87
|
+
out[camelToSnake(k)] = v;
|
|
88
|
+
}
|
|
89
|
+
return out;
|
|
90
|
+
}
|
|
64
91
|
export class ConfigNotFoundError extends ModuleError {
|
|
65
92
|
static DEFAULT_RETRYABLE = false;
|
|
66
93
|
constructor(configPath, options) {
|
|
@@ -128,8 +155,8 @@ export class ModuleTimeoutError extends ModuleError {
|
|
|
128
155
|
}
|
|
129
156
|
export class SchemaValidationError extends ModuleError {
|
|
130
157
|
static DEFAULT_RETRYABLE = false;
|
|
131
|
-
constructor(message = 'Schema validation failed', errors, options) {
|
|
132
|
-
super(
|
|
158
|
+
constructor(message = 'Schema validation failed', errors, options, errorCode = 'SCHEMA_VALIDATION_ERROR') {
|
|
159
|
+
super(errorCode, message, { errors: errors ?? [] }, options?.cause, options?.traceId, options?.retryable, options?.aiGuidance ??
|
|
133
160
|
'Input validation failed. Review the error details to identify which fields have invalid values, then correct them or ask the user for valid input.', options?.userFixable, options?.suggestion);
|
|
134
161
|
this.name = 'SchemaValidationError';
|
|
135
162
|
}
|
|
@@ -155,6 +182,13 @@ export class SchemaCircularRefError extends ModuleError {
|
|
|
155
182
|
this.name = 'SchemaCircularRefError';
|
|
156
183
|
}
|
|
157
184
|
}
|
|
185
|
+
export class SchemaMaxDepthExceededError extends ModuleError {
|
|
186
|
+
static DEFAULT_RETRYABLE = false;
|
|
187
|
+
constructor(refPath, options) {
|
|
188
|
+
super('SCHEMA_MAX_DEPTH_EXCEEDED', `Maximum reference depth exceeded resolving: ${refPath}`, { refPath }, options?.cause, options?.traceId, options?.retryable, options?.aiGuidance, options?.userFixable, options?.suggestion);
|
|
189
|
+
this.name = 'SchemaMaxDepthExceededError';
|
|
190
|
+
}
|
|
191
|
+
}
|
|
158
192
|
export class CallDepthExceededError extends ModuleError {
|
|
159
193
|
static DEFAULT_RETRYABLE = false;
|
|
160
194
|
constructor(depth, maxDepth, callChain, options) {
|
|
@@ -199,7 +233,7 @@ export class CallFrequencyExceededError extends ModuleError {
|
|
|
199
233
|
export class InvalidInputError extends ModuleError {
|
|
200
234
|
static DEFAULT_RETRYABLE = false;
|
|
201
235
|
constructor(message = 'Invalid input', options) {
|
|
202
|
-
super('GENERAL_INVALID_INPUT', message, {}, options?.cause, options?.traceId, options?.retryable, options?.aiGuidance, options?.userFixable, options?.suggestion);
|
|
236
|
+
super('GENERAL_INVALID_INPUT', message, options?.details ?? {}, options?.cause, options?.traceId, options?.retryable, options?.aiGuidance, options?.userFixable, options?.suggestion);
|
|
203
237
|
this.name = 'InvalidInputError';
|
|
204
238
|
}
|
|
205
239
|
}
|
|
@@ -533,6 +567,61 @@ export class SysModuleRegistrationError extends ModuleError {
|
|
|
533
567
|
this.name = 'SysModuleRegistrationError';
|
|
534
568
|
}
|
|
535
569
|
}
|
|
570
|
+
/**
|
|
571
|
+
* Raised when an APCore client method requires sys_modules to be enabled.
|
|
572
|
+
*
|
|
573
|
+
* Cross-language equivalent of Rust's `ModuleError(code=SysModulesDisabled)`
|
|
574
|
+
* and Python's `SysModulesDisabledError`. Replaces bare `Error` in
|
|
575
|
+
* `APCore.on/off/disable/enable` so callers can dispatch on
|
|
576
|
+
* `error.code === 'SYS_MODULES_DISABLED'` instead of catching generic
|
|
577
|
+
* `Error`.
|
|
578
|
+
*/
|
|
579
|
+
export class SysModulesDisabledError extends ModuleError {
|
|
580
|
+
static DEFAULT_RETRYABLE = false;
|
|
581
|
+
constructor(message, options) {
|
|
582
|
+
super('SYS_MODULES_DISABLED', message, undefined, options?.cause, options?.traceId, options?.retryable, options?.aiGuidance, options?.userFixable, options?.suggestion);
|
|
583
|
+
this.name = 'SysModulesDisabledError';
|
|
584
|
+
}
|
|
585
|
+
}
|
|
586
|
+
export class DuplicateModuleIdError extends ModuleError {
|
|
587
|
+
static DEFAULT_RETRYABLE = false;
|
|
588
|
+
constructor(moduleId, options) {
|
|
589
|
+
super('DUPLICATE_MODULE_ID', `Module ID '${moduleId}' is already registered`, { moduleId }, options?.cause, options?.traceId, options?.retryable, options?.aiGuidance, options?.userFixable, options?.suggestion);
|
|
590
|
+
this.name = 'DuplicateModuleIdError';
|
|
591
|
+
}
|
|
592
|
+
}
|
|
593
|
+
export class StreamingInterfaceError extends ModuleError {
|
|
594
|
+
static DEFAULT_RETRYABLE = false;
|
|
595
|
+
moduleId;
|
|
596
|
+
annotationValue;
|
|
597
|
+
hasStreamMethod;
|
|
598
|
+
hasMarker;
|
|
599
|
+
constructor(moduleId, annotationValue, hasStreamMethod, hasMarker, options) {
|
|
600
|
+
super('STREAMING_INTERFACE_MISMATCH', `Module '${moduleId}' declares annotations.streaming=true but does not implement the StreamingModule interface (hasStreamMethod=${hasStreamMethod}, hasMarker=${hasMarker})`, { moduleId, annotationValue, hasStreamMethod, hasMarker }, options?.cause, options?.traceId, options?.retryable, options?.aiGuidance, options?.userFixable, options?.suggestion);
|
|
601
|
+
this.name = 'StreamingInterfaceError';
|
|
602
|
+
this.moduleId = moduleId;
|
|
603
|
+
this.annotationValue = annotationValue;
|
|
604
|
+
this.hasStreamMethod = hasStreamMethod;
|
|
605
|
+
this.hasMarker = hasMarker;
|
|
606
|
+
}
|
|
607
|
+
}
|
|
608
|
+
/**
|
|
609
|
+
* Raised when a Context that is already bound to one Executor (or CancelToken)
|
|
610
|
+
* is offered to a different Executor (or CancelToken). Per apcore Issue #66 /
|
|
611
|
+
* v0.22.0 spec "Contract: Executor binding to Context", binding is a one-shot
|
|
612
|
+
* operation: idempotent for the same instance, error for a different one.
|
|
613
|
+
*/
|
|
614
|
+
export class ContextBindingError extends ModuleError {
|
|
615
|
+
static DEFAULT_RETRYABLE = false;
|
|
616
|
+
constructor(message, options) {
|
|
617
|
+
super('CONTEXT_BINDING_ERROR', message, {}, options?.cause, options?.traceId, options?.retryable, options?.aiGuidance ??
|
|
618
|
+
'A Context was offered to an Executor (or attached to a CancelToken) ' +
|
|
619
|
+
'that does not match the one it is already bound to. Create a fresh ' +
|
|
620
|
+
'Context via Context.create() for the new Executor / CancelToken, or ' +
|
|
621
|
+
'reuse the existing bound Context across calls on the same Executor.', options?.userFixable, options?.suggestion);
|
|
622
|
+
this.name = 'ContextBindingError';
|
|
623
|
+
}
|
|
624
|
+
}
|
|
536
625
|
/**
|
|
537
626
|
* All framework error codes as constants.
|
|
538
627
|
* Use these instead of hardcoding error code strings.
|
|
@@ -560,6 +649,7 @@ export const ErrorCodes = Object.freeze({
|
|
|
560
649
|
SCHEMA_NOT_FOUND: 'SCHEMA_NOT_FOUND',
|
|
561
650
|
SCHEMA_PARSE_ERROR: 'SCHEMA_PARSE_ERROR',
|
|
562
651
|
SCHEMA_CIRCULAR_REF: 'SCHEMA_CIRCULAR_REF',
|
|
652
|
+
SCHEMA_MAX_DEPTH_EXCEEDED: 'SCHEMA_MAX_DEPTH_EXCEEDED',
|
|
563
653
|
CALL_DEPTH_EXCEEDED: 'CALL_DEPTH_EXCEEDED',
|
|
564
654
|
CIRCULAR_CALL: 'CIRCULAR_CALL',
|
|
565
655
|
CALL_FREQUENCY_EXCEEDED: 'CALL_FREQUENCY_EXCEEDED',
|
|
@@ -594,5 +684,9 @@ export const ErrorCodes = Object.freeze({
|
|
|
594
684
|
CIRCUIT_BREAKER_OPEN: 'CIRCUIT_BREAKER_OPEN',
|
|
595
685
|
MODULE_RELOAD_CONFLICT: 'MODULE_RELOAD_CONFLICT',
|
|
596
686
|
SYS_MODULE_REGISTRATION_FAILED: 'SYS_MODULE_REGISTRATION_FAILED',
|
|
687
|
+
SYS_MODULES_DISABLED: 'SYS_MODULES_DISABLED',
|
|
688
|
+
DUPLICATE_MODULE_ID: 'DUPLICATE_MODULE_ID',
|
|
689
|
+
STREAMING_INTERFACE_MISMATCH: 'STREAMING_INTERFACE_MISMATCH',
|
|
690
|
+
CONTEXT_BINDING_ERROR: 'CONTEXT_BINDING_ERROR',
|
|
597
691
|
});
|
|
598
692
|
//# sourceMappingURL=errors.js.map
|