create-syncular-app 0.1.2 → 0.2.0

package/template/generated/kotlin/SyncularApp.kt

@@ -1,1005 +0,0 @@
-// @generated by `cargo run --manifest-path rust/Cargo.toml -p syncular-codegen --`
-// Source: migrations/*.sql and generated Syncular codegen handoff
-
-import kotlinx.serialization.json.Json
-import kotlinx.serialization.json.JsonElement
-import kotlinx.serialization.json.JsonNull
-import kotlinx.serialization.json.JsonObject
-import kotlinx.serialization.json.booleanOrNull
-import kotlinx.serialization.json.doubleOrNull
-import kotlinx.serialization.json.jsonArray
-import kotlinx.serialization.json.jsonObject
-import kotlinx.serialization.json.jsonPrimitive
-import kotlinx.serialization.json.longOrNull
-
-const val syncularNativeExpectedFfiAbiVersion: Int = 2
-const val syncularNativeExpectedCrateVersion: String = "0.1.0"
-const val syncularNativeGeneratedSchemaVersion: Int = 1
-
-const val syncularNativeGeneratedAppSchemaJson: String = "{\"clientSchemaSupport\":{\"current\":1,\"minSupported\":1,\"supported\":[1]},\"localBaseSchema\":{\"tableSetupSql\":[\"CREATE TABLE IF NOT EXISTS \\\"tasks\\\" (\\n  \\\"id\\\" TEXT PRIMARY KEY,\\n  \\\"title\\\" TEXT NOT NULL,\\n  \\\"completed\\\" INTEGER NOT NULL DEFAULT 0,\\n  \\\"user_id\\\" TEXT NOT NULL,\\n  \\\"created_at\\\" INTEGER NOT NULL DEFAULT 0,\\n  \\\"server_version\\\" INTEGER NOT NULL DEFAULT 0\\n) WITHOUT ROWID\"]},\"migrations\":[{\"name\":\"initial\",\"schemaVersion\":1,\"upSql\":\"CREATE TABLE IF NOT EXISTS tasks (\\n  id TEXT PRIMARY KEY,\\n  title TEXT NOT NULL,\\n  completed INTEGER NOT NULL DEFAULT 0,\\n  user_id TEXT NOT NULL,\\n  created_at BIGINT NOT NULL DEFAULT 0,\\n  server_version BIGINT NOT NULL DEFAULT 0\\n) WITHOUT ROWID;\",\"version\":\"0001\"}],\"schemaVersion\":1,\"tables\":[{\"blobColumns\":[],\"columns\":[{\"name\":\"id\",\"notnullRequired\":false,\"primaryKey\":true,\"typeFamily\":\"text\"},{\"name\":\"title\",\"notnullRequired\":true,\"primaryKey\":false,\"typeFamily\":\"text\"},{\"name\":\"completed\",\"notnullRequired\":true,\"primaryKey\":false,\"typeFamily\":\"integer\"},{\"name\":\"user_id\",\"notnullRequired\":true,\"primaryKey\":false,\"typeFamily\":\"text\"},{\"name\":\"created_at\",\"notnullRequired\":true,\"primaryKey\":false,\"typeFamily\":\"integer\"},{\"name\":\"server_version\",\"notnullRequired\":true,\"primaryKey\":false,\"typeFamily\":\"integer\"}],\"crdtYjsFields\":[],\"encryptedFields\":[],\"name\":\"tasks\",\"primaryKeyColumn\":\"id\",\"scopes\":[{\"column\":\"user_id\",\"name\":\"user_id\",\"required\":true,\"source\":\"actorId\"}],\"serverVersionColumn\":\"server_version\",\"softDeleteColumn\":null,\"subscriptionId\":\"sub-tasks\"}]}"
-
-data class SyncularNativeRuntimeManifest(
-    val ffiAbiVersion: Int,
-    val crateName: String,
-    val crateVersion: String,
-    val schemaVersion: Int,
-    val storageBackend: String,
-    val transportBackends: List<String> = emptyList(),
-    val capabilities: List<String> = emptyList(),
-)
-
-fun assertSyncularNativeRuntimeManifest(manifest: SyncularNativeRuntimeManifest) {
-    require(manifest.ffiAbiVersion == syncularNativeExpectedFfiAbiVersion) { "FFI ABI version ${manifest.ffiAbiVersion} does not match generated expectation $syncularNativeExpectedFfiAbiVersion" }
-    require(manifest.crateVersion == syncularNativeExpectedCrateVersion) { "Rust crate version ${manifest.crateVersion} does not match generated expectation $syncularNativeExpectedCrateVersion" }
-    require(manifest.storageBackend == "diesel-sqlite") { "Rust storage backend ${manifest.storageBackend} is not diesel-sqlite" }
-    require(manifest.capabilities.contains("generated-json-local-operations")) { "Rust native runtime is missing generated-json-local-operations" }
-    require(manifest.capabilities.contains("generated-json-mutations")) { "Rust native runtime is missing generated-json-mutations" }
-    require(manifest.capabilities.contains("generated-json-leased-mutations")) { "Rust native runtime is missing generated-json-leased-mutations" }
-    require(manifest.capabilities.contains("queued-json-leased-mutations")) { "Rust native runtime is missing queued-json-leased-mutations" }
-    require(manifest.capabilities.contains("auth-lease-issue")) { "Rust native runtime is missing auth-lease-issue" }
-    require(manifest.capabilities.contains("read-only-query-json")) { "Rust native runtime is missing read-only-query-json" }
-    require(manifest.capabilities.contains("query-observer-events")) { "Rust native runtime is missing query-observer-events" }
-}
-
-enum class SyncularGeneratedOperationKind(val wireValue: String) {
-    Upsert("upsert"),
-    Delete("delete"),
-}
-
-data class SyncularGeneratedOperation(
-    val table: String,
-    val rowId: String,
-    val op: SyncularGeneratedOperationKind,
-    val payload: Map<String, Any?>?,
-    val baseVersion: Long?,
-) {
-    fun toJsonValue(): Map<String, Any?> = linkedMapOf(
-        "table" to table,
-        "row_id" to rowId,
-        "op" to op.wireValue,
-        "payload" to payload,
-        "base_version" to baseVersion,
-    )
-
-    fun toJsonString(): String = syncularJsonValue(toJsonValue())
-}
-
-data class SyncularBlobRef(
-    val hash: String,
-    val size: Long,
-    val mimeType: String,
-    val encrypted: Boolean? = null,
-    val keyId: String? = null,
-) {
-    fun toJsonValue(): Map<String, Any?> {
-        val value = linkedMapOf<String, Any?>(
-            "hash" to hash,
-            "size" to size,
-            "mimeType" to mimeType,
-        )
-        encrypted?.let { value["encrypted"] = it }
-        keyId?.let { value["keyId"] = it }
-        return value
-    }
-
-    fun toJsonString(): String = syncularJsonValue(toJsonValue())
-}
-
-data class SyncularSubscriptionArgs(
-    val actorId: String,
-    val projectId: String? = null,
-    val bootstrapPhases: Map<String, Long> = emptyMap(),
-)
-
-private fun syncularBootstrapPhase(args: SyncularSubscriptionArgs, table: String, subscriptionId: String): Long =
-    args.bootstrapPhases[subscriptionId] ?: args.bootstrapPhases[table] ?: 0L
-
-data class SyncularSubscriptionSpec(
-    val id: String,
-    val table: String,
-    val scopes: Map<String, Any?>,
-    val params: Map<String, Any?> = emptyMap(),
-    val bootstrapPhase: Long = 0,
-) {
-    fun toJsonValue(): Map<String, Any?> = linkedMapOf(
-        "id" to id,
-        "table" to table,
-        "scopes" to scopes,
-        "params" to params,
-        "bootstrapPhase" to bootstrapPhase,
-    )
-
-    fun toJsonString(): String = syncularJsonValue(toJsonValue())
-}
-
-data class SyncularAuthLeaseScope(
-    val subscriptionId: String,
-    val table: String,
-    val values: Map<String, Any?>,
-    val operations: List<String>,
-) {
-    fun toJsonValue(): Map<String, Any?> = linkedMapOf(
-        "subscriptionId" to subscriptionId,
-        "table" to table,
-        "values" to values,
-        "operations" to operations,
-    )
-
-    fun toJsonString(): String = syncularJsonValue(toJsonValue())
-}
-
-data class SyncularAuthLeaseIssueRequest(
-    val schemaVersion: Int = syncularNativeGeneratedSchemaVersion,
-    val ttlMs: Long? = null,
-    val scopes: List<SyncularAuthLeaseScope>,
-) {
-    fun toJsonValue(): Map<String, Any?> = linkedMapOf(
-        "schemaVersion" to schemaVersion,
-        "ttlMs" to ttlMs,
-        "scopes" to scopes.map { it.toJsonValue() },
-    )
-
-    fun toJsonString(): String = syncularJsonValue(toJsonValue())
-}
-
-data class SyncularAuthLeaseRecord(
-    val leaseId: String,
-    val kid: String,
-    val actorId: String,
-    val issuedAtMs: Long,
-    val notBeforeMs: Long,
-    val expiresAtMs: Long,
-    val schemaVersion: Int,
-    val payloadJson: String,
-    val token: String,
-    val status: String,
-    val lastValidationError: String? = null,
-    val createdAtMs: Long,
-    val updatedAtMs: Long,
-)
-
-fun syncularDecodeAuthLeaseRecord(recordJson: String): SyncularAuthLeaseRecord {
-    val value = syncularGeneratedJson.parseToJsonElement(recordJson).jsonObject
-    return SyncularAuthLeaseRecord(
-        leaseId = value.syncularRequiredString("leaseId"),
-        kid = value.syncularRequiredString("kid"),
-        actorId = value.syncularRequiredString("actorId"),
-        issuedAtMs = value.syncularRequiredLong("issuedAtMs"),
-        notBeforeMs = value.syncularRequiredLong("notBeforeMs"),
-        expiresAtMs = value.syncularRequiredLong("expiresAtMs"),
-        schemaVersion = value.syncularRequiredLong("schemaVersion").toInt(),
-        payloadJson = value.syncularRequiredString("payloadJson"),
-        token = value.syncularRequiredString("token"),
-        status = value.syncularRequiredString("status"),
-        lastValidationError = value.syncularOptionalString("lastValidationError"),
-        createdAtMs = value.syncularRequiredLong("createdAtMs"),
-        updatedAtMs = value.syncularRequiredLong("updatedAtMs"),
-    )
-}
-
-fun syncularSubscriptionsJson(subscriptions: List<SyncularSubscriptionSpec>): String =
-    syncularJsonValue(subscriptions.map { it.toJsonValue() })
-
-fun syncularDefaultSubscriptionsJson(actorId: String, projectId: String? = null, bootstrapPhases: Map<String, Long> = emptyMap()): String =
-    syncularSubscriptionsJson(syncularDefaultSubscriptions(SyncularSubscriptionArgs(actorId = actorId, projectId = projectId, bootstrapPhases = bootstrapPhases)))
-
-fun syncularDefaultSubscriptions(args: SyncularSubscriptionArgs): List<SyncularSubscriptionSpec> = listOf(
-    taskSubscription(args),
-)
-
-fun taskSubscription(args: SyncularSubscriptionArgs): SyncularSubscriptionSpec {
-    val scopes = linkedMapOf<String, Any?>()
-    scopes["user_id"] = args.actorId
-    return SyncularSubscriptionSpec(id = "sub-tasks", table = "tasks", scopes = scopes, params = emptyMap<String, Any?>(), bootstrapPhase = syncularBootstrapPhase(args, "tasks", "sub-tasks"))
-}
-
-data class SyncularFieldEncryptionRule(
-    val scope: String,
-    val table: String?,
-    val fields: List<String>,
-    val rowIdField: String?,
-) {
-    fun toJsonValue(): Map<String, Any?> = linkedMapOf(
-        "scope" to scope,
-        "table" to table,
-        "fields" to fields,
-        "rowIdField" to rowIdField,
-    ).filterValues { it != null }
-}
-
-val syncularGeneratedFieldEncryptionRules: List<SyncularFieldEncryptionRule> = listOf(
-)
-
-fun syncularGeneratedFieldEncryptionConfigJson(
-    keys: Map<String, String>,
-    encryptionKid: String? = null,
-    decryptionErrorMode: String? = null,
-    envelopePrefix: String? = null,
-): String = syncularJsonValue(linkedMapOf(
-    "rules" to syncularGeneratedFieldEncryptionRules.map { it.toJsonValue() },
-    "keys" to keys,
-    "encryptionKid" to encryptionKid,
-    "decryptionErrorMode" to decryptionErrorMode,
-    "envelopePrefix" to envelopePrefix,
-).filterValues { it != null })
-
-data class SyncularReadonlyQuery(
-    val sql: String,
-    val params: List<Any?> = emptyList(),
-    val tables: List<String> = emptyList(),
-) {
-    fun toJsonValue(): Map<String, Any?> = linkedMapOf(
-        "sql" to sql,
-        "params" to params,
-        "tables" to tables,
-    )
-
-    fun toJsonString(): String = syncularJsonValue(toJsonValue())
-}
-
-data class SyncularLiveQueryRegistration(
-    val id: String,
-    val tables: List<String>,
-    val label: String? = null,
-) {
-    fun toJsonValue(): Map<String, Any?> = linkedMapOf(
-        "id" to id,
-        "tables" to tables,
-        "label" to label,
-    )
-
-    fun toJsonString(): String = syncularJsonValue(toJsonValue())
-}
-
-data class SyncularChangedCrdtField(
-    val field: String,
-    val stateColumn: String,
-    val containerKey: String,
-    val rowIdField: String,
-    val kind: String,
-    val syncMode: String,
-)
-
-data class SyncularChangedRow(
-    val table: String,
-    val rowId: String? = null,
-    val operation: String,
-    val changedFields: List<String> = emptyList(),
-    val crdtFields: List<String> = emptyList(),
-    val crdtFieldChanges: List<SyncularChangedCrdtField> = emptyList(),
-    val commitId: String? = null,
-    val commitSeq: Long? = null,
-    val subscriptionId: String? = null,
-    val serverVersion: Long? = null,
-)
-
-data class SyncularBootstrapState(
-    val asOfCommitSeq: Long = 0,
-    val tables: List<String> = emptyList(),
-    val tableIndex: Long = 0,
-    val rowCursor: String? = null,
-)
-
-data class SyncularBootstrapSubscriptionStatus(
-    val id: String,
-    val table: String,
-    val expected: Boolean,
-    val ready: Boolean,
-    val status: String? = null,
-    val phase: String,
-    val progressPercent: Long,
-    val cursor: Long? = null,
-    val bootstrapState: SyncularBootstrapState? = null,
-    val bootstrapPhase: Long,
-)
-
-data class SyncularBootstrapPhaseStatus(
-    val phase: Long,
-    val expectedSubscriptionIds: List<String> = emptyList(),
-    val readySubscriptionIds: List<String> = emptyList(),
-    val pendingSubscriptionIds: List<String> = emptyList(),
-    val isReady: Boolean,
-    val progressPercent: Long,
-)
-
-data class SyncularBootstrapStatus(
-    val channelPhase: String,
-    val progressPercent: Long,
-    val isBootstrapping: Boolean,
-    val criticalReady: Boolean,
-    val interactiveReady: Boolean,
-    val complete: Boolean,
-    val activePhase: Long? = null,
-    val expectedSubscriptionIds: List<String> = emptyList(),
-    val readySubscriptionIds: List<String> = emptyList(),
-    val pendingSubscriptionIds: List<String> = emptyList(),
-    val subscriptions: List<SyncularBootstrapSubscriptionStatus> = emptyList(),
-    val phases: List<SyncularBootstrapPhaseStatus> = emptyList(),
-)
-
-data class SyncularNativeErrorInfo(
-    val kind: String,
-    val code: String,
-    val category: String,
-    val retryable: Boolean,
-    val recommendedAction: String,
-    val message: String,
-    val debug: String? = null,
-)
-
-data class SyncularNativeLifecycleBootstrap(
-    val complete: Boolean = false,
-    val criticalReady: Boolean = false,
-    val interactiveReady: Boolean = false,
-    val isBootstrapping: Boolean = false,
-    val progressPercent: Long = 0,
-)
-
-data class SyncularNativeLifecycleOutbox(
-    val pending: Long = 0,
-)
-
-data class SyncularNativeLifecycleConflicts(
-    val unresolved: Long = 0,
-)
-
-data class SyncularNativeLifecycleBlobUploads(
-    val pending: Long = 0,
-    val uploading: Long = 0,
-    val failed: Long = 0,
-)
-
-data class SyncularNativeLifecycleState(
-    val phase: String,
-    val online: Boolean = false,
-    val requiresAction: Boolean = false,
-    val pendingRequests: Long = 0,
-    val bootstrap: SyncularNativeLifecycleBootstrap? = null,
-    val outbox: SyncularNativeLifecycleOutbox? = null,
-    val conflicts: SyncularNativeLifecycleConflicts? = null,
-    val blobUploads: SyncularNativeLifecycleBlobUploads? = null,
-)
-
-data class SyncularNativeEvent(
-    val eventSeq: Long = 0,
-    val kind: String,
-    val error: SyncularNativeErrorInfo? = null,
-    val tables: List<String> = emptyList(),
-    val queries: List<String> = emptyList(),
-    val changedRows: List<SyncularChangedRow> = emptyList(),
-    val commandId: String? = null,
-    val clientCommitId: String? = null,
-    val durationMs: Long? = null,
-    val droppedCount: Long? = null,
-    val bootstrap: SyncularBootstrapStatus? = null,
-    val lifecycle: SyncularNativeLifecycleState? = null,
-    val resyncRequired: Boolean = false,
-) {
-    val eventStreamLost: Boolean get() = kind == "EventsOverflowed" || resyncRequired
-}
-
-fun syncularDecodeChangedCrdtField(field: JsonObject): SyncularChangedCrdtField = SyncularChangedCrdtField(
-    field = field["field"]?.jsonPrimitive?.content ?: "",
-    stateColumn = field["stateColumn"]?.jsonPrimitive?.content ?: "",
-    containerKey = field["containerKey"]?.jsonPrimitive?.content ?: "",
-    rowIdField = field["rowIdField"]?.jsonPrimitive?.content ?: "",
-    kind = field["kind"]?.jsonPrimitive?.content ?: "",
-    syncMode = field["syncMode"]?.jsonPrimitive?.content ?: "",
-)
-
-fun syncularDecodeChangedRow(row: JsonObject): SyncularChangedRow = SyncularChangedRow(
-    table = row["table"]?.jsonPrimitive?.content ?: "",
-    rowId = row["rowId"]?.jsonPrimitive?.content,
-    operation = row["operation"]?.jsonPrimitive?.content ?: "",
-    changedFields = row["changedFields"]?.jsonArray?.map { it.jsonPrimitive.content } ?: emptyList(),
-    crdtFields = row["crdtFields"]?.jsonArray?.map { it.jsonPrimitive.content } ?: emptyList(),
-    crdtFieldChanges = row["crdtFieldChanges"]?.jsonArray?.map { syncularDecodeChangedCrdtField(it.jsonObject) } ?: emptyList(),
-    commitId = row["commitId"]?.jsonPrimitive?.content,
-    commitSeq = row["commitSeq"]?.jsonPrimitive?.longOrNull,
-    subscriptionId = row["subscriptionId"]?.jsonPrimitive?.content,
-    serverVersion = row["serverVersion"]?.jsonPrimitive?.longOrNull,
-)
-
-private fun syncularOptionalString(value: JsonElement?): String? =
-    if (value == null || value is JsonNull) null else value.jsonPrimitive.content
-
-private fun syncularJsonStringList(value: JsonElement?): List<String> =
-    if (value == null || value is JsonNull) emptyList() else value.jsonArray.map { it.jsonPrimitive.content }
-
-private fun syncularDecodeBootstrapState(value: JsonElement?): SyncularBootstrapState? {
-    if (value == null || value is JsonNull) return null
-    val state = value.jsonObject
-    return SyncularBootstrapState(
-        asOfCommitSeq = state["asOfCommitSeq"]?.jsonPrimitive?.longOrNull ?: 0L,
-        tables = syncularJsonStringList(state["tables"]),
-        tableIndex = state["tableIndex"]?.jsonPrimitive?.longOrNull ?: 0L,
-        rowCursor = syncularOptionalString(state["rowCursor"]),
-    )
-}
-
-private fun syncularDecodeBootstrapSubscriptionStatus(value: JsonElement): SyncularBootstrapSubscriptionStatus {
-    val subscription = value.jsonObject
-    return SyncularBootstrapSubscriptionStatus(
-        id = subscription["id"]?.jsonPrimitive?.content ?: "",
-        table = subscription["table"]?.jsonPrimitive?.content ?: "",
-        expected = subscription["expected"]?.jsonPrimitive?.booleanOrNull ?: false,
-        ready = subscription["ready"]?.jsonPrimitive?.booleanOrNull ?: false,
-        status = syncularOptionalString(subscription["status"]),
-        phase = subscription["phase"]?.jsonPrimitive?.content ?: "pending",
-        progressPercent = subscription["progressPercent"]?.jsonPrimitive?.longOrNull ?: 0L,
-        cursor = subscription["cursor"]?.jsonPrimitive?.longOrNull,
-        bootstrapState = syncularDecodeBootstrapState(subscription["bootstrapState"]),
-        bootstrapPhase = subscription["bootstrapPhase"]?.jsonPrimitive?.longOrNull ?: 0L,
-    )
-}
-
-private fun syncularDecodeBootstrapPhaseStatus(value: JsonElement): SyncularBootstrapPhaseStatus {
-    val phase = value.jsonObject
-    return SyncularBootstrapPhaseStatus(
-        phase = phase["phase"]?.jsonPrimitive?.longOrNull ?: 0L,
-        expectedSubscriptionIds = syncularJsonStringList(phase["expectedSubscriptionIds"]),
-        readySubscriptionIds = syncularJsonStringList(phase["readySubscriptionIds"]),
-        pendingSubscriptionIds = syncularJsonStringList(phase["pendingSubscriptionIds"]),
-        isReady = phase["isReady"]?.jsonPrimitive?.booleanOrNull ?: false,
-        progressPercent = phase["progressPercent"]?.jsonPrimitive?.longOrNull ?: 0L,
-    )
-}
-
-private fun syncularDecodeBootstrapStatus(value: JsonElement?): SyncularBootstrapStatus? {
-    if (value == null || value is JsonNull) return null
-    val status = value.jsonObject
-    return SyncularBootstrapStatus(
-        channelPhase = status["channelPhase"]?.jsonPrimitive?.content ?: "idle",
-        progressPercent = status["progressPercent"]?.jsonPrimitive?.longOrNull ?: 0L,
-        isBootstrapping = status["isBootstrapping"]?.jsonPrimitive?.booleanOrNull ?: false,
-        criticalReady = status["criticalReady"]?.jsonPrimitive?.booleanOrNull ?: false,
-        interactiveReady = status["interactiveReady"]?.jsonPrimitive?.booleanOrNull ?: false,
-        complete = status["complete"]?.jsonPrimitive?.booleanOrNull ?: false,
-        activePhase = status["activePhase"]?.jsonPrimitive?.longOrNull,
-        expectedSubscriptionIds = syncularJsonStringList(status["expectedSubscriptionIds"]),
-        readySubscriptionIds = syncularJsonStringList(status["readySubscriptionIds"]),
-        pendingSubscriptionIds = syncularJsonStringList(status["pendingSubscriptionIds"]),
-        subscriptions = status["subscriptions"]?.jsonArray?.map { syncularDecodeBootstrapSubscriptionStatus(it) } ?: emptyList(),
-        phases = status["phases"]?.jsonArray?.map { syncularDecodeBootstrapPhaseStatus(it) } ?: emptyList(),
-    )
-}
-
-private fun syncularDecodeNativeErrorInfo(value: JsonElement?): SyncularNativeErrorInfo? {
-    if (value == null || value is JsonNull) return null
-    val error = value.jsonObject
-    return SyncularNativeErrorInfo(
-        kind = error["kind"]?.jsonPrimitive?.content ?: "",
-        code = error["code"]?.jsonPrimitive?.content ?: "",
-        category = error["category"]?.jsonPrimitive?.content ?: "",
-        retryable = error["retryable"]?.jsonPrimitive?.booleanOrNull ?: false,
-        recommendedAction = error["recommendedAction"]?.jsonPrimitive?.content ?: "",
-        message = error["message"]?.jsonPrimitive?.content ?: "",
-        debug = syncularOptionalString(error["debug"]),
-    )
-}
-
-private fun syncularDecodeNativeLifecycleState(value: JsonElement?): SyncularNativeLifecycleState? {
-    if (value == null || value is JsonNull) return null
-    val state = value.jsonObject
-    val bootstrap = state["bootstrap"]?.takeUnless { it is JsonNull }?.jsonObject
-    val outbox = state["outbox"]?.takeUnless { it is JsonNull }?.jsonObject
-    val conflicts = state["conflicts"]?.takeUnless { it is JsonNull }?.jsonObject
-    val blobUploads = state["blobUploads"]?.takeUnless { it is JsonNull }?.jsonObject
-    return SyncularNativeLifecycleState(
-        phase = state["phase"]?.jsonPrimitive?.content ?: "offline",
-        online = state["online"]?.jsonPrimitive?.booleanOrNull ?: false,
-        requiresAction = state["requiresAction"]?.jsonPrimitive?.booleanOrNull ?: false,
-        pendingRequests = state["pendingRequests"]?.jsonPrimitive?.longOrNull ?: 0L,
-        bootstrap = bootstrap?.let { SyncularNativeLifecycleBootstrap(
-            complete = it["complete"]?.jsonPrimitive?.booleanOrNull ?: false,
-            criticalReady = it["criticalReady"]?.jsonPrimitive?.booleanOrNull ?: false,
-            interactiveReady = it["interactiveReady"]?.jsonPrimitive?.booleanOrNull ?: false,
-            isBootstrapping = it["isBootstrapping"]?.jsonPrimitive?.booleanOrNull ?: false,
-            progressPercent = it["progressPercent"]?.jsonPrimitive?.longOrNull ?: 0L,
-        ) },
-        outbox = outbox?.let { SyncularNativeLifecycleOutbox(pending = it["pending"]?.jsonPrimitive?.longOrNull ?: 0L) },
-        conflicts = conflicts?.let { SyncularNativeLifecycleConflicts(unresolved = it["unresolved"]?.jsonPrimitive?.longOrNull ?: 0L) },
-        blobUploads = blobUploads?.let { SyncularNativeLifecycleBlobUploads(
-            pending = it["pending"]?.jsonPrimitive?.longOrNull ?: 0L,
-            uploading = it["uploading"]?.jsonPrimitive?.longOrNull ?: 0L,
-            failed = it["failed"]?.jsonPrimitive?.longOrNull ?: 0L,
-        ) },
-    )
-}
-
-fun syncularDecodeNativeEvent(eventJson: String): SyncularNativeEvent {
-    val event = Json.parseToJsonElement(eventJson).jsonObject
-    return SyncularNativeEvent(
-        eventSeq = event["event_seq"]?.jsonPrimitive?.longOrNull ?: 0L,
-        kind = event["kind"]?.jsonPrimitive?.content ?: "",
-        error = syncularDecodeNativeErrorInfo(event["error"]),
-        tables = event["tables"]?.jsonArray?.map { it.jsonPrimitive.content } ?: emptyList(),
-        queries = event["queries"]?.jsonArray?.map { it.jsonPrimitive.content } ?: emptyList(),
-        changedRows = event["changedRows"]?.jsonArray?.map { syncularDecodeChangedRow(it.jsonObject) } ?: emptyList(),
-        commandId = event["command_id"]?.jsonPrimitive?.content,
-        clientCommitId = event["client_commit_id"]?.jsonPrimitive?.content,
-        durationMs = event["duration_ms"]?.jsonPrimitive?.longOrNull,
-        droppedCount = event["droppedCount"]?.jsonPrimitive?.longOrNull,
-        bootstrap = syncularDecodeBootstrapStatus(event["bootstrap"]),
-        lifecycle = syncularDecodeNativeLifecycleState(event["lifecycle"]),
-        resyncRequired = event["resyncRequired"]?.jsonPrimitive?.booleanOrNull ?: (event["kind"]?.jsonPrimitive?.content == "EventsOverflowed"),
-    )
-}
-
-fun syncularNativeEventRequiresFullRefresh(event: SyncularNativeEvent): Boolean =
-    event.eventStreamLost
-
-interface SyncularNativeEventJsonSource {
-    fun forEachEventJson(capacity: ULong = 256uL, handler: (String) -> Boolean)
-}
-
-fun SyncularNativeEventJsonSource.forEachNativeEvent(capacity: ULong = 256uL, handler: (SyncularNativeEvent) -> Boolean) {
-    forEachEventJson(capacity) { eventJson -> handler(syncularDecodeNativeEvent(eventJson)) }
-}
-
-fun syncularDecodeNativeEvents(eventJson: Iterable<String>): List<SyncularNativeEvent> =
-    eventJson.map(::syncularDecodeNativeEvent)
-
-data class TaskChangedFields(val raw: Set<String>) {
-    constructor(fields: List<String>) : this(fields.toSet())
-    val id: Boolean = raw.contains("id")
-    val title: Boolean = raw.contains("title")
-    val completed: Boolean = raw.contains("completed")
-    val userId: Boolean = raw.contains("user_id")
-    val createdAt: Boolean = raw.contains("created_at")
-    val serverVersion: Boolean = raw.contains("server_version")
-
-    fun contains(column: String): Boolean = when (column) {
-        "id" -> id
-        "title" -> title
-        "completed" -> completed
-        "user_id" -> userId
-        "created_at" -> createdAt
-        "server_version" -> serverVersion
-        else -> false
-    }
-}
-
-data class TaskChangedRow(
-    val raw: SyncularChangedRow,
-    val changed: TaskChangedFields = TaskChangedFields(raw.changedFields),
-    val crdt: TaskChangedFields = TaskChangedFields(raw.crdtFields),
-) {
-    val rowId: String? get() = raw.rowId
-    val operation: String get() = raw.operation
-    val isInsert: Boolean get() = raw.operation == "insert"
-    val isUpdate: Boolean get() = raw.operation == "update"
-    val isDelete: Boolean get() = raw.operation == "delete"
-
-    companion object {
-        fun from(row: SyncularChangedRow): TaskChangedRow? =
-            if (row.table == "tasks") TaskChangedRow(row) else null
-    }
-}
-
-fun taskChangedRows(rows: List<SyncularChangedRow>): List<TaskChangedRow> =
-    rows.mapNotNull { TaskChangedRow.from(it) }
-
-fun taskChangedRows(event: SyncularNativeEvent): List<TaskChangedRow> =
-    taskChangedRows(event.changedRows)
-
-interface SyncularNativeJsonClient {
-    fun applyMutationJson(mutationJson: String, localRowJson: String? = null): String
-    fun applyLeasedMutationJson(mutationJson: String, localRowJson: String? = null): String
-    fun enqueueMutationJson(mutationJson: String, localRowJson: String? = null): String
-    fun enqueueLeasedMutationJson(mutationJson: String, localRowJson: String? = null): String
-    fun issueAuthLeaseJson(requestJson: String): String
-    fun queryJson(requestJson: String): String
-    fun registerQueryJson(queryJson: String): String
-    fun unregisterQuery(id: String): Boolean
-    fun diagnosticSnapshotJson(): String
-}
-
-fun SyncularNativeJsonClient.apply(operation: SyncularGeneratedOperation, localRowJson: String? = null): String =
-    applyMutationJson(operation.toJsonString(), localRowJson)
-
-fun SyncularNativeJsonClient.applyLeased(operation: SyncularGeneratedOperation, localRowJson: String? = null): String =
-    applyLeasedMutationJson(operation.toJsonString(), localRowJson)
-
-fun SyncularNativeJsonClient.enqueue(operation: SyncularGeneratedOperation, localRowJson: String? = null): String =
-    enqueueMutationJson(operation.toJsonString(), localRowJson)
-
-fun SyncularNativeJsonClient.enqueueLeased(operation: SyncularGeneratedOperation, localRowJson: String? = null): String =
-    enqueueLeasedMutationJson(operation.toJsonString(), localRowJson)
-
-fun SyncularNativeJsonClient.issueAuthLease(request: SyncularAuthLeaseIssueRequest): SyncularAuthLeaseRecord =
-    syncularDecodeAuthLeaseRecord(issueAuthLeaseJson(request.toJsonString()))
-
-fun SyncularNativeJsonClient.diagnosticSnapshot(): JsonObject =
-    Json.parseToJsonElement(diagnosticSnapshotJson()).jsonObject
-
-fun SyncularNativeJsonClient.query(query: SyncularReadonlyQuery): List<JsonObject> =
-    syncularGeneratedQueryRows(queryJson(query.toJsonString()))
-
-fun <Row> SyncularNativeJsonClient.query(query: SyncularReadonlyQuery, decode: (JsonObject) -> Row): List<Row> =
-    query(query).map(decode)
-
-fun SyncularNativeJsonClient.registerLiveQuery(registration: SyncularLiveQueryRegistration): String =
-    registerQueryJson(registration.toJsonString())
-
-class SyncularNativeLiveQuery<Row>(
-    val id: String,
-    val query: SyncularReadonlyQuery,
-    private val decode: (JsonObject) -> Row,
-    val label: String? = null,
-) {
-    var rows: List<Row> = emptyList()
-        private set
-
-    fun start(client: SyncularNativeJsonClient): List<Row> {
-        client.registerLiveQuery(SyncularLiveQueryRegistration(id = id, tables = query.tables, label = label))
-        return refresh(client)
-    }
-
-    fun refresh(client: SyncularNativeJsonClient): List<Row> {
-        rows = client.query(query, decode)
-        return rows
-    }
-
-    fun stop(client: SyncularNativeJsonClient): Boolean = client.unregisterQuery(id)
-
-    fun matches(queryIds: Iterable<String>): Boolean = queryIds.any { it == id }
-
-    fun refreshIfChanged(event: SyncularNativeEvent, client: SyncularNativeJsonClient): List<Row>? {
-        if (syncularNativeEventRequiresFullRefresh(event)) return refresh(client)
-        if (event.kind != "QueriesChanged" || !matches(event.queries)) return null
-        return refresh(client)
-    }
-
-    fun refreshIfChanged(eventJson: String, client: SyncularNativeJsonClient): List<Row>? =
-        refreshIfChanged(syncularDecodeNativeEvent(eventJson), client)
-}
-
-data class SyncularQueryPredicate(
-    val sql: String,
-    val params: List<Any?> = emptyList(),
-) {
-    infix fun and(other: SyncularQueryPredicate): SyncularQueryPredicate =
-        SyncularQueryPredicate(sql = "(($sql) and (${other.sql}))", params = params + other.params)
-
-    infix fun or(other: SyncularQueryPredicate): SyncularQueryPredicate =
-        SyncularQueryPredicate(sql = "(($sql) or (${other.sql}))", params = params + other.params)
-}
-
-data class SyncularQueryOrder(
-    val sql: String,
-)
-
-class SyncularQueryColumn<T>(
-    val table: String,
-    val name: String,
-) {
-    fun eq(value: T): SyncularQueryPredicate =
-        SyncularQueryPredicate(sql = "${syncularQuoteIdentifier(name)} = ?", params = listOf(value))
-
-    fun notEq(value: T): SyncularQueryPredicate =
-        SyncularQueryPredicate(sql = "${syncularQuoteIdentifier(name)} != ?", params = listOf(value))
-
-    fun gt(value: T): SyncularQueryPredicate =
-        SyncularQueryPredicate(sql = "${syncularQuoteIdentifier(name)} > ?", params = listOf(value))
-
-    fun gte(value: T): SyncularQueryPredicate =
-        SyncularQueryPredicate(sql = "${syncularQuoteIdentifier(name)} >= ?", params = listOf(value))
-
-    fun lt(value: T): SyncularQueryPredicate =
-        SyncularQueryPredicate(sql = "${syncularQuoteIdentifier(name)} < ?", params = listOf(value))
-
-    fun lte(value: T): SyncularQueryPredicate =
-        SyncularQueryPredicate(sql = "${syncularQuoteIdentifier(name)} <= ?", params = listOf(value))
-
-    fun isNull(): SyncularQueryPredicate =
-        SyncularQueryPredicate(sql = "${syncularQuoteIdentifier(name)} is null")
-
-    fun isNotNull(): SyncularQueryPredicate =
-        SyncularQueryPredicate(sql = "${syncularQuoteIdentifier(name)} is not null")
-
-    fun isIn(values: Iterable<T>): SyncularQueryPredicate {
-        val list = values.toList()
-        if (list.isEmpty()) return SyncularQueryPredicate(sql = "0 = 1")
-        return SyncularQueryPredicate(sql = "${syncularQuoteIdentifier(name)} in (${list.joinToString(", ") { "?" }})", params = list)
-    }
-
-    fun notIn(values: Iterable<T>): SyncularQueryPredicate {
-        val list = values.toList()
-        if (list.isEmpty()) return SyncularQueryPredicate(sql = "1 = 1")
-        return SyncularQueryPredicate(sql = "${syncularQuoteIdentifier(name)} not in (${list.joinToString(", ") { "?" }})", params = list)
-    }
-
-    fun asc(): SyncularQueryOrder = SyncularQueryOrder("${syncularQuoteIdentifier(name)} asc")
-
-    fun desc(): SyncularQueryOrder = SyncularQueryOrder("${syncularQuoteIdentifier(name)} desc")
-}
-
-class SyncularQueryTable<Row>(
-    val name: String,
-    val columns: List<String>,
-    val decode: (JsonObject) -> Row,
-) {
-    fun select(): SyncularSelectQuery<Row> = SyncularSelectQuery(table = this)
-}
-
-data class SyncularSelectQuery<Row>(
-    val table: SyncularQueryTable<Row>,
-    val predicates: List<SyncularQueryPredicate> = emptyList(),
-    val orders: List<SyncularQueryOrder> = emptyList(),
-    val limitValue: Int? = null,
-) {
-    fun filter(predicate: SyncularQueryPredicate): SyncularSelectQuery<Row> =
-        copy(predicates = predicates + predicate)
-
-    fun orderBy(order: SyncularQueryOrder): SyncularSelectQuery<Row> =
-        copy(orders = orders + order)
-
-    fun limit(value: Int): SyncularSelectQuery<Row> = copy(limitValue = value)
-
-    fun readonlyQuery(): SyncularReadonlyQuery {
-        val columnSql = table.columns.joinToString(", ") { syncularQuoteIdentifier(it) }
-        val sql = buildString {
-            append("select ")
-            append(columnSql)
-            append(" from ")
-            append(syncularQuoteIdentifier(table.name))
-            if (predicates.isNotEmpty()) {
-                append(" where ")
-                append(predicates.joinToString(" and ") { it.sql })
-            }
-            if (orders.isNotEmpty()) {
-                append(" order by ")
-                append(orders.joinToString(", ") { it.sql })
-            }
-            limitValue?.let { append(" limit $it") }
-        }
-        return SyncularReadonlyQuery(
-            sql = sql,
-            params = predicates.flatMap { it.params },
-            tables = listOf(table.name),
-        )
-    }
-
-    fun fetch(client: SyncularNativeJsonClient): List<Row> = client.query(readonlyQuery(), table.decode)
-
-    fun liveQuery(id: String, label: String? = null): SyncularNativeLiveQuery<Row> =
-        SyncularNativeLiveQuery(id = id, query = readonlyQuery(), decode = table.decode, label = label)
-}
-
-private fun syncularQuoteIdentifier(identifier: String): String =
-    "\"" + identifier.replace("\"", "\"\"") + "\""
-
-data class TaskRow(
-    val id: String,
-    val title: String,
-    val completed: Long,
-    val userId: String,
-    val createdAt: Long,
-    val serverVersion: Long,
-)
-
-data class NewTask(
-    val id: String,
-    val title: String,
-    val completed: Long? = null,
-    val userId: String,
-    val createdAt: Long? = null,
-)
-
-data class TaskPatch(
-    val title: String? = null,
-    val completed: Long? = null,
-    val userId: String? = null,
-    val createdAt: Long? = null,
-)
-
-object TaskQuery {
-    val table = SyncularQueryTable(name = "tasks", columns = listOf("id", "title", "completed", "user_id", "created_at", "server_version"), decode = ::syncularDecodeTaskRow)
-    val id = SyncularQueryColumn<String>(table = "tasks", name = "id")
-    val title = SyncularQueryColumn<String>(table = "tasks", name = "title")
-    val completed = SyncularQueryColumn<Long>(table = "tasks", name = "completed")
-    val userId = SyncularQueryColumn<String>(table = "tasks", name = "user_id")
-    val createdAt = SyncularQueryColumn<Long>(table = "tasks", name = "created_at")
-    val serverVersion = SyncularQueryColumn<Long>(table = "tasks", name = "server_version")
-    fun select(): SyncularSelectQuery<TaskRow> = table.select()
-}
-
-object SyncularAppOperations {
-    fun newTask(input: NewTask, baseVersion: Long? = 0): SyncularGeneratedOperation {
-        val payload = linkedMapOf<String, Any?>()
-        payload["title"] = input.title
-        payload["completed"] = input.completed ?: 0L
-        payload["user_id"] = input.userId
-        payload["created_at"] = input.createdAt ?: 0L
-        return SyncularGeneratedOperation(
-            table = "tasks",
-            rowId = input.id,
-            op = SyncularGeneratedOperationKind.Upsert,
-            payload = payload,
-            baseVersion = baseVersion,
-        )
-    }
-
-    fun patchTask(rowId: String, patch: TaskPatch, baseVersion: Long? = null): SyncularGeneratedOperation {
-        val payload = linkedMapOf<String, Any?>()
-        patch.title?.let { payload["title"] = it }
-        patch.completed?.let { payload["completed"] = it }
-        patch.userId?.let { payload["user_id"] = it }
-        patch.createdAt?.let { payload["created_at"] = it }
-        return SyncularGeneratedOperation(
-            table = "tasks",
-            rowId = rowId,
-            op = SyncularGeneratedOperationKind.Upsert,
-            payload = payload,
-            baseVersion = baseVersion,
-        )
-    }
-
-    fun deleteTask(rowId: String, baseVersion: Long? = null): SyncularGeneratedOperation = SyncularGeneratedOperation(
-        table = "tasks",
-        rowId = rowId,
-        op = SyncularGeneratedOperationKind.Delete,
-        payload = null,
-        baseVersion = baseVersion,
-    )
-
-}
-
-class SyncularAppMutations internal constructor(
-    private val client: SyncularNativeJsonClient,
-    private val queued: Boolean = false,
-    private val leased: Boolean = false,
-) {
-    val tasks: TaskMutations get() = TaskMutations(client, queued, leased)
-}
-
-val SyncularNativeJsonClient.mutations: SyncularAppMutations
-    get() = SyncularAppMutations(this)
-
-val SyncularNativeJsonClient.queuedMutations: SyncularAppMutations
-    get() = SyncularAppMutations(this, queued = true)
-
-val SyncularNativeJsonClient.leasedMutations: SyncularAppMutations
-    get() = SyncularAppMutations(this, leased = true)
-
-val SyncularNativeJsonClient.queuedLeasedMutations: SyncularAppMutations
-    get() = SyncularAppMutations(this, queued = true, leased = true)
-
-class TaskMutations internal constructor(
-    private val client: SyncularNativeJsonClient,
-    private val queued: Boolean,
-    private val leased: Boolean,
-) {
-    fun insert(input: NewTask, baseVersion: Long? = 0, localRowJson: String? = null): String {
-        val operation = SyncularAppOperations.newTask(input, baseVersion)
-        return when {
-            queued && leased -> client.enqueueLeased(operation, localRowJson)
-            queued -> client.enqueue(operation, localRowJson)
-            leased -> client.applyLeased(operation, localRowJson)
-            else -> client.apply(operation, localRowJson)
-        }
-    }
-
-    fun update(rowId: String, patch: TaskPatch, baseVersion: Long? = null, localRowJson: String? = null): String {
-        val operation = SyncularAppOperations.patchTask(rowId, patch, baseVersion)
-        return when {
-            queued && leased -> client.enqueueLeased(operation, localRowJson)
-            queued -> client.enqueue(operation, localRowJson)
-            leased -> client.applyLeased(operation, localRowJson)
-            else -> client.apply(operation, localRowJson)
-        }
-    }
-
-    fun delete(rowId: String, baseVersion: Long? = null): String {
-        val operation = SyncularAppOperations.deleteTask(rowId, baseVersion)
-        return when {
-            queued && leased -> client.enqueueLeased(operation)
-            queued -> client.enqueue(operation)
-            leased -> client.applyLeased(operation)
-            else -> client.apply(operation)
-        }
-    }
-}
-
-private val syncularGeneratedJson = Json { ignoreUnknownKeys = true }
-
-private fun syncularGeneratedRows(json: String): List<JsonObject> =
-    syncularGeneratedJson.parseToJsonElement(json).jsonArray.map { it.jsonObject }
-
-private fun syncularGeneratedQueryRows(json: String): List<JsonObject> =
-    syncularGeneratedJson.parseToJsonElement(json).jsonObject["rows"]?.jsonArray?.map { it.jsonObject } ?: emptyList()
-
-private fun syncularDecodeTaskRows(json: String): List<TaskRow> =
-    syncularGeneratedRows(json).map(::syncularDecodeTaskRow)
-
-private fun syncularDecodeTaskRow(row: JsonObject): TaskRow = TaskRow(
-    id = row.syncularRequiredString("id"),
-    title = row.syncularRequiredString("title"),
-    completed = row.syncularRequiredLong("completed"),
-    userId = row.syncularRequiredString("user_id"),
-    createdAt = row.syncularRequiredLong("created_at"),
-    serverVersion = row.syncularRequiredLong("server_version"),
-)
-
-private fun JsonObject.syncularRequiredString(name: String): String =
-    syncularOptionalString(name) ?: error("missing string field $name")
-
-private fun JsonObject.syncularOptionalString(name: String): String? {
-    val element = this[name] ?: return null
-    if (element is JsonNull) return null
-    return element.jsonPrimitive.content
-}
-
-private fun JsonObject.syncularRequiredBlobRef(name: String): SyncularBlobRef =
-    syncularOptionalBlobRef(name) ?: error("missing blob ref field $name")
-
-private fun JsonObject.syncularOptionalBlobRef(name: String): SyncularBlobRef? {
-    val element = this[name] ?: return null
-    if (element is JsonNull) return null
-    val objectValue = runCatching {
-        syncularGeneratedJson.parseToJsonElement(element.jsonPrimitive.content).jsonObject
-    }.getOrElse {
-        element.jsonObject
-    }
-    return SyncularBlobRef(
-        hash = objectValue.syncularRequiredString("hash"),
-        size = objectValue.syncularRequiredLong("size"),
-        mimeType = objectValue.syncularRequiredString("mimeType"),
-        encrypted = objectValue.syncularOptionalBoolean("encrypted"),
-        keyId = objectValue.syncularOptionalString("keyId"),
-    )
-}
-
-private fun JsonObject.syncularRequiredLong(name: String): Long =
-    syncularOptionalLong(name) ?: error("missing integer field $name")
-
-private fun JsonObject.syncularOptionalLong(name: String): Long? {
-    val element = this[name] ?: return null
-    if (element is JsonNull) return null
-    return element.jsonPrimitive.longOrNull ?: error("field $name is not an integer")
-}
-
-private fun JsonObject.syncularRequiredDouble(name: String): Double =
-    syncularOptionalDouble(name) ?: error("missing double field $name")
-
-private fun JsonObject.syncularOptionalDouble(name: String): Double? {
-    val element = this[name] ?: return null
-    if (element is JsonNull) return null
-    return element.jsonPrimitive.doubleOrNull ?: error("field $name is not a double")
-}
-
-private fun JsonObject.syncularRequiredBoolean(name: String): Boolean =
-    syncularOptionalBoolean(name) ?: error("missing boolean field $name")
-
-private fun JsonObject.syncularOptionalBoolean(name: String): Boolean? {
-    val element = this[name] ?: return null
-    if (element is JsonNull) return null
-    return element.jsonPrimitive.booleanOrNull ?: error("field $name is not a boolean")
-}
-
-private fun syncularJsonValue(value: Any?): String = when (value) {
-    null -> "null"
-    is SyncularBlobRef -> syncularJsonString(value.toJsonString())
-    is String -> syncularJsonString(value)
-    is Number -> value.toString()
-    is Boolean -> value.toString()
-    is Map<*, *> -> value.entries.joinToString(prefix = "{", postfix = "}") { entry -> syncularJsonString(entry.key.toString()) + ":" + syncularJsonValue(entry.value) }
-    is Iterable<*> -> value.joinToString(prefix = "[", postfix = "]") { syncularJsonValue(it) }
-    else -> syncularJsonString(value.toString())
-}
-
-private fun syncularJsonString(value: String): String = buildString {
-    append('\"')
-    for (ch in value) {
-        when (ch) {
-            '\\' -> append("\\\\")
-            '\"' -> append("\\\"")
-            '\n' -> append("\\n")
-            '\r' -> append("\\r")
-            '\t' -> append("\\t")
-            else -> append(ch)
-        }
-    }
-    append('\"')
-}