@beignet/devtools 0.0.1

package/dist/provider.js

@@ -0,0 +1,293 @@
+/**
+ * Devtools provider implementation
+ *
+ * Provides an in-memory event buffer that can be attached to ctx.ports.devtools.
+ * The provider is disabled by default in production environments.
+ */
+import { createProvider } from "@beignet/core/providers";
+import { z } from "zod";
+import { createFileDevtoolsStore, } from "./persistence";
+import { applyDevtoolsRedaction, createRedactionFailureEvent, } from "./redaction";
+import { isDevtoolsEventEnabled, isDevtoolsWatcherEnabled, resolveDevtoolsWatchers, } from "./watchers";
+/**
+ * Maximum number of events to keep in the buffer.
+ * When this limit is reached, the oldest events are removed.
+ */
+const MAX_EVENTS = 500;
+function createEventId() {
+    if (typeof crypto !== "undefined" && "randomUUID" in crypto) {
+        return crypto.randomUUID();
+    }
+    return `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+}
+export function createDevtoolsEvent(event) {
+    return {
+        ...event,
+        id: event.id ?? createEventId(),
+        timestamp: event.timestamp ?? new Date().toISOString(),
+    };
+}
+/**
+ * Create an in-memory devtools implementation.
+ *
+ * This implementation stores events in a bounded buffer (max 500 events).
+ * When the buffer is full, the oldest events are removed to make room for new ones.
+ *
+ * @returns A DevtoolsPort implementation
+ */
+export function createInMemoryDevtools(options = {}) {
+    const listeners = new Set();
+    const maxEvents = options.maxEvents ?? MAX_EVENTS;
+    const watchers = resolveDevtoolsWatchers(options.watchers);
+    const events = [];
+    function notify(event) {
+        for (const listener of listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Subscribers are observers; they must not affect devtools storage.
+            }
+        }
+    }
+    function getErrorMessage(error) {
+        if (error instanceof Error)
+            return error.message;
+        if (typeof error === "string")
+            return error;
+        return "Unknown error";
+    }
+    function persistEvent(event) {
+        if (!options.store?.append)
+            return;
+        void Promise.resolve(options.store.append(event, [...events])).catch((error) => {
+            storeInternalError({
+                type: "error",
+                message: "Devtools persistence failed",
+                details: {
+                    message: getErrorMessage(error),
+                    store: options.store?.name,
+                },
+            });
+        });
+    }
+    async function clearPersistedEvents() {
+        if (!options.store?.clear)
+            return;
+        try {
+            await options.store.clear();
+        }
+        catch (error) {
+            storeInternalError({
+                type: "error",
+                message: "Devtools persistence clear failed",
+                details: {
+                    message: getErrorMessage(error),
+                    store: options.store?.name,
+                },
+            });
+        }
+    }
+    function store(event, storeOptions = {}) {
+        events.push(event);
+        if (events.length > maxEvents) {
+            events.splice(0, events.length - maxEvents);
+        }
+        if (storeOptions.notify !== false) {
+            notify({ type: "record", event });
+        }
+        if (storeOptions.persist !== false) {
+            persistEvent(event);
+        }
+        return event;
+    }
+    function redact(event) {
+        try {
+            return applyDevtoolsRedaction(event, options.redact);
+        }
+        catch (error) {
+            return createRedactionFailureEvent(error);
+        }
+    }
+    function storeInternalError(event) {
+        const normalized = createDevtoolsEvent(event);
+        const redacted = redact(normalized);
+        if (!isDevtoolsEventEnabled(watchers, redacted))
+            return redacted;
+        return store(redacted, { persist: false });
+    }
+    for (const event of options.initialEvents ?? []) {
+        const redacted = redact(event);
+        if (isDevtoolsEventEnabled(watchers, redacted)) {
+            store(redacted, { notify: false, persist: false });
+        }
+    }
+    function log(event) {
+        const redacted = redact(event);
+        if (!isDevtoolsEventEnabled(watchers, redacted))
+            return;
+        store(redacted);
+    }
+    function record(event) {
+        const normalized = createDevtoolsEvent(event);
+        const redacted = redact(normalized);
+        if (!isDevtoolsEventEnabled(watchers, redacted))
+            return redacted;
+        return store(redacted);
+    }
+    function getEvents(filter) {
+        let result = [...events];
+        if (filter?.type) {
+            result = result.filter((e) => e.type === filter.type);
+        }
+        if (filter?.requestId) {
+            result = result.filter((e) => e.requestId === filter.requestId);
+        }
+        if (filter?.traceId) {
+            result = result.filter((e) => e.traceId === filter.traceId);
+        }
+        const limit = filter?.limit ?? 200;
+        if (result.length > limit) {
+            result = result.slice(result.length - limit);
+        }
+        return result;
+    }
+    async function clear() {
+        events.length = 0;
+        notify({ type: "clear" });
+        await clearPersistedEvents();
+    }
+    function getWatchers() {
+        return watchers.map((watcher) => ({ ...watcher }));
+    }
+    function isWatcherEnabled(name) {
+        return isDevtoolsWatcherEnabled(watchers, name);
+    }
+    function subscribe(listener) {
+        listeners.add(listener);
+        return () => {
+            listeners.delete(listener);
+        };
+    }
+    return {
+        log,
+        record,
+        subscribe,
+        getEvents,
+        clear,
+        getWatchers,
+        isWatcherEnabled,
+    };
+}
+/**
+ * Configuration schema for the devtools provider.
+ */
+const DevtoolsConfigSchema = z.object({
+    ENABLED: z
+        .string()
+        .optional()
+        .transform((v) => (v === undefined ? undefined : v === "true")),
+    MAX_EVENTS: z.coerce.number().int().positive().optional(),
+    PERSIST: z
+        .string()
+        .optional()
+        .transform((v) => (v === undefined ? undefined : v === "true")),
+    PERSIST_PATH: z.string().optional(),
+});
+/**
+ * Devtools service provider.
+ *
+ * This provider attaches a DevtoolsPort to ctx.ports.devtools.
+ * It can be enabled/disabled via the DEVTOOLS_ENABLED environment variable.
+ * By default, it's enabled in non-production environments and disabled in production.
+ *
+ * @example
+ * ```ts
+ * import { createDevtoolsProvider } from "@beignet/devtools";
+ * import { createServer } from "@beignet/core/server";
+ *
+ * const server = await createServer({
+ *   ports,
+ *   providers: [createDevtoolsProvider()],
+ * });
+ * ```
+ *
+ * To explicitly enable/disable:
+ * ```bash
+ * DEVTOOLS_ENABLED=true npm run dev
+ * DEVTOOLS_ENABLED=false npm run dev
+ * ```
+ */
+export function createDevtoolsProvider(options = {}) {
+    return createProvider({
+        name: "devtools",
+        config: {
+            schema: DevtoolsConfigSchema,
+            envPrefix: "DEVTOOLS_",
+        },
+        async setup({ config }) {
+            const enabled = options.enabled ??
+                config?.ENABLED ??
+                process.env.NODE_ENV !== "production";
+            if (!enabled) {
+                const watchers = resolveDevtoolsWatchers(options.watchers).map((watcher) => ({
+                    ...watcher,
+                    enabled: false,
+                }));
+                // Provide a no-op implementation so callers don't need null checks
+                const noop = {
+                    log: () => { },
+                    record: (event) => createDevtoolsEvent(event),
+                    subscribe: () => () => { },
+                    getEvents: () => [],
+                    clear: () => { },
+                    getWatchers: () => watchers.map((watcher) => ({ ...watcher })),
+                    isWatcherEnabled: () => false,
+                };
+                return { ports: { devtools: noop } };
+            }
+            const maxEvents = config?.MAX_EVENTS ?? options.maxEvents ?? MAX_EVENTS;
+            const configuredStore = typeof options.store === "function"
+                ? await options.store()
+                : options.store;
+            let store = configuredStore ??
+                (config?.PERSIST || config?.PERSIST_PATH
+                    ? createFileDevtoolsStore({
+                        filePath: config.PERSIST_PATH,
+                        maxEvents,
+                    })
+                    : undefined);
+            let initialEvents = [];
+            let loadError;
+            if (store?.load) {
+                try {
+                    initialEvents = await store.load();
+                }
+                catch (error) {
+                    loadError = error;
+                    store = undefined;
+                }
+            }
+            const devtools = createInMemoryDevtools({
+                maxEvents,
+                redact: options.redact,
+                watchers: options.watchers,
+                initialEvents,
+                store,
+            });
+            if (loadError) {
+                devtools.record({
+                    type: "error",
+                    message: "Devtools persistence load failed",
+                    details: {
+                        message: loadError instanceof Error
+                            ? loadError.message
+                            : String(loadError),
+                    },
+                });
+            }
+            return { ports: { devtools } };
+        },
+    });
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/redaction.d.ts

@@ -0,0 +1,5 @@
+import type { DevtoolsEvent, DevtoolsRedactor } from "./events";
+export declare const defaultDevtoolsRedactor: DevtoolsRedactor;
+export declare function applyDevtoolsRedaction(event: DevtoolsEvent, redact?: DevtoolsRedactor): DevtoolsEvent;
+export declare function createRedactionFailureEvent(error: unknown): DevtoolsEvent;
+//# sourceMappingURL=redaction.d.ts.map

package/dist/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEhE,eAAO,MAAM,uBAAuB,EAAE,gBAClB,CAAC;AAErB,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EACpB,MAAM,CAAC,EAAE,gBAAgB,GACxB,aAAa,CAIf;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAUzE"}

package/dist/redaction.js

@@ -0,0 +1,20 @@
+import { redactValue } from "@beignet/core/ports";
+export const defaultDevtoolsRedactor = (event) => redactValue(event);
+export function applyDevtoolsRedaction(event, redact) {
+    const redacted = defaultDevtoolsRedactor(event);
+    if (!redact)
+        return redacted;
+    return redact(redacted);
+}
+export function createRedactionFailureEvent(error) {
+    return {
+        id: `${Date.now()}-${Math.random().toString(16).slice(2)}`,
+        timestamp: new Date().toISOString(),
+        type: "error",
+        message: "Devtools redactor failed",
+        details: {
+            message: error instanceof Error ? error.message : String(error),
+        },
+    };
+}
+//# sourceMappingURL=redaction.js.map

package/dist/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,MAAM,CAAC,MAAM,uBAAuB,GAAqB,CAAC,KAAK,EAAE,EAAE,CACjE,WAAW,CAAC,KAAK,CAAC,CAAC;AAErB,MAAM,UAAU,sBAAsB,CACpC,KAAoB,EACpB,MAAyB;IAEzB,MAAM,QAAQ,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,OAAO;QACL,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAC1D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,0BAA0B;QACnC,OAAO,EAAE;YACP,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE;KACF,CAAC;AACJ,CAAC"}

package/dist/routes.d.ts

@@ -0,0 +1,113 @@
+/**
+ * HTTP handlers for devtools API
+ *
+ * These handlers can be used to expose devtools data via HTTP endpoints
+ * in Next.js or any other framework that uses the Fetch API Request/Response.
+ */
+import { type DevtoolsRouteAccessOptions } from "./access";
+import type { DevtoolsPort } from "./index";
+export interface DevtoolsRequestOptions extends DevtoolsRouteAccessOptions {
+    /**
+     * URL path prefix where devtools routes are mounted.
+     *
+     * @example "/api/devtools"
+     */
+    basePath: string;
+}
+export interface DevtoolsRouteHandlers {
+    GET(req: Request): Promise<Response>;
+    POST(req: Request): Promise<Response>;
+}
+/**
+ * Handle GET requests to list devtools events with optional filtering.
+ *
+ * Query parameters:
+ * - type: Filter by event type (request, error, usecase, eventBus, job, schedule, provider)
+ * - requestId: Filter by request correlation ID
+ * - traceId: Filter by W3C trace ID
+ * - limit: Maximum number of events to return (default: 200)
+ *
+ * @param req - The incoming HTTP request
+ * @param devtools - The DevtoolsPort instance to query
+ * @returns JSON response with events array
+ *
+ * @example
+ * ```ts
+ * // In a Next.js route handler:
+ * // app/api/devtools/core/events/route.ts
+ * import { handleDevtoolsEventsRequest } from "@beignet/devtools";
+ *
+ * export async function GET(req: Request) {
+ *   const devtools = getAppDevtoolsPort(); // app-specific helper
+ *   return handleDevtoolsEventsRequest(req, devtools);
+ * }
+ * ```
+ */
+export declare function handleDevtoolsEventsRequest(req: Request, devtools: DevtoolsPort, options?: DevtoolsRouteAccessOptions): Promise<Response>;
+/**
+ * Handle POST requests to clear all devtools events.
+ *
+ * This endpoint requires a POST request and will clear the in-memory event buffer.
+ *
+ * @param req - The incoming HTTP request
+ * @param devtools - The DevtoolsPort instance to clear
+ * @returns JSON response with success status
+ *
+ * @example
+ * ```ts
+ * // In a Next.js route handler:
+ * // app/api/devtools/clear/route.ts
+ * import { handleDevtoolsClearRequest } from "@beignet/devtools";
+ *
+ * export async function POST(req: Request) {
+ *   const devtools = getAppDevtoolsPort(); // app-specific helper
+ *   return handleDevtoolsClearRequest(req, devtools);
+ * }
+ * ```
+ */
+export declare function handleDevtoolsClearRequest(req: Request, devtools: DevtoolsPort, options?: DevtoolsRouteAccessOptions): Promise<Response>;
+/**
+ * Handle GET requests for a live Server-Sent Events stream.
+ *
+ * The stream emits:
+ * - `snapshot` with the current event buffer
+ * - `event` when a new event is recorded
+ * - `clear` when the buffer is cleared
+ */
+export declare function handleDevtoolsStreamRequest(req: Request, devtools: DevtoolsPort, options?: DevtoolsRouteAccessOptions): Promise<Response>;
+/**
+ * Unified devtools request handler.
+ *
+ * Routes requests to the appropriate handler based on the URL path:
+ * - `{basePath}/core/events` → event list (GET)
+ * - `{basePath}/stream` → live event stream (GET)
+ * - `{basePath}/clear` → clear buffer (POST)
+ * - `{basePath}` → dashboard UI (GET)
+ *
+ * This lets you wire up a single catch-all route instead of three separate ones.
+ *
+ * @param req - The incoming HTTP request
+ * @param devtools - The DevtoolsPort instance
+ * @param options - Devtools route options including base path and access policy
+ * @returns Response for the matched sub-route
+ *
+ * @example
+ * ```ts
+ * // Next.js catch-all route: app/api/devtools/[[...path]]/route.ts
+ * import { createDevtoolsRoute } from "@beignet/devtools";
+ * import { getDevtools } from "@/server";
+ *
+ * export const { GET, POST } = createDevtoolsRoute(getDevtools(), {
+ *   basePath: "/api/devtools",
+ * });
+ * ```
+ */
+export declare function handleDevtoolsRequest(req: Request, devtools: DevtoolsPort, options: DevtoolsRequestOptions): Promise<Response>;
+/**
+ * Create GET and POST handlers for a devtools catch-all route.
+ *
+ * This is the recommended integration for frameworks such as Next.js that
+ * export HTTP method functions from route modules.
+ */
+export declare function createDevtoolsRoute(devtools: DevtoolsPort, options: DevtoolsRequestOptions): DevtoolsRouteHandlers;
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,SAAS,CAAC;AAG5D,MAAM,WAAW,sBAAuB,SAAQ,0BAA0B;IACxE;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,QAAQ,CAAC,CAkDnB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,QAAQ,CAAC,CAiBnB;AAQD;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,QAAQ,CAAC,CA+DnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,QAAQ,CAAC,CA6BnB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAQvB"}