@logbrew/react-native 0.1.8 → 0.1.9

package/README.md

@@ -71,6 +71,11 @@ export async function verifyLogBrewSetup() {
 }
 ```
 
+Screen labels remain available as the original `metadata.screen` value. The
+helper preserves an already machine-safe action name and otherwise normalizes
+and bounds it for hosted ingestion, so labels such as `Checkout Complete` do
+not cause a rejected batch.
+
 For mobile apps, prefer an app-scoped public key through `clientKey`. Expo
 inlines `EXPO_PUBLIC_*` values into the app, so never use a server key there.
 `apiKey` is still accepted for compatibility with lower-level SDK examples.

package/index.cjs

@@ -16,6 +16,8 @@ const {
 const DEFAULT_SDK_NAME = "logbrew-react-native";
 const DEFAULT_SDK_VERSION = "0.1.0";
 const DEFAULT_ENDPOINT = "https://api.logbrew.co/v1/events";
+const MAX_ACTION_NAME_LENGTH = 64;
+const SCREEN_ACTION_PREFIX = "screen:";
 const BACKGROUND_APP_STATES = new Set(["background", "inactive"]);
 const LogBrewNativeContext = React.createContext(null);
 const activeTraceScopes = [];
@@ -294,7 +296,7 @@ function captureScreenView(client, screenName, {
   requireClient(client);
   requireNonEmpty("screen name", screenName);
   client.action(id, timestamp, {
-    name: `screen:${screenName}`,
+    name: screenActionName(screenName),
     status,
     metadata: {
       ...getReactNativeContext({ platform, appState }),
@@ -1023,6 +1025,22 @@ function slugify(value) {
     .replace(/^_+|_+$/g, "") || "event";
 }
 
+function screenActionName(screenName) {
+  const directName = `${SCREEN_ACTION_PREFIX}${screenName}`;
+  if (
+    directName.length <= MAX_ACTION_NAME_LENGTH
+    && /^[a-z0-9_.:-]+$/i.test(directName)
+  ) {
+    return directName;
+  }
+
+  const maxScreenSegmentLength = MAX_ACTION_NAME_LENGTH - SCREEN_ACTION_PREFIX.length;
+  const screenSegment = slugify(screenName)
+    .slice(0, maxScreenSegmentLength)
+    .replace(/_+$/g, "") || "event";
+  return `${SCREEN_ACTION_PREFIX}${screenSegment}`;
+}
+
 function statusFromStatusCode(statusCode) {
   if (typeof statusCode === "number" && Number.isFinite(statusCode) && statusCode >= 400) {
     return "failure";

package/index.js

@@ -16,6 +16,8 @@ import {
 const DEFAULT_SDK_NAME = "logbrew-react-native";
 const DEFAULT_SDK_VERSION = "0.1.0";
 const DEFAULT_ENDPOINT = "https://api.logbrew.co/v1/events";
+const MAX_ACTION_NAME_LENGTH = 64;
+const SCREEN_ACTION_PREFIX = "screen:";
 const BACKGROUND_APP_STATES = new Set(["background", "inactive"]);
 const LogBrewNativeContext = React.createContext(null);
 const activeTraceScopes = [];
@@ -294,7 +296,7 @@ export function captureScreenView(client, screenName, {
   requireClient(client);
   requireNonEmpty("screen name", screenName);
   client.action(id, timestamp, {
-    name: `screen:${screenName}`,
+    name: screenActionName(screenName),
     status,
     metadata: {
       ...getReactNativeContext({ platform, appState }),
@@ -1012,6 +1014,22 @@ function slugify(value) {
     .replace(/^_+|_+$/g, "") || "event";
 }
 
+function screenActionName(screenName) {
+  const directName = `${SCREEN_ACTION_PREFIX}${screenName}`;
+  if (
+    directName.length <= MAX_ACTION_NAME_LENGTH
+    && /^[a-z0-9_.:-]+$/i.test(directName)
+  ) {
+    return directName;
+  }
+
+  const maxScreenSegmentLength = MAX_ACTION_NAME_LENGTH - SCREEN_ACTION_PREFIX.length;
+  const screenSegment = slugify(screenName)
+    .slice(0, maxScreenSegmentLength)
+    .replace(/_+$/g, "") || "event";
+  return `${SCREEN_ACTION_PREFIX}${screenSegment}`;
+}
+
 function statusFromStatusCode(statusCode) {
   if (typeof statusCode === "number" && Number.isFinite(statusCode) && statusCode >= 400) {
     return "failure";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logbrew/react-native",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "React Native screen, error, trace, action, and network timeline helpers for LogBrew.",
   "type": "module",
   "main": "./index.cjs",