localisync_sdk library

Flutter integration for verified Localisync translation delivery.

Classes

AppVersion
Strict SemVer 2.0. Build metadata has no precedence; bounds include prereleases.
ArtifactDescriptor
CachedGeneration
Stored strings are untrusted until reverified with the application's trust anchors.
CacheState
Cancellation
Cancellation belongs to one operation, not a shared HTTP client.
Catalog
Compatibility
CompiledMessage
Prepared immutable message. Parsing/contract validation happens once before activation.
ContentPreparer
CooperativePreparer
CooperativeVerification
DeliveryCache
DeliveryLimits
DeliveryReader
Download and verification never publish content to readers.
DeliveryResponse
DeliveryTransport
DeliveryVerification
CPU boundary: platform adapters may perform signature, JSON and artifact verification in an isolate. Scope and publication decisions remain in the delivery use case.
DiagnosticsConfig
Explicit opt-in. This credential can submit diagnostics but cannot read content.
DiagnosticSink
A content-free port. Implementations must only enqueue bounded counters on record().
DownloadedRelease
LocaleFile
LocalisyncClient
Instance-scoped translation client. Reads never await initialization or perform I/O.
LocalisyncConfig
LocalisyncScope
Rebuilds only widgets depending on this scope, without replacing navigator/form keys.
LocalisyncStatus
MemoryDeliveryCache
Explicit opt-in for applications without durable storage. Default platform setup always supplies a persistent adapter instead.
Publication
ReleaseManifest
SignatureVerifier
Trust anchors are supplied by the application, never learned from an untrusted response.
TranslationBundle
Immutable application-owned fallback. No network, asset read or mutable global locale.
TranslationEntry
TranslationResult
UpdateResult
VerifiedCatalog

Enums

ActivationPolicy
Channel
ContentSource
DiagnosticStage
FailureCode
Stable, content-free diagnostic codes. Messages never contain translation input.
MessageFormat
ParameterType
UpdateOutcome
UpdatePhase
UpdatePolicy

Functions

createLocalisyncClient(LocalisyncConfig config) → LocalisyncClient
Create a persistent platform client. Its bundled translations are immediately readable.
decodeDocument(String input, {int maxBytes = 100 * 1024 * 1024}) → Future<Object?>
Bounded JSON decoder that rejects duplicate object keys and yields on large input. Unlike jsonDecode's reviver, duplicate names cannot disappear before validation.
fallbackChain(Map<String, String?> languages, String locale) → List<String>
flutterLocale(String tag) → Locale
Explicit Flutter boundary. Variants cannot be represented by dart:ui Locale.
invalid(String message) → Never
prepareBundle(ReleaseManifest manifest, Map<String, LocaleFile> files, {Map<String, TranslationEntry> contracts = const {}}) → Future<TranslationBundle>
Compile once. On browsers this yields between bounded batches rather than claiming that compute() provides an off-thread isolate.
sha256Hex(List<int> bytes) → Future<String>
strictUtf8(String value) → Uint8List
validateFallbacks(Map<String, String?> languages) → void

Exceptions / Errors

LocalisyncException