@bsv/overlay-express 2.2.0 → 2.3.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.
@@ -2,4 +2,5 @@ export { default, type EngineConfig, type HealthCheckDefinition, type HealthChec
2
2
  export { BanService, type BannedRecord } from './src/BanService.js';
3
3
  export { BanAwareLookupWrapper } from './src/BanAwareLookupWrapper.js';
4
4
  export { JanitorService, type JanitorConfig, type JanitorReport, type HostHealthResult } from './src/JanitorService.js';
5
+ export { OverlayMonitor, analyzeOverlayLookupResponse, type OverlayLookupOutputSummary, type OverlayLookupProbe, type OverlayLookupProbeResult, type OverlayMonitorConfig, type OverlayMonitorLogger, type OverlayMonitorReport, type OverlayMonitorTarget, type OverlayMonitorThresholds, type OverlayMonitorWarning } from './src/OverlayMonitor.js';
5
6
  //# sourceMappingURL=mod.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../mod.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAA"}
1
+ {"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../mod.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACvH,OAAO,EACL,cAAc,EACd,4BAA4B,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAA"}
@@ -91,6 +91,7 @@ export default class OverlayExpress {
91
91
  services: Record<string, LookupService>;
92
92
  enableGASPSync: boolean;
93
93
  arcApiKey: string | undefined;
94
+ arcCallbackToken: string | undefined;
94
95
  verboseRequestLogging: boolean;
95
96
  webUIConfig: UIConfig;
96
97
  engineConfig: EngineConfig;
@@ -176,6 +177,11 @@ export default class OverlayExpress {
176
177
  * @param apiKey - The ARC API key
177
178
  */
178
179
  configureArcApiKey(apiKey: string): void;
180
+ /**
181
+ * Configures the ARC callback token expected by /arc-ingest.
182
+ * @param token - The token ARC should present when posting callback notifications.
183
+ */
184
+ configureArcCallbackToken(token: string): void;
179
185
  /**
180
186
  * Enables or disables GASP synchronization (high-level setting).
181
187
  * This is a broad toggle that can be overridden or customized through syncConfiguration.
@@ -189,7 +195,7 @@ export default class OverlayExpress {
189
195
  configureVerboseRequestLogging(enable: boolean): void;
190
196
  /**
191
197
  * Configure Knex (SQL) database connection.
192
- * @param config - Knex configuration object, or MySQL connection string (e.g. mysql://overlayAdmin:overlay123@mysql:3306/overlay).
198
+ * @param config - Knex configuration object, or a MySQL connection string loaded from configuration.
193
199
  */
194
200
  configureKnex(config: Knex.Knex.Config | string): Promise<void>;
195
201
  /**
@@ -252,6 +258,18 @@ export default class OverlayExpress {
252
258
  * @param autoConfigureShipSlap - Whether to auto-configure SHIP and SLAP services (default: true)
253
259
  */
254
260
  configureEngine(autoConfigureShipSlap?: boolean): Promise<void>;
261
+ /** Wrap SHIP/SLAP with ban-aware filter if BanService is configured. */
262
+ private wrapBanAwareServices;
263
+ /** Build the sync config based on enableGASPSync and engineConfig. */
264
+ private buildSyncConfig;
265
+ /** Build the ARC broadcaster if an API key is configured. */
266
+ private buildBroadcaster;
267
+ /** Resolve the SLAP trackers from config or network defaults. */
268
+ private resolveSlapTrackers;
269
+ /** Build the WalletAdvertiser (or use user-provided one). */
270
+ private buildAdvertiser;
271
+ /** Initialize the server wallet for BSV mutual authentication. */
272
+ private initServerWallet;
255
273
  /**
256
274
  * Ensures that Knex is configured and returns it.
257
275
  * @throws Error if Knex is not configured
@@ -271,6 +289,16 @@ export default class OverlayExpress {
271
289
  * Creates a JanitorService instance with current configuration.
272
290
  */
273
291
  private createJanitor;
292
+ /** Ban a domain and remove all its SHIP/SLAP records from MongoDB. */
293
+ private handleBanDomain;
294
+ /** Parse outpoint string, ban it, and evict it from all lookup services. */
295
+ private handleBanOutpoint;
296
+ /** Evict an output from a specific service or all services (silent per-service errors). */
297
+ private evictFromServices;
298
+ /** Look up the domain of an outpoint from SHIP or SLAP records. */
299
+ private lookupDomainForOutpoint;
300
+ /** Ban a domain and delete all SHIP/SLAP records for it. */
301
+ private banDomainAndRemoveRecords;
274
302
  private runHealthCheck;
275
303
  private collectHealthReport;
276
304
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"OverlayExpress.d.ts","sourceRoot":"","sources":["../../../src/OverlayExpress.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAA;AAE7B,OAAO,EAAE,MAAM,EAAe,aAAa,EAAE,YAAY,EAAyB,UAAU,EAAE,MAAM,cAAc,CAAA;AAClH,OAAO,EAEL,YAAY,EAKZ,WAAW,EACX,2BAA2B,EAS3B,eAAe,EAChB,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;AAK5C;;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;AAqCD;;GAEG;AACH,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,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,KAAK,CAAC,CAAA;IAC7D,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;CAC5C;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,MAAM,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,CAAC,GAAG,IAAI,CAAA;AAE3M,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;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IAuGxB,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,MAAM;IAClB,gBAAgB,EAAE,MAAM;IAvGjC,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;IAG9B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAY;IAGzC,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;KAC1B,CAIE;IAGH,UAAU,CAAC,EAAE,UAAU,CAAA;IAGvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAGzB,YAAY,CAAC,EAAE,eAAe,CAAA;IAG9B,OAAO,CAAC,SAAS,CAAC,CAAM;IAGxB,YAAY,EAAE,YAAY,CAGzB;IAGD,YAAY,EAAE,qBAAqB,EAAE,CAAK;IAG1C,WAAW,EAAE,OAAO,CAAQ;IAE5B;;;;;;;OAOG;gBAEM,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EAC/B,UAAU,CAAC,EAAE,MAAM;IAOrB;;OAEG;IACH,aAAa,IAAK,MAAM;IAIxB;;;OAGG;IACH,aAAa,CAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAKlC;;;OAGG;IACH,cAAc,CAAE,MAAM,EAAE,QAAQ,GAAG,IAAI;IAKvC;;;;;;OAMG;IACH,gBAAgB,CAAE,MAAM,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI;IAQnE;;OAEG;IACH,eAAe,CAAE,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAQrD;;OAEG;IACH,mBAAmB,CAAE,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAU7D;;;;;;OAMG;IACH,yBAAyB,CAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAKrD;;;OAGG;IACH,eAAe,CAAE,MAAM,EAAE,OAAO,OAAO,GAAG,IAAI;IAK9C;;;;OAIG;IACH,gBAAgB,CAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMjD;;;;OAIG;IACH,qBAAqB,CAAE,YAAY,GAAE,YAAY,GAAG,cAA+C,GAAG,IAAI;IAK1G;;;OAGG;IACH,kBAAkB,CAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKzC;;;;OAIG;IACH,uBAAuB,CAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAK/C;;;OAGG;IACH,8BAA8B,CAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAKtD;;;OAGG;IACG,aAAa,CAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtE;;;;OAIG;IACG,cAAc,CAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D;;;;OAIG;IACH,qBAAqB,CAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAKjE;;;;OAIG;IACH,sBAAsB,CAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAKnE;;;;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;IAQP;;;;OAIG;IACH,+BAA+B,CAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,aAAa,GAAG,IAAI;IAMpG;;;;;;;;;;;;;OAaG;IACH,qBAAqB,CAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAQlD;;;;;;;;;;OAUG;IACG,eAAe,CAAE,qBAAqB,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAoJnE;;;OAGG;IACH,OAAO,CAAC,UAAU;IAOlB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAOnB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,aAAa;YAYP,cAAc;YAsCd,mBAAmB;IA8HjC;;;OAGG;IACG,KAAK,IAAK,OAAO,CAAC,IAAI,CAAC;CA2+B9B"}
1
+ {"version":3,"file":"OverlayExpress.d.ts","sourceRoot":"","sources":["../../../src/OverlayExpress.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,125 @@
1
+ export interface OverlayMonitorLogger {
2
+ log: (...args: any[]) => void;
3
+ warn: (...args: any[]) => void;
4
+ error: (...args: any[]) => void;
5
+ }
6
+ export interface OverlayLookupProbe {
7
+ name?: string;
8
+ service: string;
9
+ query: unknown;
10
+ maxOutputs?: number;
11
+ }
12
+ export interface OverlayMonitorTarget {
13
+ name: string;
14
+ baseUrl: string;
15
+ probes: OverlayLookupProbe[];
16
+ headers?: Record<string, string>;
17
+ }
18
+ export interface OverlayMonitorThresholds {
19
+ responseBytes?: number;
20
+ beefBytes?: number;
21
+ txsWithoutProof?: number;
22
+ requireSubjectProof?: boolean;
23
+ }
24
+ export interface OverlayMonitorConfig {
25
+ targets: OverlayMonitorTarget[];
26
+ thresholds?: OverlayMonitorThresholds;
27
+ intervalMs?: number;
28
+ /** Per-probe request timeout in milliseconds. Defaults to 30000. */
29
+ timeoutMs?: number;
30
+ fetchImpl?: typeof fetch;
31
+ logger?: OverlayMonitorLogger;
32
+ onReport?: (report: OverlayMonitorReport) => Promise<void> | void;
33
+ now?: () => Date;
34
+ }
35
+ export interface OverlayMonitorWarning {
36
+ code: 'response-bytes' | 'beef-bytes' | 'txs-without-proof' | 'subject-proof-missing';
37
+ message: string;
38
+ value: number | boolean;
39
+ threshold?: number | boolean;
40
+ outputIndex?: number;
41
+ txid?: string;
42
+ }
43
+ export interface OverlayLookupOutputSummary {
44
+ outputIndex: number;
45
+ txid?: string;
46
+ beefBytes: number;
47
+ txCount?: number;
48
+ proofCount?: number;
49
+ txsWithoutProof?: number;
50
+ subjectHasProof?: boolean;
51
+ subjectRawTxBytes?: number;
52
+ currentToSubjectRawRatio?: number;
53
+ contextBytes?: number;
54
+ error?: string;
55
+ }
56
+ export interface OverlayLookupProbeResult {
57
+ target: string;
58
+ url: string;
59
+ probe: string;
60
+ service: string;
61
+ status: number;
62
+ ok: boolean;
63
+ responseBytes: number;
64
+ outputCount: number;
65
+ analyzedOutputCount: number;
66
+ outputs: OverlayLookupOutputSummary[];
67
+ warnings: OverlayMonitorWarning[];
68
+ durationMs: number;
69
+ error?: string;
70
+ }
71
+ export interface OverlayMonitorReport {
72
+ startedAt: Date;
73
+ completedAt: Date;
74
+ durationMs: number;
75
+ results: OverlayLookupProbeResult[];
76
+ summary: {
77
+ targetCount: number;
78
+ probeCount: number;
79
+ failedProbeCount: number;
80
+ responseBytes: number;
81
+ outputCount: number;
82
+ analyzedOutputCount: number;
83
+ outputsMissingSubjectProof: number;
84
+ warningCount: number;
85
+ };
86
+ }
87
+ interface AnalyzeOptions {
88
+ target: string;
89
+ url: string;
90
+ probe: string;
91
+ service: string;
92
+ status: number;
93
+ ok: boolean;
94
+ responseBody: unknown;
95
+ responseBytes: number;
96
+ durationMs: number;
97
+ thresholds?: OverlayMonitorThresholds;
98
+ maxOutputs?: number;
99
+ error?: string;
100
+ }
101
+ /**
102
+ * OverlayMonitor runs generic Overlay Express /lookup probes and reports response
103
+ * size plus BEEF proof shape. It is intended for long-running monitor workers or
104
+ * scheduled jobs, analogous to a storage monitor but scoped to overlay health.
105
+ */
106
+ export declare class OverlayMonitor {
107
+ private readonly targets;
108
+ private readonly thresholds;
109
+ private readonly fetchImpl;
110
+ private readonly logger;
111
+ private readonly onReport?;
112
+ private readonly now;
113
+ private readonly intervalMs?;
114
+ private readonly timeoutMs;
115
+ private timer?;
116
+ private running;
117
+ constructor(config: OverlayMonitorConfig);
118
+ runOnce(): Promise<OverlayMonitorReport>;
119
+ start(): void;
120
+ stop(): void;
121
+ private runProbe;
122
+ }
123
+ export declare function analyzeOverlayLookupResponse(options: AnalyzeOptions): OverlayLookupProbeResult;
124
+ export {};
125
+ //# sourceMappingURL=OverlayMonitor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"OverlayMonitor.d.ts","sourceRoot":"","sources":["../../../src/OverlayMonitor.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAC7B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAC9B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,kBAAkB,EAAE,CAAA;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,oBAAoB,EAAE,CAAA;IAC/B,UAAU,CAAC,EAAE,wBAAwB,CAAA;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,MAAM,CAAC,EAAE,oBAAoB,CAAA;IAC7B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACjE,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,gBAAgB,GAAG,YAAY,GAAG,mBAAmB,GAAG,uBAAuB,CAAA;IACrF,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,EAAE,EAAE,OAAO,CAAA;IACX,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,OAAO,EAAE,0BAA0B,EAAE,CAAA;IACrC,QAAQ,EAAE,qBAAqB,EAAE,CAAA;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,IAAI,CAAA;IACf,WAAW,EAAE,IAAI,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,wBAAwB,EAAE,CAAA;IACnC,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,EAAE,MAAM,CAAA;QAClB,gBAAgB,EAAE,MAAM,CAAA;QACxB,aAAa,EAAE,MAAM,CAAA;QACrB,WAAW,EAAE,MAAM,CAAA;QACnB,mBAAmB,EAAE,MAAM,CAAA;QAC3B,0BAA0B,EAAE,MAAM,CAAA;QAClC,YAAY,EAAE,MAAM,CAAA;KACrB,CAAA;CACF;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,EAAE,EAAE,OAAO,CAAA;IACX,YAAY,EAAE,OAAO,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,wBAAwB,CAAA;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AASD;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAwD;IAClF,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,KAAK,CAAC,CAAgC;IAC9C,OAAO,CAAC,OAAO,CAAQ;gBAEV,MAAM,EAAE,oBAAoB;IAanC,OAAO,IAAK,OAAO,CAAC,oBAAoB,CAAC;IAuB/C,KAAK,IAAK,IAAI;IAmBd,IAAI,IAAK,IAAI;YAOC,QAAQ;CAsEvB;AAED,wBAAgB,4BAA4B,CAAE,OAAO,EAAE,cAAc,GAAG,wBAAwB,CAmC/F"}