@bernierllc/email-manager 0.12.1 → 0.12.2

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 (93) hide show
  1. package/package.json +12 -12
  2. package/dist/capabilities/degradation-logger.d.ts +0 -59
  3. package/dist/capabilities/degradation-logger.d.ts.map +0 -1
  4. package/dist/capabilities/degradation-logger.js +0 -106
  5. package/dist/capabilities/degradation-logger.js.map +0 -1
  6. package/dist/capabilities/feature-router.d.ts +0 -55
  7. package/dist/capabilities/feature-router.d.ts.map +0 -1
  8. package/dist/capabilities/feature-router.js +0 -143
  9. package/dist/capabilities/feature-router.js.map +0 -1
  10. package/dist/capabilities/in-memory-resolver.d.ts +0 -27
  11. package/dist/capabilities/in-memory-resolver.d.ts.map +0 -1
  12. package/dist/capabilities/in-memory-resolver.js +0 -79
  13. package/dist/capabilities/in-memory-resolver.js.map +0 -1
  14. package/dist/capabilities/index.d.ts +0 -13
  15. package/dist/capabilities/index.d.ts.map +0 -1
  16. package/dist/capabilities/index.js +0 -21
  17. package/dist/capabilities/index.js.map +0 -1
  18. package/dist/capabilities/matrix.d.ts +0 -67
  19. package/dist/capabilities/matrix.d.ts.map +0 -1
  20. package/dist/capabilities/matrix.js +0 -312
  21. package/dist/capabilities/matrix.js.map +0 -1
  22. package/dist/capabilities/redis-resolver.d.ts +0 -95
  23. package/dist/capabilities/redis-resolver.d.ts.map +0 -1
  24. package/dist/capabilities/redis-resolver.js +0 -227
  25. package/dist/capabilities/redis-resolver.js.map +0 -1
  26. package/dist/capabilities/resolver-factory.d.ts +0 -30
  27. package/dist/capabilities/resolver-factory.d.ts.map +0 -1
  28. package/dist/capabilities/resolver-factory.js +0 -70
  29. package/dist/capabilities/resolver-factory.js.map +0 -1
  30. package/dist/capabilities/resolver.d.ts +0 -40
  31. package/dist/capabilities/resolver.d.ts.map +0 -1
  32. package/dist/capabilities/resolver.js +0 -18
  33. package/dist/capabilities/resolver.js.map +0 -1
  34. package/dist/capabilities/routing-metadata.d.ts +0 -16
  35. package/dist/capabilities/routing-metadata.d.ts.map +0 -1
  36. package/dist/capabilities/routing-metadata.js +0 -17
  37. package/dist/capabilities/routing-metadata.js.map +0 -1
  38. package/dist/capabilities/safe-resolver.d.ts +0 -24
  39. package/dist/capabilities/safe-resolver.d.ts.map +0 -1
  40. package/dist/capabilities/safe-resolver.js +0 -48
  41. package/dist/capabilities/safe-resolver.js.map +0 -1
  42. package/dist/config/loadConfiguration.d.ts +0 -60
  43. package/dist/config/loadConfiguration.d.ts.map +0 -1
  44. package/dist/config/loadConfiguration.js +0 -468
  45. package/dist/config/loadConfiguration.js.map +0 -1
  46. package/dist/config/schema.d.ts +0 -962
  47. package/dist/config/schema.d.ts.map +0 -1
  48. package/dist/config/schema.js +0 -318
  49. package/dist/config/schema.js.map +0 -1
  50. package/dist/config/types.d.ts +0 -826
  51. package/dist/config/types.d.ts.map +0 -1
  52. package/dist/config/types.js +0 -9
  53. package/dist/config/types.js.map +0 -1
  54. package/dist/email-manager.d.ts +0 -143
  55. package/dist/email-manager.d.ts.map +0 -1
  56. package/dist/email-manager.js +0 -365
  57. package/dist/email-manager.js.map +0 -1
  58. package/dist/enhanced-email-manager.d.ts +0 -349
  59. package/dist/enhanced-email-manager.d.ts.map +0 -1
  60. package/dist/enhanced-email-manager.js +0 -1396
  61. package/dist/enhanced-email-manager.js.map +0 -1
  62. package/dist/errors.d.ts +0 -154
  63. package/dist/errors.d.ts.map +0 -1
  64. package/dist/errors.js +0 -251
  65. package/dist/errors.js.map +0 -1
  66. package/dist/index.d.ts +0 -25
  67. package/dist/index.d.ts.map +0 -1
  68. package/dist/index.js +0 -30
  69. package/dist/index.js.map +0 -1
  70. package/dist/managers/email-analytics.d.ts +0 -92
  71. package/dist/managers/email-analytics.d.ts.map +0 -1
  72. package/dist/managers/email-analytics.js +0 -375
  73. package/dist/managers/email-analytics.js.map +0 -1
  74. package/dist/managers/email-scheduler.d.ts +0 -81
  75. package/dist/managers/email-scheduler.d.ts.map +0 -1
  76. package/dist/managers/email-scheduler.js +0 -288
  77. package/dist/managers/email-scheduler.js.map +0 -1
  78. package/dist/managers/provider-manager.d.ts +0 -152
  79. package/dist/managers/provider-manager.d.ts.map +0 -1
  80. package/dist/managers/provider-manager.js +0 -592
  81. package/dist/managers/provider-manager.js.map +0 -1
  82. package/dist/managers/template-manager.d.ts +0 -65
  83. package/dist/managers/template-manager.d.ts.map +0 -1
  84. package/dist/managers/template-manager.js +0 -314
  85. package/dist/managers/template-manager.js.map +0 -1
  86. package/dist/types.d.ts +0 -1029
  87. package/dist/types.d.ts.map +0 -1
  88. package/dist/types.js +0 -62
  89. package/dist/types.js.map +0 -1
  90. package/dist/utils/simple-template-engine.d.ts +0 -27
  91. package/dist/utils/simple-template-engine.d.ts.map +0 -1
  92. package/dist/utils/simple-template-engine.js +0 -61
  93. package/dist/utils/simple-template-engine.js.map +0 -1
@@ -1,288 +0,0 @@
1
- /*
2
- Copyright (c) 2025 Bernier LLC
3
-
4
- This file is licensed to the client under a limited-use license.
5
- The client may use and modify this code *only within the scope of the project it was delivered for*.
6
- Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
7
- */
8
- import { v4 as uuidv4 } from 'uuid';
9
- /**
10
- * Email Scheduling System
11
- * Handles queuing and scheduled delivery of emails
12
- */
13
- export class EmailScheduler {
14
- constructor(sendEmailCallback, config = {
15
- enabled: true,
16
- checkIntervalMs: 60000, // Check every minute
17
- maxRetries: 3,
18
- retryDelayMs: 300000 // 5 minutes
19
- }) {
20
- this.queue = [];
21
- this.isRunning = false;
22
- this.interval = null;
23
- this.sendEmailCallback = sendEmailCallback;
24
- this.config = config;
25
- }
26
- /**
27
- * Schedule an email for future delivery
28
- */
29
- async scheduleEmail(email, scheduleTime) {
30
- try {
31
- // Validate schedule time
32
- if (scheduleTime <= new Date()) {
33
- return {
34
- success: false,
35
- scheduleId: '',
36
- scheduledFor: scheduleTime,
37
- emailId: '',
38
- status: 'cancelled'
39
- };
40
- }
41
- const scheduleId = uuidv4();
42
- const scheduledEmail = {
43
- id: scheduleId,
44
- email,
45
- scheduledFor: scheduleTime,
46
- status: 'scheduled',
47
- createdAt: new Date()
48
- };
49
- // Add to queue and sort
50
- this.queue.push(scheduledEmail);
51
- this.sortQueue();
52
- return {
53
- success: true,
54
- scheduleId,
55
- scheduledFor: scheduleTime,
56
- emailId: scheduleId,
57
- status: 'scheduled'
58
- };
59
- }
60
- catch (error) {
61
- return {
62
- success: false,
63
- scheduleId: '',
64
- scheduledFor: scheduleTime,
65
- emailId: '',
66
- status: 'cancelled'
67
- };
68
- }
69
- }
70
- /**
71
- * Cancel a scheduled email
72
- */
73
- async cancelScheduledEmail(scheduleId) {
74
- try {
75
- const index = this.queue.findIndex(item => item.id === scheduleId);
76
- if (index === -1) {
77
- return {
78
- success: false,
79
- error: 'Scheduled email not found'
80
- };
81
- }
82
- const scheduledEmail = this.queue[index];
83
- // Check if email can be cancelled (not already sent)
84
- if (scheduledEmail.status === 'sent') {
85
- return {
86
- success: false,
87
- error: 'Cannot cancel email that has already been sent'
88
- };
89
- }
90
- // Update status and remove from queue
91
- scheduledEmail.status = 'cancelled';
92
- this.queue.splice(index, 1);
93
- return {
94
- success: true,
95
- message: 'Scheduled email cancelled successfully'
96
- };
97
- }
98
- catch (error) {
99
- return {
100
- success: false,
101
- error: error instanceof Error ? error.message : 'Unknown error occurred'
102
- };
103
- }
104
- }
105
- /**
106
- * Get scheduled email by ID
107
- */
108
- getScheduledEmail(scheduleId) {
109
- return this.queue.find(item => item.id === scheduleId) || null;
110
- }
111
- /**
112
- * List all scheduled emails
113
- */
114
- listScheduledEmails(status) {
115
- let filtered = [...this.queue];
116
- if (status) {
117
- filtered = filtered.filter(item => item.status === status);
118
- }
119
- // Sort by schedule time
120
- filtered.sort((a, b) => a.scheduledFor.getTime() - b.scheduledFor.getTime());
121
- return filtered;
122
- }
123
- /**
124
- * Start the scheduler
125
- */
126
- startScheduler() {
127
- if (!this.config.enabled || this.isRunning) {
128
- return;
129
- }
130
- this.isRunning = true;
131
- this.interval = setInterval(() => {
132
- this.processQueue();
133
- }, this.config.checkIntervalMs);
134
- console.log('Email scheduler started');
135
- }
136
- /**
137
- * Stop the scheduler
138
- */
139
- stopScheduler() {
140
- if (!this.isRunning) {
141
- return;
142
- }
143
- this.isRunning = false;
144
- if (this.interval) {
145
- clearInterval(this.interval);
146
- this.interval = null;
147
- }
148
- console.log('Email scheduler stopped');
149
- }
150
- /**
151
- * Process the email queue
152
- */
153
- async processQueue() {
154
- if (!this.config.enabled) {
155
- return;
156
- }
157
- const now = new Date();
158
- const readyEmails = this.queue.filter(item => item.status === 'scheduled' && item.scheduledFor <= now);
159
- console.log(`Processing ${readyEmails.length} scheduled emails`);
160
- for (const scheduledEmail of readyEmails) {
161
- await this.processSingleEmail(scheduledEmail);
162
- }
163
- // Clean up old completed emails (keep only last 1000)
164
- this.cleanupCompletedEmails();
165
- }
166
- /**
167
- * Process a single scheduled email
168
- */
169
- async processSingleEmail(scheduledEmail) {
170
- try {
171
- // Attempt to send email
172
- const result = await this.sendEmailCallback(scheduledEmail.email);
173
- // Update scheduled email status
174
- scheduledEmail.status = result.success ? 'sent' : 'failed';
175
- scheduledEmail.sentAt = new Date();
176
- scheduledEmail.result = result;
177
- // Remove from queue if sent successfully
178
- if (result.success) {
179
- const index = this.queue.findIndex(item => item.id === scheduledEmail.id);
180
- if (index !== -1) {
181
- this.queue.splice(index, 1);
182
- }
183
- }
184
- else {
185
- // Handle retry logic for failed emails
186
- await this.handleFailedEmail(scheduledEmail);
187
- }
188
- console.log(`Scheduled email ${scheduledEmail.id} ${result.success ? 'sent successfully' : 'failed to send'}`);
189
- }
190
- catch (error) {
191
- console.error(`Failed to send scheduled email ${scheduledEmail.id}:`, error);
192
- scheduledEmail.status = 'failed';
193
- scheduledEmail.error = error instanceof Error ? error.message : 'Unknown error';
194
- await this.handleFailedEmail(scheduledEmail);
195
- }
196
- }
197
- /**
198
- * Handle failed email delivery with retry logic
199
- */
200
- async handleFailedEmail(scheduledEmail) {
201
- const retryCount = scheduledEmail.retryCount || 0;
202
- if (retryCount < this.config.maxRetries) {
203
- // Schedule retry
204
- const retryTime = new Date(Date.now() + this.config.retryDelayMs);
205
- scheduledEmail.retryCount = retryCount + 1;
206
- scheduledEmail.scheduledFor = retryTime;
207
- scheduledEmail.status = 'scheduled';
208
- // Re-sort queue
209
- this.sortQueue();
210
- console.log(`Scheduled retry ${retryCount + 1}/${this.config.maxRetries} for email ${scheduledEmail.id} at ${retryTime.toISOString()}`);
211
- }
212
- else {
213
- // Max retries reached, mark as permanently failed
214
- console.error(`Email ${scheduledEmail.id} failed permanently after ${this.config.maxRetries} retries`);
215
- // Remove from queue
216
- const index = this.queue.findIndex(item => item.id === scheduledEmail.id);
217
- if (index !== -1) {
218
- this.queue.splice(index, 1);
219
- }
220
- }
221
- }
222
- /**
223
- * Sort queue by scheduled time
224
- */
225
- sortQueue() {
226
- this.queue.sort((a, b) => a.scheduledFor.getTime() - b.scheduledFor.getTime());
227
- }
228
- /**
229
- * Clean up old completed emails to prevent memory issues
230
- */
231
- cleanupCompletedEmails() {
232
- const completedEmails = this.queue.filter(item => item.status === 'sent' || item.status === 'cancelled');
233
- if (completedEmails.length > 1000) {
234
- // Remove oldest completed emails
235
- const toRemove = completedEmails
236
- .sort((a, b) => (a.sentAt || a.createdAt).getTime() - (b.sentAt || b.createdAt).getTime())
237
- .slice(0, completedEmails.length - 1000);
238
- for (const email of toRemove) {
239
- const index = this.queue.findIndex(item => item.id === email.id);
240
- if (index !== -1) {
241
- this.queue.splice(index, 1);
242
- }
243
- }
244
- }
245
- }
246
- /**
247
- * Get scheduler statistics
248
- */
249
- getStats() {
250
- const now = new Date();
251
- const scheduled = this.queue.filter(item => item.status === 'scheduled');
252
- const overdue = scheduled.filter(item => item.scheduledFor <= now);
253
- return {
254
- isRunning: this.isRunning,
255
- totalInQueue: this.queue.length,
256
- scheduled: scheduled.length,
257
- overdue: overdue.length,
258
- nextScheduled: scheduled.length > 0
259
- ? scheduled.sort((a, b) => a.scheduledFor.getTime() - b.scheduledFor.getTime())[0].scheduledFor
260
- : null,
261
- config: this.config
262
- };
263
- }
264
- /**
265
- * Update scheduler configuration
266
- */
267
- updateConfig(config) {
268
- this.config = { ...this.config, ...config };
269
- // Restart scheduler if interval changed
270
- if (config.checkIntervalMs && this.isRunning) {
271
- this.stopScheduler();
272
- this.startScheduler();
273
- }
274
- }
275
- /**
276
- * Clear all scheduled emails (for testing)
277
- */
278
- clear() {
279
- this.queue = [];
280
- }
281
- /**
282
- * Get queue length
283
- */
284
- getQueueLength() {
285
- return this.queue.length;
286
- }
287
- }
288
- //# sourceMappingURL=email-scheduler.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"email-scheduler.js","sourceRoot":"","sources":["../../src/managers/email-scheduler.ts"],"names":[],"mappings":"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"}
@@ -1,152 +0,0 @@
1
- import { EmailSender } from '@bernierllc/email-sender';
2
- import { EmailProvider, EmailData, SendResult, ProviderResult, DeleteResult, ProviderList, ProviderStatus, TestResult } from '../types.js';
3
- import type { FeatureRouter } from '../capabilities/feature-router.js';
4
- import type { DegradationLogger } from '../capabilities/degradation-logger.js';
5
- /**
6
- * Optional routing configuration. When set, the ProviderManager uses the
7
- * FeatureRouter to select providers based on capability awareness instead
8
- * of the default priority-based failover loop.
9
- */
10
- export interface ProviderManagerRoutingConfig {
11
- featureRouter: FeatureRouter;
12
- degradationLogger?: DegradationLogger;
13
- }
14
- /**
15
- * Provider Management System
16
- * Handles email provider configuration, fallback, and load balancing
17
- */
18
- export declare class ProviderManager {
19
- private providers;
20
- private emailSender;
21
- private activeProviders;
22
- private usageTracking;
23
- private routingConfig;
24
- constructor(emailSender: EmailSender);
25
- /**
26
- * Configure capability-aware routing. When configured, sendEmail will use
27
- * the FeatureRouter to select the best provider for the 'sendEmail' feature
28
- * instead of the default priority-based failover loop.
29
- *
30
- * This is designed to be called after construction (e.g. during EmailManager
31
- * initialization) so the constructor signature remains unchanged.
32
- */
33
- configureRouting(config: ProviderManagerRoutingConfig): void;
34
- /**
35
- * Add a new email provider
36
- */
37
- addProvider(provider: EmailProvider): Promise<ProviderResult>;
38
- /**
39
- * Remove a provider
40
- */
41
- removeProvider(providerId: string): Promise<DeleteResult>;
42
- /**
43
- * Get a provider by ID
44
- */
45
- getProvider(providerId: string): Promise<EmailProvider | null>;
46
- /**
47
- * List all providers
48
- */
49
- listProviders(): Promise<ProviderList>;
50
- /**
51
- * Send email with provider fallback
52
- *
53
- * When routing is configured via {@link configureRouting}, the FeatureRouter
54
- * selects the best provider for the 'sendEmail' feature and the result
55
- * includes routing metadata. When routing is NOT configured, the existing
56
- * priority-based failover loop runs unchanged.
57
- *
58
- * @throws {AllProvidersFailedError} When all providers fail to send
59
- * @throws {RateLimitExceededError} When all providers are rate limited
60
- */
61
- sendEmail(email: EmailData): Promise<SendResult>;
62
- /**
63
- * Routing-aware send: uses FeatureRouter to select the best provider,
64
- * then attempts the send. Attaches routing metadata to the result.
65
- */
66
- private sendEmailWithRouting;
67
- /**
68
- * Legacy send path: priority-based failover loop. This is the original
69
- * sendEmail implementation, preserved exactly as-is for backward
70
- * compatibility when routing is not configured.
71
- */
72
- private sendEmailLegacy;
73
- /**
74
- * Get provider status
75
- */
76
- getProviderStatus(providerId: string): Promise<ProviderStatus | null>;
77
- /**
78
- * Test provider connection
79
- */
80
- testConnection(providerId: string): Promise<TestResult>;
81
- /**
82
- * Send email with specific provider
83
- *
84
- * @throws {ProviderError} When the provider fails to send (wraps underlying EmailSenderError)
85
- */
86
- private sendWithProvider;
87
- /**
88
- * Get available providers sorted by priority
89
- */
90
- private getAvailableProviders;
91
- /**
92
- * Check if provider is within rate limits
93
- */
94
- private checkRateLimit;
95
- /**
96
- * Update usage tracking for a provider
97
- */
98
- private updateUsageTracking;
99
- /**
100
- * Initialize usage tracking for a provider
101
- */
102
- private initializeUsageTracking;
103
- /**
104
- * Reset usage counters based on time intervals
105
- */
106
- private resetUsageCounters;
107
- /**
108
- * Update the active providers list
109
- */
110
- private updateActiveProviders;
111
- /**
112
- * Validate provider configuration
113
- */
114
- private validateProvider;
115
- /**
116
- * Test provider connection
117
- */
118
- private testProviderConnection;
119
- /**
120
- * Get provider statistics
121
- */
122
- getStats(): {
123
- total: number;
124
- active: number;
125
- inactive: number;
126
- byType: Record<string, number>;
127
- usageStats: Record<string, {
128
- minute: number;
129
- hour: number;
130
- day: number;
131
- }>;
132
- };
133
- /**
134
- * Group providers by type
135
- */
136
- private groupByType;
137
- /**
138
- * Get usage statistics
139
- */
140
- private getUsageStats;
141
- /**
142
- * Map internal provider storage to the ProviderInfo format expected by
143
- * FeatureRouter. Only active providers are included; priority is derived
144
- * from the stored priority field.
145
- */
146
- private getProviderInfoList;
147
- /**
148
- * Clear all providers (for testing)
149
- */
150
- clear(): void;
151
- }
152
- //# sourceMappingURL=provider-manager.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"provider-manager.d.ts","sourceRoot":"","sources":["../../src/managers/provider-manager.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAoB,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EACL,aAAa,EACb,SAAS,EACT,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,UAAU,EAGX,MAAM,aAAa,CAAC;AAOrB,OAAO,KAAK,EAAE,aAAa,EAA+B,MAAM,mCAAmC,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAG/E;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,aAAa,CAAC;IAC7B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAaD;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,aAAa,CAA0F;IAC/G,OAAO,CAAC,aAAa,CAA2C;gBAEpD,WAAW,EAAE,WAAW;IAOpC;;;;;;;OAOG;IACH,gBAAgB,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI;IAI5D;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA8CnE;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAyB/D;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAIpE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;IAY5C;;;;;;;;;;OAUG;IACG,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAUtD;;;OAGG;YACW,oBAAoB;IAoElC;;;;OAIG;YACW,eAAe;IA+D7B;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAuB3E;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAY7D;;;;OAIG;YACW,gBAAgB;IA4D9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiB7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAS/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgExB;;OAEG;YACW,sBAAsB;IA0BpC;;OAEG;IACH,QAAQ;;;;;;oBA4B0C,MAAM;kBAAQ,MAAM;iBAAO,MAAM;;;IAhBnF;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd"}