configwire 0.2.0

configwire: ^0.2.0 copied to clipboard

example/main.dart

import 'dart:convert';
import 'dart:io';

import 'package:configwire/configwire.dart';

/// Caching is bring-your-own via the [CacheStore] seam. Omitting `store:`
/// uses the default session-only [MemoryCacheStore] (no disk). For disk
/// persistence, implement [CacheStore] yourself (example: [_JsonFileStore]
/// below) and pass it as `store:`.
///
/// Live mode (env vars; apiKey printed NEVER — values only):
///   CW_BASE_URL=http://127.0.0.1:8102 CW_API_KEY=`<sdk-key>` CW_ENV=dev \
///     CW_LIVE=1 dart run example/main.dart
Future<void> main() async {
  final baseUrl =
      Platform.environment['CW_BASE_URL'] ?? 'http://localhost:8090';
  final apiKey = Platform.environment['CW_API_KEY'] ?? 'demo-key';
  final env = Platform.environment['CW_ENV'] ?? 'dev';
  final live = Platform.environment['CW_LIVE'] == '1';

  final cw = ConfigWire(
    apiKey: apiKey,
    env: env,
    baseUrl: baseUrl,
    defaults: {'welcome': 'hello', 'enabled': true, 'launch_flag': false},
    // Dev smoke: no throttle so repeated runs always hit the server.
    minimumFetchInterval: Duration.zero,
  );

  // ignore: avoid_print
  print('welcome=${cw.getString('welcome')} enabled=${cw.getBool('enabled')}');

  if (live) {
    await cw.ensureInitialized();
    // Sticky targeting: sent as fetch query params (?uid=, ?platform=,
    // ?appVersion=, ?locale=, ?country=, ?attrs=) so the server can
    // evaluate `rules` per fetch. Empty fields are omitted (anonymous).
    cw.setTargeting(const Targeting(userId: 'user-7', platform: 'ios'));
    await cw.fetchAndActivate();
    // NOTE: values printed, apiKey never printed.
    // ignore: avoid_print
    print(
      'live_fetch status=${cw.lastFetchStatus} version=${cw.version} '
      'etag=${cw.etag} launch_flag=${cw.getBool('launch_flag')} '
      'welcome=${cw.getString('welcome')} variants=${cw.getVariants()}',
    );
  }
  await cw.dispose();
}

/// Pure `dart:io` + `dart:convert`, no extra dependencies. Load returns
/// null on any miss/corruption (caller falls back to defaults); save
/// overwrites the file.
// ignore: unused_element
class _JsonFileStore implements CacheStore {
  _JsonFileStore({required this.env, String? dir})
    : _file = File('${dir ?? '.configwire-cache'}/cache_$env.json');

  final String env;
  final File _file;

  @override
  Future<CacheData?> load() async {
    try {
      final raw = await _file.readAsString();
      final decoded = jsonDecode(raw);
      if (decoded is! Map) return null;
      return CacheData.fromJson(Map<String, Object?>.from(decoded));
    } catch (_) {
      return null;
    }
  }

  @override
  Future<void> save(CacheData data) async {
    await _file.parent.create(recursive: true);
    await _file.writeAsString(jsonEncode(data.toJson()));
  }
}