@bsv/overlay-express 2.2.1 → 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.
- package/README.md +33 -0
- package/dist/cjs/mod.js +4 -1
- package/dist/cjs/mod.js.map +1 -1
- package/dist/cjs/package.json +11 -10
- package/dist/cjs/src/OverlayExpress.js +27 -1
- package/dist/cjs/src/OverlayExpress.js.map +1 -1
- package/dist/cjs/src/OverlayMonitor.js +306 -0
- package/dist/cjs/src/OverlayMonitor.js.map +1 -0
- package/dist/cjs/tsconfig.cjs.tsbuildinfo +1 -1
- package/dist/esm/mod.js +1 -0
- package/dist/esm/mod.js.map +1 -1
- package/dist/esm/src/OverlayExpress.js +27 -1
- package/dist/esm/src/OverlayExpress.js.map +1 -1
- package/dist/esm/src/OverlayMonitor.js +304 -0
- package/dist/esm/src/OverlayMonitor.js.map +1 -0
- package/dist/esm/tsconfig.esm.tsbuildinfo +1 -1
- package/dist/types/mod.d.ts +1 -0
- package/dist/types/mod.d.ts.map +1 -1
- package/dist/types/src/OverlayExpress.d.ts +6 -0
- package/dist/types/src/OverlayExpress.d.ts.map +1 -1
- package/dist/types/src/OverlayMonitor.d.ts +125 -0
- package/dist/types/src/OverlayMonitor.d.ts.map +1 -0
- package/dist/types/tsconfig.types.tsbuildinfo +1 -1
- package/mod.ts +13 -0
- package/package.json +11 -10
- package/src/OverlayExpress.ts +30 -2
- package/src/OverlayMonitor.ts +445 -0
- package/src/__tests__/OverlayExpress.test.ts +86 -1
- package/src/__tests__/OverlayMonitor.test.ts +116 -0
package/dist/types/mod.d.ts
CHANGED
|
@@ -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
|
package/dist/types/mod.d.ts.map
CHANGED
|
@@ -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.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"OverlayExpress.d.ts","sourceRoot":"","sources":["../../../src/OverlayExpress.ts"],"names":[],"mappings":"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
|
|
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":"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"}
|