apcore-js 0.4.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (306) hide show
  1. package/dist/acl.d.ts +27 -0
  2. package/dist/acl.d.ts.map +1 -0
  3. package/dist/acl.js +175 -0
  4. package/dist/acl.js.map +1 -0
  5. package/dist/async-task.d.ts +90 -0
  6. package/dist/async-task.d.ts.map +1 -0
  7. package/dist/async-task.js +215 -0
  8. package/dist/async-task.js.map +1 -0
  9. package/dist/bindings.d.ts +12 -0
  10. package/dist/bindings.d.ts.map +1 -0
  11. package/dist/bindings.js +185 -0
  12. package/dist/bindings.js.map +1 -0
  13. package/dist/cancel.d.ts +14 -0
  14. package/dist/cancel.d.ts.map +1 -0
  15. package/dist/cancel.js +27 -0
  16. package/dist/cancel.js.map +1 -0
  17. package/dist/config.d.ts +9 -0
  18. package/dist/config.d.ts.map +1 -0
  19. package/dist/config.js +23 -0
  20. package/dist/config.js.map +1 -0
  21. package/dist/context.d.ts +50 -0
  22. package/dist/context.d.ts.map +1 -0
  23. package/dist/context.js +87 -0
  24. package/dist/context.js.map +1 -0
  25. package/dist/decorator.d.ts +57 -0
  26. package/dist/decorator.d.ts.map +1 -0
  27. package/dist/decorator.js +74 -0
  28. package/dist/decorator.js.map +1 -0
  29. package/dist/errors.d.ts +215 -0
  30. package/dist/errors.d.ts.map +1 -0
  31. package/dist/errors.js +246 -0
  32. package/dist/errors.js.map +1 -0
  33. package/dist/executor.d.ts +67 -0
  34. package/dist/executor.d.ts.map +1 -0
  35. package/dist/executor.js +372 -0
  36. package/dist/executor.js.map +1 -0
  37. package/dist/extensions.d.ts +58 -0
  38. package/dist/extensions.d.ts.map +1 -0
  39. package/dist/extensions.js +220 -0
  40. package/dist/extensions.js.map +1 -0
  41. package/{src/index.ts → dist/index.d.ts} +14 -59
  42. package/dist/index.d.ts.map +1 -0
  43. package/dist/index.js +43 -0
  44. package/dist/index.js.map +1 -0
  45. package/dist/middleware/adapters.d.ts +18 -0
  46. package/dist/middleware/adapters.d.ts.map +1 -0
  47. package/dist/middleware/adapters.js +25 -0
  48. package/dist/middleware/adapters.js.map +1 -0
  49. package/dist/middleware/base.d.ts +10 -0
  50. package/dist/middleware/base.d.ts.map +1 -0
  51. package/dist/middleware/base.js +15 -0
  52. package/dist/middleware/base.js.map +1 -0
  53. package/{src/middleware/index.ts → dist/middleware/index.d.ts} +1 -0
  54. package/dist/middleware/index.d.ts.map +1 -0
  55. package/dist/middleware/index.js +5 -0
  56. package/dist/middleware/index.js.map +1 -0
  57. package/dist/middleware/logging.d.ts +25 -0
  58. package/dist/middleware/logging.d.ts.map +1 -0
  59. package/dist/middleware/logging.js +64 -0
  60. package/dist/middleware/logging.js.map +1 -0
  61. package/dist/middleware/manager.d.ts +21 -0
  62. package/dist/middleware/manager.d.ts.map +1 -0
  63. package/dist/middleware/manager.js +77 -0
  64. package/dist/middleware/manager.js.map +1 -0
  65. package/dist/module.d.ts +31 -0
  66. package/dist/module.d.ts.map +1 -0
  67. package/dist/module.js +12 -0
  68. package/dist/module.js.map +1 -0
  69. package/dist/observability/context-logger.d.ts +54 -0
  70. package/dist/observability/context-logger.d.ts.map +1 -0
  71. package/dist/observability/context-logger.js +151 -0
  72. package/dist/observability/context-logger.js.map +1 -0
  73. package/{src/observability/index.ts → dist/observability/index.d.ts} +1 -0
  74. package/dist/observability/index.d.ts.map +1 -0
  75. package/dist/observability/index.js +4 -0
  76. package/dist/observability/index.js.map +1 -0
  77. package/dist/observability/metrics.d.ts +30 -0
  78. package/dist/observability/metrics.d.ts.map +1 -0
  79. package/dist/observability/metrics.js +177 -0
  80. package/dist/observability/metrics.js.map +1 -0
  81. package/dist/observability/tracing.d.ts +62 -0
  82. package/dist/observability/tracing.d.ts.map +1 -0
  83. package/dist/observability/tracing.js +184 -0
  84. package/dist/observability/tracing.js.map +1 -0
  85. package/dist/registry/dependencies.d.ts +6 -0
  86. package/dist/registry/dependencies.d.ts.map +1 -0
  87. package/dist/registry/dependencies.js +83 -0
  88. package/dist/registry/dependencies.js.map +1 -0
  89. package/dist/registry/entry-point.d.ts +6 -0
  90. package/dist/registry/entry-point.d.ts.map +1 -0
  91. package/dist/registry/entry-point.js +55 -0
  92. package/dist/registry/entry-point.js.map +1 -0
  93. package/{src/registry/index.ts → dist/registry/index.d.ts} +2 -0
  94. package/dist/registry/index.d.ts.map +1 -0
  95. package/dist/registry/index.js +8 -0
  96. package/dist/registry/index.js.map +1 -0
  97. package/dist/registry/metadata.d.ts +9 -0
  98. package/dist/registry/metadata.d.ts.map +1 -0
  99. package/dist/registry/metadata.js +105 -0
  100. package/dist/registry/metadata.js.map +1 -0
  101. package/dist/registry/registry.d.ts +102 -0
  102. package/dist/registry/registry.d.ts.map +1 -0
  103. package/dist/registry/registry.js +534 -0
  104. package/dist/registry/registry.js.map +1 -0
  105. package/dist/registry/scanner.d.ts +7 -0
  106. package/dist/registry/scanner.d.ts.map +1 -0
  107. package/dist/registry/scanner.js +164 -0
  108. package/dist/registry/scanner.js.map +1 -0
  109. package/dist/registry/schema-export.d.ts +9 -0
  110. package/dist/registry/schema-export.d.ts.map +1 -0
  111. package/dist/registry/schema-export.js +132 -0
  112. package/dist/registry/schema-export.js.map +1 -0
  113. package/dist/registry/types.d.ts +29 -0
  114. package/dist/registry/types.d.ts.map +1 -0
  115. package/dist/registry/types.js +5 -0
  116. package/dist/registry/types.js.map +1 -0
  117. package/dist/registry/validation.d.ts +9 -0
  118. package/dist/registry/validation.d.ts.map +1 -0
  119. package/dist/registry/validation.js +33 -0
  120. package/dist/registry/validation.js.map +1 -0
  121. package/dist/schema/annotations.d.ts +8 -0
  122. package/dist/schema/annotations.d.ts.map +1 -0
  123. package/dist/schema/annotations.js +52 -0
  124. package/dist/schema/annotations.js.map +1 -0
  125. package/dist/schema/exporter.d.ts +13 -0
  126. package/dist/schema/exporter.d.ts.map +1 -0
  127. package/dist/schema/exporter.js +71 -0
  128. package/dist/schema/exporter.js.map +1 -0
  129. package/dist/schema/index.d.ts +9 -0
  130. package/dist/schema/index.d.ts.map +1 -0
  131. package/{src/schema/index.ts → dist/schema/index.js} +1 -7
  132. package/dist/schema/index.js.map +1 -0
  133. package/dist/schema/loader.d.ts +30 -0
  134. package/dist/schema/loader.d.ts.map +1 -0
  135. package/dist/schema/loader.js +260 -0
  136. package/dist/schema/loader.js.map +1 -0
  137. package/dist/schema/ref-resolver.d.ts +19 -0
  138. package/dist/schema/ref-resolver.d.ts.map +1 -0
  139. package/dist/schema/ref-resolver.js +212 -0
  140. package/dist/schema/ref-resolver.js.map +1 -0
  141. package/dist/schema/strict.d.ts +7 -0
  142. package/dist/schema/strict.d.ts.map +1 -0
  143. package/dist/schema/strict.js +127 -0
  144. package/dist/schema/strict.js.map +1 -0
  145. package/dist/schema/types.d.ts +53 -0
  146. package/dist/schema/types.d.ts.map +1 -0
  147. package/dist/schema/types.js +31 -0
  148. package/dist/schema/types.js.map +1 -0
  149. package/dist/schema/validator.d.ts +16 -0
  150. package/dist/schema/validator.d.ts.map +1 -0
  151. package/dist/schema/validator.js +71 -0
  152. package/dist/schema/validator.js.map +1 -0
  153. package/dist/trace-context.d.ts +35 -0
  154. package/dist/trace-context.d.ts.map +1 -0
  155. package/dist/trace-context.js +86 -0
  156. package/dist/trace-context.js.map +1 -0
  157. package/dist/utils/index.d.ts +11 -0
  158. package/dist/utils/index.d.ts.map +1 -0
  159. package/dist/utils/index.js +32 -0
  160. package/dist/utils/index.js.map +1 -0
  161. package/dist/utils/pattern.d.ts +5 -0
  162. package/dist/utils/pattern.d.ts.map +1 -0
  163. package/dist/utils/pattern.js +31 -0
  164. package/dist/utils/pattern.js.map +1 -0
  165. package/package.json +8 -2
  166. package/.claude/settings.local.json +0 -12
  167. package/.github/workflows/ci.yml +0 -39
  168. package/.gitmessage +0 -60
  169. package/.pre-commit-config.yaml +0 -28
  170. package/CHANGELOG.md +0 -183
  171. package/CLAUDE.md +0 -68
  172. package/apcore-logo.svg +0 -79
  173. package/planning/acl-system/overview.md +0 -54
  174. package/planning/acl-system/plan.md +0 -92
  175. package/planning/acl-system/state.json +0 -76
  176. package/planning/acl-system/tasks/acl-core.md +0 -226
  177. package/planning/acl-system/tasks/acl-rule.md +0 -92
  178. package/planning/acl-system/tasks/conditional-rules.md +0 -259
  179. package/planning/acl-system/tasks/pattern-matching.md +0 -152
  180. package/planning/acl-system/tasks/yaml-loading.md +0 -271
  181. package/planning/core-executor/overview.md +0 -53
  182. package/planning/core-executor/plan.md +0 -88
  183. package/planning/core-executor/state.json +0 -76
  184. package/planning/core-executor/tasks/async-support.md +0 -106
  185. package/planning/core-executor/tasks/execution-pipeline.md +0 -113
  186. package/planning/core-executor/tasks/redaction.md +0 -85
  187. package/planning/core-executor/tasks/safety-checks.md +0 -65
  188. package/planning/core-executor/tasks/setup.md +0 -75
  189. package/planning/decorator-bindings/overview.md +0 -62
  190. package/planning/decorator-bindings/plan.md +0 -104
  191. package/planning/decorator-bindings/state.json +0 -87
  192. package/planning/decorator-bindings/tasks/binding-directory.md +0 -79
  193. package/planning/decorator-bindings/tasks/binding-loader.md +0 -148
  194. package/planning/decorator-bindings/tasks/explicit-schemas.md +0 -85
  195. package/planning/decorator-bindings/tasks/function-module.md +0 -127
  196. package/planning/decorator-bindings/tasks/module-factory.md +0 -89
  197. package/planning/decorator-bindings/tasks/schema-modes.md +0 -142
  198. package/planning/middleware-system/overview.md +0 -48
  199. package/planning/middleware-system/plan.md +0 -102
  200. package/planning/middleware-system/state.json +0 -65
  201. package/planning/middleware-system/tasks/adapters.md +0 -170
  202. package/planning/middleware-system/tasks/base.md +0 -115
  203. package/planning/middleware-system/tasks/logging-middleware.md +0 -304
  204. package/planning/middleware-system/tasks/manager.md +0 -313
  205. package/planning/observability/overview.md +0 -53
  206. package/planning/observability/plan.md +0 -119
  207. package/planning/observability/state.json +0 -98
  208. package/planning/observability/tasks/context-logger.md +0 -201
  209. package/planning/observability/tasks/exporters.md +0 -121
  210. package/planning/observability/tasks/metrics-collector.md +0 -162
  211. package/planning/observability/tasks/metrics-middleware.md +0 -141
  212. package/planning/observability/tasks/obs-logging-middleware.md +0 -179
  213. package/planning/observability/tasks/span-model.md +0 -120
  214. package/planning/observability/tasks/tracing-middleware.md +0 -179
  215. package/planning/overview.md +0 -81
  216. package/planning/registry-system/overview.md +0 -57
  217. package/planning/registry-system/plan.md +0 -114
  218. package/planning/registry-system/state.json +0 -109
  219. package/planning/registry-system/tasks/dependencies.md +0 -157
  220. package/planning/registry-system/tasks/entry-point.md +0 -148
  221. package/planning/registry-system/tasks/metadata.md +0 -198
  222. package/planning/registry-system/tasks/registry-core.md +0 -323
  223. package/planning/registry-system/tasks/scanner.md +0 -172
  224. package/planning/registry-system/tasks/schema-export.md +0 -261
  225. package/planning/registry-system/tasks/types.md +0 -124
  226. package/planning/registry-system/tasks/validation.md +0 -177
  227. package/planning/schema-system/overview.md +0 -56
  228. package/planning/schema-system/plan.md +0 -121
  229. package/planning/schema-system/state.json +0 -98
  230. package/planning/schema-system/tasks/exporter.md +0 -153
  231. package/planning/schema-system/tasks/loader.md +0 -106
  232. package/planning/schema-system/tasks/ref-resolver.md +0 -133
  233. package/planning/schema-system/tasks/strict-mode.md +0 -140
  234. package/planning/schema-system/tasks/typebox-generation.md +0 -133
  235. package/planning/schema-system/tasks/types-and-annotations.md +0 -160
  236. package/planning/schema-system/tasks/validator.md +0 -149
  237. package/src/acl.ts +0 -200
  238. package/src/bindings.ts +0 -207
  239. package/src/config.ts +0 -24
  240. package/src/context.ts +0 -78
  241. package/src/decorator.ts +0 -110
  242. package/src/errors.ts +0 -425
  243. package/src/executor.ts +0 -475
  244. package/src/middleware/adapters.ts +0 -54
  245. package/src/middleware/base.ts +0 -33
  246. package/src/middleware/logging.ts +0 -103
  247. package/src/middleware/manager.ts +0 -105
  248. package/src/module.ts +0 -43
  249. package/src/observability/context-logger.ts +0 -203
  250. package/src/observability/metrics.ts +0 -214
  251. package/src/observability/tracing.ts +0 -188
  252. package/src/registry/dependencies.ts +0 -99
  253. package/src/registry/entry-point.ts +0 -64
  254. package/src/registry/metadata.ts +0 -111
  255. package/src/registry/registry.ts +0 -360
  256. package/src/registry/scanner.ts +0 -168
  257. package/src/registry/schema-export.ts +0 -181
  258. package/src/registry/types.ts +0 -32
  259. package/src/registry/validation.ts +0 -38
  260. package/src/schema/annotations.ts +0 -68
  261. package/src/schema/exporter.ts +0 -90
  262. package/src/schema/loader.ts +0 -273
  263. package/src/schema/ref-resolver.ts +0 -244
  264. package/src/schema/strict.ts +0 -136
  265. package/src/schema/types.ts +0 -73
  266. package/src/schema/validator.ts +0 -82
  267. package/src/utils/index.ts +0 -5
  268. package/src/utils/pattern.ts +0 -30
  269. package/tests/helpers.ts +0 -30
  270. package/tests/integration/test-acl-safety.test.ts +0 -269
  271. package/tests/integration/test-binding-executor.test.ts +0 -194
  272. package/tests/integration/test-e2e-flow.test.ts +0 -117
  273. package/tests/integration/test-error-propagation.test.ts +0 -259
  274. package/tests/integration/test-middleware-chain.test.ts +0 -120
  275. package/tests/integration/test-observability-integration.test.ts +0 -438
  276. package/tests/observability/test-context-logger.test.ts +0 -123
  277. package/tests/observability/test-metrics.test.ts +0 -186
  278. package/tests/observability/test-tracing.test.ts +0 -131
  279. package/tests/registry/test-dependencies.test.ts +0 -70
  280. package/tests/registry/test-entry-point.test.ts +0 -133
  281. package/tests/registry/test-metadata.test.ts +0 -265
  282. package/tests/registry/test-registry.test.ts +0 -1008
  283. package/tests/registry/test-scanner.test.ts +0 -257
  284. package/tests/registry/test-schema-export.test.ts +0 -355
  285. package/tests/registry/test-validation.test.ts +0 -75
  286. package/tests/schema/test-annotations.test.ts +0 -137
  287. package/tests/schema/test-exporter.test.ts +0 -172
  288. package/tests/schema/test-loader.test.ts +0 -461
  289. package/tests/schema/test-ref-resolver.test.ts +0 -530
  290. package/tests/schema/test-strict.test.ts +0 -348
  291. package/tests/schema/test-validator.test.ts +0 -64
  292. package/tests/test-acl.test.ts +0 -423
  293. package/tests/test-bindings.test.ts +0 -227
  294. package/tests/test-config.test.ts +0 -76
  295. package/tests/test-context.test.ts +0 -151
  296. package/tests/test-decorator.test.ts +0 -173
  297. package/tests/test-errors.test.ts +0 -647
  298. package/tests/test-executor-stream.test.ts +0 -208
  299. package/tests/test-executor.test.ts +0 -252
  300. package/tests/test-logging-middleware.test.ts +0 -150
  301. package/tests/test-middleware-manager.test.ts +0 -185
  302. package/tests/test-middleware.test.ts +0 -86
  303. package/tests/utils/test-pattern.test.ts +0 -109
  304. package/tsconfig.build.json +0 -8
  305. package/tsconfig.json +0 -20
  306. package/vitest.config.ts +0 -18
@@ -1,647 +0,0 @@
1
- import { describe, it, expect } from 'vitest';
2
- import {
3
- ModuleError,
4
- ModuleNotFoundError,
5
- ModuleTimeoutError,
6
- ModuleExecuteError,
7
- ModuleLoadError,
8
- SchemaValidationError,
9
- SchemaNotFoundError,
10
- SchemaParseError,
11
- SchemaCircularRefError,
12
- ACLDeniedError,
13
- ACLRuleError,
14
- CallDepthExceededError,
15
- CircularCallError,
16
- CallFrequencyExceededError,
17
- ConfigNotFoundError,
18
- ConfigError,
19
- InvalidInputError,
20
- InternalError,
21
- FuncMissingTypeHintError,
22
- FuncMissingReturnTypeError,
23
- BindingInvalidTargetError,
24
- BindingModuleNotFoundError,
25
- BindingCallableNotFoundError,
26
- BindingNotCallableError,
27
- BindingSchemaMissingError,
28
- BindingFileInvalidError,
29
- CircularDependencyError,
30
- ErrorCodes,
31
- } from '../src/errors.js';
32
-
33
- describe('ModuleError', () => {
34
- it('creates with code and message', () => {
35
- const err = new ModuleError('TEST_CODE', 'test message');
36
- expect(err.code).toBe('TEST_CODE');
37
- expect(err.message).toBe('test message');
38
- expect(err.name).toBe('ModuleError');
39
- expect(err.details).toEqual({});
40
- expect(err.timestamp).toBeDefined();
41
- });
42
-
43
- it('toString includes code and message', () => {
44
- const err = new ModuleError('ERR', 'something failed');
45
- expect(err.toString()).toBe('[ERR] something failed');
46
- });
47
-
48
- it('accepts details, cause, and traceId', () => {
49
- const cause = new Error('root cause');
50
- const err = new ModuleError('X', 'msg', { key: 'val' }, cause, 'trace-123');
51
- expect(err.details).toEqual({ key: 'val' });
52
- expect(err.cause).toBe(cause);
53
- expect(err.traceId).toBe('trace-123');
54
- });
55
-
56
- it('is an instance of Error', () => {
57
- const err = new ModuleError('X', 'msg');
58
- expect(err).toBeInstanceOf(Error);
59
- expect(err).toBeInstanceOf(ModuleError);
60
- });
61
- });
62
-
63
- describe('Error subclasses', () => {
64
- it('ModuleNotFoundError', () => {
65
- const err = new ModuleNotFoundError('mod.x');
66
- expect(err.name).toBe('ModuleNotFoundError');
67
- expect(err.code).toBe('MODULE_NOT_FOUND');
68
- expect(err.message).toContain('mod.x');
69
- expect(err.details['moduleId']).toBe('mod.x');
70
- });
71
-
72
- it('ModuleTimeoutError', () => {
73
- const err = new ModuleTimeoutError('mod.x', 5000);
74
- expect(err.name).toBe('ModuleTimeoutError');
75
- expect(err.code).toBe('MODULE_TIMEOUT');
76
- expect(err.moduleId).toBe('mod.x');
77
- expect(err.timeoutMs).toBe(5000);
78
- });
79
-
80
- it('SchemaValidationError', () => {
81
- const err = new SchemaValidationError('bad data', [{ path: '/x' }]);
82
- expect(err.name).toBe('SchemaValidationError');
83
- expect(err.code).toBe('SCHEMA_VALIDATION_ERROR');
84
- expect(err.details['errors']).toHaveLength(1);
85
- });
86
-
87
- it('ACLDeniedError', () => {
88
- const err = new ACLDeniedError('caller.a', 'target.b');
89
- expect(err.name).toBe('ACLDeniedError');
90
- expect(err.code).toBe('ACL_DENIED');
91
- expect(err.callerId).toBe('caller.a');
92
- expect(err.targetId).toBe('target.b');
93
- });
94
-
95
- it('CallDepthExceededError', () => {
96
- const err = new CallDepthExceededError(33, 32, ['a', 'b']);
97
- expect(err.name).toBe('CallDepthExceededError');
98
- expect(err.code).toBe('CALL_DEPTH_EXCEEDED');
99
- expect(err.currentDepth).toBe(33);
100
- expect(err.maxDepth).toBe(32);
101
- });
102
-
103
- it('CircularCallError', () => {
104
- const err = new CircularCallError('mod.a', ['mod.a', 'mod.b', 'mod.a']);
105
- expect(err.name).toBe('CircularCallError');
106
- expect(err.code).toBe('CIRCULAR_CALL');
107
- expect(err.moduleId).toBe('mod.a');
108
- });
109
-
110
- it('CallFrequencyExceededError', () => {
111
- const err = new CallFrequencyExceededError('mod.a', 4, 3, ['mod.a', 'mod.a', 'mod.a', 'mod.a']);
112
- expect(err.name).toBe('CallFrequencyExceededError');
113
- expect(err.code).toBe('CALL_FREQUENCY_EXCEEDED');
114
- expect(err.moduleId).toBe('mod.a');
115
- expect(err.count).toBe(4);
116
- expect(err.maxRepeat).toBe(3);
117
- });
118
-
119
- it('ConfigNotFoundError', () => {
120
- const err = new ConfigNotFoundError('/path/to/config');
121
- expect(err.name).toBe('ConfigNotFoundError');
122
- expect(err.code).toBe('CONFIG_NOT_FOUND');
123
- });
124
-
125
- it('ConfigError', () => {
126
- const err = new ConfigError('bad config');
127
- expect(err.name).toBe('ConfigError');
128
- expect(err.code).toBe('CONFIG_INVALID');
129
- });
130
-
131
- it('InvalidInputError', () => {
132
- const err = new InvalidInputError('bad input');
133
- expect(err.name).toBe('InvalidInputError');
134
- expect(err.code).toBe('GENERAL_INVALID_INPUT');
135
- });
136
-
137
- it('BindingInvalidTargetError', () => {
138
- const err = new BindingInvalidTargetError('bad:target:format');
139
- expect(err.name).toBe('BindingInvalidTargetError');
140
- expect(err.code).toBe('BINDING_INVALID_TARGET');
141
- });
142
-
143
- it('BindingModuleNotFoundError', () => {
144
- const err = new BindingModuleNotFoundError('some.module');
145
- expect(err.name).toBe('BindingModuleNotFoundError');
146
- expect(err.code).toBe('BINDING_MODULE_NOT_FOUND');
147
- });
148
-
149
- it('BindingCallableNotFoundError', () => {
150
- const err = new BindingCallableNotFoundError('fn', 'some.module');
151
- expect(err.name).toBe('BindingCallableNotFoundError');
152
- expect(err.code).toBe('BINDING_CALLABLE_NOT_FOUND');
153
- });
154
-
155
- it('BindingNotCallableError', () => {
156
- const err = new BindingNotCallableError('some:target');
157
- expect(err.name).toBe('BindingNotCallableError');
158
- expect(err.code).toBe('BINDING_NOT_CALLABLE');
159
- });
160
-
161
- it('BindingSchemaMissingError', () => {
162
- const err = new BindingSchemaMissingError('some:target');
163
- expect(err.name).toBe('BindingSchemaMissingError');
164
- expect(err.code).toBe('BINDING_SCHEMA_MISSING');
165
- });
166
-
167
- it('BindingFileInvalidError', () => {
168
- const err = new BindingFileInvalidError('/path/file.yaml', 'parse error');
169
- expect(err.name).toBe('BindingFileInvalidError');
170
- expect(err.code).toBe('BINDING_FILE_INVALID');
171
- });
172
-
173
- it('CircularDependencyError', () => {
174
- const err = new CircularDependencyError(['a', 'b', 'a']);
175
- expect(err.name).toBe('CircularDependencyError');
176
- expect(err.code).toBe('CIRCULAR_DEPENDENCY');
177
- expect(err.message).toContain('a -> b -> a');
178
- });
179
-
180
- it('ModuleLoadError', () => {
181
- const err = new ModuleLoadError('mod.a', 'file not found');
182
- expect(err.name).toBe('ModuleLoadError');
183
- expect(err.code).toBe('MODULE_LOAD_ERROR');
184
- });
185
-
186
- it('SchemaNotFoundError', () => {
187
- const err = new SchemaNotFoundError('schema.x');
188
- expect(err.name).toBe('SchemaNotFoundError');
189
- expect(err.code).toBe('SCHEMA_NOT_FOUND');
190
- });
191
-
192
- it('SchemaParseError', () => {
193
- const err = new SchemaParseError('invalid yaml');
194
- expect(err.name).toBe('SchemaParseError');
195
- expect(err.code).toBe('SCHEMA_PARSE_ERROR');
196
- });
197
-
198
- it('SchemaCircularRefError', () => {
199
- const err = new SchemaCircularRefError('#/definitions/A');
200
- expect(err.name).toBe('SchemaCircularRefError');
201
- expect(err.code).toBe('SCHEMA_CIRCULAR_REF');
202
- });
203
-
204
- it('ACLRuleError', () => {
205
- const err = new ACLRuleError('bad rule');
206
- expect(err.name).toBe('ACLRuleError');
207
- expect(err.code).toBe('ACL_RULE_ERROR');
208
- });
209
- });
210
-
211
- describe('ModuleError optional parameters', () => {
212
- it('defaults details to empty object when not provided', () => {
213
- const err = new ModuleError('X', 'msg');
214
- expect(err.details).toEqual({});
215
- });
216
-
217
- it('leaves cause and traceId undefined when not provided', () => {
218
- const err = new ModuleError('X', 'msg');
219
- expect(err.cause).toBeUndefined();
220
- expect(err.traceId).toBeUndefined();
221
- });
222
-
223
- it('passes cause to Error super constructor', () => {
224
- const cause = new Error('root');
225
- const err = new ModuleError('X', 'msg', {}, cause);
226
- expect(err.cause).toBe(cause);
227
- });
228
-
229
- it('sets traceId when provided', () => {
230
- const err = new ModuleError('X', 'msg', {}, undefined, 'trace-abc');
231
- expect(err.traceId).toBe('trace-abc');
232
- expect(err.cause).toBeUndefined();
233
- });
234
-
235
- it('toString returns formatted code and message', () => {
236
- const err = new ModuleError('MY_CODE', 'my message');
237
- expect(err.toString()).toBe('[MY_CODE] my message');
238
- });
239
- });
240
-
241
- describe('Error subclasses with options (cause and traceId branches)', () => {
242
- const cause = new Error('underlying cause');
243
- const traceId = 'trace-999';
244
-
245
- it('ConfigNotFoundError with cause and traceId', () => {
246
- const err = new ConfigNotFoundError('/cfg', { cause, traceId });
247
- expect(err.cause).toBe(cause);
248
- expect(err.traceId).toBe(traceId);
249
- expect(err.details['configPath']).toBe('/cfg');
250
- });
251
-
252
- it('ConfigNotFoundError without options', () => {
253
- const err = new ConfigNotFoundError('/cfg');
254
- expect(err.cause).toBeUndefined();
255
- expect(err.traceId).toBeUndefined();
256
- });
257
-
258
- it('ConfigError with cause and traceId', () => {
259
- const err = new ConfigError('bad config', { cause, traceId });
260
- expect(err.cause).toBe(cause);
261
- expect(err.traceId).toBe(traceId);
262
- });
263
-
264
- it('ConfigError without options', () => {
265
- const err = new ConfigError('bad config');
266
- expect(err.cause).toBeUndefined();
267
- expect(err.traceId).toBeUndefined();
268
- });
269
-
270
- it('ACLRuleError with cause and traceId', () => {
271
- const err = new ACLRuleError('bad rule', { cause, traceId });
272
- expect(err.cause).toBe(cause);
273
- expect(err.traceId).toBe(traceId);
274
- });
275
-
276
- it('ACLRuleError without options', () => {
277
- const err = new ACLRuleError('bad rule');
278
- expect(err.cause).toBeUndefined();
279
- expect(err.traceId).toBeUndefined();
280
- });
281
-
282
- it('ACLDeniedError with cause and traceId', () => {
283
- const err = new ACLDeniedError('caller.a', 'target.b', { cause, traceId });
284
- expect(err.cause).toBe(cause);
285
- expect(err.traceId).toBe(traceId);
286
- expect(err.callerId).toBe('caller.a');
287
- expect(err.targetId).toBe('target.b');
288
- });
289
-
290
- it('ACLDeniedError without options', () => {
291
- const err = new ACLDeniedError('caller.a', 'target.b');
292
- expect(err.cause).toBeUndefined();
293
- expect(err.traceId).toBeUndefined();
294
- });
295
-
296
- it('ACLDeniedError with null callerId', () => {
297
- const err = new ACLDeniedError(null, 'target.b');
298
- expect(err.callerId).toBeNull();
299
- expect(err.targetId).toBe('target.b');
300
- expect(err.message).toContain('null -> target.b');
301
- });
302
-
303
- it('ModuleNotFoundError with cause and traceId', () => {
304
- const err = new ModuleNotFoundError('mod.x', { cause, traceId });
305
- expect(err.cause).toBe(cause);
306
- expect(err.traceId).toBe(traceId);
307
- });
308
-
309
- it('ModuleNotFoundError without options', () => {
310
- const err = new ModuleNotFoundError('mod.x');
311
- expect(err.cause).toBeUndefined();
312
- expect(err.traceId).toBeUndefined();
313
- });
314
-
315
- it('ModuleTimeoutError with cause and traceId', () => {
316
- const err = new ModuleTimeoutError('mod.x', 3000, { cause, traceId });
317
- expect(err.cause).toBe(cause);
318
- expect(err.traceId).toBe(traceId);
319
- expect(err.moduleId).toBe('mod.x');
320
- expect(err.timeoutMs).toBe(3000);
321
- });
322
-
323
- it('ModuleTimeoutError without options', () => {
324
- const err = new ModuleTimeoutError('mod.x', 3000);
325
- expect(err.cause).toBeUndefined();
326
- expect(err.traceId).toBeUndefined();
327
- });
328
-
329
- it('SchemaValidationError with cause and traceId', () => {
330
- const err = new SchemaValidationError('invalid', [{ path: '/a' }], { cause, traceId });
331
- expect(err.cause).toBe(cause);
332
- expect(err.traceId).toBe(traceId);
333
- });
334
-
335
- it('SchemaValidationError without options', () => {
336
- const err = new SchemaValidationError('invalid', []);
337
- expect(err.cause).toBeUndefined();
338
- expect(err.traceId).toBeUndefined();
339
- });
340
-
341
- it('SchemaValidationError uses default message when no arguments provided', () => {
342
- const err = new SchemaValidationError();
343
- expect(err.message).toBe('Schema validation failed');
344
- expect(err.details['errors']).toEqual([]);
345
- });
346
-
347
- it('SchemaValidationError defaults errors to empty array when errors not provided', () => {
348
- const err = new SchemaValidationError('custom message');
349
- expect(err.details['errors']).toEqual([]);
350
- });
351
-
352
- it('SchemaNotFoundError with cause and traceId', () => {
353
- const err = new SchemaNotFoundError('schema.x', { cause, traceId });
354
- expect(err.cause).toBe(cause);
355
- expect(err.traceId).toBe(traceId);
356
- });
357
-
358
- it('SchemaNotFoundError without options', () => {
359
- const err = new SchemaNotFoundError('schema.x');
360
- expect(err.cause).toBeUndefined();
361
- expect(err.traceId).toBeUndefined();
362
- });
363
-
364
- it('SchemaParseError with cause and traceId', () => {
365
- const err = new SchemaParseError('bad yaml', { cause, traceId });
366
- expect(err.cause).toBe(cause);
367
- expect(err.traceId).toBe(traceId);
368
- });
369
-
370
- it('SchemaParseError without options', () => {
371
- const err = new SchemaParseError('bad yaml');
372
- expect(err.cause).toBeUndefined();
373
- expect(err.traceId).toBeUndefined();
374
- });
375
-
376
- it('SchemaCircularRefError with cause and traceId', () => {
377
- const err = new SchemaCircularRefError('#/defs/A', { cause, traceId });
378
- expect(err.cause).toBe(cause);
379
- expect(err.traceId).toBe(traceId);
380
- });
381
-
382
- it('SchemaCircularRefError without options', () => {
383
- const err = new SchemaCircularRefError('#/defs/A');
384
- expect(err.cause).toBeUndefined();
385
- expect(err.traceId).toBeUndefined();
386
- });
387
-
388
- it('CallDepthExceededError with cause and traceId', () => {
389
- const err = new CallDepthExceededError(5, 4, ['a', 'b'], { cause, traceId });
390
- expect(err.cause).toBe(cause);
391
- expect(err.traceId).toBe(traceId);
392
- expect(err.currentDepth).toBe(5);
393
- expect(err.maxDepth).toBe(4);
394
- });
395
-
396
- it('CallDepthExceededError without options', () => {
397
- const err = new CallDepthExceededError(5, 4, ['a', 'b']);
398
- expect(err.cause).toBeUndefined();
399
- expect(err.traceId).toBeUndefined();
400
- });
401
-
402
- it('CircularCallError with cause and traceId', () => {
403
- const err = new CircularCallError('mod.a', ['mod.a', 'mod.b'], { cause, traceId });
404
- expect(err.cause).toBe(cause);
405
- expect(err.traceId).toBe(traceId);
406
- expect(err.moduleId).toBe('mod.a');
407
- });
408
-
409
- it('CircularCallError without options', () => {
410
- const err = new CircularCallError('mod.a', ['mod.a', 'mod.b']);
411
- expect(err.cause).toBeUndefined();
412
- expect(err.traceId).toBeUndefined();
413
- });
414
-
415
- it('CallFrequencyExceededError with cause and traceId', () => {
416
- const err = new CallFrequencyExceededError('mod.a', 4, 3, ['mod.a'], { cause, traceId });
417
- expect(err.cause).toBe(cause);
418
- expect(err.traceId).toBe(traceId);
419
- expect(err.moduleId).toBe('mod.a');
420
- expect(err.count).toBe(4);
421
- expect(err.maxRepeat).toBe(3);
422
- });
423
-
424
- it('CallFrequencyExceededError without options', () => {
425
- const err = new CallFrequencyExceededError('mod.a', 4, 3, ['mod.a']);
426
- expect(err.cause).toBeUndefined();
427
- expect(err.traceId).toBeUndefined();
428
- });
429
-
430
- it('InvalidInputError with cause and traceId', () => {
431
- const err = new InvalidInputError('bad data', { cause, traceId });
432
- expect(err.cause).toBe(cause);
433
- expect(err.traceId).toBe(traceId);
434
- });
435
-
436
- it('InvalidInputError without options', () => {
437
- const err = new InvalidInputError('bad data');
438
- expect(err.cause).toBeUndefined();
439
- expect(err.traceId).toBeUndefined();
440
- });
441
-
442
- it('InvalidInputError uses default message when no arguments provided', () => {
443
- const err = new InvalidInputError();
444
- expect(err.message).toBe('Invalid input');
445
- });
446
-
447
- it('FuncMissingTypeHintError with cause and traceId', () => {
448
- const err = new FuncMissingTypeHintError('myFunc', 'myParam', { cause, traceId });
449
- expect(err.name).toBe('FuncMissingTypeHintError');
450
- expect(err.code).toBe('FUNC_MISSING_TYPE_HINT');
451
- expect(err.cause).toBe(cause);
452
- expect(err.traceId).toBe(traceId);
453
- expect(err.message).toContain('myParam');
454
- expect(err.message).toContain('myFunc');
455
- });
456
-
457
- it('FuncMissingTypeHintError without options', () => {
458
- const err = new FuncMissingTypeHintError('myFunc', 'myParam');
459
- expect(err.cause).toBeUndefined();
460
- expect(err.traceId).toBeUndefined();
461
- });
462
-
463
- it('FuncMissingReturnTypeError with cause and traceId', () => {
464
- const err = new FuncMissingReturnTypeError('myFunc', { cause, traceId });
465
- expect(err.name).toBe('FuncMissingReturnTypeError');
466
- expect(err.code).toBe('FUNC_MISSING_RETURN_TYPE');
467
- expect(err.cause).toBe(cause);
468
- expect(err.traceId).toBe(traceId);
469
- expect(err.message).toContain('myFunc');
470
- });
471
-
472
- it('FuncMissingReturnTypeError without options', () => {
473
- const err = new FuncMissingReturnTypeError('myFunc');
474
- expect(err.cause).toBeUndefined();
475
- expect(err.traceId).toBeUndefined();
476
- });
477
-
478
- it('BindingInvalidTargetError with cause and traceId', () => {
479
- const err = new BindingInvalidTargetError('bad:target', { cause, traceId });
480
- expect(err.cause).toBe(cause);
481
- expect(err.traceId).toBe(traceId);
482
- });
483
-
484
- it('BindingInvalidTargetError without options', () => {
485
- const err = new BindingInvalidTargetError('bad:target');
486
- expect(err.cause).toBeUndefined();
487
- expect(err.traceId).toBeUndefined();
488
- });
489
-
490
- it('BindingModuleNotFoundError with cause and traceId', () => {
491
- const err = new BindingModuleNotFoundError('some.module', { cause, traceId });
492
- expect(err.cause).toBe(cause);
493
- expect(err.traceId).toBe(traceId);
494
- });
495
-
496
- it('BindingModuleNotFoundError without options', () => {
497
- const err = new BindingModuleNotFoundError('some.module');
498
- expect(err.cause).toBeUndefined();
499
- expect(err.traceId).toBeUndefined();
500
- });
501
-
502
- it('BindingCallableNotFoundError with cause and traceId', () => {
503
- const err = new BindingCallableNotFoundError('fn', 'some.module', { cause, traceId });
504
- expect(err.cause).toBe(cause);
505
- expect(err.traceId).toBe(traceId);
506
- });
507
-
508
- it('BindingCallableNotFoundError without options', () => {
509
- const err = new BindingCallableNotFoundError('fn', 'some.module');
510
- expect(err.cause).toBeUndefined();
511
- expect(err.traceId).toBeUndefined();
512
- });
513
-
514
- it('BindingNotCallableError with cause and traceId', () => {
515
- const err = new BindingNotCallableError('some:target', { cause, traceId });
516
- expect(err.cause).toBe(cause);
517
- expect(err.traceId).toBe(traceId);
518
- });
519
-
520
- it('BindingNotCallableError without options', () => {
521
- const err = new BindingNotCallableError('some:target');
522
- expect(err.cause).toBeUndefined();
523
- expect(err.traceId).toBeUndefined();
524
- });
525
-
526
- it('BindingSchemaMissingError with cause and traceId', () => {
527
- const err = new BindingSchemaMissingError('some:target', { cause, traceId });
528
- expect(err.cause).toBe(cause);
529
- expect(err.traceId).toBe(traceId);
530
- });
531
-
532
- it('BindingSchemaMissingError without options', () => {
533
- const err = new BindingSchemaMissingError('some:target');
534
- expect(err.cause).toBeUndefined();
535
- expect(err.traceId).toBeUndefined();
536
- });
537
-
538
- it('BindingFileInvalidError with cause and traceId', () => {
539
- const err = new BindingFileInvalidError('/file.yaml', 'parse error', { cause, traceId });
540
- expect(err.cause).toBe(cause);
541
- expect(err.traceId).toBe(traceId);
542
- });
543
-
544
- it('BindingFileInvalidError without options', () => {
545
- const err = new BindingFileInvalidError('/file.yaml', 'parse error');
546
- expect(err.cause).toBeUndefined();
547
- expect(err.traceId).toBeUndefined();
548
- });
549
-
550
- it('CircularDependencyError with cause and traceId', () => {
551
- const err = new CircularDependencyError(['a', 'b', 'a'], { cause, traceId });
552
- expect(err.cause).toBe(cause);
553
- expect(err.traceId).toBe(traceId);
554
- });
555
-
556
- it('CircularDependencyError without options', () => {
557
- const err = new CircularDependencyError(['a', 'b', 'a']);
558
- expect(err.cause).toBeUndefined();
559
- expect(err.traceId).toBeUndefined();
560
- });
561
-
562
- it('ModuleLoadError with cause and traceId', () => {
563
- const err = new ModuleLoadError('mod.a', 'file not found', { cause, traceId });
564
- expect(err.cause).toBe(cause);
565
- expect(err.traceId).toBe(traceId);
566
- });
567
-
568
- it('ModuleLoadError without options', () => {
569
- const err = new ModuleLoadError('mod.a', 'file not found');
570
- expect(err.cause).toBeUndefined();
571
- expect(err.traceId).toBeUndefined();
572
- });
573
-
574
- it('ModuleExecuteError with cause and traceId', () => {
575
- const err = new ModuleExecuteError('mod.a', 'runtime error', { cause, traceId });
576
- expect(err.name).toBe('ModuleExecuteError');
577
- expect(err.code).toBe('MODULE_EXECUTE_ERROR');
578
- expect(err.cause).toBe(cause);
579
- expect(err.traceId).toBe(traceId);
580
- expect(err.message).toContain('mod.a');
581
- expect(err.message).toContain('runtime error');
582
- });
583
-
584
- it('ModuleExecuteError without options', () => {
585
- const err = new ModuleExecuteError('mod.a', 'runtime error');
586
- expect(err.cause).toBeUndefined();
587
- expect(err.traceId).toBeUndefined();
588
- });
589
-
590
- it('InternalError with cause and traceId', () => {
591
- const err = new InternalError('something broke', { cause, traceId });
592
- expect(err.name).toBe('InternalError');
593
- expect(err.code).toBe('GENERAL_INTERNAL_ERROR');
594
- expect(err.cause).toBe(cause);
595
- expect(err.traceId).toBe(traceId);
596
- });
597
-
598
- it('InternalError without options', () => {
599
- const err = new InternalError('something broke');
600
- expect(err.cause).toBeUndefined();
601
- expect(err.traceId).toBeUndefined();
602
- });
603
-
604
- it('InternalError uses default message when no arguments provided', () => {
605
- const err = new InternalError();
606
- expect(err.message).toBe('Internal error');
607
- });
608
- });
609
-
610
- describe('ErrorCodes', () => {
611
- it('contains MIDDLEWARE_CHAIN_ERROR', () => {
612
- expect(ErrorCodes.MIDDLEWARE_CHAIN_ERROR).toBe('MIDDLEWARE_CHAIN_ERROR');
613
- });
614
-
615
- it('contains all expected error codes', () => {
616
- expect(ErrorCodes.CONFIG_NOT_FOUND).toBe('CONFIG_NOT_FOUND');
617
- expect(ErrorCodes.CONFIG_INVALID).toBe('CONFIG_INVALID');
618
- expect(ErrorCodes.ACL_RULE_ERROR).toBe('ACL_RULE_ERROR');
619
- expect(ErrorCodes.ACL_DENIED).toBe('ACL_DENIED');
620
- expect(ErrorCodes.MODULE_NOT_FOUND).toBe('MODULE_NOT_FOUND');
621
- expect(ErrorCodes.MODULE_TIMEOUT).toBe('MODULE_TIMEOUT');
622
- expect(ErrorCodes.MODULE_LOAD_ERROR).toBe('MODULE_LOAD_ERROR');
623
- expect(ErrorCodes.MODULE_EXECUTE_ERROR).toBe('MODULE_EXECUTE_ERROR');
624
- expect(ErrorCodes.SCHEMA_VALIDATION_ERROR).toBe('SCHEMA_VALIDATION_ERROR');
625
- expect(ErrorCodes.SCHEMA_NOT_FOUND).toBe('SCHEMA_NOT_FOUND');
626
- expect(ErrorCodes.SCHEMA_PARSE_ERROR).toBe('SCHEMA_PARSE_ERROR');
627
- expect(ErrorCodes.SCHEMA_CIRCULAR_REF).toBe('SCHEMA_CIRCULAR_REF');
628
- expect(ErrorCodes.CALL_DEPTH_EXCEEDED).toBe('CALL_DEPTH_EXCEEDED');
629
- expect(ErrorCodes.CIRCULAR_CALL).toBe('CIRCULAR_CALL');
630
- expect(ErrorCodes.CALL_FREQUENCY_EXCEEDED).toBe('CALL_FREQUENCY_EXCEEDED');
631
- expect(ErrorCodes.GENERAL_INVALID_INPUT).toBe('GENERAL_INVALID_INPUT');
632
- expect(ErrorCodes.GENERAL_INTERNAL_ERROR).toBe('GENERAL_INTERNAL_ERROR');
633
- expect(ErrorCodes.FUNC_MISSING_TYPE_HINT).toBe('FUNC_MISSING_TYPE_HINT');
634
- expect(ErrorCodes.FUNC_MISSING_RETURN_TYPE).toBe('FUNC_MISSING_RETURN_TYPE');
635
- expect(ErrorCodes.BINDING_INVALID_TARGET).toBe('BINDING_INVALID_TARGET');
636
- expect(ErrorCodes.BINDING_MODULE_NOT_FOUND).toBe('BINDING_MODULE_NOT_FOUND');
637
- expect(ErrorCodes.BINDING_CALLABLE_NOT_FOUND).toBe('BINDING_CALLABLE_NOT_FOUND');
638
- expect(ErrorCodes.BINDING_NOT_CALLABLE).toBe('BINDING_NOT_CALLABLE');
639
- expect(ErrorCodes.BINDING_SCHEMA_MISSING).toBe('BINDING_SCHEMA_MISSING');
640
- expect(ErrorCodes.BINDING_FILE_INVALID).toBe('BINDING_FILE_INVALID');
641
- expect(ErrorCodes.CIRCULAR_DEPENDENCY).toBe('CIRCULAR_DEPENDENCY');
642
- });
643
-
644
- it('is frozen and cannot be mutated', () => {
645
- expect(Object.isFrozen(ErrorCodes)).toBe(true);
646
- });
647
- });