@bsv/overlay-express 2.4.2 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (147) hide show
  1. package/LICENSE.txt +57 -27
  2. package/README.md +141 -56
  3. package/dist/cjs/mod.d.ts +11 -0
  4. package/dist/cjs/mod.d.ts.map +1 -0
  5. package/dist/cjs/mod.js.map +1 -1
  6. package/dist/cjs/package.json +26 -13
  7. package/dist/cjs/src/ArcadeProvider.d.ts +37 -0
  8. package/dist/cjs/src/ArcadeProvider.d.ts.map +1 -0
  9. package/dist/cjs/src/ArcadeProvider.js.map +1 -1
  10. package/dist/cjs/src/BanAwareDiscoveryStorage.d.ts +36 -0
  11. package/dist/cjs/src/BanAwareDiscoveryStorage.d.ts.map +1 -0
  12. package/dist/cjs/src/BanAwareDiscoveryStorage.js +5 -4
  13. package/dist/cjs/src/BanAwareDiscoveryStorage.js.map +1 -1
  14. package/dist/cjs/src/BanAwareLookupWrapper.d.ts +31 -0
  15. package/dist/cjs/src/BanAwareLookupWrapper.d.ts.map +1 -0
  16. package/dist/cjs/src/BanAwareLookupWrapper.js +3 -2
  17. package/dist/cjs/src/BanAwareLookupWrapper.js.map +1 -1
  18. package/dist/cjs/src/BanAwareTopicManager.d.ts +28 -0
  19. package/dist/cjs/src/BanAwareTopicManager.d.ts.map +1 -0
  20. package/dist/cjs/src/BanAwareTopicManager.js +3 -2
  21. package/dist/cjs/src/BanAwareTopicManager.js.map +1 -1
  22. package/dist/cjs/src/BanService.d.ts +79 -0
  23. package/dist/cjs/src/BanService.d.ts.map +1 -0
  24. package/dist/cjs/src/BanService.js +18 -5
  25. package/dist/cjs/src/BanService.js.map +1 -1
  26. package/dist/cjs/src/ChaintracksProvider.d.ts +29 -0
  27. package/dist/cjs/src/ChaintracksProvider.d.ts.map +1 -0
  28. package/dist/cjs/src/ChaintracksProvider.js +1 -1
  29. package/dist/cjs/src/ChaintracksProvider.js.map +1 -1
  30. package/dist/cjs/src/JanitorService.d.ts +135 -0
  31. package/dist/cjs/src/JanitorService.d.ts.map +1 -0
  32. package/dist/cjs/src/JanitorService.js +168 -48
  33. package/dist/cjs/src/JanitorService.js.map +1 -1
  34. package/dist/cjs/src/OverlayExpress.d.ts +472 -0
  35. package/dist/cjs/src/OverlayExpress.d.ts.map +1 -0
  36. package/dist/cjs/src/OverlayExpress.js +483 -193
  37. package/dist/cjs/src/OverlayExpress.js.map +1 -1
  38. package/dist/cjs/src/OverlayMonitor.d.ts +197 -0
  39. package/dist/cjs/src/OverlayMonitor.d.ts.map +1 -0
  40. package/dist/cjs/src/OverlayMonitor.js +6 -4
  41. package/dist/cjs/src/OverlayMonitor.js.map +1 -1
  42. package/dist/cjs/src/ProviderChainBroadcaster.d.ts +18 -0
  43. package/dist/cjs/src/ProviderChainBroadcaster.d.ts.map +1 -0
  44. package/dist/cjs/src/ProviderChainBroadcaster.js +7 -3
  45. package/dist/cjs/src/ProviderChainBroadcaster.js.map +1 -1
  46. package/dist/cjs/src/ReorgStream.d.ts +74 -0
  47. package/dist/cjs/src/ReorgStream.d.ts.map +1 -0
  48. package/dist/cjs/src/ReorgStream.js +14 -6
  49. package/dist/cjs/src/ReorgStream.js.map +1 -1
  50. package/dist/cjs/src/ResourceBoundedLookupWrapper.d.ts +26 -0
  51. package/dist/cjs/src/ResourceBoundedLookupWrapper.d.ts.map +1 -0
  52. package/dist/cjs/src/ResourceBoundedLookupWrapper.js +70 -0
  53. package/dist/cjs/src/ResourceBoundedLookupWrapper.js.map +1 -0
  54. package/dist/cjs/src/generalGuide.md.d.ts +3 -0
  55. package/dist/cjs/src/generalGuide.md.d.ts.map +1 -0
  56. package/dist/cjs/src/generalGuide.md.js.map +1 -1
  57. package/dist/cjs/src/makeUserInterface.d.ts +22 -0
  58. package/dist/cjs/src/makeUserInterface.d.ts.map +1 -0
  59. package/dist/cjs/src/makeUserInterface.js +4 -4
  60. package/dist/cjs/src/makeUserInterface.js.map +1 -1
  61. package/dist/cjs/src/security/edgePolicy.d.ts +84 -0
  62. package/dist/cjs/src/security/edgePolicy.d.ts.map +1 -0
  63. package/dist/cjs/src/security/edgePolicy.js +533 -0
  64. package/dist/cjs/src/security/edgePolicy.js.map +1 -0
  65. package/dist/esm/mod.js.map +1 -1
  66. package/dist/esm/src/ArcadeProvider.js.map +1 -1
  67. package/dist/esm/src/BanAwareDiscoveryStorage.js +5 -4
  68. package/dist/esm/src/BanAwareDiscoveryStorage.js.map +1 -1
  69. package/dist/esm/src/BanAwareLookupWrapper.js +3 -2
  70. package/dist/esm/src/BanAwareLookupWrapper.js.map +1 -1
  71. package/dist/esm/src/BanAwareTopicManager.js +3 -2
  72. package/dist/esm/src/BanAwareTopicManager.js.map +1 -1
  73. package/dist/esm/src/BanService.js +18 -5
  74. package/dist/esm/src/BanService.js.map +1 -1
  75. package/dist/esm/src/ChaintracksProvider.js +1 -1
  76. package/dist/esm/src/ChaintracksProvider.js.map +1 -1
  77. package/dist/esm/src/JanitorService.js +146 -19
  78. package/dist/esm/src/JanitorService.js.map +1 -1
  79. package/dist/esm/src/OverlayExpress.js +465 -176
  80. package/dist/esm/src/OverlayExpress.js.map +1 -1
  81. package/dist/esm/src/ProviderChainBroadcaster.js +7 -3
  82. package/dist/esm/src/ProviderChainBroadcaster.js.map +1 -1
  83. package/dist/esm/src/ReorgStream.js +14 -6
  84. package/dist/esm/src/ReorgStream.js.map +1 -1
  85. package/dist/esm/src/ResourceBoundedLookupWrapper.js +70 -0
  86. package/dist/esm/src/ResourceBoundedLookupWrapper.js.map +1 -0
  87. package/dist/esm/src/makeUserInterface.js +3 -4
  88. package/dist/esm/src/makeUserInterface.js.map +1 -1
  89. package/dist/esm/src/security/edgePolicy.js +522 -0
  90. package/dist/esm/src/security/edgePolicy.js.map +1 -0
  91. package/dist/types/mod.d.ts +1 -1
  92. package/dist/types/mod.d.ts.map +1 -1
  93. package/dist/types/src/ArcadeProvider.d.ts.map +1 -1
  94. package/dist/types/src/BanAwareDiscoveryStorage.d.ts.map +1 -1
  95. package/dist/types/src/BanAwareLookupWrapper.d.ts.map +1 -1
  96. package/dist/types/src/BanAwareTopicManager.d.ts.map +1 -1
  97. package/dist/types/src/BanService.d.ts +2 -4
  98. package/dist/types/src/BanService.d.ts.map +1 -1
  99. package/dist/types/src/ChaintracksProvider.d.ts.map +1 -1
  100. package/dist/types/src/JanitorService.d.ts +21 -1
  101. package/dist/types/src/JanitorService.d.ts.map +1 -1
  102. package/dist/types/src/OverlayExpress.d.ts +54 -2
  103. package/dist/types/src/OverlayExpress.d.ts.map +1 -1
  104. package/dist/types/src/OverlayMonitor.d.ts.map +1 -1
  105. package/dist/types/src/ProviderChainBroadcaster.d.ts.map +1 -1
  106. package/dist/types/src/ReorgStream.d.ts.map +1 -1
  107. package/dist/types/src/ResourceBoundedLookupWrapper.d.ts +26 -0
  108. package/dist/types/src/ResourceBoundedLookupWrapper.d.ts.map +1 -0
  109. package/dist/types/src/generalGuide.md.d.ts +1 -1
  110. package/dist/types/src/generalGuide.md.d.ts.map +1 -1
  111. package/dist/types/src/makeUserInterface.d.ts +1 -2
  112. package/dist/types/src/makeUserInterface.d.ts.map +1 -1
  113. package/dist/types/src/security/edgePolicy.d.ts +84 -0
  114. package/dist/types/src/security/edgePolicy.d.ts.map +1 -0
  115. package/package.json +47 -25
  116. package/dist/cjs/tsconfig.cjs.tsbuildinfo +0 -1
  117. package/dist/esm/tsconfig.esm.tsbuildinfo +0 -1
  118. package/dist/types/tsconfig.types.tsbuildinfo +0 -1
  119. package/mod.ts +0 -47
  120. package/src/ArcadeProvider.ts +0 -232
  121. package/src/BanAwareDiscoveryStorage.ts +0 -91
  122. package/src/BanAwareLookupWrapper.ts +0 -95
  123. package/src/BanAwareTopicManager.ts +0 -87
  124. package/src/BanService.ts +0 -154
  125. package/src/ChaintracksProvider.ts +0 -79
  126. package/src/JanitorService.ts +0 -423
  127. package/src/OverlayExpress.ts +0 -2479
  128. package/src/OverlayMonitor.ts +0 -817
  129. package/src/ProviderChainBroadcaster.ts +0 -108
  130. package/src/ReorgStream.ts +0 -221
  131. package/src/__tests__/BanAwareDiscoveryStorage.test.ts +0 -131
  132. package/src/__tests__/BanAwareLookupWrapper.test.ts +0 -255
  133. package/src/__tests__/BanAwareTopicManager.test.ts +0 -132
  134. package/src/__tests__/BanService.test.ts +0 -310
  135. package/src/__tests__/InMemoryMigrationSource.test.ts +0 -11
  136. package/src/__tests__/JanitorService.test.ts +0 -941
  137. package/src/__tests__/OverlayExpress.test.ts +0 -1300
  138. package/src/__tests__/OverlayMonitor.test.ts +0 -255
  139. package/src/__tests__/OverlayProviders.live.test.ts +0 -43
  140. package/src/__tests__/OverlayProviders.test.ts +0 -123
  141. package/src/__tests__/README.md +0 -105
  142. package/src/__tests__/ReorgStream.test.ts +0 -66
  143. package/src/__tests__/makeUserInterface.test.ts +0 -193
  144. package/src/__tests__/setup.ts +0 -36
  145. package/src/auth-express-middleware.d.ts +0 -16
  146. package/src/generalGuide.md.ts +0 -74
  147. package/src/makeUserInterface.ts +0 -1224
@@ -0,0 +1,472 @@
1
+ import express from 'express';
2
+ import { Engine, LookupService, TopicManager, Advertiser } from '@bsv/overlay';
3
+ import { ChainTracker, Broadcaster, OverlayBroadcastFacilitator, WalletInterface, SessionManager, AsyncSessionManager } from '@bsv/sdk';
4
+ import Knex from 'knex';
5
+ import { MongoClient, Db } from 'mongodb';
6
+ import { type UIConfig } from './makeUserInterface.js';
7
+ import { BanService } from './BanService.js';
8
+ import type { Server } from 'node:http';
9
+ import { type HttpServerPolicyDefaults, type SecurityHeadersOptions } from './security/edgePolicy.js';
10
+ /**
11
+ * Knex database migration.
12
+ */
13
+ interface Migration {
14
+ name?: string;
15
+ up: (knex: Knex.Knex) => Promise<void>;
16
+ down?: (knex: Knex.Knex) => Promise<void>;
17
+ }
18
+ /**
19
+ * Configuration options that map to Engine constructor parameters.
20
+ */
21
+ export type SyncConfigurationEntry = string[] | 'SHIP' | false;
22
+ export type SyncConfigurationMap = Record<string, SyncConfigurationEntry>;
23
+ export interface EngineConfig {
24
+ chainTracker?: ChainTracker | 'scripts only';
25
+ shipTrackers?: string[];
26
+ slapTrackers?: string[];
27
+ broadcaster?: Broadcaster;
28
+ advertiser?: Advertiser;
29
+ syncConfiguration?: SyncConfigurationMap;
30
+ logTime?: boolean;
31
+ logPrefix?: string;
32
+ throwOnBroadcastFailure?: boolean;
33
+ overlayBroadcastFacilitator?: OverlayBroadcastFacilitator;
34
+ suppressDefaultSyncAdvertisements?: boolean;
35
+ topicAnchorHeaderResolver?: TopicAnchorHeaderResolver;
36
+ enableBASMSync?: boolean;
37
+ unprovenEvictionBlocks?: number;
38
+ reorgStreamUrl?: string;
39
+ reorgScanDepth?: number;
40
+ unprovenMaintenanceIntervalMs?: number;
41
+ /** Maximum lookup formulas hydrated by the engine. Use -1 to opt out. */
42
+ maxLookupResults?: number;
43
+ }
44
+ export type HealthStatus = 'ok' | 'degraded' | 'error';
45
+ export interface HealthCheckResult {
46
+ name: string;
47
+ scope: 'live' | 'ready';
48
+ status: HealthStatus;
49
+ critical: boolean;
50
+ message?: string;
51
+ details?: Record<string, any>;
52
+ durationMs: number;
53
+ }
54
+ export type HealthCheckHandler = () => Promise<Omit<HealthCheckResult, 'name' | 'scope' | 'critical' | 'durationMs'> | void> | Omit<HealthCheckResult, 'name' | 'scope' | 'critical' | 'durationMs'> | void;
55
+ export interface HealthCheckDefinition {
56
+ name: string;
57
+ scope?: 'live' | 'ready';
58
+ critical?: boolean;
59
+ handler: HealthCheckHandler;
60
+ }
61
+ export interface HealthConfig {
62
+ includeDetails: boolean;
63
+ timeoutMs: number;
64
+ contextProvider?: () => Promise<Record<string, any> | undefined> | Record<string, any> | undefined;
65
+ }
66
+ export interface HealthReport {
67
+ status: HealthStatus;
68
+ live: boolean;
69
+ ready: boolean;
70
+ service: {
71
+ name: string;
72
+ advertisableFQDN: string;
73
+ port: number;
74
+ network: 'main' | 'test';
75
+ startedAt?: string;
76
+ uptimeMs: number;
77
+ topicManagerCount: number;
78
+ lookupServiceCount: number;
79
+ };
80
+ checks: HealthCheckResult[];
81
+ context?: Record<string, any>;
82
+ }
83
+ export interface EdgePolicyConfig {
84
+ environmentPrefix: string;
85
+ allowedOrigins?: string[];
86
+ jsonBodyLimitBytes: number;
87
+ binaryBodyLimitBytes: number;
88
+ maxConcurrentRequests: number;
89
+ http: HttpServerPolicyDefaults;
90
+ securityHeaders: SecurityHeadersOptions;
91
+ }
92
+ export type TopicAnchorHeaderResolver = (blockHeight: number) => Promise<{
93
+ blockHeight: number;
94
+ blockHash: string;
95
+ merkleRoot?: string;
96
+ } | undefined>;
97
+ /**
98
+ * OverlayExpress class provides an Express-based server for hosting Overlay Services.
99
+ * It allows configuration of various components like databases, topic managers, and lookup services.
100
+ * It encapsulates an Express application and provides methods to start the server.
101
+ */
102
+ export default class OverlayExpress {
103
+ name: string;
104
+ privateKey: string;
105
+ advertisableFQDN: string;
106
+ app: express.Application;
107
+ port: number;
108
+ logger: typeof console;
109
+ knex?: Knex.Knex;
110
+ migrationsToRun: Migration[];
111
+ mongoDb?: Db;
112
+ mongoClient?: MongoClient;
113
+ network: 'main' | 'test';
114
+ chainTracker: ChainTracker | 'scripts only';
115
+ engine?: Engine;
116
+ managers: Record<string, TopicManager>;
117
+ services: Record<string, LookupService>;
118
+ enableGASPSync: boolean;
119
+ enableBASMSync: boolean;
120
+ unprovenEvictionBlocks: number;
121
+ basmBlockPollIntervalMs: number;
122
+ private basmBlockPollTimer?;
123
+ unprovenMaintenanceIntervalMs: number;
124
+ private unprovenMaintenanceTimer?;
125
+ reorgStreamUrl?: string;
126
+ reorgScanDepth: number;
127
+ private reorgAdapter?;
128
+ topicAnchorHeaderResolver?: TopicAnchorHeaderResolver;
129
+ arcApiKey: string | undefined;
130
+ arcCallbackToken: string | undefined;
131
+ arcadeUrl: string | undefined;
132
+ arcadeApiKey: string | undefined;
133
+ arcadeDeploymentId: string | undefined;
134
+ arcadeChaintracksApiPrefix: string;
135
+ private arcadeProvider?;
136
+ verboseRequestLogging: boolean;
137
+ webUIConfig: UIConfig;
138
+ engineConfig: EngineConfig;
139
+ private readonly adminToken;
140
+ janitorConfig: {
141
+ requestTimeoutMs: number;
142
+ hostDownRevokeScore: number;
143
+ autoBanOnRemoval: boolean;
144
+ allowPrivateHosts: boolean;
145
+ batchSize?: number;
146
+ maxReportResults?: number;
147
+ };
148
+ banService?: BanService;
149
+ adminIdentityKey?: string;
150
+ serverWallet?: WalletInterface;
151
+ authSessionManager?: SessionManager | AsyncSessionManager;
152
+ private startTime?;
153
+ healthConfig: HealthConfig;
154
+ healthChecks: HealthCheckDefinition[];
155
+ isListening: boolean;
156
+ server?: Server;
157
+ private closePromise?;
158
+ edgePolicyConfig: EdgePolicyConfig;
159
+ /**
160
+ * Constructs an instance of OverlayExpress.
161
+ * @param name - The name of the service
162
+ * @param privateKey - Private key used for signing advertisements
163
+ * @param advertisableFQDN - The fully qualified domain name where this service is available. Does not include "https://".
164
+ * @param adminToken - Optional. An administrative Bearer token used to protect admin routes.
165
+ * If not provided, a random token will be generated at runtime.
166
+ */
167
+ constructor(name: string, privateKey: string, advertisableFQDN: string, adminToken?: string);
168
+ /**
169
+ * Returns the current admin token in case you need to programmatically retrieve or display it.
170
+ */
171
+ getAdminToken(): string;
172
+ /**
173
+ * Configures the port on which the server will listen.
174
+ * @param port - The port number
175
+ */
176
+ configurePort(port: number): void;
177
+ /**
178
+ * Configures the web user interface
179
+ * @param config - Web UI configuration options
180
+ */
181
+ configureWebUI(config: UIConfig): void;
182
+ /**
183
+ * Configures the janitor service parameters
184
+ * @param config - Janitor configuration options
185
+ * - requestTimeoutMs: Timeout for health check requests (default: 10000ms)
186
+ * - hostDownRevokeScore: Number of consecutive failures before deleting output (default: 3)
187
+ * - autoBanOnRemoval: Whether to auto-ban domains when removed by janitor (default: true)
188
+ * - allowPrivateHosts: Permit private/HTTP targets for isolated local development (default: false)
189
+ * - batchSize: Mongo scan batch size; -1 uses the driver default
190
+ * - maxReportResults: Maximum retained result details; -1 retains all
191
+ */
192
+ configureJanitor(config: Partial<typeof this.janitorConfig>): void;
193
+ /**
194
+ * Configures health-report behavior.
195
+ */
196
+ configureHealth(config: Partial<HealthConfig>): void;
197
+ /**
198
+ * Configures explicit browser origins and bounded request/resource policy.
199
+ * Public cross-origin access is the default; pass allowedOrigins or set
200
+ * OVERLAY_CORS_MODE=allowlist to restrict browser callers.
201
+ */
202
+ configureEdgePolicy(config: Partial<Omit<EdgePolicyConfig, 'http' | 'securityHeaders'>> & {
203
+ http?: Partial<HttpServerPolicyDefaults>;
204
+ securityHeaders?: SecurityHeadersOptions;
205
+ }): void;
206
+ /**
207
+ * Registers an application-specific health check.
208
+ */
209
+ registerHealthCheck(definition: HealthCheckDefinition): void;
210
+ /**
211
+ * Configures the admin identity key for wallet-based admin detection.
212
+ * When set, the frontend can compare the user's wallet identity key against this
213
+ * to determine whether to show the admin dashboard.
214
+ *
215
+ * @param identityKey - The hex-encoded public key of the admin
216
+ */
217
+ configureAdminIdentityKey(identityKey: string): void;
218
+ /**
219
+ * Configures BRC-103 session storage for the administrative mutual-auth
220
+ * middleware. Horizontally scaled services should supply a shared
221
+ * AsyncSessionManager rather than use the default process-local store.
222
+ */
223
+ configureAuthSessionManager(sessionManager: SessionManager | AsyncSessionManager): void;
224
+ /**
225
+ * Configures the logger to be used by the server.
226
+ * @param logger - A logger object (e.g., console)
227
+ */
228
+ configureLogger(logger: typeof console): void;
229
+ /**
230
+ * Configures the BSV Blockchain network to be used ('main' or 'test').
231
+ * By default, it re-initializes chainTracker as a WhatsOnChain for that network.
232
+ * @param network - The network ('main' or 'test')
233
+ */
234
+ configureNetwork(network: 'main' | 'test'): void;
235
+ /**
236
+ * Configures the ChainTracker to be used.
237
+ * If 'scripts only' is used, it implies no full SPV chain tracking in the Engine.
238
+ * @param chainTracker - An instance of ChainTracker or 'scripts only'
239
+ */
240
+ configureChainTracker(chainTracker?: ChainTracker | 'scripts only'): void;
241
+ /**
242
+ * Configures the ARC API key.
243
+ * @param apiKey - The ARC API key
244
+ */
245
+ configureArcApiKey(apiKey: string): void;
246
+ /**
247
+ * Configures the ARC callback token expected by /arc-ingest.
248
+ * @param token - The token ARC should present when posting callback notifications.
249
+ */
250
+ configureArcCallbackToken(token: string): void;
251
+ /**
252
+ * Configures Arcade for first-choice transaction propagation and proof lookup.
253
+ */
254
+ configureArcade(url: string, config?: {
255
+ apiKey?: string;
256
+ deploymentId?: string;
257
+ chaintracksApiPrefix?: string;
258
+ }): void;
259
+ /**
260
+ * Configures a go-chaintracks compatible service for header validation and
261
+ * BASM reorg streaming. Arcade exposes this at `/chaintracks/v2`.
262
+ */
263
+ configureChaintracks(url: string, config?: {
264
+ apiPrefix?: string;
265
+ reorgStream?: boolean;
266
+ scanDepth?: number;
267
+ }): void;
268
+ /**
269
+ * Enables or disables GASP synchronization (high-level setting).
270
+ * This is a broad toggle that can be overridden or customized through syncConfiguration.
271
+ * @param enable - true to enable, false to disable
272
+ */
273
+ configureEnableGASPSync(enable: boolean): void;
274
+ /**
275
+ * Enables or disables BRC-136 BASM synchronization.
276
+ * BASM is opt-in because it requires direct proofs and block hash resolution.
277
+ */
278
+ configureEnableBASMSync(enable: boolean): void;
279
+ /**
280
+ * Configures the block header resolver used to derive BASM block hashes.
281
+ */
282
+ configureTopicAnchorHeaderResolver(resolver: TopicAnchorHeaderResolver): void;
283
+ /**
284
+ * Configures the go-chaintracks (Arcade) reorg SSE stream used to reconcile
285
+ * BASM anchors with blockchain reorganizations in real time.
286
+ * @param url - The reorg stream URL, e.g. `https://arcade.example/v2/reorg/stream`.
287
+ * @param scanDepth - Optional revalidation-sweep depth in blocks (default 3).
288
+ */
289
+ configureReorgStream(url: string, scanDepth?: number): void;
290
+ /**
291
+ * Configures the opt-in unproven state eviction threshold.
292
+ */
293
+ configureUnprovenEviction(config: {
294
+ thresholdBlocks?: number;
295
+ }): void;
296
+ /**
297
+ * Configures periodic unproven maintenance. Each run first tries configured
298
+ * proof providers, then evicts rows that are still unproven past the threshold.
299
+ */
300
+ configureUnprovenMaintenance(config: {
301
+ intervalMs?: number;
302
+ thresholdBlocks?: number;
303
+ }): void;
304
+ /**
305
+ * Configures how often the BASM anchor chain is extended with empty anchors to
306
+ * follow the chain tip. Set to 0 to disable periodic polling.
307
+ */
308
+ configureBASMBlockPollInterval(intervalMs: number): void;
309
+ /**
310
+ * Enables or disables verbose request logging.
311
+ * @param enable - true to enable, false to disable
312
+ */
313
+ configureVerboseRequestLogging(enable: boolean): void;
314
+ /**
315
+ * Configure Knex (SQL) database connection.
316
+ * @param config - Knex configuration object, or a MySQL connection string loaded from configuration.
317
+ */
318
+ configureKnex(config: Knex.Knex.Config | string): Promise<void>;
319
+ /**
320
+ * Configures the MongoDB database connection.
321
+ * Also initializes the BanService for persistent ban tracking.
322
+ * @param connectionString - MongoDB connection string
323
+ */
324
+ configureMongo(connectionString: string): Promise<void>;
325
+ /**
326
+ * Configures a Topic Manager.
327
+ * @param name - The name of the Topic Manager
328
+ * @param manager - An instance of TopicManager
329
+ */
330
+ configureTopicManager(name: string, manager: TopicManager): void;
331
+ /**
332
+ * Configures a Lookup Service.
333
+ * @param name - The name of the Lookup Service
334
+ * @param service - An instance of LookupService
335
+ */
336
+ configureLookupService(name: string, service: LookupService): void;
337
+ /**
338
+ * Configures a Lookup Service using Knex (SQL) database.
339
+ * @param name - The name of the Lookup Service
340
+ * @param serviceFactory - A factory function that creates a LookupService instance using Knex
341
+ */
342
+ configureLookupServiceWithKnex(name: string, serviceFactory: (knex: Knex.Knex) => {
343
+ service: LookupService;
344
+ migrations: Migration[];
345
+ }): void;
346
+ /**
347
+ * Configures a Lookup Service using MongoDB.
348
+ * @param name - The name of the Lookup Service
349
+ * @param serviceFactory - A factory function that creates a LookupService instance using MongoDB
350
+ */
351
+ configureLookupServiceWithMongo(name: string, serviceFactory: (mongoDb: Db) => LookupService): void;
352
+ /**
353
+ * Advanced configuration method for setting or overriding any
354
+ * Engine constructor parameters via an EngineConfig object.
355
+ *
356
+ * Example usage:
357
+ * configureEngineParams({
358
+ * logTime: true,
359
+ * throwOnBroadcastFailure: true,
360
+ * overlayBroadcastFacilitator: new MyCustomFacilitator()
361
+ * })
362
+ *
363
+ * These fields will be respected when we finally build/configure the Engine
364
+ * in the `configureEngine()` method below.
365
+ */
366
+ configureEngineParams(params: EngineConfig): void;
367
+ /**
368
+ * Configures the Overlay Engine itself.
369
+ * By default, auto-configures SHIP and SLAP unless autoConfigureShipSlap = false
370
+ * Then it merges in any advanced engine config from `this.engineConfig`.
371
+ *
372
+ * When a BanService is available (from configureMongo), auto-configured SHIP
373
+ * and SLAP managers, discovery storage, and lookup services are wrapped so
374
+ * banned outputs are not admitted or indexed.
375
+ *
376
+ * @param autoConfigureShipSlap - Whether to auto-configure SHIP and SLAP services (default: true)
377
+ */
378
+ configureEngine(autoConfigureShipSlap?: boolean): Promise<void>;
379
+ /** Wrap SHIP/SLAP managers and services with ban-aware filters if BanService is configured. */
380
+ private wrapBanAwareServices;
381
+ /** Build the sync config based on enableGASPSync and engineConfig. */
382
+ private buildSyncConfig;
383
+ /** Build the configured transaction propagation provider chain. */
384
+ private buildBroadcaster;
385
+ private ensureArcadeProvider;
386
+ private fetchArcadeProof;
387
+ private fetchConfiguredMerkleProof;
388
+ /** Build the BASM block header resolver. */
389
+ private buildTopicAnchorHeaderResolver;
390
+ /** Resolve the SLAP trackers from config or network defaults. */
391
+ private resolveSlapTrackers;
392
+ /** Build the WalletAdvertiser (or use user-provided one). */
393
+ private buildAdvertiser;
394
+ /** Initialize the server wallet for BSV mutual authentication. */
395
+ private initServerWallet;
396
+ /**
397
+ * Ensures that Knex is configured and returns it.
398
+ * @throws Error if Knex is not configured
399
+ */
400
+ private ensureKnex;
401
+ /**
402
+ * Ensures that MongoDB is configured and returns it.
403
+ * @throws Error if MongoDB is not configured
404
+ */
405
+ private ensureMongo;
406
+ /**
407
+ * Ensures that the Overlay Engine is configured and returns it.
408
+ * @throws Error if the Engine is not configured
409
+ */
410
+ private ensureEngine;
411
+ /**
412
+ * Creates a JanitorService instance with current configuration.
413
+ */
414
+ private createJanitor;
415
+ /** Ban a domain and remove all its SHIP/SLAP records from MongoDB. */
416
+ private handleBanDomain;
417
+ /** Parse outpoint string, ban it, and evict it from all lookup services. */
418
+ private handleBanOutpoint;
419
+ /** Evict an output from a specific service or all services (silent per-service errors). */
420
+ private evictFromServices;
421
+ /** Look up the domain of an outpoint from SHIP or SLAP records. */
422
+ private lookupDomainForOutpoint;
423
+ /** Ban a domain and delete all SHIP/SLAP records for it. */
424
+ private banDomainAndRemoveRecords;
425
+ private runHealthCheck;
426
+ private collectHealthReport;
427
+ /**
428
+ * Renders a request or response body for verbose logging, truncating overly long payloads.
429
+ */
430
+ private formatBodyForLog;
431
+ private redactHeadersForLog;
432
+ private arcCallbackRequestToken;
433
+ private arcCallbackAuthorized;
434
+ private processArcIngest;
435
+ /**
436
+ * Installs middleware that verbosely logs incoming requests and outgoing responses.
437
+ */
438
+ private setupVerboseRequestLogging;
439
+ /**
440
+ * Starts the Express server.
441
+ * Sets up routes and begins listening on the configured port.
442
+ */
443
+ start(): Promise<void>;
444
+ /**
445
+ * Stops new HTTP work, background synchronization, and database clients.
446
+ *
447
+ * The operation is idempotent so multiple signal handlers or embedding
448
+ * runtimes can share shutdown ownership safely.
449
+ */
450
+ close(): Promise<void>;
451
+ private closeResources;
452
+ /**
453
+ * Runs the post-listen startup work: advertiser init, advertisement sync,
454
+ * and the optional GASP/BASM background syncs.
455
+ */
456
+ private runStartupSync;
457
+ /** Attempt a GASP sync at startup when enabled. */
458
+ private runGaspStartupSync;
459
+ /** Attempt a BASM sync at startup when enabled, then begin tip-following. */
460
+ private runBasmStartupSync;
461
+ /** Poll for new blocks to advance anchor chains and detect reorgs. */
462
+ private startBASMBlockPolling;
463
+ /** Real-time reorg reconciliation via the go-chaintracks (Arcade) reorg SSE. */
464
+ private startBASMReorgStream;
465
+ /** Extend every topic's BASM anchor chain to the current chain tip. */
466
+ private advanceBASMAnchorChains;
467
+ /** Revalidate recent BASM anchors against the chain tracker, reconciling any reorg. */
468
+ private revalidateBASMAnchors;
469
+ private startUnprovenMaintenance;
470
+ }
471
+ export {};
472
+ //# sourceMappingURL=OverlayExpress.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"OverlayExpress.d.ts","sourceRoot":"","sources":["../../../src/OverlayExpress.ts"],"names":[],"mappings":"AAAA,OAAO,OAAwC,MAAM,SAAS,CAAA;AAE9D,OAAO,EACL,MAAM,EAEN,aAAa,EACb,YAAY,EAEZ,UAAU,EAGX,MAAM,cAAc,CAAA;AACrB,OAAO,EAEL,YAAY,EAKZ,WAAW,EACX,2BAA2B,EAS3B,eAAe,EACf,cAAc,EACd,mBAAmB,EACpB,MAAM,UAAU,CAAA;AACjB,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AACzC,OAA0B,EAAE,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAMzE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAW5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAYL,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC5B,MAAM,0BAA0B,CAAA;AAEjC;;GAEG;AACH,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1C;AAuCD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,KAAK,CAAA;AAC9D,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;AAEzE,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,YAAY,GAAG,cAAc,CAAA;IAC5C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,iBAAiB,CAAC,EAAE,oBAAoB,CAAA;IACxC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,2BAA2B,CAAC,EAAE,2BAA2B,CAAA;IACzD,iCAAiC,CAAC,EAAE,OAAO,CAAA;IAC3C,yBAAyB,CAAC,EAAE,yBAAyB,CAAA;IACrD,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6BAA6B,CAAC,EAAE,MAAM,CAAA;IACtC,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,UAAU,GAAG,OAAO,CAAA;AAEtD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,MAAM,EAAE,YAAY,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAC7B,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,GACrF,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,CAAC,GACrE,IAAI,CAAA;AAER,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,kBAAkB,CAAA;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,OAAO,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAAA;CACnG;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,gBAAgB,EAAE,MAAM,CAAA;QACxB,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;QACxB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,QAAQ,EAAE,MAAM,CAAA;QAChB,iBAAiB,EAAE,MAAM,CAAA;QACzB,kBAAkB,EAAE,MAAM,CAAA;KAC3B,CAAA;IACD,MAAM,EAAE,iBAAiB,EAAE,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,IAAI,EAAE,wBAAwB,CAAA;IAC9B,eAAe,EAAE,sBAAsB,CAAA;CACxC;AAED,MAAM,MAAM,yBAAyB,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CACpE;IACE,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,GACD,SAAS,CACZ,CAAA;AA8ED;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IAsLxB,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,MAAM;IAClB,gBAAgB,EAAE,MAAM;IAtLjC,GAAG,EAAE,OAAO,CAAC,WAAW,CAAA;IAGxB,IAAI,EAAE,MAAM,CAAO;IAGnB,MAAM,EAAE,OAAO,OAAO,CAAU;IAGhC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAA;IAGhB,eAAe,EAAE,SAAS,EAAE,CAAK;IAGjC,OAAO,CAAC,EAAE,EAAE,CAAA;IAGZ,WAAW,CAAC,EAAE,WAAW,CAAA;IAGzB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAS;IAIjC,YAAY,EAAE,YAAY,GAAG,cAAc,CAAiC;IAG5E,MAAM,CAAC,EAAE,MAAM,CAAA;IAGf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAK;IAG3C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAK;IAI5C,cAAc,EAAE,OAAO,CAAO;IAI9B,cAAc,EAAE,OAAO,CAAQ;IAG/B,sBAAsB,EAAE,MAAM,CAAM;IAKpC,uBAAuB,EAAE,MAAM,CAAiB;IAGhD,OAAO,CAAC,kBAAkB,CAAC,CAAgC;IAI3D,6BAA6B,EAAE,MAAM,CAAI;IAEzC,OAAO,CAAC,wBAAwB,CAAC,CAAgC;IAKjE,cAAc,CAAC,EAAE,MAAM,CAAA;IAGvB,cAAc,EAAE,MAAM,CAAI;IAG1B,OAAO,CAAC,YAAY,CAAC,CAAiB;IAGtC,yBAAyB,CAAC,EAAE,yBAAyB,CAAA;IAGrD,SAAS,EAAE,MAAM,GAAG,SAAS,CAAY;IAGzC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAY;IAIhD,SAAS,EAAE,MAAM,GAAG,SAAS,CAAY;IACzC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAY;IAC5C,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAY;IAClD,0BAA0B,EAAE,MAAM,CAAoB;IAEtD,OAAO,CAAC,cAAc,CAAC,CAAgB;IAGvC,qBAAqB,EAAE,OAAO,CAAQ;IAGtC,WAAW,EAAE,QAAQ,CAAK;IAI1B,YAAY,EAAE,YAAY,CAAK;IAI/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IAGnC,aAAa,EAAE;QACb,gBAAgB,EAAE,MAAM,CAAA;QACxB,mBAAmB,EAAE,MAAM,CAAA;QAC3B,gBAAgB,EAAE,OAAO,CAAA;QACzB,iBAAiB,EAAE,OAAO,CAAA;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAC1B,CAOA;IAGD,UAAU,CAAC,EAAE,UAAU,CAAA;IAGvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAGzB,YAAY,CAAC,EAAE,eAAe,CAAA;IAG9B,kBAAkB,CAAC,EAAE,cAAc,GAAG,mBAAmB,CAAA;IAGzD,OAAO,CAAC,SAAS,CAAC,CAAM;IAGxB,YAAY,EAAE,YAAY,CAGzB;IAGD,YAAY,EAAE,qBAAqB,EAAE,CAAK;IAG1C,WAAW,EAAE,OAAO,CAAQ;IAI5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,YAAY,CAAC,CAAe;IAEpC,gBAAgB,EAAE,gBAAgB,CAgBjC;IAED;;;;;;;OAOG;IACH,YACS,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EAC/B,UAAU,CAAC,EAAE,MAAM,EAKpB;IAED;;OAEG;IACH,aAAa,IAAI,MAAM,CAEtB;IAED;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGhC;IAED;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAGrC;IAED;;;;;;;;;OASG;IACH,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI,CAMjE;IAED;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAMnD;IAED;;;;OAIG;IACH,mBAAmB,CACjB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,GAAG;QACpE,IAAI,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAA;QACxC,eAAe,CAAC,EAAE,sBAAsB,CAAA;KACzC,GACA,IAAI,CAwBN;IAED;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAQ3D;IAED;;;;;;OAMG;IACH,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAGnD;IAED;;;;OAIG;IACH,2BAA2B,CAAC,cAAc,EAAE,cAAc,GAAG,mBAAmB,GAAG,IAAI,CAGtF;IAED;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,OAAO,OAAO,GAAG,IAAI,CAG5C;IAED;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI/C;IAED;;;;OAIG;IACH,qBAAqB,CACnB,YAAY,GAAE,YAAY,GAAG,cAA+C,GAC3E,IAAI,CAGN;IAED;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGvC;IAED;;;OAGG;IACH,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG7C;IAED;;OAEG;IACH,eAAe,CACb,GAAG,EAAE,MAAM,EACX,MAAM,GAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,oBAAoB,CAAC,EAAE,MAAM,CAAA;KACzB,GACL,IAAI,CAQN;IAED;;;OAGG;IACH,oBAAoB,CAClB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE;QACN,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB,SAAS,CAAC,EAAE,MAAM,CAAA;KACd,GACL,IAAI,CAiBN;IAED;;;;OAIG;IACH,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAG7C;IAED;;;OAGG;IACH,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAG7C;IAED;;OAEG;IACH,kCAAkC,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CAG5E;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAM1D;IAED;;OAEG;IACH,yBAAyB,CAAC,MAAM,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAKpE;IAED;;;OAGG;IACH,4BAA4B,CAAC,MAAM,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAQ5F;IAED;;;OAGG;IACH,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAGvD;IAED;;;OAGG;IACH,8BAA8B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAGpD;IAED;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASpE;IAED;;;;OAIG;IACG,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY5D;IAED;;;;OAIG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAG/D;IAED;;;;OAIG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAGjE;IAED;;;;OAIG;IACH,8BAA8B,CAC5B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,UAAU,EAAE,SAAS,EAAE,CAAA;KAAE,GACvF,IAAI,CAMN;IAED;;;;OAIG;IACH,+BAA+B,CAC7B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,aAAa,GAC7C,IAAI,CAIN;IAED;;;;;;;;;;;;;OAaG;IACH,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAMhD;IAED;;;;;;;;;;OAUG;IACG,eAAe,CAAC,qBAAqB,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAsFjE;IAED,+FAA+F;IAC/F,OAAO,CAAC,oBAAoB;IA4B5B,sEAAsE;IACtE,OAAO,CAAC,eAAe;IAWvB,mEAAmE;IACnE,OAAO,CAAC,gBAAgB;IAoCxB,OAAO,CAAC,oBAAoB;YAYd,gBAAgB;YAyBhB,0BAA0B;IAWxC,4CAA4C;IAC5C,OAAO,CAAC,8BAA8B;IA+BtC,iEAAiE;IACjE,OAAO,CAAC,mBAAmB;IAK3B,6DAA6D;YAC/C,eAAe;IAqB7B,kEAAkE;IAClE,OAAO,CAAC,gBAAgB;IAkBxB;;;OAGG;IACH,OAAO,CAAC,UAAU;IASlB;;;OAGG;IACH,OAAO,CAAC,WAAW;IASnB;;;OAGG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA+BrB,sEAAsE;YACxD,eAAe;IAiB7B,4EAA4E;YAC9D,iBAAiB;IAyB/B,2FAA2F;YAC7E,iBAAiB;IAoB/B,mEAAmE;YACrD,uBAAuB;IAYrC,4DAA4D;YAC9C,yBAAyB;YASzB,cAAc;YAmDd,mBAAmB;IAyIjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,uBAAuB;IAS/B,OAAO,CAAC,qBAAqB;YAYf,gBAAgB;IAkD9B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAoDlC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA2qC3B;IAED;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;YAEa,cAAc;IAoC5B;;;OAGG;YACW,cAAc;IA6B5B,mDAAmD;YACrC,kBAAkB;IAchC,6EAA6E;YAC/D,kBAAkB;IAmBhC,sEAAsE;IACtE,OAAO,CAAC,qBAAqB;IAa7B,gFAAgF;IAChF,OAAO,CAAC,oBAAoB;IAqB5B,uEAAuE;YACzD,uBAAuB;IAQrC,uFAAuF;YACzE,qBAAqB;IASnC,OAAO,CAAC,wBAAwB;CAwBjC"}