@analyticscli/sdk 0.1.0-preview.10 → 0.1.0-preview.12

package/README.md

@@ -38,30 +38,27 @@ Before integrating, collect required values in [dash.analyticscli.com](https://d
 ## Usage (Low Boilerplate)
 
 ```ts
-import { createAnalyticsContext } from '@analyticscli/sdk';
-
-const analytics = createAnalyticsContext({
-  client: {
-    apiKey: '<YOUR_APP_KEY>',
-    identityTrackingMode: 'consent_gated', // explicit host-app default
-  },
-  onboarding: {
-    onboardingFlowId: 'onboarding_v1',
-    onboardingFlowVersion: '1.0.0',
-    isNewUser: true,
-  },
+import { init } from '@analyticscli/sdk';
+
+const analytics = init({
+  apiKey: '<YOUR_APP_KEY>',
+  identityTrackingMode: 'consent_gated', // explicit host-app default
+});
+
+const onboarding = analytics.createOnboardingTracker({
+  onboardingFlowId: 'onboarding_v1',
+  onboardingFlowVersion: '1.0.0',
+  isNewUser: true,
 });
 
-analytics.onboarding.start();
-analytics.onboarding.step('welcome', 0).view();
+onboarding.start();
+onboarding.step('welcome', 0).view();
 ```
 
-`createAnalyticsContext(...)` gives you:
-- `analytics.client` (raw `AnalyticsClient`)
-- `analytics.onboarding` (pre-wired tracker instance)
-- `analytics.paywall` (optional tracker instance)
-- `analytics.consent.*` (collection + full-tracking controls)
-- `analytics.user.*` (`set`, `clear`, `identify`)
+`init(...)` returns `AnalyticsClient` directly.
+Use tracker factories for flow-scoped instrumentation:
+- `analytics.createOnboardingTracker(...)`
+- `analytics.createPaywallTracker(...)`
 
 For host-app integration, prefer explicit client config with
 `identityTrackingMode: 'consent_gated'` unless you intentionally need another mode.
@@ -69,36 +66,32 @@ For host-app integration, prefer explicit client config with
 Optional runtime collection pause/resume:
 
 ```ts
-import { createAnalyticsContext } from '@analyticscli/sdk';
+import { init } from '@analyticscli/sdk';
 
-const analytics = createAnalyticsContext({
-  client: {
-    apiKey: '<YOUR_APP_KEY>',
-    identityTrackingMode: 'consent_gated',
-  },
+const analytics = init({
+  apiKey: '<YOUR_APP_KEY>',
+  identityTrackingMode: 'consent_gated',
 });
-analytics.consent.optOut(); // stop sending until optIn()
+analytics.optOut(); // stop sending until optIn()
 // ...
-analytics.consent.optIn();
+analytics.optIn();
 ```
 
 Optional full-tracking consent gate (recommended default):
 
 ```ts
-import { createAnalyticsContext } from '@analyticscli/sdk';
+import { init } from '@analyticscli/sdk';
 
-const analytics = createAnalyticsContext({
-  client: {
-    apiKey: '<YOUR_APP_KEY>',
-    identityTrackingMode: 'consent_gated',
-  },
+const analytics = init({
+  apiKey: '<YOUR_APP_KEY>',
+  identityTrackingMode: 'consent_gated',
 });
 
 // user accepts full tracking in your consent UI
-analytics.consent.setFullTracking(true);
+analytics.setFullTrackingConsent(true);
 
 // user rejects full tracking but you still keep strict anonymous analytics
-analytics.consent.setFullTracking(false);
+analytics.setFullTrackingConsent(false);
 ```
 
 If `apiKey` is missing, the SDK logs a console error and remains a safe no-op client.
@@ -108,28 +101,20 @@ If `apiKey` is missing, the SDK logs a console error and remains a safe no-op cl
 ```ts
 import * as Application from 'expo-application';
 import { Platform } from 'react-native';
-import { createAnalyticsContext } from '@analyticscli/sdk';
-
-const analytics = createAnalyticsContext({
-  client: {
-    apiKey: process.env.EXPO_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY,
-    debug: __DEV__,
-    platform: Platform.OS,
-    projectSurface: 'app',
-    appVersion: Application.nativeApplicationVersion,
-    initialConsentGranted: true,
-    identityTrackingMode: 'consent_gated',
-    initialFullTrackingConsentGranted: false,
-    dedupeOnboardingStepViewsPerSession: true,
-    dedupeScreenViewsPerSession: true,
-    screenViewDedupeWindowMs: 1200,
-  },
-  onboarding: {
-    onboardingFlowId: 'onboarding_main',
-    onboardingFlowVersion: '1',
-    isNewUser: true,
-    stepCount: 7,
-  },
+import { init } from '@analyticscli/sdk';
+
+const analytics = init({
+  apiKey: process.env.EXPO_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY,
+  debug: __DEV__,
+  platform: Platform.OS,
+  projectSurface: 'app',
+  appVersion: Application.nativeApplicationVersion,
+  initialConsentGranted: true,
+  identityTrackingMode: 'consent_gated',
+  initialFullTrackingConsentGranted: false,
+  dedupeOnboardingStepViewsPerSession: true,
+  dedupeScreenViewsPerSession: true,
+  screenViewDedupeWindowMs: 1200,
 });
 ```
 
@@ -151,7 +136,7 @@ For paywall funnels with stable `source` + `paywallId`, create one tracker per
 flow context and reuse it:
 
 ```ts
-const paywall = analytics.createPaywall({
+const paywall = analytics.createPaywallTracker({
   source: 'onboarding',
   paywallId: 'default_paywall',
   offering: 'rc_main', // RevenueCat example
@@ -161,7 +146,7 @@ paywall.shown({ fromScreen: 'onboarding_offer' });
 paywall.purchaseSuccess({ packageId: 'annual' });
 ```
 
-Do not create a new `createPaywall(...)` instance for every paywall callback/event.
+Do not create a new `createPaywallTracker(...)` instance for every paywall callback/event.
 If your paywall provider exposes it, pass `offering` in tracker defaults
 (RevenueCat offering id, Adapty paywall/placement id, Superwall placement/paywall id).
 
@@ -169,7 +154,7 @@ For onboarding surveys, avoid repeating unchanged flow metadata at every callsit
 Create one onboarding tracker with defaults and emit minimal survey payloads:
 
 ```ts
-const onboarding = analytics.createOnboarding({
+const onboarding = analytics.createOnboardingTracker({
   onboardingFlowId: 'onboarding_main',
   onboardingFlowVersion: '1',
   stepCount: 7,
@@ -187,11 +172,11 @@ onboarding.step('budget-survey', 6).surveyResponse({
 For RevenueCat correlation, keep identity and paywall purchase metadata aligned:
 
 ```ts
-analytics.user.set(appUserId); // same id passed to Purchases.logIn(appUserId)
+analytics.setUser(appUserId); // same id passed to Purchases.logIn(appUserId)
 // in purchase callbacks, prefer provider-native ids
 paywall.purchaseStarted({ packageId: packageBeingPurchased.identifier });
 // on sign-out
-analytics.user.clear();
+analytics.clearUser();
 ```
 
 Identity tracking modes:
@@ -205,25 +190,25 @@ Recommendation for global tenant apps:
 In strict phase (and in `strict` mode):
 - no persistent SDK identity across app/browser restarts
 - no cookie-domain identity continuity
-- `analytics.user.identify(...)` / `analytics.user.set(...)` are ignored
+- `analytics.identify(...)` / `analytics.setUser(...)` are ignored
 
 `initialConsentGranted` is optional:
 - default: `true` when `apiKey` is present
 - you can still pause/resume collection at runtime with consent APIs when your app needs that
 
 Runtime collection control APIs:
-- `analytics.consent.get()` -> current in-memory consent
-- `analytics.consent.getState()` -> `'granted' | 'denied' | 'unknown'`
-- `analytics.consent.optIn()` / `analytics.consent.optOut()`
-- `analytics.consent.set(true|false)`
+- `analytics.getConsent()` -> current in-memory consent
+- `analytics.getConsentState()` -> `'granted' | 'denied' | 'unknown'`
+- `analytics.optIn()` / `analytics.optOut()`
+- `analytics.setConsent(true|false)`
 
 Full-tracking control APIs:
-- `analytics.consent.setFullTracking(true|false)`
-- `analytics.consent.optInFullTracking()` / `analytics.consent.optOutFullTracking()`
-- `analytics.consent.isFullTrackingEnabled()`
+- `analytics.setFullTrackingConsent(true|false)`
+- `analytics.optInFullTracking()` / `analytics.optOutFullTracking()`
+- `analytics.isFullTrackingEnabled()`
 
-`analytics.ready()` / `analytics.client.ready()` do not "start" tracking. With default settings, tracking
-starts on `createAnalyticsContext(...)`.
+`analytics.ready()` does not "start" tracking. With default settings, tracking
+starts on `init(...)`.
 
 Use your project-specific publishable API key from the AnalyticsCLI dashboard in your workspace.
 Only the publishable API key (`apiKey`) is needed for SDK setup calls.

package/dist/browser.cjs

@@ -31,7 +31,6 @@ __export(browser_exports, {
   PAYWALL_SKIP_EVENT_CANDIDATES: () => PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_EVENTS: () => PURCHASE_EVENTS,
   PURCHASE_SUCCESS_EVENT_CANDIDATES: () => PURCHASE_SUCCESS_EVENT_CANDIDATES,
-  createAnalyticsContext: () => createAnalyticsContext,
   init: () => init,
   initAsync: () => initAsync,
   initConsentFirst: () => initConsentFirst,
@@ -1121,20 +1120,25 @@ var AnalyticsClient = class {
     if (!this.consentGranted) {
       return;
     }
+    const normalizedScreenName = this.normalizeScreenName(name);
+    if (!normalizedScreenName) {
+      this.log("Dropping screen event with invalid name", { name });
+      return;
+    }
     if (this.shouldDeferEventsUntilHydrated()) {
       const deferredProperties = this.cloneProperties(properties);
       this.deferEventUntilHydrated(() => {
-        this.screen(name, deferredProperties);
+        this.screen(normalizedScreenName, deferredProperties);
       });
       return;
     }
     const sessionId = this.getSessionId();
-    if (this.shouldDropScreenView(name, properties, sessionId)) {
+    if (this.shouldDropScreenView(normalizedScreenName, properties, sessionId)) {
       return;
     }
     this.enqueue({
       eventId: randomId(),
-      eventName: `screen:${name}`,
+      eventName: `screen:${normalizedScreenName}`,
       ts: nowIso(),
       sessionId,
       anonId: this.anonId,
@@ -1639,6 +1643,20 @@ var AnalyticsClient = class {
     const resolvedScreenClass = screenClass ?? normalizedName;
     return `${normalizedName}|${resolvedScreenClass}`;
   }
+  normalizeScreenName(name) {
+    const trimmed = this.readRequiredStringOption(name);
+    if (!trimmed) {
+      return null;
+    }
+    const withoutEdgeSlashes = trimmed.replace(/^\/+|\/+$/g, "");
+    const candidate = withoutEdgeSlashes || "root";
+    const normalized = candidate.replace(/[^a-zA-Z0-9_:\-.]/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
+    if (!normalized) {
+      return null;
+    }
+    const maxScreenNameLength = 100 - "screen:".length;
+    return normalized.slice(0, maxScreenNameLength);
+  }
   getOnboardingStepViewDedupeKey(properties) {
     if (!properties) {
       return null;
@@ -1804,7 +1822,6 @@ var AnalyticsClient = class {
       appBuild: this.context.appBuild,
       osName: this.context.osName,
       osVersion: this.context.osVersion,
-      country: this.context.country,
       region: this.context.region,
       city: this.context.city
     };
@@ -1857,78 +1874,8 @@ var AnalyticsClient = class {
   }
 };
 
-// src/context.ts
-var normalizeInitInput = (input) => {
-  if (typeof input === "string") {
-    return { apiKey: input };
-  }
-  if (input === null || input === void 0) {
-    return {};
-  }
-  return input;
-};
-var resolveClient = (input) => {
-  if (input instanceof AnalyticsClient) {
-    return input;
-  }
-  return new AnalyticsClient(normalizeInitInput(input ?? {}));
-};
-var createAnalyticsContext = (options = {}) => {
-  const client = resolveClient(options.client);
-  let onboardingTracker = client.createOnboardingTracker(options.onboarding ?? {});
-  let paywallTracker = options.paywall ? client.createPaywallTracker(options.paywall) : null;
-  const consent = {
-    get: () => client.getConsent(),
-    getState: () => client.getConsentState(),
-    set: (granted, setOptions) => client.setConsent(granted, setOptions),
-    optIn: (setOptions) => client.optIn(setOptions),
-    optOut: (setOptions) => client.optOut(setOptions),
-    setFullTracking: (granted, setOptions) => client.setFullTrackingConsent(granted, setOptions),
-    optInFullTracking: (setOptions) => client.optInFullTracking(setOptions),
-    optOutFullTracking: (setOptions) => client.optOutFullTracking(setOptions),
-    isFullTrackingEnabled: () => client.isFullTrackingEnabled()
-  };
-  const user = {
-    identify: (userId, traits) => client.identify(userId, traits),
-    set: (userId, traits) => client.setUser(userId, traits),
-    clear: () => client.clearUser()
-  };
-  return {
-    client,
-    get onboarding() {
-      return onboardingTracker;
-    },
-    get paywall() {
-      return paywallTracker;
-    },
-    consent,
-    user,
-    track: (eventName, properties) => client.track(eventName, properties),
-    trackOnboardingEvent: (eventName, properties) => client.trackOnboardingEvent(eventName, properties),
-    trackOnboardingSurveyResponse: (input, eventName) => client.trackOnboardingSurveyResponse(input, eventName),
-    trackPaywallEvent: (eventName, properties) => client.trackPaywallEvent(eventName, properties),
-    screen: (name, properties) => client.screen(name, properties),
-    page: (name, properties) => client.page(name, properties),
-    feedback: (message, rating, properties) => client.feedback(message, rating, properties),
-    setContext: (context) => client.setContext(context),
-    createOnboarding: (defaults) => client.createOnboardingTracker(defaults),
-    createPaywall: (defaults) => client.createPaywallTracker(defaults),
-    configureOnboarding: (defaults) => {
-      onboardingTracker = client.createOnboardingTracker(defaults);
-      return onboardingTracker;
-    },
-    configurePaywall: (defaults) => {
-      paywallTracker = client.createPaywallTracker(defaults);
-      return paywallTracker;
-    },
-    ready: () => client.ready(),
-    flush: () => client.flush(),
-    shutdown: () => client.shutdown()
-  };
-};
-
 // src/index.ts
-var normalizeInitInput2 = (input) => {
+var normalizeInitInput = (input) => {
   if (typeof input === "string") {
     return { apiKey: input };
   }
@@ -1938,17 +1885,17 @@ var normalizeInitInput2 = (input) => {
   return input;
 };
 var init = (input = {}) => {
-  return new AnalyticsClient(normalizeInitInput2(input));
+  return new AnalyticsClient(normalizeInitInput(input));
 };
 var initConsentFirst = (input = {}) => {
-  const normalized = normalizeInitInput2(input);
+  const normalized = normalizeInitInput(input);
   return new AnalyticsClient({
     ...normalized,
     initialConsentGranted: false
   });
 };
 var initAsync = async (input = {}) => {
-  const client = new AnalyticsClient(normalizeInitInput2(input));
+  const client = new AnalyticsClient(normalizeInitInput(input));
   await client.ready();
   return client;
 };
@@ -1970,7 +1917,6 @@ var initConsentFirstAsync = async (input = {}) => {
   PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_EVENTS,
   PURCHASE_SUCCESS_EVENT_CANDIDATES,
-  createAnalyticsContext,
   init,
   initAsync,
   initConsentFirst,

package/dist/browser.d.cts

@@ -1 +1 @@
-export { AnalyticsClient, AnalyticsClientOptions, AnalyticsConsentState, AnalyticsContext, AnalyticsContextConsentControls, AnalyticsContextUserControls, AnalyticsIngestError, AnalyticsIngestErrorHandler, AnalyticsStorageAdapter, CreateAnalyticsContextOptions, EventContext, EventProperties, IdentityTrackingMode, InitInput, InitOptions, ONBOARDING_EVENTS, ONBOARDING_PROGRESS_EVENT_ORDER, ONBOARDING_SCREEN_EVENT_PREFIXES, ONBOARDING_SURVEY_EVENTS, OnboardingEventName, OnboardingEventProperties, OnboardingStepTracker, OnboardingSurveyAnswerType, OnboardingSurveyEventName, OnboardingSurveyResponseInput, OnboardingTracker, OnboardingTrackerDefaults, OnboardingTrackerSurveyInput, PAYWALL_ANCHOR_EVENT_CANDIDATES, PAYWALL_EVENTS, PAYWALL_JOURNEY_EVENT_ORDER, PAYWALL_SKIP_EVENT_CANDIDATES, PURCHASE_EVENTS, PURCHASE_SUCCESS_EVENT_CANDIDATES, PaywallEventName, PaywallEventProperties, PaywallJourneyEventName, PaywallTracker, PaywallTrackerDefaults, PaywallTrackerProperties, PurchaseEventName, SetConsentOptions, createAnalyticsContext, init, initAsync, initConsentFirst, initConsentFirstAsync } from './index.cjs';
+export { AnalyticsClient, AnalyticsClientOptions, AnalyticsConsentState, AnalyticsIngestError, AnalyticsIngestErrorHandler, AnalyticsStorageAdapter, EventContext, EventProperties, IdentityTrackingMode, InitInput, InitOptions, ONBOARDING_EVENTS, ONBOARDING_PROGRESS_EVENT_ORDER, ONBOARDING_SCREEN_EVENT_PREFIXES, ONBOARDING_SURVEY_EVENTS, OnboardingEventName, OnboardingEventProperties, OnboardingStepTracker, OnboardingSurveyAnswerType, OnboardingSurveyEventName, OnboardingSurveyResponseInput, OnboardingTracker, OnboardingTrackerDefaults, OnboardingTrackerSurveyInput, PAYWALL_ANCHOR_EVENT_CANDIDATES, PAYWALL_EVENTS, PAYWALL_JOURNEY_EVENT_ORDER, PAYWALL_SKIP_EVENT_CANDIDATES, PURCHASE_EVENTS, PURCHASE_SUCCESS_EVENT_CANDIDATES, PaywallEventName, PaywallEventProperties, PaywallJourneyEventName, PaywallTracker, PaywallTrackerDefaults, PaywallTrackerProperties, PurchaseEventName, SetConsentOptions, init, initAsync, initConsentFirst, initConsentFirstAsync } from './index.cjs';

package/dist/browser.d.ts

@@ -1 +1 @@
-export { AnalyticsClient, AnalyticsClientOptions, AnalyticsConsentState, AnalyticsContext, AnalyticsContextConsentControls, AnalyticsContextUserControls, AnalyticsIngestError, AnalyticsIngestErrorHandler, AnalyticsStorageAdapter, CreateAnalyticsContextOptions, EventContext, EventProperties, IdentityTrackingMode, InitInput, InitOptions, ONBOARDING_EVENTS, ONBOARDING_PROGRESS_EVENT_ORDER, ONBOARDING_SCREEN_EVENT_PREFIXES, ONBOARDING_SURVEY_EVENTS, OnboardingEventName, OnboardingEventProperties, OnboardingStepTracker, OnboardingSurveyAnswerType, OnboardingSurveyEventName, OnboardingSurveyResponseInput, OnboardingTracker, OnboardingTrackerDefaults, OnboardingTrackerSurveyInput, PAYWALL_ANCHOR_EVENT_CANDIDATES, PAYWALL_EVENTS, PAYWALL_JOURNEY_EVENT_ORDER, PAYWALL_SKIP_EVENT_CANDIDATES, PURCHASE_EVENTS, PURCHASE_SUCCESS_EVENT_CANDIDATES, PaywallEventName, PaywallEventProperties, PaywallJourneyEventName, PaywallTracker, PaywallTrackerDefaults, PaywallTrackerProperties, PurchaseEventName, SetConsentOptions, createAnalyticsContext, init, initAsync, initConsentFirst, initConsentFirstAsync } from './index.js';
+export { AnalyticsClient, AnalyticsClientOptions, AnalyticsConsentState, AnalyticsIngestError, AnalyticsIngestErrorHandler, AnalyticsStorageAdapter, EventContext, EventProperties, IdentityTrackingMode, InitInput, InitOptions, ONBOARDING_EVENTS, ONBOARDING_PROGRESS_EVENT_ORDER, ONBOARDING_SCREEN_EVENT_PREFIXES, ONBOARDING_SURVEY_EVENTS, OnboardingEventName, OnboardingEventProperties, OnboardingStepTracker, OnboardingSurveyAnswerType, OnboardingSurveyEventName, OnboardingSurveyResponseInput, OnboardingTracker, OnboardingTrackerDefaults, OnboardingTrackerSurveyInput, PAYWALL_ANCHOR_EVENT_CANDIDATES, PAYWALL_EVENTS, PAYWALL_JOURNEY_EVENT_ORDER, PAYWALL_SKIP_EVENT_CANDIDATES, PURCHASE_EVENTS, PURCHASE_SUCCESS_EVENT_CANDIDATES, PaywallEventName, PaywallEventProperties, PaywallJourneyEventName, PaywallTracker, PaywallTrackerDefaults, PaywallTrackerProperties, PurchaseEventName, SetConsentOptions, init, initAsync, initConsentFirst, initConsentFirstAsync } from './index.js';

package/dist/browser.js

@@ -10,12 +10,11 @@ import {
   PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_EVENTS,
   PURCHASE_SUCCESS_EVENT_CANDIDATES,
-  createAnalyticsContext,
   init,
   initAsync,
   initConsentFirst,
   initConsentFirstAsync
-} from "./chunk-6EPJZLLK.js";
+} from "./chunk-4DKQNTSO.js";
 export {
   AnalyticsClient,
   ONBOARDING_EVENTS,
@@ -28,7 +27,6 @@ export {
   PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_EVENTS,
   PURCHASE_SUCCESS_EVENT_CANDIDATES,
-  createAnalyticsContext,
   init,
   initAsync,
   initConsentFirst,

package/dist/{chunk-6EPJZLLK.js → chunk-4DKQNTSO.js}

@@ -1080,20 +1080,25 @@ var AnalyticsClient = class {
     if (!this.consentGranted) {
       return;
     }
+    const normalizedScreenName = this.normalizeScreenName(name);
+    if (!normalizedScreenName) {
+      this.log("Dropping screen event with invalid name", { name });
+      return;
+    }
     if (this.shouldDeferEventsUntilHydrated()) {
       const deferredProperties = this.cloneProperties(properties);
       this.deferEventUntilHydrated(() => {
-        this.screen(name, deferredProperties);
+        this.screen(normalizedScreenName, deferredProperties);
       });
       return;
     }
     const sessionId = this.getSessionId();
-    if (this.shouldDropScreenView(name, properties, sessionId)) {
+    if (this.shouldDropScreenView(normalizedScreenName, properties, sessionId)) {
       return;
     }
     this.enqueue({
       eventId: randomId(),
-      eventName: `screen:${name}`,
+      eventName: `screen:${normalizedScreenName}`,
       ts: nowIso(),
       sessionId,
       anonId: this.anonId,
@@ -1598,6 +1603,20 @@ var AnalyticsClient = class {
     const resolvedScreenClass = screenClass ?? normalizedName;
     return `${normalizedName}|${resolvedScreenClass}`;
   }
+  normalizeScreenName(name) {
+    const trimmed = this.readRequiredStringOption(name);
+    if (!trimmed) {
+      return null;
+    }
+    const withoutEdgeSlashes = trimmed.replace(/^\/+|\/+$/g, "");
+    const candidate = withoutEdgeSlashes || "root";
+    const normalized = candidate.replace(/[^a-zA-Z0-9_:\-.]/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
+    if (!normalized) {
+      return null;
+    }
+    const maxScreenNameLength = 100 - "screen:".length;
+    return normalized.slice(0, maxScreenNameLength);
+  }
   getOnboardingStepViewDedupeKey(properties) {
     if (!properties) {
       return null;
@@ -1763,7 +1782,6 @@ var AnalyticsClient = class {
       appBuild: this.context.appBuild,
       osName: this.context.osName,
       osVersion: this.context.osVersion,
-      country: this.context.country,
       region: this.context.region,
       city: this.context.city
     };
@@ -1816,78 +1834,8 @@ var AnalyticsClient = class {
   }
 };
 
-// src/context.ts
-var normalizeInitInput = (input) => {
-  if (typeof input === "string") {
-    return { apiKey: input };
-  }
-  if (input === null || input === void 0) {
-    return {};
-  }
-  return input;
-};
-var resolveClient = (input) => {
-  if (input instanceof AnalyticsClient) {
-    return input;
-  }
-  return new AnalyticsClient(normalizeInitInput(input ?? {}));
-};
-var createAnalyticsContext = (options = {}) => {
-  const client = resolveClient(options.client);
-  let onboardingTracker = client.createOnboardingTracker(options.onboarding ?? {});
-  let paywallTracker = options.paywall ? client.createPaywallTracker(options.paywall) : null;
-  const consent = {
-    get: () => client.getConsent(),
-    getState: () => client.getConsentState(),
-    set: (granted, setOptions) => client.setConsent(granted, setOptions),
-    optIn: (setOptions) => client.optIn(setOptions),
-    optOut: (setOptions) => client.optOut(setOptions),
-    setFullTracking: (granted, setOptions) => client.setFullTrackingConsent(granted, setOptions),
-    optInFullTracking: (setOptions) => client.optInFullTracking(setOptions),
-    optOutFullTracking: (setOptions) => client.optOutFullTracking(setOptions),
-    isFullTrackingEnabled: () => client.isFullTrackingEnabled()
-  };
-  const user = {
-    identify: (userId, traits) => client.identify(userId, traits),
-    set: (userId, traits) => client.setUser(userId, traits),
-    clear: () => client.clearUser()
-  };
-  return {
-    client,
-    get onboarding() {
-      return onboardingTracker;
-    },
-    get paywall() {
-      return paywallTracker;
-    },
-    consent,
-    user,
-    track: (eventName, properties) => client.track(eventName, properties),
-    trackOnboardingEvent: (eventName, properties) => client.trackOnboardingEvent(eventName, properties),
-    trackOnboardingSurveyResponse: (input, eventName) => client.trackOnboardingSurveyResponse(input, eventName),
-    trackPaywallEvent: (eventName, properties) => client.trackPaywallEvent(eventName, properties),
-    screen: (name, properties) => client.screen(name, properties),
-    page: (name, properties) => client.page(name, properties),
-    feedback: (message, rating, properties) => client.feedback(message, rating, properties),
-    setContext: (context) => client.setContext(context),
-    createOnboarding: (defaults) => client.createOnboardingTracker(defaults),
-    createPaywall: (defaults) => client.createPaywallTracker(defaults),
-    configureOnboarding: (defaults) => {
-      onboardingTracker = client.createOnboardingTracker(defaults);
-      return onboardingTracker;
-    },
-    configurePaywall: (defaults) => {
-      paywallTracker = client.createPaywallTracker(defaults);
-      return paywallTracker;
-    },
-    ready: () => client.ready(),
-    flush: () => client.flush(),
-    shutdown: () => client.shutdown()
-  };
-};
-
 // src/index.ts
-var normalizeInitInput2 = (input) => {
+var normalizeInitInput = (input) => {
   if (typeof input === "string") {
     return { apiKey: input };
   }
@@ -1897,17 +1845,17 @@ var normalizeInitInput2 = (input) => {
   return input;
 };
 var init = (input = {}) => {
-  return new AnalyticsClient(normalizeInitInput2(input));
+  return new AnalyticsClient(normalizeInitInput(input));
 };
 var initConsentFirst = (input = {}) => {
-  const normalized = normalizeInitInput2(input);
+  const normalized = normalizeInitInput(input);
   return new AnalyticsClient({
     ...normalized,
     initialConsentGranted: false
   });
 };
 var initAsync = async (input = {}) => {
-  const client = new AnalyticsClient(normalizeInitInput2(input));
+  const client = new AnalyticsClient(normalizeInitInput(input));
   await client.ready();
   return client;
 };
@@ -1929,7 +1877,6 @@ export {
   PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_SUCCESS_EVENT_CANDIDATES,
   AnalyticsClient,
-  createAnalyticsContext,
   init,
   initConsentFirst,
   initAsync,

package/dist/index.cjs

@@ -31,7 +31,6 @@ __export(index_exports, {
   PAYWALL_SKIP_EVENT_CANDIDATES: () => PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_EVENTS: () => PURCHASE_EVENTS,
   PURCHASE_SUCCESS_EVENT_CANDIDATES: () => PURCHASE_SUCCESS_EVENT_CANDIDATES,
-  createAnalyticsContext: () => createAnalyticsContext,
   init: () => init,
   initAsync: () => initAsync,
   initConsentFirst: () => initConsentFirst,
@@ -1121,20 +1120,25 @@ var AnalyticsClient = class {
     if (!this.consentGranted) {
       return;
     }
+    const normalizedScreenName = this.normalizeScreenName(name);
+    if (!normalizedScreenName) {
+      this.log("Dropping screen event with invalid name", { name });
+      return;
+    }
     if (this.shouldDeferEventsUntilHydrated()) {
       const deferredProperties = this.cloneProperties(properties);
       this.deferEventUntilHydrated(() => {
-        this.screen(name, deferredProperties);
+        this.screen(normalizedScreenName, deferredProperties);
       });
       return;
     }
     const sessionId = this.getSessionId();
-    if (this.shouldDropScreenView(name, properties, sessionId)) {
+    if (this.shouldDropScreenView(normalizedScreenName, properties, sessionId)) {
       return;
     }
     this.enqueue({
       eventId: randomId(),
-      eventName: `screen:${name}`,
+      eventName: `screen:${normalizedScreenName}`,
       ts: nowIso(),
       sessionId,
       anonId: this.anonId,
@@ -1639,6 +1643,20 @@ var AnalyticsClient = class {
     const resolvedScreenClass = screenClass ?? normalizedName;
     return `${normalizedName}|${resolvedScreenClass}`;
   }
+  normalizeScreenName(name) {
+    const trimmed = this.readRequiredStringOption(name);
+    if (!trimmed) {
+      return null;
+    }
+    const withoutEdgeSlashes = trimmed.replace(/^\/+|\/+$/g, "");
+    const candidate = withoutEdgeSlashes || "root";
+    const normalized = candidate.replace(/[^a-zA-Z0-9_:\-.]/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
+    if (!normalized) {
+      return null;
+    }
+    const maxScreenNameLength = 100 - "screen:".length;
+    return normalized.slice(0, maxScreenNameLength);
+  }
   getOnboardingStepViewDedupeKey(properties) {
     if (!properties) {
       return null;
@@ -1804,7 +1822,6 @@ var AnalyticsClient = class {
       appBuild: this.context.appBuild,
       osName: this.context.osName,
       osVersion: this.context.osVersion,
-      country: this.context.country,
       region: this.context.region,
       city: this.context.city
     };
@@ -1857,78 +1874,8 @@ var AnalyticsClient = class {
   }
 };
 
-// src/context.ts
-var normalizeInitInput = (input) => {
-  if (typeof input === "string") {
-    return { apiKey: input };
-  }
-  if (input === null || input === void 0) {
-    return {};
-  }
-  return input;
-};
-var resolveClient = (input) => {
-  if (input instanceof AnalyticsClient) {
-    return input;
-  }
-  return new AnalyticsClient(normalizeInitInput(input ?? {}));
-};
-var createAnalyticsContext = (options = {}) => {
-  const client = resolveClient(options.client);
-  let onboardingTracker = client.createOnboardingTracker(options.onboarding ?? {});
-  let paywallTracker = options.paywall ? client.createPaywallTracker(options.paywall) : null;
-  const consent = {
-    get: () => client.getConsent(),
-    getState: () => client.getConsentState(),
-    set: (granted, setOptions) => client.setConsent(granted, setOptions),
-    optIn: (setOptions) => client.optIn(setOptions),
-    optOut: (setOptions) => client.optOut(setOptions),
-    setFullTracking: (granted, setOptions) => client.setFullTrackingConsent(granted, setOptions),
-    optInFullTracking: (setOptions) => client.optInFullTracking(setOptions),
-    optOutFullTracking: (setOptions) => client.optOutFullTracking(setOptions),
-    isFullTrackingEnabled: () => client.isFullTrackingEnabled()
-  };
-  const user = {
-    identify: (userId, traits) => client.identify(userId, traits),
-    set: (userId, traits) => client.setUser(userId, traits),
-    clear: () => client.clearUser()
-  };
-  return {
-    client,
-    get onboarding() {
-      return onboardingTracker;
-    },
-    get paywall() {
-      return paywallTracker;
-    },
-    consent,
-    user,
-    track: (eventName, properties) => client.track(eventName, properties),
-    trackOnboardingEvent: (eventName, properties) => client.trackOnboardingEvent(eventName, properties),
-    trackOnboardingSurveyResponse: (input, eventName) => client.trackOnboardingSurveyResponse(input, eventName),
-    trackPaywallEvent: (eventName, properties) => client.trackPaywallEvent(eventName, properties),
-    screen: (name, properties) => client.screen(name, properties),
-    page: (name, properties) => client.page(name, properties),
-    feedback: (message, rating, properties) => client.feedback(message, rating, properties),
-    setContext: (context) => client.setContext(context),
-    createOnboarding: (defaults) => client.createOnboardingTracker(defaults),
-    createPaywall: (defaults) => client.createPaywallTracker(defaults),
-    configureOnboarding: (defaults) => {
-      onboardingTracker = client.createOnboardingTracker(defaults);
-      return onboardingTracker;
-    },
-    configurePaywall: (defaults) => {
-      paywallTracker = client.createPaywallTracker(defaults);
-      return paywallTracker;
-    },
-    ready: () => client.ready(),
-    flush: () => client.flush(),
-    shutdown: () => client.shutdown()
-  };
-};
-
 // src/index.ts
-var normalizeInitInput2 = (input) => {
+var normalizeInitInput = (input) => {
   if (typeof input === "string") {
     return { apiKey: input };
   }
@@ -1938,17 +1885,17 @@ var normalizeInitInput2 = (input) => {
   return input;
 };
 var init = (input = {}) => {
-  return new AnalyticsClient(normalizeInitInput2(input));
+  return new AnalyticsClient(normalizeInitInput(input));
 };
 var initConsentFirst = (input = {}) => {
-  const normalized = normalizeInitInput2(input);
+  const normalized = normalizeInitInput(input);
   return new AnalyticsClient({
     ...normalized,
     initialConsentGranted: false
   });
 };
 var initAsync = async (input = {}) => {
-  const client = new AnalyticsClient(normalizeInitInput2(input));
+  const client = new AnalyticsClient(normalizeInitInput(input));
   await client.ready();
   return client;
 };
@@ -1970,7 +1917,6 @@ var initConsentFirstAsync = async (input = {}) => {
   PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_EVENTS,
   PURCHASE_SUCCESS_EVENT_CANDIDATES,
-  createAnalyticsContext,
   init,
   initAsync,
   initConsentFirst,

package/dist/index.d.cts

@@ -49,7 +49,6 @@ type EventContext = {
     appBuild?: string;
     osName?: string;
     osVersion?: string;
-    country?: string;
     region?: string;
     city?: string;
 };
@@ -487,6 +486,7 @@ declare class AnalyticsClient {
     private shouldDropOnboardingStepView;
     private shouldDropScreenView;
     private getScreenViewDedupeKey;
+    private normalizeScreenName;
     private getOnboardingStepViewDedupeKey;
     private readPropertyAsString;
     private readPropertyAsStepIndex;
@@ -510,65 +510,6 @@ declare class AnalyticsClient {
     private reportMissingApiKey;
 }
 
-type ContextClientInput = InitInput | AnalyticsClient | null | undefined;
-type AnalyticsContextConsentControls = {
-    get: () => boolean;
-    getState: () => AnalyticsConsentState;
-    set: (granted: boolean, options?: SetConsentOptions) => void;
-    optIn: (options?: SetConsentOptions) => void;
-    optOut: (options?: SetConsentOptions) => void;
-    setFullTracking: (granted: boolean, options?: SetConsentOptions) => void;
-    optInFullTracking: (options?: SetConsentOptions) => void;
-    optOutFullTracking: (options?: SetConsentOptions) => void;
-    isFullTrackingEnabled: () => boolean;
-};
-type AnalyticsContextUserControls = {
-    identify: (userId: string, traits?: EventProperties) => void;
-    set: (userId: string | null | undefined, traits?: EventProperties) => void;
-    clear: () => void;
-};
-type AnalyticsContext = {
-    client: AnalyticsClient;
-    onboarding: OnboardingTracker;
-    paywall: PaywallTracker | null;
-    consent: AnalyticsContextConsentControls;
-    user: AnalyticsContextUserControls;
-    track: (eventName: string, properties?: EventProperties) => void;
-    trackOnboardingEvent: (eventName: OnboardingEventName, properties?: OnboardingEventProperties) => void;
-    trackOnboardingSurveyResponse: (input: OnboardingSurveyResponseInput, eventName?: OnboardingSurveyEventName) => void;
-    trackPaywallEvent: (eventName: PaywallJourneyEventName, properties: PaywallEventProperties) => void;
-    screen: (name: string, properties?: EventProperties) => void;
-    page: (name: string, properties?: EventProperties) => void;
-    feedback: (message: string, rating?: number, properties?: EventProperties) => void;
-    setContext: (context: EventContext) => void;
-    createOnboarding: (defaults: OnboardingTrackerDefaults) => OnboardingTracker;
-    createPaywall: (defaults: PaywallTrackerDefaults) => PaywallTracker;
-    configureOnboarding: (defaults: OnboardingTrackerDefaults) => OnboardingTracker;
-    configurePaywall: (defaults: PaywallTrackerDefaults) => PaywallTracker;
-    ready: () => Promise<void>;
-    flush: () => Promise<void>;
-    shutdown: () => void;
-};
-type CreateAnalyticsContextOptions = {
-    /**
-     * Either an existing client instance or standard `init(...)` input.
-     */
-    client?: ContextClientInput;
-    /**
-     * Defaults used for the exported `context.onboarding` tracker instance.
-     */
-    onboarding?: OnboardingTrackerDefaults | null;
-    /**
-     * Optional defaults used for the exported `context.paywall` tracker instance.
-     */
-    paywall?: PaywallTrackerDefaults | null;
-};
-/**
- * Host-app friendly SDK context with low boilerplate and rich defaults.
- * Provides pre-wired onboarding + consent/user controls and optional paywall tracker binding.
- */
-declare const createAnalyticsContext: (options?: CreateAnalyticsContextOptions) => AnalyticsContext;
-
 /**
  * Creates a browser analytics client instance.
  */
@@ -584,4 +525,4 @@ declare const initConsentFirst: (input?: InitInput) => AnalyticsClient;
 declare const initAsync: (input?: InitInput) => Promise<AnalyticsClient>;
 declare const initConsentFirstAsync: (input?: InitInput) => Promise<AnalyticsClient>;
 
-export { AnalyticsClient, type AnalyticsClientOptions, type AnalyticsConsentState, type AnalyticsContext, type AnalyticsContextConsentControls, type AnalyticsContextUserControls, type AnalyticsIngestError, type AnalyticsIngestErrorHandler, type AnalyticsStorageAdapter, type CreateAnalyticsContextOptions, type EventContext, type EventProperties, type IdentityTrackingMode, type InitInput, type InitOptions, ONBOARDING_EVENTS, ONBOARDING_PROGRESS_EVENT_ORDER, ONBOARDING_SCREEN_EVENT_PREFIXES, ONBOARDING_SURVEY_EVENTS, type OnboardingEventName, type OnboardingEventProperties, type OnboardingStepTracker, type OnboardingSurveyAnswerType, type OnboardingSurveyEventName, type OnboardingSurveyResponseInput, type OnboardingTracker, type OnboardingTrackerDefaults, type OnboardingTrackerSurveyInput, PAYWALL_ANCHOR_EVENT_CANDIDATES, PAYWALL_EVENTS, PAYWALL_JOURNEY_EVENT_ORDER, PAYWALL_SKIP_EVENT_CANDIDATES, PURCHASE_EVENTS, PURCHASE_SUCCESS_EVENT_CANDIDATES, type PaywallEventName, type PaywallEventProperties, type PaywallJourneyEventName, type PaywallTracker, type PaywallTrackerDefaults, type PaywallTrackerProperties, type PurchaseEventName, type SetConsentOptions, createAnalyticsContext, init, initAsync, initConsentFirst, initConsentFirstAsync };
+export { AnalyticsClient, type AnalyticsClientOptions, type AnalyticsConsentState, type AnalyticsIngestError, type AnalyticsIngestErrorHandler, type AnalyticsStorageAdapter, type EventContext, type EventProperties, type IdentityTrackingMode, type InitInput, type InitOptions, ONBOARDING_EVENTS, ONBOARDING_PROGRESS_EVENT_ORDER, ONBOARDING_SCREEN_EVENT_PREFIXES, ONBOARDING_SURVEY_EVENTS, type OnboardingEventName, type OnboardingEventProperties, type OnboardingStepTracker, type OnboardingSurveyAnswerType, type OnboardingSurveyEventName, type OnboardingSurveyResponseInput, type OnboardingTracker, type OnboardingTrackerDefaults, type OnboardingTrackerSurveyInput, PAYWALL_ANCHOR_EVENT_CANDIDATES, PAYWALL_EVENTS, PAYWALL_JOURNEY_EVENT_ORDER, PAYWALL_SKIP_EVENT_CANDIDATES, PURCHASE_EVENTS, PURCHASE_SUCCESS_EVENT_CANDIDATES, type PaywallEventName, type PaywallEventProperties, type PaywallJourneyEventName, type PaywallTracker, type PaywallTrackerDefaults, type PaywallTrackerProperties, type PurchaseEventName, type SetConsentOptions, init, initAsync, initConsentFirst, initConsentFirstAsync };

package/dist/index.d.ts

@@ -49,7 +49,6 @@ type EventContext = {
     appBuild?: string;
     osName?: string;
     osVersion?: string;
-    country?: string;
     region?: string;
     city?: string;
 };
@@ -487,6 +486,7 @@ declare class AnalyticsClient {
     private shouldDropOnboardingStepView;
     private shouldDropScreenView;
     private getScreenViewDedupeKey;
+    private normalizeScreenName;
     private getOnboardingStepViewDedupeKey;
     private readPropertyAsString;
     private readPropertyAsStepIndex;
@@ -510,65 +510,6 @@ declare class AnalyticsClient {
     private reportMissingApiKey;
 }
 
-type ContextClientInput = InitInput | AnalyticsClient | null | undefined;
-type AnalyticsContextConsentControls = {
-    get: () => boolean;
-    getState: () => AnalyticsConsentState;
-    set: (granted: boolean, options?: SetConsentOptions) => void;
-    optIn: (options?: SetConsentOptions) => void;
-    optOut: (options?: SetConsentOptions) => void;
-    setFullTracking: (granted: boolean, options?: SetConsentOptions) => void;
-    optInFullTracking: (options?: SetConsentOptions) => void;
-    optOutFullTracking: (options?: SetConsentOptions) => void;
-    isFullTrackingEnabled: () => boolean;
-};
-type AnalyticsContextUserControls = {
-    identify: (userId: string, traits?: EventProperties) => void;
-    set: (userId: string | null | undefined, traits?: EventProperties) => void;
-    clear: () => void;
-};
-type AnalyticsContext = {
-    client: AnalyticsClient;
-    onboarding: OnboardingTracker;
-    paywall: PaywallTracker | null;
-    consent: AnalyticsContextConsentControls;
-    user: AnalyticsContextUserControls;
-    track: (eventName: string, properties?: EventProperties) => void;
-    trackOnboardingEvent: (eventName: OnboardingEventName, properties?: OnboardingEventProperties) => void;
-    trackOnboardingSurveyResponse: (input: OnboardingSurveyResponseInput, eventName?: OnboardingSurveyEventName) => void;
-    trackPaywallEvent: (eventName: PaywallJourneyEventName, properties: PaywallEventProperties) => void;
-    screen: (name: string, properties?: EventProperties) => void;
-    page: (name: string, properties?: EventProperties) => void;
-    feedback: (message: string, rating?: number, properties?: EventProperties) => void;
-    setContext: (context: EventContext) => void;
-    createOnboarding: (defaults: OnboardingTrackerDefaults) => OnboardingTracker;
-    createPaywall: (defaults: PaywallTrackerDefaults) => PaywallTracker;
-    configureOnboarding: (defaults: OnboardingTrackerDefaults) => OnboardingTracker;
-    configurePaywall: (defaults: PaywallTrackerDefaults) => PaywallTracker;
-    ready: () => Promise<void>;
-    flush: () => Promise<void>;
-    shutdown: () => void;
-};
-type CreateAnalyticsContextOptions = {
-    /**
-     * Either an existing client instance or standard `init(...)` input.
-     */
-    client?: ContextClientInput;
-    /**
-     * Defaults used for the exported `context.onboarding` tracker instance.
-     */
-    onboarding?: OnboardingTrackerDefaults | null;
-    /**
-     * Optional defaults used for the exported `context.paywall` tracker instance.
-     */
-    paywall?: PaywallTrackerDefaults | null;
-};
-/**
- * Host-app friendly SDK context with low boilerplate and rich defaults.
- * Provides pre-wired onboarding + consent/user controls and optional paywall tracker binding.
- */
-declare const createAnalyticsContext: (options?: CreateAnalyticsContextOptions) => AnalyticsContext;
-
 /**
  * Creates a browser analytics client instance.
  */
@@ -584,4 +525,4 @@ declare const initConsentFirst: (input?: InitInput) => AnalyticsClient;
 declare const initAsync: (input?: InitInput) => Promise<AnalyticsClient>;
 declare const initConsentFirstAsync: (input?: InitInput) => Promise<AnalyticsClient>;
 
-export { AnalyticsClient, type AnalyticsClientOptions, type AnalyticsConsentState, type AnalyticsContext, type AnalyticsContextConsentControls, type AnalyticsContextUserControls, type AnalyticsIngestError, type AnalyticsIngestErrorHandler, type AnalyticsStorageAdapter, type CreateAnalyticsContextOptions, type EventContext, type EventProperties, type IdentityTrackingMode, type InitInput, type InitOptions, ONBOARDING_EVENTS, ONBOARDING_PROGRESS_EVENT_ORDER, ONBOARDING_SCREEN_EVENT_PREFIXES, ONBOARDING_SURVEY_EVENTS, type OnboardingEventName, type OnboardingEventProperties, type OnboardingStepTracker, type OnboardingSurveyAnswerType, type OnboardingSurveyEventName, type OnboardingSurveyResponseInput, type OnboardingTracker, type OnboardingTrackerDefaults, type OnboardingTrackerSurveyInput, PAYWALL_ANCHOR_EVENT_CANDIDATES, PAYWALL_EVENTS, PAYWALL_JOURNEY_EVENT_ORDER, PAYWALL_SKIP_EVENT_CANDIDATES, PURCHASE_EVENTS, PURCHASE_SUCCESS_EVENT_CANDIDATES, type PaywallEventName, type PaywallEventProperties, type PaywallJourneyEventName, type PaywallTracker, type PaywallTrackerDefaults, type PaywallTrackerProperties, type PurchaseEventName, type SetConsentOptions, createAnalyticsContext, init, initAsync, initConsentFirst, initConsentFirstAsync };
+export { AnalyticsClient, type AnalyticsClientOptions, type AnalyticsConsentState, type AnalyticsIngestError, type AnalyticsIngestErrorHandler, type AnalyticsStorageAdapter, type EventContext, type EventProperties, type IdentityTrackingMode, type InitInput, type InitOptions, ONBOARDING_EVENTS, ONBOARDING_PROGRESS_EVENT_ORDER, ONBOARDING_SCREEN_EVENT_PREFIXES, ONBOARDING_SURVEY_EVENTS, type OnboardingEventName, type OnboardingEventProperties, type OnboardingStepTracker, type OnboardingSurveyAnswerType, type OnboardingSurveyEventName, type OnboardingSurveyResponseInput, type OnboardingTracker, type OnboardingTrackerDefaults, type OnboardingTrackerSurveyInput, PAYWALL_ANCHOR_EVENT_CANDIDATES, PAYWALL_EVENTS, PAYWALL_JOURNEY_EVENT_ORDER, PAYWALL_SKIP_EVENT_CANDIDATES, PURCHASE_EVENTS, PURCHASE_SUCCESS_EVENT_CANDIDATES, type PaywallEventName, type PaywallEventProperties, type PaywallJourneyEventName, type PaywallTracker, type PaywallTrackerDefaults, type PaywallTrackerProperties, type PurchaseEventName, type SetConsentOptions, init, initAsync, initConsentFirst, initConsentFirstAsync };

package/dist/index.js

@@ -10,12 +10,11 @@ import {
   PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_EVENTS,
   PURCHASE_SUCCESS_EVENT_CANDIDATES,
-  createAnalyticsContext,
   init,
   initAsync,
   initConsentFirst,
   initConsentFirstAsync
-} from "./chunk-6EPJZLLK.js";
+} from "./chunk-4DKQNTSO.js";
 export {
   AnalyticsClient,
   ONBOARDING_EVENTS,
@@ -28,7 +27,6 @@ export {
   PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_EVENTS,
   PURCHASE_SUCCESS_EVENT_CANDIDATES,
-  createAnalyticsContext,
   init,
   initAsync,
   initConsentFirst,

package/dist/react-native.cjs

@@ -31,7 +31,6 @@ __export(react_native_exports, {
   PAYWALL_SKIP_EVENT_CANDIDATES: () => PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_EVENTS: () => PURCHASE_EVENTS,
   PURCHASE_SUCCESS_EVENT_CANDIDATES: () => PURCHASE_SUCCESS_EVENT_CANDIDATES,
-  createAnalyticsContext: () => createAnalyticsContext,
   init: () => init,
   initAsync: () => initAsync,
   initConsentFirst: () => initConsentFirst,
@@ -1121,20 +1120,25 @@ var AnalyticsClient = class {
     if (!this.consentGranted) {
       return;
     }
+    const normalizedScreenName = this.normalizeScreenName(name);
+    if (!normalizedScreenName) {
+      this.log("Dropping screen event with invalid name", { name });
+      return;
+    }
     if (this.shouldDeferEventsUntilHydrated()) {
       const deferredProperties = this.cloneProperties(properties);
       this.deferEventUntilHydrated(() => {
-        this.screen(name, deferredProperties);
+        this.screen(normalizedScreenName, deferredProperties);
       });
       return;
     }
     const sessionId = this.getSessionId();
-    if (this.shouldDropScreenView(name, properties, sessionId)) {
+    if (this.shouldDropScreenView(normalizedScreenName, properties, sessionId)) {
       return;
     }
     this.enqueue({
       eventId: randomId(),
-      eventName: `screen:${name}`,
+      eventName: `screen:${normalizedScreenName}`,
       ts: nowIso(),
       sessionId,
       anonId: this.anonId,
@@ -1639,6 +1643,20 @@ var AnalyticsClient = class {
     const resolvedScreenClass = screenClass ?? normalizedName;
     return `${normalizedName}|${resolvedScreenClass}`;
   }
+  normalizeScreenName(name) {
+    const trimmed = this.readRequiredStringOption(name);
+    if (!trimmed) {
+      return null;
+    }
+    const withoutEdgeSlashes = trimmed.replace(/^\/+|\/+$/g, "");
+    const candidate = withoutEdgeSlashes || "root";
+    const normalized = candidate.replace(/[^a-zA-Z0-9_:\-.]/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
+    if (!normalized) {
+      return null;
+    }
+    const maxScreenNameLength = 100 - "screen:".length;
+    return normalized.slice(0, maxScreenNameLength);
+  }
   getOnboardingStepViewDedupeKey(properties) {
     if (!properties) {
       return null;
@@ -1804,7 +1822,6 @@ var AnalyticsClient = class {
       appBuild: this.context.appBuild,
       osName: this.context.osName,
       osVersion: this.context.osVersion,
-      country: this.context.country,
       region: this.context.region,
       city: this.context.city
     };
@@ -1857,78 +1874,8 @@ var AnalyticsClient = class {
   }
 };
 
-// src/context.ts
-var normalizeInitInput = (input) => {
-  if (typeof input === "string") {
-    return { apiKey: input };
-  }
-  if (input === null || input === void 0) {
-    return {};
-  }
-  return input;
-};
-var resolveClient = (input) => {
-  if (input instanceof AnalyticsClient) {
-    return input;
-  }
-  return new AnalyticsClient(normalizeInitInput(input ?? {}));
-};
-var createAnalyticsContext = (options = {}) => {
-  const client = resolveClient(options.client);
-  let onboardingTracker = client.createOnboardingTracker(options.onboarding ?? {});
-  let paywallTracker = options.paywall ? client.createPaywallTracker(options.paywall) : null;
-  const consent = {
-    get: () => client.getConsent(),
-    getState: () => client.getConsentState(),
-    set: (granted, setOptions) => client.setConsent(granted, setOptions),
-    optIn: (setOptions) => client.optIn(setOptions),
-    optOut: (setOptions) => client.optOut(setOptions),
-    setFullTracking: (granted, setOptions) => client.setFullTrackingConsent(granted, setOptions),
-    optInFullTracking: (setOptions) => client.optInFullTracking(setOptions),
-    optOutFullTracking: (setOptions) => client.optOutFullTracking(setOptions),
-    isFullTrackingEnabled: () => client.isFullTrackingEnabled()
-  };
-  const user = {
-    identify: (userId, traits) => client.identify(userId, traits),
-    set: (userId, traits) => client.setUser(userId, traits),
-    clear: () => client.clearUser()
-  };
-  return {
-    client,
-    get onboarding() {
-      return onboardingTracker;
-    },
-    get paywall() {
-      return paywallTracker;
-    },
-    consent,
-    user,
-    track: (eventName, properties) => client.track(eventName, properties),
-    trackOnboardingEvent: (eventName, properties) => client.trackOnboardingEvent(eventName, properties),
-    trackOnboardingSurveyResponse: (input, eventName) => client.trackOnboardingSurveyResponse(input, eventName),
-    trackPaywallEvent: (eventName, properties) => client.trackPaywallEvent(eventName, properties),
-    screen: (name, properties) => client.screen(name, properties),
-    page: (name, properties) => client.page(name, properties),
-    feedback: (message, rating, properties) => client.feedback(message, rating, properties),
-    setContext: (context) => client.setContext(context),
-    createOnboarding: (defaults) => client.createOnboardingTracker(defaults),
-    createPaywall: (defaults) => client.createPaywallTracker(defaults),
-    configureOnboarding: (defaults) => {
-      onboardingTracker = client.createOnboardingTracker(defaults);
-      return onboardingTracker;
-    },
-    configurePaywall: (defaults) => {
-      paywallTracker = client.createPaywallTracker(defaults);
-      return paywallTracker;
-    },
-    ready: () => client.ready(),
-    flush: () => client.flush(),
-    shutdown: () => client.shutdown()
-  };
-};
-
 // src/index.ts
-var normalizeInitInput2 = (input) => {
+var normalizeInitInput = (input) => {
   if (typeof input === "string") {
     return { apiKey: input };
   }
@@ -1938,17 +1885,17 @@ var normalizeInitInput2 = (input) => {
   return input;
 };
 var init = (input = {}) => {
-  return new AnalyticsClient(normalizeInitInput2(input));
+  return new AnalyticsClient(normalizeInitInput(input));
 };
 var initConsentFirst = (input = {}) => {
-  const normalized = normalizeInitInput2(input);
+  const normalized = normalizeInitInput(input);
   return new AnalyticsClient({
     ...normalized,
     initialConsentGranted: false
   });
 };
 var initAsync = async (input = {}) => {
-  const client = new AnalyticsClient(normalizeInitInput2(input));
+  const client = new AnalyticsClient(normalizeInitInput(input));
   await client.ready();
   return client;
 };
@@ -1970,7 +1917,6 @@ var initConsentFirstAsync = async (input = {}) => {
   PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_EVENTS,
   PURCHASE_SUCCESS_EVENT_CANDIDATES,
-  createAnalyticsContext,
   init,
   initAsync,
   initConsentFirst,

package/dist/react-native.d.cts

@@ -1 +1 @@
-export { AnalyticsClient, AnalyticsClientOptions, AnalyticsConsentState, AnalyticsContext, AnalyticsContextConsentControls, AnalyticsContextUserControls, AnalyticsIngestError, AnalyticsIngestErrorHandler, AnalyticsStorageAdapter, CreateAnalyticsContextOptions, EventContext, EventProperties, IdentityTrackingMode, InitInput, InitOptions, ONBOARDING_EVENTS, ONBOARDING_PROGRESS_EVENT_ORDER, ONBOARDING_SCREEN_EVENT_PREFIXES, ONBOARDING_SURVEY_EVENTS, OnboardingEventName, OnboardingEventProperties, OnboardingStepTracker, OnboardingSurveyAnswerType, OnboardingSurveyEventName, OnboardingSurveyResponseInput, OnboardingTracker, OnboardingTrackerDefaults, OnboardingTrackerSurveyInput, PAYWALL_ANCHOR_EVENT_CANDIDATES, PAYWALL_EVENTS, PAYWALL_JOURNEY_EVENT_ORDER, PAYWALL_SKIP_EVENT_CANDIDATES, PURCHASE_EVENTS, PURCHASE_SUCCESS_EVENT_CANDIDATES, PaywallEventName, PaywallEventProperties, PaywallJourneyEventName, PaywallTracker, PaywallTrackerDefaults, PaywallTrackerProperties, PurchaseEventName, SetConsentOptions, createAnalyticsContext, init, initAsync, initConsentFirst, initConsentFirstAsync } from './index.cjs';
+export { AnalyticsClient, AnalyticsClientOptions, AnalyticsConsentState, AnalyticsIngestError, AnalyticsIngestErrorHandler, AnalyticsStorageAdapter, EventContext, EventProperties, IdentityTrackingMode, InitInput, InitOptions, ONBOARDING_EVENTS, ONBOARDING_PROGRESS_EVENT_ORDER, ONBOARDING_SCREEN_EVENT_PREFIXES, ONBOARDING_SURVEY_EVENTS, OnboardingEventName, OnboardingEventProperties, OnboardingStepTracker, OnboardingSurveyAnswerType, OnboardingSurveyEventName, OnboardingSurveyResponseInput, OnboardingTracker, OnboardingTrackerDefaults, OnboardingTrackerSurveyInput, PAYWALL_ANCHOR_EVENT_CANDIDATES, PAYWALL_EVENTS, PAYWALL_JOURNEY_EVENT_ORDER, PAYWALL_SKIP_EVENT_CANDIDATES, PURCHASE_EVENTS, PURCHASE_SUCCESS_EVENT_CANDIDATES, PaywallEventName, PaywallEventProperties, PaywallJourneyEventName, PaywallTracker, PaywallTrackerDefaults, PaywallTrackerProperties, PurchaseEventName, SetConsentOptions, init, initAsync, initConsentFirst, initConsentFirstAsync } from './index.cjs';

package/dist/react-native.d.ts

@@ -1 +1 @@
-export { AnalyticsClient, AnalyticsClientOptions, AnalyticsConsentState, AnalyticsContext, AnalyticsContextConsentControls, AnalyticsContextUserControls, AnalyticsIngestError, AnalyticsIngestErrorHandler, AnalyticsStorageAdapter, CreateAnalyticsContextOptions, EventContext, EventProperties, IdentityTrackingMode, InitInput, InitOptions, ONBOARDING_EVENTS, ONBOARDING_PROGRESS_EVENT_ORDER, ONBOARDING_SCREEN_EVENT_PREFIXES, ONBOARDING_SURVEY_EVENTS, OnboardingEventName, OnboardingEventProperties, OnboardingStepTracker, OnboardingSurveyAnswerType, OnboardingSurveyEventName, OnboardingSurveyResponseInput, OnboardingTracker, OnboardingTrackerDefaults, OnboardingTrackerSurveyInput, PAYWALL_ANCHOR_EVENT_CANDIDATES, PAYWALL_EVENTS, PAYWALL_JOURNEY_EVENT_ORDER, PAYWALL_SKIP_EVENT_CANDIDATES, PURCHASE_EVENTS, PURCHASE_SUCCESS_EVENT_CANDIDATES, PaywallEventName, PaywallEventProperties, PaywallJourneyEventName, PaywallTracker, PaywallTrackerDefaults, PaywallTrackerProperties, PurchaseEventName, SetConsentOptions, createAnalyticsContext, init, initAsync, initConsentFirst, initConsentFirstAsync } from './index.js';
+export { AnalyticsClient, AnalyticsClientOptions, AnalyticsConsentState, AnalyticsIngestError, AnalyticsIngestErrorHandler, AnalyticsStorageAdapter, EventContext, EventProperties, IdentityTrackingMode, InitInput, InitOptions, ONBOARDING_EVENTS, ONBOARDING_PROGRESS_EVENT_ORDER, ONBOARDING_SCREEN_EVENT_PREFIXES, ONBOARDING_SURVEY_EVENTS, OnboardingEventName, OnboardingEventProperties, OnboardingStepTracker, OnboardingSurveyAnswerType, OnboardingSurveyEventName, OnboardingSurveyResponseInput, OnboardingTracker, OnboardingTrackerDefaults, OnboardingTrackerSurveyInput, PAYWALL_ANCHOR_EVENT_CANDIDATES, PAYWALL_EVENTS, PAYWALL_JOURNEY_EVENT_ORDER, PAYWALL_SKIP_EVENT_CANDIDATES, PURCHASE_EVENTS, PURCHASE_SUCCESS_EVENT_CANDIDATES, PaywallEventName, PaywallEventProperties, PaywallJourneyEventName, PaywallTracker, PaywallTrackerDefaults, PaywallTrackerProperties, PurchaseEventName, SetConsentOptions, init, initAsync, initConsentFirst, initConsentFirstAsync } from './index.js';

package/dist/react-native.js

@@ -10,12 +10,11 @@ import {
   PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_EVENTS,
   PURCHASE_SUCCESS_EVENT_CANDIDATES,
-  createAnalyticsContext,
   init,
   initAsync,
   initConsentFirst,
   initConsentFirstAsync
-} from "./chunk-6EPJZLLK.js";
+} from "./chunk-4DKQNTSO.js";
 export {
   AnalyticsClient,
   ONBOARDING_EVENTS,
@@ -28,7 +27,6 @@ export {
   PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_EVENTS,
   PURCHASE_SUCCESS_EVENT_CANDIDATES,
-  createAnalyticsContext,
   init,
   initAsync,
   initConsentFirst,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@analyticscli/sdk",
-  "version": "0.1.0-preview.10",
+  "version": "0.1.0-preview.12",
   "description": "TypeScript SDK for sending onboarding, paywall, purchase and survey analytics events to AnalyticsCLI.",
   "license": "MIT",
   "type": "module",