@buoy-gg/benchmark 2.1.3 → 2.1.4-beta.1

package/lib/commonjs/benchmarking/BenchmarkStorage.js

@@ -1 +1,235 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.BenchmarkStorage=void 0,exports.createAsyncStorageAdapter=createAsyncStorageAdapter,exports.createMemoryStorageAdapter=createMemoryStorageAdapter,exports.default=void 0;const STORAGE_PREFIX="@buoy-gg/benchmark",INDEX_KEY=`${STORAGE_PREFIX}/index`,REPORT_KEY_PREFIX=`${STORAGE_PREFIX}/report/`;function getReportKey(e){return`${REPORT_KEY_PREFIX}${e}`}function extractMetadata(e){return{id:e.id,name:e.name,description:e.description,createdAt:e.createdAt,duration:e.duration,batchCount:e.stats.batchCount}}class BenchmarkStorage{constructor(e){this.storage=e}async saveReport(e){const t=await this.loadIndex(),r=t.findIndex(t=>t.id===e.id);return r>=0?t[r]=extractMetadata(e):t.push(extractMetadata(e)),await Promise.all([this.storage.setItem(getReportKey(e.id),JSON.stringify(e)),this.storage.setItem(INDEX_KEY,JSON.stringify(t))]),extractMetadata(e)}async loadReport(e){try{const t=await this.storage.getItem(getReportKey(e));return t?JSON.parse(t):null}catch(t){return console.error(`[BenchmarkStorage] Error loading report ${e}:`,t),null}}async listReports(){return(await this.loadIndex()).sort((e,t)=>t.createdAt-e.createdAt)}async deleteReport(e){const t=await this.loadIndex(),r=t.findIndex(t=>t.id===e);return!(r<0||(t.splice(r,1),await Promise.all([this.storage.removeItem(getReportKey(e)),this.storage.setItem(INDEX_KEY,JSON.stringify(t))]),0))}async clearAll(){const e=await this.loadIndex();await Promise.all([...e.map(e=>this.storage.removeItem(getReportKey(e.id))),this.storage.removeItem(INDEX_KEY)])}async updateReport(e,t){const r=await this.loadReport(e);return!!r&&(void 0!==t.name&&(r.name=t.name),void 0!==t.description&&(r.description=t.description),await this.saveReport(r),!0)}async getMostRecent(){const e=await this.listReports();return 0===e.length?null:this.loadReport(e[0].id)}async getReportsByName(e){return(await this.loadIndex()).filter(t=>t.name===e).sort((e,t)=>t.createdAt-e.createdAt)}async loadIndex(){try{const e=await this.storage.getItem(INDEX_KEY);return e?JSON.parse(e):[]}catch(e){return console.error("[BenchmarkStorage] Error loading index:",e),[]}}}function createAsyncStorageAdapter(){try{const e=require("@react-native-async-storage/async-storage").default;return{getItem:t=>e.getItem(t),setItem:(t,r)=>e.setItem(t,r),removeItem:t=>e.removeItem(t)}}catch{return console.warn("[BenchmarkStorage] @react-native-async-storage/async-storage not available. Provide a custom storage adapter."),null}}function createMemoryStorageAdapter(){const e=new Map;return{getItem:async t=>e.get(t)??null,setItem:async(t,r)=>{e.set(t,r)},removeItem:async t=>{e.delete(t)}}}exports.BenchmarkStorage=BenchmarkStorage;var _default=exports.default=BenchmarkStorage;
+/**
+ * BenchmarkStorage
+ *
+ * Handles persistence of benchmark reports to AsyncStorage.
+ * Provides methods to save, load, list, and delete benchmark reports.
+ *
+ * Storage keys:
+ *   - @benchmark/index: Array of report metadata (id, name, createdAt)
+ *   - @benchmark/report/{id}: Full report data
+ *
+ * @packageDocumentation
+ */
+
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.BenchmarkStorage = void 0;
+exports.createAsyncStorageAdapter = createAsyncStorageAdapter;
+exports.createMemoryStorageAdapter = createMemoryStorageAdapter;
+exports.default = void 0;
+/**
+ * Storage adapter interface - allows for different storage backends
+ */
+
+/**
+ * Metadata for a stored benchmark (stored in index)
+ */
+
+// Storage key prefix
+const STORAGE_PREFIX = "@buoy-gg/benchmark";
+const INDEX_KEY = `${STORAGE_PREFIX}/index`;
+const REPORT_KEY_PREFIX = `${STORAGE_PREFIX}/report/`;
+
+/**
+ * Get the storage key for a report
+ */
+function getReportKey(id) {
+  return `${REPORT_KEY_PREFIX}${id}`;
+}
+
+/**
+ * Extract metadata from a full report
+ */
+function extractMetadata(report) {
+  return {
+    id: report.id,
+    name: report.name,
+    description: report.description,
+    createdAt: report.createdAt,
+    duration: report.duration,
+    batchCount: report.stats.batchCount
+  };
+}
+
+/**
+ * BenchmarkStorage - Manages persistence of benchmark reports
+ */
+class BenchmarkStorage {
+  /**
+   * Create a new BenchmarkStorage instance
+   * @param storage - Storage adapter (e.g., AsyncStorage)
+   */
+  constructor(storage) {
+    this.storage = storage;
+  }
+
+  /**
+   * Save a benchmark report
+   * @returns The saved report's metadata
+   */
+  async saveReport(report) {
+    // Load current index
+    const index = await this.loadIndex();
+
+    // Check if report already exists
+    const existingIndex = index.findIndex(m => m.id === report.id);
+    if (existingIndex >= 0) {
+      // Update existing entry
+      index[existingIndex] = extractMetadata(report);
+    } else {
+      // Add new entry
+      index.push(extractMetadata(report));
+    }
+
+    // Save report and update index
+    await Promise.all([this.storage.setItem(getReportKey(report.id), JSON.stringify(report)), this.storage.setItem(INDEX_KEY, JSON.stringify(index))]);
+    return extractMetadata(report);
+  }
+
+  /**
+   * Load a benchmark report by ID
+   * @returns The report, or null if not found
+   */
+  async loadReport(id) {
+    try {
+      const data = await this.storage.getItem(getReportKey(id));
+      if (!data) return null;
+      const report = JSON.parse(data);
+      return report;
+    } catch (error) {
+      console.error(`[BenchmarkStorage] Error loading report ${id}:`, error);
+      return null;
+    }
+  }
+
+  /**
+   * Load all benchmark metadata (for listing)
+   */
+  async listReports() {
+    const index = await this.loadIndex();
+    // Sort by createdAt descending (newest first)
+    return index.sort((a, b) => b.createdAt - a.createdAt);
+  }
+
+  /**
+   * Delete a benchmark report
+   * @returns true if deleted, false if not found
+   */
+  async deleteReport(id) {
+    // Load current index
+    const index = await this.loadIndex();
+
+    // Find and remove from index
+    const existingIndex = index.findIndex(m => m.id === id);
+    if (existingIndex < 0) {
+      return false;
+    }
+    index.splice(existingIndex, 1);
+
+    // Remove report and update index
+    await Promise.all([this.storage.removeItem(getReportKey(id)), this.storage.setItem(INDEX_KEY, JSON.stringify(index))]);
+    return true;
+  }
+
+  /**
+   * Delete all benchmark reports
+   */
+  async clearAll() {
+    const index = await this.loadIndex();
+
+    // Delete all reports
+    await Promise.all([...index.map(m => this.storage.removeItem(getReportKey(m.id))), this.storage.removeItem(INDEX_KEY)]);
+  }
+
+  /**
+   * Update a benchmark report's name and/or description
+   * @returns true if updated, false if not found
+   */
+  async updateReport(id, updates) {
+    // Load the report
+    const report = await this.loadReport(id);
+    if (!report) return false;
+
+    // Apply updates
+    if (updates.name !== undefined) {
+      report.name = updates.name;
+    }
+    if (updates.description !== undefined) {
+      report.description = updates.description;
+    }
+
+    // Save updated report (this also updates the index)
+    await this.saveReport(report);
+    return true;
+  }
+
+  /**
+   * Get the most recent report
+   */
+  async getMostRecent() {
+    const reports = await this.listReports();
+    if (reports.length === 0) return null;
+    return this.loadReport(reports[0].id);
+  }
+
+  /**
+   * Get reports by name (for comparing multiple runs of same benchmark)
+   */
+  async getReportsByName(name) {
+    const index = await this.loadIndex();
+    return index.filter(m => m.name === name).sort((a, b) => b.createdAt - a.createdAt);
+  }
+
+  /**
+   * Load the index of all benchmarks
+   */
+  async loadIndex() {
+    try {
+      const data = await this.storage.getItem(INDEX_KEY);
+      if (!data) return [];
+      return JSON.parse(data);
+    } catch (error) {
+      console.error("[BenchmarkStorage] Error loading index:", error);
+      return [];
+    }
+  }
+}
+
+/**
+ * Create a storage instance using AsyncStorage
+ */
+exports.BenchmarkStorage = BenchmarkStorage;
+function createAsyncStorageAdapter() {
+  try {
+    // Dynamic import to avoid hard dependency on AsyncStorage
+    const AsyncStorage = require("@react-native-async-storage/async-storage").default;
+    return {
+      getItem: key => AsyncStorage.getItem(key),
+      setItem: (key, value) => AsyncStorage.setItem(key, value),
+      removeItem: key => AsyncStorage.removeItem(key)
+    };
+  } catch {
+    console.warn("[BenchmarkStorage] @react-native-async-storage/async-storage not available. " + "Provide a custom storage adapter.");
+    return null;
+  }
+}
+
+/**
+ * In-memory storage adapter (for testing or when AsyncStorage is not available)
+ */
+function createMemoryStorageAdapter() {
+  const store = new Map();
+  return {
+    getItem: async key => store.get(key) ?? null,
+    setItem: async (key, value) => {
+      store.set(key, value);
+    },
+    removeItem: async key => {
+      store.delete(key);
+    }
+  };
+}
+var _default = exports.default = BenchmarkStorage;

package/lib/commonjs/benchmarking/index.js

@@ -1 +1,83 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"BenchmarkComparator",{enumerable:!0,get:function(){return _BenchmarkComparator.BenchmarkComparator}}),Object.defineProperty(exports,"BenchmarkRecorder",{enumerable:!0,get:function(){return _BenchmarkRecorder.BenchmarkRecorder}}),Object.defineProperty(exports,"BenchmarkStorage",{enumerable:!0,get:function(){return _BenchmarkStorage.BenchmarkStorage}}),Object.defineProperty(exports,"benchmarkRecorder",{enumerable:!0,get:function(){return _BenchmarkRecorder.benchmarkRecorder}}),Object.defineProperty(exports,"createAsyncStorageAdapter",{enumerable:!0,get:function(){return _BenchmarkStorage.createAsyncStorageAdapter}}),Object.defineProperty(exports,"createMemoryStorageAdapter",{enumerable:!0,get:function(){return _BenchmarkStorage.createMemoryStorageAdapter}});var _BenchmarkRecorder=require("./BenchmarkRecorder"),_BenchmarkStorage=require("./BenchmarkStorage"),_BenchmarkComparator=require("./BenchmarkComparator");
+/**
+ * @buoy-gg/benchmark/benchmarking
+ *
+ * Performance benchmarking system for measuring and comparing
+ * highlight updates performance. Uses the W3C Performance API
+ * for accurate timing measurements.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   benchmarkRecorder,
+ *   BenchmarkStorage,
+ *   BenchmarkComparator,
+ *   createAsyncStorageAdapter,
+ * } from '@buoy-gg/benchmark';
+ *
+ * // Start recording
+ * benchmarkRecorder.startSession({ name: 'MyBenchmark' });
+ *
+ * // ... perform operations ...
+ *
+ * // Stop and get report
+ * const report = benchmarkRecorder.stopSession();
+ *
+ * // Save report
+ * const storage = new BenchmarkStorage(createAsyncStorageAdapter()!);
+ * await storage.saveReport(report);
+ *
+ * // Compare with previous
+ * const previous = await storage.getMostRecent();
+ * if (previous) {
+ *   BenchmarkComparator.quickCompare(previous, report);
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+"use strict";
+
+// Types
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "BenchmarkComparator", {
+  enumerable: true,
+  get: function () {
+    return _BenchmarkComparator.BenchmarkComparator;
+  }
+});
+Object.defineProperty(exports, "BenchmarkRecorder", {
+  enumerable: true,
+  get: function () {
+    return _BenchmarkRecorder.BenchmarkRecorder;
+  }
+});
+Object.defineProperty(exports, "BenchmarkStorage", {
+  enumerable: true,
+  get: function () {
+    return _BenchmarkStorage.BenchmarkStorage;
+  }
+});
+Object.defineProperty(exports, "benchmarkRecorder", {
+  enumerable: true,
+  get: function () {
+    return _BenchmarkRecorder.benchmarkRecorder;
+  }
+});
+Object.defineProperty(exports, "createAsyncStorageAdapter", {
+  enumerable: true,
+  get: function () {
+    return _BenchmarkStorage.createAsyncStorageAdapter;
+  }
+});
+Object.defineProperty(exports, "createMemoryStorageAdapter", {
+  enumerable: true,
+  get: function () {
+    return _BenchmarkStorage.createMemoryStorageAdapter;
+  }
+});
+var _BenchmarkRecorder = require("./BenchmarkRecorder");
+var _BenchmarkStorage = require("./BenchmarkStorage");
+var _BenchmarkComparator = require("./BenchmarkComparator");

package/lib/commonjs/benchmarking/types.js

@@ -1 +1,13 @@
-"use strict";
+/**
+ * Benchmarking Types
+ *
+ * Core type definitions for the performance benchmarking system.
+ *
+ * @packageDocumentation
+ */
+
+"use strict";
+
+/**
+ * High-resolution timestamp in milliseconds
+ */