@webiny/telemetry 6.4.0-beta.3 → 6.4.0-beta.4

package/cli.d.ts

@@ -1,6 +1,5 @@
 export declare interface SendEventParams {
     event: string;
-    user?: string;
     version?: string;
     properties: Record<string, any>;
 }

package/cli.js

@@ -1,17 +1,19 @@
 import { globalConfig } from "@webiny/global-config";
 import { isCI } from "ci-info";
-import { WTS } from "wts-client/node.js";
+import { WTS } from "@webiny/wts-client/node";
 import baseSendEvent from "./sendEvent.js";
 import { loadJsonFileSync } from "load-json-file";
 import path from "path";
 
-export const sendEvent = async ({ event, user, version, properties }) => {
+export const sendEvent = async ({ event, version, properties }) => {
     const shouldSend = isEnabled();
     if (!shouldSend) {
         return;
     }
 
-    const wts = new WTS();
+    // The WTS client reads the machine id from `~/.webiny/config` (user.id field)
+    // via the same path globalConfig writes to. No need to pass user explicitly.
+    const wts = new WTS({ source: "cli" });
 
     const wcpProperties = {};
     const [wcpOrgId, wcpProjectId] = getWcpOrgProjectId();
@@ -20,15 +22,21 @@ export const sendEvent = async ({ event, user, version, properties }) => {
         wcpProperties.wcpProjectId = wcpProjectId;
     }
 
+    const installationProperties = {};
+    const installationId = getInstallationId();
+    if (installationId) {
+        installationProperties.installation_id = installationId;
+    }
+
     const packageJsonPath = path.join(import.meta.dirname, "package.json");
     const packageJson = loadJsonFileSync(packageJsonPath);
 
     return baseSendEvent({
         event,
-        user: user || globalConfig.get("id"),
         properties: {
             ...properties,
             ...wcpProperties,
+            ...installationProperties,
             version: version || packageJson.version,
             ci: isCI,
             newUser: Boolean(globalConfig.get("newUser"))
@@ -46,6 +54,22 @@ const getWcpOrgProjectId = () => {
     return [];
 };
 
+/**
+ * Reads the anonymous per-project installation id from
+ * `<project-root>/package.json` → `webiny.installationId`. Generated once at
+ * `create-webiny-project` time and tracked in git so it stays stable across
+ * machines that share the project. Returns null if the file is missing or
+ * unreadable — telemetry events still fire, just without the property.
+ */
+const getInstallationId = () => {
+    try {
+        const data = loadJsonFileSync(path.join(process.cwd(), "package.json"));
+        return typeof data?.webiny?.installationId === "string" ? data.webiny.installationId : null;
+    } catch {
+        return null;
+    }
+};
+
 export const enable = () => {
     globalConfig.set("telemetry", true);
 };

package/package.json

@@ -1,19 +1,17 @@
 {
 	"name": "@webiny/telemetry",
-	"version": "6.4.0-beta.3",
+	"version": "6.4.0-beta.4",
 	"type": "module",
 	"license": "MIT",
 	"dependencies": {
-		"@webiny/global-config": "6.4.0-beta.3",
+		"@webiny/global-config": "6.4.0-beta.4",
+		"@webiny/wts-client": "3.0.2",
 		"ci-info": "4.4.0",
 		"jsesc": "3.1.0",
 		"load-json-file": "7.0.1",
-		"strip-ansi": "7.2.0",
-		"wts-client": "2.0.0"
+		"strip-ansi": "7.2.0"
 	},
 	"publishConfig": {
-		"access": "public",
-		"directory": "."
-	},
-	"gitHead": "2e58681d4344024bfb60e6180338e2f154ec87f0"
+		"access": "public"
+	}
 }

package/react.d.ts

@@ -1 +1,2 @@
 export declare function sendEvent(ev: string, properties?: Record<string, any>): Promise<any>;
+export declare function getMachineId(): string | null;

package/react.js

@@ -1,5 +1,87 @@
 import baseSendEvent from "./sendEvent.js";
-import { WTS } from "wts-client/admin.js";
+import { WTS } from "@webiny/wts-client/web";
+
+const STORAGE_MACHINE_ID = "wts_machine_id";
+const STORAGE_PROJECT_ID = "wts_project_id";
+
+let wtsInstance = null;
+let projectId = null;
+let distinctId = null;
+
+/**
+ * Resolves the WTS client identity for the admin app.
+ *
+ * Priority for `distinct_id` (machine_id):
+ *   1. URL param `wts_did` on first load. Persisted to localStorage.
+ *   2. localStorage (subsequent loads).
+ *   3. `process.env.REACT_APP_WEBINY_TELEMETRY_USER_ID` (build-time fallback,
+ *      set by `SetAdminAppEnvVarsBefore{Build,Watch}` from `~/.webiny/config`).
+ *
+ * Priority for `project_id` (installation_id):
+ *   1. URL param `iid` on first load. Persisted to localStorage.
+ *   2. localStorage.
+ *   3. `process.env.REACT_APP_WEBINY_INSTALLATION_ID` (build-time fallback,
+ *      set from `<project>/package.json` → `webiny.installationId`).
+ *
+ * Attached as a super-property on every admin event so PostHog funnels can
+ * group per-install.
+ */
+const initWts = () => {
+    if (wtsInstance) {
+        return wtsInstance;
+    }
+
+    distinctId = process.env.REACT_APP_WEBINY_TELEMETRY_USER_ID;
+    projectId = process.env.REACT_APP_WEBINY_INSTALLATION_ID || null;
+
+    if (typeof window !== "undefined") {
+        const params = new URLSearchParams(window.location.search);
+
+        const fromUrl = params.get("wts_did");
+        if (fromUrl) {
+            distinctId = fromUrl;
+            try {
+                window.localStorage.setItem(STORAGE_MACHINE_ID, fromUrl);
+            } catch {
+                // localStorage unavailable; URL value is used for this session only.
+            }
+        } else {
+            try {
+                distinctId = window.localStorage.getItem(STORAGE_MACHINE_ID) || distinctId;
+            } catch {
+                // ignore
+            }
+        }
+
+        const iidFromUrl = params.get("iid");
+        if (iidFromUrl) {
+            projectId = iidFromUrl;
+            try {
+                window.localStorage.setItem(STORAGE_PROJECT_ID, iidFromUrl);
+            } catch {
+                // ignore
+            }
+        } else {
+            try {
+                projectId = window.localStorage.getItem(STORAGE_PROJECT_ID) || projectId;
+            } catch {
+                // env-var value (set above) is used as fallback.
+            }
+        }
+    }
+
+    wtsInstance = new WTS({ source: "admin", distinctId });
+    return wtsInstance;
+};
+
+/**
+ * Returns the machine_id used by admin events, if known. Used by the
+ * install/finish CTA to construct the alias handoff URL.
+ */
+export const getMachineId = () => {
+    initWts();
+    return distinctId || null;
+};
 
 export const sendEvent = async (event, properties = {}) => {
     const shouldSend = process.env.REACT_APP_WEBINY_TELEMETRY !== "false";
@@ -7,7 +89,7 @@ export const sendEvent = async (event, properties = {}) => {
         return;
     }
 
-    const wts = new WTS();
+    const wts = initWts();
 
     const wcpProperties = {};
     const [wcpOrgId, wcpProjectId] = getWcpOrgProjectId();
@@ -18,10 +100,10 @@ export const sendEvent = async (event, properties = {}) => {
 
     return baseSendEvent({
         event,
-        user: process.env.REACT_APP_WEBINY_TELEMETRY_USER_ID,
         properties: {
             ...properties,
             ...wcpProperties,
+            ...(projectId ? { project_id: projectId } : {}),
             version: process.env.REACT_APP_WEBINY_VERSION,
             ci: process.env.REACT_APP_IS_CI === "true",
             newUser: process.env.REACT_APP_WEBINY_TELEMETRY_NEW_USER === "true"

package/sendEvent.js

@@ -4,17 +4,16 @@ import jsesc from "jsesc";
 /**
  * The main `sendEvent` function.
  * NOTE: don't use this in your app directly. Instead, use the one from `cli.js` or `react.js` files accordingly.
+ *
+ * Identity is owned by the WTS instance — `cli.js` reads `~/.webiny/config`,
+ * `react.js` reads URL params / localStorage / env. This function only
+ * validates and sanitises the event payload before dispatching.
  */
-export default ({ event, user, properties, wts } = {}) => {
-    // 1. Check for the existence of required base parameters.
+export default ({ event, properties, wts } = {}) => {
     if (!event) {
         throw new Error(`Cannot send event - missing "event" name.`);
     }
 
-    if (!user) {
-        throw new Error(`Cannot send event - missing "user" ID.`);
-    }
-
     if (!properties) {
         throw new Error(`Cannot send event - missing "properties" object.`);
     }
@@ -23,7 +22,6 @@ export default ({ event, user, properties, wts } = {}) => {
         throw new Error(`Cannot send event - missing "wts" instance.`);
     }
 
-    // 2. Extract properties and check for existence of required properties.
     if (!properties.version) {
         throw new Error(`Cannot send event - missing "version" property.`);
     }
@@ -38,7 +36,6 @@ export default ({ event, user, properties, wts } = {}) => {
         throw new Error(`Cannot send event - missing "newUser" boolean property.`);
     }
 
-    // 2. Sanitize properties.
     const sanitizedProperties = {
         ...properties,
         newUser: properties.newUser === true ? "yes" : "no",
@@ -56,6 +53,5 @@ export default ({ event, user, properties, wts } = {}) => {
         sanitizedProperties[key] = sanitizedValue;
     }
 
-    // 3. Send.
-    return wts.trackEvent(user, event, sanitizedProperties);
+    return wts.track(event, sanitizedProperties);
 };