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

package/js/sdk/core.ts

@@ -1,12 +1,12 @@
-// perf-lab core: settings, windows, the commit walk, observers, faults, logs.
+// keepsnappy core: settings, windows, the commit walk, observers, faults, logs.
 // Loaded by boot.ts, which Metro runs before the app's entry module.
 
 import {
   type ActivationStore,
   type Decision,
   MODE,
-  PERF_LAB_DEEP_LINK_PATH,
-  PERF_LAB_ENABLED,
+  KEEPSNAPPY_DEEP_LINK_PATH,
+  KEEPSNAPPY_ENABLED,
   parseQuery,
   type PolyfillActivation,
 } from './activation';
@@ -90,7 +90,7 @@ import {
   windowAggregate,
 } from './sampler';
 
-export { PERF_LAB_DEEP_LINK_PATH, PERF_LAB_ENABLED, parseQuery };
+export { KEEPSNAPPY_DEEP_LINK_PATH, KEEPSNAPPY_ENABLED, parseQuery };
 
 type LogSink = 'console' | 'native' | 'both';
 
@@ -126,7 +126,7 @@ interface Settings extends SamplerSettings {
   diag: boolean;
 }
 
-interface PerfLabNative extends Partial<CpuProfileNative> {
+interface KeepSnappyNative extends Partial<CpuProfileNative> {
   beginAsyncSection(name: string, cookie: number): void;
   endAsyncSection(name: string, cookie: number): void;
   setCounter(name: string, value: number): void;
@@ -143,13 +143,13 @@ interface PerfLabNative extends Partial<CpuProfileNative> {
   samplerRecent(sinceT: number): SamplerRecord[];
   samplerNow(): number;
   flushSignal?(status: string, detail: string): void;
-  // GC before the action: Android finishes the pending command broadcast with this result; iOS shows it on `perflab.ack`.
+  // GC before the action: Android finishes the pending command broadcast with this result; iOS shows it on `keepsnappy.ack`.
   commandDone?(n: number, data: string): void;
   /** Android: whether the broadcast of command n still waits for its answer (native finishes it at a deadline). */
   commandPending?(n: number): boolean;
   ackSignal?(text: string): void;
   commandListen?(on: boolean): void;
-  addListener?(event: 'perflabCommand', listener: (e: { cmd: string; n: number; tNative: number }) => void): { remove(): void };
+  addListener?(event: 'keepsnappyCommand', listener: (e: { cmd: string; n: number; tNative: number }) => void): { remove(): void };
 }
 
 interface RendererInternals {
@@ -232,7 +232,7 @@ interface PolyfillHook {
   attach: (listener: HookListener | null) => void;
 }
 
-interface PerfLabGlobal {
+interface KeepSnappyGlobal {
   HermesInternal?: HermesInternalApi;
   PerformanceObserver?: PerfObserverCtor & { supportedEntryTypes?: string[] };
   performance?: PerformanceLike;
@@ -240,12 +240,12 @@ interface PerfLabGlobal {
   console: { log: (...args: unknown[]) => void; timeStamp?: unknown };
   expo?: { modules?: Record<string, unknown> };
   __REACT_DEVTOOLS_GLOBAL_HOOK__?: Record<string, unknown>;
-  __PERFLAB_HOOK__?: PolyfillHook;
-  __PERFLAB_ACTIVATION__?: PolyfillActivation;
-  __PERF_LAB__?: unknown;
+  __KEEPSNAPPY_HOOK__?: PolyfillHook;
+  __KEEPSNAPPY_ACTIVATION__?: PolyfillActivation;
+  __KEEPSNAPPY__?: unknown;
 }
 
-const g = globalThis as unknown as PerfLabGlobal;
+const g = globalThis as unknown as KeepSnappyGlobal;
 
 const NO_FAULTS: Faults = {
   cpu: 0,
@@ -275,15 +275,15 @@ const defaultSettings = (): Settings => ({
   log: AUTO ? 'both' : 'console',
   faults: { ...NO_FAULTS },
   faultTarget: DEFAULT_FAULT_TARGET,
-  profile: (process.env.EXPO_PUBLIC_KEEPSNAPPY_PROFILE ?? process.env.EXPO_PUBLIC_PERF_LAB_PROFILE) === '1',
-  rexport: (process.env.EXPO_PUBLIC_KEEPSNAPPY_REACT_EXPORT ?? process.env.EXPO_PUBLIC_PERF_LAB_REACT_EXPORT) === '1',
-  cpuprof: (process.env.EXPO_PUBLIC_KEEPSNAPPY_CPUPROF ?? process.env.EXPO_PUBLIC_PERF_LAB_CPUPROF) === '1',
-  cpuhz: Number((process.env.EXPO_PUBLIC_KEEPSNAPPY_CPUPROF_HZ ?? process.env.EXPO_PUBLIC_PERF_LAB_CPUPROF_HZ)) || 250,
+  profile: (process.env.EXPO_PUBLIC_KEEPSNAPPY_PROFILE) === '1',
+  rexport: (process.env.EXPO_PUBLIC_KEEPSNAPPY_REACT_EXPORT) === '1',
+  cpuprof: (process.env.EXPO_PUBLIC_KEEPSNAPPY_CPUPROF) === '1',
+  cpuhz: Number((process.env.EXPO_PUBLIC_KEEPSNAPPY_CPUPROF_HZ)) || 250,
   diag: false,
   ...samplerDefaults({
     auto: AUTO,
-    sampler: (process.env.EXPO_PUBLIC_KEEPSNAPPY_SAMPLER ?? process.env.EXPO_PUBLIC_PERF_LAB_SAMPLER),
-    samplerMs: (process.env.EXPO_PUBLIC_KEEPSNAPPY_SAMPLER_MS ?? process.env.EXPO_PUBLIC_PERF_LAB_SAMPLER_MS),
+    sampler: (process.env.EXPO_PUBLIC_KEEPSNAPPY_SAMPLER),
+    samplerMs: (process.env.EXPO_PUBLIC_KEEPSNAPPY_SAMPLER_MS),
   }),
 });
 
@@ -296,14 +296,14 @@ export const now = () => (g.performance ? g.performance.now() : Date.now());
 export const fmt = (ms: number) => ms.toFixed(3);
 const noop = () => undefined;
 
-let nativeModule: PerfLabNative | null | undefined;
+let nativeModule: KeepSnappyNative | null | undefined;
 let nativeMissingLogged = false;
 
-const getNative = (): PerfLabNative | null => {
+const getNative = (): KeepSnappyNative | null => {
   if (nativeModule) {
     return nativeModule;
   }
-  const found = g.expo?.modules?.PerfLab as PerfLabNative | undefined;
+  const found = g.expo?.modules?.KeepSnappy as KeepSnappyNative | undefined;
   if (found) {
     nativeModule = found;
     return found;
@@ -311,7 +311,7 @@ const getNative = (): PerfLabNative | null => {
   if (!nativeMissingLogged) {
     nativeMissingLogged = true;
     g.console.log(
-      'PERF_LAB native module PerfLab missing (expo.modules.PerfLab)',
+      'KEEPSNAPPY native module KeepSnappy missing (expo.modules.KeepSnappy)',
     );
   }
   return null;
@@ -344,10 +344,10 @@ const cpu = createCpuProfiler({
 });
 
 export const perfLog = (message: string, sink: LogSink = settings.log) => {
-  if (!PERF_LAB_ENABLED) {
+  if (!KEEPSNAPPY_ENABLED) {
     return;
   }
-  const line = `PERF_LAB ${message}`;
+  const line = `KEEPSNAPPY ${message}`;
   if (sink === 'console' || sink === 'both') {
     g.console.log(line);
   }
@@ -412,7 +412,7 @@ const nativeSamplerNow = () => {
 
 // On-demand sample: logged natively like the automatic ones and returned. Null when the sampler is off.
 export const sample = (reason = 'manual'): SamplerRecord | null => {
-  if (!PERF_LAB_ENABLED || samplerState.mode === 'off') {
+  if (!KEEPSNAPPY_ENABLED || samplerState.mode === 'off') {
     return null;
   }
   try {
@@ -816,7 +816,7 @@ const clearIdleGc = () => {
 
 const scheduleIdleGc = () => {
   clearIdleGc();
-  if (!PERF_LAB_ENABLED || !settings.gcwin || openWindows.size > 0) {
+  if (!KEEPSNAPPY_ENABLED || !settings.gcwin || openWindows.size > 0) {
     return;
   }
   idleGcTimer = setTimeout(() => {
@@ -835,7 +835,7 @@ export const lastCommitAt = (key: string) =>
 export const isWindowOpen = (key?: string) =>
   key ? openWindows.has(key) : openWindows.size > 0;
 
-const traceName = (name: string) => `perf-lab:${name}`;
+const traceName = (name: string) => `keepsnappy:${name}`;
 
 interface StartOptions {
   key?: string;
@@ -962,7 +962,7 @@ const endBackground = (reason: string) => {
 };
 
 const start = (name: string, options: StartOptions = {}) => {
-  if (!PERF_LAB_ENABLED || !settings.marks) {
+  if (!KEEPSNAPPY_ENABLED || !settings.marks) {
     return null;
   }
   const key = options.key ?? name;
@@ -1091,7 +1091,7 @@ const rename = (key: string, name: string) => {
 };
 
 const point = (name: string) => {
-  if (!PERF_LAB_ENABLED || !settings.marks) {
+  if (!KEEPSNAPPY_ENABLED || !settings.marks) {
     return;
   }
   const t = now();
@@ -1277,15 +1277,15 @@ const onCommitFiberUnmount = (_rendererId: number, fiber: Fiber) => {
 };
 
 export const lastRoot = (rendererId = 1): FiberRoot | null =>
-  g.__PERFLAB_HOOK__?.state.lastRootByRenderer[rendererId] ?? null;
+  g.__KEEPSNAPPY_HOOK__?.state.lastRootByRenderer[rendererId] ?? null;
 
-// The polyfill (withPerfLab) installed the hook before React loaded; attach to
+// The polyfill (withKeepSnappy) installed the hook before React loaded; attach to
 // it. Without the polyfill, fall back to installing it now, as the prototype did.
 export const attachHook = () => {
-  if (!PERF_LAB_ENABLED || hookState.installed) {
+  if (!KEEPSNAPPY_ENABLED || hookState.installed) {
     return;
   }
-  const polyfill = g.__PERFLAB_HOOK__;
+  const polyfill = g.__KEEPSNAPPY_HOOK__;
   if (polyfill) {
     polyfill.ensure();
     polyfill.attach({
@@ -1310,7 +1310,7 @@ export const attachHook = () => {
   }
   if (g.__REACT_DEVTOOLS_GLOBAL_HOOK__) {
     hookState.preexisting = true;
-    g.console.log('PERF_LAB hook already present, not replacing it');
+    g.console.log('KEEPSNAPPY hook already present, not replacing it');
     return;
   }
   let nextRendererId = 1;
@@ -1327,7 +1327,7 @@ export const attachHook = () => {
         bundleType: internals.bundleType,
       });
       g.console.log(
-        `PERF_LAB hook inject id=${id} renderer=${internals.rendererPackageName} version=${internals.version} bundleType=${internals.bundleType}`,
+        `KEEPSNAPPY hook inject id=${id} renderer=${internals.rendererPackageName} version=${internals.version} bundleType=${internals.bundleType}`,
       );
       return id;
     },
@@ -1753,7 +1753,7 @@ const finalizeWindow = (window: MarkerWindow) => {
 const writeWindowRecord = (window: MarkerWindow, summary: Record<string, unknown>) => {
   const json = JSON.stringify(summary);
   perfLog(`window ${json}`);
-  windowListener?.(`${Date.now()} PERF_LAB window ${json}`);
+  windowListener?.(`${Date.now()} KEEPSNAPPY window ${json}`);
   if (settings.file) {
     const path = getNative()?.writeText(
       `window-${window.id}-${window.name.replace(/[^\w.:+-]/g, '_')}.json`,
@@ -1948,7 +1948,7 @@ const forwardSamples = () => {
       if (record.t <= samplesSentT) {
         continue;
       }
-      windowListener(`${record.wallMs} PERF_LAB sample ${JSON.stringify(record)}`);
+      windowListener(`${record.wallMs} KEEPSNAPPY sample ${JSON.stringify(record)}`);
       samplesSentT = record.t;
     }
   } catch (error) {
@@ -1973,7 +1973,7 @@ export const writeRunEvent = (kind: 'gc' | 'appstate', record: Record<string, un
   const json = JSON.stringify({ ...record, t: now(), wallMs: Date.now() });
   perfLog(`${kind} ${json}`);
   if (inRun() && (kind === 'gc' || gcRanSinceFlush)) {
-    windowListener?.(`${Date.now()} PERF_LAB ${kind} ${json}`);
+    windowListener?.(`${Date.now()} KEEPSNAPPY ${kind} ${json}`);
   }
 };
 
@@ -1995,7 +1995,7 @@ export const setFlushHandler = (handler: FlushHandler | null) => {
 };
 
 // `flush=1`: end the open windows, send every unsent line, then show the result
-// to the test driver as an accessibility element (iOS: id `perflab.flushed`,
+// to the test driver as an accessibility element (iOS: id `keepsnappy.flushed`,
 // label `ok` / `error` / `off`), so a flow can wait for it without network access.
 const flushOnce = async () => {
   // One deadline for the whole flush (lines, clock, artifacts); the end report of the upload comes after it.
@@ -2059,7 +2059,7 @@ export const flushNow = (): Promise<void> => {
 
 // The activation's profile/cpuprof turn those on for the whole process; off
 // leaves the build's env defaults.
-// A PerfLab run (one with a run token) forces an idle GC between windows so heap-after-GC
+// A KeepSnappy run (one with a run token) forces an idle GC between windows so heap-after-GC
 // readings exist for the leak slope (plan 41 Q7); `gcwin=0` in a link still turns it off.
 const applyDecision = (decision: Decision) => {
   settings.diag = decision.diag;
@@ -2093,13 +2093,13 @@ const activationReport = () => {
     mode: 'active',
     buildMode: decision.mode,
     read: decision.read,
-    installMs: g.__PERFLAB_ACTIVATION__?.installMs,
+    installMs: g.__KEEPSNAPPY_ACTIVATION__?.installMs,
     runToken: runToken !== null,
     expiresAt: decision.expiresAt,
     diag: decision.diag,
     profile: decision.profile,
     cpuprof: decision.cpuprof,
-    renderer: g.__PERFLAB_ACTIVATION__?.renderer ?? null,
+    renderer: g.__KEEPSNAPPY_ACTIVATION__?.renderer ?? null,
     next: next
       ? {
           active: next.active,
@@ -2258,24 +2258,24 @@ const syncCommandListener = () => {
   if (!native?.commandListen) {
     return;
   }
-  const on = PERF_LAB_ENABLED && runToken !== null;
+  const on = KEEPSNAPPY_ENABLED && runToken !== null;
   if (on && commandSubscription === null) {
     commandSubscription =
-      native.addListener?.('perflabCommand', e => {
+      native.addListener?.('keepsnappyCommand', e => {
         // A command native already timed out on is not run: its GC would land in the next step's action.
         if (native.commandPending?.(e.n) === false) {
           perfLog(`command gc:${e.n} late, skipped`);
           return;
         }
-        handlePerfLabCommand(e.cmd, e.n, e.tNative);
+        handleKeepSnappyCommand(e.cmd, e.n, e.tNative);
       }) ?? null;
   }
   native.commandListen(on);
 };
 
 /** A command (`cmd=<name>&n=<n>`), from a link (iOS) or the native receiver (Android); unknown commands are ignored. */
-export const handlePerfLabCommand = (cmd: string | undefined, n: number, tNative?: number): boolean => {
-  if (!PERF_LAB_ENABLED || cmd !== 'gc' || !Number.isInteger(n) || n < 1) {
+export const handleKeepSnappyCommand = (cmd: string | undefined, n: number, tNative?: number): boolean => {
+  if (!KEEPSNAPPY_ENABLED || cmd !== 'gc' || !Number.isInteger(n) || n < 1) {
     return false;
   }
   // Every received command is answered, so the Android receiver is never left pending.
@@ -2288,14 +2288,14 @@ export const handlePerfLabCommand = (cmd: string | undefined, n: number, tNative
   return true;
 };
 
-export const handlePerfLabDeepLink = (url: string) => {
-  if (!PERF_LAB_ENABLED) {
+export const handleKeepSnappyDeepLink = (url: string) => {
+  if (!KEEPSNAPPY_ENABLED) {
     return;
   }
   const params = parseQuery(url.split('?')[1]);
   // A command changes no settings and writes no activation record.
   if (params.cmd !== undefined) {
-    handlePerfLabCommand(params.cmd, Number(params.n));
+    handleKeepSnappyCommand(params.cmd, Number(params.n));
     return;
   }
   const written = activation?.store.apply(params) ?? null;
@@ -2326,7 +2326,7 @@ export const addStartupSection = (name: string, read: () => unknown) => {
 
 export const logStartup = (phase: string) => {
   const native = getNative();
-  const polyfill = g.__PERFLAB_HOOK__?.state;
+  const polyfill = g.__KEEPSNAPPY_HOOK__?.state;
   const extra: Record<string, unknown> = {};
   for (const [name, read] of extraStartupSections) {
     extra[name] = safe(read);
@@ -2391,7 +2391,7 @@ export const logStartup = (phase: string) => {
 };
 
 export const exposeGlobal = () => {
-  g.__PERF_LAB__ = {
+  g.__KEEPSNAPPY__ = {
     settings,
     set: applySettings,
     markers,

package/js/sdk/cpuprof.ts

@@ -3,7 +3,7 @@
 // overlapping windows (a press and the screen it opens) share one span and one
 // file. Inside a run it samples on until `flush=1` and writes one file there.
 // The file is a DevTools .cpuprofile (nodes/samples/timeDeltas) written by the
-// native module into Documents/perf-lab.
+// native module into Documents/keepsnappy.
 
 export interface CpuProfileNative {
   cpuProfileStart(hz: number): boolean;

package/js/sdk/dormant.ts

@@ -16,14 +16,14 @@ interface DormantNative {
 
 interface DormantGlobal {
   __REACT_DEVTOOLS_GLOBAL_HOOK__?: unknown;
-  __PERFLAB_HOOK__?: { state?: { mode?: string; listener?: unknown } };
-  __PERF_LAB__?: unknown;
+  __KEEPSNAPPY_HOOK__?: { state?: { mode?: string; listener?: unknown } };
+  __KEEPSNAPPY__?: unknown;
   expo?: { modules?: Record<string, unknown> };
 }
 
 const g = globalThis as unknown as DormantGlobal;
 
-const NET_MARK = '__perflabNet';
+const NET_MARK = '__keepsnappyNet';
 
 const marked = (value: unknown) =>
   (typeof value === 'function' || (typeof value === 'object' && value !== null)) &&
@@ -54,8 +54,8 @@ export const dormantReport = (decision: Decision) => ({
   buildMode: decision.mode,
   read: decision.read,
   reactHook: typeof g.__REACT_DEVTOOLS_GLOBAL_HOOK__,
-  perflabHook: g.__PERFLAB_HOOK__ ? (g.__PERFLAB_HOOK__.state?.mode ?? 'present') : 'absent',
-  sdkGlobal: g.__PERF_LAB__ !== undefined,
+  keepsnappyHook: g.__KEEPSNAPPY_HOOK__ ? (g.__KEEPSNAPPY_HOOK__.state?.mode ?? 'present') : 'absent',
+  sdkGlobal: g.__KEEPSNAPPY__ !== undefined,
   fetchWrapped: globalWrapped('fetch'),
   xhrGetterWrapped: globalWrapped('XMLHttpRequest'),
   xhrPatched: xhrPatched(),
@@ -69,9 +69,9 @@ export const startDormant = (decision: Decision) => {
     store.apply(params);
     if (params.dump === '1') {
       // Asked for: one os_log line (iOS) / logcat line (Android), no log file.
-      const native = g.expo?.modules?.PerfLab as DormantNative | undefined;
+      const native = g.expo?.modules?.KeepSnappy as DormantNative | undefined;
       const report = { ...dormantReport(decision), activation: store.stats() };
-      native?.osLog?.(`PERF_LAB dormant ${JSON.stringify(report)}`);
+      native?.osLog?.(`KEEPSNAPPY dormant ${JSON.stringify(report)}`);
     }
   });
 };

package/js/sdk/links.ts

@@ -1,31 +1,31 @@
-// Settings links (`<scheme>://devtools/perf-lab?...`) without app code: the SDK
+// Settings links (`<scheme>://devtools/keepsnappy?...`) without app code: the SDK
 // runs before the router subscribes to Linking, so it wraps the link sources.
-// A perf-lab link goes to the handler here and never reaches the app's
+// A keepsnappy link goes to the handler here and never reaches the app's
 // listeners, so the router does not navigate to an unmatched route. Only a URL
-// whose host and path are exactly `devtools/perf-lab` on a custom (non-web)
+// whose host and path are exactly `devtools/keepsnappy` on a custom (non-web)
 // scheme is one; every other URL passes through unchanged after one substring
 // check: in a dormant build this is the only work the SDK does after startup.
 
 import { Linking } from 'react-native';
 
-import { PERF_LAB_DEEP_LINK_PATH } from './activation';
+import { KEEPSNAPPY_DEEP_LINK_PATH } from './activation';
 
 export type LinkHandler = (url: string, via: string) => void;
-// Told when an app URL (not a perf-lab one) is handed to the app, before the
+// Told when an app URL (not a keepsnappy one) is handed to the app, before the
 // app sees it: the start of a link-driven navigation.
 export type AppLinkHandler = (url: string, via: string) => void;
 
 type UrlListener = (event: { url: string }) => void;
 
-// `<scheme>://devtools/perf-lab[/][?query][#fragment]`, also with an empty host
-// (`<scheme>:///devtools/perf-lab`). Universal links (http/https) never match,
+// `<scheme>://devtools/keepsnappy[/][?query][#fragment]`, also with an empty host
+// (`<scheme>:///devtools/keepsnappy`). Universal links (http/https) never match,
 // so a web page cannot route a link here.
-// Spells out PERF_LAB_DEEP_LINK_PATH.
-const SETTINGS_LINK = /^([a-z][a-z0-9+.-]*):\/\/\/?devtools\/perf-lab\/?(?:[?#]|$)/i;
+// Spells out KEEPSNAPPY_DEEP_LINK_PATH.
+const SETTINGS_LINK = /^([a-z][a-z0-9+.-]*):\/\/\/?devtools\/keepsnappy\/?(?:[?#]|$)/i;
 const WEB_SCHEMES = new Set(['http', 'https']);
 
-export const isPerfLabUrl = (url: unknown): url is string => {
-  if (typeof url !== 'string' || !url.includes(PERF_LAB_DEEP_LINK_PATH)) {
+export const isKeepSnappyUrl = (url: unknown): url is string => {
+  if (typeof url !== 'string' || !url.includes(KEEPSNAPPY_DEEP_LINK_PATH)) {
     return false;
   }
   const match = SETTINGS_LINK.exec(url);
@@ -126,7 +126,7 @@ const patch = (
 };
 
 const filterInitial = (url: unknown, via: string) => {
-  if (isPerfLabUrl(url)) {
+  if (isKeepSnappyUrl(url)) {
     apply(url, via);
     return null;
   }
@@ -157,7 +157,7 @@ export const installLinks = (
         return original(type, listener);
       }
       const filtered: UrlListener = event => {
-        if (isPerfLabUrl(event?.url)) {
+        if (isKeepSnappyUrl(event?.url)) {
           apply(event.url, 'event');
           return;
         }

package/js/sdk/net.ts

@@ -403,8 +403,8 @@ export type NetCounter = ReturnType<typeof createNetCounter>;
 // images loaded natively (Image, expo-image), WebSockets, and native SDKs
 // (Stream, LiveKit, Firebase).
 
-const WRAPPED = '__perflabNet';
-const XHR_STATE = '__perflabNetXhr';
+const WRAPPED = '__keepsnappyNet';
+const XHR_STATE = '__keepsnappyNetXhr';
 const EXPO_BUILTIN = Symbol.for('expo.builtin');
 
 type AnyFn = (...args: unknown[]) => unknown;

package/js/sdk/profile-export.ts

@@ -178,7 +178,7 @@ const changeDescription = (cause: UpdateCause) => ({
 
 export interface ReactExport {
   version: 5;
-  source: 'perflab';
+  source: 'keepsnappy';
   captureStart: { clock: 'perf-now-ms'; t0: number };
   dataForRoots: {
     rootID: number;
@@ -225,11 +225,11 @@ export const buildReactExport = (t0: number, commits: ExportCommit[]): ReactExpo
       passiveEffectDuration: null,
       priorityLevel: null,
       timestamp: Math.max(0, commit.t - t0),
-      perflabCauses: commit.causes,
-      perflabCarrier: commit.carrier,
-      perflabStore: commit.store,
-      perflabTask: commit.task,
-      ...(commit.facts ? { perflabFacts: commit.facts } : {}),
+      keepsnappyCauses: commit.causes,
+      keepsnappyCarrier: commit.carrier,
+      keepsnappyStore: commit.store,
+      keepsnappyTask: commit.task,
+      ...(commit.facts ? { keepsnappyFacts: commit.facts } : {}),
       updaters: (commit.updaters ?? []).map(displayName => ({
         displayName,
         hocDisplayNames: null,
@@ -241,7 +241,7 @@ export const buildReactExport = (t0: number, commits: ExportCommit[]): ReactExpo
   });
   return {
     version: 5,
-    source: 'perflab',
+    source: 'keepsnappy',
     captureStart: { clock: 'perf-now-ms', t0 },
     dataForRoots: [
       {

package/js/sdk/push-install.ts

@@ -1,6 +1,6 @@
 // Wires the push client to React Native: env config, device info, AppState.
-// Push stays off unless both EXPO_PUBLIC_PERFLAB_INGEST_URL and
-// EXPO_PUBLIC_PERFLAB_KEY are set at build time.
+// Push stays off unless both EXPO_PUBLIC_KEEPSNAPPY_INGEST_URL and
+// EXPO_PUBLIC_KEEPSNAPPY_KEY are set at build time.
 
 import { AppState, Platform } from 'react-native';
 
@@ -18,8 +18,8 @@ import {
 import { ownFetch } from './net-install';
 import { createPushClient, type DeviceInfo, type PushSpool } from './push';
 
-const INGEST_URL = (process.env.EXPO_PUBLIC_KEEPSNAPPY_INGEST_URL ?? process.env.EXPO_PUBLIC_PERFLAB_INGEST_URL);
-const INGEST_KEY = (process.env.EXPO_PUBLIC_KEEPSNAPPY_KEY ?? process.env.EXPO_PUBLIC_PERFLAB_KEY);
+const INGEST_URL = (process.env.EXPO_PUBLIC_KEEPSNAPPY_INGEST_URL);
+const INGEST_KEY = (process.env.EXPO_PUBLIC_KEEPSNAPPY_KEY);
 
 const randomId = () =>
   `r${Date.now().toString(36)}${Math.random().toString(36).slice(2, 10)}`;
@@ -80,7 +80,7 @@ interface SpoolNative {
 const nativeArtifacts = (): ArtifactUploadNative | null => {
   const native = (
     globalThis as unknown as { expo?: { modules?: Record<string, unknown> } }
-  ).expo?.modules?.PerfLab as Partial<ArtifactUploadNative> | undefined;
+  ).expo?.modules?.KeepSnappy as Partial<ArtifactUploadNative> | undefined;
   if (!native || typeof native.artifactUpload !== 'function') {
     return null;
   }
@@ -88,12 +88,12 @@ const nativeArtifacts = (): ArtifactUploadNative | null => {
   return { artifactUpload: (...args) => artifactUpload.apply(native, args) };
 };
 
-// The journal file next to the log (perf-lab/push-spool.jsonl). Without these
+// The journal file next to the log (keepsnappy/push-spool.jsonl). Without these
 // native functions (an older binary) the queue is memory-only, as before.
 const nativeSpool = (): PushSpool | null => {
   const native = (
     globalThis as unknown as { expo?: { modules?: Record<string, unknown> } }
-  ).expo?.modules?.PerfLab as SpoolNative | undefined;
+  ).expo?.modules?.KeepSnappy as SpoolNative | undefined;
   if (
     !native ||
     typeof native.spoolRead !== 'function' ||

package/js/sdk/push.ts

@@ -630,10 +630,10 @@ export const createPushClient = (deps: PushDeps) => {
       });
       const headers: Record<string, string> = {
         'content-type': 'application/json',
-        'x-perflab-key': deps.key,
+        'x-keepsnappy-key': deps.key,
       };
       if (runToken) {
-        headers['x-perflab-run-token'] = runToken;
+        headers['x-keepsnappy-run-token'] = runToken;
       }
       const budget = flushLimit !== null ? Math.max(1, Math.min(timeoutMs, flushLimit - deps.now())) : timeoutMs;
       const controller =

package/js/sdk/sampler.ts

@@ -84,7 +84,7 @@ export const SAMPLER_MS_MIN = 250;
 export const SAMPLER_MS_MAX = 60_000;
 // Background interval between native samples. 4 s: Arek 2026-10-16 (followups, RULING ~09:00); windows get their own
 // samples at open and close, so the background ones only serve peak memory in long windows and the heat trend.
-// The native samplers keep the same number as their unconfigured fallback (PerfLabSampler.swift / .kt).
+// The native samplers keep the same number as their unconfigured fallback (KeepSnappySampler.swift / .kt).
 export const SAMPLER_MS_DEFAULT = 4000;
 
 export const parseSamplerMode = (

package/js/zustand-vanilla.js

@@ -1,4 +1,4 @@
-// zustand/vanilla in a PerfLab bundle. withPerfLab (metro.js) resolves every
+// zustand/vanilla in a KeepSnappy bundle. withKeepSnappy (metro.js) resolves every
 // `zustand/vanilla` request to this module (zustand 5's index, react and
 // traditional entries all load it by that name), and the name below to the real
 // one. Each store's setState goes through the cause tracker's store writer
@@ -10,7 +10,7 @@ var real = require('@keepsnappy/react-native/zustand/vanilla');
 
 var wrap = function (createState) {
   return function (set, get, api) {
-    var stores = globalThis.__PERFLAB_STORES__;
+    var stores = globalThis.__KEEPSNAPPY_STORES__;
     if (!stores) {
       return createState(set, get, api);
     }

package/metro.js

@@ -1,6 +1,6 @@
-// withPerfLab(metroConfig): the only line an app adds to metro.config.js.
+// withKeepSnappy(metroConfig): the only line an app adds to metro.config.js.
 //
-// With EXPO_PUBLIC_PERF_LAB=1 it
+// With EXPO_PUBLIC_KEEPSNAPPY=1 it
 //  1. appends the React DevTools hook as a Metro polyfill, so the hook exists
 //     before any module (React included) evaluates;
 //  2. wraps the Babel transformer so the app's entry module imports the SDK boot
@@ -11,12 +11,12 @@
 //     zustand store's setState through the cause tracker (REQ-MEAS-32 timers).
 // Without the flag it returns the config object untouched.
 //
-// PERF_LAB_REACT_PROFILING=1 (independent of the flag) resolves React Native's
+// KEEPSNAPPY_REACT_PROFILING=1 (independent of the flag) resolves React Native's
 // production renderer to its profiling build (fiber actualDuration /
 // selfBaseDuration, root.memoizedUpdaters), the same rewrite as
 // @callstack/inspector's withInspector. Nothing else in the bundle changes.
 //
-// PERF_LAB_REACT_PROFILING=switch (flag on only) bundles both Fabric renderers
+// KEEPSNAPPY_REACT_PROFILING=switch (flag on only) bundles both Fabric renderers
 // behind js/renderer-switch.js, which loads the profiling one only in a process
 // whose activation asked for it (plan 40 §2.1). Ignored with the flag off.
 
@@ -31,13 +31,13 @@ const ENV_UPSTREAM = 'KEEPSNAPPY_UPSTREAM_BABEL_TRANSFORMER';
 const ENV_ENTRY = 'KEEPSNAPPY_ENTRY_FILE';
 const ENV_BOOT = 'KEEPSNAPPY_BOOT_FILE';
 
-const isEnabled = () => (process.env.EXPO_PUBLIC_KEEPSNAPPY ?? process.env.EXPO_PUBLIC_PERF_LAB) === '1';
-const isProfiling = () => (process.env.KEEPSNAPPY_REACT_PROFILING ?? process.env.PERF_LAB_REACT_PROFILING) === '1';
-const isSwitch = () => (process.env.KEEPSNAPPY_REACT_PROFILING ?? process.env.PERF_LAB_REACT_PROFILING) === 'switch';
+const isEnabled = () => (process.env.EXPO_PUBLIC_KEEPSNAPPY) === '1';
+const isProfiling = () => (process.env.KEEPSNAPPY_REACT_PROFILING) === '1';
+const isSwitch = () => (process.env.KEEPSNAPPY_REACT_PROFILING) === 'switch';
 
 const SWITCH_PATH = path.join(__dirname, 'js', 'renderer-switch.js');
 // The names renderer-switch.js requires; they resolve next to RN's shim.
-const SDK_NAMES = ['@keepsnappy/react-native', '@perf-labs/react-native'];
+const SDK_NAMES = ['@keepsnappy/react-native'];
 const SWITCH_TARGET_PREFIXES = SDK_NAMES.map(name => `${name}/renderer/`);
 const FABRIC_RENDERERS = new Set([
   '../implementations/ReactFabric-prod',
@@ -175,7 +175,7 @@ const resolveEntry = projectRoot => {
   return null;
 };
 
-function withPerfLab(input) {
+function withKeepSnappy(input) {
   if (!isEnabled()) {
     return isProfiling() ? withReactProfiling(input) : input;
   }
@@ -225,8 +225,7 @@ function withPerfLab(input) {
 }
 
 module.exports = {
-  withPerfLab,
-  withKeepSnappy: withPerfLab,
+  withKeepSnappy,
   withReactProfiling,
   withRendererSwitch,
   withStoreWrap,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keepsnappy/react-native",
-  "version": "0.1.0-alpha.11",
+  "version": "0.1.0-alpha.13",
   "description": "KeepSnappy in-app SDK for React Native / Expo: zero-code measurement windows, React commit hook, native signposts and log file",
   "license": "UNLICENSED",
   "repository": {