@smythos/sre 1.5.1 → 1.5.4

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 (193) hide show
  1. package/LICENSE +18 -0
  2. package/dist/index.js +22329 -4
  3. package/dist/index.js.map +1 -1
  4. package/dist/types/subsystems/IO/VectorDB.service/connectors/PineconeVectorDB.class.d.ts +2 -2
  5. package/dist/types/subsystems/IO/VectorDB.service/embed/BaseEmbedding.d.ts +11 -7
  6. package/dist/types/types/VectorDB.types.d.ts +13 -11
  7. package/package.json +102 -127
  8. package/src/Components/APICall/APICall.class.ts +155 -0
  9. package/src/Components/APICall/AccessTokenManager.ts +130 -0
  10. package/src/Components/APICall/ArrayBufferResponse.helper.ts +58 -0
  11. package/src/Components/APICall/OAuth.helper.ts +294 -0
  12. package/src/Components/APICall/mimeTypeCategories.ts +46 -0
  13. package/src/Components/APICall/parseData.ts +167 -0
  14. package/src/Components/APICall/parseHeaders.ts +41 -0
  15. package/src/Components/APICall/parseProxy.ts +68 -0
  16. package/src/Components/APICall/parseUrl.ts +91 -0
  17. package/src/Components/APIEndpoint.class.ts +234 -0
  18. package/src/Components/APIOutput.class.ts +58 -0
  19. package/src/Components/AgentPlugin.class.ts +102 -0
  20. package/src/Components/Async.class.ts +155 -0
  21. package/src/Components/Await.class.ts +90 -0
  22. package/src/Components/Classifier.class.ts +158 -0
  23. package/src/Components/Component.class.ts +94 -0
  24. package/src/Components/ComponentHost.class.ts +38 -0
  25. package/src/Components/DataSourceCleaner.class.ts +92 -0
  26. package/src/Components/DataSourceIndexer.class.ts +181 -0
  27. package/src/Components/DataSourceLookup.class.ts +141 -0
  28. package/src/Components/FEncDec.class.ts +29 -0
  29. package/src/Components/FHash.class.ts +33 -0
  30. package/src/Components/FSign.class.ts +80 -0
  31. package/src/Components/FSleep.class.ts +25 -0
  32. package/src/Components/FTimestamp.class.ts +25 -0
  33. package/src/Components/FileStore.class.ts +75 -0
  34. package/src/Components/ForEach.class.ts +97 -0
  35. package/src/Components/GPTPlugin.class.ts +70 -0
  36. package/src/Components/GenAILLM.class.ts +395 -0
  37. package/src/Components/HuggingFace.class.ts +314 -0
  38. package/src/Components/Image/imageSettings.config.ts +70 -0
  39. package/src/Components/ImageGenerator.class.ts +407 -0
  40. package/src/Components/JSONFilter.class.ts +54 -0
  41. package/src/Components/LLMAssistant.class.ts +213 -0
  42. package/src/Components/LogicAND.class.ts +28 -0
  43. package/src/Components/LogicAtLeast.class.ts +85 -0
  44. package/src/Components/LogicAtMost.class.ts +86 -0
  45. package/src/Components/LogicOR.class.ts +29 -0
  46. package/src/Components/LogicXOR.class.ts +34 -0
  47. package/src/Components/MCPClient.class.ts +112 -0
  48. package/src/Components/PromptGenerator.class.ts +122 -0
  49. package/src/Components/ScrapflyWebScrape.class.ts +159 -0
  50. package/src/Components/TavilyWebSearch.class.ts +98 -0
  51. package/src/Components/index.ts +77 -0
  52. package/src/Core/AgentProcess.helper.ts +240 -0
  53. package/src/Core/Connector.class.ts +123 -0
  54. package/src/Core/ConnectorsService.ts +192 -0
  55. package/src/Core/DummyConnector.ts +49 -0
  56. package/src/Core/HookService.ts +105 -0
  57. package/src/Core/SmythRuntime.class.ts +292 -0
  58. package/src/Core/SystemEvents.ts +15 -0
  59. package/src/Core/boot.ts +55 -0
  60. package/src/config.ts +15 -0
  61. package/src/constants.ts +125 -0
  62. package/src/data/hugging-face.params.json +580 -0
  63. package/src/helpers/BinaryInput.helper.ts +324 -0
  64. package/src/helpers/Conversation.helper.ts +1094 -0
  65. package/src/helpers/JsonContent.helper.ts +97 -0
  66. package/src/helpers/LocalCache.helper.ts +97 -0
  67. package/src/helpers/Log.helper.ts +234 -0
  68. package/src/helpers/OpenApiParser.helper.ts +150 -0
  69. package/src/helpers/S3Cache.helper.ts +129 -0
  70. package/src/helpers/SmythURI.helper.ts +5 -0
  71. package/src/helpers/TemplateString.helper.ts +243 -0
  72. package/src/helpers/TypeChecker.helper.ts +329 -0
  73. package/src/index.ts +179 -0
  74. package/src/index.ts.bak +179 -0
  75. package/src/subsystems/AgentManager/Agent.class.ts +1108 -0
  76. package/src/subsystems/AgentManager/Agent.helper.ts +3 -0
  77. package/src/subsystems/AgentManager/AgentData.service/AgentDataConnector.ts +230 -0
  78. package/src/subsystems/AgentManager/AgentData.service/connectors/CLIAgentDataConnector.class.ts +66 -0
  79. package/src/subsystems/AgentManager/AgentData.service/connectors/LocalAgentDataConnector.class.ts +142 -0
  80. package/src/subsystems/AgentManager/AgentData.service/connectors/NullAgentData.class.ts +39 -0
  81. package/src/subsystems/AgentManager/AgentData.service/index.ts +18 -0
  82. package/src/subsystems/AgentManager/AgentLogger.class.ts +297 -0
  83. package/src/subsystems/AgentManager/AgentRequest.class.ts +51 -0
  84. package/src/subsystems/AgentManager/AgentRuntime.class.ts +559 -0
  85. package/src/subsystems/AgentManager/AgentSSE.class.ts +101 -0
  86. package/src/subsystems/AgentManager/AgentSettings.class.ts +52 -0
  87. package/src/subsystems/AgentManager/Component.service/ComponentConnector.ts +32 -0
  88. package/src/subsystems/AgentManager/Component.service/connectors/LocalComponentConnector.class.ts +59 -0
  89. package/src/subsystems/AgentManager/Component.service/index.ts +11 -0
  90. package/src/subsystems/AgentManager/EmbodimentSettings.class.ts +47 -0
  91. package/src/subsystems/AgentManager/ForkedAgent.class.ts +153 -0
  92. package/src/subsystems/AgentManager/OSResourceMonitor.ts +77 -0
  93. package/src/subsystems/ComputeManager/Code.service/CodeConnector.ts +99 -0
  94. package/src/subsystems/ComputeManager/Code.service/connectors/AWSLambdaCode.class.ts +63 -0
  95. package/src/subsystems/ComputeManager/Code.service/index.ts +11 -0
  96. package/src/subsystems/IO/CLI.service/CLIConnector.ts +47 -0
  97. package/src/subsystems/IO/CLI.service/index.ts +9 -0
  98. package/src/subsystems/IO/Log.service/LogConnector.ts +32 -0
  99. package/src/subsystems/IO/Log.service/connectors/ConsoleLog.class.ts +28 -0
  100. package/src/subsystems/IO/Log.service/index.ts +13 -0
  101. package/src/subsystems/IO/NKV.service/NKVConnector.ts +41 -0
  102. package/src/subsystems/IO/NKV.service/connectors/NKVRAM.class.ts +204 -0
  103. package/src/subsystems/IO/NKV.service/connectors/NKVRedis.class.ts +182 -0
  104. package/src/subsystems/IO/NKV.service/index.ts +12 -0
  105. package/src/subsystems/IO/Router.service/RouterConnector.ts +21 -0
  106. package/src/subsystems/IO/Router.service/connectors/ExpressRouter.class.ts +48 -0
  107. package/src/subsystems/IO/Router.service/connectors/NullRouter.class.ts +40 -0
  108. package/src/subsystems/IO/Router.service/index.ts +11 -0
  109. package/src/subsystems/IO/Storage.service/SmythFS.class.ts +472 -0
  110. package/src/subsystems/IO/Storage.service/StorageConnector.ts +66 -0
  111. package/src/subsystems/IO/Storage.service/connectors/LocalStorage.class.ts +305 -0
  112. package/src/subsystems/IO/Storage.service/connectors/S3Storage.class.ts +418 -0
  113. package/src/subsystems/IO/Storage.service/index.ts +13 -0
  114. package/src/subsystems/IO/VectorDB.service/VectorDBConnector.ts +108 -0
  115. package/src/subsystems/IO/VectorDB.service/connectors/MilvusVectorDB.class.ts +454 -0
  116. package/src/subsystems/IO/VectorDB.service/connectors/PineconeVectorDB.class.ts +384 -0
  117. package/src/subsystems/IO/VectorDB.service/connectors/RAMVecrtorDB.class.ts +421 -0
  118. package/src/subsystems/IO/VectorDB.service/embed/BaseEmbedding.ts +107 -0
  119. package/src/subsystems/IO/VectorDB.service/embed/OpenAIEmbedding.ts +109 -0
  120. package/src/subsystems/IO/VectorDB.service/embed/index.ts +21 -0
  121. package/src/subsystems/IO/VectorDB.service/index.ts +14 -0
  122. package/src/subsystems/LLMManager/LLM.helper.ts +221 -0
  123. package/src/subsystems/LLMManager/LLM.inference.ts +335 -0
  124. package/src/subsystems/LLMManager/LLM.service/LLMConnector.ts +375 -0
  125. package/src/subsystems/LLMManager/LLM.service/LLMCredentials.helper.ts +145 -0
  126. package/src/subsystems/LLMManager/LLM.service/connectors/Anthropic.class.ts +632 -0
  127. package/src/subsystems/LLMManager/LLM.service/connectors/Bedrock.class.ts +405 -0
  128. package/src/subsystems/LLMManager/LLM.service/connectors/Echo.class.ts +81 -0
  129. package/src/subsystems/LLMManager/LLM.service/connectors/GoogleAI.class.ts +689 -0
  130. package/src/subsystems/LLMManager/LLM.service/connectors/Groq.class.ts +257 -0
  131. package/src/subsystems/LLMManager/LLM.service/connectors/OpenAI.class.ts +848 -0
  132. package/src/subsystems/LLMManager/LLM.service/connectors/Perplexity.class.ts +255 -0
  133. package/src/subsystems/LLMManager/LLM.service/connectors/VertexAI.class.ts +193 -0
  134. package/src/subsystems/LLMManager/LLM.service/index.ts +43 -0
  135. package/src/subsystems/LLMManager/ModelsProvider.service/ModelsProviderConnector.ts +281 -0
  136. package/src/subsystems/LLMManager/ModelsProvider.service/connectors/SmythModelsProvider.class.ts +229 -0
  137. package/src/subsystems/LLMManager/ModelsProvider.service/index.ts +11 -0
  138. package/src/subsystems/LLMManager/custom-models.ts +854 -0
  139. package/src/subsystems/LLMManager/models.ts +2539 -0
  140. package/src/subsystems/LLMManager/paramMappings.ts +69 -0
  141. package/src/subsystems/MemoryManager/Cache.service/CacheConnector.ts +86 -0
  142. package/src/subsystems/MemoryManager/Cache.service/connectors/LocalStorageCache.class.ts +297 -0
  143. package/src/subsystems/MemoryManager/Cache.service/connectors/RAMCache.class.ts +201 -0
  144. package/src/subsystems/MemoryManager/Cache.service/connectors/RedisCache.class.ts +252 -0
  145. package/src/subsystems/MemoryManager/Cache.service/connectors/S3Cache.class.ts +373 -0
  146. package/src/subsystems/MemoryManager/Cache.service/index.ts +15 -0
  147. package/src/subsystems/MemoryManager/LLMCache.ts +72 -0
  148. package/src/subsystems/MemoryManager/LLMContext.ts +125 -0
  149. package/src/subsystems/MemoryManager/RuntimeContext.ts +249 -0
  150. package/src/subsystems/Security/AccessControl/ACL.class.ts +208 -0
  151. package/src/subsystems/Security/AccessControl/AccessCandidate.class.ts +76 -0
  152. package/src/subsystems/Security/AccessControl/AccessRequest.class.ts +52 -0
  153. package/src/subsystems/Security/Account.service/AccountConnector.ts +41 -0
  154. package/src/subsystems/Security/Account.service/connectors/AWSAccount.class.ts +76 -0
  155. package/src/subsystems/Security/Account.service/connectors/DummyAccount.class.ts +130 -0
  156. package/src/subsystems/Security/Account.service/connectors/JSONFileAccount.class.ts +159 -0
  157. package/src/subsystems/Security/Account.service/index.ts +14 -0
  158. package/src/subsystems/Security/Credentials.helper.ts +62 -0
  159. package/src/subsystems/Security/ManagedVault.service/ManagedVaultConnector.ts +34 -0
  160. package/src/subsystems/Security/ManagedVault.service/connectors/NullManagedVault.class.ts +57 -0
  161. package/src/subsystems/Security/ManagedVault.service/connectors/SecretManagerManagedVault.ts +154 -0
  162. package/src/subsystems/Security/ManagedVault.service/index.ts +12 -0
  163. package/src/subsystems/Security/SecureConnector.class.ts +110 -0
  164. package/src/subsystems/Security/Vault.service/Vault.helper.ts +30 -0
  165. package/src/subsystems/Security/Vault.service/VaultConnector.ts +26 -0
  166. package/src/subsystems/Security/Vault.service/connectors/HashicorpVault.class.ts +46 -0
  167. package/src/subsystems/Security/Vault.service/connectors/JSONFileVault.class.ts +166 -0
  168. package/src/subsystems/Security/Vault.service/connectors/NullVault.class.ts +54 -0
  169. package/src/subsystems/Security/Vault.service/connectors/SecretsManager.class.ts +140 -0
  170. package/src/subsystems/Security/Vault.service/index.ts +12 -0
  171. package/src/types/ACL.types.ts +104 -0
  172. package/src/types/AWS.types.ts +9 -0
  173. package/src/types/Agent.types.ts +61 -0
  174. package/src/types/AgentLogger.types.ts +17 -0
  175. package/src/types/Cache.types.ts +1 -0
  176. package/src/types/Common.types.ts +3 -0
  177. package/src/types/LLM.types.ts +419 -0
  178. package/src/types/Redis.types.ts +8 -0
  179. package/src/types/SRE.types.ts +64 -0
  180. package/src/types/Security.types.ts +18 -0
  181. package/src/types/Storage.types.ts +5 -0
  182. package/src/types/VectorDB.types.ts +86 -0
  183. package/src/utils/base64.utils.ts +275 -0
  184. package/src/utils/cli.utils.ts +68 -0
  185. package/src/utils/data.utils.ts +263 -0
  186. package/src/utils/date-time.utils.ts +22 -0
  187. package/src/utils/general.utils.ts +238 -0
  188. package/src/utils/index.ts +12 -0
  189. package/src/utils/numbers.utils.ts +13 -0
  190. package/src/utils/oauth.utils.ts +35 -0
  191. package/src/utils/string.utils.ts +414 -0
  192. package/src/utils/url.utils.ts +19 -0
  193. package/src/utils/validation.utils.ts +74 -0
@@ -0,0 +1,324 @@
1
+ import axios from 'axios';
2
+ import mime from 'mime';
3
+ import { fileTypeFromBuffer } from 'file-type';
4
+ import { Readable } from 'stream';
5
+ import fs from 'fs';
6
+ import path from 'path';
7
+ import os from 'os';
8
+
9
+ import { ConnectorService } from '@sre/Core/ConnectorsService';
10
+ import { SmythFS } from '@sre/IO/Storage.service/SmythFS.class';
11
+ import { IAccessCandidate } from '@sre/types/ACL.types';
12
+ import { getSizeFromBinary, isUrl, uid, getBase64FileInfo, getMimeType } from '@sre/utils';
13
+ import config from '@sre/config';
14
+ export class BinaryInput {
15
+ private size: number;
16
+ private url: string;
17
+ private _ready;
18
+ private _readyPromise;
19
+ private _source: Buffer;
20
+ private _uploading: boolean = false;
21
+
22
+ constructor(
23
+ data: BinaryInput | Buffer | ArrayBuffer | Blob | string | Record<string, any>,
24
+ private _name?: string,
25
+ public mimetype?: string,
26
+ private candidate?: IAccessCandidate,
27
+ ) {
28
+ if (!_name) _name = uid();
29
+ this._name = _name;
30
+ //this._source = data;
31
+
32
+ this.load(data, _name, mimetype, candidate);
33
+ }
34
+
35
+ public async ready() {
36
+ if (this._ready) return true;
37
+
38
+ if (!this._readyPromise) {
39
+ this._readyPromise = new Promise((resolve) => {
40
+ const maxWait = 10000;
41
+ const interval = setInterval(() => {
42
+ if (this._ready) {
43
+ clearInterval(interval);
44
+ resolve(true);
45
+ }
46
+ if (maxWait <= 0) {
47
+ clearInterval(interval);
48
+ resolve(false);
49
+ }
50
+ }, 100);
51
+ });
52
+ }
53
+
54
+ return this._readyPromise;
55
+ }
56
+
57
+ private async load(data, name: string, mimetype?: string, candidate?: IAccessCandidate) {
58
+ //assume the mimetype from the provided name
59
+ const ext: any = name.split('.')?.length > 1 ? name.split('.').pop() : '';
60
+ // Need to set mimetype empty string if no extension is found, setting default mimetype to 'application/octet-stream' lead wrong direction when try to get the mimetype from base64 or buffer data (as it's not accurate all the time)
61
+ this.mimetype = mimetype || mime.getType(ext) || '';
62
+ this.url = ``;
63
+
64
+ if (typeof data === 'object' && data.url && data.mimetype && data.size) {
65
+ this.mimetype = data.mimetype;
66
+ this.size = data.size;
67
+ this.url = data.url;
68
+
69
+ const ext = mime.getExtension(this.mimetype);
70
+ if (!this._name.endsWith(`.${ext}`)) this._name += `.${ext}`;
71
+
72
+ if (candidate) {
73
+ this._source = await SmythFS.Instance.read(this.url, candidate).finally(() => {
74
+ this._ready = true;
75
+ });
76
+ } else {
77
+ this._ready = true;
78
+ }
79
+ return;
80
+ }
81
+
82
+ if (typeof data === 'string' && data.startsWith('smythfs://')) {
83
+ this.url = data;
84
+ if (candidate) {
85
+ try {
86
+ this._source = await SmythFS.Instance.read(this.url, candidate);
87
+ this.mimetype = await getMimeType(this._source);
88
+ this.size = this._source.byteLength;
89
+
90
+ if (!this.mimetype) {
91
+ this.mimetype = mime.getType(this.url) || mime.getType(this._name) || '';
92
+ }
93
+
94
+ const ext = mime.getExtension(this.mimetype);
95
+ if (!this._name.endsWith(`.${ext}`)) this._name += `.${ext}`;
96
+ } finally {
97
+ this._ready = true;
98
+ }
99
+ } else {
100
+ this._ready = true;
101
+ }
102
+ return;
103
+ }
104
+
105
+ if (isUrl(data)) {
106
+ try {
107
+ const response = await axios({
108
+ method: 'get',
109
+ url: data,
110
+ responseType: 'arraybuffer', // Important for handling binary data
111
+ });
112
+
113
+ this.size = response.data.byteLength;
114
+ this._source = Buffer.from(response.data, 'binary');
115
+
116
+ let mimetype = response.headers?.['content-type'] || '';
117
+
118
+ // Try to get the file extension from the URL
119
+ const urlPath = new URL(data).pathname;
120
+ let extension = urlPath.split('.')?.length > 1 ? urlPath.split('.').pop() : '';
121
+
122
+ // When content-type header is missing or invalid, try to determine mime type from file extension
123
+ if (!mimetype || mimetype.startsWith('binary/octet-stream')) {
124
+ mimetype = extension ? mime.getType(extension) : '';
125
+ }
126
+
127
+ // If we couldn't determine the mime type from headers or file extension, try detecting it from the actual file content
128
+ if (!mimetype) {
129
+ const type = await fileTypeFromBuffer(this._source);
130
+ mimetype = type?.mime || '';
131
+ }
132
+
133
+ this.mimetype = mimetype;
134
+
135
+ extension = extension || mime.getExtension(this.mimetype);
136
+ if (!this._name.endsWith(`.${extension}`)) this._name += `.${extension}`;
137
+ } catch (error) {
138
+ console.error('Error loading binary data from url:', data.url);
139
+ }
140
+
141
+ //this._source = data.url;
142
+
143
+ this._ready = true;
144
+ return;
145
+ }
146
+
147
+ // console.log('>>>>>>>>>>>>>>>>>>> is base64 file ?', isBase64DataUrl(data));
148
+ const base64FileInfo = await getBase64FileInfo(data);
149
+ if (base64FileInfo) {
150
+ // If the MIME type is already set, it's safe to use it,
151
+ // as determining the MIME type from the base64 string is not always accurate, specially when it's not a base64 URL
152
+ if (!this.mimetype) {
153
+ this.mimetype = base64FileInfo.mimetype;
154
+ }
155
+ this.size = base64FileInfo.size;
156
+ this._source = Buffer.from(base64FileInfo.data, 'base64');
157
+
158
+ const ext = mime.getExtension(this.mimetype);
159
+ if (!this._name.endsWith(`.${ext}`)) this._name += `.${ext}`;
160
+
161
+ this._ready = true;
162
+ return;
163
+ }
164
+
165
+ if (typeof data === 'string') {
166
+ this._source = Buffer.from(data);
167
+ this.size = data.length;
168
+ this.mimetype = 'text/plain';
169
+ if (!this._name.endsWith(`.txt`)) this._name += `.txt`;
170
+
171
+ this._ready = true;
172
+ return;
173
+ }
174
+
175
+ //this.size = getSizeFromBinary(data);
176
+ // //try to enforce the mimetype from the provided data
177
+ // if (Buffer.isBuffer(data)) {
178
+ // const fileType = await FileType.fileTypeFromBuffer(data);
179
+ // this.mimetype = fileType.mime;
180
+ // const ext = mime.getExtension(this.mimetype);
181
+ // if (!this._name.endsWith(`.${ext}`)) this._name += `.${ext}`;
182
+
183
+ // this._ready = true;
184
+ // return;
185
+ // }
186
+ //try to enforce the mimetype from the provided data
187
+ if (Buffer.isBuffer(data)) {
188
+ this._source = data;
189
+ this.size = getSizeFromBinary(data);
190
+ // If the MIME type is already set, it's safe to use it,
191
+ // as determining the MIME type from the buffer is not always accurate.
192
+ if (!this.mimetype) {
193
+ this.mimetype = await getMimeType(data);
194
+ }
195
+ const ext = mime.getExtension(this.mimetype);
196
+ if (!this._name.endsWith(`.${ext}`)) this._name += `.${ext}`;
197
+ }
198
+
199
+ if (data instanceof Blob) {
200
+ this._source = Buffer.from(await data.arrayBuffer());
201
+ this.size = data.size;
202
+ this.mimetype = data.type;
203
+ }
204
+
205
+ this._ready = true;
206
+ }
207
+
208
+ private async getUrlInfo(url) {
209
+ try {
210
+ // Before we had axios.head(), head method does not work for all URLs
211
+ const response = await axios.get(url);
212
+ const contentType = response.headers['content-type'];
213
+ const contentLength = response.headers['content-length'];
214
+ return { contentType, contentLength };
215
+ } catch (error) {
216
+ return { contentType: '', contentLength: 0 };
217
+ }
218
+ }
219
+
220
+ public static from(data, name?: string, mimetype?: string, candidate?: IAccessCandidate) {
221
+ if (data instanceof BinaryInput) return data;
222
+ return new BinaryInput(data, name, mimetype, candidate);
223
+ }
224
+
225
+ public async upload(candidate: IAccessCandidate, ttl?: number) {
226
+ await this.ready();
227
+ if (this._uploading) return;
228
+
229
+ try {
230
+ this._uploading = true;
231
+ if (!this.url) {
232
+ const accountConnector = ConnectorService.getAccountConnector();
233
+ const teamId = await accountConnector.getCandidateTeam(candidate);
234
+
235
+ this.url = `smythfs://${teamId}.team/${candidate.id}/_temp/${this._name}`;
236
+ await SmythFS.Instance.write(this.url, this._source, candidate, undefined, ttl);
237
+ this._uploading = false;
238
+ }
239
+ } catch (error) {
240
+ console.error('Error uploading binary data:', error);
241
+ this._uploading = false;
242
+ }
243
+ }
244
+
245
+ public async getJsonData(candidate: IAccessCandidate, ttl?: number) {
246
+ await this.upload(candidate, ttl);
247
+ return {
248
+ mimetype: this.mimetype,
249
+ size: this.size,
250
+ url: this.url,
251
+ name: this._name,
252
+ };
253
+ }
254
+
255
+ public async readData(candidate: IAccessCandidate) {
256
+ await this.ready();
257
+ if (!this.url) {
258
+ throw new Error('Binary data not ready');
259
+ }
260
+ const data = await SmythFS.Instance.read(this.url, candidate);
261
+ return data;
262
+ }
263
+
264
+ public async getName() {
265
+ await this.ready();
266
+ return this._name;
267
+ }
268
+
269
+ public async getBuffer() {
270
+ await this.ready();
271
+
272
+ return this._source;
273
+ }
274
+
275
+ /**
276
+ * Creates a read stream from the binary data.
277
+ * Uses temporary files to reduce memory usage for large files.
278
+ */
279
+ public async getReadStream(): Promise<Readable> {
280
+ await this.ready();
281
+
282
+ // * Direct in-memory stream; faster but uses memory for the entire file.
283
+ return Readable.from(this._source);
284
+
285
+ // * Uses temp files (slower but memory-efficient). Disabled in favor of simpler in-memory approach.
286
+ // let tempDir: string;
287
+
288
+ // try {
289
+ // tempDir = path.join(config.env.DATA_PATH, 'tmp');
290
+ // // Test if we can access/write to this directory
291
+ // if (!fs.existsSync(tempDir)) {
292
+ // fs.mkdirSync(tempDir, { recursive: true });
293
+ // }
294
+ // } catch (error) {
295
+ // // Last resort: try to use an in-memory stream instead of a temp file
296
+ // console.warn('Failed to access temporary directories:', error, error);
297
+ // return Readable.from(this._source);
298
+ // }
299
+
300
+ // // Generate a unique temp file name
301
+ // const tempFilePath = path.join(tempDir, `${Date.now()}-${this._name || uid()}`);
302
+
303
+ // try {
304
+ // // Write the buffer to a temp file
305
+ // fs.writeFileSync(tempFilePath, this._source);
306
+
307
+ // // Create cleanup handler to remove temp file when stream ends
308
+ // const stream = fs.createReadStream(tempFilePath);
309
+ // stream.on('close', () => {
310
+ // try {
311
+ // fs.unlinkSync(tempFilePath);
312
+ // } catch (e) {
313
+ // console.warn('Failed to clean up temporary file:', tempFilePath, e);
314
+ // }
315
+ // });
316
+
317
+ // return stream;
318
+ // } catch (writeError) {
319
+ // // If we can't write to the temp file, fall back to an in-memory stream
320
+ // console.warn('Failed to write temporary file:', writeError);
321
+ // return Readable.from(this._source);
322
+ // }
323
+ }
324
+ }