@qvac/sdk 0.8.1 → 1.1.0

package/dist/profiling/controller.js

@@ -1,123 +0,0 @@
-/**
- * Central state management for profiling enablement, configuration, and recording.
- *
- * Precedence (highest to lowest):
- * 1. Per-call override
- * 2. Runtime API (enable/disable)
- * 3. Disabled default
- */
-import { getGlobalSingleton } from "../utils/global-singleton.js";
-import { createAggregator, recordEvent as aggregatorRecord, getAggregates as aggregatorGetAggregates, getRecentEvents as aggregatorGetRecentEvents, clearAggregator, setMaxRecentEvents, } from "./aggregator.js";
-import { nowMs, generateProfileId } from "./clock.js";
-const DEFAULT_CONFIG = {
-    enabled: false,
-    mode: "summary",
-    includeServerBreakdown: false,
-    operationFilters: [],
-    maxRecentEvents: 1000,
-};
-const CONTROLLER_STATE_KEY = Symbol.for("@qvac/sdk:profiler-controller-state");
-function getControllerState() {
-    const state = getGlobalSingleton(CONTROLLER_STATE_KEY, () => {
-        return {
-            runtimeOverride: undefined,
-            runtimeOptions: {},
-            onRecordCallbacks: [],
-            initialized: false,
-        };
-    });
-    if (!state.initialized) {
-        createAggregator(DEFAULT_CONFIG.maxRecentEvents);
-        state.initialized = true;
-    }
-    return state;
-}
-export function enable(options) {
-    const state = getControllerState();
-    state.runtimeOverride = true;
-    state.runtimeOptions = options ? { ...options } : {};
-    clearAggregator();
-    setMaxRecentEvents(DEFAULT_CONFIG.maxRecentEvents);
-}
-export function disable() {
-    const state = getControllerState();
-    state.runtimeOverride = false;
-    state.runtimeOptions = {};
-    setMaxRecentEvents(DEFAULT_CONFIG.maxRecentEvents);
-}
-export function isEnabled() {
-    const state = getControllerState();
-    return state.runtimeOverride ?? false;
-}
-export function getEffectiveConfig() {
-    const state = getControllerState();
-    return {
-        enabled: isEnabled(),
-        mode: state.runtimeOptions.mode ?? DEFAULT_CONFIG.mode,
-        includeServerBreakdown: state.runtimeOptions.includeServerBreakdown ??
-            DEFAULT_CONFIG.includeServerBreakdown,
-        operationFilters: [
-            ...(state.runtimeOptions.operationFilters ?? DEFAULT_CONFIG.operationFilters),
-        ],
-        maxRecentEvents: DEFAULT_CONFIG.maxRecentEvents,
-    };
-}
-export function shouldProfile(operation, perCallOptions) {
-    if (perCallOptions?.enabled !== undefined) {
-        return perCallOptions.enabled;
-    }
-    if (!isEnabled()) {
-        return false;
-    }
-    const config = getEffectiveConfig();
-    if (config.operationFilters.length > 0) {
-        return config.operationFilters.includes(operation);
-    }
-    return true;
-}
-export function shouldIncludeServerBreakdown(perCallOptions) {
-    if (perCallOptions?.includeServerBreakdown !== undefined) {
-        return perCallOptions.includeServerBreakdown;
-    }
-    return getEffectiveConfig().includeServerBreakdown;
-}
-export function generateId() {
-    return generateProfileId();
-}
-export function record(event) {
-    const state = getControllerState();
-    let eventWithTs = event;
-    if (event.ts === undefined) {
-        eventWithTs = { ...event, ts: nowMs() };
-    }
-    const storeInBuffer = getEffectiveConfig().mode === "verbose";
-    aggregatorRecord(eventWithTs, storeInBuffer);
-    for (const cb of state.onRecordCallbacks) {
-        try {
-            cb(eventWithTs);
-        }
-        catch {
-            // Callback errors should not break profiling
-        }
-    }
-}
-/** Returns unsubscribe function. */
-export function onRecord(callback) {
-    const state = getControllerState();
-    state.onRecordCallbacks.push(callback);
-    return () => {
-        const idx = state.onRecordCallbacks.indexOf(callback);
-        if (idx >= 0) {
-            state.onRecordCallbacks.splice(idx, 1);
-        }
-    };
-}
-export function getAggregates() {
-    return aggregatorGetAggregates();
-}
-export function getRecentEvents() {
-    return aggregatorGetRecentEvents();
-}
-export function clear() {
-    clearAggregator();
-}

package/dist/profiling/envelope.d.ts

@@ -1,10 +0,0 @@
-/**
- * Helpers to inject/extract __profiling metadata in RPC payloads.
- */
-import { type ProfilingRequestMeta, type ProfilingResponseMeta } from "../schemas/index";
-export declare function createProfilingMeta(profileId: string, includeServerBreakdown: boolean): ProfilingRequestMeta;
-export declare function createProfilingDisabledMeta(): ProfilingRequestMeta;
-export declare function injectProfilingMetaIntoObject(obj: Record<string, unknown>, meta: ProfilingRequestMeta): Record<string, unknown>;
-export declare function extractProfilingMeta(payload: unknown): ProfilingResponseMeta | undefined;
-export declare function stripProfilingMeta<T extends object>(payload: T): T;
-//# sourceMappingURL=envelope.d.ts.map

package/dist/profiling/envelope.js

@@ -1,36 +0,0 @@
-/**
- * Helpers to inject/extract __profiling metadata in RPC payloads.
- */
-import { PROFILING_KEY, } from "../schemas/index.js";
-export function createProfilingMeta(profileId, includeServerBreakdown) {
-    return {
-        enabled: true,
-        id: profileId,
-        includeServer: includeServerBreakdown,
-    };
-}
-export function createProfilingDisabledMeta() {
-    return { enabled: false };
-}
-export function injectProfilingMetaIntoObject(obj, meta) {
-    return { ...obj, [PROFILING_KEY]: meta };
-}
-export function extractProfilingMeta(payload) {
-    if (typeof payload === "object" &&
-        payload !== null &&
-        PROFILING_KEY in payload) {
-        const meta = payload[PROFILING_KEY];
-        if (typeof meta === "object" && meta !== null) {
-            return meta;
-        }
-    }
-    return undefined;
-}
-export function stripProfilingMeta(payload) {
-    if (PROFILING_KEY in payload) {
-        const { [PROFILING_KEY]: _unused, ...rest } = payload;
-        void _unused;
-        return rest;
-    }
-    return payload;
-}

package/dist/profiling/events.d.ts

@@ -1,20 +0,0 @@
-import type { ProfilingEventKind } from "./types";
-import type { ServerBreakdown, DelegationBreakdown } from "../schemas/index";
-export interface BaseTimings {
-    profileId: string;
-    requestType: string;
-    requestStart: number;
-}
-export interface BaseEvent {
-    ts: number;
-    op: string;
-    kind: ProfilingEventKind;
-    profileId: string;
-}
-export declare function recordPhase(base: BaseEvent, phase: string, ms?: number, extra?: {
-    count?: number;
-}): void;
-export declare function recordFailure(base: BaseEvent, startTime: number, error: unknown): void;
-export declare function recordServerBreakdownPhases(base: BaseEvent, server: ServerBreakdown, prefix?: string): void;
-export declare function recordDelegationBreakdownPhases(base: BaseEvent, delegation: DelegationBreakdown, prefix?: string): void;
-//# sourceMappingURL=events.d.ts.map

package/dist/profiling/events.js

@@ -1,37 +0,0 @@
-import { nowMs } from "./clock.js";
-import { record } from "./controller.js";
-export function recordPhase(base, phase, ms, extra) {
-    if (ms === undefined)
-        return;
-    record({ ...base, phase, ms, ...extra });
-}
-export function recordFailure(base, startTime, error) {
-    const now = nowMs();
-    record({
-        ...base,
-        ts: now,
-        phase: "failed",
-        ms: now - startTime,
-        tags: {
-            error: error instanceof Error ? error.name : "Unknown",
-            message: error instanceof Error
-                ? error.message.slice(0, 100)
-                : String(error).slice(0, 100),
-        },
-    });
-}
-export function recordServerBreakdownPhases(base, server, prefix = "server") {
-    recordPhase(base, `${prefix}.request.jsonParse`, server.requestJsonParseMs);
-    recordPhase(base, `${prefix}.request.zodValidation`, server.requestZodValidationMs);
-    recordPhase(base, `${prefix}.handlerExecution`, server.handlerExecutionMs);
-    recordPhase(base, `${prefix}.response.zodValidation`, server.responseZodValidationMs);
-    recordPhase(base, `${prefix}.response.stringify`, server.responseStringifyMs);
-    recordPhase(base, `${prefix}.totalServerTime`, server.totalServerMs);
-}
-export function recordDelegationBreakdownPhases(base, delegation, prefix = "delegation") {
-    recordPhase(base, `${prefix}.connection`, delegation.connectionMs);
-    recordPhase(base, `${prefix}.request.stringify`, delegation.requestStringifyMs);
-    recordPhase(base, `${prefix}.serverWait`, delegation.serverWaitMs);
-    recordPhase(base, `${prefix}.response.jsonParse`, delegation.responseJsonParseMs);
-    recordPhase(base, `${prefix}.totalDelegationTime`, delegation.totalDelegationMs);
-}

package/dist/profiling/exporters.d.ts

@@ -1,10 +0,0 @@
-/**
- * JSON, table, and summary export utilities for profiling data.
- */
-import type { ProfilerExport } from "./types";
-export declare function exportJSON(options?: {
-    includeRecentEvents?: boolean;
-}): ProfilerExport;
-export declare function exportTable(): string;
-export declare function exportSummary(): string;
-//# sourceMappingURL=exporters.d.ts.map

package/dist/profiling/exporters.js

@@ -1,236 +0,0 @@
-/**
- * JSON, table, and summary export utilities for profiling data.
- */
-import { getEffectiveConfig, getAggregates, getRecentEvents, } from "./controller.js";
-import { getDroppedCount, getEventCount } from "./aggregator.js";
-import { nowMs, getClockSource, isMonotonic } from "./clock.js";
-export function exportJSON(options) {
-    const config = getEffectiveConfig();
-    const includeRecent = options?.includeRecentEvents ?? true;
-    const result = {
-        config,
-        aggregates: getAggregates(),
-        exportedAt: nowMs(),
-    };
-    if (includeRecent && config.mode === "verbose") {
-        result.recentEvents = getRecentEvents();
-    }
-    return result;
-}
-function aggregateMatchingStats(aggregates, predicate) {
-    const matches = Object.entries(aggregates).filter(([key]) => predicate(key));
-    if (matches.length === 0) {
-        return undefined;
-    }
-    let count = 0;
-    let sum = 0;
-    let min = Infinity;
-    let max = -Infinity;
-    let last = 0;
-    for (const [, stats] of matches) {
-        count += stats.count;
-        sum += stats.sum;
-        if (stats.count > 0) {
-            if (stats.min < min)
-                min = stats.min;
-            if (stats.max > max)
-                max = stats.max;
-            last = stats.last;
-        }
-    }
-    return {
-        count,
-        min: count > 0 ? min : 0,
-        max: count > 0 ? max : 0,
-        avg: count > 0 ? sum / count : 0,
-        sum,
-        last,
-    };
-}
-function formatDuration(ms) {
-    if (ms < 1) {
-        return `${(ms * 1000).toFixed(0)}μs`;
-    }
-    if (ms < 1000) {
-        return `${ms.toFixed(1)}ms`;
-    }
-    if (ms < 60000) {
-        return `${(ms / 1000).toFixed(2)}s`;
-    }
-    return `${(ms / 60000).toFixed(2)}m`;
-}
-function formatBytes(bytes) {
-    if (bytes < 1024)
-        return `${bytes.toFixed(0)} B`;
-    if (bytes < 1024 * 1024)
-        return `${(bytes / 1024).toFixed(1)} KB`;
-    if (bytes < 1024 * 1024 * 1024)
-        return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
-    return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GB`;
-}
-function formatThroughput(bps) {
-    if (bps < 1024)
-        return `${bps.toFixed(0)} B/s`;
-    if (bps < 1024 * 1024)
-        return `${(bps / 1024).toFixed(1)} KB/s`;
-    if (bps < 1024 * 1024 * 1024)
-        return `${(bps / (1024 * 1024)).toFixed(2)} MB/s`;
-    return `${(bps / (1024 * 1024 * 1024)).toFixed(2)} GB/s`;
-}
-function formatNumber(n) {
-    if (Number.isInteger(n)) {
-        return n.toLocaleString();
-    }
-    if (n === 0)
-        return "0";
-    if (Math.abs(n) < 0.01)
-        return n.toExponential(2);
-    if (Math.abs(n) < 1)
-        return n.toFixed(3);
-    if (Math.abs(n) < 100)
-        return n.toFixed(2);
-    return n.toFixed(1);
-}
-function detectMetricType(metricName) {
-    const lowerName = metricName.toLowerCase();
-    if (lowerName.includes("bps") || lowerName.includes("speed")) {
-        return "throughput";
-    }
-    if (lowerName.includes("bytes") || lowerName.includes("downloaded") || lowerName.includes("size")) {
-        return "bytes";
-    }
-    if (lowerName.endsWith("time") ||
-        lowerName.endsWith("ms") ||
-        lowerName.endsWith("duration") ||
-        lowerName.includes("ttfb") ||
-        lowerName.includes("latency") ||
-        lowerName.includes("wait") ||
-        lowerName.includes("overhead") ||
-        lowerName.includes("parse") ||
-        lowerName.includes("stringify") ||
-        lowerName.includes("validation") ||
-        lowerName.includes("execution") ||
-        lowerName.includes("serialization") ||
-        lowerName.includes("connection")) {
-        return "duration";
-    }
-    if (lowerName.includes("count") || lowerName.includes("token")) {
-        return "number";
-    }
-    // Default to duration for unknown metrics (most profiling is timing)
-    return "duration";
-}
-function formatMetricValue(value, metricName) {
-    const type = detectMetricType(metricName);
-    switch (type) {
-        case "bytes":
-            return formatBytes(value);
-        case "throughput":
-            return formatThroughput(value);
-        case "number":
-            return formatNumber(value);
-        case "duration":
-        default:
-            return formatDuration(value);
-    }
-}
-function pad(s, len, align = "left") {
-    if (s.length >= len)
-        return s.substring(0, len);
-    const spaces = " ".repeat(len - s.length);
-    return align === "left" ? s + spaces : spaces + s;
-}
-export function exportTable() {
-    const aggregates = getAggregates();
-    const entries = Object.entries(aggregates);
-    if (entries.length === 0) {
-        return "No profiling data recorded.";
-    }
-    const metricWidth = 40;
-    const numWidth = 12;
-    const header = [
-        pad("Metric", metricWidth),
-        pad("Count", numWidth, "right"),
-        pad("Min", numWidth, "right"),
-        pad("Max", numWidth, "right"),
-        pad("Avg", numWidth, "right"),
-        pad("Total", numWidth, "right"),
-    ].join(" | ");
-    const separator = "-".repeat(header.length);
-    const rows = entries
-        .sort((a, b) => a[0].localeCompare(b[0]))
-        .map(([metric, stats]) => {
-        return [
-            pad(metric, metricWidth),
-            pad(formatNumber(stats.count), numWidth, "right"),
-            pad(formatMetricValue(stats.min, metric), numWidth, "right"),
-            pad(formatMetricValue(stats.max, metric), numWidth, "right"),
-            pad(formatMetricValue(stats.avg, metric), numWidth, "right"),
-            pad(formatMetricValue(stats.sum, metric), numWidth, "right"),
-        ].join(" | ");
-    });
-    return [separator, header, separator, ...rows, separator].join("\n");
-}
-export function exportSummary() {
-    const aggregates = getAggregates();
-    const config = getEffectiveConfig();
-    const eventCount = getEventCount();
-    const droppedCount = getDroppedCount();
-    const lines = [
-        "=".repeat(60),
-        "PROFILER SUMMARY",
-        "=".repeat(60),
-        "",
-        "Session:",
-        `  Status:        ${config.enabled ? "enabled" : "disabled"}`,
-        `  Mode:          ${config.mode}`,
-        `  Clock:         ${getClockSource()} (monotonic: ${isMonotonic()})`,
-        `  Events:        ${eventCount.toLocaleString()}`,
-        `  Dropped:       ${droppedCount.toLocaleString()}`,
-        "",
-    ];
-    const keyMetrics = [
-        {
-            label: "RPC Total",
-            stats: aggregateMatchingStats(aggregates, (key) => key.endsWith(".totalClientTime")),
-        },
-        {
-            label: "Handler",
-            stats: aggregateMatchingStats(aggregates, (key) => key.endsWith(".server.handlerExecution") || !key.includes(".")),
-        },
-        {
-            label: "Model Load",
-            stats: aggregateMatchingStats(aggregates, (key) => key === "load.totalTime" || key.endsWith(".load.totalTime")),
-        },
-        {
-            label: "Download",
-            stats: aggregateMatchingStats(aggregates, (key) => key === "download.time" || key.endsWith(".download.time")),
-        },
-    ];
-    const hasMetrics = keyMetrics.some((m) => m.stats);
-    if (hasMetrics) {
-        lines.push("Key Metrics:");
-        lines.push("-".repeat(60));
-        lines.push("  " +
-            "Metric".padEnd(18) +
-            "Samples".padStart(10) +
-            "Avg".padStart(12) +
-            "Total".padStart(12));
-        lines.push("-".repeat(60));
-        for (const { label, stats } of keyMetrics) {
-            if (stats) {
-                const name = label.padEnd(18);
-                const samples = String(stats.count).padStart(10);
-                const avg = formatDuration(stats.avg).padStart(12);
-                const total = formatDuration(stats.sum).padStart(12);
-                lines.push(`  ${name}${samples}${avg}${total}`);
-            }
-        }
-    }
-    else {
-        lines.push("No metrics recorded yet.");
-    }
-    lines.push("");
-    lines.push("=".repeat(60));
-    return lines.join("\n");
-}

package/dist/profiling/index.d.ts

@@ -1,36 +0,0 @@
-/**
- * QVAC SDK Profiler
- *
- * @example
- * ```ts
- * import { profiler } from "@qvac/sdk";
- *
- * profiler.enable({ mode: "summary" });
- * // ... run SDK operations ...
- * console.log(profiler.exportTable());
- * profiler.disable();
- * ```
- */
-import * as controller from "./controller";
-import type { ProfilerRuntimeOptions, ProfilingEvent, ProfilerExport, AggregatedStats } from "./types";
-export declare const profiler: {
-    enable: (options?: ProfilerRuntimeOptions) => void;
-    disable: () => void;
-    isEnabled: () => boolean;
-    exportJSON: (options?: {
-        includeRecentEvents?: boolean;
-    }) => ProfilerExport;
-    exportTable: () => string;
-    exportSummary: () => string;
-    onRecord: (callback: (event: ProfilingEvent) => void) => () => void;
-    getConfig: () => controller.ResolvedProfilerConfig;
-    getAggregates: () => Record<string, AggregatedStats>;
-    clear: () => void;
-};
-export type { ProfilerRuntimeOptions, ProfilingEvent, ProfilerExport, AggregatedStats, ProfilingEventKind, } from "./types";
-export type { ProfilerMode } from "../schemas/index";
-export { nowMs } from "./clock";
-export { record, shouldProfile, shouldIncludeServerBreakdown, generateId, isEnabled, type ResolvedProfilerConfig, } from "./controller";
-export { createProfilingMeta, createProfilingDisabledMeta, injectProfilingMetaIntoObject, extractProfilingMeta, stripProfilingMeta, } from "./envelope";
-export { recordPhase, recordFailure, recordServerBreakdownPhases, recordDelegationBreakdownPhases, type BaseTimings, type BaseEvent, } from "./events";
-//# sourceMappingURL=index.d.ts.map

package/dist/profiling/index.js

@@ -1,31 +0,0 @@
-/**
- * QVAC SDK Profiler
- *
- * @example
- * ```ts
- * import { profiler } from "@qvac/sdk";
- *
- * profiler.enable({ mode: "summary" });
- * // ... run SDK operations ...
- * console.log(profiler.exportTable());
- * profiler.disable();
- * ```
- */
-import * as controller from "./controller.js";
-import * as exporters from "./exporters.js";
-export const profiler = {
-    enable: (options) => controller.enable(options),
-    disable: () => controller.disable(),
-    isEnabled: () => controller.isEnabled(),
-    exportJSON: (options) => exporters.exportJSON(options),
-    exportTable: () => exporters.exportTable(),
-    exportSummary: () => exporters.exportSummary(),
-    onRecord: (callback) => controller.onRecord(callback),
-    getConfig: () => controller.getEffectiveConfig(),
-    getAggregates: () => controller.getAggregates(),
-    clear: () => controller.clear(),
-};
-export { nowMs } from "./clock.js";
-export { record, shouldProfile, shouldIncludeServerBreakdown, generateId, isEnabled, } from "./controller.js";
-export { createProfilingMeta, createProfilingDisabledMeta, injectProfilingMetaIntoObject, extractProfilingMeta, stripProfilingMeta, } from "./envelope.js";
-export { recordPhase, recordFailure, recordServerBreakdownPhases, recordDelegationBreakdownPhases, } from "./events.js";

package/dist/profiling/ring-buffer.d.ts

@@ -1,19 +0,0 @@
-/**
- * O(1) bounded buffer for event storage.
- * Oldest events are overwritten when full.
- */
-export interface RingBufferState<T> {
-    buffer: (T | undefined)[];
-    capacity: number;
-    head: number;
-    size: number;
-    totalPushed: number;
-}
-export declare function createRingBuffer<T>(capacity: number): RingBufferState<T>;
-export declare function ringBufferPush<T>(state: RingBufferState<T>, item: T): T | undefined;
-export declare function ringBufferToArray<T>(state: RingBufferState<T>): T[];
-export declare function ringBufferGetRecent<T>(state: RingBufferState<T>, count: number): T[];
-export declare function ringBufferClear<T>(state: RingBufferState<T>): void;
-export declare function ringBufferDroppedCount<T>(state: RingBufferState<T>): number;
-export declare function ringBufferResize<T>(state: RingBufferState<T>, newCapacity: number): RingBufferState<T>;
-//# sourceMappingURL=ring-buffer.d.ts.map

package/dist/profiling/ring-buffer.js

@@ -1,83 +0,0 @@
-/**
- * O(1) bounded buffer for event storage.
- * Oldest events are overwritten when full.
- */
-import { ProfilerInvalidCapacityError } from "../utils/errors-client.js";
-export function createRingBuffer(capacity) {
-    if (capacity < 1) {
-        throw new ProfilerInvalidCapacityError(1);
-    }
-    return {
-        buffer: new Array(capacity),
-        capacity,
-        head: 0,
-        size: 0,
-        totalPushed: 0,
-    };
-}
-// Returns the overwritten item if buffer was full, undefined otherwise.
-export function ringBufferPush(state, item) {
-    const overwritten = state.size === state.capacity ? state.buffer[state.head] : undefined;
-    state.buffer[state.head] = item;
-    state.head = (state.head + 1) % state.capacity;
-    state.size = Math.min(state.size + 1, state.capacity);
-    state.totalPushed++;
-    return overwritten;
-}
-// Returns all items in chronological order (oldest first).
-export function ringBufferToArray(state) {
-    if (state.size === 0) {
-        return [];
-    }
-    const result = [];
-    const start = state.size === state.capacity
-        ? state.head // Full: head points to oldest
-        : 0;
-    for (let i = 0; i < state.size; i++) {
-        const index = (start + i) % state.capacity;
-        const item = state.buffer[index];
-        if (item !== undefined) {
-            result.push(item);
-        }
-    }
-    return result;
-}
-// Returns the most recent N items (newest first).
-export function ringBufferGetRecent(state, count) {
-    if (state.size === 0 || count <= 0) {
-        return [];
-    }
-    const actualCount = Math.min(count, state.size);
-    const result = [];
-    for (let i = 0; i < actualCount; i++) {
-        const index = (state.head - 1 - i + state.capacity) % state.capacity;
-        const item = state.buffer[index];
-        if (item !== undefined) {
-            result.push(item);
-        }
-    }
-    return result;
-}
-export function ringBufferClear(state) {
-    state.buffer = new Array(state.capacity);
-    state.head = 0;
-    state.size = 0;
-    state.totalPushed = 0;
-}
-export function ringBufferDroppedCount(state) {
-    return Math.max(0, state.totalPushed - state.capacity);
-}
-// Resizes the buffer, keeping the most recent items.
-export function ringBufferResize(state, newCapacity) {
-    if (newCapacity < 1) {
-        throw new ProfilerInvalidCapacityError(1);
-    }
-    const items = ringBufferToArray(state);
-    const itemsToKeep = items.slice(-newCapacity);
-    const newState = createRingBuffer(newCapacity);
-    for (const item of itemsToKeep) {
-        ringBufferPush(newState, item);
-    }
-    newState.totalPushed = state.totalPushed;
-    return newState;
-}