@beignet/devtools 0.0.1

package/dist/instrumentation.js

@@ -0,0 +1,293 @@
+import { createDevtoolsEvent } from "./provider";
+import { createChildDevtoolsTraceContext, createDevtoolsTraceContext, parseTraceparent, } from "./trace-context";
+function getContextRequestId(ctx) {
+    if (!ctx || typeof ctx !== "object")
+        return undefined;
+    const requestId = ctx.requestId;
+    return typeof requestId === "string" ? requestId : undefined;
+}
+function getContextDevtools(ctx) {
+    if (!ctx || typeof ctx !== "object")
+        return undefined;
+    const ports = ctx.ports;
+    return ports?.devtools;
+}
+function getContextTraceContext(ctx) {
+    if (!ctx || typeof ctx !== "object")
+        return undefined;
+    const context = ctx;
+    if (!context.traceId &&
+        !context.spanId &&
+        !context.parentSpanId &&
+        !context.traceparent) {
+        return undefined;
+    }
+    return {
+        traceId: context.traceId,
+        spanId: context.spanId,
+        parentSpanId: context.parentSpanId,
+        traceparent: context.traceparent,
+    };
+}
+function getErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === "string")
+        return error;
+    return "Unknown error";
+}
+function getErrorStack(error) {
+    return error instanceof Error ? error.stack : undefined;
+}
+function createRequestId() {
+    if (typeof crypto !== "undefined" && "randomUUID" in crypto) {
+        return crypto.randomUUID();
+    }
+    return `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+}
+function getPathname(req) {
+    try {
+        return new URL(req.url).pathname;
+    }
+    catch {
+        return req.url;
+    }
+}
+function isDevtoolsPath(pathname, basePath) {
+    const normalizedBase = basePath.replace(/\/+$/, "");
+    return (pathname === normalizedBase || pathname.startsWith(`${normalizedBase}/`));
+}
+function isWatcherEnabled(devtools, name) {
+    return devtools.isWatcherEnabled(name);
+}
+export function createDevtoolsHooks(options = {}) {
+    let devtools;
+    const basePath = options.basePath ?? "/api/devtools";
+    const requestIdHeader = options.requestIdHeader ?? "x-request-id";
+    const traceContextHeader = options.traceContextHeader ?? "traceparent";
+    const generatedRequestIds = new WeakMap();
+    const traceContexts = new WeakMap();
+    const resolveRequestId = (args) => {
+        const headerRequestId = requestIdHeader === false
+            ? undefined
+            : args.req.headers.get(requestIdHeader);
+        const existing = options.getRequestId?.(args) ??
+            getContextRequestId(args.ctx) ??
+            headerRequestId ??
+            generatedRequestIds.get(args.req);
+        if (existing)
+            return existing;
+        const requestId = createRequestId();
+        generatedRequestIds.set(args.req, requestId);
+        return requestId;
+    };
+    const resolveTraceContext = (args) => {
+        const configured = options.getTraceContext?.(args);
+        const configuredContext = typeof configured === "string" ? { traceparent: configured } : configured;
+        const contextTrace = getContextTraceContext(args.ctx);
+        const headerTraceparent = traceContextHeader === false
+            ? undefined
+            : args.req.headers.get(traceContextHeader);
+        const existing = configuredContext ?? contextTrace;
+        const existingTraceparent = existing?.traceparent ?? parseTraceparent(headerTraceparent)?.traceparent;
+        if (existing) {
+            const traceContext = createDevtoolsTraceContext({
+                ...existing,
+                traceparent: existingTraceparent,
+            });
+            traceContexts.set(args.req, traceContext);
+            return traceContext;
+        }
+        const cached = traceContexts.get(args.req);
+        if (cached)
+            return cached;
+        const traceContext = createDevtoolsTraceContext({
+            traceparent: existingTraceparent,
+        });
+        traceContexts.set(args.req, traceContext);
+        return traceContext;
+    };
+    const record = (event) => {
+        if (!devtools)
+            return;
+        const normalized = createDevtoolsEvent(event);
+        try {
+            devtools.record(options.redact ? options.redact(normalized) : normalized);
+        }
+        catch (error) {
+            devtools.record({
+                type: "error",
+                message: "Devtools hook redactor failed",
+                details: {
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            });
+        }
+    };
+    return {
+        name: "devtools",
+        onRequest: ({ ports }) => {
+            devtools = ports.devtools;
+            return undefined;
+        },
+        beforeHandle: ({ req, ctx }) => {
+            if (!ctx || typeof ctx !== "object" || Array.isArray(ctx)) {
+                return undefined;
+            }
+            const traceContext = resolveTraceContext({ req, ctx });
+            return {
+                ctx: {
+                    ...ctx,
+                    traceId: traceContext.traceId,
+                    spanId: traceContext.spanId,
+                    parentSpanId: traceContext.parentSpanId,
+                    traceparent: traceContext.traceparent,
+                },
+            };
+        },
+        beforeSend: async ({ req, ctx, response }) => {
+            if (requestIdHeader === false && traceContextHeader === false) {
+                return undefined;
+            }
+            const requestId = resolveRequestId({ req, ctx, response });
+            const traceContext = resolveTraceContext({ req, ctx, response });
+            const headers = {
+                ...response.headers,
+                ...(requestIdHeader === false ? {} : { [requestIdHeader]: requestId }),
+                ...(traceContextHeader === false
+                    ? {}
+                    : { [traceContextHeader]: traceContext.traceparent }),
+            };
+            return {
+                ...response,
+                headers,
+            };
+        },
+        afterSend: async ({ req, ctx, contract, response, error, durationMs }) => {
+            if (!devtools)
+                return;
+            const path = getPathname(req);
+            if (isDevtoolsPath(path, basePath))
+                return;
+            const shouldCaptureRequest = isWatcherEnabled(devtools, "requests");
+            const shouldCaptureError = Boolean(error) && isWatcherEnabled(devtools, "errors");
+            if (!shouldCaptureRequest && !shouldCaptureError)
+                return;
+            if (options.shouldCapture &&
+                !options.shouldCapture({ req, ctx, contract, response, error })) {
+                return;
+            }
+            const requestId = resolveRequestId({ req, ctx, response });
+            const traceContext = resolveTraceContext({ req, ctx, response });
+            if (shouldCaptureRequest) {
+                record({
+                    type: "request",
+                    requestId,
+                    traceId: traceContext.traceId,
+                    spanId: traceContext.spanId,
+                    parentSpanId: traceContext.parentSpanId,
+                    traceparent: traceContext.traceparent,
+                    method: req.method,
+                    path,
+                    contractName: contract.name,
+                    status: response.status,
+                    durationMs,
+                    details: {
+                        headers: Object.fromEntries(req.headers.entries()),
+                    },
+                });
+            }
+            if (error && shouldCaptureError) {
+                record({
+                    type: "error",
+                    requestId,
+                    traceId: traceContext.traceId,
+                    spanId: traceContext.spanId,
+                    parentSpanId: traceContext.parentSpanId,
+                    traceparent: traceContext.traceparent,
+                    message: getErrorMessage(error),
+                    stack: getErrorStack(error),
+                    contractName: contract.name,
+                });
+            }
+        },
+    };
+}
+export function createDevtoolsUseCaseObserver(options = {}) {
+    const logErrorEvents = options.logErrorEvents ?? true;
+    const activeTraceContexts = new Map();
+    return (event) => {
+        const devtools = options.getDevtools?.(event.ctx) ?? getContextDevtools(event.ctx);
+        if (!devtools)
+            return;
+        const requestId = options.getRequestId?.(event.ctx) ?? getContextRequestId(event.ctx);
+        const errorMessage = event.phase === "error" ? getErrorMessage(event.error) : undefined;
+        const shouldCaptureUseCase = isWatcherEnabled(devtools, "useCases");
+        const shouldCaptureError = event.phase === "error" &&
+            logErrorEvents &&
+            isWatcherEnabled(devtools, "errors");
+        if (!shouldCaptureUseCase && !shouldCaptureError)
+            return;
+        const parentTraceContext = getContextTraceContext(event.ctx);
+        const useCaseKey = [
+            requestId ?? "no-request",
+            parentTraceContext?.traceId ?? "no-trace",
+            event.kind,
+            event.name,
+        ].join(":");
+        const traceContext = event.phase === "start"
+            ? createChildDevtoolsTraceContext(parentTraceContext ?? {})
+            : (activeTraceContexts.get(useCaseKey) ??
+                createChildDevtoolsTraceContext(parentTraceContext ?? {}));
+        if (event.phase === "start") {
+            activeTraceContexts.set(useCaseKey, traceContext);
+        }
+        else {
+            activeTraceContexts.delete(useCaseKey);
+        }
+        const record = (input) => {
+            const normalized = createDevtoolsEvent(input);
+            try {
+                devtools.record(options.redact ? options.redact(normalized) : normalized);
+            }
+            catch (error) {
+                devtools.record({
+                    type: "error",
+                    message: "Devtools use case redactor failed",
+                    details: {
+                        message: error instanceof Error ? error.message : String(error),
+                    },
+                });
+            }
+        };
+        if (shouldCaptureUseCase) {
+            record({
+                type: "usecase",
+                requestId,
+                traceId: traceContext.traceId,
+                spanId: traceContext.spanId,
+                parentSpanId: traceContext.parentSpanId,
+                traceparent: traceContext.traceparent,
+                name: event.name,
+                kind: event.kind,
+                phase: event.phase,
+                durationMs: event.durationMs,
+                error: errorMessage,
+            });
+        }
+        if (shouldCaptureError) {
+            record({
+                type: "error",
+                requestId,
+                traceId: traceContext.traceId,
+                spanId: traceContext.spanId,
+                parentSpanId: traceContext.parentSpanId,
+                traceparent: traceContext.traceparent,
+                message: errorMessage ?? "Use case failed",
+                stack: getErrorStack(event.error),
+                useCaseName: event.name,
+            });
+        }
+    };
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/instrumentation.js.map

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

package/dist/persistence.d.ts

@@ -0,0 +1,30 @@
+import type { DevtoolsEvent } from "./events";
+export interface DevtoolsEventStore {
+    name?: string;
+    load?(): DevtoolsEvent[] | Promise<DevtoolsEvent[]>;
+    append?(event: DevtoolsEvent, events: readonly DevtoolsEvent[]): void | Promise<void>;
+    clear?(): void | Promise<void>;
+}
+export interface FileDevtoolsStoreOptions {
+    /**
+     * JSONL file used for persisted devtools events.
+     *
+     * @default ".beignet/devtools/core/events.jsonl"
+     */
+    filePath?: string;
+    /**
+     * Maximum number of events to load and keep when compacting the file.
+     *
+     * @default 1000
+     */
+    maxEvents?: number;
+    /**
+     * Rewrite the JSONL file after this many appended events. Compaction keeps
+     * persistence bounded without making every record pay the rewrite cost.
+     *
+     * @default 50
+     */
+    compactEvery?: number;
+}
+export declare function createFileDevtoolsStore(options?: FileDevtoolsStoreOptions): DevtoolsEventStore;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,IAAI,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACpD,MAAM,CAAC,CACL,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,SAAS,aAAa,EAAE,GAC/B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAgDD,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,wBAA6B,GACrC,kBAAkB,CA8EpB"}

package/dist/persistence.js

@@ -0,0 +1,100 @@
+const DEFAULT_FILE_PATH = ".beignet/devtools/core/events.jsonl";
+const DEFAULT_MAX_EVENTS = 1000;
+const DEFAULT_COMPACT_EVERY = 50;
+function isErrnoException(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        typeof error.code === "string");
+}
+function isDevtoolsEvent(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "id" in value &&
+        "timestamp" in value &&
+        "type" in value);
+}
+function parseJsonLine(line) {
+    try {
+        const parsed = JSON.parse(line);
+        return isDevtoolsEvent(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function loadNodeModules() {
+    const [fs, path] = await Promise.all([
+        import("node:fs/promises"),
+        import("node:path"),
+    ]);
+    return { fs, path };
+}
+export function createFileDevtoolsStore(options = {}) {
+    const filePath = options.filePath ?? DEFAULT_FILE_PATH;
+    const maxEvents = Math.max(1, options.maxEvents ?? DEFAULT_MAX_EVENTS);
+    const compactEvery = Math.max(1, options.compactEvery ?? DEFAULT_COMPACT_EVERY);
+    let appendCount = 0;
+    let queue = Promise.resolve();
+    async function ensureDirectory(fs, path) {
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+    }
+    async function readEvents() {
+        const { fs } = await loadNodeModules();
+        let content;
+        try {
+            content = await fs.readFile(filePath, "utf8");
+        }
+        catch (error) {
+            if (isErrnoException(error) && error.code === "ENOENT")
+                return [];
+            throw error;
+        }
+        return content
+            .split("\n")
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .map(parseJsonLine)
+            .filter((event) => event !== undefined)
+            .slice(-maxEvents);
+    }
+    async function writeEvents(events) {
+        const { fs, path } = await loadNodeModules();
+        await ensureDirectory(fs, path);
+        const content = events.map((event) => JSON.stringify(event)).join("\n");
+        await fs.writeFile(filePath, content ? `${content}\n` : "", "utf8");
+    }
+    function enqueue(task) {
+        queue = queue.then(task, task);
+        return queue;
+    }
+    return {
+        name: "file",
+        async load() {
+            const events = await readEvents();
+            await writeEvents(events);
+            return events;
+        },
+        append(event, events) {
+            appendCount += 1;
+            const currentAppendCount = appendCount;
+            return enqueue(async () => {
+                const shouldCompact = currentAppendCount % compactEvery === 0 || events.length >= maxEvents;
+                if (shouldCompact) {
+                    await writeEvents(events.slice(-maxEvents));
+                    return;
+                }
+                const { fs, path } = await loadNodeModules();
+                await ensureDirectory(fs, path);
+                await fs.appendFile(filePath, `${JSON.stringify(event)}\n`, "utf8");
+            });
+        },
+        clear() {
+            appendCount = 0;
+            return enqueue(async () => {
+                await writeEvents([]);
+            });
+        },
+    };
+}
+//# sourceMappingURL=persistence.js.map

package/dist/persistence.js.map

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

package/dist/provider-instrumentation.d.ts

@@ -0,0 +1,9 @@
+import { type ProviderCustomInstrumentationEventInput, type ProviderInstrumentation, type ProviderInstrumentationOptions } from "@beignet/core/providers";
+import type { DevtoolsPort } from "./index";
+export type ProviderDevtoolsOptions = ProviderInstrumentationOptions;
+export type ProviderCustomDevtoolsEventInput = ProviderCustomInstrumentationEventInput;
+export type ProviderDevtools = ProviderInstrumentation;
+export declare function isDevtoolsPort(value: unknown): value is DevtoolsPort;
+export declare function resolveDevtoolsPort(target: unknown): DevtoolsPort | undefined;
+export declare function createProviderDevtools(target: unknown, options: ProviderDevtoolsOptions): ProviderDevtools;
+//# sourceMappingURL=provider-instrumentation.d.ts.map

package/dist/provider-instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-instrumentation.d.ts","sourceRoot":"","sources":["../src/provider-instrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,uCAAuC,EAC5C,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACpC,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,MAAM,uBAAuB,GAAG,8BAA8B,CAAC;AACrE,MAAM,MAAM,gCAAgC,GAC1C,uCAAuC,CAAC;AAC1C,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEvD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAUpE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAa7E;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,uBAAuB,GAC/B,gBAAgB,CAKlB"}

package/dist/provider-instrumentation.js

@@ -0,0 +1,25 @@
+import { createProviderInstrumentation, isProviderInstrumentationPort, } from "@beignet/core/providers";
+export function isDevtoolsPort(value) {
+    return (isProviderInstrumentationPort(value) &&
+        typeof value === "object" &&
+        value !== null &&
+        "getEvents" in value &&
+        typeof value.getEvents === "function" &&
+        "isWatcherEnabled" in value &&
+        typeof value.isWatcherEnabled === "function");
+}
+export function resolveDevtoolsPort(target) {
+    if (isDevtoolsPort(target))
+        return target;
+    if (typeof target === "object" &&
+        target !== null &&
+        "devtools" in target &&
+        isDevtoolsPort(target.devtools)) {
+        return target.devtools;
+    }
+    return undefined;
+}
+export function createProviderDevtools(target, options) {
+    return createProviderInstrumentation(resolveDevtoolsPort(target) ?? undefined, options);
+}
+//# sourceMappingURL=provider-instrumentation.js.map

package/dist/provider-instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-instrumentation.js","sourceRoot":"","sources":["../src/provider-instrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,GAI9B,MAAM,yBAAyB,CAAC;AAQjC,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,CACL,6BAA6B,CAAC,KAAK,CAAC;QACpC,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,WAAW,IAAI,KAAK;QACpB,OAAO,KAAK,CAAC,SAAS,KAAK,UAAU;QACrC,kBAAkB,IAAI,KAAK;QAC3B,OAAO,KAAK,CAAC,gBAAgB,KAAK,UAAU,CAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,IAAI,cAAc,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAE1C,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,UAAU,IAAI,MAAM;QACpB,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,EAC/B,CAAC;QACD,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAe,EACf,OAAgC;IAEhC,OAAO,6BAA6B,CAClC,mBAAmB,CAAC,MAAM,CAAC,IAAI,SAAS,EACxC,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 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 { z } from "zod";
+import type { DevtoolsEvent, DevtoolsEventInput, DevtoolsRedactor } from "./events";
+import type { DevtoolsPort } from "./index";
+import { type DevtoolsEventStore } from "./persistence";
+import { type DevtoolsWatchersOptions } from "./watchers";
+export interface InMemoryDevtoolsOptions {
+    maxEvents?: number;
+    redact?: DevtoolsRedactor;
+    watchers?: DevtoolsWatchersOptions;
+    initialEvents?: readonly DevtoolsEvent[];
+    store?: DevtoolsEventStore;
+}
+export declare function createDevtoolsEvent(event: DevtoolsEventInput): DevtoolsEvent;
+/**
+ * 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 declare function createInMemoryDevtools(options?: InMemoryDevtoolsOptions): DevtoolsPort;
+/**
+ * Configuration schema for the devtools provider.
+ */
+declare const DevtoolsConfigSchema: z.ZodObject<{
+    ENABLED: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<boolean | undefined, string | undefined>>;
+    MAX_EVENTS: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    PERSIST: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<boolean | undefined, string | undefined>>;
+    PERSIST_PATH: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DevtoolsConfig = z.infer<typeof DevtoolsConfigSchema>;
+export interface DevtoolsProviderOptions {
+    enabled?: boolean;
+    maxEvents?: number;
+    redact?: DevtoolsRedactor;
+    watchers?: DevtoolsWatchersOptions;
+    store?: DevtoolsEventStore | (() => DevtoolsEventStore | Promise<DevtoolsEventStore>);
+}
+/**
+ * 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 declare function createDevtoolsProvider(options?: DevtoolsProviderOptions): import("@beignet/core/providers").ServiceProvider<Record<string, unknown>, z.ZodObject<{
+    ENABLED: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<boolean | undefined, string | undefined>>;
+    MAX_EVENTS: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    PERSIST: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<boolean | undefined, string | undefined>>;
+    PERSIST_PATH: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, {
+    devtools: DevtoolsPort;
+}>;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAElB,gBAAgB,EAEjB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AAKvB,OAAO,EAEL,KAAK,uBAAuB,EAI7B,MAAM,YAAY,CAAC;AAQpB,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,aAAa,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AASD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAM5E;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,GACpC,YAAY,CA+Jd;AAED;;GAEG;AACH,QAAA,MAAM,oBAAoB;;;;;iBAWxB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,KAAK,CAAC,EACF,kBAAkB,GAClB,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;CAC9D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,uBAA4B;;;;;;cAI5D,YAAY;GAqF3B"}