@kissmyappss/react-native 0.0.0-stage → 1.0.0

package/lib/index.js

@@ -0,0 +1,89 @@
+"use strict";
+// KissMyApps analytics for React Native: sessions, installs, opens, screens and your own
+// events, sent to your KissMyApps project. Pure JavaScript, so there is nothing to link.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KissMyApps = exports.SDK_VERSION = exports.KmaClient = void 0;
+exports.trackNavigation = trackNavigation;
+const react_native_1 = require("react-native");
+const client_1 = require("./client");
+const device_1 = require("./device");
+const navigation_1 = require("./navigation");
+var client_2 = require("./client");
+Object.defineProperty(exports, "KmaClient", { enumerable: true, get: function () { return client_2.KmaClient; } });
+Object.defineProperty(exports, "SDK_VERSION", { enumerable: true, get: function () { return client_2.SDK_VERSION; } });
+let client = null;
+// Calls made before init run once it is called.
+const early = [];
+function call(run) {
+    if (client)
+        run(client);
+    else if (early.length < 100)
+        early.push(run);
+}
+exports.KissMyApps = {
+    /** Starts the SDK once, as early as possible, with the project's client key. */
+    init(options) {
+        var _a;
+        if (client)
+            return client;
+        const started = new client_1.KmaClient(options, {
+            storage: (_a = options.storage) !== null && _a !== void 0 ? _a : null,
+            device: device_1.deviceInfo,
+            fetch: (url, init) => fetch(url, init),
+            sdk: `kma-react-native/${client_1.SDK_VERSION}`,
+        });
+        client = started;
+        if (react_native_1.AppState.currentState !== 'background')
+            started.foreground();
+        react_native_1.AppState.addEventListener('change', (state) => {
+            if (state === 'active')
+                started.foreground();
+            else if (state === 'background')
+                started.background();
+        });
+        for (const run of early.splice(0))
+            run(started);
+        return started;
+    },
+    track(name, properties) {
+        call((kma) => kma.track(name, properties));
+    },
+    screen(name, properties) {
+        call((kma) => kma.screen(name, properties));
+    },
+    identify(userId, traits) {
+        call((kma) => kma.identify(userId, traits));
+    },
+    setTraits(traits) {
+        call((kma) => kma.setTraits(traits));
+    },
+    reset() {
+        call((kma) => kma.reset());
+    },
+    flush() {
+        var _a;
+        return (_a = client === null || client === void 0 ? void 0 : client.flush()) !== null && _a !== void 0 ? _a : Promise.resolve();
+    },
+    optOut() {
+        call((kma) => kma.optOut());
+    },
+    optIn() {
+        call((kma) => kma.optIn());
+    },
+    getAnonymousId() {
+        var _a;
+        return (_a = client === null || client === void 0 ? void 0 : client.getAnonymousId()) !== null && _a !== void 0 ? _a : null;
+    },
+    getSessionId() {
+        var _a;
+        return (_a = client === null || client === void 0 ? void 0 : client.getSessionId()) !== null && _a !== void 0 ? _a : null;
+    },
+};
+/**
+ * Screen views from React Navigation:
+ * `<NavigationContainer ref={ref} {...trackNavigation(ref)}>`.
+ */
+function trackNavigation(ref) {
+    return (0, navigation_1.navigationTracker)(ref, (name) => exports.KissMyApps.screen(name));
+}
+exports.default = exports.KissMyApps;

package/lib/navigation.d.ts

@@ -0,0 +1,10 @@
+export interface NavigationRefLike {
+    getCurrentRoute(): {
+        name: string;
+    } | undefined;
+}
+/** Handlers for NavigationContainer's onReady and onStateChange that report each new screen. */
+export declare function navigationTracker(ref: NavigationRefLike, onScreen: (name: string) => void): {
+    onReady: () => void;
+    onStateChange: () => void;
+};

package/lib/navigation.js

@@ -0,0 +1,18 @@
+"use strict";
+// Screen views from React Navigation, without depending on it: anything with
+// getCurrentRoute(), such as the ref from createNavigationContainerRef(), works.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.navigationTracker = navigationTracker;
+/** Handlers for NavigationContainer's onReady and onStateChange that report each new screen. */
+function navigationTracker(ref, onScreen) {
+    let last;
+    const report = () => {
+        var _a;
+        const name = (_a = ref.getCurrentRoute()) === null || _a === void 0 ? void 0 : _a.name;
+        if (!name || name === last)
+            return;
+        last = name;
+        onScreen(name);
+    };
+    return { onReady: report, onStateChange: report };
+}

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@kissmyappss/react-native",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "KissMyApps analytics for React Native apps: sessions, installs, screens and events.",
+  "license": "MIT",
+  "homepage": "https://kissmyapps.dev",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "react-native": "src/index.ts",
+  "files": [
+    "lib",
+    "src",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm run build"
+  },
+  "peerDependencies": {
+    "react-native": ">=0.70"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  },
+  "keywords": [
+    "analytics",
+    "react-native",
+    "expo",
+    "mobile-analytics",
+    "kissmyapps"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}