@vibesdotdev/logging 0.0.2 → 1.0.0-rc.4

package/dist/browser/capture-error.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Browser Error Capture
+ *
+ * Records client-side errors from SvelteKit error boundaries through the
+ * handed logger, and keeps the most recent ones in a ring buffer on the handed
+ * runtime's browser host storage (`runtime/browser-host`).
+ */
+import * as z from 'zod/v4';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { Logger } from '../core/types.ts';
+/** The browser host storage key of the error ring buffer; `read-errors.ts` reads the same key. */
+export declare const ERROR_RING_BUFFER_KEY = "vibes:error-log";
+/** The ring buffer keeps this many newest events. */
+export declare const ERROR_RING_BUFFER_SIZE = 100;
+/**
+ * Error telemetry event structure
+ */
+export interface ErrorTelemetryEvent {
+    /** ISO timestamp */
+    timestamp: string;
+    /** Host version from the handed runtime, or 'unknown' */
+    version: string;
+    /** Current route */
+    route: string;
+    /** Error message */
+    message: string;
+    /** Error stack trace */
+    stack?: string;
+    /** HTTP status code if from error boundary */
+    status?: number;
+    /** Error source. Earlier releases also persisted global handler sources. */
+    source: 'sveltekit' | 'window.onerror' | 'unhandledrejection';
+}
+/** The stored ring buffer: a JSON array of `ErrorTelemetryEvent`. Shared with `read-errors.ts`. */
+export declare const ErrorRingBufferSchema: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodArray<z.ZodObject<{
+    timestamp: z.ZodString;
+    version: z.ZodString;
+    route: z.ZodString;
+    message: z.ZodString;
+    stack: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodNumber>;
+    source: z.ZodEnum<{
+        sveltekit: "sveltekit";
+        "window.onerror": "window.onerror";
+        unhandledrejection: "unhandledrejection";
+    }>;
+}, z.core.$strip>>>;
+/** What a SvelteKit `+error.svelte` boundary reports. */
+export declare const SvelteKitErrorSchema: z.ZodObject<{
+    status: z.ZodNumber;
+    message: z.ZodString;
+    route: z.ZodString;
+    stack: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SvelteKitError = z.input<typeof SvelteKitErrorSchema>;
+/** The handed runtime surface error capture reads: its browser host and host version. */
+export type ErrorCaptureRuntime = Pick<RuntimeRef, 'hasKind' | 'query' | 'localEnvironment'>;
+/**
+ * Capture an error from a SvelteKit `+error.svelte` boundary. The event is
+ * always recorded through the handed logger first. It is then appended to the
+ * ring buffer (`vibes:error-log`, newest 100) on the handed runtime's browser
+ * host; a host with no browser host refuses `UNAVAILABLE browser-host-unavailable`.
+ * A storage refusal (quota, private mode) is reported through the logger.
+ */
+export declare function captureSvelteKitError(runtime: ErrorCaptureRuntime, logger: Logger, error: SvelteKitError): Promise<void>;
+//# sourceMappingURL=capture-error.d.ts.map

package/dist/browser/capture-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-error.d.ts","sourceRoot":"","sources":["../../src/browser/capture-error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAkD,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI/C,kGAAkG;AAClG,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AACvD,qDAAqD;AACrD,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,MAAM,EAAE,WAAW,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;CAC9D;AAaD,mGAAmG;AACnG,eAAO,MAAM,qBAAqB;;;;;;;;;;;;mBAKQ,CAAC;AAE3C,yDAAyD;AACzD,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,yFAAyF;AACzF,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,GAAG,kBAAkB,CAAC,CAAC;AAY7F;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB9H"}

package/dist/browser/capture-error.js

@@ -0,0 +1,82 @@
+/**
+ * Browser Error Capture
+ *
+ * Records client-side errors from SvelteKit error boundaries through the
+ * handed logger, and keeps the most recent ones in a ring buffer on the handed
+ * runtime's browser host storage (`runtime/browser-host`).
+ */
+import * as z from 'zod/v4';
+import { getRuntimeBrowserHost } from '@vibesdotdev/kernel';
+import { attempt } from "../core/outcome.js";
+import { createFieldsReadSchema, RedactedLogValueSchema } from "../core/redact.js";
+/** The browser host storage key of the error ring buffer; `read-errors.ts` reads the same key. */
+export const ERROR_RING_BUFFER_KEY = 'vibes:error-log';
+/** The ring buffer keeps this many newest events. */
+export const ERROR_RING_BUFFER_SIZE = 100;
+/** The persisted ring-buffer entry, parsed where it is read back from storage. */
+const ErrorTelemetryEventSchema = z.object({
+    timestamp: z.string(),
+    version: z.string(),
+    route: z.string(),
+    message: z.string(),
+    stack: z.string().optional(),
+    status: z.number().optional(),
+    source: z.enum(['sveltekit', 'window.onerror', 'unhandledrejection'])
+});
+/** The stored ring buffer: a JSON array of `ErrorTelemetryEvent`. Shared with `read-errors.ts`. */
+export const ErrorRingBufferSchema = z.string().transform((raw, context) => {
+    const parsed = attempt(() => JSON.parse(raw));
+    if (!parsed.failed)
+        return parsed.value;
+    context.addIssue({ code: 'custom', message: parsed.cause instanceof Error ? parsed.cause.message : 'The stored ring buffer is not JSON.' });
+    return z.NEVER;
+}).pipe(ErrorTelemetryEventSchema.array());
+/** What a SvelteKit `+error.svelte` boundary reports. */
+export const SvelteKitErrorSchema = z.object({
+    status: z.number(),
+    message: z.string(),
+    route: z.string(),
+    stack: z.string().optional()
+});
+const SvelteKitErrorFieldsSchema = createFieldsReadSchema(['status', 'message', 'route', 'stack']);
+/** The stored ring buffer; a malformed one is reported and replaced. */
+function readRingBuffer(storage, logger) {
+    const raw = storage.getItem(ERROR_RING_BUFFER_KEY);
+    if (raw === null)
+        return [];
+    const stored = ErrorRingBufferSchema.safeParse(raw);
+    if (stored.success)
+        return stored.data;
+    logger.warn('Replacing a malformed browser error ring buffer.', { key: ERROR_RING_BUFFER_KEY, issues: stored.error.issues.map(issue => issue.message) });
+    return [];
+}
+/**
+ * Capture an error from a SvelteKit `+error.svelte` boundary. The event is
+ * always recorded through the handed logger first. It is then appended to the
+ * ring buffer (`vibes:error-log`, newest 100) on the handed runtime's browser
+ * host; a host with no browser host refuses `UNAVAILABLE browser-host-unavailable`.
+ * A storage refusal (quota, private mode) is reported through the logger.
+ */
+export async function captureSvelteKitError(runtime, logger, error) {
+    // Each field is read once inside a guard and walked before it is validated, so a hostile error refuses with a
+    // typed, value-free `ZodError`, never with what a getter or Proxy trap threw.
+    const input = SvelteKitErrorSchema.parse(RedactedLogValueSchema.parse(SvelteKitErrorFieldsSchema.parse(error)));
+    const event = {
+        timestamp: new Date().toISOString(),
+        version: runtime.localEnvironment.hostVersion?.() ?? 'unknown',
+        route: input.route,
+        message: input.message,
+        stack: input.stack,
+        status: input.status,
+        source: 'sveltekit'
+    };
+    logger.error(`SvelteKit error boundary: ${event.message}`, { ...event });
+    const { storage } = await getRuntimeBrowserHost(runtime);
+    const stored = attempt(() => {
+        const buffer = [...readRingBuffer(storage, logger), event].slice(-ERROR_RING_BUFFER_SIZE);
+        storage.setItem(ERROR_RING_BUFFER_KEY, JSON.stringify(buffer));
+    });
+    if (stored.failed)
+        logger.warn('The browser error ring buffer refused the captured event.', { key: ERROR_RING_BUFFER_KEY, error: stored.cause });
+}
+//# sourceMappingURL=capture-error.js.map

package/dist/browser/capture-error.js.map

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

package/dist/browser/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @vibesdotdev/logging/browser
+ *
+ * Browser-optimized logging sinks for vibes logging.
+ */
+export { default as loggingBrowserPlugin, loggingBrowserPlugin as default } from './logging-browser.plugin.ts';
+export { browserSinkDescriptor } from './sinks/browser/browser.browser.descriptor.ts';
+export { default as BrowserSink } from './sinks/browser/browser.impl.browser.ts';
+export { captureSvelteKitError, type SvelteKitError, type ErrorCaptureRuntime, type ErrorTelemetryEvent } from './capture-error.ts';
+export { readRecentBrowserErrors, ReadRecentBrowserErrorsOptionsSchema, type ReadRecentBrowserErrorsOptions, type ErrorReadRuntime } from './read-errors.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,oBAAoB,IAAI,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAG/G,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAGtF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAGjF,OAAO,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGpI,OAAO,EAAE,uBAAuB,EAAE,oCAAoC,EAAE,KAAK,8BAA8B,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,16 @@
+/**
+ * @vibesdotdev/logging/browser
+ *
+ * Browser-optimized logging sinks for vibes logging.
+ */
+// Plugin
+export { default as loggingBrowserPlugin, loggingBrowserPlugin as default } from "./logging-browser.plugin.js";
+// Sink descriptors
+export { browserSinkDescriptor } from "./sinks/browser/browser.browser.descriptor.js";
+// Implementation (for direct use / testing)
+export { default as BrowserSink } from "./sinks/browser/browser.impl.browser.js";
+// SvelteKit error boundary capture
+export { captureSvelteKitError } from "./capture-error.js";
+// Recent captured errors, read back from the ring buffer
+export { readRecentBrowserErrors, ReadRecentBrowserErrorsOptionsSchema } from "./read-errors.js";
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,SAAS;AACT,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,oBAAoB,IAAI,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAE/G,mBAAmB;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAEtF,4CAA4C;AAC5C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAEjF,mCAAmC;AACnC,OAAO,EAAE,qBAAqB,EAA2E,MAAM,oBAAoB,CAAC;AAEpI,yDAAyD;AACzD,OAAO,EAAE,uBAAuB,EAAE,oCAAoC,EAA8D,MAAM,kBAAkB,CAAC"}

package/dist/browser/logging-browser.plugin.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Logging Browser Plugin
+ *
+ * Registers browser-optimized logging sinks with the runtime.
+ * Browser environments only (uses localStorage, window, console CSS).
+ */
+export declare const loggingBrowserPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default loggingBrowserPlugin;
+//# sourceMappingURL=logging-browser.plugin.d.ts.map

package/dist/browser/logging-browser.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-browser.plugin.d.ts","sourceRoot":"","sources":["../../src/browser/logging-browser.plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,eAAO,MAAM,oBAAoB,6CAiB/B,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/browser/logging-browser.plugin.js

@@ -0,0 +1,26 @@
+/**
+ * Logging Browser Plugin
+ *
+ * Registers browser-optimized logging sinks with the runtime.
+ * Browser environments only (uses localStorage, window, console CSS).
+ */
+import { createRuntimePlugin, getRuntimeBrowserHost, getRuntimeConsole } from '@vibesdotdev/kernel';
+// Descriptors
+import browserSinkDescriptor from "./sinks/browser/browser.browser.descriptor.js";
+export const loggingBrowserPlugin = createRuntimePlugin({
+    id: '@vibesdotdev/logging/browser',
+    name: 'Logging Browser',
+    description: 'Browser-optimized logging sinks with localStorage buffering and styled console output.',
+    dependencies: ['logging'],
+    descriptors: [browserSinkDescriptor],
+    onRegister: async (runtime) => {
+        // Register loader for browser sink implementation
+        runtime.registerLoader('logging/sink', browserSinkDescriptor.id, async () => {
+            await getRuntimeBrowserHost(runtime);
+            await getRuntimeConsole(runtime);
+            return { impl: (await import("./sinks/browser/browser.impl.browser.js")).default };
+        });
+    }
+});
+export default loggingBrowserPlugin;
+//# sourceMappingURL=logging-browser.plugin.js.map

package/dist/browser/logging-browser.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-browser.plugin.js","sourceRoot":"","sources":["../../src/browser/logging-browser.plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEpG,cAAc;AACd,OAAO,qBAAqB,MAAM,+CAA+C,CAAC;AAElF,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;IACvD,EAAE,EAAE,8BAA8B;IAClC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACV,wFAAwF;IACzF,YAAY,EAAE,CAAC,SAAS,CAAC;IAEzB,WAAW,EAAE,CAAC,qBAAqB,CAAC;IAEpC,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC7B,kDAAkD;QAClD,OAAO,CAAC,cAAc,CAAC,cAAc,EAAE,qBAAqB,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE;YAC3E,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACjC,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,yCAAyC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACpF,CAAC,CAAC,CAAC;IACJ,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/browser/plugin.d.ts

@@ -0,0 +1,2 @@
+export { default } from './logging-browser.plugin.ts';
+//# sourceMappingURL=plugin.d.ts.map

package/dist/browser/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/browser/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/browser/plugin.js

@@ -0,0 +1,2 @@
+export { default } from "./logging-browser.plugin.js";
+//# sourceMappingURL=plugin.js.map

package/dist/browser/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/browser/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/browser/read-errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Browser Error Reader
+ *
+ * Reads the recent errors `captureSvelteKitError` keeps in the ring buffer on
+ * the handed runtime's browser host storage (`runtime/browser-host`). The
+ * reader never writes: a malformed buffer reads as empty and is left for the
+ * next capture to report and replace.
+ */
+import * as z from 'zod/v4';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type ErrorTelemetryEvent } from './capture-error.ts';
+/** How many recent errors to read, and from when. */
+export declare const ReadRecentBrowserErrorsOptionsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    since: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
+export type ReadRecentBrowserErrorsOptions = z.input<typeof ReadRecentBrowserErrorsOptionsSchema>;
+/** The handed runtime surface the reader needs: its browser host. */
+export type ErrorReadRuntime = Pick<RuntimeRef, 'hasKind' | 'query'>;
+/**
+ * The newest recorded browser errors, oldest first. A runtime with no browser
+ * host refuses `UNAVAILABLE browser-host-unavailable`; an absent, unreadable
+ * or malformed buffer reads as no errors.
+ */
+export declare function readRecentBrowserErrors(runtime: ErrorReadRuntime, options?: ReadRecentBrowserErrorsOptions): Promise<ErrorTelemetryEvent[]>;
+//# sourceMappingURL=read-errors.d.ts.map

package/dist/browser/read-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-errors.d.ts","sourceRoot":"","sources":["../../src/browser/read-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,EAAwE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEpI,qDAAqD;AACrD,eAAO,MAAM,oCAAoC;;;iBAK/C,CAAC;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAElG,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC;AAErE;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,GAAE,8BAAmC,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAUrJ"}

package/dist/browser/read-errors.js

@@ -0,0 +1,38 @@
+/**
+ * Browser Error Reader
+ *
+ * Reads the recent errors `captureSvelteKitError` keeps in the ring buffer on
+ * the handed runtime's browser host storage (`runtime/browser-host`). The
+ * reader never writes: a malformed buffer reads as empty and is left for the
+ * next capture to report and replace.
+ */
+import * as z from 'zod/v4';
+import { getRuntimeBrowserHost } from '@vibesdotdev/kernel';
+import { attempt } from "../core/outcome.js";
+import { ERROR_RING_BUFFER_KEY, ERROR_RING_BUFFER_SIZE, ErrorRingBufferSchema } from "./capture-error.js";
+/** How many recent errors to read, and from when. */
+export const ReadRecentBrowserErrorsOptionsSchema = z.object({
+    /** The newest N events, at most the ring buffer's size. Default 20. */
+    limit: z.number().int().positive().max(ERROR_RING_BUFFER_SIZE).default(20),
+    /** Only events at or after this ISO timestamp. */
+    since: z.iso.datetime().optional()
+});
+/**
+ * The newest recorded browser errors, oldest first. A runtime with no browser
+ * host refuses `UNAVAILABLE browser-host-unavailable`; an absent, unreadable
+ * or malformed buffer reads as no errors.
+ */
+export async function readRecentBrowserErrors(runtime, options = {}) {
+    const { limit, since } = ReadRecentBrowserErrorsOptionsSchema.parse(options);
+    const { storage } = await getRuntimeBrowserHost(runtime);
+    const raw = attempt(() => storage.getItem(ERROR_RING_BUFFER_KEY));
+    if (raw.failed || raw.value === null)
+        return [];
+    const stored = ErrorRingBufferSchema.safeParse(raw.value);
+    if (!stored.success)
+        return [];
+    const floor = since === undefined ? undefined : Date.parse(since);
+    const events = floor === undefined ? stored.data : stored.data.filter(event => Date.parse(event.timestamp) >= floor);
+    return events.slice(-limit);
+}
+//# sourceMappingURL=read-errors.js.map

package/dist/browser/read-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-errors.js","sourceRoot":"","sources":["../../src/browser/read-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAmB,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,qBAAqB,EAA4B,MAAM,oBAAoB,CAAC;AAEpI,qDAAqD;AACrD,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5D,uEAAuE;IACvE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1E,kDAAkD;IAClD,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAMH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAAyB,EAAE,UAA0C,EAAE;IACpH,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,oCAAoC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7E,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAClE,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,CAAC;IACrH,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/browser/sinks/browser/browser.browser.descriptor.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Browser Sink Descriptor
+ *
+ * Browser-optimized sink with localStorage buffering and styled console output.
+ * Provides persistence across page reloads and batched log delivery.
+ */
+import type { SinkDescriptor } from '@vibesdotdev/logging/schemas/sink';
+export declare const browserSinkDescriptor: SinkDescriptor;
+export default browserSinkDescriptor;
+//# sourceMappingURL=browser.browser.descriptor.d.ts.map

package/dist/browser/sinks/browser/browser.browser.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.browser.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/browser/sinks/browser/browser.browser.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAExE,eAAO,MAAM,qBAAqB,EAAE,cAcnC,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/dist/browser/sinks/browser/browser.browser.descriptor.js

@@ -0,0 +1,23 @@
+/**
+ * Browser Sink Descriptor
+ *
+ * Browser-optimized sink with localStorage buffering and styled console output.
+ * Provides persistence across page reloads and batched log delivery.
+ */
+export const browserSinkDescriptor = {
+    kind: 'logging/sink',
+    id: 'browser',
+    name: 'Browser Sink',
+    description: 'Browser-optimized logging with localStorage buffering and styled console output',
+    tags: ['browser', 'persistent'],
+    requiredContext: ['runtime/browser-host', 'runtime/stdio'],
+    async: true,
+    batching: {
+        enabled: true,
+        maxSize: 100,
+        maxWait: 5000 // 5 seconds
+    },
+    formats: ['jsonl', 'pretty']
+};
+export default browserSinkDescriptor;
+//# sourceMappingURL=browser.browser.descriptor.js.map

package/dist/browser/sinks/browser/browser.browser.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.browser.descriptor.js","sourceRoot":"","sources":["../../../../src/browser/sinks/browser/browser.browser.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACpD,IAAI,EAAE,cAAc;IACpB,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,iFAAiF;IAC9F,IAAI,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC;IAC/B,eAAe,EAAE,CAAC,sBAAsB,EAAE,eAAe,CAAC;IAC1D,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE;QACT,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,GAAG;QACZ,OAAO,EAAE,IAAI,CAAC,YAAY;KAC1B;IACD,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;CAC5B,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/dist/browser/sinks/browser/browser.impl.browser.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Browser Sink Implementation
+ *
+ * Browser-optimized sink with:
+ * - localStorage buffering for persistence across reloads
+ * - Styled console output using CSS
+ * - Batched writes for performance
+ * - Automatic cleanup on page unload
+ */
+import type { SinkImplementation, SinkContext } from '@vibesdotdev/logging/kinds/sink';
+import type { SinkDescriptor } from '@vibesdotdev/logging/schemas/sink';
+import { type RuntimeLogEntry } from '@vibesdotdev/logging/schemas/entry';
+import * as z from 'zod/v4';
+import { type RuntimeBrowserHost, type RuntimeConsole } from '@vibesdotdev/kernel';
+/**
+ * The most recent browser storage failure the sink absorbed. Storage failures
+ * never break logging (console output continues, accepted entries stay in
+ * memory), so they are recorded here instead of thrown: `read`/`remove`/`write`
+ * carry the host's refusal as `cause`; `malformed` carries the parse issues of
+ * a stored buffer that is not valid wire entries.
+ */
+export type BrowserStorageFailure = {
+    readonly operation: 'read' | 'remove' | 'write';
+    readonly key: string;
+    readonly cause: unknown;
+} | {
+    readonly operation: 'malformed';
+    readonly key: string;
+    readonly cause: z.ZodError;
+};
+export interface BrowserSinkContext extends SinkContext {
+    readonly 'runtime/browser-host': RuntimeBrowserHost;
+    readonly 'runtime/stdio': RuntimeConsole;
+}
+/**
+ * Browser sink - optimized for browser environments with:
+ * - Styled console output with color-coded namespaces
+ * - localStorage buffering for persistence
+ * - Batched writes and automatic cleanup
+ */
+export default class BrowserSink implements SinkImplementation {
+    readonly id: string;
+    readonly descriptor: SinkDescriptor;
+    private readonly config;
+    private buffer;
+    /** The one-shot persist pending for the current buffer (lifecycle-owned, RC07). */
+    private flushDisposer;
+    /** Batched persistence delay; unset when batching is off. */
+    private readonly batchWaitMs;
+    private readonly runtime;
+    private readonly browser;
+    private readonly console;
+    private unsubscribeUnload;
+    private closed;
+    private lastStorageFailure;
+    constructor(descriptor: SinkDescriptor, context: BrowserSinkContext);
+    emit(entry: RuntimeLogEntry): void;
+    private schedulePersist;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Absorb a storage failure observably: record it for {@link storageFailure}
+     * and report it once on the handed console when it is a new kind of failure,
+     * so a refused or full storage is never silent and never floods the console.
+     */
+    private recordStorageFailure;
+    /**
+     * The latest absorbed storage failure, or `null` when none was recorded. A
+     * later successful write clears a `write` failure. See {@link BrowserStorageFailure}.
+     */
+    storageFailure(): BrowserStorageFailure | null;
+    /**
+     * Valid persisted wire entries. An absent buffer (or disabled storage) is
+     * empty; a refused read or a malformed buffer is also empty and is recorded
+     * on {@link storageFailure}.
+     */
+    getBufferedEntries(): RuntimeLogEntry[];
+    clearBuffer(): void;
+    private writeToConsole;
+    private persistBuffer;
+    private restoreBuffer;
+}
+//# sourceMappingURL=browser.impl.browser.d.ts.map

package/dist/browser/sinks/browser/browser.impl.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.impl.browser.d.ts","sourceRoot":"","sources":["../../../../src/browser/sinks/browser/browser.impl.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAyB,KAAK,eAAe,EAAiB,MAAM,oCAAoC,CAAC;AAChH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,OAAO,EAAmD,KAAK,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAkDpI;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAC9B;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAClG;IAAE,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,CAAC;AAEzF,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACtD,QAAQ,CAAC,sBAAsB,EAAE,kBAAkB,CAAC;IACpD,QAAQ,CAAC,eAAe,EAAE,cAAc,CAAC;CACzC;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,WAAY,YAAW,kBAAkB;IAC7D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,MAAM,CAAyB;IACvC,mFAAmF;IACnF,OAAO,CAAC,aAAa,CAAyB;IAC9C,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,kBAAkB,CAAsC;gBAEpD,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB;IAoBnE,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAgBlC,OAAO,CAAC,eAAe;IAajB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;;OAGG;IACH,cAAc,IAAI,qBAAqB,GAAG,IAAI;IAI9C;;;;OAIG;IACH,kBAAkB,IAAI,eAAe,EAAE;IAevC,WAAW,IAAI,IAAI;IASnB,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,aAAa;CAUrB"}