// 1. Anonymous: start() identifies the device without a user id.
await client.start();

// 2. After sign-in: link the install to your user id.
await client.setUserId(userId);

// 3. Send traits for targeting (consent omitted = unchanged).
await client.identify({ traits: { plan_tier: 'gold' } });

import { useEffect } from 'react';
import { useCF } from '@contentflow/sdk/react';

// 1. Anonymous: <CFProvider> calls start(), which identifies the device without a user id.

function AfterSignIn({ userId }: { userId: string }) {
  const cf = useCF();
  useEffect(() => {
    void (async () => {
      // 2. After sign-in: link the install to your user id.
      await cf.setUserId(userId);
      // 3. Send traits for targeting (consent omitted = unchanged).
      await cf.identify({ traits: { plan_tier: 'gold' } });
    })();
  }, [cf, userId]);
  return null;
}

import { useEffect } from 'react';
import { useCF } from '@contentflow/sdk/react-native';

// 1. Anonymous: <CFProvider> calls start(), which identifies the device without a user id.

function AfterSignIn({ userId }: { userId: string }) {
  const cf = useCF();
  useEffect(() => {
    void (async () => {
      // 2. After sign-in: link the install to your user id.
      await cf.setUserId(userId);
      // 3. Send traits for targeting (consent omitted = unchanged).
      await cf.identify({ traits: { plan_tier: 'gold' } });
    })();
  }, [cf, userId]);
  return null;
}

// 1. Anonymous: Swift registers the device on the first identify or sync.
try await client.identify(userId: nil)

// 2 and 3. After sign-in: link the install to your user id and send traits.
//    A non-empty traits set replaces the stored one.
try await client.identify(userId: userId, traits: ["plan_tier": "gold"])

// 1. Anonymous: start() identifies the device without a user id.
client.start()

// 2 and 3. After sign-in, from a coroutine: link the install and send traits.
//    A non-empty traits map replaces the stored one.
client.identify(userId, mapOf("plan_tier" to JsonValue.of("gold")))

// 1. Anonymous: ContentFlow.create() identifies the device without a user id.
await ContentFlow.create(const ContentFlowConfig(publicKey: CONTENTFLOW_SDK_KEY));
final cf = ContentFlow.instance;

// 2. After sign-in: link the install to your user id.
await cf.setUserId(userId);

// 3. Send traits for targeting.
await cf.identify(userId: userId, traits: {'plan_tier': 'gold'});

# 1. Anonymous: identify with the device id only.
curl -X POST https://api.contentflow.click/sdk/v1/identify \
  -H "X-CF-Key: $CF_SDK_KEY" -H "X-CF-Device: $CF_DEVICE" -H 'Content-Type: application/json' \
  -d "{\"deviceId\":\"$CF_DEVICE\"}"

# 2 and 3. After sign-in: the same call with your user id and traits.
curl -X POST https://api.contentflow.click/sdk/v1/identify \
  -H "X-CF-Key: $CF_SDK_KEY" -H "X-CF-Device: $CF_DEVICE" -H 'Content-Type: application/json' \
  -d "{\"deviceId\":\"$CF_DEVICE\",\"userId\":\"cust_123\",\"traits\":{\"plan_tier\":\"gold\"}}"

// 1. Analytics consent, from the person's choice.
await client.setConsent(userAcceptedAnalytics);

// 2. Signed in: identify as the user first (see above).
await client.setUserId(userId);

// 3. Channel consent, independent of analytics consent.
//    With a user id it is stored on the profile; without one, on this device only.
await client.setChannelConsent(userId, { push: true, sms: false });

import { useCF } from '@contentflow/sdk/react';

function ConsentForm({ userId }: { userId: string }) {
  const cf = useCF();
  async function save(userAcceptedAnalytics: boolean) {
    // 1. Analytics consent, from the person's choice.
    await cf.setConsent(userAcceptedAnalytics);
    // 2. Signed in: identify as the user first (see above).
    await cf.setUserId(userId);
    // 3. Channel consent, independent of analytics consent.
    //    With a user id it is stored on the profile; without one, on this device only.
    await cf.setChannelConsent(userId, { push: true, sms: false });
  }
  return <button onClick={() => save(true)}>Save choices</button>;
}

import { Button } from 'react-native';
import { useCF } from '@contentflow/sdk/react-native';

function ConsentForm({ userId }: { userId: string }) {
  const cf = useCF();
  async function save(userAcceptedAnalytics: boolean) {
    // 1. Analytics consent, from the person's choice.
    await cf.setConsent(userAcceptedAnalytics);
    // 2. Signed in: identify as the user first (see above).
    await cf.setUserId(userId);
    // 3. Channel consent, independent of analytics consent.
    //    With a user id it is stored on the profile; without one, on this device only.
    await cf.setChannelConsent(userId, { push: true, sms: false });
  }
  return <Button title="Save choices" onPress={() => save(true)} />;
}

// 1. Analytics consent, from the person's choice.
try await client.setAnalyticsConsent(.granted)

// 2. Signed in: identify as the user first (see above).
try await client.identify(userId: userId)

// 3. Channel consent, one channel per call. Sent with the linked user when
//    the client is identified, otherwise stored for this device only.
try await client.setChannelConsent(.granted, for: .push)
try await client.setChannelConsent(.denied, for: .sms)

// 1. Analytics consent, from the person's choice.
client.setAnalyticsConsent(ConsentStatus.Granted)

// 2. Signed in: identify as the user first (see above).
client.identify(userId)

// 3. Channel consent, one channel per call.
//    Kotlin requires an identified user: otherwise this throws InvalidConfiguration.
client.setChannelConsent(ConsentChannel.Push, ConsentStatus.Granted)
client.setChannelConsent(ConsentChannel.Sms, ConsentStatus.Denied)

final cf = ContentFlow.instance;

// 1. Analytics consent, from the person's choice.
await cf.setConsent(true);

// 2. Signed in: identify as the user first, or step 3 throws StateError.
await cf.setUserId(userId);

// 3. Channel consent. Every channel is sent: a flag you leave out is sent as false,
//    and locationTracking: false also stops location collection on the device.
await cf.setChannelConsent(userId, const CFChannelConsent(push: true, sms: false));

# 1 and 2. Identify as the user, with the analytics decision.
curl -X POST https://api.contentflow.click/sdk/v1/identify \
  -H "X-CF-Key: $CF_SDK_KEY" -H "X-CF-Device: $CF_DEVICE" -H 'Content-Type: application/json' \
  -d "{\"deviceId\":\"$CF_DEVICE\",\"userId\":\"cust_123\",\"consent\":true}"

# 3. Channel consent: flags must be nested under channels.
#    The user is sent as username; userId is accepted as an alias (username wins if both are sent).
curl -X POST https://api.contentflow.click/sdk/v1/consent \
  -H "X-CF-Key: $CF_SDK_KEY" -H "X-CF-Device: $CF_DEVICE" -H 'Content-Type: application/json' \
  -d "{\"deviceId\":\"$CF_DEVICE\",\"username\":\"cust_123\",\"channels\":{\"push\":true,\"sms\":false}}"

import { consentPathsToConfig } from '@contentflow/sdk/web';

// 1. Read the preset to build your consent screen.
//    preset.required / preset.optional are paths such as 'channels.push' or 'marketing.promotional'.
const preset = await client.getConsentConfig('banking_ksa');

// 2. Record what the person accepted, against the preset.
await client.requestConsent({ preset: preset.preset, ...consentPathsToConfig(userAcceptedPaths) });

import { useEffect, useState } from 'react';
import { useCF, consentPathsToConfig, type ConsentPreset } from '@contentflow/sdk/react';

function ConsentScreen({ userAcceptedPaths }: { userAcceptedPaths: string[] }) {
  const cf = useCF();
  const [preset, setPreset] = useState<ConsentPreset | null>(null);

  // 1. Read the preset to build your consent screen.
  //    preset.required / preset.optional are paths such as 'channels.push' or 'marketing.promotional';
  //    preset.availableTopics lists the push topics.
  useEffect(() => { void cf.getConsentConfig('banking_ksa').then(setPreset); }, [cf]);

  // 2. Record what the person accepted, against the preset.
  async function accept() {
    if (!preset) return;
    await cf.requestConsent({ preset: preset.preset, ...consentPathsToConfig(userAcceptedPaths) });
  }
  return <button disabled={!preset} onClick={accept}>Accept</button>;
}

import { useEffect, useState } from 'react';
import { Button } from 'react-native';
import { useCF, consentPathsToConfig, type ConsentPreset } from '@contentflow/sdk/react-native';

function ConsentScreen({ userAcceptedPaths }: { userAcceptedPaths: string[] }) {
  const cf = useCF();
  const [preset, setPreset] = useState<ConsentPreset | null>(null);

  // 1. Read the preset to build your consent screen.
  //    preset.required / preset.optional are paths such as 'channels.push' or 'marketing.promotional';
  //    preset.availableTopics lists the push topics.
  useEffect(() => { void cf.getConsentConfig('banking_ksa').then(setPreset); }, [cf]);

  // 2. Record what the person accepted, against the preset.
  async function accept() {
    if (!preset) return;
    await cf.requestConsent({ preset: preset.preset, ...consentPathsToConfig(userAcceptedPaths) });
  }
  return <Button title="Accept" disabled={!preset} onPress={accept} />;
}

// 1. Read the preset to build your consent screen.
let preset = try await client.getConsentConfig(preset: "banking_ksa")

// 2. Record what the person accepted, against the preset.
try await client.requestConsent(options: ConsentRequestOptions(
    preset: "banking_ksa",
    channels: .init(push: true, sms: false)))

// 1. Read the preset to build your consent screen (presets live on client.extensions).
val preset = client.extensions.getConsentConfig("banking_ksa")

// 2. Record what the person accepted, against the preset.
client.extensions.requestConsent(ConsentRequestOptions(
    preset = "banking_ksa",
    channels = FullConsentConfig.ChannelConsent(push = true, sms = false),
))

final cf = ContentFlow.instance;

// 1. Read the preset to build your consent screen. Returns null if the request fails.
final preset = await cf.getConsentConfig('banking_ksa');

// 2. Record what the person accepted, against the preset.
//    Every channel is sent: a flag you leave out is sent as false.
await cf.requestConsent(preset: 'banking_ksa', channels: const CFChannelConsent(push: true, sms: false));

# 1. Read the preset: the key alone, no device header needed.
curl https://api.contentflow.click/sdk/v1/consent/config/banking_ksa -H "X-CF-Key: $CF_SDK_KEY"

# 2. Record what the person accepted: channels, marketing and topics in one write.
curl -X POST https://api.contentflow.click/sdk/v1/consent/full \
  -H "X-CF-Key: $CF_SDK_KEY" -H "X-CF-Device: $CF_DEVICE" -H 'Content-Type: application/json' \
  -d "{\"deviceId\":\"$CF_DEVICE\",\"preset\":\"banking_ksa\",\"channels\":{\"push\":true,\"sms\":false}}"

// 1. On sign-out: unlink the user and remove the push token.
//    A 207 PUSH_LINKAGE_INCOMPLETE throws a partial-write error: retry logout.
await client.logout();

import { useCF } from '@contentflow/sdk/react';

function SignOutButton() {
  const cf = useCF();
  // 1. On sign-out: unlink the user and remove the push token.
  //    A 207 PUSH_LINKAGE_INCOMPLETE throws a partial-write error: retry logout.
  return <button onClick={() => cf.logout()}>Sign out</button>;
}

import { Button } from 'react-native';
import { useCF } from '@contentflow/sdk/react-native';

function SignOutButton() {
  const cf = useCF();
  // 1. On sign-out: unlink the user and remove the push token.
  //    A 207 PUSH_LINKAGE_INCOMPLETE throws a partial-write error: retry logout.
  return <Button title="Sign out" onPress={() => cf.logout()} />;
}

// 1. On sign-out: unlink the user and remove the push token.
//    A partial push clear throws partialLogout: retry logout.
try await client.logout()

// 1. On sign-out, from a coroutine: unlink the user and remove the push token.
client.logout()

final cf = ContentFlow.instance;

// 1. On sign-out: unlink the user and remove the push token.
//    Throws on failure and leaves local state unchanged, so retry.
await cf.logout();

# 1. On sign-out: unlink the user and remove the push token.
curl -X POST https://api.contentflow.click/sdk/v1/logout \
  -H "X-CF-Key: $CF_SDK_KEY" -H "X-CF-Device: $CF_DEVICE" -H 'Content-Type: application/json' \
  -d "{\"deviceId\":\"$CF_DEVICE\"}"

// 1. Erase this device and its linked user's data.
//    Throws unless the server confirms a complete erasure; retry on failure.
await client.deleteIdentity();

// 2. On success the client is disposed: create a new one (new device id) if the app continues.

import { useState } from 'react';
import { CFProvider, useCF } from '@contentflow/sdk/react';

function EraseButton({ onErased }: { onErased: () => void }) {
  const cf = useCF();
  async function erase() {
    // 1. Erase this device and its linked user's data.
    //    Throws unless the server confirms a complete erasure; retry on failure.
    await cf.deleteIdentity();
    onErased();
  }
  return <button onClick={erase}>Delete my data</button>;
}

export function App() {
  // 2. On success the client is disposed: a new key remounts CFProvider with a new client (new device id).
  const [session, setSession] = useState(0);
  return (
    <CFProvider key={session} config={{ publicKey: CONTENTFLOW_SDK_KEY }}>
      <EraseButton onErased={() => setSession((n) => n + 1)} />
    </CFProvider>
  );
}

import { useState } from 'react';
import { Button } from 'react-native';
import { CFProvider, useCF } from '@contentflow/sdk/react-native';

function EraseButton({ onErased }: { onErased: () => void }) {
  const cf = useCF();
  async function erase() {
    // 1. Erase this device and its linked user's data.
    //    Throws unless the server confirms a complete erasure; retry on failure.
    await cf.deleteIdentity();
    onErased();
  }
  return <Button title="Delete my data" onPress={erase} />;
}

export function App() {
  // 2. On success the client is disposed: a new key remounts CFProvider with a new client (new device id).
  const [session, setSession] = useState(0);
  return (
    <CFProvider key={session} config={{ publicKey: CONTENTFLOW_SDK_KEY }}>
      <EraseButton onErased={() => setSession((n) => n + 1)} />
    </CFProvider>
  );
}

// 1. Erase this device and its linked user's data.
//    Throws when the server cannot confirm the erasure; retry on failure.
try await client.deleteIdentity()

// 2. On success, local identity, consent and cache are cleared.

// 1. Erase this device and its linked user's data.
//    Throws if the server cannot confirm the erasure; retry on failure.
client.deleteIdentity()

// 2. On success, local identity, cached segments and cached content are cleared.

final cf = ContentFlow.instance;

// 1. Erase this device and its linked user's data.
//    Throws (CFRequestException on a partial erasure) unless the server
//    confirms a complete erasure; local state is kept, so retry.
await cf.deleteIdentity();

// 2. On success, local data is cleared and the SDK starts over with a new device id.

# 1. Erase everything the device id addresses. The device id is read only from X-CF-Device.
curl -X DELETE https://api.contentflow.click/sdk/v1/identify \
  -H "X-CF-Key: $CF_SDK_KEY" -H "X-CF-Device: $CF_DEVICE"

# 2. Clear the device id on the client only after a 200; otherwise retry with the same id.