// Run in CI or on your server (Node 18+), never in an app.
// `client` is your ContentFlow client (createCFClient, or the ContentFlow facade after ContentFlow.init).
// A CI job without one can send the same request with the REST tab (one curl).

// 1. Send each key with its source text (and a note for translators).
const result = await client.registerStrings(
  [
    { key: 'home.welcome', defaultValue: 'Welcome back', context: 'Home screen heading' },
    { key: 'offer.apply_cta', defaultValue: 'Apply now' },
  ],
  { writeKey: process.env.CF_WRITE_KEY! },
);

// 2. Keys created, keys changed, keys sent but neither created nor changed.
console.log(result.registered, result.updated, result.skipped);

// Run from a build tool or backend, never in the shipped app.
// The SDK logs a warning whenever this is called.

// 1. Send each key with its source text (and a note for translators).
let result = try await client.registerStrings(
    [
        StringRegistration(key: "home.welcome", defaultValue: "Welcome back", context: "Home screen heading"),
        StringRegistration(key: "offer.apply_cta", defaultValue: "Apply now"),
    ],
    writeKey: ProcessInfo.processInfo.environment["CF_WRITE_KEY"]!
)

// 2. Keys created, keys changed, keys sent but neither created nor changed.
print(result.registered, result.updated, result.skipped)

// Run from a JVM CI tool or server (a client from ContentFlowClientFactory), never in an app.
// On Android the SDK logs a one-time warning when this is called.

// 1. Send each key with its source text (and a note for translators).
val result = client.extensions.registerStrings(
    listOf(
        StringRegistration(key = "home.welcome", defaultValue = "Welcome back", context = "Home screen heading"),
        StringRegistration(key = "offer.apply_cta", defaultValue = "Apply now"),
    ),
    writeKey = System.getenv("CF_WRITE_KEY"),
)

// 2. Keys created, keys changed, keys sent but neither created nor changed.
println("${result.registered} ${result.updated} ${result.skipped}")

// The Flutter SDK needs a running Flutter app, so from CI use the REST tab.
// From an internal Flutter tool (never a store build):
final cf = ContentFlow.instance;

// 1. Send each key with its source text (and a note for translators).
final result = await cf.registerStrings([
  const CFStringRegistration(key: 'home.welcome', defaultValue: 'Welcome back', context: 'Home screen heading'),
  const CFStringRegistration(key: 'offer.apply_cta', defaultValue: 'Apply now'),
], writeKey: const String.fromEnvironment('CF_WRITE_KEY'));

// 2. Keys created, keys changed, keys sent but neither created nor changed.
print('${result.registered} ${result.updated} ${result.skipped}');

# 1. Send each key with its source text. REST also takes namespace and translations.
curl -X POST https://api.contentflow.click/api/v1/strings/sync \
  -H "X-CF-Write-Key: $CF_WRITE_KEY" -H 'Content-Type: application/json' \
  -d '{"strings":[{"key":"home.welcome","sourceText":"Welcome back","namespace":"home","description":"Home screen heading","values":{"ar":"أهلاً بعودتك"}}]}'

# 2. The answer counts created, updated, unchanged and translationsWritten,
#    and lists rejected keys and skippedLocales. Check the status AND "success".

// 1. Load the catalog for the current locale (start() also does this; ETag-cached).
await client.getStrings();          // or getStrings('home') for one namespace

// 2. Read a key: the delivered text, else your fallback, else the key itself.
title.textContent = client.t('home.welcome', 'Welcome back');

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

function Welcome() {
  // 1. The hook loads the catalog for the current locale and re-renders
  //    when it arrives or changes (useCFTranslations() returns the whole map).
  // 2. Read a key: the delivered text, else your fallback, else the key itself.
  const title = useCFString('home.welcome', 'Welcome back');
  return <h1>{title}</h1>;
}

import { Text } from 'react-native';
import { useCFString } from '@contentflow/sdk/react-native';

function Welcome() {
  // 1. The hook loads the catalog for the current locale and re-renders
  //    when it arrives or changes (useCFTranslations() returns the whole map).
  // 2. Read a key: the delivered text, else your fallback, else the key itself.
  const title = useCFString('home.welcome', 'Welcome back');
  return <Text>{title}</Text>;
}

// 1. Load the catalog for the current locale.
let strings = try await client.getStrings()

// 2. Read a key with a fallback.
titleLabel.text = strings.string("home.welcome", fallback: "Welcome back")

// 1. Load the catalog for the current locale.
val strings = client.getStrings()

// 2. Read a key with a fallback.
titleView.text = strings.value("home.welcome", "Welcome back")

final cf = ContentFlow.instance;

// 1. Load the catalog for the current locale (a key-to-text map).
final strings = await cf.getStrings();

// 2. Read a key with a fallback.
final title = strings['home.welcome'] ?? 'Welcome back';

# 1. Load the catalog for one locale (add &namespace=home for one namespace).
curl "https://api.contentflow.click/sdk/v1/strings?locale=ar" \
  -H "X-CF-Key: $CF_SDK_KEY"            # a content read: the key alone, no device id

# 2. Read the key from data.strings. Send the ETag back as If-None-Match: 304 means unchanged.

// 1. The workspace's languages (code, name, native, rtl, coverage).
const { locales } = await client.getLocales();

// 2. Switch: content and strings are fetched again for Arabic.
await client.setLocale('ar');
title.textContent = client.t('home.welcome', 'Welcome back');

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

function LanguagePicker() {
  const cf = useCF();
  const [locales, setLocales] = useState<CFLocale[]>([]);
  // 1. The workspace's languages (code, name, native, rtl, coverage).
  useEffect(() => { cf.getLocales().then((c) => setLocales(c.locales)).catch(() => undefined); }, [cf]);
  // 2. Switch: useCFString components re-render with the new catalog.
  const title = useCFString('home.welcome', 'Welcome back');
  return <><h1>{title}</h1>{locales.map((l) => <button key={l.code} onClick={() => cf.setLocale(l.code)}>{l.native ?? l.code}</button>)}</>;
}

import { useEffect, useState } from 'react';
import { Button, Text } from 'react-native';
import { useCF, useCFString, type CFLocale } from '@contentflow/sdk/react-native';

function LanguagePicker() {
  const cf = useCF();
  const [locales, setLocales] = useState<CFLocale[]>([]);
  // 1. The workspace's languages (code, name, native, rtl, coverage).
  useEffect(() => { cf.getLocales().then((c) => setLocales(c.locales)).catch(() => undefined); }, [cf]);
  // 2. Switch: useCFString components re-render with the new catalog.
  const title = useCFString('home.welcome', 'Welcome back');
  return <><Text>{title}</Text>{locales.map((l) => <Button key={l.code} title={l.native ?? l.code} onPress={() => cf.setLocale(l.code)} />)}</>;
}

// 1. The workspace's languages (code, name, native, rtl, coverage).
let catalog = try await client.getLocales()

// 2. Switch: the SDK revalidates content and strings for Arabic.
await client.setLocale(Locale(identifier: "ar"))
let strings = try await client.getStrings()

// 1. The workspace's languages (code, name, nativeName, rtl).
val locales = client.extensions.getAvailableLocales()

// 2. Switch, then load the catalog for the new language.
client.setLocale(Locale.forLanguageTag("ar"))
val strings = client.getStrings()

final cf = ContentFlow.instance;

// 1. The workspace's languages (null if the catalog could not be read).
final catalog = await cf.getLocales();

// 2. Switch (re-syncs blocks), then load the strings for the new language.
await cf.setLocale('ar');
final strings = await cf.getStrings();

// Run in CI or on your server (Node 18+), never in an app.

// 1. Stop tracking keys (1 to 500 per call; duplicates are dropped).
const { disabled, alreadyDisabled, unknown } = await client.disableStrings(
  ['legacy.promo_title', 'legacy.promo_body'],
  { writeKey: process.env.CF_WRITE_KEY! },
);

// 2. Turned off now, were already off, not in the catalog (nothing changed for those).
console.log(disabled, alreadyDisabled, unknown);

// Run from a build tool or backend, never in the shipped app.

// 1. Stop tracking keys (1 to 500 per call; duplicates are dropped).
let result = try await client.disableStrings(
    ["legacy.promo_title", "legacy.promo_body"],
    writeKey: ProcessInfo.processInfo.environment["CF_WRITE_KEY"]!
)

// 2. Turned off now, were already off, not in the catalog (nothing changed for those).
print(result.disabled, result.alreadyDisabled, result.unknown)

// Run from a JVM CI tool or server, never in an app.

// 1. Stop tracking keys (1 to 500 per call; duplicates are dropped).
val result = client.extensions.disableStrings(
    listOf("legacy.promo_title", "legacy.promo_body"),
    writeKey = System.getenv("CF_WRITE_KEY"),
)

// 2. Turned off now, were already off, not in the catalog (nothing changed for those).
println("${result.disabled} ${result.alreadyDisabled} ${result.unknown}")

// From CI use the REST tab. From an internal Flutter tool (never a store build):
final cf = ContentFlow.instance;

// 1. Stop tracking keys (1 to 500 per call; duplicates are dropped).
final result = await cf.disableStrings(
  ['legacy.promo_title', 'legacy.promo_body'],
  writeKey: const String.fromEnvironment('CF_WRITE_KEY'),
);

// 2. Turned off now, were already off, not in the catalog (nothing changed for those).
print('${result.disabled} ${result.alreadyDisabled} ${result.unknown}');

# 1. Stop tracking keys (1 to 500 distinct keys of at most 200 characters).
curl -X POST https://api.contentflow.click/api/v1/strings/disable \
  -H "X-CF-Write-Key: $CF_WRITE_KEY" -H 'Content-Type: application/json' \
  -d '{"keys":["legacy.promo_title","legacy.promo_body"]}'

# 2. data.disabled, data.alreadyDisabled, data.unknown. Check the status AND "success".