timsoft_os 0.1.2

TIMSoft Platform OS — Backend-less Application Engine. Local-first database with Sync, Auth, Realtime, RBAC, and Admin tools inside a single SDK. No external server required.

Changelog

All notable changes to timsoft_platform_os are documented here.

---

0.1.2 — 2026-04-28

Fixed

• Resolve remaining static analysis issues
• Fix WebSocket bridge stability and reconnection handling
• Improve error handling and null safety checks

Improved

• Refactor internal code for better maintainability
• Optimize repository and sync performance

---

0.1.1 — 2026-04-28

Fixed

• Fix ws_bridge SyncException error
• Improve static analysis warnings
• Fix repository and pubspec validation issues
• Add example and license compliance fixes

---

0.1.0 — 2026-04-27

Added

Core

• Result<T> sealed class with Success / Failure variants
• guardAsync / guard top-level helpers
• collectResults for fail-fast list validation
• Unified TimException hierarchy (Database, Sync, Auth, Schema, Platform)
• TenantContext — immutable multi-tenant identity carrier
• PlatformConfig with development / production presets

Entity

• @TimEntity annotation (declarative, no code generation)
• TimRecord abstract contract
• RecordMeta with automatic system fields (__id, __version, etc.)
• CollectionSchema + FieldSchema with FieldConstraints
• ChangeLog + ChangeLogEntry — operation-based audit trail with retry state

Database

• StorageDriver pluggable contract
• MemoryDriver — in-memory, zero I/O (tests / web)
• FileDriver — atomic JSON-on-disk with per-collection locking
• QueryEngine — filter (13 operators), multi-field sort, pagination, projection
• IndexManager — HashIndex + UniqueIndex for O(1) equality lookups
• TimTransaction — optimistic staged transactions with runTransaction() helper

Sync

• VersionVector — causal clock with dominance / concurrent detection
• Five ConflictResolver strategies:
  • LastWriteWinsResolver
  • FieldMergeResolver
  • CustomResolver
  • CrdtCounterResolver
  • AppendOnlyListResolver
  • PriorityResolver (tries resolvers in order)
• DeltaCalculator — minimal field-level diff + patch apply
• SyncQueue — exponential backoff, dead-letter queue
• SyncEngine — coordinated push/pull cycle with background timer

Auth

• TimSession — immutable session with expiry / refresh-token support
• RbacPolicy — role → permission mapping with wildcard collection support
• AuthProvider contract
• JwtAuthProvider — local JWT with user registry
• OAuthProvider — Google / Apple / GitHub / custom OIDC
• MagicLinkProvider — passwordless OTP flow
• AuthEngine — session lifecycle, auto-refresh, RBAC helpers

Realtime

• EventBus — in-process pub/sub with typed TimDataEvent / TimPlatformEvent
• LiveQuery<T> — reactive query stream with debounce + watchOne(id)
• WsBridge — optional WebSocket bridge with auto-reconnect

API

• Repository<T> — auto-CRUD with:
  • create / createMany
  • findById / findByIdOrFail / findMany / count
  • update / patch / upsert
  • delete (soft) / deleteMany / purge (hard)
• ValidatorChain<T> + MapValidator helpers
• MapReader + MapPatch serialisation utilities

Cloud

• CloudAdapter contract
• NoOpCloudAdapter — pure local mode
• DataVersioning — snapshot ring-buffer with rollback

Admin

• DashboardSpec + CollectionAdminConfig + ColumnDescriptor + FormFieldDescriptor
• DashboardGenerator — auto-generates spec from CollectionSchema list

Platform

• TimPlatform.boot(...) — single-call initialisation
• TimPlatform.instance — singleton access
• TimPlatform.collection<T>(...) — repository factory
• TimPlatform.liveQuery<T>(...) — live query factory
• TimPlatform.diagnostics() — runtime health snapshot

---

[Unreleased]

Planned

• RestCloudAdapter — full HTTP sync client
• IndexedDB driver — Flutter Web persistent storage
• Hive driver — Flutter mobile fast storage
• timsoft_os_flutter — Flutter UI components (CRUD screens from DashboardSpec)
• code_gen — build_runner plugin for toMap / fromMap generation
• Multi-region cloud sync