API reference

import {
  MicroSurvey,
  InsitoProvider,
  useInsito,
  useInsitoScreenTracking,
  resolveTheme,
  themePresets,
  SDK_DEFAULT_LABELS,
  resolveLabels,
} from "@insito/react-native";

import type {
  InsitoConfig,
  InsitoVariableDeclaration,
  InsitoTheme,
  IdentifyArgs,
  InsitoEvent,
  InsitoEventName,
  InsitoEventListener,
  ActiveSurvey,
  Answer,
  SurveyQuestion,
  SdkState,
  SdkLabels,
  ThemePreset,
  InsitoUser,
  ApiResponse,
  InsitoProviderProps,
  InsitoAppearance,
  SubmitResponseOptions,
  SubmitResponseResult,
} from "@insito/react-native";

MicroSurvey.init({
  apiKey: "proj_xxx",
  debug: __DEV__,
  environment: "production",
  theme: { preset: "rounded" },
});

await MicroSurvey.identify({
  userId: "auth_4f93k...",
  platform: "ios",
  appVersion: "2.7.0",
  metadata: { cohort: "beta-q2" },
  properties: {
    plan: "premium",
    transactionsThisMonth: 14,
    hasLinkedCard: true,
  },
});

void MicroSurvey.trigger("checkout_completed");

type SubmitResponseResult =
  | { status: "success"; responseId: string }
  | { status: "queued" }
  | { status: "failed"; reason: string };

const off = MicroSurvey.on("response_submitted", ({ surveyId, responseId }) => {
  analytics.track("survey_response_submitted", { surveyId, responseId });
});
// later
off();

// In your consent screen:
if (accepted) {
  await MicroSurvey.optIn();
  await MicroSurvey.identify({ userId: user.id });
} else {
  await MicroSurvey.optOut();
}

import { MicroSurvey } from "@insito/react-native";

<NavigationContainer onStateChange={MicroSurvey.onNavigationStateChange}>
  ...
</NavigationContainer>

MicroSurvey.state         // 'idle' | 'loading' | 'survey_active' | 'completed'
MicroSurvey.activeSurvey  // ActiveSurvey | null
MicroSurvey.user          // InsitoUser | null
MicroSurvey.theme         // InsitoTheme
MicroSurvey.config        // runtime API settings only, or null
MicroSurvey.consent       // 'granted' | 'denied' | 'pending'

<InsitoProvider>
  <App />
</InsitoProvider>

<InsitoProvider appearance={isDark ? "dark" : "light"}>
  <App />
</InsitoProvider>

function FeedbackButton() {
  const { sdkState } = useInsito();
  const disabled = sdkState === "loading" || sdkState === "survey_active";
  return (
    <Button
      disabled={disabled}
      onPress={() => MicroSurvey.trigger("manual_feedback")}
    />
  );
}

import { useInsitoScreenTracking } from "@insito/react-native";

export default function RootLayout() {
  useInsitoScreenTracking();
  return <Stack />;
}

interface Answer {
  questionId: string;
  type: "nps" | "rating" | "multiple_choice" | "open_text";
  value: string | number | string[];
}

type SdkState = "idle" | "loading" | "survey_active" | "completed";

type InsitoEventName =
  | "initialized"
  | "survey_shown"
  | "survey_dismissed"
  | "survey_completed"
  | "response_submitted"
  | "response_queued"
  | "response_failed"
  | "screen_tracked"
  | "screen_map_flushed"
  | "error";