@c9up/ream 0.2.25 → 0.2.27

package/dist/profiler/Profiler.js

@@ -0,0 +1,162 @@
+/**
+ * The profiler: one profile per request, and the token that finds it again.
+ *
+ * The hard part is attribution. A SQL query is reported by a listener the
+ * database package calls, with no idea which request caused it — and in a
+ * server answering three requests at once, "the current request" is not a
+ * variable anything can hold. `AsyncLocalStorage` is what makes it one: the
+ * request runs inside a store, and whatever a collector does during it, however
+ * deep in the await chain, lands in the right bag.
+ *
+ * Dev only, and hard-gated: a profiler that kept every request in production
+ * would be a memory leak wearing a feature's name.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { randomBytes } from 'node:crypto';
+/** Where the toolbar and the profiler page are served. */
+export const PROFILER_PATH = '/__ream/profiler';
+/** The header carrying the token back, so a client can ask for the profile. */
+export const PROFILER_TOKEN_HEADER = 'x-debug-token';
+export class Profiler {
+    #storage = new AsyncLocalStorage();
+    #collectors;
+    #store;
+    constructor(collectors, store) {
+        this.#collectors = collectors;
+        this.#store = store;
+    }
+    get store() {
+        return this.#store;
+    }
+    get collectors() {
+        return this.#collectors;
+    }
+    /**
+     * Run one request inside a profile.
+     *
+     * `work` is handed the scope so it can stamp the token on the response
+     * before anything else runs: a request that throws unwinds past its caller,
+     * and a token written after the await would be missing on exactly the
+     * request worth looking at.
+     *
+     * `describe` is called AFTER the work, because the status is only known
+     * then — asking for it up front would record the request as it arrived
+     * rather than as it was answered. It is given whatever was thrown, since a
+     * handler that threw has not had its status written yet.
+     */
+    async profile(request, work, describe) {
+        const token = newToken();
+        const startedAt = Date.now();
+        const started = performance.now();
+        const active = { scope: { token, startedAt }, bags: new Map() };
+        for (const collector of this.#collectors) {
+            // A collector that throws while starting must not fail the request it was
+            // only meant to watch.
+            try {
+                active.bags.set(collector.name, collector.start(active.scope));
+            }
+            catch {
+                active.bags.set(collector.name, undefined);
+            }
+        }
+        // A request that threw is the profile you most want to look at, so it is
+        // recorded like any other and the error is re-thrown afterwards. Losing it
+        // here would mean the profiler goes quiet exactly when something broke.
+        let result;
+        let thrown;
+        let failed = false;
+        try {
+            result = await this.#storage.run(active, () => work(active.scope));
+        }
+        catch (error) {
+            thrown = error;
+            failed = true;
+            recordException(active, error);
+        }
+        const profile = {
+            token,
+            time: startedAt,
+            method: request.method,
+            url: request.url,
+            status: safeStatus(describe, thrown),
+            duration: performance.now() - started,
+            data: {},
+        };
+        for (const collector of this.#collectors) {
+            try {
+                profile.data[collector.name] = collector.finish(active.bags.get(collector.name), active.scope);
+            }
+            catch {
+                // Same rule on the way out: one broken panel, not a broken response.
+                profile.data[collector.name] = {};
+            }
+        }
+        this.#store.save(profile);
+        if (failed)
+            throw thrown;
+        // Only reachable when the work resolved, which is when `result` is set.
+        return { result: result, token };
+    }
+    /**
+     * The bag of the collector named, for the request running right now.
+     *
+     * `undefined` outside a request — a query from a console command, a boot-time
+     * warm-up — and a collector that writes into it must accept that.
+     */
+    current(collector) {
+        const active = this.#storage.getStore();
+        if (active === undefined)
+            return undefined;
+        const bag = active.bags.get(collector);
+        return bag === undefined ? undefined : bag;
+    }
+    /** Whether a request is being profiled right now. */
+    get active() {
+        return this.#storage.getStore() !== undefined;
+    }
+}
+/**
+ * Put the error where the exception panel reads it.
+ *
+ * The collector's own bag, by name: the framework ships that collector, and a
+ * profiler that could not say what broke would miss the reason most people
+ * open it.
+ */
+function recordException(active, error) {
+    const bag = active.bags.get('exception');
+    if (typeof bag !== 'object' || bag === null)
+        return;
+    const target = Object.assign(bag);
+    if (error instanceof Error) {
+        target.name = error.name;
+        target.message = error.message;
+        if (error.stack !== undefined)
+            target.stack = error.stack;
+        const code = Reflect.get(error, 'code');
+        if (typeof code === 'string')
+            target.code = code;
+    }
+    else {
+        target.name = 'Error';
+        target.message = String(error);
+    }
+}
+/**
+ * A token, short enough to read aloud and random enough not to collide.
+ *
+ * Six bytes of hex, as Symfony's is six characters: it identifies a request
+ * within one dev session, not across the internet.
+ */
+function newToken() {
+    return randomBytes(6).toString('hex');
+}
+function safeStatus(describe, error) {
+    try {
+        const { status } = describe(error);
+        return Number.isInteger(status) ? status : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=Profiler.js.map

package/dist/profiler/Profiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Profiler.js","sourceRoot":"","sources":["../../src/profiler/Profiler.ts"],"names":[],"mappings":"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"}

package/dist/profiler/collectors.d.ts

@@ -0,0 +1,105 @@
+/**
+ * What the profiler watches.
+ *
+ * Each one is independent and may be replaced: the database collector is the
+ * interesting case, because the data does not come from the request at all. It
+ * comes from `db:query` events the data layer emits with no idea which request
+ * caused them, and the profiler's async store is what puts each one back where
+ * it belongs.
+ *
+ * NO import of atlas. The collector listens on the application's emitter for
+ * `db:query`, which is the shape atlas documents for bridging its own registry
+ * (`onDbQuery((event) => emitter.emit('db:query', event))`). A project on
+ * another data layer emits the same event and gets the same panel.
+ */
+import type { CollectedData, ProfilerCollector } from './types.js';
+/** One SQL statement, as the panel shows it. */
+export interface RecordedQuery {
+    sql: string;
+    bindings: readonly unknown[];
+    /** Milliseconds. */
+    duration: number;
+    connection?: string;
+    model?: string;
+    method?: string;
+    inTransaction?: boolean;
+    /** The message, when the statement threw. */
+    error?: string;
+}
+/** What the emitter must give this collector. Structural: no package imported. */
+export interface QueryEventSource {
+    on(event: string, listener: (payload: unknown) => void): unknown;
+}
+export declare function databaseCollector(events: QueryEventSource, read: () => QueryBag | undefined): ProfilerCollector<QueryBag>;
+export interface QueryBag {
+    total: number;
+    duration: number;
+    queries: RecordedQuery[];
+}
+/** The request and what it answered. */
+export declare function requestCollector(): ProfilerCollector<RequestBag>;
+export interface RequestBag {
+    route?: string;
+    controller?: string;
+    userId?: string;
+}
+/**
+ * What went wrong, if anything.
+ *
+ * The one panel worth opening by itself: an exception that reached the handler
+ * is reported here so it shows up in the page rather than only in the terminal
+ * someone may not be looking at.
+ */
+export declare function exceptionCollector(): ProfilerCollector<ExceptionBag>;
+export interface ExceptionBag {
+    name?: string;
+    message?: string;
+    stack?: string;
+    /** Where it was reported from, when the framework knows. */
+    code?: string;
+}
+/**
+ * Lines logged while the request ran.
+ *
+ * Same arrangement as the database panel, and for the same reason: a logger
+ * writes a line with no idea which request caused it. It comes off the
+ * application's emitter as `log:line`, which is what `@c9up/spectrum` bridges
+ * its own registry to (`onLog((entry) => emitter.emit('log:line', entry))`),
+ * so a project on another logger emits the same event and gets the same panel.
+ */
+export declare function logCollector(events: LogEventSource, read: () => LogBag | undefined): {
+    name: string;
+    badge: (data: CollectedData) => string | undefined;
+    start: () => {
+        total: number;
+        lines: never[];
+    };
+    finish: (bag: LogBag) => {
+        total?: undefined;
+        lines?: undefined;
+    } | {
+        total: number;
+        lines: {
+            level: string;
+            message: string;
+            time?: string;
+        }[];
+    };
+};
+/** What the emitter must give the log collector. Structural, as above. */
+export interface LogEventSource {
+    on(event: string, listener: (payload: unknown) => void): unknown;
+}
+export interface LogBag {
+    total: number;
+    lines: Array<{
+        level: string;
+        message: string;
+        time?: string;
+    }>;
+}
+/** Peak heap while the request ran, which is what a leak shows up in. */
+export declare function memoryCollector(): ProfilerCollector<{
+    start: number;
+}>;
+//# sourceMappingURL=collectors.d.ts.map

package/dist/profiler/collectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectors.d.ts","sourceRoot":"","sources":["../../src/profiler/collectors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAElE,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IAC5B,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAA;CACjE;AAWD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,QAAQ,GAAG,SAAS,GAC/B,iBAAiB,CAAC,QAAQ,CAAC,CA8B7B;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,aAAa,EAAE,CAAA;CACzB;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,IAAI,iBAAiB,CAAC,UAAU,CAAC,CAOhE;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,CAAC,YAAY,CAAC,CAOpE;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,MAAM,GAAG,SAAS;;;;;;;;;;;;;mBAkC3D,MAAM;qBAAW,MAAM;mBAAS,MAAM;;;EAZ7D;AAED,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAA;CACjE;AAKD,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAChE;AAWD,yEAAyE;AACzE,wBAAgB,eAAe,IAAI,iBAAiB,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAatE"}

package/dist/profiler/collectors.js

@@ -0,0 +1,164 @@
+/**
+ * What the profiler watches.
+ *
+ * Each one is independent and may be replaced: the database collector is the
+ * interesting case, because the data does not come from the request at all. It
+ * comes from `db:query` events the data layer emits with no idea which request
+ * caused them, and the profiler's async store is what puts each one back where
+ * it belongs.
+ *
+ * NO import of atlas. The collector listens on the application's emitter for
+ * `db:query`, which is the shape atlas documents for bridging its own registry
+ * (`onDbQuery((event) => emitter.emit('db:query', event))`). A project on
+ * another data layer emits the same event and gets the same panel.
+ */
+/**
+ * How many statements one request may record.
+ *
+ * A runaway loop issuing ten thousand queries is exactly the bug this panel
+ * exists to show, and keeping all ten thousand would take the dev server down
+ * with it. The count stays true past the cap; the list stops.
+ */
+const QUERY_CAP = 500;
+export function databaseCollector(events, read) {
+    // Subscribed once, at construction: a listener added per request would leak
+    // one per request, and removing it on the way out would miss a query still
+    // in flight.
+    events.on('db:query', (payload) => {
+        const bag = read();
+        if (bag === undefined)
+            return;
+        bag.total += 1;
+        bag.duration += durationOf(payload);
+        if (bag.queries.length < QUERY_CAP)
+            bag.queries.push(toQuery(payload));
+    });
+    return {
+        name: 'database',
+        badge: (data) => {
+            const total = typeof data.total === 'number' ? data.total : 0;
+            const duration = typeof data.duration === 'number' ? data.duration : 0;
+            return `${total} ${total === 1 ? 'query' : 'queries'} · ${round(duration)} ms`;
+        },
+        start: () => ({ total: 0, duration: 0, queries: [] }),
+        finish: (bag) => bag === undefined
+            ? { total: 0, duration: 0, queries: [], capped: false }
+            : {
+                total: bag.total,
+                duration: round(bag.duration),
+                queries: bag.queries,
+                capped: bag.total > bag.queries.length,
+            },
+    };
+}
+/** The request and what it answered. */
+export function requestCollector() {
+    return {
+        name: 'request',
+        badge: (data) => (typeof data.route === 'string' ? data.route : undefined),
+        start: () => ({}),
+        finish: (bag) => ({ ...(bag ?? {}) }),
+    };
+}
+/**
+ * What went wrong, if anything.
+ *
+ * The one panel worth opening by itself: an exception that reached the handler
+ * is reported here so it shows up in the page rather than only in the terminal
+ * someone may not be looking at.
+ */
+export function exceptionCollector() {
+    return {
+        name: 'exception',
+        badge: (data) => (typeof data.message === 'string' ? 'error' : undefined),
+        start: () => ({}),
+        finish: (bag) => ({ ...(bag ?? {}) }),
+    };
+}
+/**
+ * Lines logged while the request ran.
+ *
+ * Same arrangement as the database panel, and for the same reason: a logger
+ * writes a line with no idea which request caused it. It comes off the
+ * application's emitter as `log:line`, which is what `@c9up/spectrum` bridges
+ * its own registry to (`onLog((entry) => emitter.emit('log:line', entry))`),
+ * so a project on another logger emits the same event and gets the same panel.
+ */
+export function logCollector(events, read) {
+    // Subscribed once, at construction, for the same reason as the queries: a
+    // listener per request leaks one per request.
+    events.on('log:line', (payload) => {
+        const bag = read();
+        if (bag === undefined)
+            return;
+        if (bag.lines.length < LINE_CAP)
+            bag.lines.push(toLine(payload));
+        bag.total += 1;
+    });
+    return {
+        name: 'logs',
+        badge: (data) => {
+            const total = typeof data.total === 'number' ? data.total : 0;
+            return total === 0 ? undefined : `${total} ${total === 1 ? 'log' : 'logs'}`;
+        },
+        start: () => ({ total: 0, lines: [] }),
+        // Nothing logged is nothing to show: an empty bag renders no panel at all,
+        // rather than a heading over an empty list.
+        finish: (bag) => bag === undefined || bag.total === 0 ? {} : { total: bag.total, lines: bag.lines },
+    };
+}
+/** As many lines as are worth scrolling; the count stays true past it. */
+const LINE_CAP = 200;
+function toLine(payload) {
+    const entry = asRecord(payload);
+    return {
+        level: typeof entry.level === 'string' ? entry.level : 'info',
+        message: typeof entry.message === 'string' ? entry.message : String(entry.message ?? ''),
+        ...(typeof entry.timestamp === 'string' ? { time: entry.timestamp } : {}),
+    };
+}
+/** Peak heap while the request ran, which is what a leak shows up in. */
+export function memoryCollector() {
+    return {
+        name: 'memory',
+        badge: (data) => (typeof data.usedMb === 'number' ? `${data.usedMb.toFixed(1)} MB` : undefined),
+        start: () => ({ start: process.memoryUsage().heapUsed }),
+        finish: (bag) => {
+            const used = process.memoryUsage().heapUsed;
+            return {
+                usedMb: used / 1024 / 1024,
+                deltaMb: bag === undefined ? 0 : (used - bag.start) / 1024 / 1024,
+            };
+        },
+    };
+}
+function toQuery(payload) {
+    const event = asRecord(payload);
+    return {
+        sql: typeof event.sql === 'string' ? event.sql : String(event.sql ?? ''),
+        bindings: Array.isArray(event.bindings) ? event.bindings : [],
+        duration: durationOf(payload),
+        ...pickString(event, 'connection'),
+        ...pickString(event, 'model'),
+        ...pickString(event, 'method'),
+        ...(event.inTransaction === true ? { inTransaction: true } : {}),
+        ...(event.error instanceof Error ? { error: event.error.message } : {}),
+    };
+}
+function durationOf(payload) {
+    const value = asRecord(payload).duration;
+    return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+}
+function pickString(event, key) {
+    const value = event[key];
+    return typeof value === 'string' && value !== '' ? { [key]: value } : {};
+}
+function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? Object.fromEntries(Object.entries(value))
+        : {};
+}
+function round(value) {
+    return Math.round(value * 100) / 100;
+}
+//# sourceMappingURL=collectors.js.map

package/dist/profiler/collectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectors.js","sourceRoot":"","sources":["../../src/profiler/collectors.ts"],"names":[],"mappings":"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"}

package/dist/profiler/endpoint.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Where the toolbar and the profiler read from.
+ *
+ * Three routes, all under `/__ream/profiler` and all development-only:
+ *
+ *     /__ream/profiler                 the history, newest first
+ *     /__ream/profiler/<token>         one request, every panel
+ *     /__ream/profiler/<token>.json    the same, for the bar in the page
+ *
+ * Server middleware rather than routes, like the hot-reload endpoint: it
+ * answers before the application's own middleware, so a profiler request does
+ * not run the authentication stack and end up in its own history.
+ */
+import type { Profiler } from './Profiler.js';
+/** The slice of the context this endpoint uses. */
+export interface ProfilerContext {
+    request: {
+        url: () => string;
+    };
+    response: {
+        header: (name: string, value: string) => unknown;
+        send: (body: unknown) => unknown;
+        status: (code: number) => unknown;
+    };
+}
+export declare function profilerEndpoint(profiler: Profiler): (ctx: ProfilerContext, next: () => Promise<void>) => Promise<void>;
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/profiler/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/profiler/endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAI7C,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,MAAM,CAAA;KAAE,CAAA;IAC9B,QAAQ,EAAE;QACR,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;QAChD,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAA;QAChC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;KAClC,CAAA;CACF;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,GACjB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAgDpE"}

package/dist/profiler/endpoint.js

@@ -0,0 +1,79 @@
+/**
+ * Where the toolbar and the profiler read from.
+ *
+ * Three routes, all under `/__ream/profiler` and all development-only:
+ *
+ *     /__ream/profiler                 the history, newest first
+ *     /__ream/profiler/<token>         one request, every panel
+ *     /__ream/profiler/<token>.json    the same, for the bar in the page
+ *
+ * Server middleware rather than routes, like the hot-reload endpoint: it
+ * answers before the application's own middleware, so a profiler request does
+ * not run the authentication stack and end up in its own history.
+ */
+import { PROFILER_PATH } from './Profiler.js';
+import { renderProfileList, renderProfilePage } from './render.js';
+export function profilerEndpoint(profiler) {
+    return async (ctx, next) => {
+        const path = ctx.request.url().split('?')[0] ?? '';
+        if (path !== PROFILER_PATH && !path.startsWith(`${PROFILER_PATH}/`)) {
+            await next();
+            return;
+        }
+        if (path === PROFILER_PATH) {
+            ctx.response.header('content-type', 'text/html; charset=utf-8');
+            ctx.response.send(renderProfileList(profiler.store.recent(50)));
+            return;
+        }
+        const rest = path.slice(`${PROFILER_PATH}/`.length);
+        const asJson = rest.endsWith('.json');
+        const token = asJson ? rest.slice(0, -'.json'.length) : rest;
+        const profile = profiler.store.find(token);
+        if (profile === undefined) {
+            // 404 rather than an empty page: a token the store has dropped is a real
+            // answer, and the bar reads the status to stop asking.
+            ctx.response.status(404);
+            if (asJson) {
+                ctx.response.header('content-type', 'application/json');
+                ctx.response.send({ error: 'no profile for this token' });
+            }
+            else {
+                ctx.response.header('content-type', 'text/html; charset=utf-8');
+                ctx.response.send(renderProfileList(profiler.store.recent(50), token));
+            }
+            return;
+        }
+        if (asJson) {
+            ctx.response.header('content-type', 'application/json');
+            // No cache: the token is single-use in practice, and a cached profile
+            // would show the previous request's numbers after a reload.
+            ctx.response.header('cache-control', 'no-store');
+            ctx.response.send({
+                ...profile,
+                badges: badgesFor(profiler, profile.data),
+            });
+            return;
+        }
+        ctx.response.header('content-type', 'text/html; charset=utf-8');
+        ctx.response.send(renderProfilePage(profile, badgesFor(profiler, profile.data)));
+    };
+}
+/** Each collector's headline, asked of the collector rather than guessed. */
+function badgesFor(profiler, data) {
+    const badges = {};
+    for (const collector of profiler.collectors) {
+        const panel = data[collector.name];
+        if (panel === undefined || collector.badge === undefined)
+            continue;
+        try {
+            const badge = collector.badge(panel);
+            if (badge !== undefined)
+                badges[collector.name] = badge;
+        }
+        catch {
+            // A badge that throws costs its own label, nothing more.
+        }
+    }
+    return badges;
+}
+//# sourceMappingURL=endpoint.js.map

package/dist/profiler/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../src/profiler/endpoint.ts"],"names":[],"mappings":"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"}

package/dist/profiler/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The profiler, assembled.
+ *
+ * One place that knows which collectors ship, so the Ignitor wires a profiler
+ * rather than a list — and an application that wants its own panel adds a
+ * collector here instead of rebuilding the set.
+ */
+import { type QueryEventSource } from './collectors.js';
+import { Profiler } from './Profiler.js';
+import type { ProfilerCollector } from './types.js';
+export * from './collectors.js';
+export { profilerEndpoint } from './endpoint.js';
+export { MemoryProfileStore } from './MemoryProfileStore.js';
+export { profileRequest } from './middleware.js';
+export { PROFILER_PATH, PROFILER_TOKEN_HEADER, Profiler } from './Profiler.js';
+export { toolbarScript } from './toolbar.js';
+export * from './types.js';
+/**
+ * The profiler a dev server runs with.
+ *
+ * `events` is the application's emitter. The database panel comes from
+ * `db:query` on it, which is how a data layer reports a statement without the
+ * profiler importing one.
+ */
+export declare function createProfiler(events: QueryEventSource, extra?: readonly ProfilerCollector[]): Profiler;
+//# sourceMappingURL=index.d.ts.map

package/dist/profiler/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/profiler/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAOL,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,cAAc,YAAY,CAAA;AAE1B;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EACxB,KAAK,GAAE,SAAS,iBAAiB,EAAO,GACvC,QAAQ,CAeV"}

package/dist/profiler/index.js

@@ -0,0 +1,41 @@
+/**
+ * The profiler, assembled.
+ *
+ * One place that knows which collectors ship, so the Ignitor wires a profiler
+ * rather than a list — and an application that wants its own panel adds a
+ * collector here instead of rebuilding the set.
+ */
+import { databaseCollector, exceptionCollector, logCollector, memoryCollector, requestCollector, } from './collectors.js';
+import { MemoryProfileStore } from './MemoryProfileStore.js';
+import { Profiler } from './Profiler.js';
+export * from './collectors.js';
+export { profilerEndpoint } from './endpoint.js';
+export { MemoryProfileStore } from './MemoryProfileStore.js';
+export { profileRequest } from './middleware.js';
+export { PROFILER_PATH, PROFILER_TOKEN_HEADER, Profiler } from './Profiler.js';
+export { toolbarScript } from './toolbar.js';
+export * from './types.js';
+/**
+ * The profiler a dev server runs with.
+ *
+ * `events` is the application's emitter. The database panel comes from
+ * `db:query` on it, which is how a data layer reports a statement without the
+ * profiler importing one.
+ */
+export function createProfiler(events, extra = []) {
+    // Built before the profiler so the database collector can read the bag of
+    // whichever request is running — the reference is filled in a line later,
+    // and nothing reads it until a request arrives.
+    let profiler;
+    const collectors = [
+        requestCollector(),
+        databaseCollector(events, () => profiler.current('database')),
+        exceptionCollector(),
+        logCollector(events, () => profiler.current('logs')),
+        memoryCollector(),
+        ...extra,
+    ];
+    profiler = new Profiler(collectors, new MemoryProfileStore(collectors));
+    return profiler;
+}
+//# sourceMappingURL=index.js.map

package/dist/profiler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/profiler/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAElB,YAAY,EACZ,eAAe,EAGf,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGxC,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,cAAc,YAAY,CAAA;AAE1B;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAwB,EACxB,QAAsC,EAAE;IAExC,0EAA0E;IAC1E,0EAA0E;IAC1E,gDAAgD;IAChD,IAAI,QAAkB,CAAA;IACtB,MAAM,UAAU,GAAwB;QACtC,gBAAgB,EAAE;QAClB,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAW,UAAU,CAAC,CAAC;QACvE,kBAAkB,EAAE;QACpB,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAS,MAAM,CAAC,CAAC;QAC5D,eAAe,EAAE;QACjB,GAAG,KAAK;KACT,CAAA;IACD,QAAQ,GAAG,IAAI,QAAQ,CAAC,UAAU,EAAE,IAAI,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAA;IACvE,OAAO,QAAQ,CAAA;AACjB,CAAC"}