apcore-js 0.5.0 → 0.7.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 (319) hide show
  1. package/README.md +1 -1
  2. package/dist/acl.d.ts +27 -0
  3. package/dist/acl.d.ts.map +1 -0
  4. package/dist/acl.js +175 -0
  5. package/dist/acl.js.map +1 -0
  6. package/dist/approval.d.ts +85 -0
  7. package/dist/approval.d.ts.map +1 -0
  8. package/dist/approval.js +73 -0
  9. package/dist/approval.js.map +1 -0
  10. package/dist/async-task.d.ts +90 -0
  11. package/dist/async-task.d.ts.map +1 -0
  12. package/dist/async-task.js +215 -0
  13. package/dist/async-task.js.map +1 -0
  14. package/dist/bindings.d.ts +12 -0
  15. package/dist/bindings.d.ts.map +1 -0
  16. package/dist/bindings.js +185 -0
  17. package/dist/bindings.js.map +1 -0
  18. package/dist/cancel.d.ts +14 -0
  19. package/dist/cancel.d.ts.map +1 -0
  20. package/dist/cancel.js +27 -0
  21. package/dist/cancel.js.map +1 -0
  22. package/dist/config.d.ts +9 -0
  23. package/dist/config.d.ts.map +1 -0
  24. package/dist/config.js +23 -0
  25. package/dist/config.js.map +1 -0
  26. package/dist/context.d.ts +50 -0
  27. package/dist/context.d.ts.map +1 -0
  28. package/dist/context.js +87 -0
  29. package/dist/context.js.map +1 -0
  30. package/dist/decorator.d.ts +57 -0
  31. package/dist/decorator.d.ts.map +1 -0
  32. package/dist/decorator.js +74 -0
  33. package/dist/decorator.js.map +1 -0
  34. package/dist/errors.d.ts +204 -0
  35. package/dist/errors.d.ts.map +1 -0
  36. package/dist/errors.js +364 -0
  37. package/dist/errors.js.map +1 -0
  38. package/dist/executor.d.ts +82 -0
  39. package/dist/executor.d.ts.map +1 -0
  40. package/dist/executor.js +489 -0
  41. package/dist/executor.js.map +1 -0
  42. package/dist/extensions.d.ts +58 -0
  43. package/dist/extensions.d.ts.map +1 -0
  44. package/dist/extensions.js +239 -0
  45. package/dist/extensions.js.map +1 -0
  46. package/{src/index.ts → dist/index.d.ts} +6 -63
  47. package/dist/index.d.ts.map +1 -0
  48. package/dist/index.js +45 -0
  49. package/dist/index.js.map +1 -0
  50. package/dist/middleware/adapters.d.ts +18 -0
  51. package/dist/middleware/adapters.d.ts.map +1 -0
  52. package/dist/middleware/adapters.js +25 -0
  53. package/dist/middleware/adapters.js.map +1 -0
  54. package/dist/middleware/base.d.ts +10 -0
  55. package/dist/middleware/base.d.ts.map +1 -0
  56. package/dist/middleware/base.js +15 -0
  57. package/dist/middleware/base.js.map +1 -0
  58. package/{src/middleware/index.ts → dist/middleware/index.d.ts} +1 -0
  59. package/dist/middleware/index.d.ts.map +1 -0
  60. package/dist/middleware/index.js +5 -0
  61. package/dist/middleware/index.js.map +1 -0
  62. package/dist/middleware/logging.d.ts +25 -0
  63. package/dist/middleware/logging.d.ts.map +1 -0
  64. package/dist/middleware/logging.js +64 -0
  65. package/dist/middleware/logging.js.map +1 -0
  66. package/dist/middleware/manager.d.ts +21 -0
  67. package/dist/middleware/manager.d.ts.map +1 -0
  68. package/dist/middleware/manager.js +77 -0
  69. package/dist/middleware/manager.js.map +1 -0
  70. package/dist/module.d.ts +31 -0
  71. package/dist/module.d.ts.map +1 -0
  72. package/dist/module.js +12 -0
  73. package/dist/module.js.map +1 -0
  74. package/dist/observability/context-logger.d.ts +54 -0
  75. package/dist/observability/context-logger.d.ts.map +1 -0
  76. package/dist/observability/context-logger.js +151 -0
  77. package/dist/observability/context-logger.js.map +1 -0
  78. package/{src/observability/index.ts → dist/observability/index.d.ts} +1 -0
  79. package/dist/observability/index.d.ts.map +1 -0
  80. package/dist/observability/index.js +4 -0
  81. package/dist/observability/index.js.map +1 -0
  82. package/dist/observability/metrics.d.ts +30 -0
  83. package/dist/observability/metrics.d.ts.map +1 -0
  84. package/dist/observability/metrics.js +177 -0
  85. package/dist/observability/metrics.js.map +1 -0
  86. package/dist/observability/tracing.d.ts +62 -0
  87. package/dist/observability/tracing.d.ts.map +1 -0
  88. package/dist/observability/tracing.js +184 -0
  89. package/dist/observability/tracing.js.map +1 -0
  90. package/dist/registry/dependencies.d.ts +6 -0
  91. package/dist/registry/dependencies.d.ts.map +1 -0
  92. package/dist/registry/dependencies.js +83 -0
  93. package/dist/registry/dependencies.js.map +1 -0
  94. package/dist/registry/entry-point.d.ts +6 -0
  95. package/dist/registry/entry-point.d.ts.map +1 -0
  96. package/dist/registry/entry-point.js +55 -0
  97. package/dist/registry/entry-point.js.map +1 -0
  98. package/{src/registry/index.ts → dist/registry/index.d.ts} +1 -0
  99. package/dist/registry/index.d.ts.map +1 -0
  100. package/dist/registry/index.js +8 -0
  101. package/dist/registry/index.js.map +1 -0
  102. package/dist/registry/metadata.d.ts +9 -0
  103. package/dist/registry/metadata.d.ts.map +1 -0
  104. package/dist/registry/metadata.js +105 -0
  105. package/dist/registry/metadata.js.map +1 -0
  106. package/dist/registry/registry.d.ts +102 -0
  107. package/dist/registry/registry.d.ts.map +1 -0
  108. package/dist/registry/registry.js +534 -0
  109. package/dist/registry/registry.js.map +1 -0
  110. package/dist/registry/scanner.d.ts +7 -0
  111. package/dist/registry/scanner.d.ts.map +1 -0
  112. package/dist/registry/scanner.js +164 -0
  113. package/dist/registry/scanner.js.map +1 -0
  114. package/dist/registry/schema-export.d.ts +9 -0
  115. package/dist/registry/schema-export.d.ts.map +1 -0
  116. package/dist/registry/schema-export.js +132 -0
  117. package/dist/registry/schema-export.js.map +1 -0
  118. package/dist/registry/types.d.ts +29 -0
  119. package/dist/registry/types.d.ts.map +1 -0
  120. package/dist/registry/types.js +5 -0
  121. package/dist/registry/types.js.map +1 -0
  122. package/dist/registry/validation.d.ts +9 -0
  123. package/dist/registry/validation.d.ts.map +1 -0
  124. package/dist/registry/validation.js +33 -0
  125. package/dist/registry/validation.js.map +1 -0
  126. package/dist/schema/annotations.d.ts +8 -0
  127. package/dist/schema/annotations.d.ts.map +1 -0
  128. package/dist/schema/annotations.js +52 -0
  129. package/dist/schema/annotations.js.map +1 -0
  130. package/dist/schema/exporter.d.ts +13 -0
  131. package/dist/schema/exporter.d.ts.map +1 -0
  132. package/dist/schema/exporter.js +71 -0
  133. package/dist/schema/exporter.js.map +1 -0
  134. package/dist/schema/index.d.ts +9 -0
  135. package/dist/schema/index.d.ts.map +1 -0
  136. package/{src/schema/index.ts → dist/schema/index.js} +1 -7
  137. package/dist/schema/index.js.map +1 -0
  138. package/dist/schema/loader.d.ts +30 -0
  139. package/dist/schema/loader.d.ts.map +1 -0
  140. package/dist/schema/loader.js +260 -0
  141. package/dist/schema/loader.js.map +1 -0
  142. package/dist/schema/ref-resolver.d.ts +19 -0
  143. package/dist/schema/ref-resolver.d.ts.map +1 -0
  144. package/dist/schema/ref-resolver.js +212 -0
  145. package/dist/schema/ref-resolver.js.map +1 -0
  146. package/dist/schema/strict.d.ts +7 -0
  147. package/dist/schema/strict.d.ts.map +1 -0
  148. package/dist/schema/strict.js +127 -0
  149. package/dist/schema/strict.js.map +1 -0
  150. package/dist/schema/types.d.ts +53 -0
  151. package/dist/schema/types.d.ts.map +1 -0
  152. package/dist/schema/types.js +31 -0
  153. package/dist/schema/types.js.map +1 -0
  154. package/dist/schema/validator.d.ts +16 -0
  155. package/dist/schema/validator.d.ts.map +1 -0
  156. package/dist/schema/validator.js +71 -0
  157. package/dist/schema/validator.js.map +1 -0
  158. package/dist/trace-context.d.ts +35 -0
  159. package/dist/trace-context.d.ts.map +1 -0
  160. package/dist/trace-context.js +86 -0
  161. package/dist/trace-context.js.map +1 -0
  162. package/dist/utils/index.d.ts +11 -0
  163. package/dist/utils/index.d.ts.map +1 -0
  164. package/dist/utils/index.js +32 -0
  165. package/dist/utils/index.js.map +1 -0
  166. package/dist/utils/pattern.d.ts +5 -0
  167. package/dist/utils/pattern.d.ts.map +1 -0
  168. package/dist/utils/pattern.js +31 -0
  169. package/dist/utils/pattern.js.map +1 -0
  170. package/package.json +24 -3
  171. package/.claude/settings.local.json +0 -12
  172. package/.github/workflows/ci.yml +0 -39
  173. package/.gitmessage +0 -60
  174. package/.pre-commit-config.yaml +0 -28
  175. package/CHANGELOG.md +0 -214
  176. package/CLAUDE.md +0 -68
  177. package/apcore-logo.svg +0 -79
  178. package/planning/acl-system/overview.md +0 -54
  179. package/planning/acl-system/plan.md +0 -92
  180. package/planning/acl-system/state.json +0 -76
  181. package/planning/acl-system/tasks/acl-core.md +0 -226
  182. package/planning/acl-system/tasks/acl-rule.md +0 -92
  183. package/planning/acl-system/tasks/conditional-rules.md +0 -259
  184. package/planning/acl-system/tasks/pattern-matching.md +0 -152
  185. package/planning/acl-system/tasks/yaml-loading.md +0 -271
  186. package/planning/core-executor/overview.md +0 -53
  187. package/planning/core-executor/plan.md +0 -88
  188. package/planning/core-executor/state.json +0 -76
  189. package/planning/core-executor/tasks/async-support.md +0 -106
  190. package/planning/core-executor/tasks/execution-pipeline.md +0 -113
  191. package/planning/core-executor/tasks/redaction.md +0 -85
  192. package/planning/core-executor/tasks/safety-checks.md +0 -65
  193. package/planning/core-executor/tasks/setup.md +0 -75
  194. package/planning/decorator-bindings/overview.md +0 -62
  195. package/planning/decorator-bindings/plan.md +0 -104
  196. package/planning/decorator-bindings/state.json +0 -87
  197. package/planning/decorator-bindings/tasks/binding-directory.md +0 -79
  198. package/planning/decorator-bindings/tasks/binding-loader.md +0 -148
  199. package/planning/decorator-bindings/tasks/explicit-schemas.md +0 -85
  200. package/planning/decorator-bindings/tasks/function-module.md +0 -127
  201. package/planning/decorator-bindings/tasks/module-factory.md +0 -89
  202. package/planning/decorator-bindings/tasks/schema-modes.md +0 -142
  203. package/planning/middleware-system/overview.md +0 -48
  204. package/planning/middleware-system/plan.md +0 -102
  205. package/planning/middleware-system/state.json +0 -65
  206. package/planning/middleware-system/tasks/adapters.md +0 -170
  207. package/planning/middleware-system/tasks/base.md +0 -115
  208. package/planning/middleware-system/tasks/logging-middleware.md +0 -304
  209. package/planning/middleware-system/tasks/manager.md +0 -313
  210. package/planning/observability/overview.md +0 -53
  211. package/planning/observability/plan.md +0 -119
  212. package/planning/observability/state.json +0 -98
  213. package/planning/observability/tasks/context-logger.md +0 -201
  214. package/planning/observability/tasks/exporters.md +0 -121
  215. package/planning/observability/tasks/metrics-collector.md +0 -162
  216. package/planning/observability/tasks/metrics-middleware.md +0 -141
  217. package/planning/observability/tasks/obs-logging-middleware.md +0 -179
  218. package/planning/observability/tasks/span-model.md +0 -120
  219. package/planning/observability/tasks/tracing-middleware.md +0 -179
  220. package/planning/overview.md +0 -81
  221. package/planning/registry-system/overview.md +0 -57
  222. package/planning/registry-system/plan.md +0 -114
  223. package/planning/registry-system/state.json +0 -109
  224. package/planning/registry-system/tasks/dependencies.md +0 -157
  225. package/planning/registry-system/tasks/entry-point.md +0 -148
  226. package/planning/registry-system/tasks/metadata.md +0 -198
  227. package/planning/registry-system/tasks/registry-core.md +0 -323
  228. package/planning/registry-system/tasks/scanner.md +0 -172
  229. package/planning/registry-system/tasks/schema-export.md +0 -261
  230. package/planning/registry-system/tasks/types.md +0 -124
  231. package/planning/registry-system/tasks/validation.md +0 -177
  232. package/planning/schema-system/overview.md +0 -56
  233. package/planning/schema-system/plan.md +0 -121
  234. package/planning/schema-system/state.json +0 -98
  235. package/planning/schema-system/tasks/exporter.md +0 -153
  236. package/planning/schema-system/tasks/loader.md +0 -106
  237. package/planning/schema-system/tasks/ref-resolver.md +0 -133
  238. package/planning/schema-system/tasks/strict-mode.md +0 -140
  239. package/planning/schema-system/tasks/typebox-generation.md +0 -133
  240. package/planning/schema-system/tasks/types-and-annotations.md +0 -160
  241. package/planning/schema-system/tasks/validator.md +0 -149
  242. package/src/acl.ts +0 -200
  243. package/src/async-task.ts +0 -267
  244. package/src/bindings.ts +0 -207
  245. package/src/cancel.ts +0 -32
  246. package/src/config.ts +0 -24
  247. package/src/context.ts +0 -160
  248. package/src/decorator.ts +0 -110
  249. package/src/errors.ts +0 -429
  250. package/src/executor.ts +0 -493
  251. package/src/extensions.ts +0 -265
  252. package/src/middleware/adapters.ts +0 -54
  253. package/src/middleware/base.ts +0 -33
  254. package/src/middleware/logging.ts +0 -103
  255. package/src/middleware/manager.ts +0 -105
  256. package/src/module.ts +0 -43
  257. package/src/observability/context-logger.ts +0 -203
  258. package/src/observability/metrics.ts +0 -214
  259. package/src/observability/tracing.ts +0 -252
  260. package/src/registry/dependencies.ts +0 -99
  261. package/src/registry/entry-point.ts +0 -64
  262. package/src/registry/metadata.ts +0 -111
  263. package/src/registry/registry.ts +0 -580
  264. package/src/registry/scanner.ts +0 -168
  265. package/src/registry/schema-export.ts +0 -181
  266. package/src/registry/types.ts +0 -32
  267. package/src/registry/validation.ts +0 -38
  268. package/src/schema/annotations.ts +0 -68
  269. package/src/schema/exporter.ts +0 -90
  270. package/src/schema/loader.ts +0 -273
  271. package/src/schema/ref-resolver.ts +0 -244
  272. package/src/schema/strict.ts +0 -136
  273. package/src/schema/types.ts +0 -73
  274. package/src/schema/validator.ts +0 -82
  275. package/src/trace-context.ts +0 -102
  276. package/src/utils/index.ts +0 -5
  277. package/src/utils/pattern.ts +0 -30
  278. package/tests/async-task.test.ts +0 -335
  279. package/tests/helpers.ts +0 -30
  280. package/tests/integration/test-acl-safety.test.ts +0 -269
  281. package/tests/integration/test-binding-executor.test.ts +0 -194
  282. package/tests/integration/test-e2e-flow.test.ts +0 -117
  283. package/tests/integration/test-error-propagation.test.ts +0 -259
  284. package/tests/integration/test-middleware-chain.test.ts +0 -120
  285. package/tests/integration/test-observability-integration.test.ts +0 -438
  286. package/tests/observability/test-context-logger.test.ts +0 -123
  287. package/tests/observability/test-metrics.test.ts +0 -186
  288. package/tests/observability/test-tracing.test.ts +0 -303
  289. package/tests/registry/test-dependencies.test.ts +0 -70
  290. package/tests/registry/test-entry-point.test.ts +0 -133
  291. package/tests/registry/test-metadata.test.ts +0 -265
  292. package/tests/registry/test-registry.test.ts +0 -1397
  293. package/tests/registry/test-scanner.test.ts +0 -257
  294. package/tests/registry/test-schema-export.test.ts +0 -355
  295. package/tests/registry/test-validation.test.ts +0 -75
  296. package/tests/schema/test-annotations.test.ts +0 -137
  297. package/tests/schema/test-exporter.test.ts +0 -172
  298. package/tests/schema/test-loader.test.ts +0 -461
  299. package/tests/schema/test-ref-resolver.test.ts +0 -530
  300. package/tests/schema/test-strict.test.ts +0 -348
  301. package/tests/schema/test-validator.test.ts +0 -64
  302. package/tests/test-acl.test.ts +0 -423
  303. package/tests/test-bindings.test.ts +0 -227
  304. package/tests/test-cancel.test.ts +0 -71
  305. package/tests/test-config.test.ts +0 -76
  306. package/tests/test-context.test.ts +0 -266
  307. package/tests/test-decorator.test.ts +0 -173
  308. package/tests/test-errors.test.ts +0 -647
  309. package/tests/test-executor-stream.test.ts +0 -208
  310. package/tests/test-executor.test.ts +0 -252
  311. package/tests/test-extensions.test.ts +0 -310
  312. package/tests/test-logging-middleware.test.ts +0 -150
  313. package/tests/test-middleware-manager.test.ts +0 -185
  314. package/tests/test-middleware.test.ts +0 -86
  315. package/tests/test-trace-context.test.ts +0 -251
  316. package/tests/utils/test-pattern.test.ts +0 -109
  317. package/tsconfig.build.json +0 -8
  318. package/tsconfig.json +0 -20
  319. 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
- });