@keepsnappy/react-native 0.1.0-alpha.11 → 0.1.0-alpha.13

package/ios/{PerfLab.podspec → KeepSnappy.podspec}

@@ -3,7 +3,7 @@ require 'json'
 package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
 
 Pod::Spec.new do |s|
-  s.name           = 'PerfLab'
+  s.name           = 'KeepSnappy'
   s.version        = package['version']
   s.summary        = package['description']
   s.description    = package['description']
@@ -19,7 +19,7 @@ Pod::Spec.new do |s|
   s.dependency 'hermes-engine'
 
   s.source_files = "*.{swift,h,mm}"
-  s.public_header_files = "PerfLabHermes.h"
+  s.public_header_files = "KeepSnappyHermes.h"
 
   s.pod_target_xcconfig = {
     'DEFINES_MODULE' => 'YES',

package/ios/{PerfLabHermes.h → KeepSnappyHermes.h}

@@ -4,7 +4,7 @@ NS_ASSUME_NONNULL_BEGIN
 
 // Hermes sampling profiler (C++ API) for Swift. The runtime pointer is the
 // jsi::Runtime behind Expo's JavaScriptRuntime.withUnsafePointee.
-@interface PerfLabHermes : NSObject
+@interface KeepSnappyHermes : NSObject
 
 + (BOOL)startWithHz:(double)hz;
 + (BOOL)stop;

package/ios/{PerfLabHermes.mm → KeepSnappyHermes.mm}

@@ -1,4 +1,4 @@
-#import "PerfLabHermes.h"
+#import "KeepSnappyHermes.h"
 
 #include <fstream>
 #include <sstream>
@@ -13,7 +13,7 @@ static fh::IHermesRootAPI *rootAPI() {
   return jsi::castInterface<fh::IHermesRootAPI>(fh::makeHermesRootAPI());
 }
 
-@implementation PerfLabHermes
+@implementation KeepSnappyHermes
 
 + (BOOL)startWithHz:(double)hz {
   auto *api = rootAPI();

package/ios/{PerfLabModule.swift → KeepSnappyModule.swift}

@@ -4,38 +4,38 @@ import Foundation
 import UIKit
 import os
 
-private let pointsOfInterest = OSLog(subsystem: "com.gigaverse.perflab", category: .pointsOfInterest)
-private let logger = OSLog(subsystem: "com.gigaverse.perflab", category: "log")
+private let pointsOfInterest = OSLog(subsystem: "com.gigaverse.keepsnappy", category: .pointsOfInterest)
+private let logger = OSLog(subsystem: "com.gigaverse.keepsnappy", category: "log")
 
 // os_log truncates long messages, so long payloads go out in chunks.
 private let logChunk = 800
 
 // Created by Expo at app start whether or not the SDK measures: nothing here may
 // do work before a function is called (a dormant build calls activationRead only).
-public class PerfLabModule: Module {
-  private lazy var logQueue = DispatchQueue(label: "com.gigaverse.perflab.log")
+public class KeepSnappyModule: Module {
+  private lazy var logQueue = DispatchQueue(label: "com.gigaverse.keepsnappy.log")
   private var logHandle: FileHandle?
   private var spoolHandle: FileHandle?
   private var samplerCreated = false
-  private lazy var sampler: PerfLabSampler = {
+  private lazy var sampler: KeepSnappySampler = {
     self.samplerCreated = true
-    return PerfLabSampler { [weak self] line in self?.writeLog(line) }
+    return KeepSnappySampler { [weak self] line in self?.writeLog(line) }
   }()
 
   public func definition() -> ModuleDefinition {
-    Name("PerfLab")
+    Name("KeepSnappy")
 
     // Signpost names must be static, so the window name travels in the message.
     Function("beginAsyncSection") { (name: String, cookie: Int) in
-      os_signpost(.begin, log: pointsOfInterest, name: "perf-lab", signpostID: OSSignpostID(UInt64(cookie)), "%{public}s", name)
+      os_signpost(.begin, log: pointsOfInterest, name: "keepsnappy", signpostID: OSSignpostID(UInt64(cookie)), "%{public}s", name)
     }
 
     Function("endAsyncSection") { (name: String, cookie: Int) in
-      os_signpost(.end, log: pointsOfInterest, name: "perf-lab", signpostID: OSSignpostID(UInt64(cookie)), "%{public}s", name)
+      os_signpost(.end, log: pointsOfInterest, name: "keepsnappy", signpostID: OSSignpostID(UInt64(cookie)), "%{public}s", name)
     }
 
     Function("setCounter") { (name: String, value: Double) in
-      os_signpost(.event, log: pointsOfInterest, name: "perf-lab-counter", "%{public}s=%f", name, value)
+      os_signpost(.event, log: pointsOfInterest, name: "keepsnappy-counter", "%{public}s=%f", name, value)
     }
 
     Function("isTracing") { () -> Bool in
@@ -67,7 +67,7 @@ public class PerfLabModule: Module {
     }
 
     Function("samplerNow") { () -> Double in
-      perfLabMonotonicMs()
+      keepSnappyMonotonicMs()
     }
 
     OnDestroy {
@@ -98,7 +98,7 @@ public class PerfLabModule: Module {
       Self.emit(message)
     }
 
-    // Push journal (perf-lab/push-spool.jsonl): append is queued, read and replace wait for
+    // Push journal (keepsnappy/push-spool.jsonl): append is queued, read and replace wait for
     // the queue so they see every earlier append.
     Function("spoolAppend") { (record: String) in
       self.logQueue.async {
@@ -117,18 +117,18 @@ public class PerfLabModule: Module {
     }
 
     // Result of a `flush=1` link for the test driver: a transparent 1x1 pt element at the
-    // top-left of the key window, accessibility id `perflab.flushed`, label ok / error / off.
+    // top-left of the key window, accessibility id `keepsnappy.flushed`, label ok / error / off.
     // Only ever created on request in a measuring process; replaced by the next flush.
     Function("flushSignal") { (status: String, detail: String) in
       Task { @MainActor in
-        Self.showSignal(tag: Self.flushSignalTag, id: "perflab.flushed", label: status, value: detail)
+        Self.showSignal(tag: Self.flushSignalTag, id: "keepsnappy.flushed", label: status, value: detail)
       }
     }
 
-    // The answer to a driver command (GC before the action): the same kind of element, id `perflab.ack`, label `gc:<n> ok`.
+    // The answer to a driver command (GC before the action): the same kind of element, id `keepsnappy.ack`, label `gc:<n> ok`.
     Function("ackSignal") { (text: String) in
       Task { @MainActor in
-        Self.showSignal(tag: Self.ackSignalTag, id: "perflab.ack", label: text, value: text)
+        Self.showSignal(tag: Self.ackSignalTag, id: "keepsnappy.ack", label: text, value: text)
       }
     }
 
@@ -175,7 +175,7 @@ public class PerfLabModule: Module {
       ]
     }
 
-    // Documents/perf-lab is pulled with `xcrun devicectl device copy from --domain-type appDataContainer`.
+    // Documents/keepsnappy is pulled with `xcrun devicectl device copy from --domain-type appDataContainer`.
     Function("writeText") { (fileName: String, content: String) -> String? in
       guard let dir = Self.outputDir() else { return nil }
       let file = dir.appendingPathComponent(fileName.replacingOccurrences(of: "/", with: "_"))
@@ -187,14 +187,14 @@ public class PerfLabModule: Module {
       }
     }
 
-    // Hermes sampling profiler (PerfLabHermes.mm). Sync functions run on the JS
+    // Hermes sampling profiler (KeepSnappyHermes.mm). Sync functions run on the JS
     // thread, which the per-runtime dump needs.
     Function("cpuProfileStart") { (hz: Double) -> Bool in
-      PerfLabHermes.start(withHz: hz)
+      KeepSnappyHermes.start(withHz: hz)
     }
 
     Function("cpuProfileStop") { () -> Bool in
-      PerfLabHermes.stop()
+      KeepSnappyHermes.stop()
     }
 
     // A raw profile file of a run (plan 40 §3.6): gzip, sha256 of the gzip, PUT to the
@@ -245,10 +245,10 @@ public class PerfLabModule: Module {
       guard let dir = Self.outputDir() else { return nil }
       let path = dir.appendingPathComponent(fileName.replacingOccurrences(of: "/", with: "_")).path
       guard let runtime = try? self.appContext?.runtime else {
-        return PerfLabHermes.dumpRuntime(nil, toPath: path)
+        return KeepSnappyHermes.dumpRuntime(nil, toPath: path)
       }
       return runtime.withUnsafePointee { pointer in
-        PerfLabHermes.dumpRuntime(pointer, toPath: path)
+        KeepSnappyHermes.dumpRuntime(pointer, toPath: path)
       }
     }
   }
@@ -258,7 +258,7 @@ public class PerfLabModule: Module {
 
   private static func outputDir() -> URL? {
     guard let docs = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first else { return nil }
-    let dir = docs.appendingPathComponent("perf-lab", isDirectory: true)
+    let dir = docs.appendingPathComponent("keepsnappy", isDirectory: true)
     try? FileManager.default.createDirectory(at: dir, withIntermediateDirectories: true)
     return dir
   }
@@ -334,7 +334,7 @@ public class PerfLabModule: Module {
 
   private static func fileIfPresent(_ name: String) -> URL? {
     guard let docs = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first else { return nil }
-    let file = docs.appendingPathComponent("perf-lab", isDirectory: true).appendingPathComponent(name)
+    let file = docs.appendingPathComponent("keepsnappy", isDirectory: true).appendingPathComponent(name)
     return FileManager.default.fileExists(atPath: file.path) ? file : nil
   }
 

package/ios/{PerfLabSampler.swift → KeepSnappySampler.swift}

@@ -19,7 +19,7 @@ private let timebase: mach_timebase_info_data_t = {
 }()
 
 // performance.now() in Hermes on iOS is steady_clock = mach_absolute_time.
-func perfLabMonotonicMs() -> Double {
+func keepSnappyMonotonicMs() -> Double {
   Double(mach_absolute_time()) * Double(timebase.numer) / Double(timebase.denom) / 1_000_000
 }
 
@@ -82,7 +82,7 @@ private func memoryMb() -> (footprint: Double, resident: Double)? {
 // on ProMotion screens the link runs at 60 Hz while duration reports the 120 Hz budget.
 // The link asks for no frame rate, so it never raises the screen's refresh rate; a single
 // 120 Hz drop between two 60 Hz callbacks is invisible.
-final class PerfLabFrameCounter: NSObject {
+final class KeepSnappyFrameCounter: NSObject {
   private var link: CADisplayLink?
   private var lastTimestamp: CFTimeInterval = 0
   private var lastBudget: CFTimeInterval = 0
@@ -176,11 +176,11 @@ final class PerfLabFrameCounter: NSObject {
 
 // Off unless configured. `auto` samples on a utility queue every intervalMs and needs no JS;
 // `manual` only keeps the frame counter running and samples when asked. Every sample is logged
-// as `PERF_LAB sample {json}` through the module's native log and kept in a short ring for windows.
-final class PerfLabSampler {
-  private let queue = DispatchQueue(label: "com.gigaverse.perflab.sampler", qos: .utility)
+// as `KEEPSNAPPY sample {json}` through the module's native log and kept in a short ring for windows.
+final class KeepSnappySampler {
+  private let queue = DispatchQueue(label: "com.gigaverse.keepsnappy.sampler", qos: .utility)
   private let log: (String) -> Void
-  private let frames = PerfLabFrameCounter()
+  private let frames = KeepSnappyFrameCounter()
 
   private var timer: DispatchSourceTimer?
   private var mode = "off"
@@ -231,7 +231,7 @@ final class PerfLabSampler {
           timer = source
         }
       }
-      return ["mode": mode, "intervalMs": intervalMs, "nowMs": perfLabMonotonicMs()]
+      return ["mode": mode, "intervalMs": intervalMs, "nowMs": keepSnappyMonotonicMs()]
     }
   }
 
@@ -300,7 +300,7 @@ final class PerfLabSampler {
   }
 
   private func collect(reason: String) -> [String: Any] {
-    let started = perfLabMonotonicMs()
+    let started = keepSnappyMonotonicMs()
     let t = started
     let processMs = processCpuMs()
     let main = frames.mainThread
@@ -349,7 +349,7 @@ final class PerfLabSampler {
     previous = (t, processMs, mainMs, jsMs, frame.presentedTotal, frame.missedTotal)
     record["cpu"] = cpu
     record["frames"] = framesOut
-    record["collectMs"] = perfLabMonotonicMs() - started
+    record["collectMs"] = keepSnappyMonotonicMs() - started
 
     ring.append(record)
     if ring.count > ringSize {
@@ -357,7 +357,7 @@ final class PerfLabSampler {
     }
     if let data = try? JSONSerialization.data(withJSONObject: record),
        let json = String(data: data, encoding: .utf8) {
-      log("PERF_LAB sample \(json)")
+      log("KEEPSNAPPY sample \(json)")
     }
     return record
   }

package/js/babel-transformer.js

@@ -1,5 +1,5 @@
-// Wraps the app's Babel transformer (set by withPerfLab) and adds one import to
-// the entry module: the perf-lab boot module. That import is what puts the SDK
+// Wraps the app's Babel transformer (set by withKeepSnappy) and adds one import to
+// the entry module: the keepsnappy boot module. That import is what puts the SDK
 // in the graph; getModulesRunBeforeMainModule then runs it before the entry.
 //
 // babel-preset-expo inlines EXPO_PUBLIC_* only outside node_modules, and the
@@ -8,9 +8,9 @@
 
 const path = require('path');
 
-const upstreamPath = (process.env.KEEPSNAPPY_UPSTREAM_BABEL_TRANSFORMER ?? process.env.PERFLAB_UPSTREAM_BABEL_TRANSFORMER);
-const entryFile = (process.env.KEEPSNAPPY_ENTRY_FILE ?? process.env.PERFLAB_ENTRY_FILE);
-const bootFile = (process.env.KEEPSNAPPY_BOOT_FILE ?? process.env.PERFLAB_BOOT_FILE);
+const upstreamPath = (process.env.KEEPSNAPPY_UPSTREAM_BABEL_TRANSFORMER);
+const entryFile = (process.env.KEEPSNAPPY_ENTRY_FILE);
+const bootFile = (process.env.KEEPSNAPPY_BOOT_FILE);
 
 if (!upstreamPath || !entryFile || !bootFile) {
   throw new Error(
@@ -30,7 +30,7 @@ const inlineEnv = src =>
 
 const envSignature = () =>
   Object.keys(process.env)
-    .filter(name => (name.startsWith('EXPO_PUBLIC_PERF') || name.startsWith('EXPO_PUBLIC_KEEPSNAPPY')))
+    .filter(name => name.startsWith('EXPO_PUBLIC_KEEPSNAPPY'))
     .sort()
     .map(name => `${name}=${process.env[name]}`)
     .join('&');
@@ -66,6 +66,6 @@ module.exports = {
       typeof upstream.getCacheKey === 'function'
         ? upstream.getCacheKey(...args)
         : '';
-    return `${base}$perflab:${entryFile}:${bootFile}:${envSignature()}`;
+    return `${base}$keepsnappy:${entryFile}:${bootFile}:${envSignature()}`;
   },
 };

package/js/hook.polyfill.js

@@ -1,20 +1,20 @@
-// perf-lab React DevTools hook, installed as a Metro polyfill: it runs before
+// keepsnappy React DevTools hook, installed as a Metro polyfill: it runs before
 // any module, so it exists before the React renderer evaluates and injects.
 // A polyfill is a plain script (no require), so this file stays self-contained:
 // it only counts and buffers. The SDK boot module attaches a listener later.
 //
-// Dormant builds (EXPO_PUBLIC_PERF_LAB_MODE=dormant) first read the activation
+// Dormant builds (EXPO_PUBLIC_KEEPSNAPPY_MODE=dormant) first read the activation
 // record through the native module, synchronously (Expo installs
 // `expo.modules` before the bundle runs; on Android the polyfill installs them itself). Not activated: nothing is installed
 // and the React DevTools global stays exactly as without the SDK. If the native
 // module cannot be reached yet, the hook is prepared but not installed and the
 // boot module decides (it still runs before the renderer loads).
 //
-// `profile` on __PERFLAB_ACTIVATION__ picks the React renderer in a
-// PERF_LAB_REACT_PROFILING=switch bundle (js/renderer-switch.js): the
-// activation's `profile` in a dormant build, EXPO_PUBLIC_PERF_LAB_PROFILE otherwise.
+// `profile` on __KEEPSNAPPY_ACTIVATION__ picks the React renderer in a
+// KEEPSNAPPY_REACT_PROFILING=switch bundle (js/renderer-switch.js): the
+// activation's `profile` in a dormant build, EXPO_PUBLIC_KEEPSNAPPY_PROFILE otherwise.
 (function (g) {
-  if (g.__PERFLAB_HOOK__ || g.__PERFLAB_ACTIVATION__) {
+  if (g.__KEEPSNAPPY_HOOK__ || g.__KEEPSNAPPY_ACTIVATION__) {
     return;
   }
   var HOOK = '__REACT_DEVTOOLS_GLOBAL_HOOK__';
@@ -29,13 +29,13 @@
     }
   };
   var modeEnv = env(function () {
-    return (process.env.EXPO_PUBLIC_KEEPSNAPPY_MODE ?? process.env.EXPO_PUBLIC_PERF_LAB_MODE);
+    return (process.env.EXPO_PUBLIC_KEEPSNAPPY_MODE);
   });
   var autoEnv = env(function () {
-    return (process.env.EXPO_PUBLIC_KEEPSNAPPY_AUTO ?? process.env.EXPO_PUBLIC_PERF_LAB_AUTO);
+    return (process.env.EXPO_PUBLIC_KEEPSNAPPY_AUTO);
   });
   var profileEnv = env(function () {
-    return (process.env.EXPO_PUBLIC_KEEPSNAPPY_PROFILE ?? process.env.EXPO_PUBLIC_PERF_LAB_PROFILE);
+    return (process.env.EXPO_PUBLIC_KEEPSNAPPY_PROFILE);
   });
   var MODE =
     modeEnv === 'dormant' || modeEnv === 'auto'
@@ -85,7 +85,7 @@
         }
       }
       var modules = g.expo && g.expo.modules;
-      var native = modules ? modules.PerfLab : undefined;
+      var native = modules ? modules.KeepSnappy : undefined;
       if (native && typeof native.activationRead === 'function') {
         activation.raw = native.activationRead();
         activation.read = 'polyfill';
@@ -99,7 +99,7 @@
       activation.read = 'deferred';
     }
   }
-  g.__PERFLAB_ACTIVATION__ = activation;
+  g.__KEEPSNAPPY_ACTIVATION__ = activation;
   if (MODE === 'dormant' && activation.read === 'polyfill' && !activation.active) {
     return;
   }
@@ -135,7 +135,7 @@
   var log = function (message) {
     try {
       if (g.console && typeof g.console.log === 'function') {
-        g.console.log('PERF_LAB ' + message);
+        g.console.log('KEEPSNAPPY ' + message);
       }
     } catch (_e) {
       return;
@@ -220,7 +220,7 @@
     supportsFiber: true,
     isDisabled: false,
     renderers: new Map(),
-    __perflab: true,
+    __keepsnappy: true,
     inject: function (internals) {
       var id = nextId++;
       ownHook.renderers.set(id, internals);
@@ -241,7 +241,7 @@
   // Wrap a hook someone else installed (React DevTools, bippy, ...): theirs runs
   // first, ours after, and the renderer id stays theirs.
   var chain = function (hook) {
-    if (!hook || hook.__perflab || hook.__perflabChained) {
+    if (!hook || hook.__keepsnappy || hook.__keepsnappyChained) {
       return;
     }
     var origInject = hook.inject;
@@ -267,7 +267,7 @@
         recordInject(id, internals);
       });
     }
-    hook.__perflabChained = true;
+    hook.__keepsnappyChained = true;
     state.chainedTargets++;
     state.mode = 'chained';
   };
@@ -301,7 +301,7 @@
     var existing = g[HOOK];
     if (existing === undefined || existing === null) {
       installOwn();
-    } else if (!existing.__perflab) {
+    } else if (!existing.__keepsnappy) {
       chain(existing);
     }
     return state.mode;
@@ -314,7 +314,7 @@
     ensure();
   }
 
-  g.__PERFLAB_HOOK__ = {
+  g.__KEEPSNAPPY_HOOK__ = {
     state: state,
     ensure: ensure,
     attach: function (listener) {

package/js/renderer-switch.js

@@ -1,11 +1,11 @@
-// React Native's production renderer in a PERF_LAB_REACT_PROFILING=switch bundle.
+// React Native's production renderer in a KEEPSNAPPY_REACT_PROFILING=switch bundle.
 // Both renderers are in the bundle; this module picks one when React Native
 // first requires it, from what hook.polyfill.js (or the boot module) read out
-// of the activation record before React loaded. withPerfLab (metro.js)
+// of the activation record before React loaded. withKeepSnappy (metro.js)
 // resolves the two module names below to RN's own implementation files.
 'use strict';
 
-var activation = globalThis.__PERFLAB_ACTIVATION__;
+var activation = globalThis.__KEEPSNAPPY_ACTIVATION__;
 var profiling = !!activation && activation.profile === true;
 if (activation) {
   activation.renderer = profiling ? 'profiling' : 'prod';

package/js/sdk/activation.ts

@@ -2,35 +2,35 @@
 // not, so it stays small and imports nothing: no React Native, no core.
 //
 // Modes (bundle time):
-//   auto    - measuring from the first frame (EXPO_PUBLIC_PERF_LAB_MODE=auto or PERF_LAB_AUTO=1)
+//   auto    - measuring from the first frame (EXPO_PUBLIC_KEEPSNAPPY_MODE=auto or KEEPSNAPPY_AUTO=1)
 //   manual  - markers only until a settings link turns collection on (no mode set)
 //   dormant - nothing installed until an activation link; it applies from the NEXT launch
 //
-// The activation record lives in the app sandbox (`perf-lab/activation.json`,
+// The activation record lives in the app sandbox (`keepsnappy/activation.json`,
 // written by the native module). hook.polyfill.js reads it once, synchronously,
-// before React loads, and leaves the raw value in __PERFLAB_ACTIVATION__.
-// Its `profile` field picks the React renderer in a PERF_LAB_REACT_PROFILING=switch
+// before React loads, and leaves the raw value in __KEEPSNAPPY_ACTIVATION__.
+// Its `profile` field picks the React renderer in a KEEPSNAPPY_REACT_PROFILING=switch
 // bundle (js/renderer-switch.js), so a process is wholly one renderer.
 
-export const PERF_LAB_ENABLED = (process.env.EXPO_PUBLIC_KEEPSNAPPY ?? process.env.EXPO_PUBLIC_PERF_LAB) === '1';
+export const KEEPSNAPPY_ENABLED = (process.env.EXPO_PUBLIC_KEEPSNAPPY) === '1';
 
-export const PERF_LAB_DEEP_LINK_PATH = 'devtools/perf-lab';
+export const KEEPSNAPPY_DEEP_LINK_PATH = 'devtools/keepsnappy';
 
-export type PerfLabMode = 'auto' | 'manual' | 'dormant';
+export type KeepSnappyMode = 'auto' | 'manual' | 'dormant';
 
 export const resolveMode = (
   mode: string | undefined,
   auto: string | undefined,
-): PerfLabMode => {
+): KeepSnappyMode => {
   if (mode === 'dormant' || mode === 'auto') {
     return mode;
   }
   return auto === '1' ? 'auto' : 'manual';
 };
 
-export const MODE: PerfLabMode = resolveMode(
-  (process.env.EXPO_PUBLIC_KEEPSNAPPY_MODE ?? process.env.EXPO_PUBLIC_PERF_LAB_MODE),
-  (process.env.EXPO_PUBLIC_KEEPSNAPPY_AUTO ?? process.env.EXPO_PUBLIC_PERF_LAB_AUTO),
+export const MODE: KeepSnappyMode = resolveMode(
+  (process.env.EXPO_PUBLIC_KEEPSNAPPY_MODE),
+  (process.env.EXPO_PUBLIC_KEEPSNAPPY_AUTO),
 );
 
 export const DEFAULT_TTL_S = 7200;
@@ -53,7 +53,7 @@ export interface ActivationRecord {
 export type ActivationRead = 'polyfill' | 'boot' | 'unavailable' | 'none';
 
 export interface Decision {
-  mode: PerfLabMode;
+  mode: KeepSnappyMode;
   active: boolean;
   runToken: string | null;
   expiresAt: number | null;
@@ -135,7 +135,7 @@ const OFF: ActivationRecord = {
 
 // Must agree with activeRecord() in hook.polyfill.js (tested on the same fixtures).
 export const decide = (
-  mode: PerfLabMode,
+  mode: KeepSnappyMode,
   record: ActivationRecord | null,
   nowMs: number,
   read: ActivationRead,
@@ -252,8 +252,8 @@ export const parseQuery = (
 export const queryOf = (url: string) => parseQuery(url.split('?')[1]);
 
 interface ActivationGlobal {
-  __PERFLAB_ACTIVATION__?: PolyfillActivation;
-  __PERFLAB_HOOK__?: { ensure: () => string };
+  __KEEPSNAPPY_ACTIVATION__?: PolyfillActivation;
+  __KEEPSNAPPY_HOOK__?: { ensure: () => string };
   expo?: { modules?: Record<string, unknown> };
 }
 
@@ -266,7 +266,7 @@ const isNative = (value: unknown): value is ActivationNative =>
 
 // Found lazily: only links and a deferred startup read need it.
 export const findActivationNative = (): ActivationNative | null => {
-  const direct = g.expo?.modules?.PerfLab;
+  const direct = g.expo?.modules?.KeepSnappy;
   if (isNative(direct)) {
     return direct;
   }
@@ -278,7 +278,7 @@ export const findActivationNative = (): ActivationNative | null => {
     const core = require('expo-modules-core') as {
       requireOptionalNativeModule?: (name: string) => unknown;
     };
-    const found = core.requireOptionalNativeModule?.('PerfLab');
+    const found = core.requireOptionalNativeModule?.('KeepSnappy');
     return isNative(found) ? found : null;
   } catch {
     return null;
@@ -290,7 +290,7 @@ export const resolveDecision = (
   nowMs: number = Date.now(),
   findNative: () => ActivationNative | null = findActivationNative,
 ): Decision => {
-  const fromPolyfill = g.__PERFLAB_ACTIVATION__;
+  const fromPolyfill = g.__KEEPSNAPPY_ACTIVATION__;
   if (MODE !== 'dormant') {
     // Not gated: the record only carries a persisted token, read when it is cheap.
     if (fromPolyfill && fromPolyfill.read === 'polyfill') {
@@ -324,7 +324,7 @@ export const resolveDecision = (
     decision = decide(MODE, null, nowMs, 'unavailable');
   }
   if (decision.active) {
-    g.__PERFLAB_HOOK__?.ensure();
+    g.__KEEPSNAPPY_HOOK__?.ensure();
   }
   // The polyfill could not choose the renderer; boot still runs before it loads.
   if (fromPolyfill && fromPolyfill.read === 'deferred') {

package/js/sdk/active.ts

@@ -7,7 +7,7 @@ import {
   applySettings,
   attachHook,
   exposeGlobal,
-  handlePerfLabDeepLink,
+  handleKeepSnappyDeepLink,
   logStartup,
   perfLog,
   setActivation,
@@ -25,7 +25,7 @@ const guarded = (label: string, run: () => void) => {
     run();
   } catch (error) {
     globalThis.console.log(
-      `PERF_LAB boot step failed ${label} ${String(error)}`,
+      `KEEPSNAPPY boot step failed ${label} ${String(error)}`,
     );
   }
 };
@@ -41,7 +41,7 @@ export const startActive = (decision: Decision) => {
     installLinks(
       (url, via) => {
         perfLog(`link via=${via} ${redactUrl(url)}`);
-        handlePerfLabDeepLink(url);
+        handleKeepSnappyDeepLink(url);
       },
       noteAppLink,
     ),

package/js/sdk/artifacts.ts

@@ -54,7 +54,7 @@ export const ARTIFACT_REQUEST_TIMEOUT_MS = 15_000;
 export const ARTIFACT_PUT_TIMEOUT_MS = 60_000;
 // One deadline per flush, started at the flush link (core.ts flushOnce) and shared by the lines push, the clock
 // report and the artifact upload (this file's ARTIFACT_UPLOAD_DEADLINE_MS is that deadline). The end report gets its
-// own request timeout after it, so `perflab.flushed` is raised at most ARTIFACT_FLUSH_WORST_CASE_MS after the link.
+// own request timeout after it, so `keepsnappy.flushed` is raised at most ARTIFACT_FLUSH_WORST_CASE_MS after the link.
 // The e2e driver's wait for it is derived from this.
 export const ARTIFACT_FLUSH_WORST_CASE_MS = ARTIFACT_UPLOAD_DEADLINE_MS + ARTIFACT_REQUEST_TIMEOUT_MS;
 // Longest pause between two attempts at one file. SDK choice: half the Retry-After cap below, so a failing file never
@@ -324,8 +324,8 @@ export const createArtifactUploader = (deps: ArtifactUploaderDeps) => {
           method: 'POST',
           headers: {
             'content-type': 'application/json',
-            'x-perflab-key': deps.key,
-            'x-perflab-run-token': token,
+            'x-keepsnappy-key': deps.key,
+            'x-keepsnappy-run-token': token,
           },
           body: JSON.stringify(body),
           ...(controller ? { signal: controller.signal } : {}),

package/js/sdk/boot.ts

@@ -1,13 +1,13 @@
-// perf-lab SDK entry. withPerfLab (metro.js) adds this module to the graph and
+// keepsnappy SDK entry. withKeepSnappy (metro.js) adds this module to the graph and
 // runs it after InitializeCore, before the app's entry module. The React hook
 // itself was installed earlier by hook.polyfill.js (unless dormant).
 //
 // The measuring SDK (active.ts and everything it imports) is required only when
 // this process measures, so a dormant process never evaluates it.
 
-import { type Decision, PERF_LAB_ENABLED, resolveDecision } from './activation';
+import { type Decision, KEEPSNAPPY_ENABLED, resolveDecision } from './activation';
 
-if (PERF_LAB_ENABLED) {
+if (KEEPSNAPPY_ENABLED) {
   try {
     const decision: Decision = resolveDecision();
     if (decision.active) {
@@ -16,6 +16,6 @@ if (PERF_LAB_ENABLED) {
       (require('./dormant') as typeof import('./dormant')).startDormant(decision);
     }
   } catch (error) {
-    globalThis.console.log(`PERF_LAB boot failed ${String(error)}`);
+    globalThis.console.log(`KEEPSNAPPY boot failed ${String(error)}`);
   }
 }

package/js/sdk/causes.ts

@@ -743,7 +743,7 @@ const wrapDeviceEmitter = (emitter: { emit: AnyFn } | undefined) => {
 // Responses of a request run under the cause of the code that sent it.
 const wrapXhr = (proto: Record<string, unknown> | undefined) => {
   if (!proto || typeof proto.send !== 'function') return;
-  const CAUSE = '__perflabCause';
+  const CAUSE = '__keepsnappyCause';
   const send = proto.send as AnyFn;
   proto.send = function (this: Record<string, unknown>, ...args: unknown[]) {
     this[CAUSE] = captured();
@@ -880,7 +880,7 @@ export const installCauses = (deps: CauseDeps = {}) => {
       | { addListener?: (type: string, fn: (event: RawEvent) => void) => unknown }
       | undefined;
     raw?.addListener?.('*', onRawEvent);
-    g.__PERFLAB_STORES__ = { writer: storeWriter };
+    g.__KEEPSNAPPY_STORES__ = { writer: storeWriter };
     causeStats.installed = true;
   } catch {
     causeStats.errors++;