@analyticscli/sdk 0.1.0-preview.5 → 0.1.0-preview.7

package/dist/{chunk-HL2VOD3Z.js → chunk-O4FIH647.js}

@@ -196,7 +196,28 @@ var randomId = () => {
   if (globalThis.crypto?.randomUUID) {
     return globalThis.crypto.randomUUID();
   }
-  return `${Date.now()}-${Math.random().toString(16).slice(2, 12)}`;
+  const bytes = new Uint8Array(16);
+  if (globalThis.crypto?.getRandomValues) {
+    globalThis.crypto.getRandomValues(bytes);
+  } else {
+    for (let index = 0; index < bytes.length; index += 1) {
+      bytes[index] = Math.floor(Math.random() * 256);
+    }
+  }
+  const byte6 = bytes[6] ?? 0;
+  const byte8 = bytes[8] ?? 0;
+  bytes[6] = byte6 & 15 | 64;
+  bytes[8] = byte8 & 63 | 128;
+  let output = "";
+  for (let index = 0; index < bytes.length; index += 1) {
+    const byte = bytes[index] ?? 0;
+    const hex = byte.toString(16).padStart(2, "0");
+    output += hex;
+    if (index === 3 || index === 5 || index === 7 || index === 9) {
+      output += "-";
+    }
+  }
+  return output;
 };
 var readStorageSync = (storage, key) => {
   if (!storage) {
@@ -1557,75 +1578,78 @@ var AnalyticsClient = class {
   }
 };
 
-// src/bootstrap.ts
-var DEFAULT_API_KEY_ENV_KEYS = [
-  "ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "NEXT_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "EXPO_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "VITE_ANALYTICSCLI_PUBLISHABLE_API_KEY"
-];
-var readTrimmedString2 = (value) => {
-  if (typeof value === "string") {
-    return value.trim();
-  }
-  if (typeof value === "number" || typeof value === "boolean") {
-    return String(value).trim();
-  }
-  return "";
-};
-var resolveDefaultEnv = () => {
-  const withProcess = globalThis;
-  if (typeof withProcess.process?.env === "object" && withProcess.process.env !== null) {
-    return withProcess.process.env;
+// src/context.ts
+var normalizeInitInput = (input) => {
+  if (typeof input === "string") {
+    return { apiKey: input };
   }
-  return {};
-};
-var resolveValueFromEnv = (env, keys) => {
-  for (const key of keys) {
-    const value = readTrimmedString2(env[key]);
-    if (value.length > 0) {
-      return value;
-    }
+  if (input === null || input === void 0) {
+    return {};
   }
-  return "";
+  return input;
 };
-var toMissingMessage = (details) => {
-  const parts = [];
-  if (details.missingApiKey) {
-    parts.push(`apiKey (searched: ${details.searchedApiKeyEnvKeys.join(", ") || "none"})`);
+var resolveClient = (input) => {
+  if (input instanceof AnalyticsClient) {
+    return input;
   }
-  return `[analyticscli-sdk] Missing required configuration: ${parts.join("; ")}.`;
+  return new AnalyticsClient(normalizeInitInput(input ?? {}));
 };
-var initFromEnv = (options = {}) => {
-  const {
-    env,
-    apiKey,
-    apiKeyEnvKeys,
-    missingConfigMode = "noop",
-    onMissingConfig,
-    ...clientOptions
-  } = options;
-  const resolvedApiKeyEnvKeys = [...apiKeyEnvKeys ?? DEFAULT_API_KEY_ENV_KEYS];
-  const envSource = env ?? resolveDefaultEnv();
-  const resolvedApiKey = readTrimmedString2(apiKey) || resolveValueFromEnv(envSource, resolvedApiKeyEnvKeys);
-  const missingConfig = {
-    missingApiKey: resolvedApiKey.length === 0,
-    searchedApiKeyEnvKeys: resolvedApiKeyEnvKeys
+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()
   };
-  if (missingConfig.missingApiKey) {
-    onMissingConfig?.(missingConfig);
-    if (missingConfigMode === "throw") {
-      throw new Error(toMissingMessage(missingConfig));
-    }
-  }
-  return new AnalyticsClient({
-    ...clientOptions,
-    apiKey: resolvedApiKey
-  });
 };
 
 // src/index.ts
-var normalizeInitInput = (input) => {
+var normalizeInitInput2 = (input) => {
   if (typeof input === "string") {
     return { apiKey: input };
   }
@@ -1635,17 +1659,17 @@ var normalizeInitInput = (input) => {
   return input;
 };
 var init = (input = {}) => {
-  return new AnalyticsClient(normalizeInitInput(input));
+  return new AnalyticsClient(normalizeInitInput2(input));
 };
 var initConsentFirst = (input = {}) => {
-  const normalized = normalizeInitInput(input);
+  const normalized = normalizeInitInput2(input);
   return new AnalyticsClient({
     ...normalized,
     initialConsentGranted: false
   });
 };
 var initAsync = async (input = {}) => {
-  const client = new AnalyticsClient(normalizeInitInput(input));
+  const client = new AnalyticsClient(normalizeInitInput2(input));
   await client.ready();
   return client;
 };
@@ -1654,31 +1678,6 @@ var initConsentFirstAsync = async (input = {}) => {
   await client.ready();
   return client;
 };
-var BROWSER_API_KEY_ENV_KEYS = [
-  "ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "NEXT_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "VITE_ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "EXPO_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY"
-];
-var REACT_NATIVE_API_KEY_ENV_KEYS = [
-  "ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "EXPO_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY"
-];
-var initBrowserFromEnv = (options = {}) => {
-  const { apiKeyEnvKeys, ...rest } = options;
-  return initFromEnv({
-    ...rest,
-    apiKeyEnvKeys: [...apiKeyEnvKeys ?? BROWSER_API_KEY_ENV_KEYS]
-  });
-};
-var initReactNativeFromEnv = (options = {}) => {
-  const { apiKeyEnvKeys, ...rest } = options;
-  return initFromEnv({
-    ...rest,
-    apiKeyEnvKeys: [...apiKeyEnvKeys ?? REACT_NATIVE_API_KEY_ENV_KEYS]
-  });
-};
 
 export {
   ONBOARDING_EVENTS,
@@ -1692,14 +1691,9 @@ export {
   PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_SUCCESS_EVENT_CANDIDATES,
   AnalyticsClient,
-  DEFAULT_API_KEY_ENV_KEYS,
-  initFromEnv,
+  createAnalyticsContext,
   init,
   initConsentFirst,
   initAsync,
-  initConsentFirstAsync,
-  BROWSER_API_KEY_ENV_KEYS,
-  REACT_NATIVE_API_KEY_ENV_KEYS,
-  initBrowserFromEnv,
-  initReactNativeFromEnv
+  initConsentFirstAsync
 };

package/dist/index.cjs

@@ -21,8 +21,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AnalyticsClient: () => AnalyticsClient,
-  BROWSER_API_KEY_ENV_KEYS: () => BROWSER_API_KEY_ENV_KEYS,
-  DEFAULT_API_KEY_ENV_KEYS: () => DEFAULT_API_KEY_ENV_KEYS,
   ONBOARDING_EVENTS: () => ONBOARDING_EVENTS,
   ONBOARDING_PROGRESS_EVENT_ORDER: () => ONBOARDING_PROGRESS_EVENT_ORDER,
   ONBOARDING_SCREEN_EVENT_PREFIXES: () => ONBOARDING_SCREEN_EVENT_PREFIXES,
@@ -33,14 +31,11 @@ __export(index_exports, {
   PAYWALL_SKIP_EVENT_CANDIDATES: () => PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_EVENTS: () => PURCHASE_EVENTS,
   PURCHASE_SUCCESS_EVENT_CANDIDATES: () => PURCHASE_SUCCESS_EVENT_CANDIDATES,
-  REACT_NATIVE_API_KEY_ENV_KEYS: () => REACT_NATIVE_API_KEY_ENV_KEYS,
+  createAnalyticsContext: () => createAnalyticsContext,
   init: () => init,
   initAsync: () => initAsync,
-  initBrowserFromEnv: () => initBrowserFromEnv,
   initConsentFirst: () => initConsentFirst,
-  initConsentFirstAsync: () => initConsentFirstAsync,
-  initFromEnv: () => initFromEnv,
-  initReactNativeFromEnv: () => initReactNativeFromEnv
+  initConsentFirstAsync: () => initConsentFirstAsync
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -242,7 +237,28 @@ var randomId = () => {
   if (globalThis.crypto?.randomUUID) {
     return globalThis.crypto.randomUUID();
   }
-  return `${Date.now()}-${Math.random().toString(16).slice(2, 12)}`;
+  const bytes = new Uint8Array(16);
+  if (globalThis.crypto?.getRandomValues) {
+    globalThis.crypto.getRandomValues(bytes);
+  } else {
+    for (let index = 0; index < bytes.length; index += 1) {
+      bytes[index] = Math.floor(Math.random() * 256);
+    }
+  }
+  const byte6 = bytes[6] ?? 0;
+  const byte8 = bytes[8] ?? 0;
+  bytes[6] = byte6 & 15 | 64;
+  bytes[8] = byte8 & 63 | 128;
+  let output = "";
+  for (let index = 0; index < bytes.length; index += 1) {
+    const byte = bytes[index] ?? 0;
+    const hex = byte.toString(16).padStart(2, "0");
+    output += hex;
+    if (index === 3 || index === 5 || index === 7 || index === 9) {
+      output += "-";
+    }
+  }
+  return output;
 };
 var readStorageSync = (storage, key) => {
   if (!storage) {
@@ -1603,75 +1619,78 @@ var AnalyticsClient = class {
   }
 };
 
-// src/bootstrap.ts
-var DEFAULT_API_KEY_ENV_KEYS = [
-  "ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "NEXT_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "EXPO_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "VITE_ANALYTICSCLI_PUBLISHABLE_API_KEY"
-];
-var readTrimmedString2 = (value) => {
-  if (typeof value === "string") {
-    return value.trim();
-  }
-  if (typeof value === "number" || typeof value === "boolean") {
-    return String(value).trim();
-  }
-  return "";
-};
-var resolveDefaultEnv = () => {
-  const withProcess = globalThis;
-  if (typeof withProcess.process?.env === "object" && withProcess.process.env !== null) {
-    return withProcess.process.env;
+// src/context.ts
+var normalizeInitInput = (input) => {
+  if (typeof input === "string") {
+    return { apiKey: input };
   }
-  return {};
-};
-var resolveValueFromEnv = (env, keys) => {
-  for (const key of keys) {
-    const value = readTrimmedString2(env[key]);
-    if (value.length > 0) {
-      return value;
-    }
+  if (input === null || input === void 0) {
+    return {};
   }
-  return "";
+  return input;
 };
-var toMissingMessage = (details) => {
-  const parts = [];
-  if (details.missingApiKey) {
-    parts.push(`apiKey (searched: ${details.searchedApiKeyEnvKeys.join(", ") || "none"})`);
+var resolveClient = (input) => {
+  if (input instanceof AnalyticsClient) {
+    return input;
   }
-  return `[analyticscli-sdk] Missing required configuration: ${parts.join("; ")}.`;
+  return new AnalyticsClient(normalizeInitInput(input ?? {}));
 };
-var initFromEnv = (options = {}) => {
-  const {
-    env,
-    apiKey,
-    apiKeyEnvKeys,
-    missingConfigMode = "noop",
-    onMissingConfig,
-    ...clientOptions
-  } = options;
-  const resolvedApiKeyEnvKeys = [...apiKeyEnvKeys ?? DEFAULT_API_KEY_ENV_KEYS];
-  const envSource = env ?? resolveDefaultEnv();
-  const resolvedApiKey = readTrimmedString2(apiKey) || resolveValueFromEnv(envSource, resolvedApiKeyEnvKeys);
-  const missingConfig = {
-    missingApiKey: resolvedApiKey.length === 0,
-    searchedApiKeyEnvKeys: resolvedApiKeyEnvKeys
+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()
   };
-  if (missingConfig.missingApiKey) {
-    onMissingConfig?.(missingConfig);
-    if (missingConfigMode === "throw") {
-      throw new Error(toMissingMessage(missingConfig));
-    }
-  }
-  return new AnalyticsClient({
-    ...clientOptions,
-    apiKey: resolvedApiKey
-  });
 };
 
 // src/index.ts
-var normalizeInitInput = (input) => {
+var normalizeInitInput2 = (input) => {
   if (typeof input === "string") {
     return { apiKey: input };
   }
@@ -1681,17 +1700,17 @@ var normalizeInitInput = (input) => {
   return input;
 };
 var init = (input = {}) => {
-  return new AnalyticsClient(normalizeInitInput(input));
+  return new AnalyticsClient(normalizeInitInput2(input));
 };
 var initConsentFirst = (input = {}) => {
-  const normalized = normalizeInitInput(input);
+  const normalized = normalizeInitInput2(input);
   return new AnalyticsClient({
     ...normalized,
     initialConsentGranted: false
   });
 };
 var initAsync = async (input = {}) => {
-  const client = new AnalyticsClient(normalizeInitInput(input));
+  const client = new AnalyticsClient(normalizeInitInput2(input));
   await client.ready();
   return client;
 };
@@ -1700,36 +1719,9 @@ var initConsentFirstAsync = async (input = {}) => {
   await client.ready();
   return client;
 };
-var BROWSER_API_KEY_ENV_KEYS = [
-  "ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "NEXT_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "VITE_ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "EXPO_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY"
-];
-var REACT_NATIVE_API_KEY_ENV_KEYS = [
-  "ANALYTICSCLI_PUBLISHABLE_API_KEY",
-  "EXPO_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY"
-];
-var initBrowserFromEnv = (options = {}) => {
-  const { apiKeyEnvKeys, ...rest } = options;
-  return initFromEnv({
-    ...rest,
-    apiKeyEnvKeys: [...apiKeyEnvKeys ?? BROWSER_API_KEY_ENV_KEYS]
-  });
-};
-var initReactNativeFromEnv = (options = {}) => {
-  const { apiKeyEnvKeys, ...rest } = options;
-  return initFromEnv({
-    ...rest,
-    apiKeyEnvKeys: [...apiKeyEnvKeys ?? REACT_NATIVE_API_KEY_ENV_KEYS]
-  });
-};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AnalyticsClient,
-  BROWSER_API_KEY_ENV_KEYS,
-  DEFAULT_API_KEY_ENV_KEYS,
   ONBOARDING_EVENTS,
   ONBOARDING_PROGRESS_EVENT_ORDER,
   ONBOARDING_SCREEN_EVENT_PREFIXES,
@@ -1740,12 +1732,9 @@ var initReactNativeFromEnv = (options = {}) => {
   PAYWALL_SKIP_EVENT_CANDIDATES,
   PURCHASE_EVENTS,
   PURCHASE_SUCCESS_EVENT_CANDIDATES,
-  REACT_NATIVE_API_KEY_ENV_KEYS,
+  createAnalyticsContext,
   init,
   initAsync,
-  initBrowserFromEnv,
   initConsentFirst,
-  initConsentFirstAsync,
-  initFromEnv,
-  initReactNativeFromEnv
+  initConsentFirstAsync
 });

package/dist/index.d.cts

@@ -236,36 +236,6 @@ type AnalyticsClientOptions = {
     useCookieStorage?: boolean | null;
 };
 type InitOptions = AnalyticsClientOptions;
-type InitFromEnvMissingConfigMode = 'noop' | 'throw';
-type InitFromEnvMissingConfig = {
-    missingApiKey: boolean;
-    searchedApiKeyEnvKeys: string[];
-};
-type InitFromEnvOptions = Omit<AnalyticsClientOptions, 'apiKey'> & {
-    /**
-     * Optional environment-like object.
-     * Defaults to `globalThis.process?.env` when available.
-     */
-    env?: Record<string, unknown> | null;
-    /**
-     * Explicit api key override.
-     */
-    apiKey?: string | null;
-    /**
-     * Candidate env keys resolved in order.
-     */
-    apiKeyEnvKeys?: string[] | null;
-    /**
-     * How missing config is handled.
-     * - `noop` (default): returns a safe no-op client
-     * - `throw`: throws when required config is missing
-     */
-    missingConfigMode?: InitFromEnvMissingConfigMode | null;
-    /**
-     * Optional callback for custom logging when config is missing.
-     */
-    onMissingConfig?: ((details: InitFromEnvMissingConfig) => void) | null;
-};
 type InitInput = InitOptions | string | null | undefined;
 
 declare class AnalyticsClient {
@@ -445,12 +415,64 @@ declare class AnalyticsClient {
     private reportMissingApiKey;
 }
 
-declare const DEFAULT_API_KEY_ENV_KEYS: readonly ["ANALYTICSCLI_PUBLISHABLE_API_KEY", "NEXT_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY", "EXPO_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY", "VITE_ANALYTICSCLI_PUBLISHABLE_API_KEY"];
+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;
+};
 /**
- * Minimal host-app bootstrap helper.
- * Resolves `apiKey` (required) from explicit options or env-like objects.
+ * 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 initFromEnv: (options?: InitFromEnvOptions) => AnalyticsClient;
+declare const createAnalyticsContext: (options?: CreateAnalyticsContextOptions) => AnalyticsContext;
 
 /**
  * Creates a browser analytics client instance.
@@ -466,23 +488,5 @@ declare const initConsentFirst: (input?: InitInput) => AnalyticsClient;
  */
 declare const initAsync: (input?: InitInput) => Promise<AnalyticsClient>;
 declare const initConsentFirstAsync: (input?: InitInput) => Promise<AnalyticsClient>;
-declare const BROWSER_API_KEY_ENV_KEYS: readonly ["ANALYTICSCLI_PUBLISHABLE_API_KEY", "NEXT_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY", "PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY", "VITE_ANALYTICSCLI_PUBLISHABLE_API_KEY", "EXPO_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY"];
-declare const REACT_NATIVE_API_KEY_ENV_KEYS: readonly ["ANALYTICSCLI_PUBLISHABLE_API_KEY", "EXPO_PUBLIC_ANALYTICSCLI_PUBLISHABLE_API_KEY"];
-type BrowserInitFromEnvOptions = Omit<InitFromEnvOptions, 'apiKeyEnvKeys'> & {
-    apiKeyEnvKeys?: readonly string[];
-};
-type ReactNativeInitFromEnvOptions = Omit<InitFromEnvOptions, 'apiKeyEnvKeys'> & {
-    apiKeyEnvKeys?: readonly string[];
-};
-/**
- * Browser-focused env bootstrap.
- * Supports common env prefixes across Next.js, Astro/Vite and Expo web.
- */
-declare const initBrowserFromEnv: (options?: BrowserInitFromEnvOptions) => AnalyticsClient;
-/**
- * React Native-focused env bootstrap.
- * Defaults to native-friendly env keys while still allowing explicit overrides.
- */
-declare const initReactNativeFromEnv: (options?: ReactNativeInitFromEnvOptions) => AnalyticsClient;
 
-export { AnalyticsClient, type AnalyticsClientOptions, type AnalyticsConsentState, type AnalyticsStorageAdapter, BROWSER_API_KEY_ENV_KEYS, type BrowserInitFromEnvOptions, DEFAULT_API_KEY_ENV_KEYS, type EventContext, type EventProperties, type IdentityTrackingMode, type InitFromEnvMissingConfig, type InitFromEnvMissingConfigMode, type InitFromEnvOptions, 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, REACT_NATIVE_API_KEY_ENV_KEYS, type ReactNativeInitFromEnvOptions, type SetConsentOptions, init, initAsync, initBrowserFromEnv, initConsentFirst, initConsentFirstAsync, initFromEnv, initReactNativeFromEnv };
+export { AnalyticsClient, type AnalyticsClientOptions, type AnalyticsConsentState, type AnalyticsContext, type AnalyticsContextConsentControls, type AnalyticsContextUserControls, 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 };