oleq_logs

Flutter / Dart SDK for Oleq Logs (iOS, Android, and Dart VM).

Docs: logs.oleq.app/docs/flutter

Install

dependencies:
  oleq_logs: ^0.0.7

flutter pub add oleq_logs
# or: dart pub add oleq_logs

Setup

1. Create an app in the dashboard (Apps).
2. Create an API key for that org.
3. Pass the key via --dart-define, env, or options:

flutter run --dart-define=OLEQLOG_API_KEY=sk_live_…
# or:
export OLEQLOG_API_KEY=sk_live_…

Usage

import 'package:oleq_logs/oleq_logs.dart';

final log = OleqLog(LoggerConfig(
  appName: 'my-mobile-app', // required — same name as your dashboard app
  environment: 'production',
  // apiKey: 'sk_live_…',              // optional if OLEQLOG_API_KEY is set
  // baseUrl: 'http://localhost:3000', // optional; default is production API
  sensitive: SensitiveConfig(
    fields: ['password', 'authorization', 'ssn'],
    action: SensitiveAction.redact, // or SensitiveAction.strip
  ),
));

await log.info(LogPayload(message: 'screen opened'));
await log.warn(LogPayload(message: 'slow query', body: {'ms': 420}));
await log.error(LogPayload(
  message: 'checkout failed',
  kind: LogKind.res,
  body: {'status': 402, 'password': 'secret'}, // password → "***" before send
));

await log.flush();
await log.close();

Levels

trace · debug · info · success · warn · error · fatal · audit · metric

Optional fields

Field	Notes
kind	LogKind.req | LogKind.res — separate events
body	any JSON-serializable attachment
track / security / metrics	structured maps

Options

Option	Default
appName	required
apiKey	OLEQLOG_API_KEY / --dart-define
baseUrl	https://logspi.oleq.app — set in code for local/dev
environment	"development"
flushIntervalMs	2000
maxBatchSize	50
sensitive	optional — { fields, action?, replaceWith? }

Check

dart run bin/oleq_log_check.dart

Sibling SDKs

SDK	Package	Status
JavaScript / TypeScript	@oleq-ai/logs	Available
.NET	Oleq.Ai.Logs	Available
Flutter (mobile)	oleq_logs (this package)	Available

License

Proprietary. See LICENSE. Source is not open.