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
@@ -0,0 +1,87 @@
1
+ import { v4 as uuidv4 } from 'uuid';
2
+ export function createIdentity(id, type = 'user', roles = [], attrs = {}) {
3
+ return Object.freeze({ id, type, roles: Object.freeze([...roles]), attrs: Object.freeze({ ...attrs }) });
4
+ }
5
+ export class Context {
6
+ traceId;
7
+ callerId;
8
+ callChain;
9
+ executor;
10
+ identity;
11
+ redactedInputs;
12
+ data;
13
+ cancelToken;
14
+ constructor(traceId, callerId = null, callChain = [], executor = null, identity = null, redactedInputs = null, data = {}, cancelToken = null) {
15
+ this.traceId = traceId;
16
+ this.callerId = callerId;
17
+ this.callChain = Object.freeze([...callChain]);
18
+ this.executor = executor;
19
+ this.identity = identity;
20
+ this.redactedInputs = redactedInputs;
21
+ this.data = data;
22
+ this.cancelToken = cancelToken;
23
+ }
24
+ /**
25
+ * Create a new top-level Context with a generated UUID v4 traceId.
26
+ *
27
+ * When `traceParent` is provided, its `traceId` (32 hex chars) is
28
+ * converted to UUID format (8-4-4-4-12) and used instead of generating
29
+ * a new one.
30
+ */
31
+ static create(executor = null, identity = null, data, traceParent) {
32
+ let traceId;
33
+ if (traceParent) {
34
+ const h = traceParent.traceId;
35
+ traceId = `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;
36
+ }
37
+ else {
38
+ traceId = uuidv4();
39
+ }
40
+ return new Context(traceId, null, [], executor, identity, null, data ?? {});
41
+ }
42
+ toJSON() {
43
+ const publicData = {};
44
+ for (const [key, value] of Object.entries(this.data)) {
45
+ if (!key.startsWith('_')) {
46
+ publicData[key] = value;
47
+ }
48
+ }
49
+ return {
50
+ traceId: this.traceId,
51
+ callerId: this.callerId,
52
+ callChain: [...this.callChain],
53
+ identity: this.identity ? {
54
+ id: this.identity.id,
55
+ type: this.identity.type,
56
+ roles: [...this.identity.roles],
57
+ attrs: { ...this.identity.attrs },
58
+ } : null,
59
+ redactedInputs: this.redactedInputs ? { ...this.redactedInputs } : null,
60
+ data: publicData,
61
+ };
62
+ }
63
+ static fromJSON(data, executor) {
64
+ const identityData = data.identity;
65
+ const identity = identityData ? {
66
+ id: identityData.id,
67
+ type: identityData.type ?? 'user',
68
+ roles: Object.freeze([...(Array.isArray(identityData.roles) ? identityData.roles : [])]),
69
+ attrs: Object.freeze((identityData.attrs && typeof identityData.attrs === 'object' ? identityData.attrs : {})),
70
+ } : null;
71
+ return new Context(data.traceId, data.callerId ?? null, data.callChain ?? [], executor ?? null, identity, data.redactedInputs ?? null, data.data ? { ...data.data } : {});
72
+ }
73
+ get logger() {
74
+ const prefix = `[apcore:${this.callerId ?? 'unknown'}]`;
75
+ return {
76
+ debug: (...args) => console.debug(prefix, ...args),
77
+ info: (...args) => console.info(prefix, ...args),
78
+ warn: (...args) => console.warn(prefix, ...args),
79
+ error: (...args) => console.error(prefix, ...args),
80
+ };
81
+ }
82
+ child(targetModuleId) {
83
+ return new Context(this.traceId, this.callChain.length > 0 ? this.callChain[this.callChain.length - 1] : null, [...this.callChain, targetModuleId], this.executor, this.identity, null, this.data, // shared reference
84
+ this.cancelToken);
85
+ }
86
+ }
87
+ //# sourceMappingURL=context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,57 @@
1
+ /**
2
+ * Module factory, FunctionModule wrapper.
3
+ *
4
+ * TypeScript version uses explicit TypeBox schemas instead of runtime type inference.
5
+ */
6
+ import type { TSchema } from '@sinclair/typebox';
7
+ import type { Context } from './context.js';
8
+ import type { ModuleAnnotations, ModuleExample } from './module.js';
9
+ export declare function normalizeResult(result: unknown): Record<string, unknown>;
10
+ export declare class FunctionModule {
11
+ readonly moduleId: string;
12
+ readonly inputSchema: TSchema;
13
+ readonly outputSchema: TSchema;
14
+ readonly description: string;
15
+ readonly documentation: string | null;
16
+ readonly tags: string[] | null;
17
+ readonly version: string;
18
+ readonly annotations: ModuleAnnotations | null;
19
+ readonly metadata: Record<string, unknown> | null;
20
+ readonly examples: ModuleExample[] | null;
21
+ private _executeFn;
22
+ constructor(options: {
23
+ execute: (inputs: Record<string, unknown>, context: Context) => Promise<Record<string, unknown>> | Record<string, unknown>;
24
+ moduleId: string;
25
+ inputSchema: TSchema;
26
+ outputSchema: TSchema;
27
+ description?: string;
28
+ documentation?: string | null;
29
+ tags?: string[] | null;
30
+ version?: string;
31
+ annotations?: ModuleAnnotations | null;
32
+ metadata?: Record<string, unknown> | null;
33
+ examples?: ModuleExample[] | null;
34
+ });
35
+ execute(inputs: Record<string, unknown>, context: Context): Promise<Record<string, unknown>>;
36
+ }
37
+ export declare function makeAutoId(name: string): string;
38
+ /**
39
+ * Create a FunctionModule from options. TypeScript version requires explicit schemas.
40
+ */
41
+ export declare function module(options: {
42
+ id?: string;
43
+ inputSchema: TSchema;
44
+ outputSchema: TSchema;
45
+ description?: string;
46
+ documentation?: string | null;
47
+ annotations?: ModuleAnnotations | null;
48
+ tags?: string[] | null;
49
+ version?: string;
50
+ metadata?: Record<string, unknown> | null;
51
+ examples?: ModuleExample[] | null;
52
+ execute: (inputs: Record<string, unknown>, context: Context) => Promise<Record<string, unknown>> | Record<string, unknown>;
53
+ registry?: {
54
+ register(moduleId: string, module: unknown): void;
55
+ } | null;
56
+ }): FunctionModule;
57
+ //# sourceMappingURL=decorator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decorator.d.ts","sourceRoot":"","sources":["../src/decorator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIxE;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAE1C,OAAO,CAAC,UAAU,CAAoH;gBAE1H,OAAO,EAAE;QACnB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3H,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,OAAO,CAAC;QACrB,YAAY,EAAE,OAAO,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;QACvC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QAC1C,QAAQ,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;KACnC;IAcK,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAInG;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3H,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACzE,GAAG,cAAc,CAsBjB"}
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Module factory, FunctionModule wrapper.
3
+ *
4
+ * TypeScript version uses explicit TypeBox schemas instead of runtime type inference.
5
+ */
6
+ export function normalizeResult(result) {
7
+ if (result === null || result === undefined)
8
+ return {};
9
+ if (typeof result === 'object' && !Array.isArray(result))
10
+ return result;
11
+ return { result };
12
+ }
13
+ export class FunctionModule {
14
+ moduleId;
15
+ inputSchema;
16
+ outputSchema;
17
+ description;
18
+ documentation;
19
+ tags;
20
+ version;
21
+ annotations;
22
+ metadata;
23
+ examples;
24
+ _executeFn;
25
+ constructor(options) {
26
+ this.moduleId = options.moduleId;
27
+ this.inputSchema = options.inputSchema;
28
+ this.outputSchema = options.outputSchema;
29
+ this.description = options.description ?? `Module ${options.moduleId}`;
30
+ this.documentation = options.documentation ?? null;
31
+ this.tags = options.tags ?? null;
32
+ this.version = options.version ?? '1.0.0';
33
+ this.annotations = options.annotations ?? null;
34
+ this.metadata = options.metadata ?? null;
35
+ this.examples = options.examples ?? null;
36
+ this._executeFn = options.execute;
37
+ }
38
+ async execute(inputs, context) {
39
+ const result = await this._executeFn(inputs, context);
40
+ return normalizeResult(result);
41
+ }
42
+ }
43
+ export function makeAutoId(name) {
44
+ let raw = name.toLowerCase();
45
+ raw = raw.replace(/[^a-z0-9_.]/g, '_');
46
+ const segments = raw.split('.');
47
+ return segments
48
+ .map((s) => (s && s[0] >= '0' && s[0] <= '9' ? '_' + s : s))
49
+ .join('.');
50
+ }
51
+ /**
52
+ * Create a FunctionModule from options. TypeScript version requires explicit schemas.
53
+ */
54
+ export function module(options) {
55
+ const moduleId = options.id ?? makeAutoId('anonymous');
56
+ const fm = new FunctionModule({
57
+ execute: options.execute,
58
+ moduleId,
59
+ inputSchema: options.inputSchema,
60
+ outputSchema: options.outputSchema,
61
+ description: options.description,
62
+ documentation: options.documentation,
63
+ tags: options.tags,
64
+ version: options.version,
65
+ annotations: options.annotations,
66
+ metadata: options.metadata,
67
+ examples: options.examples,
68
+ });
69
+ if (options.registry) {
70
+ options.registry.register(fm.moduleId, fm);
71
+ }
72
+ return fm;
73
+ }
74
+ //# sourceMappingURL=decorator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decorator.js","sourceRoot":"","sources":["../src/decorator.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,204 @@
1
+ /**
2
+ * Error hierarchy for the apcore framework.
3
+ */
4
+ export interface ErrorOptions {
5
+ cause?: Error;
6
+ traceId?: string;
7
+ retryable?: boolean | null;
8
+ aiGuidance?: string | null;
9
+ userFixable?: boolean | null;
10
+ suggestion?: string | null;
11
+ }
12
+ export declare class ModuleError extends Error {
13
+ static readonly DEFAULT_RETRYABLE: boolean | null;
14
+ readonly code: string;
15
+ readonly details: Record<string, unknown>;
16
+ readonly cause?: Error;
17
+ readonly traceId?: string;
18
+ readonly timestamp: string;
19
+ readonly retryable: boolean | null;
20
+ readonly aiGuidance: string | null;
21
+ readonly userFixable: boolean | null;
22
+ readonly suggestion: string | null;
23
+ 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
+ toString(): string;
25
+ toJSON(): Record<string, unknown>;
26
+ }
27
+ export declare class ConfigNotFoundError extends ModuleError {
28
+ static readonly DEFAULT_RETRYABLE: boolean | null;
29
+ constructor(configPath: string, options?: ErrorOptions);
30
+ }
31
+ export declare class ConfigError extends ModuleError {
32
+ static readonly DEFAULT_RETRYABLE: boolean | null;
33
+ constructor(message: string, options?: ErrorOptions);
34
+ }
35
+ export declare class ACLRuleError extends ModuleError {
36
+ static readonly DEFAULT_RETRYABLE: boolean | null;
37
+ constructor(message: string, options?: ErrorOptions);
38
+ }
39
+ export declare class ACLDeniedError extends ModuleError {
40
+ static readonly DEFAULT_RETRYABLE: boolean | null;
41
+ constructor(callerId: string | null, targetId: string, options?: ErrorOptions);
42
+ get callerId(): string | null;
43
+ get targetId(): string;
44
+ }
45
+ export declare class ModuleNotFoundError extends ModuleError {
46
+ static readonly DEFAULT_RETRYABLE: boolean | null;
47
+ constructor(moduleId: string, options?: ErrorOptions);
48
+ }
49
+ export declare class ModuleTimeoutError extends ModuleError {
50
+ static readonly DEFAULT_RETRYABLE: boolean | null;
51
+ constructor(moduleId: string, timeoutMs: number, options?: ErrorOptions);
52
+ get moduleId(): string;
53
+ get timeoutMs(): number;
54
+ }
55
+ export declare class SchemaValidationError extends ModuleError {
56
+ static readonly DEFAULT_RETRYABLE: boolean | null;
57
+ constructor(message?: string, errors?: Array<Record<string, unknown>>, options?: ErrorOptions);
58
+ }
59
+ export declare class SchemaNotFoundError extends ModuleError {
60
+ static readonly DEFAULT_RETRYABLE: boolean | null;
61
+ constructor(schemaId: string, options?: ErrorOptions);
62
+ }
63
+ export declare class SchemaParseError extends ModuleError {
64
+ static readonly DEFAULT_RETRYABLE: boolean | null;
65
+ constructor(message: string, options?: ErrorOptions);
66
+ }
67
+ export declare class SchemaCircularRefError extends ModuleError {
68
+ static readonly DEFAULT_RETRYABLE: boolean | null;
69
+ constructor(refPath: string, options?: ErrorOptions);
70
+ }
71
+ export declare class CallDepthExceededError extends ModuleError {
72
+ static readonly DEFAULT_RETRYABLE: boolean | null;
73
+ constructor(depth: number, maxDepth: number, callChain: string[], options?: ErrorOptions);
74
+ get currentDepth(): number;
75
+ get maxDepth(): number;
76
+ }
77
+ export declare class CircularCallError extends ModuleError {
78
+ static readonly DEFAULT_RETRYABLE: boolean | null;
79
+ constructor(moduleId: string, callChain: string[], options?: ErrorOptions);
80
+ get moduleId(): string;
81
+ }
82
+ export declare class CallFrequencyExceededError extends ModuleError {
83
+ static readonly DEFAULT_RETRYABLE: boolean | null;
84
+ constructor(moduleId: string, count: number, maxRepeat: number, callChain: string[], options?: ErrorOptions);
85
+ get moduleId(): string;
86
+ get count(): number;
87
+ get maxRepeat(): number;
88
+ }
89
+ export declare class InvalidInputError extends ModuleError {
90
+ static readonly DEFAULT_RETRYABLE: boolean | null;
91
+ constructor(message?: string, options?: ErrorOptions);
92
+ }
93
+ export declare class FuncMissingTypeHintError extends ModuleError {
94
+ static readonly DEFAULT_RETRYABLE: boolean | null;
95
+ constructor(functionName: string, parameterName: string, options?: ErrorOptions);
96
+ }
97
+ export declare class FuncMissingReturnTypeError extends ModuleError {
98
+ static readonly DEFAULT_RETRYABLE: boolean | null;
99
+ constructor(functionName: string, options?: ErrorOptions);
100
+ }
101
+ export declare class BindingInvalidTargetError extends ModuleError {
102
+ static readonly DEFAULT_RETRYABLE: boolean | null;
103
+ constructor(target: string, options?: ErrorOptions);
104
+ }
105
+ export declare class BindingModuleNotFoundError extends ModuleError {
106
+ static readonly DEFAULT_RETRYABLE: boolean | null;
107
+ constructor(modulePath: string, options?: ErrorOptions);
108
+ }
109
+ export declare class BindingCallableNotFoundError extends ModuleError {
110
+ static readonly DEFAULT_RETRYABLE: boolean | null;
111
+ constructor(callableName: string, modulePath: string, options?: ErrorOptions);
112
+ }
113
+ export declare class BindingNotCallableError extends ModuleError {
114
+ static readonly DEFAULT_RETRYABLE: boolean | null;
115
+ constructor(target: string, options?: ErrorOptions);
116
+ }
117
+ export declare class BindingSchemaMissingError extends ModuleError {
118
+ static readonly DEFAULT_RETRYABLE: boolean | null;
119
+ constructor(target: string, options?: ErrorOptions);
120
+ }
121
+ export declare class BindingFileInvalidError extends ModuleError {
122
+ static readonly DEFAULT_RETRYABLE: boolean | null;
123
+ constructor(filePath: string, reason: string, options?: ErrorOptions);
124
+ }
125
+ export declare class CircularDependencyError extends ModuleError {
126
+ static readonly DEFAULT_RETRYABLE: boolean | null;
127
+ constructor(cyclePath: string[], options?: ErrorOptions);
128
+ }
129
+ export declare class ModuleLoadError extends ModuleError {
130
+ static readonly DEFAULT_RETRYABLE: boolean | null;
131
+ constructor(moduleId: string, reason: string, options?: ErrorOptions);
132
+ }
133
+ export declare class ModuleExecuteError extends ModuleError {
134
+ static readonly DEFAULT_RETRYABLE: boolean | null;
135
+ constructor(moduleId: string, reason: string, options?: ErrorOptions);
136
+ }
137
+ export declare class InternalError extends ModuleError {
138
+ static readonly DEFAULT_RETRYABLE: boolean | null;
139
+ constructor(message?: string, options?: ErrorOptions);
140
+ }
141
+ /**
142
+ * Base error for all approval-related errors.
143
+ * Carries the full ApprovalResult for inspection by callers.
144
+ */
145
+ export declare class ApprovalError extends ModuleError {
146
+ static readonly DEFAULT_RETRYABLE: boolean | null;
147
+ readonly result: unknown;
148
+ constructor(code: string, message: string, result: unknown, moduleId?: string, options?: ErrorOptions);
149
+ get moduleId(): string | null;
150
+ get reason(): string | null;
151
+ }
152
+ export declare class ApprovalDeniedError extends ApprovalError {
153
+ static readonly DEFAULT_RETRYABLE: boolean | null;
154
+ constructor(result: unknown, moduleId?: string, options?: ErrorOptions);
155
+ }
156
+ export declare class ApprovalTimeoutError extends ApprovalError {
157
+ static readonly DEFAULT_RETRYABLE: boolean | null;
158
+ constructor(result: unknown, moduleId?: string, options?: ErrorOptions);
159
+ }
160
+ export declare class ApprovalPendingError extends ApprovalError {
161
+ static readonly DEFAULT_RETRYABLE: boolean | null;
162
+ constructor(result: unknown, moduleId?: string, options?: ErrorOptions);
163
+ get approvalId(): string | null;
164
+ }
165
+ /**
166
+ * All framework error codes as constants.
167
+ * Use these instead of hardcoding error code strings.
168
+ */
169
+ export declare const ErrorCodes: Readonly<{
170
+ readonly CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND";
171
+ readonly CONFIG_INVALID: "CONFIG_INVALID";
172
+ readonly ACL_RULE_ERROR: "ACL_RULE_ERROR";
173
+ readonly ACL_DENIED: "ACL_DENIED";
174
+ readonly MODULE_NOT_FOUND: "MODULE_NOT_FOUND";
175
+ readonly MODULE_TIMEOUT: "MODULE_TIMEOUT";
176
+ readonly MODULE_LOAD_ERROR: "MODULE_LOAD_ERROR";
177
+ readonly MODULE_EXECUTE_ERROR: "MODULE_EXECUTE_ERROR";
178
+ readonly SCHEMA_VALIDATION_ERROR: "SCHEMA_VALIDATION_ERROR";
179
+ readonly SCHEMA_NOT_FOUND: "SCHEMA_NOT_FOUND";
180
+ readonly SCHEMA_PARSE_ERROR: "SCHEMA_PARSE_ERROR";
181
+ readonly SCHEMA_CIRCULAR_REF: "SCHEMA_CIRCULAR_REF";
182
+ readonly CALL_DEPTH_EXCEEDED: "CALL_DEPTH_EXCEEDED";
183
+ readonly CIRCULAR_CALL: "CIRCULAR_CALL";
184
+ readonly CALL_FREQUENCY_EXCEEDED: "CALL_FREQUENCY_EXCEEDED";
185
+ readonly GENERAL_INVALID_INPUT: "GENERAL_INVALID_INPUT";
186
+ readonly GENERAL_INTERNAL_ERROR: "GENERAL_INTERNAL_ERROR";
187
+ readonly FUNC_MISSING_TYPE_HINT: "FUNC_MISSING_TYPE_HINT";
188
+ readonly FUNC_MISSING_RETURN_TYPE: "FUNC_MISSING_RETURN_TYPE";
189
+ readonly BINDING_INVALID_TARGET: "BINDING_INVALID_TARGET";
190
+ readonly BINDING_MODULE_NOT_FOUND: "BINDING_MODULE_NOT_FOUND";
191
+ readonly BINDING_CALLABLE_NOT_FOUND: "BINDING_CALLABLE_NOT_FOUND";
192
+ readonly BINDING_NOT_CALLABLE: "BINDING_NOT_CALLABLE";
193
+ readonly BINDING_SCHEMA_MISSING: "BINDING_SCHEMA_MISSING";
194
+ readonly BINDING_FILE_INVALID: "BINDING_FILE_INVALID";
195
+ readonly CIRCULAR_DEPENDENCY: "CIRCULAR_DEPENDENCY";
196
+ readonly MIDDLEWARE_CHAIN_ERROR: "MIDDLEWARE_CHAIN_ERROR";
197
+ readonly APPROVAL_DENIED: "APPROVAL_DENIED";
198
+ readonly APPROVAL_TIMEOUT: "APPROVAL_TIMEOUT";
199
+ readonly APPROVAL_PENDING: "APPROVAL_PENDING";
200
+ readonly GENERAL_NOT_IMPLEMENTED: "GENERAL_NOT_IMPLEMENTED";
201
+ readonly DEPENDENCY_NOT_FOUND: "DEPENDENCY_NOT_FOUND";
202
+ }>;
203
+ export type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
204
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}