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.
Files changed (175) hide show
  1. package/README.md +33 -3
  2. package/dist/acl-file.d.ts +12 -0
  3. package/dist/acl-file.d.ts.map +1 -0
  4. package/dist/acl-file.js +46 -0
  5. package/dist/acl-file.js.map +1 -0
  6. package/dist/acl-handlers.d.ts.map +1 -1
  7. package/dist/acl-handlers.js +5 -0
  8. package/dist/acl-handlers.js.map +1 -1
  9. package/dist/acl.d.ts.map +1 -1
  10. package/dist/acl.js +20 -37
  11. package/dist/acl.js.map +1 -1
  12. package/dist/async-task.d.ts +49 -14
  13. package/dist/async-task.d.ts.map +1 -1
  14. package/dist/async-task.js +134 -39
  15. package/dist/async-task.js.map +1 -1
  16. package/dist/bindings.d.ts +1 -1
  17. package/dist/bindings.d.ts.map +1 -1
  18. package/dist/bindings.js +10 -26
  19. package/dist/bindings.js.map +1 -1
  20. package/dist/browser/index.d.ts +77 -0
  21. package/dist/browser/index.d.ts.map +1 -0
  22. package/dist/browser/index.js +78 -0
  23. package/dist/browser/index.js.map +1 -0
  24. package/dist/builtin-steps.d.ts +14 -12
  25. package/dist/builtin-steps.d.ts.map +1 -1
  26. package/dist/builtin-steps.js +83 -30
  27. package/dist/builtin-steps.js.map +1 -1
  28. package/dist/cancel.d.ts +23 -2
  29. package/dist/cancel.d.ts.map +1 -1
  30. package/dist/cancel.js +31 -6
  31. package/dist/cancel.js.map +1 -1
  32. package/dist/client.d.ts +4 -1
  33. package/dist/client.d.ts.map +1 -1
  34. package/dist/client.js +19 -7
  35. package/dist/client.js.map +1 -1
  36. package/dist/config-defaults.d.ts +30 -0
  37. package/dist/config-defaults.d.ts.map +1 -0
  38. package/dist/config-defaults.js +83 -0
  39. package/dist/config-defaults.js.map +1 -0
  40. package/dist/config.d.ts +39 -7
  41. package/dist/config.d.ts.map +1 -1
  42. package/dist/config.js +60 -126
  43. package/dist/config.js.map +1 -1
  44. package/dist/context.d.ts +36 -3
  45. package/dist/context.d.ts.map +1 -1
  46. package/dist/context.js +94 -11
  47. package/dist/context.js.map +1 -1
  48. package/dist/errors.d.ts +64 -1
  49. package/dist/errors.d.ts.map +1 -1
  50. package/dist/errors.js +101 -7
  51. package/dist/errors.js.map +1 -1
  52. package/dist/events/emitter.d.ts +46 -12
  53. package/dist/events/emitter.d.ts.map +1 -1
  54. package/dist/events/emitter.js +146 -56
  55. package/dist/events/emitter.js.map +1 -1
  56. package/dist/events/index.d.ts +2 -1
  57. package/dist/events/index.d.ts.map +1 -1
  58. package/dist/events/index.js +1 -1
  59. package/dist/events/index.js.map +1 -1
  60. package/dist/events/retry.d.ts +35 -0
  61. package/dist/events/retry.d.ts.map +1 -0
  62. package/dist/events/retry.js +52 -0
  63. package/dist/events/retry.js.map +1 -0
  64. package/dist/events/subscribers.d.ts +52 -9
  65. package/dist/events/subscribers.d.ts.map +1 -1
  66. package/dist/events/subscribers.js +96 -63
  67. package/dist/events/subscribers.js.map +1 -1
  68. package/dist/executor.d.ts +4 -1
  69. package/dist/executor.d.ts.map +1 -1
  70. package/dist/executor.js +143 -16
  71. package/dist/executor.js.map +1 -1
  72. package/dist/generated/version.d.ts +1 -1
  73. package/dist/generated/version.js +1 -1
  74. package/dist/index.d.ts +15 -5
  75. package/dist/index.d.ts.map +1 -1
  76. package/dist/index.js +17 -4
  77. package/dist/index.js.map +1 -1
  78. package/dist/middleware/circuit-breaker.d.ts +2 -2
  79. package/dist/middleware/circuit-breaker.d.ts.map +1 -1
  80. package/dist/middleware/circuit-breaker.js +19 -19
  81. package/dist/middleware/circuit-breaker.js.map +1 -1
  82. package/dist/middleware/index.d.ts +1 -1
  83. package/dist/middleware/index.d.ts.map +1 -1
  84. package/dist/middleware/index.js +1 -1
  85. package/dist/middleware/index.js.map +1 -1
  86. package/dist/middleware/manager.d.ts +6 -2
  87. package/dist/middleware/manager.d.ts.map +1 -1
  88. package/dist/middleware/manager.js +36 -1
  89. package/dist/middleware/manager.js.map +1 -1
  90. package/dist/middleware/platform-notify.d.ts +2 -3
  91. package/dist/middleware/platform-notify.d.ts.map +1 -1
  92. package/dist/middleware/platform-notify.js +5 -6
  93. package/dist/middleware/platform-notify.js.map +1 -1
  94. package/dist/middleware/tracing-otel-default.d.ts +16 -0
  95. package/dist/middleware/tracing-otel-default.d.ts.map +1 -0
  96. package/dist/middleware/tracing-otel-default.js +25 -0
  97. package/dist/middleware/tracing-otel-default.js.map +1 -0
  98. package/dist/middleware/tracing.d.ts.map +1 -1
  99. package/dist/middleware/tracing.js +9 -10
  100. package/dist/middleware/tracing.js.map +1 -1
  101. package/dist/pipeline.d.ts +1 -1
  102. package/dist/pipeline.js +11 -11
  103. package/dist/pipeline.js.map +1 -1
  104. package/dist/registry/metadata-pure.d.ts +13 -0
  105. package/dist/registry/metadata-pure.d.ts.map +1 -0
  106. package/dist/registry/metadata-pure.js +67 -0
  107. package/dist/registry/metadata-pure.js.map +1 -0
  108. package/dist/registry/metadata.d.ts +8 -4
  109. package/dist/registry/metadata.d.ts.map +1 -1
  110. package/dist/registry/metadata.js +9 -70
  111. package/dist/registry/metadata.js.map +1 -1
  112. package/dist/registry/multi-class.d.ts +0 -31
  113. package/dist/registry/multi-class.d.ts.map +1 -1
  114. package/dist/registry/registry.d.ts +46 -10
  115. package/dist/registry/registry.d.ts.map +1 -1
  116. package/dist/registry/registry.js +273 -33
  117. package/dist/registry/registry.js.map +1 -1
  118. package/dist/registry/scanner.d.ts.map +1 -1
  119. package/dist/registry/scanner.js +3 -15
  120. package/dist/registry/scanner.js.map +1 -1
  121. package/dist/schema/loader-pure.d.ts +24 -0
  122. package/dist/schema/loader-pure.d.ts.map +1 -0
  123. package/dist/schema/loader-pure.js +153 -0
  124. package/dist/schema/loader-pure.js.map +1 -0
  125. package/dist/schema/loader.d.ts +14 -30
  126. package/dist/schema/loader.d.ts.map +1 -1
  127. package/dist/schema/loader.js +20 -201
  128. package/dist/schema/loader.js.map +1 -1
  129. package/dist/schema/ref-resolver.d.ts.map +1 -1
  130. package/dist/schema/ref-resolver.js +7 -21
  131. package/dist/schema/ref-resolver.js.map +1 -1
  132. package/dist/schema/types.d.ts.map +1 -1
  133. package/dist/schema/types.js +1 -1
  134. package/dist/schema/types.js.map +1 -1
  135. package/dist/schema/validator.d.ts.map +1 -1
  136. package/dist/schema/validator.js +11 -20
  137. package/dist/schema/validator.js.map +1 -1
  138. package/dist/streaming.d.ts +21 -0
  139. package/dist/streaming.d.ts.map +1 -0
  140. package/dist/streaming.js +32 -0
  141. package/dist/streaming.js.map +1 -0
  142. package/dist/sys-modules/control.d.ts +0 -78
  143. package/dist/sys-modules/control.d.ts.map +1 -1
  144. package/dist/sys-modules/health.d.ts +0 -138
  145. package/dist/sys-modules/health.d.ts.map +1 -1
  146. package/dist/sys-modules/install.d.ts +12 -0
  147. package/dist/sys-modules/install.d.ts.map +1 -0
  148. package/dist/sys-modules/install.js +14 -0
  149. package/dist/sys-modules/install.js.map +1 -0
  150. package/dist/sys-modules/manifest.d.ts +1 -141
  151. package/dist/sys-modules/manifest.d.ts.map +1 -1
  152. package/dist/sys-modules/overrides-file.d.ts +14 -0
  153. package/dist/sys-modules/overrides-file.d.ts.map +1 -0
  154. package/dist/sys-modules/overrides-file.js +31 -0
  155. package/dist/sys-modules/overrides-file.js.map +1 -0
  156. package/dist/sys-modules/registration.d.ts.map +1 -1
  157. package/dist/sys-modules/registration.js +40 -20
  158. package/dist/sys-modules/registration.js.map +1 -1
  159. package/dist/sys-modules/toggle.d.ts +0 -70
  160. package/dist/sys-modules/toggle.d.ts.map +1 -1
  161. package/dist/sys-modules/usage.d.ts +1 -132
  162. package/dist/sys-modules/usage.d.ts.map +1 -1
  163. package/dist/utils/index.d.ts +2 -3
  164. package/dist/utils/index.d.ts.map +1 -1
  165. package/dist/utils/index.js +3 -11
  166. package/dist/utils/index.js.map +1 -1
  167. package/package.json +22 -7
  168. package/dist/registry/index.d.ts +0 -15
  169. package/dist/registry/index.d.ts.map +0 -1
  170. package/dist/registry/index.js +0 -11
  171. package/dist/registry/index.js.map +0 -1
  172. package/dist/schema/index.d.ts +0 -11
  173. package/dist/schema/index.d.ts.map +0 -1
  174. package/dist/schema/index.js +0 -9
  175. 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 interface Identity {
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
- 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);
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>(executor?: unknown, identity?: Identity | null, data?: Record<string, unknown>, traceParent?: TraceParent | null, services?: S, globalDeadline?: number | null): Context<S>;
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
@@ -1 +1 @@
1
- {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}
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 Object.freeze({
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
- constructor(traceId, callerId = null, callChain = [], executor = null, identity = null, redactedInputs = null, data = {}, cancelToken = null, services = null, globalDeadline = null) {
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 = null;
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(executor = null, identity = null, data, traceParent, services, globalDeadline) {
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, [], executor, identity, null, ctxData, null, services ?? null, globalDeadline ?? 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
@@ -1 +1 @@
1
- {"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}
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
@@ -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.traceId = this.traceId;
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.aiGuidance = this.aiGuidance;
63
+ obj.ai_guidance = this.aiGuidance;
54
64
  }
55
65
  if (this.userFixable !== null) {
56
- obj.userFixable = this.userFixable;
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('SCHEMA_VALIDATION_ERROR', message, { errors: errors ?? [] }, options?.cause, options?.traceId, options?.retryable, options?.aiGuidance ??
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