write
suspend fun writeTileCacheEntry(content: GpkgContent, zoomLevel: Int, tileColumn: Int, tileRow: Int, tileData: ByteArray, etag: String? = null, httpLastModified: String? = null, validatedAt: Long? = null, griddedScale: Float? = null, griddedOffset: Float? = null): Long
Single-transaction upsert of one cached tile: blob, optional gridded ancillary row (elevation) and optional freshness row, plus the content last-change stamp. One writeDispatcher hop and one SQLite commit instead of one per statement — the per-tile cache write path is commit-bound. Returns the tile-user-data row id.