@smythos/sre 1.5.53 → 1.5.54

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 (223) hide show
  1. package/CHANGELOG +98 -98
  2. package/LICENSE +18 -18
  3. package/README.md +135 -135
  4. package/dist/bundle-analysis-lazy.html +4949 -0
  5. package/dist/bundle-analysis.html +4949 -0
  6. package/dist/index.js +3 -3
  7. package/dist/index.js.map +1 -1
  8. package/dist/types/subsystems/LLMManager/LLM.service/connectors/openai/OpenAIConnector.class.d.ts +1 -6
  9. package/dist/types/utils/package-manager.utils.d.ts +26 -0
  10. package/package.json +1 -1
  11. package/src/Components/APICall/APICall.class.ts +157 -157
  12. package/src/Components/APICall/AccessTokenManager.ts +166 -166
  13. package/src/Components/APICall/ArrayBufferResponse.helper.ts +58 -58
  14. package/src/Components/APICall/OAuth.helper.ts +447 -447
  15. package/src/Components/APICall/mimeTypeCategories.ts +46 -46
  16. package/src/Components/APICall/parseData.ts +167 -167
  17. package/src/Components/APICall/parseHeaders.ts +41 -41
  18. package/src/Components/APICall/parseProxy.ts +68 -68
  19. package/src/Components/APICall/parseUrl.ts +91 -91
  20. package/src/Components/APIEndpoint.class.ts +234 -234
  21. package/src/Components/APIOutput.class.ts +58 -58
  22. package/src/Components/AgentPlugin.class.ts +102 -102
  23. package/src/Components/Async.class.ts +155 -155
  24. package/src/Components/Await.class.ts +90 -90
  25. package/src/Components/Classifier.class.ts +158 -158
  26. package/src/Components/Component.class.ts +132 -132
  27. package/src/Components/ComponentHost.class.ts +38 -38
  28. package/src/Components/DataSourceCleaner.class.ts +92 -92
  29. package/src/Components/DataSourceIndexer.class.ts +181 -181
  30. package/src/Components/DataSourceLookup.class.ts +161 -161
  31. package/src/Components/ECMASandbox.class.ts +71 -71
  32. package/src/Components/FEncDec.class.ts +29 -29
  33. package/src/Components/FHash.class.ts +33 -33
  34. package/src/Components/FSign.class.ts +80 -80
  35. package/src/Components/FSleep.class.ts +25 -25
  36. package/src/Components/FTimestamp.class.ts +25 -25
  37. package/src/Components/FileStore.class.ts +78 -78
  38. package/src/Components/ForEach.class.ts +97 -97
  39. package/src/Components/GPTPlugin.class.ts +70 -70
  40. package/src/Components/GenAILLM.class.ts +586 -586
  41. package/src/Components/HuggingFace.class.ts +314 -314
  42. package/src/Components/Image/imageSettings.config.ts +70 -70
  43. package/src/Components/ImageGenerator.class.ts +502 -502
  44. package/src/Components/JSONFilter.class.ts +54 -54
  45. package/src/Components/LLMAssistant.class.ts +213 -213
  46. package/src/Components/LogicAND.class.ts +28 -28
  47. package/src/Components/LogicAtLeast.class.ts +85 -85
  48. package/src/Components/LogicAtMost.class.ts +86 -86
  49. package/src/Components/LogicOR.class.ts +29 -29
  50. package/src/Components/LogicXOR.class.ts +34 -34
  51. package/src/Components/MCPClient.class.ts +138 -138
  52. package/src/Components/MemoryDeleteKeyVal.class.ts +70 -70
  53. package/src/Components/MemoryReadKeyVal.class.ts +66 -66
  54. package/src/Components/MemoryWriteKeyVal.class.ts +62 -62
  55. package/src/Components/MemoryWriteObject.class.ts +97 -97
  56. package/src/Components/MultimodalLLM.class.ts +128 -128
  57. package/src/Components/OpenAPI.class.ts +72 -72
  58. package/src/Components/PromptGenerator.class.ts +122 -122
  59. package/src/Components/ScrapflyWebScrape.class.ts +159 -159
  60. package/src/Components/ServerlessCode.class.ts +123 -123
  61. package/src/Components/TavilyWebSearch.class.ts +98 -98
  62. package/src/Components/VisionLLM.class.ts +104 -104
  63. package/src/Components/ZapierAction.class.ts +127 -127
  64. package/src/Components/index.ts +97 -97
  65. package/src/Core/AgentProcess.helper.ts +240 -240
  66. package/src/Core/Connector.class.ts +123 -123
  67. package/src/Core/ConnectorsService.ts +197 -197
  68. package/src/Core/DummyConnector.ts +49 -49
  69. package/src/Core/HookService.ts +105 -105
  70. package/src/Core/SmythRuntime.class.ts +235 -235
  71. package/src/Core/SystemEvents.ts +16 -16
  72. package/src/Core/boot.ts +56 -56
  73. package/src/config.ts +15 -15
  74. package/src/constants.ts +126 -126
  75. package/src/data/hugging-face.params.json +579 -579
  76. package/src/helpers/AWSLambdaCode.helper.ts +590 -590
  77. package/src/helpers/BinaryInput.helper.ts +331 -331
  78. package/src/helpers/Conversation.helper.ts +1119 -1119
  79. package/src/helpers/ECMASandbox.helper.ts +54 -54
  80. package/src/helpers/JsonContent.helper.ts +97 -97
  81. package/src/helpers/LocalCache.helper.ts +97 -97
  82. package/src/helpers/Log.helper.ts +274 -274
  83. package/src/helpers/OpenApiParser.helper.ts +150 -150
  84. package/src/helpers/S3Cache.helper.ts +147 -147
  85. package/src/helpers/SmythURI.helper.ts +5 -5
  86. package/src/helpers/Sysconfig.helper.ts +77 -77
  87. package/src/helpers/TemplateString.helper.ts +243 -243
  88. package/src/helpers/TypeChecker.helper.ts +329 -329
  89. package/src/index.ts +3 -3
  90. package/src/index.ts.bak +3 -3
  91. package/src/subsystems/AgentManager/Agent.class.ts +1114 -1114
  92. package/src/subsystems/AgentManager/Agent.helper.ts +3 -3
  93. package/src/subsystems/AgentManager/AgentData.service/AgentDataConnector.ts +230 -230
  94. package/src/subsystems/AgentManager/AgentData.service/connectors/CLIAgentDataConnector.class.ts +66 -66
  95. package/src/subsystems/AgentManager/AgentData.service/connectors/LocalAgentDataConnector.class.ts +142 -142
  96. package/src/subsystems/AgentManager/AgentData.service/connectors/NullAgentData.class.ts +39 -39
  97. package/src/subsystems/AgentManager/AgentData.service/index.ts +18 -18
  98. package/src/subsystems/AgentManager/AgentLogger.class.ts +301 -297
  99. package/src/subsystems/AgentManager/AgentRequest.class.ts +51 -51
  100. package/src/subsystems/AgentManager/AgentRuntime.class.ts +559 -559
  101. package/src/subsystems/AgentManager/AgentSSE.class.ts +101 -101
  102. package/src/subsystems/AgentManager/AgentSettings.class.ts +52 -52
  103. package/src/subsystems/AgentManager/Component.service/ComponentConnector.ts +32 -32
  104. package/src/subsystems/AgentManager/Component.service/connectors/LocalComponentConnector.class.ts +60 -60
  105. package/src/subsystems/AgentManager/Component.service/index.ts +11 -11
  106. package/src/subsystems/AgentManager/EmbodimentSettings.class.ts +47 -47
  107. package/src/subsystems/AgentManager/ForkedAgent.class.ts +154 -154
  108. package/src/subsystems/AgentManager/OSResourceMonitor.ts +77 -77
  109. package/src/subsystems/ComputeManager/Code.service/CodeConnector.ts +98 -98
  110. package/src/subsystems/ComputeManager/Code.service/connectors/AWSLambdaCode.class.ts +172 -172
  111. package/src/subsystems/ComputeManager/Code.service/connectors/ECMASandbox.class.ts +131 -131
  112. package/src/subsystems/ComputeManager/Code.service/index.ts +13 -13
  113. package/src/subsystems/IO/CLI.service/CLIConnector.ts +47 -47
  114. package/src/subsystems/IO/CLI.service/index.ts +9 -9
  115. package/src/subsystems/IO/Log.service/LogConnector.ts +32 -32
  116. package/src/subsystems/IO/Log.service/connectors/ConsoleLog.class.ts +28 -28
  117. package/src/subsystems/IO/Log.service/index.ts +13 -13
  118. package/src/subsystems/IO/NKV.service/NKVConnector.ts +43 -43
  119. package/src/subsystems/IO/NKV.service/connectors/NKVLocalStorage.class.ts +234 -234
  120. package/src/subsystems/IO/NKV.service/connectors/NKVRAM.class.ts +204 -204
  121. package/src/subsystems/IO/NKV.service/connectors/NKVRedis.class.ts +182 -182
  122. package/src/subsystems/IO/NKV.service/index.ts +14 -14
  123. package/src/subsystems/IO/Router.service/RouterConnector.ts +21 -21
  124. package/src/subsystems/IO/Router.service/connectors/ExpressRouter.class.ts +48 -48
  125. package/src/subsystems/IO/Router.service/connectors/NullRouter.class.ts +40 -40
  126. package/src/subsystems/IO/Router.service/index.ts +11 -11
  127. package/src/subsystems/IO/Storage.service/SmythFS.class.ts +489 -489
  128. package/src/subsystems/IO/Storage.service/StorageConnector.ts +66 -66
  129. package/src/subsystems/IO/Storage.service/connectors/LocalStorage.class.ts +327 -327
  130. package/src/subsystems/IO/Storage.service/connectors/S3Storage.class.ts +482 -482
  131. package/src/subsystems/IO/Storage.service/index.ts +13 -13
  132. package/src/subsystems/IO/VectorDB.service/VectorDBConnector.ts +108 -108
  133. package/src/subsystems/IO/VectorDB.service/connectors/MilvusVectorDB.class.ts +454 -454
  134. package/src/subsystems/IO/VectorDB.service/connectors/PineconeVectorDB.class.ts +384 -384
  135. package/src/subsystems/IO/VectorDB.service/connectors/RAMVecrtorDB.class.ts +421 -421
  136. package/src/subsystems/IO/VectorDB.service/embed/BaseEmbedding.ts +107 -107
  137. package/src/subsystems/IO/VectorDB.service/embed/OpenAIEmbedding.ts +109 -109
  138. package/src/subsystems/IO/VectorDB.service/embed/index.ts +21 -21
  139. package/src/subsystems/IO/VectorDB.service/index.ts +14 -14
  140. package/src/subsystems/LLMManager/LLM.helper.ts +251 -251
  141. package/src/subsystems/LLMManager/LLM.inference.ts +339 -339
  142. package/src/subsystems/LLMManager/LLM.service/LLMConnector.ts +489 -489
  143. package/src/subsystems/LLMManager/LLM.service/LLMCredentials.helper.ts +171 -171
  144. package/src/subsystems/LLMManager/LLM.service/connectors/Anthropic.class.ts +659 -659
  145. package/src/subsystems/LLMManager/LLM.service/connectors/Bedrock.class.ts +400 -400
  146. package/src/subsystems/LLMManager/LLM.service/connectors/Echo.class.ts +77 -77
  147. package/src/subsystems/LLMManager/LLM.service/connectors/GoogleAI.class.ts +757 -757
  148. package/src/subsystems/LLMManager/LLM.service/connectors/Groq.class.ts +304 -304
  149. package/src/subsystems/LLMManager/LLM.service/connectors/Perplexity.class.ts +250 -250
  150. package/src/subsystems/LLMManager/LLM.service/connectors/VertexAI.class.ts +423 -423
  151. package/src/subsystems/LLMManager/LLM.service/connectors/openai/OpenAIConnector.class.ts +488 -488
  152. package/src/subsystems/LLMManager/LLM.service/connectors/openai/apiInterfaces/ChatCompletionsApiInterface.ts +524 -524
  153. package/src/subsystems/LLMManager/LLM.service/connectors/openai/apiInterfaces/OpenAIApiInterface.ts +100 -100
  154. package/src/subsystems/LLMManager/LLM.service/connectors/openai/apiInterfaces/OpenAIApiInterfaceFactory.ts +81 -81
  155. package/src/subsystems/LLMManager/LLM.service/connectors/openai/apiInterfaces/ResponsesApiInterface.ts +1145 -1145
  156. package/src/subsystems/LLMManager/LLM.service/connectors/openai/apiInterfaces/constants.ts +13 -13
  157. package/src/subsystems/LLMManager/LLM.service/connectors/openai/apiInterfaces/index.ts +4 -4
  158. package/src/subsystems/LLMManager/LLM.service/connectors/openai/apiInterfaces/utils.ts +11 -11
  159. package/src/subsystems/LLMManager/LLM.service/connectors/openai/types.ts +32 -32
  160. package/src/subsystems/LLMManager/LLM.service/connectors/xAI.class.ts +471 -471
  161. package/src/subsystems/LLMManager/LLM.service/index.ts +44 -44
  162. package/src/subsystems/LLMManager/ModelsProvider.service/ModelsProviderConnector.ts +300 -300
  163. package/src/subsystems/LLMManager/ModelsProvider.service/connectors/JSONModelsProvider.class.ts +252 -252
  164. package/src/subsystems/LLMManager/ModelsProvider.service/index.ts +11 -11
  165. package/src/subsystems/LLMManager/custom-models.ts +854 -854
  166. package/src/subsystems/LLMManager/models.ts +2540 -2540
  167. package/src/subsystems/LLMManager/paramMappings.ts +69 -69
  168. package/src/subsystems/MemoryManager/Cache.service/CacheConnector.ts +86 -86
  169. package/src/subsystems/MemoryManager/Cache.service/connectors/LocalStorageCache.class.ts +297 -297
  170. package/src/subsystems/MemoryManager/Cache.service/connectors/RAMCache.class.ts +201 -201
  171. package/src/subsystems/MemoryManager/Cache.service/connectors/RedisCache.class.ts +252 -252
  172. package/src/subsystems/MemoryManager/Cache.service/connectors/S3Cache.class.ts +373 -373
  173. package/src/subsystems/MemoryManager/Cache.service/index.ts +15 -15
  174. package/src/subsystems/MemoryManager/LLMCache.ts +72 -72
  175. package/src/subsystems/MemoryManager/LLMContext.ts +124 -124
  176. package/src/subsystems/MemoryManager/LLMMemory.service/LLMMemoryConnector.ts +26 -26
  177. package/src/subsystems/MemoryManager/RuntimeContext.ts +266 -266
  178. package/src/subsystems/Security/AccessControl/ACL.class.ts +208 -208
  179. package/src/subsystems/Security/AccessControl/AccessCandidate.class.ts +82 -82
  180. package/src/subsystems/Security/AccessControl/AccessRequest.class.ts +52 -52
  181. package/src/subsystems/Security/Account.service/AccountConnector.ts +44 -44
  182. package/src/subsystems/Security/Account.service/connectors/AWSAccount.class.ts +76 -76
  183. package/src/subsystems/Security/Account.service/connectors/DummyAccount.class.ts +130 -130
  184. package/src/subsystems/Security/Account.service/connectors/JSONFileAccount.class.ts +159 -159
  185. package/src/subsystems/Security/Account.service/index.ts +14 -14
  186. package/src/subsystems/Security/Credentials.helper.ts +62 -62
  187. package/src/subsystems/Security/ManagedVault.service/ManagedVaultConnector.ts +38 -38
  188. package/src/subsystems/Security/ManagedVault.service/connectors/NullManagedVault.class.ts +53 -53
  189. package/src/subsystems/Security/ManagedVault.service/connectors/SecretManagerManagedVault.ts +154 -154
  190. package/src/subsystems/Security/ManagedVault.service/index.ts +12 -12
  191. package/src/subsystems/Security/SecureConnector.class.ts +110 -110
  192. package/src/subsystems/Security/Vault.service/Vault.helper.ts +30 -30
  193. package/src/subsystems/Security/Vault.service/VaultConnector.ts +29 -29
  194. package/src/subsystems/Security/Vault.service/connectors/HashicorpVault.class.ts +46 -46
  195. package/src/subsystems/Security/Vault.service/connectors/JSONFileVault.class.ts +221 -221
  196. package/src/subsystems/Security/Vault.service/connectors/NullVault.class.ts +54 -54
  197. package/src/subsystems/Security/Vault.service/connectors/SecretsManager.class.ts +140 -140
  198. package/src/subsystems/Security/Vault.service/index.ts +12 -12
  199. package/src/types/ACL.types.ts +104 -104
  200. package/src/types/AWS.types.ts +10 -10
  201. package/src/types/Agent.types.ts +61 -61
  202. package/src/types/AgentLogger.types.ts +17 -17
  203. package/src/types/Cache.types.ts +1 -1
  204. package/src/types/Common.types.ts +2 -2
  205. package/src/types/LLM.types.ts +496 -496
  206. package/src/types/Redis.types.ts +8 -8
  207. package/src/types/SRE.types.ts +64 -64
  208. package/src/types/Security.types.ts +14 -14
  209. package/src/types/Storage.types.ts +5 -5
  210. package/src/types/VectorDB.types.ts +86 -86
  211. package/src/utils/base64.utils.ts +275 -275
  212. package/src/utils/cli.utils.ts +68 -68
  213. package/src/utils/data.utils.ts +322 -322
  214. package/src/utils/date-time.utils.ts +22 -22
  215. package/src/utils/general.utils.ts +238 -238
  216. package/src/utils/index.ts +12 -12
  217. package/src/utils/lazy-client.ts +261 -261
  218. package/src/utils/numbers.utils.ts +13 -13
  219. package/src/utils/oauth.utils.ts +35 -35
  220. package/src/utils/string.utils.ts +414 -414
  221. package/src/utils/url.utils.ts +19 -19
  222. package/src/utils/validation.utils.ts +74 -74
  223. package/dist/types/subsystems/LLMManager/ModelsProvider.service/connectors/SmythModelsProvider.class.d.ts +0 -39
@@ -1,49 +1,49 @@
1
- import { Logger } from '../helpers/Log.helper';
2
- import { getFormattedStackTrace, printStackTrace } from '../utils';
3
-
4
- /**
5
- * DummyConnector is a placeholder for unimplemented connectors, it logs a warning when a method is called in order to help developers identify missing connectors
6
- */
7
- export const DummyConnector: any = (name: string) => {
8
- const logger = Logger(`DummyConnector<${name}>`);
9
- return new Proxy(
10
- {},
11
- {
12
- get: function (target, prop, receiver) {
13
- //check if we are accessing the valid property
14
- if (prop === 'valid') {
15
- return false; //when DummyConnector is used it means that the main connector failed to load
16
- }
17
-
18
- // Check if the property being accessed is a function
19
- if (typeof target[prop] === 'function') {
20
- return target[prop];
21
- } else {
22
- // Return a function that logs "unavailable"
23
- return function (...args: any[]) {
24
- const argsString =
25
- args.length > 0
26
- ? args
27
- .map((arg) => {
28
- if (typeof arg === 'object') return JSON.stringify(arg, null, 0).slice(0, 50) + '...';
29
- if (typeof arg === 'string') return `"${arg.slice(0, 50)}..."`;
30
- if (typeof arg === 'number') return arg.toString();
31
- if (typeof arg === 'boolean') return arg.toString();
32
- if (typeof arg === 'function') return arg.toString();
33
- if (typeof arg === 'symbol') return arg.toString();
34
- if (typeof arg === 'undefined') return 'undefined';
35
-
36
- return String(arg);
37
- })
38
- .join(', ')
39
- : '(no arguments)';
40
-
41
- logger.warn(`[!!] Unimplemented Connector tried to call: ${name}.${prop.toString()}(${argsString})`);
42
-
43
- printStackTrace(logger, 3, 1); //the argument 1 means that we skip one more strack element because we are calling printStackTrace from an anonymous function
44
- };
45
- }
46
- },
47
- },
48
- );
49
- };
1
+ import { Logger } from '../helpers/Log.helper';
2
+ import { getFormattedStackTrace, printStackTrace } from '../utils';
3
+
4
+ /**
5
+ * DummyConnector is a placeholder for unimplemented connectors, it logs a warning when a method is called in order to help developers identify missing connectors
6
+ */
7
+ export const DummyConnector: any = (name: string) => {
8
+ const logger = Logger(`DummyConnector<${name}>`);
9
+ return new Proxy(
10
+ {},
11
+ {
12
+ get: function (target, prop, receiver) {
13
+ //check if we are accessing the valid property
14
+ if (prop === 'valid') {
15
+ return false; //when DummyConnector is used it means that the main connector failed to load
16
+ }
17
+
18
+ // Check if the property being accessed is a function
19
+ if (typeof target[prop] === 'function') {
20
+ return target[prop];
21
+ } else {
22
+ // Return a function that logs "unavailable"
23
+ return function (...args: any[]) {
24
+ const argsString =
25
+ args.length > 0
26
+ ? args
27
+ .map((arg) => {
28
+ if (typeof arg === 'object') return JSON.stringify(arg, null, 0).slice(0, 50) + '...';
29
+ if (typeof arg === 'string') return `"${arg.slice(0, 50)}..."`;
30
+ if (typeof arg === 'number') return arg.toString();
31
+ if (typeof arg === 'boolean') return arg.toString();
32
+ if (typeof arg === 'function') return arg.toString();
33
+ if (typeof arg === 'symbol') return arg.toString();
34
+ if (typeof arg === 'undefined') return 'undefined';
35
+
36
+ return String(arg);
37
+ })
38
+ .join(', ')
39
+ : '(no arguments)';
40
+
41
+ logger.warn(`[!!] Unimplemented Connector tried to call: ${name}.${prop.toString()}(${argsString})`);
42
+
43
+ printStackTrace(logger, 3, 1); //the argument 1 means that we skip one more strack element because we are calling printStackTrace from an anonymous function
44
+ };
45
+ }
46
+ },
47
+ },
48
+ );
49
+ };
@@ -1,105 +1,105 @@
1
- // Type definition for hook callbacks
2
- type HookCallback = (...args: any[]) => void;
3
-
4
- // Store hooks in a map where each hook name can have multiple callbacks
5
- const hooks: { [key: string]: HookCallback[] } = {};
6
-
7
- export class HookService {
8
- /**
9
- * Register a new hook callback for a given hook name
10
- * @param hookName The name of the hook to register
11
- * @param callback The callback function to execute when the hook is triggered
12
- */
13
- static register(hookName: string, callback: HookCallback): void {
14
- if (typeof callback !== 'function') {
15
- throw new Error('Hook callback must be a function');
16
- }
17
-
18
- if (!hooks[hookName]) {
19
- hooks[hookName] = [];
20
- }
21
-
22
- hooks[hookName].push(callback);
23
- }
24
-
25
- static trigger(hookName: string, ...args: any[]) {
26
- if (hooks[hookName]) {
27
- hooks[hookName].forEach((callback) => callback(...args));
28
- }
29
- }
30
- }
31
-
32
- /**
33
- * Decorator function that executes registered hooks before the decorated method
34
- * @param hookName The name of the hook to trigger
35
- */
36
- export function hook(hookName: string) {
37
- return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
38
- const originalMethod = descriptor.value;
39
-
40
- descriptor.value = function (...args: any[]) {
41
- // Execute all registered hooks for this hook name
42
- if (hooks[hookName]) {
43
- hooks[hookName].forEach((callback) => {
44
- callback.apply(this, args);
45
- });
46
- }
47
-
48
- // Call the original method
49
- return originalMethod.apply(this, args);
50
- };
51
-
52
- return descriptor;
53
- };
54
- }
55
-
56
- /**
57
- * Decorator function that executes registered hooks asynchronously before the decorated method
58
- * @param hookName The name of the hook to trigger
59
- */
60
- export function hookAsync(hookName: string) {
61
- return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
62
- const originalMethod = descriptor.value;
63
-
64
- descriptor.value = async function (...args: any[]) {
65
- // Execute all registered hooks for this hook name
66
- if (hooks[hookName]) {
67
- // Wait for all hooks to complete before proceeding
68
- await Promise.all(hooks[hookName].map((callback) => callback.apply(this, args)));
69
- }
70
-
71
- // Call the original method
72
- return originalMethod.apply(this, args);
73
- };
74
-
75
- return descriptor;
76
- };
77
- }
78
-
79
- /**
80
- * Decorator function that executes registered hooks asynchronously before the decorated method
81
- * @param hookName The name of the hook to trigger
82
- * @param contextFn Optional function to extract additional context from the class instance
83
- */
84
- export function hookAsyncWithContext(hookName: string, contextFn?: (instance: any) => Record<string, any>) {
85
- return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
86
- const originalMethod = descriptor.value;
87
-
88
- descriptor.value = async function (...args: any[]) {
89
- // Execute all registered hooks for this hook name
90
- if (hooks[hookName]) {
91
- // Get additional context if contextFn is provided
92
- const additionalContext = typeof contextFn === 'function' ? await contextFn(this) : {};
93
-
94
- // Wait for all hooks to complete before proceeding
95
- // We need to prepend the additional context before the args; otherwise, optional parameters may cause incorrect argument mapping.
96
- await Promise.all(hooks[hookName].map((callback) => callback.apply(this, [additionalContext, ...args])));
97
- }
98
-
99
- // Call the original method
100
- return originalMethod.apply(this, args);
101
- };
102
-
103
- return descriptor;
104
- };
105
- }
1
+ // Type definition for hook callbacks
2
+ type HookCallback = (...args: any[]) => void;
3
+
4
+ // Store hooks in a map where each hook name can have multiple callbacks
5
+ const hooks: { [key: string]: HookCallback[] } = {};
6
+
7
+ export class HookService {
8
+ /**
9
+ * Register a new hook callback for a given hook name
10
+ * @param hookName The name of the hook to register
11
+ * @param callback The callback function to execute when the hook is triggered
12
+ */
13
+ static register(hookName: string, callback: HookCallback): void {
14
+ if (typeof callback !== 'function') {
15
+ throw new Error('Hook callback must be a function');
16
+ }
17
+
18
+ if (!hooks[hookName]) {
19
+ hooks[hookName] = [];
20
+ }
21
+
22
+ hooks[hookName].push(callback);
23
+ }
24
+
25
+ static trigger(hookName: string, ...args: any[]) {
26
+ if (hooks[hookName]) {
27
+ hooks[hookName].forEach((callback) => callback(...args));
28
+ }
29
+ }
30
+ }
31
+
32
+ /**
33
+ * Decorator function that executes registered hooks before the decorated method
34
+ * @param hookName The name of the hook to trigger
35
+ */
36
+ export function hook(hookName: string) {
37
+ return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
38
+ const originalMethod = descriptor.value;
39
+
40
+ descriptor.value = function (...args: any[]) {
41
+ // Execute all registered hooks for this hook name
42
+ if (hooks[hookName]) {
43
+ hooks[hookName].forEach((callback) => {
44
+ callback.apply(this, args);
45
+ });
46
+ }
47
+
48
+ // Call the original method
49
+ return originalMethod.apply(this, args);
50
+ };
51
+
52
+ return descriptor;
53
+ };
54
+ }
55
+
56
+ /**
57
+ * Decorator function that executes registered hooks asynchronously before the decorated method
58
+ * @param hookName The name of the hook to trigger
59
+ */
60
+ export function hookAsync(hookName: string) {
61
+ return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
62
+ const originalMethod = descriptor.value;
63
+
64
+ descriptor.value = async function (...args: any[]) {
65
+ // Execute all registered hooks for this hook name
66
+ if (hooks[hookName]) {
67
+ // Wait for all hooks to complete before proceeding
68
+ await Promise.all(hooks[hookName].map((callback) => callback.apply(this, args)));
69
+ }
70
+
71
+ // Call the original method
72
+ return originalMethod.apply(this, args);
73
+ };
74
+
75
+ return descriptor;
76
+ };
77
+ }
78
+
79
+ /**
80
+ * Decorator function that executes registered hooks asynchronously before the decorated method
81
+ * @param hookName The name of the hook to trigger
82
+ * @param contextFn Optional function to extract additional context from the class instance
83
+ */
84
+ export function hookAsyncWithContext(hookName: string, contextFn?: (instance: any) => Record<string, any>) {
85
+ return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
86
+ const originalMethod = descriptor.value;
87
+
88
+ descriptor.value = async function (...args: any[]) {
89
+ // Execute all registered hooks for this hook name
90
+ if (hooks[hookName]) {
91
+ // Get additional context if contextFn is provided
92
+ const additionalContext = typeof contextFn === 'function' ? await contextFn(this) : {};
93
+
94
+ // Wait for all hooks to complete before proceeding
95
+ // We need to prepend the additional context before the args; otherwise, optional parameters may cause incorrect argument mapping.
96
+ await Promise.all(hooks[hookName].map((callback) => callback.apply(this, [additionalContext, ...args])));
97
+ }
98
+
99
+ // Call the original method
100
+ return originalMethod.apply(this, args);
101
+ };
102
+
103
+ return descriptor;
104
+ };
105
+ }