@korajs/devtools 0.0.0-canary-20261008174129
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/LICENSE +21 -0
- package/README.md +49 -0
- package/dist/chunk-LQFL4TWM.js +999 -0
- package/dist/chunk-LQFL4TWM.js.map +1 -0
- package/dist/embed-overlay-Dwys5PYM.d.cts +170 -0
- package/dist/embed-overlay-Dwys5PYM.d.ts +170 -0
- package/dist/extension/background.cjs +65 -0
- package/dist/extension/background.cjs.map +1 -0
- package/dist/extension/background.d.cts +2 -0
- package/dist/extension/background.d.ts +2 -0
- package/dist/extension/background.js +63 -0
- package/dist/extension/background.js.map +1 -0
- package/dist/extension/content-script.cjs +18 -0
- package/dist/extension/content-script.cjs.map +1 -0
- package/dist/extension/content-script.d.cts +2 -0
- package/dist/extension/content-script.d.ts +2 -0
- package/dist/extension/content-script.js +16 -0
- package/dist/extension/content-script.js.map +1 -0
- package/dist/extension/devtools-page.html +45 -0
- package/dist/extension/devtools.cjs +8 -0
- package/dist/extension/devtools.cjs.map +1 -0
- package/dist/extension/devtools.d.cts +2 -0
- package/dist/extension/devtools.d.ts +2 -0
- package/dist/extension/devtools.html +599 -0
- package/dist/extension/devtools.js +6 -0
- package/dist/extension/devtools.js.map +1 -0
- package/dist/extension/manifest.json +20 -0
- package/dist/extension/panel.cjs +1311 -0
- package/dist/extension/panel.cjs.map +1 -0
- package/dist/extension/panel.d.cts +2 -0
- package/dist/extension/panel.d.ts +2 -0
- package/dist/extension/panel.js +1309 -0
- package/dist/extension/panel.js.map +1 -0
- package/dist/index.cjs +1353 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +107 -0
- package/dist/index.d.ts +107 -0
- package/dist/index.js +326 -0
- package/dist/index.js.map +1 -0
- package/dist/overlay.cjs +1027 -0
- package/dist/overlay.cjs.map +1 -0
- package/dist/overlay.d.cts +2 -0
- package/dist/overlay.d.ts +2 -0
- package/dist/overlay.js +7 -0
- package/dist/overlay.js.map +1 -0
- package/package.json +55 -0
package/dist/index.js
ADDED
|
@@ -0,0 +1,326 @@
|
|
|
1
|
+
import {
|
|
2
|
+
buildPanelModel,
|
|
3
|
+
computeStatistics,
|
|
4
|
+
filterEvents,
|
|
5
|
+
getEventCategory,
|
|
6
|
+
mountKoraDevtoolsOverlay,
|
|
7
|
+
renderDevtoolsPanel
|
|
8
|
+
} from "./chunk-LQFL4TWM.js";
|
|
9
|
+
|
|
10
|
+
// src/bridge/message-bridge.ts
|
|
11
|
+
var DEFAULT_CHANNEL = "kora-devtools";
|
|
12
|
+
var MessageBridge = class {
|
|
13
|
+
channelName;
|
|
14
|
+
listeners = /* @__PURE__ */ new Set();
|
|
15
|
+
messageHandler;
|
|
16
|
+
destroyed = false;
|
|
17
|
+
constructor(channelName = DEFAULT_CHANNEL) {
|
|
18
|
+
this.channelName = channelName;
|
|
19
|
+
if (typeof window === "undefined") {
|
|
20
|
+
this.messageHandler = null;
|
|
21
|
+
return;
|
|
22
|
+
}
|
|
23
|
+
this.messageHandler = (event) => {
|
|
24
|
+
if (this.destroyed) return;
|
|
25
|
+
const data = event.data;
|
|
26
|
+
if (!data || data.source !== this.channelName) return;
|
|
27
|
+
for (const listener of this.listeners) {
|
|
28
|
+
listener(data.payload);
|
|
29
|
+
}
|
|
30
|
+
};
|
|
31
|
+
window.addEventListener("message", this.messageHandler);
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Post a timestamped event through the bridge.
|
|
35
|
+
* No-op if window is not available or the bridge has been destroyed.
|
|
36
|
+
*/
|
|
37
|
+
send(event) {
|
|
38
|
+
if (this.destroyed || typeof window === "undefined") return;
|
|
39
|
+
const message = {
|
|
40
|
+
source: this.channelName,
|
|
41
|
+
payload: event
|
|
42
|
+
};
|
|
43
|
+
window.postMessage(message, "*");
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Register a callback for events received through the bridge.
|
|
47
|
+
* Returns an unsubscribe function.
|
|
48
|
+
*/
|
|
49
|
+
onReceive(callback) {
|
|
50
|
+
if (this.destroyed) return () => {
|
|
51
|
+
};
|
|
52
|
+
this.listeners.add(callback);
|
|
53
|
+
return () => {
|
|
54
|
+
this.listeners.delete(callback);
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Remove all listeners and detach from window.
|
|
59
|
+
* After calling destroy, all operations become no-ops.
|
|
60
|
+
*/
|
|
61
|
+
destroy() {
|
|
62
|
+
if (this.destroyed) return;
|
|
63
|
+
this.destroyed = true;
|
|
64
|
+
this.listeners.clear();
|
|
65
|
+
if (this.messageHandler && typeof window !== "undefined") {
|
|
66
|
+
window.removeEventListener("message", this.messageHandler);
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
};
|
|
70
|
+
|
|
71
|
+
// src/buffer/event-buffer.ts
|
|
72
|
+
var DEFAULT_CAPACITY = 1e4;
|
|
73
|
+
var EventBuffer = class {
|
|
74
|
+
_capacity;
|
|
75
|
+
buffer;
|
|
76
|
+
/** Index where the next event will be written */
|
|
77
|
+
head = 0;
|
|
78
|
+
/** Total number of events ever pushed (used to compute readable range) */
|
|
79
|
+
_totalPushed = 0;
|
|
80
|
+
constructor(capacity = DEFAULT_CAPACITY) {
|
|
81
|
+
if (capacity < 1) {
|
|
82
|
+
throw new Error("EventBuffer capacity must be at least 1");
|
|
83
|
+
}
|
|
84
|
+
this._capacity = capacity;
|
|
85
|
+
this.buffer = new Array(capacity);
|
|
86
|
+
}
|
|
87
|
+
/** Maximum number of events the buffer can hold */
|
|
88
|
+
get capacity() {
|
|
89
|
+
return this._capacity;
|
|
90
|
+
}
|
|
91
|
+
/** Current number of events in the buffer */
|
|
92
|
+
get size() {
|
|
93
|
+
return Math.min(this._totalPushed, this._capacity);
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* Append an event to the buffer.
|
|
97
|
+
* If the buffer is at capacity, the oldest event is evicted.
|
|
98
|
+
*/
|
|
99
|
+
push(event) {
|
|
100
|
+
this.buffer[this.head] = event;
|
|
101
|
+
this.head = (this.head + 1) % this._capacity;
|
|
102
|
+
this._totalPushed++;
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* Returns all events in insertion order (oldest first).
|
|
106
|
+
*/
|
|
107
|
+
getAll() {
|
|
108
|
+
if (this._totalPushed === 0) return [];
|
|
109
|
+
const result = [];
|
|
110
|
+
if (this._totalPushed <= this._capacity) {
|
|
111
|
+
for (let i = 0; i < this.head; i++) {
|
|
112
|
+
const event = this.buffer[i];
|
|
113
|
+
if (event) result.push(event);
|
|
114
|
+
}
|
|
115
|
+
} else {
|
|
116
|
+
for (let i = 0; i < this._capacity; i++) {
|
|
117
|
+
const index = (this.head + i) % this._capacity;
|
|
118
|
+
const event = this.buffer[index];
|
|
119
|
+
if (event) result.push(event);
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
return result;
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* Returns events whose sequential IDs fall within [start, end] (inclusive).
|
|
126
|
+
*/
|
|
127
|
+
getRange(start, end) {
|
|
128
|
+
return this.getAll().filter((e) => e.id >= start && e.id <= end);
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* Returns events matching a specific KoraEventType.
|
|
132
|
+
*/
|
|
133
|
+
getByType(type) {
|
|
134
|
+
return this.getAll().filter((e) => e.event.type === type);
|
|
135
|
+
}
|
|
136
|
+
/** Remove all events from the buffer */
|
|
137
|
+
clear() {
|
|
138
|
+
this.buffer.fill(void 0);
|
|
139
|
+
this.head = 0;
|
|
140
|
+
this._totalPushed = 0;
|
|
141
|
+
}
|
|
142
|
+
};
|
|
143
|
+
|
|
144
|
+
// src/instrumenter/instrumenter.ts
|
|
145
|
+
var DEFAULT_BUFFER_SIZE = 1e4;
|
|
146
|
+
var DEFAULT_CHANNEL_NAME = "kora-devtools";
|
|
147
|
+
var ALL_EVENT_TYPES = [
|
|
148
|
+
"operation:created",
|
|
149
|
+
"operation:applied",
|
|
150
|
+
"merge:started",
|
|
151
|
+
"merge:completed",
|
|
152
|
+
"merge:conflict",
|
|
153
|
+
"constraint:violated",
|
|
154
|
+
"sync:connected",
|
|
155
|
+
"sync:disconnected",
|
|
156
|
+
"sync:schema-mismatch",
|
|
157
|
+
"sync:auth-failed",
|
|
158
|
+
"sync:suspended",
|
|
159
|
+
"sync:apply-failed",
|
|
160
|
+
"sync:apply-blocked",
|
|
161
|
+
"sync:apply-retrying",
|
|
162
|
+
"sync:apply-recovered",
|
|
163
|
+
"sync:apply-abandoned",
|
|
164
|
+
"sync:sent",
|
|
165
|
+
"sync:received",
|
|
166
|
+
"sync:acknowledged",
|
|
167
|
+
"sync:diagnostics",
|
|
168
|
+
"sync:bandwidth",
|
|
169
|
+
"sync:initial-sync-progress",
|
|
170
|
+
"sync:durability-degraded",
|
|
171
|
+
"sync:durability-restored",
|
|
172
|
+
"store:persistence-error",
|
|
173
|
+
"store:quota-exceeded",
|
|
174
|
+
"store:log-integrity",
|
|
175
|
+
"store:rematerialized",
|
|
176
|
+
"store:storage-fallback",
|
|
177
|
+
"store:opfs-unavailable",
|
|
178
|
+
"store:durability-lost",
|
|
179
|
+
"store:db-name-collision",
|
|
180
|
+
"store:storage-blocked",
|
|
181
|
+
"store:storage-migrated",
|
|
182
|
+
"store:schema-ahead",
|
|
183
|
+
"replay:completed",
|
|
184
|
+
"query:subscribed",
|
|
185
|
+
"query:invalidated",
|
|
186
|
+
"query:executed",
|
|
187
|
+
"query:error",
|
|
188
|
+
"storage:persistence",
|
|
189
|
+
"connection:quality"
|
|
190
|
+
];
|
|
191
|
+
var Instrumenter = class {
|
|
192
|
+
constructor(emitter, config) {
|
|
193
|
+
this.emitter = emitter;
|
|
194
|
+
const bufferSize = config?.bufferSize ?? DEFAULT_BUFFER_SIZE;
|
|
195
|
+
const bridgeEnabled = config?.bridgeEnabled ?? true;
|
|
196
|
+
const channelName = config?.channelName ?? DEFAULT_CHANNEL_NAME;
|
|
197
|
+
this.buffer = new EventBuffer(bufferSize);
|
|
198
|
+
this.bridge = bridgeEnabled ? new MessageBridge(channelName) : null;
|
|
199
|
+
this.attachListeners();
|
|
200
|
+
}
|
|
201
|
+
emitter;
|
|
202
|
+
buffer;
|
|
203
|
+
bridge;
|
|
204
|
+
unsubscribers = [];
|
|
205
|
+
nextId = 1;
|
|
206
|
+
paused = false;
|
|
207
|
+
destroyed = false;
|
|
208
|
+
/** Access the underlying event buffer */
|
|
209
|
+
getBuffer() {
|
|
210
|
+
return this.buffer;
|
|
211
|
+
}
|
|
212
|
+
/** Access the message bridge, or null if bridge is disabled */
|
|
213
|
+
getBridge() {
|
|
214
|
+
return this.bridge;
|
|
215
|
+
}
|
|
216
|
+
/** Temporarily stop recording events. Events emitted while paused are dropped. */
|
|
217
|
+
pause() {
|
|
218
|
+
this.paused = true;
|
|
219
|
+
}
|
|
220
|
+
/** Resume recording events after a pause. */
|
|
221
|
+
resume() {
|
|
222
|
+
this.paused = false;
|
|
223
|
+
}
|
|
224
|
+
/** Whether the instrumenter is currently paused */
|
|
225
|
+
isPaused() {
|
|
226
|
+
return this.paused;
|
|
227
|
+
}
|
|
228
|
+
/**
|
|
229
|
+
* Detach all listeners from the emitter and destroy the bridge.
|
|
230
|
+
* After calling destroy, the instrumenter is inert.
|
|
231
|
+
*/
|
|
232
|
+
destroy() {
|
|
233
|
+
if (this.destroyed) return;
|
|
234
|
+
this.destroyed = true;
|
|
235
|
+
for (const unsub of this.unsubscribers) {
|
|
236
|
+
unsub();
|
|
237
|
+
}
|
|
238
|
+
this.unsubscribers.length = 0;
|
|
239
|
+
this.bridge?.destroy();
|
|
240
|
+
}
|
|
241
|
+
attachListeners() {
|
|
242
|
+
for (const eventType of ALL_EVENT_TYPES) {
|
|
243
|
+
const unsub = this.emitter.on(eventType, (event) => {
|
|
244
|
+
this.handleEvent(event);
|
|
245
|
+
});
|
|
246
|
+
this.unsubscribers.push(unsub);
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
handleEvent(event) {
|
|
250
|
+
if (this.paused || this.destroyed) return;
|
|
251
|
+
const timestamped = {
|
|
252
|
+
id: this.nextId++,
|
|
253
|
+
event,
|
|
254
|
+
receivedAt: Date.now()
|
|
255
|
+
};
|
|
256
|
+
this.buffer.push(timestamped);
|
|
257
|
+
this.bridge?.send(timestamped);
|
|
258
|
+
}
|
|
259
|
+
};
|
|
260
|
+
|
|
261
|
+
// src/extension/port-router.ts
|
|
262
|
+
var PortRouter = class {
|
|
263
|
+
panelClients = /* @__PURE__ */ new Map();
|
|
264
|
+
contentClients = /* @__PURE__ */ new Map();
|
|
265
|
+
handleConnection(port) {
|
|
266
|
+
if (port.name === "kora-panel") {
|
|
267
|
+
this.attachPanel(port);
|
|
268
|
+
return;
|
|
269
|
+
}
|
|
270
|
+
if (port.name === "kora-content") {
|
|
271
|
+
this.attachContent(port);
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
attachPanel(port) {
|
|
275
|
+
port.onMessage.addListener((message) => {
|
|
276
|
+
if (!isPanelInitMessage(message)) return;
|
|
277
|
+
this.panelClients.set(message.tabId, { tabId: message.tabId, port });
|
|
278
|
+
});
|
|
279
|
+
port.onDisconnect.addListener(() => {
|
|
280
|
+
for (const [tabId, client] of this.panelClients) {
|
|
281
|
+
if (client.port === port) {
|
|
282
|
+
this.panelClients.delete(tabId);
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
});
|
|
286
|
+
}
|
|
287
|
+
attachContent(port) {
|
|
288
|
+
const tabId = port.sender?.tab?.id;
|
|
289
|
+
if (typeof tabId !== "number") {
|
|
290
|
+
return;
|
|
291
|
+
}
|
|
292
|
+
this.contentClients.set(tabId, port);
|
|
293
|
+
port.onMessage.addListener((message) => {
|
|
294
|
+
if (!isContentEventMessage(message)) return;
|
|
295
|
+
const panel = this.panelClients.get(tabId);
|
|
296
|
+
if (!panel) return;
|
|
297
|
+
panel.port.postMessage({ type: "kora-event", payload: message.payload });
|
|
298
|
+
});
|
|
299
|
+
port.onDisconnect.addListener(() => {
|
|
300
|
+
this.contentClients.delete(tabId);
|
|
301
|
+
});
|
|
302
|
+
}
|
|
303
|
+
};
|
|
304
|
+
function isPanelInitMessage(value) {
|
|
305
|
+
if (typeof value !== "object" || value === null) return false;
|
|
306
|
+
const record = value;
|
|
307
|
+
return record.type === "panel-init" && typeof record.tabId === "number";
|
|
308
|
+
}
|
|
309
|
+
function isContentEventMessage(value) {
|
|
310
|
+
if (typeof value !== "object" || value === null) return false;
|
|
311
|
+
const record = value;
|
|
312
|
+
return record.type === "kora-event" && "payload" in record;
|
|
313
|
+
}
|
|
314
|
+
export {
|
|
315
|
+
EventBuffer,
|
|
316
|
+
Instrumenter,
|
|
317
|
+
MessageBridge,
|
|
318
|
+
PortRouter,
|
|
319
|
+
buildPanelModel,
|
|
320
|
+
computeStatistics,
|
|
321
|
+
filterEvents,
|
|
322
|
+
getEventCategory,
|
|
323
|
+
mountKoraDevtoolsOverlay,
|
|
324
|
+
renderDevtoolsPanel
|
|
325
|
+
};
|
|
326
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/bridge/message-bridge.ts","../src/buffer/event-buffer.ts","../src/instrumenter/instrumenter.ts","../src/extension/port-router.ts"],"sourcesContent":["import type { TimestampedEvent } from '../types'\n\nconst DEFAULT_CHANNEL = 'kora-devtools'\n\n/** Shape of messages posted through the bridge */\ninterface BridgeMessage {\n\tsource: string\n\tpayload: TimestampedEvent\n}\n\n/**\n * Communicates between the page context and a DevTools panel via window.postMessage.\n * All messages are namespaced with a `source` field to avoid collisions with other\n * postMessage consumers on the page.\n *\n * Safe to instantiate in non-browser environments (SSR/Node) — all operations\n * become no-ops when `window` is not available.\n */\nexport class MessageBridge {\n\tprivate readonly channelName: string\n\tprivate readonly listeners: Set<(event: TimestampedEvent) => void> = new Set()\n\tprivate readonly messageHandler: ((event: MessageEvent) => void) | null\n\tprivate destroyed = false\n\n\tconstructor(channelName: string = DEFAULT_CHANNEL) {\n\t\tthis.channelName = channelName\n\n\t\tif (typeof window === 'undefined') {\n\t\t\tthis.messageHandler = null\n\t\t\treturn\n\t\t}\n\n\t\t// Single shared handler that dispatches to all registered callbacks\n\t\tthis.messageHandler = (event: MessageEvent) => {\n\t\t\tif (this.destroyed) return\n\t\t\tconst data = event.data as Partial<BridgeMessage> | undefined\n\t\t\tif (!data || data.source !== this.channelName) return\n\n\t\t\tfor (const listener of this.listeners) {\n\t\t\t\tlistener(data.payload as TimestampedEvent)\n\t\t\t}\n\t\t}\n\n\t\twindow.addEventListener('message', this.messageHandler)\n\t}\n\n\t/**\n\t * Post a timestamped event through the bridge.\n\t * No-op if window is not available or the bridge has been destroyed.\n\t */\n\tsend(event: TimestampedEvent): void {\n\t\tif (this.destroyed || typeof window === 'undefined') return\n\n\t\tconst message: BridgeMessage = {\n\t\t\tsource: this.channelName,\n\t\t\tpayload: event,\n\t\t}\n\t\twindow.postMessage(message, '*')\n\t}\n\n\t/**\n\t * Register a callback for events received through the bridge.\n\t * Returns an unsubscribe function.\n\t */\n\tonReceive(callback: (event: TimestampedEvent) => void): () => void {\n\t\tif (this.destroyed) return () => {}\n\n\t\tthis.listeners.add(callback)\n\t\treturn () => {\n\t\t\tthis.listeners.delete(callback)\n\t\t}\n\t}\n\n\t/**\n\t * Remove all listeners and detach from window.\n\t * After calling destroy, all operations become no-ops.\n\t */\n\tdestroy(): void {\n\t\tif (this.destroyed) return\n\t\tthis.destroyed = true\n\t\tthis.listeners.clear()\n\n\t\tif (this.messageHandler && typeof window !== 'undefined') {\n\t\t\twindow.removeEventListener('message', this.messageHandler)\n\t\t}\n\t}\n}\n","import type { KoraEventType } from '@korajs/core'\nimport type { TimestampedEvent } from '../types'\n\nconst DEFAULT_CAPACITY = 10_000\n\n/**\n * Fixed-capacity ring buffer for storing timestamped events.\n * When the buffer is full, the oldest events are evicted to make room for new ones.\n * This prevents unbounded memory growth when events accumulate fast.\n */\nexport class EventBuffer {\n\tprivate readonly _capacity: number\n\tprivate readonly buffer: Array<TimestampedEvent | undefined>\n\t/** Index where the next event will be written */\n\tprivate head = 0\n\t/** Total number of events ever pushed (used to compute readable range) */\n\tprivate _totalPushed = 0\n\n\tconstructor(capacity: number = DEFAULT_CAPACITY) {\n\t\tif (capacity < 1) {\n\t\t\tthrow new Error('EventBuffer capacity must be at least 1')\n\t\t}\n\t\tthis._capacity = capacity\n\t\tthis.buffer = new Array<TimestampedEvent | undefined>(capacity)\n\t}\n\n\t/** Maximum number of events the buffer can hold */\n\tget capacity(): number {\n\t\treturn this._capacity\n\t}\n\n\t/** Current number of events in the buffer */\n\tget size(): number {\n\t\treturn Math.min(this._totalPushed, this._capacity)\n\t}\n\n\t/**\n\t * Append an event to the buffer.\n\t * If the buffer is at capacity, the oldest event is evicted.\n\t */\n\tpush(event: TimestampedEvent): void {\n\t\tthis.buffer[this.head] = event\n\t\tthis.head = (this.head + 1) % this._capacity\n\t\tthis._totalPushed++\n\t}\n\n\t/**\n\t * Returns all events in insertion order (oldest first).\n\t */\n\tgetAll(): readonly TimestampedEvent[] {\n\t\tif (this._totalPushed === 0) return []\n\n\t\tconst result: TimestampedEvent[] = []\n\n\t\tif (this._totalPushed <= this._capacity) {\n\t\t\t// Buffer hasn't wrapped yet — events are 0..head-1\n\t\t\tfor (let i = 0; i < this.head; i++) {\n\t\t\t\tconst event = this.buffer[i]\n\t\t\t\tif (event) result.push(event)\n\t\t\t}\n\t\t} else {\n\t\t\t// Buffer has wrapped — oldest is at head, newest is at head-1\n\t\t\tfor (let i = 0; i < this._capacity; i++) {\n\t\t\t\tconst index = (this.head + i) % this._capacity\n\t\t\t\tconst event = this.buffer[index]\n\t\t\t\tif (event) result.push(event)\n\t\t\t}\n\t\t}\n\n\t\treturn result\n\t}\n\n\t/**\n\t * Returns events whose sequential IDs fall within [start, end] (inclusive).\n\t */\n\tgetRange(start: number, end: number): readonly TimestampedEvent[] {\n\t\treturn this.getAll().filter((e) => e.id >= start && e.id <= end)\n\t}\n\n\t/**\n\t * Returns events matching a specific KoraEventType.\n\t */\n\tgetByType(type: KoraEventType): readonly TimestampedEvent[] {\n\t\treturn this.getAll().filter((e) => e.event.type === type)\n\t}\n\n\t/** Remove all events from the buffer */\n\tclear(): void {\n\t\tthis.buffer.fill(undefined)\n\t\tthis.head = 0\n\t\tthis._totalPushed = 0\n\t}\n}\n","import type { KoraEvent, KoraEventEmitter, KoraEventType } from '@korajs/core'\nimport { MessageBridge } from '../bridge/message-bridge'\nimport { EventBuffer } from '../buffer/event-buffer'\nimport type { DevtoolsConfig, TimestampedEvent } from '../types'\n\nconst DEFAULT_BUFFER_SIZE = 10_000\nconst DEFAULT_CHANNEL_NAME = 'kora-devtools'\n\n/** All event types the instrumenter subscribes to */\nexport const ALL_EVENT_TYPES: readonly KoraEventType[] = [\n\t'operation:created',\n\t'operation:applied',\n\t'merge:started',\n\t'merge:completed',\n\t'merge:conflict',\n\t'constraint:violated',\n\t'sync:connected',\n\t'sync:disconnected',\n\t'sync:schema-mismatch',\n\t'sync:auth-failed',\n\t'sync:suspended',\n\t'sync:apply-failed',\n\t'sync:apply-blocked',\n\t'sync:apply-retrying',\n\t'sync:apply-recovered',\n\t'sync:apply-abandoned',\n\t'sync:sent',\n\t'sync:received',\n\t'sync:acknowledged',\n\t'sync:diagnostics',\n\t'sync:bandwidth',\n\t'sync:initial-sync-progress',\n\t'sync:durability-degraded',\n\t'sync:durability-restored',\n\t'store:persistence-error',\n\t'store:quota-exceeded',\n\t'store:log-integrity',\n\t'store:rematerialized',\n\t'store:storage-fallback',\n\t'store:opfs-unavailable',\n\t'store:durability-lost',\n\t'store:db-name-collision',\n\t'store:storage-blocked',\n\t'store:storage-migrated',\n\t'store:schema-ahead',\n\t'replay:completed',\n\t'query:subscribed',\n\t'query:invalidated',\n\t'query:executed',\n\t'query:error',\n\t'storage:persistence',\n\t'connection:quality',\n] as const\n\n/**\n * Core orchestrator for Kora DevTools instrumentation.\n *\n * Attaches to a KoraEventEmitter, records all emitted events into a ring buffer\n * with sequential IDs and reception timestamps, and optionally forwards them\n * through a MessageBridge for consumption by a DevTools panel.\n *\n * @example\n * ```typescript\n * const instrumenter = new Instrumenter(app.emitter, { bufferSize: 5000 })\n * const buffer = instrumenter.getBuffer()\n * // ... later\n * instrumenter.destroy()\n * ```\n */\nexport class Instrumenter {\n\tprivate readonly buffer: EventBuffer\n\tprivate readonly bridge: MessageBridge | null\n\tprivate readonly unsubscribers: Array<() => void> = []\n\tprivate nextId = 1\n\tprivate paused = false\n\tprivate destroyed = false\n\n\tconstructor(\n\t\tprivate readonly emitter: KoraEventEmitter,\n\t\tconfig?: DevtoolsConfig,\n\t) {\n\t\tconst bufferSize = config?.bufferSize ?? DEFAULT_BUFFER_SIZE\n\t\tconst bridgeEnabled = config?.bridgeEnabled ?? true\n\t\tconst channelName = config?.channelName ?? DEFAULT_CHANNEL_NAME\n\n\t\tthis.buffer = new EventBuffer(bufferSize)\n\t\tthis.bridge = bridgeEnabled ? new MessageBridge(channelName) : null\n\n\t\tthis.attachListeners()\n\t}\n\n\t/** Access the underlying event buffer */\n\tgetBuffer(): EventBuffer {\n\t\treturn this.buffer\n\t}\n\n\t/** Access the message bridge, or null if bridge is disabled */\n\tgetBridge(): MessageBridge | null {\n\t\treturn this.bridge\n\t}\n\n\t/** Temporarily stop recording events. Events emitted while paused are dropped. */\n\tpause(): void {\n\t\tthis.paused = true\n\t}\n\n\t/** Resume recording events after a pause. */\n\tresume(): void {\n\t\tthis.paused = false\n\t}\n\n\t/** Whether the instrumenter is currently paused */\n\tisPaused(): boolean {\n\t\treturn this.paused\n\t}\n\n\t/**\n\t * Detach all listeners from the emitter and destroy the bridge.\n\t * After calling destroy, the instrumenter is inert.\n\t */\n\tdestroy(): void {\n\t\tif (this.destroyed) return\n\t\tthis.destroyed = true\n\n\t\tfor (const unsub of this.unsubscribers) {\n\t\t\tunsub()\n\t\t}\n\t\tthis.unsubscribers.length = 0\n\n\t\tthis.bridge?.destroy()\n\t}\n\n\tprivate attachListeners(): void {\n\t\tfor (const eventType of ALL_EVENT_TYPES) {\n\t\t\tconst unsub = this.emitter.on(eventType, (event: KoraEvent) => {\n\t\t\t\tthis.handleEvent(event)\n\t\t\t})\n\t\t\tthis.unsubscribers.push(unsub)\n\t\t}\n\t}\n\n\tprivate handleEvent(event: KoraEvent): void {\n\t\tif (this.paused || this.destroyed) return\n\n\t\tconst timestamped: TimestampedEvent = {\n\t\t\tid: this.nextId++,\n\t\t\tevent,\n\t\t\treceivedAt: Date.now(),\n\t\t}\n\n\t\tthis.buffer.push(timestamped)\n\t\tthis.bridge?.send(timestamped)\n\t}\n}\n","export interface ExtensionPort {\n\tname: string\n\tonMessage: {\n\t\taddListener(callback: (message: unknown) => void): void\n\t}\n\tonDisconnect: {\n\t\taddListener(callback: () => void): void\n\t}\n\tpostMessage(message: unknown): void\n\tsender?: { tab?: { id?: number } }\n}\n\ninterface PanelClient {\n\tport: ExtensionPort\n\ttabId: number\n}\n\n/**\n * Routes content-script events to the matching DevTools panel by tab.\n */\nexport class PortRouter {\n\tprivate readonly panelClients = new Map<number, PanelClient>()\n\tprivate readonly contentClients = new Map<number, ExtensionPort>()\n\n\thandleConnection(port: ExtensionPort): void {\n\t\tif (port.name === 'kora-panel') {\n\t\t\tthis.attachPanel(port)\n\t\t\treturn\n\t\t}\n\n\t\tif (port.name === 'kora-content') {\n\t\t\tthis.attachContent(port)\n\t\t}\n\t}\n\n\tprivate attachPanel(port: ExtensionPort): void {\n\t\tport.onMessage.addListener((message) => {\n\t\t\tif (!isPanelInitMessage(message)) return\n\n\t\t\tthis.panelClients.set(message.tabId, { tabId: message.tabId, port })\n\t\t})\n\n\t\tport.onDisconnect.addListener(() => {\n\t\t\tfor (const [tabId, client] of this.panelClients) {\n\t\t\t\tif (client.port === port) {\n\t\t\t\t\tthis.panelClients.delete(tabId)\n\t\t\t\t}\n\t\t\t}\n\t\t})\n\t}\n\n\tprivate attachContent(port: ExtensionPort): void {\n\t\tconst tabId = port.sender?.tab?.id\n\t\tif (typeof tabId !== 'number') {\n\t\t\treturn\n\t\t}\n\n\t\tthis.contentClients.set(tabId, port)\n\n\t\tport.onMessage.addListener((message) => {\n\t\t\tif (!isContentEventMessage(message)) return\n\n\t\t\tconst panel = this.panelClients.get(tabId)\n\t\t\tif (!panel) return\n\n\t\t\tpanel.port.postMessage({ type: 'kora-event', payload: message.payload })\n\t\t})\n\n\t\tport.onDisconnect.addListener(() => {\n\t\t\tthis.contentClients.delete(tabId)\n\t\t})\n\t}\n}\n\nfunction isPanelInitMessage(value: unknown): value is { type: 'panel-init'; tabId: number } {\n\tif (typeof value !== 'object' || value === null) return false\n\tconst record = value as Record<string, unknown>\n\treturn record.type === 'panel-init' && typeof record.tabId === 'number'\n}\n\nfunction isContentEventMessage(value: unknown): value is { type: 'kora-event'; payload: unknown } {\n\tif (typeof value !== 'object' || value === null) return false\n\tconst record = value as Record<string, unknown>\n\treturn record.type === 'kora-event' && 'payload' in record\n}\n"],"mappings":"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","names":[]}
|