@keepsnappy/react-native 0.1.0-alpha.12 → 0.1.0-alpha.14

package/app.plugin.js

@@ -1,6 +1,6 @@
-// Expo config plugin for the PerfLab SDK.
+// Expo config plugin for the KeepSnappy SDK.
 //
-// The native module (iOS pod PerfLab, Android expo.modules.perflab) is linked
+// The native module (iOS pod KeepSnappy, Android expo.modules.keepsnappy) is linked
 // by Expo autolinking from expo-module.config.json. With the build flag off
 // (EXPO_PUBLIC_KEEPSNAPPY is not "1" when `expo prebuild` runs) this plugin
 // excludes the package from Expo autolinking, so a store build carries no SDK
@@ -20,8 +20,7 @@ const { withPodfile, withSettingsGradle } = require('expo/config-plugins');
 const PACKAGE_NAME = require('./package.json').name;
 const PACKAGE_NAMES = [...new Set([PACKAGE_NAME, '@keepsnappy/react-native'])];
 const namesFor = name => name === PACKAGE_NAME ? PACKAGE_NAMES : [name];
-// Keep this generated-line marker stable so old exclusions can be removed.
-const TAG = 'perflab: native module excluded, EXPO_PUBLIC_PERF_LAB is not 1';
+const TAG = 'keepsnappy: native module excluded, EXPO_PUBLIC_KEEPSNAPPY is not 1';
 
 const isEnabled = () => (process.env.EXPO_PUBLIC_KEEPSNAPPY) === '1';
 
@@ -61,7 +60,9 @@ const gradleLine = (language, name) =>
     : `expoAutolinking.exclude = (expoAutolinking.exclude ?: []) + [${namesFor(name).map(quoted).join(', ')}] // ${TAG}`;
 
 const editSettingsGradle = (contents, enabled, language = 'groovy', name = PACKAGE_NAME) => {
-  const lines = contents.split('\n').filter(line => !line.includes(TAG));
+  // Match the generated statement independently of its branding comment.
+  const generated = ['groovy', 'kt'].map(dsl => gradleLine(dsl, name).split(' // ')[0]);
+  const lines = contents.split('\n').filter(line => !generated.includes(line.split(' // ')[0].trim()));
   if (enabled) {
     return lines.join('\n');
   }
@@ -81,7 +82,7 @@ const withKeepSnappy = config => {
   if (enabled) {
     config.extra = {
       ...config.extra,
-      perflab: { native: true, profilingRenderer: profilingRenderer() },
+      keepsnappy: { native: true, profilingRenderer: profilingRenderer() },
     };
   }
   config = withPodfile(config, mod => {

package/expo-module.config.json

@@ -1,9 +1,9 @@
 {
   "platforms": ["ios", "android"],
   "ios": {
-    "modules": ["PerfLabModule"]
+    "modules": ["KeepSnappyModule"]
   },
   "android": {
-    "modules": ["expo.modules.perflab.PerfLabModule"]
+    "modules": ["expo.modules.keepsnappy.KeepSnappyModule"]
   }
 }

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)
       }
     }
 
@@ -139,6 +139,31 @@ public class PerfLabModule: Module {
       }
     }
 
+    // The profile files a flush has not uploaded yet, with their run tokens; read by a later process.
+    Function("artifactsPendingRead") { () -> String? in
+      self.logQueue.sync {
+        guard let file = Self.fileIfPresent("artifacts-pending.json") else { return nil }
+        return try? String(contentsOf: file, encoding: .utf8)
+      }
+    }
+
+    Function("artifactsPendingWrite") { (content: String) -> Bool in
+      self.logQueue.sync {
+        guard let dir = Self.outputDir() else { return false }
+        let file = dir.appendingPathComponent("artifacts-pending.json")
+        if content.isEmpty {
+          try? FileManager.default.removeItem(at: file)
+          return true
+        }
+        do {
+          try content.write(to: file, atomically: true, encoding: .utf8)
+          return true
+        } catch {
+          return false
+        }
+      }
+    }
+
     Function("spoolReplace") { (content: String) -> Bool in
       self.logQueue.sync {
         try? self.spoolHandle?.close()
@@ -175,7 +200,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 +212,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 +270,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 +283,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
   }
@@ -296,12 +321,26 @@ public class PerfLabModule: Module {
   private static let flushSignalTag = 0x9E7F_1A5
   private static let ackSignalTag = 0x9E7F_1A6
 
+  // No window yet (a relaunch, a link mid-transition): tried again this often, this far apart.
+  private static let signalRetries = 3
+  private static let signalRetryNanoseconds: UInt64 = 1_000_000_000
+
   @MainActor
-  private static func showSignal(tag: Int, id: String, label status: String, value detail: String) {
+  private static func showSignal(tag: Int, id: String, label status: String, value detail: String, attempt: Int = 0) {
     let windows = UIApplication.shared.connectedScenes
       .compactMap { $0 as? UIWindowScene }
       .flatMap { $0.windows }
-    guard let window = windows.first(where: { $0.isKeyWindow }) ?? windows.first else { return }
+    guard let window = windows.first(where: { $0.isKeyWindow }) ?? windows.first else {
+      if attempt < signalRetries {
+        Task { @MainActor in
+          try? await Task.sleep(nanoseconds: signalRetryNanoseconds)
+          Self.showSignal(tag: tag, id: id, label: status, value: detail, attempt: attempt + 1)
+        }
+      } else {
+        emit("KEEPSNAPPY \(id) not shown: no window after \(attempt + 1) tries (\(status))")
+      }
+      return
+    }
     window.viewWithTag(tag)?.removeFromSuperview()
     let label = UILabel(frame: CGRect(x: 0, y: 0, width: 1, height: 1))
     label.tag = tag
@@ -334,7 +373,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 withKeepSnappy) and adds one import to
-// the entry module: the perf-lab boot module. That import is what puts the SDK
+// 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
@@ -11,8 +11,9 @@ const path = require('path');
 const upstreamPath = (process.env.KEEPSNAPPY_UPSTREAM_BABEL_TRANSFORMER);
 const entryFile = (process.env.KEEPSNAPPY_ENTRY_FILE);
 const bootFile = (process.env.KEEPSNAPPY_BOOT_FILE);
+const sdkVersion = process.env.KEEPSNAPPY_SDK_VERSION;
 
-if (!upstreamPath || !entryFile || !bootFile) {
+if (!upstreamPath || !entryFile || !bootFile || !sdkVersion) {
   throw new Error(
     'KeepSnappy Babel transformer loaded without withKeepSnappy env (KEEPSNAPPY_*)',
   );
@@ -57,7 +58,10 @@ module.exports = {
       return upstream.transform({ ...args, src: bootImport() + args.src });
     }
     if (file.startsWith(packageRoot)) {
-      return upstream.transform({ ...args, src: inlineEnv(args.src) });
+      const src = file === path.join(packageRoot, 'js', 'sdk', 'push-install.ts')
+        ? args.src.replace("require('../../package.json')", JSON.stringify({ version: sdkVersion }))
+        : args.src;
+      return upstream.transform({ ...args, src: inlineEnv(src) });
     }
     return upstream.transform(args);
   },
@@ -66,6 +70,6 @@ module.exports = {
       typeof upstream.getCacheKey === 'function'
         ? upstream.getCacheKey(...args)
         : '';
-    return `${base}$perflab:${entryFile}:${bootFile}:${envSignature()}`;
+    return `${base}$keepsnappy:${entryFile}:${bootFile}:${sdkVersion}:${envSignature()}`;
   },
 };

package/js/build-version.js

@@ -0,0 +1,23 @@
+// Build tooling only: Metro workers receive the identity in their inherited env.
+const { execFileSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+function sdkBuildVersion() {
+  const packageRoot = path.resolve(__dirname, '..');
+  const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
+  if (!pkg.private) return pkg.version;
+  const git = args => execFileSync('git', args, { cwd: packageRoot, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim();
+  try {
+    const root = git(['rev-parse', '--show-toplevel']);
+    const release = JSON.parse(fs.readFileSync(path.join(root, 'release.json'), 'utf8')).version;
+    if (typeof release !== 'string' || !release) throw new Error('release.json has no version');
+    const sha = git(['rev-parse', '--short', 'HEAD']);
+    const dirty = git(['status', '--porcelain', '--untracked-files=normal']) ? '.dirty' : '';
+    return `${release}+local.${sha}${dirty}`;
+  } catch (cause) {
+    throw new Error('KeepSnappy: cannot identify this unpublished SDK; build from its Git checkout or use a staged release package', { cause });
+  }
+}
+
+module.exports = { sdkBuildVersion };

package/js/hook.polyfill.js

@@ -1,4 +1,4 @@
-// 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.
@@ -10,11 +10,11 @@
 // 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
+// `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__';
@@ -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

@@ -5,7 +5,7 @@
 // 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

@@ -6,29 +6,29 @@
 //   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__.
+// 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) === '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(
+export const MODE: KeepSnappyMode = resolveMode(
   (process.env.EXPO_PUBLIC_KEEPSNAPPY_MODE),
   (process.env.EXPO_PUBLIC_KEEPSNAPPY_AUTO),
 );
@@ -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,
     ),