docs: clarify customerId examples

Author: leo-paz

README.md

@@ -45,7 +45,7 @@ const outlit = new Outlit({
 outlit.user.identify({
   email: 'user@example.com',
   traits: { name: 'John Doe' },
-  customerId: 'cust_123', // The stable account/workspace ID you also use on track()
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   customerTraits: { plan: 'pro' },
 })
 
@@ -57,7 +57,7 @@ outlit.track('button_clicked', {
 
 // Mark billing status on a customer
 outlit.customer.trialing({
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   properties: { plan: 'pro' },
 })
 ```
@@ -74,10 +74,10 @@ init({ publicKey: 'pk_xxx' })
 track('page_viewed', { page: '/home' })
 user().identify({
   email: 'user@example.com',
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
 })
 customer().paid({
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   properties: { plan: 'pro' },
 })
 ```
@@ -119,7 +119,7 @@ const outlit = new Outlit({
 
 // Track server-side events (requires identity)
 outlit.track({
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   eventName: 'api_request',
   properties: {
     endpoint: '/api/users',
@@ -135,13 +135,13 @@ outlit.track({
 outlit.user.identify({
   email: 'user@example.com',
   traits: { plan: 'pro' },
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   customerTraits: { plan: 'pro' },
 })
 
 // Mark customer billing status
 outlit.customer.paid({
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   properties: { plan: 'pro' },
 })
 

docs/concepts/customer-journey.mdx

@@ -162,19 +162,19 @@ For non-Stripe payment processors or custom billing logic:
 ```typescript
 // When a trial starts
 outlit.customer.trialing({
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   properties: { trialEndsAt: '2025-06-15' }
 })
 
 // When payment succeeds
 outlit.customer.paid({
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   properties: { plan: 'pro', amount: 99 }
 })
 
 // When subscription is cancelled
 outlit.customer.churned({
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   properties: { reason: 'too_expensive' }
 })
 ```

docs/concepts/identity-resolution.mdx

@@ -151,7 +151,7 @@ Your system-owned customer, account, or workspace ID. Use this when product usag
 outlit.identify({
   email: 'jane@acme.com',
   userId: 'usr_12345',
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   customerTraits: { plan: 'enterprise' }
 })
 ```
@@ -160,7 +160,7 @@ Server-side `track()` calls can also use `customerId` without a user identity:
 
 ```typescript
 outlit.track({
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   eventName: 'account_synced'
 })
 ```
@@ -280,7 +280,7 @@ When Outlit detects the same person with different identifiers, profiles are mer
 
     // Account/workspace-scoped event
     outlit.track({
-      customerId: 'cust_123',
+      customerId: 'cust_123', // Your app's account/workspace/customer ID
       eventName: 'workspace_synced'
     })
     ```

docs/tracking/browser/npm.mdx

@@ -160,7 +160,7 @@ Identify the current visitor. Links their anonymous history to a known profile.
 outlit.identify({
   email: 'jane@acme.com',
   userId: 'usr_12345',
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   traits: {
     name: 'Jane Doe',
     role: 'Engineering Manager',
@@ -200,7 +200,7 @@ Set the current user identity. Ideal for SPA applications where you know the use
 outlit.setUser({
   email: 'jane@acme.com',
   userId: 'usr_12345',
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   traits: {
     name: 'Jane Doe',
   },

docs/tracking/browser/react.mdx

@@ -454,7 +454,7 @@ function MyComponent() {
 
   // Customer billing methods (requires account identifier)
   customer.paid({
-    customerId: 'cust_123',
+    customerId: 'cust_123', // Your app's account/workspace/customer ID
     properties: { plan: 'pro' }
   })
 

docs/tracking/browser/vue.mdx

@@ -291,7 +291,7 @@ user.activate({ flow: 'onboarding' })
 
 // Customer billing methods (requires account identifier)
 customer.paid({
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   properties: { plan: 'pro' }
 })
 

docs/tracking/server/nodejs.mdx

@@ -48,7 +48,7 @@ const outlit = new Outlit({
 // Track an event
 outlit.track({
   email: 'user@example.com',
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   eventName: 'subscription_upgraded',
   properties: {
     fromPlan: 'starter',
@@ -104,7 +104,7 @@ Track a custom event for a user, a customer, or both.
 outlit.track({
   email: 'jane@acme.com',
   userId: 'usr_12345', // optional if email provided
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   eventName: 'report_exported',
   properties: {
     reportType: 'sales',
@@ -155,7 +155,7 @@ Update user traits without tracking an event. Customer metadata can be included
 outlit.identify({
   email: 'jane@acme.com',
   userId: 'usr_12345',
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   customerTraits: {
     plan: 'enterprise',
     seats: 50
@@ -224,7 +224,7 @@ Mark an account as trialing.
 
 ```typescript
 outlit.customer.trialing({
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   properties: { trialEndsAt: '2024-02-15' }
 })
 ```
@@ -235,7 +235,7 @@ Mark an account as paying.
 
 ```typescript
 outlit.customer.paid({
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   properties: { plan: 'pro', amount: 99 }
 })
 ```
@@ -246,7 +246,7 @@ Mark an account as churned.
 
 ```typescript
 outlit.customer.churned({
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   properties: { reason: 'cancelled_by_user' }
 })
 ```
@@ -520,7 +520,7 @@ const outlit = new Outlit(options)
 
 const trackOptions: ServerTrackOptions = {
   email: 'user@test.com',
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   eventName: 'test',
   properties: { key: 'value' }
 }
@@ -537,7 +537,7 @@ outlit.user.activate(stageOptions)
 
 // Account billing options
 const billingOptions: BillingOptions = {
-  customerId: 'cust_123',
+  customerId: 'cust_123', // Your app's account/workspace/customer ID
   properties: { plan: 'pro' }
 }