@microsoft/agents-hosting 1.9.0-beta.18.g6b8111bba5 → 1.9.0-beta.20.g0c48a31a21

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 (71) hide show
  1. package/README.md +18 -10
  2. package/dist/package.json +3 -3
  3. package/dist/src/app/agentApplication.d.ts +1 -0
  4. package/dist/src/app/agentApplication.js +18 -5
  5. package/dist/src/app/agentApplication.js.map +1 -1
  6. package/dist/src/app/agentApplicationBuilder.d.ts +9 -2
  7. package/dist/src/app/agentApplicationBuilder.js +9 -0
  8. package/dist/src/app/agentApplicationBuilder.js.map +1 -1
  9. package/dist/src/app/agentApplicationOptions.d.ts +10 -4
  10. package/dist/src/app/auth/handlerStorage.d.ts +5 -3
  11. package/dist/src/app/auth/handlerStorage.js +36 -10
  12. package/dist/src/app/auth/handlerStorage.js.map +1 -1
  13. package/dist/src/app/auth/types.d.ts +2 -2
  14. package/dist/src/app/index.d.ts +1 -0
  15. package/dist/src/app/proactive/proactive.js +10 -6
  16. package/dist/src/app/proactive/proactive.js.map +1 -1
  17. package/dist/src/app/proactive/proactiveOptions.d.ts +2 -2
  18. package/dist/src/app/rateLimit.d.ts +315 -0
  19. package/dist/src/app/rateLimit.js +333 -0
  20. package/dist/src/app/rateLimit.js.map +1 -0
  21. package/dist/src/app/turnState.d.ts +6 -3
  22. package/dist/src/app/turnState.js +43 -4
  23. package/dist/src/app/turnState.js.map +1 -1
  24. package/dist/src/errorHelper.js +40 -9
  25. package/dist/src/errorHelper.js.map +1 -1
  26. package/dist/src/observability/traces.d.ts +6 -4
  27. package/dist/src/observability/traces.js +10 -9
  28. package/dist/src/observability/traces.js.map +1 -1
  29. package/dist/src/state/agentState.d.ts +8 -3
  30. package/dist/src/state/agentState.js +26 -8
  31. package/dist/src/state/agentState.js.map +1 -1
  32. package/dist/src/state/conversationState.d.ts +2 -2
  33. package/dist/src/state/conversationState.js.map +1 -1
  34. package/dist/src/state/userState.d.ts +2 -2
  35. package/dist/src/state/userState.js.map +1 -1
  36. package/dist/src/statusCodes.d.ts +5 -0
  37. package/dist/src/statusCodes.js +5 -0
  38. package/dist/src/statusCodes.js.map +1 -1
  39. package/dist/src/storage/fileStorage.d.ts +83 -71
  40. package/dist/src/storage/fileStorage.js +272 -136
  41. package/dist/src/storage/fileStorage.js.map +1 -1
  42. package/dist/src/storage/memoryStorage.d.ts +85 -62
  43. package/dist/src/storage/memoryStorage.js +240 -109
  44. package/dist/src/storage/memoryStorage.js.map +1 -1
  45. package/dist/src/storage/storage.d.ts +101 -16
  46. package/dist/src/storage/storage.js +25 -0
  47. package/dist/src/storage/storage.js.map +1 -1
  48. package/dist/src/storage/storageCompatibility.d.ts +17 -0
  49. package/dist/src/storage/storageCompatibility.js +157 -0
  50. package/dist/src/storage/storageCompatibility.js.map +1 -0
  51. package/package.json +3 -3
  52. package/src/app/agentApplication.ts +16 -0
  53. package/src/app/agentApplicationBuilder.ts +13 -2
  54. package/src/app/agentApplicationOptions.ts +11 -4
  55. package/src/app/auth/handlerStorage.ts +51 -7
  56. package/src/app/auth/types.ts +2 -2
  57. package/src/app/index.ts +7 -0
  58. package/src/app/proactive/proactive.ts +19 -9
  59. package/src/app/proactive/proactiveOptions.ts +2 -2
  60. package/src/app/rateLimit.ts +659 -0
  61. package/src/app/turnState.ts +50 -7
  62. package/src/errorHelper.ts +46 -8
  63. package/src/observability/traces.ts +8 -7
  64. package/src/state/agentState.ts +39 -13
  65. package/src/state/conversationState.ts +2 -2
  66. package/src/state/userState.ts +2 -2
  67. package/src/statusCodes.ts +6 -0
  68. package/src/storage/fileStorage.ts +289 -134
  69. package/src/storage/memoryStorage.ts +266 -109
  70. package/src/storage/storage.ts +115 -17
  71. package/src/storage/storageCompatibility.ts +185 -0
@@ -7,205 +7,341 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
7
7
  return (mod && mod.__esModule) ? mod : { "default": mod };
8
8
  };
9
9
  Object.defineProperty(exports, "__esModule", { value: true });
10
- exports.FileStorage = void 0;
11
- const path_1 = __importDefault(require("path"));
12
- const fs_1 = __importDefault(require("fs"));
13
- const storageExpiry_1 = require("./storageExpiry");
10
+ exports.FileStorageV2 = exports.FileStorage = void 0;
11
+ const node_fs_1 = __importDefault(require("node:fs"));
12
+ const node_path_1 = __importDefault(require("node:path"));
13
+ const node_crypto_1 = require("node:crypto");
14
+ const agents_activity_1 = require("@microsoft/agents-activity");
14
15
  const agents_telemetry_1 = require("@microsoft/agents-telemetry");
16
+ const errorHelper_1 = require("../errorHelper");
15
17
  const observability_1 = require("../observability");
18
+ const storageExpiry_1 = require("./storageExpiry");
19
+ const storage_1 = require("./storage");
16
20
  const logger = (0, agents_telemetry_1.debug)('agents:file-storage');
21
+ class FileStorageInternals {
22
+ constructor(folder) {
23
+ node_fs_1.default.mkdirSync(folder, { recursive: true });
24
+ this.statePath = node_path_1.default.join(folder, 'state.json');
25
+ this.versionsPath = node_path_1.default.join(folder, 'state.versions.json');
26
+ this.expirationsPath = node_path_1.default.join(folder, 'state.expirations.json');
27
+ if (!node_fs_1.default.existsSync(this.statePath))
28
+ node_fs_1.default.writeFileSync(this.statePath, '{}');
29
+ this.state = JSON.parse(node_fs_1.default.readFileSync(this.statePath, 'utf8'));
30
+ this.versions = node_fs_1.default.existsSync(this.versionsPath)
31
+ ? JSON.parse(node_fs_1.default.readFileSync(this.versionsPath, 'utf8'))
32
+ : {};
33
+ this.expirations = node_fs_1.default.existsSync(this.expirationsPath)
34
+ ? JSON.parse(node_fs_1.default.readFileSync(this.expirationsPath, 'utf8'))
35
+ : {};
36
+ }
37
+ flush() {
38
+ node_fs_1.default.writeFileSync(this.statePath, JSON.stringify(this.state, null, 2));
39
+ if (node_fs_1.default.existsSync(this.versionsPath) || Object.keys(this.versions).length > 0) {
40
+ node_fs_1.default.writeFileSync(this.versionsPath, JSON.stringify(this.versions, null, 2));
41
+ }
42
+ if (node_fs_1.default.existsSync(this.expirationsPath) || Object.keys(this.expirations).length > 0) {
43
+ node_fs_1.default.writeFileSync(this.expirationsPath, JSON.stringify(this.expirations, null, 2));
44
+ }
45
+ }
46
+ getOrCreateVersion(key) {
47
+ var _a;
48
+ const version = (_a = this.versions[key]) !== null && _a !== void 0 ? _a : (0, node_crypto_1.randomUUID)();
49
+ this.versions[key] = version;
50
+ return version;
51
+ }
52
+ isExpired(key) {
53
+ const expiresAt = this.expirations[key];
54
+ return expiresAt !== undefined && expiresAt <= Date.now();
55
+ }
56
+ remove(key) {
57
+ delete this.state[key];
58
+ delete this.versions[key];
59
+ delete this.expirations[key];
60
+ }
61
+ }
17
62
  /**
18
63
  * A file-based storage implementation that persists data to the local filesystem.
19
64
  *
20
65
  * @remarks
21
- * FileStorage stores all data in a single JSON file named 'state.json' within a specified folder.
66
+ * FileStorage stores all data in a single JSON file named `state.json` within a specified folder.
22
67
  * This implementation is suitable for development scenarios, local testing, and single-instance
23
68
  * deployments where shared state across multiple instances is not required.
24
69
  *
25
- * The storage format is a simple key-value JSON object where keys are strings and values
26
- * can be any JSON-serializable data. All operations are synchronous file I/O operations
27
- * wrapped in Promise interfaces to match the Storage contract.
70
+ * Values remain a key-value JSON object in `state.json`. V2 keeps generated storage versions in
71
+ * `state.versions.json` so a value's own `eTag` property is not changed. All operations use
72
+ * synchronous file I/O wrapped in Promise interfaces. Use {@link FileStorageV2} for the
73
+ * structured StorageV2 contract.
74
+ * V2 supports create-only, replace, and expected-version conditions.
75
+ *
76
+ * The inherited constructor creates the folder and `state.json` when needed, then loads values
77
+ * and V2 version metadata into memory. It creates `state.versions.json` on the first V2 write.
28
78
  *
29
79
  * ### Warning
30
80
  * This implementation does not provide:
31
81
  * - Thread safety for concurrent access
32
- * - Optimistic concurrency control (eTag support)
33
82
  * - Atomic operations across multiple keys
34
83
  * - Scale for large datasets
35
84
  *
36
- * For production scenarios requiring these features, consider using
37
- * database-backed storage implementations instead.
85
+ * For production scenarios requiring these features, use a database-backed storage implementation.
38
86
  *
39
87
  * @example
40
88
  * ```typescript
41
- * const storage = new FileStorage('./data');
89
+ * const legacyStorage = new FileStorage('./data')
90
+ * const storageV2 = new FileStorageV2('./data-v2')
42
91
  *
43
- * // Write some data
44
- * await storage.write({
45
- * 'user123': { name: 'John', lastSeen: new Date().toISOString() },
46
- * 'conversation456': { turn: 5, context: 'discussing weather' }
47
- * });
92
+ * await storageV2.write({
93
+ * user123: { name: 'John', lastSeen: new Date().toISOString() }
94
+ * })
48
95
  *
49
- * // Read specific keys
50
- * const data = await storage.read(['user123']);
51
- * console.log(data.user123); // { name: 'John', lastSeen: '...' }
96
+ * const result = await storageV2.read(['user123'])
97
+ * console.log(result.user123.value)
52
98
  *
53
- * // Delete data
54
- * await storage.delete(['conversation456']);
99
+ * await storageV2.delete(['user123'])
55
100
  * ```
56
- *
57
101
  */
58
- class FileStorage {
102
+ class FileStorage extends FileStorageInternals {
59
103
  /**
60
- * Creates a new FileStorage instance that stores data in the specified folder.
104
+ * Reads legacy items from `state.json`.
61
105
  *
62
- * @param folder The absolute or relative path to the folder where the state.json file will be stored
63
- * @throws May throw filesystem errors if the folder cannot be created or accessed
64
- *
65
- * @remarks
66
- * The constructor performs the following initialization steps:
67
- * 1. Creates the target folder if it doesn't exist (including parent directories)
68
- * 2. Creates an empty state.json file if it doesn't exist
69
- * 3. Loads existing data from state.json into memory for fast access
106
+ * @param keys The keys to read; must not be empty.
107
+ * @returns Existing items keyed by storage key. Missing keys are omitted.
108
+ */
109
+ async read(keys) {
110
+ return (0, agents_telemetry_1.trace)(observability_1.StorageTraceDefinitions.read, async ({ record }) => {
111
+ record({ keyCount: keys === null || keys === void 0 ? void 0 : keys.length });
112
+ if (!keys || keys.length === 0) {
113
+ throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageReadKeysRequired);
114
+ }
115
+ const items = Object.fromEntries(keys
116
+ .filter(key => Boolean(this.state[key]))
117
+ .map(key => [key, this.state[key]]));
118
+ return items;
119
+ });
120
+ }
121
+ /**
122
+ * Writes legacy items to `state.json`.
70
123
  *
124
+ * @param changes The items to write, keyed by storage key.
125
+ * @throws If `changes` is invalid or the file cannot be written.
71
126
  */
72
- constructor(folder) {
73
- var _a;
74
- var _b;
75
- this._folder = folder;
76
- if (!fs_1.default.existsSync(folder)) {
77
- fs_1.default.mkdirSync(folder, { recursive: true });
78
- }
79
- if (!fs_1.default.existsSync(path_1.default.join(folder, 'state.json'))) {
80
- fs_1.default.writeFileSync(path_1.default.join(folder, 'state.json'), '{}');
81
- }
82
- if (!fs_1.default.existsSync(path_1.default.join(folder, 'state.metadata.json'))) {
83
- fs_1.default.writeFileSync(path_1.default.join(folder, 'state.metadata.json'), '{}');
84
- }
85
- const data = fs_1.default.readFileSync(path_1.default.join(folder, 'state.json'), 'utf8');
86
- this._stateFile = JSON.parse(data);
87
- const metadata = fs_1.default.readFileSync(path_1.default.join(folder, 'state.metadata.json'), 'utf8');
88
- this._metadataFile = JSON.parse(metadata);
89
- (_a = (_b = this._metadataFile).expirations) !== null && _a !== void 0 ? _a : (_b.expirations = {});
127
+ async write(changes) {
128
+ return (0, agents_telemetry_1.trace)(observability_1.StorageTraceDefinitions.write, async ({ record }) => {
129
+ record({ keyCount: changes ? Object.keys(changes).length : undefined });
130
+ if (!changes || typeof changes !== 'object' || Array.isArray(changes)) {
131
+ throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageWriteChangesRequired);
132
+ }
133
+ Object.assign(this.state, changes);
134
+ for (const key of Object.keys(changes)) {
135
+ delete this.versions[key];
136
+ delete this.expirations[key];
137
+ }
138
+ this.flush();
139
+ });
90
140
  }
91
141
  /**
92
- * Reads store items from the filesystem storage.
142
+ * Deletes legacy items from `state.json`.
93
143
  *
94
- * @param keys Array of keys to read from storage
95
- * @returns Promise resolving to an object containing the requested items (keys that don't exist are omitted)
96
- * @throws ReferenceError if keys array is empty or undefined
144
+ * @param keys The keys to delete; must not be empty. Missing keys are ignored.
145
+ */
146
+ async delete(keys) {
147
+ return (0, agents_telemetry_1.trace)(observability_1.StorageTraceDefinitions.delete, async ({ record }) => {
148
+ record({ keyCount: keys === null || keys === void 0 ? void 0 : keys.length });
149
+ if (!keys || keys.length === 0) {
150
+ throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageDeleteKeysRequired);
151
+ }
152
+ for (const key of keys) {
153
+ this.remove(key);
154
+ }
155
+ this.flush();
156
+ });
157
+ }
158
+ }
159
+ exports.FileStorage = FileStorage;
160
+ /**
161
+ * A file-backed provider for the structured {@link StorageV2} contract.
162
+ *
163
+ * This is the V2 counterpart to {@link FileStorage}. Values are stored in `state.json`, while
164
+ * generated storage versions are stored separately in `state.versions.json`; an `eTag` property
165
+ * in an application value is therefore preserved. Reads and mutations return a result for every
166
+ * requested key and support create-only, replace, and expected-version conditions.
167
+ *
168
+ * Like {@link FileStorage}, this provider is for development, local testing, and single-instance
169
+ * deployments. It does not provide cross-process concurrency or multi-key atomicity.
170
+ */
171
+ class FileStorageV2 extends storage_1.StorageV2 {
172
+ /**
173
+ * Creates a V2 file storage provider.
97
174
  *
98
- * @remarks
99
- * This method reads from the in-memory cache that was loaded during construction,
100
- * making it very fast but potentially returning stale data if the file was
101
- * modified by external processes.
175
+ * @param folder The absolute or relative folder where `state.json` is stored.
176
+ * @throws May throw filesystem errors if the folder or state file cannot be created or read.
177
+ */
178
+ constructor(folder) {
179
+ super();
180
+ this.internals = new FileStorageInternals(folder);
181
+ }
182
+ /**
183
+ * Reads items and their stored versions from the local state files.
102
184
  *
185
+ * @param keys The keys to read. Empty batches are valid.
186
+ * @returns A result for every key, with `notFound` for missing items. Returned values are cloned.
103
187
  */
104
- read(keys) {
188
+ async read(keys) {
105
189
  return (0, agents_telemetry_1.trace)(observability_1.StorageTraceDefinitions.read, async ({ record }) => {
106
190
  record({ keyCount: keys === null || keys === void 0 ? void 0 : keys.length });
107
- return new Promise((resolve, reject) => {
108
- if (!keys || keys.length === 0) {
109
- reject(new ReferenceError('Keys are required when reading.'));
110
- }
111
- else {
112
- const data = {};
113
- let storageChanged = false;
114
- for (const key of keys) {
115
- if (this.isExpired(key)) {
116
- logger.info('Item expired, deleting from storage', { key: (0, agents_telemetry_1.redactString)(key, true) });
117
- delete this._stateFile[key];
118
- delete this._metadataFile.expirations[key];
119
- storageChanged = true;
120
- continue;
121
- }
122
- const item = this._stateFile[key];
123
- if (item) {
124
- data[key] = item;
125
- }
126
- }
127
- if (storageChanged) {
128
- this.writeFiles();
191
+ validateV2Keys(keys);
192
+ let createdVersion = false;
193
+ const results = Object.fromEntries(keys.map(key => {
194
+ if (!Object.prototype.hasOwnProperty.call(this.internals.state, key) || this.internals.isExpired(key)) {
195
+ if (this.internals.isExpired(key)) {
196
+ logger.info('Item expired, deleting from storage', { key: (0, agents_telemetry_1.redactString)(key, true) });
197
+ this.internals.remove(key);
198
+ createdVersion = true;
129
199
  }
130
- resolve(data);
200
+ return [key, { key, status: storage_1.StorageOperationStatus.NotFound }];
131
201
  }
132
- });
202
+ const value = structuredClone(this.internals.state[key]);
203
+ const version = this.internals.versions[key];
204
+ createdVersion || (createdVersion = version === undefined);
205
+ return [key, {
206
+ key,
207
+ status: storage_1.StorageOperationStatus.Succeeded,
208
+ value,
209
+ version: version !== null && version !== void 0 ? version : this.internals.getOrCreateVersion(key),
210
+ }];
211
+ }));
212
+ if (createdVersion)
213
+ this.internals.flush();
214
+ return results;
133
215
  });
134
216
  }
135
217
  /**
136
- * Writes store items to the filesystem storage.
137
- *
138
- * @param changes Object containing key-value pairs to write to storage
139
- * @returns Promise that resolves when the write operation completes
140
- *
141
- * @remarks
142
- * This method updates both the in-memory cache and writes the entire state
143
- * to the state.json file. The file is written with pretty-printing (2-space indentation)
144
- * for better readability during development and debugging.
145
- *
146
- * > [!NOTE]
147
- * > This implementation does not support eTag-based optimistic concurrency control.
148
- * > Any eTag values in the changes object are ignored.
218
+ * Writes cloned items and generated versions to the local state files.
149
219
  *
220
+ * @param changes The values to write, keyed by storage key.
221
+ * @param options Create-only, replace, or expected-version conditions.
222
+ * @returns A result for every supplied key, including concurrency-condition outcomes.
150
223
  */
151
- write(changes, options) {
224
+ async write(changes, options) {
152
225
  return (0, agents_telemetry_1.trace)(observability_1.StorageTraceDefinitions.write, async ({ record }) => {
226
+ var _a;
227
+ record({ keyCount: changes ? Object.keys(changes).length : undefined });
228
+ validateExpectedVersion(options === null || options === void 0 ? void 0 : options.expectedVersion);
229
+ validateV2Changes(changes);
230
+ const results = {};
153
231
  const expiresAt = (0, storageExpiry_1.getStorageWriteExpiry)(options);
154
- const keys = Object.keys(changes);
155
- record({ keyCount: keys === null || keys === void 0 ? void 0 : keys.length });
156
- for (const key of keys) {
157
- this._stateFile[key] = changes[key];
158
- if (expiresAt === undefined) {
159
- delete this._metadataFile.expirations[key];
232
+ const mode = (_a = options === null || options === void 0 ? void 0 : options.mode) !== null && _a !== void 0 ? _a : storage_1.StorageWriteMode.Upsert;
233
+ validateWriteMode(mode);
234
+ let changed = false;
235
+ let createdVersion = false;
236
+ for (const [key, value] of Object.entries(changes)) {
237
+ if (this.internals.isExpired(key)) {
238
+ logger.info('Item expired, deleting from storage', { key: (0, agents_telemetry_1.redactString)(key, true) });
239
+ this.internals.remove(key);
240
+ changed = true;
241
+ }
242
+ const current = this.internals.state[key];
243
+ createdVersion || (createdVersion = current !== undefined && this.internals.versions[key] === undefined);
244
+ const currentVersion = current === undefined
245
+ ? undefined
246
+ : this.internals.getOrCreateVersion(key);
247
+ if (mode === storage_1.StorageWriteMode.CreateOnly && current !== undefined) {
248
+ results[key] = { key, status: storage_1.StorageOperationStatus.Conflict, version: currentVersion };
249
+ }
250
+ else if (mode === storage_1.StorageWriteMode.Replace && current === undefined) {
251
+ results[key] = { key, status: storage_1.StorageOperationStatus.NotFound };
252
+ }
253
+ else if ((options === null || options === void 0 ? void 0 : options.expectedVersion) !== undefined && options.expectedVersion !== currentVersion) {
254
+ results[key] = { key, status: storage_1.StorageOperationStatus.ConditionNotMet, version: currentVersion };
160
255
  }
161
256
  else {
162
- this._metadataFile.expirations[key] = expiresAt;
257
+ const version = (0, node_crypto_1.randomUUID)();
258
+ this.internals.state[key] = structuredClone(value);
259
+ this.internals.versions[key] = version;
260
+ if (expiresAt === undefined)
261
+ delete this.internals.expirations[key];
262
+ else
263
+ this.internals.expirations[key] = expiresAt;
264
+ results[key] = { key, status: storage_1.StorageOperationStatus.Succeeded, version };
265
+ changed = true;
163
266
  }
164
267
  }
165
- this.writeFiles();
268
+ if (changed || createdVersion)
269
+ this.internals.flush();
270
+ return results;
166
271
  });
167
272
  }
168
273
  /**
169
- * Deletes store items from the filesystem storage.
170
- *
171
- * @param keys Array of keys to delete from storage
172
- * @returns Promise that resolves when the delete operation completes
173
- *
174
- * @throws ReferenceError if keys array is empty or undefined
175
- *
176
- * @remarks
177
- * This method removes the specified keys from both the in-memory cache
178
- * and writes the updated state to the state.json file. Keys that don't
179
- * exist in storage are silently ignored.
274
+ * Deletes items and their versions from the local state files.
180
275
  *
276
+ * @param keys The keys to delete. Empty batches are valid.
277
+ * @param options An optional expected storage version.
278
+ * @returns A result for every supplied key.
181
279
  */
182
- delete(keys) {
280
+ async delete(keys, options) {
183
281
  return (0, agents_telemetry_1.trace)(observability_1.StorageTraceDefinitions.delete, async ({ record }) => {
184
282
  record({ keyCount: keys === null || keys === void 0 ? void 0 : keys.length });
185
- return new Promise((resolve, reject) => {
186
- if (!keys || keys.length === 0) {
187
- reject(new ReferenceError('Keys are required when deleting.'));
283
+ validateExpectedVersion(options === null || options === void 0 ? void 0 : options.expectedVersion);
284
+ validateV2Keys(keys);
285
+ const results = {};
286
+ let changed = false;
287
+ let createdVersion = false;
288
+ for (const key of keys) {
289
+ if (this.internals.isExpired(key)) {
290
+ logger.info('Item expired, deleting from storage', { key: (0, agents_telemetry_1.redactString)(key, true) });
291
+ this.internals.remove(key);
292
+ changed = true;
293
+ }
294
+ const current = this.internals.state[key];
295
+ createdVersion || (createdVersion = current !== undefined && this.internals.versions[key] === undefined);
296
+ const currentVersion = current === undefined
297
+ ? undefined
298
+ : this.internals.getOrCreateVersion(key);
299
+ if (current === undefined) {
300
+ results[key] = { key, status: storage_1.StorageOperationStatus.NotFound };
301
+ }
302
+ else if ((options === null || options === void 0 ? void 0 : options.expectedVersion) !== undefined && options.expectedVersion !== currentVersion) {
303
+ results[key] = { key, status: storage_1.StorageOperationStatus.ConditionNotMet, version: currentVersion };
188
304
  }
189
305
  else {
190
- for (const key of keys) {
191
- delete this._stateFile[key];
192
- delete this._metadataFile.expirations[key];
193
- }
194
- this.writeFiles();
195
- resolve(undefined);
306
+ this.internals.remove(key);
307
+ results[key] = { key, status: storage_1.StorageOperationStatus.Succeeded, version: currentVersion };
308
+ changed = true;
196
309
  }
197
- });
310
+ }
311
+ if (changed || createdVersion)
312
+ this.internals.flush();
313
+ return results;
198
314
  });
199
315
  }
200
- isExpired(key) {
201
- var _a;
202
- const expiresAt = (_a = this._metadataFile.expirations) === null || _a === void 0 ? void 0 : _a[key];
203
- return expiresAt !== undefined && expiresAt <= Date.now();
316
+ }
317
+ exports.FileStorageV2 = FileStorageV2;
318
+ function validateV2Keys(keys) {
319
+ if (!Array.isArray(keys)) {
320
+ throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageReadKeysRequired);
204
321
  }
205
- writeFiles() {
206
- fs_1.default.writeFileSync(path_1.default.join(this._folder, 'state.json'), JSON.stringify(this._stateFile, null, 2));
207
- fs_1.default.writeFileSync(path_1.default.join(this._folder, 'state.metadata.json'), JSON.stringify(this._metadataFile, null, 2));
322
+ if (keys.some(key => typeof key !== 'string' || key.trim() === '')) {
323
+ throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageV2KeyRequired);
324
+ }
325
+ }
326
+ function validateV2Changes(changes) {
327
+ if (changes === null || typeof changes !== 'object' || Array.isArray(changes)) {
328
+ throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageWriteChangesRequired);
329
+ }
330
+ if (Object.keys(changes).some(key => key.trim() === '')) {
331
+ throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageV2KeyRequired);
332
+ }
333
+ if (Object.values(changes).some(value => value === null || typeof value !== 'object' || Array.isArray(value))) {
334
+ throw agents_activity_1.ExceptionHelper.generateException(TypeError, errorHelper_1.Errors.StorageV2ValueRequired);
335
+ }
336
+ }
337
+ function validateExpectedVersion(expectedVersion) {
338
+ if (expectedVersion === '') {
339
+ throw agents_activity_1.ExceptionHelper.generateException(RangeError, errorHelper_1.Errors.StorageV2ExpectedVersionEmpty);
340
+ }
341
+ }
342
+ function validateWriteMode(mode) {
343
+ if (!Object.values(storage_1.StorageWriteMode).includes(mode)) {
344
+ throw agents_activity_1.ExceptionHelper.generateException(RangeError, errorHelper_1.Errors.StorageV2WriteModeUnsupported, undefined, { mode: String(mode) });
208
345
  }
209
346
  }
210
- exports.FileStorage = FileStorage;
211
347
  //# sourceMappingURL=fileStorage.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"fileStorage.js","sourceRoot":"","sources":["../../../src/storage/fileStorage.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"fileStorage.js","sourceRoot":"","sources":["../../../src/storage/fileStorage.ts"],"names":[],"mappings":"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"}