After some internal discussions we decided that we are no longer willing to support mastodon_dart. The reason is because keeping up with the Mastodon API is too much work without them having an official OpenAPI spec. If the Mastodon team decides to make an OpenAPI spec available we will reconsider supporting mastodon_dart.

Related: https://github.com/tootsuite/mastodon/issues/1404

I ran across https://mastodon.social/@GIbiz/109626791400616879 which returns a malformed author_url value.

"author_url": "[\"https://www.gamesindustry.biz/authors/brendan-sinclair\", \"https://twitter.com/BrendanSinclair\"]",

Steps to reproduce:

1. Check out the add_missing_entity_data branch
2. Run the mastodon_flutter example app while depending on mastodon_dart from path
3. The below stack trace will appear in the console

Stack trace:

E/flutter ( 1696): [ERROR:flutter/lib/ui/ui_dart_state.cc(157)] Unhandled Exception: type 'List<dynamic>' is not a subtype of type 'Map<String, dynamic>' in type cast
E/flutter ( 1696): #0      _$PollFromJson (package:mastodon_dart/src/data/poll.g.dart:21:31)
E/flutter ( 1696): #1      new Poll.fromJson (package:mastodon_dart/src/data/poll.dart:69:55)
E/flutter ( 1696): #2      _$StatusFromJson (package:mastodon_dart/src/data/status.g.dart:55:16)
E/flutter ( 1696): #3      new Status.fromJson (package:mastodon_dart/src/data/status.dart:170:57)
E/flutter ( 1696): #4      Timelines.publicTimeline.<anonymous closure> (package:mastodon_dart/src/endpoints/timelines.dart:92:55)
E/flutter ( 1696): #5      MappedListIterable.elementAt (dart:_internal/iterable.dart:417:31)
E/flutter ( 1696): #6      ListIterator.moveNext (dart:_internal/iterable.dart:346:26)
E/flutter ( 1696): #7      new List.from (dart:core-patch/array_patch.dart:54:19)
E/flutter ( 1696): #8      Timelines.publicTimeline (package:mastodon_dart/src/endpoints/timelines.dart:91:12)
E/flutter ( 1696): <asynchronous suspension>
E/flutter ( 1696): #9      _LocalTimelineState.updateTimelineBloc.<anonymous closure> (package:jiminy_for_mastodon/screens/timelines/local_timeline.dart:61:49)
E/flutter ( 1696): #10     TimelineBloc._handleRequest (package:mastodon_dart/src/bloc/timeline.dart:40:42)
E/flutter ( 1696): #11     _rootRunUnary (dart:async/zone.dart:1192:38)
E/flutter ( 1696): #12     _CustomZone.runUnary (dart:async/zone.dart:1085:19)
E/flutter ( 1696): #13     _CustomZone.runUnaryGuarded (dart:async/zone.dart:987:7)
E/flutter ( 1696): #14     _BufferingStreamSubscription._sendData (dart:async/stream_impl.dart:339:11)
E/flutter ( 1696): #15     _BufferingStreamSubscription._add (dart:async/stream_impl.dart:266:7)
E/flutter ( 1696): #16     _SyncStreamControllerDispatch._sendData (dart:async/stream_controller.dart:779:19)
E/flutter ( 1696): #17     _StreamController._add (dart:async/stream_controller.dart:655:7)
E/flutter ( 1696): #18     _StreamController.add (dart:async/stream_controller.dart:597:5)
E/flutter ( 1696): #19     BackpressureStreamTransformer._buildTransformer.<anonymous closure>.<anonymous closure>.<anonymous closure> (package:rxdart/src/transformers/backpressure/backpressure.dart:99:53)
E/flutter ( 1696): #20     BackpressureStreamTransformer._buildTransformer.<anonymous closure>.<anonymous closure>.<anonymous closure> (package:rxdart/src/transformers/backpressure/backpressure.dart:214:39)
E/flutter ( 1696): #21     BackpressureStreamTransformer._buildTransformer.<anonymous closure>.<anonymous closure>.<anonymous closure> (package:rxdart/src/transformers/backpressure/backpressure.dart:249:32)
E/flutter ( 1696): #22     _rootRunUnary (dart:async/zone.dart:1192:38)
E/flutter ( 1696): #23     _CustomZone.runUnary (dart:async/zone.dart:1085:19)
E/flutter ( 1696): #24     _CustomZone.runUnaryGuarded (dart:async/zone.dart:987:7)
E/flutter ( 1696): #25     _BufferingStreamSubscription._sendData (dart:async/stream_impl.dart:339:11)
E/flutter ( 1696): #26     _BufferingStreamSubscription._add (dart:async/stream_impl.dart:266:7)
E/flutter ( 1696): #27     _ForwardingStreamSubscription._add (dart:async/stream_pipe.dart:134:11)
E/flutter ( 1696): #28     _WhereStream._handleData (dart:async/stream_pipe.dart:209:12)
E/flutter ( 1696): #29     _ForwardingStreamSubscription._handleData (dart:async/stream_pipe.dart:166:13)
E/flutter ( 1696): #30     _rootRunUnary (dart:async/zone.dart:1192:38)
E/flutter ( 1696): #31     _CustomZone.runUnary (dart:async/zone.dart:1085:19)
E/flutter ( 1696): #32     _CustomZone.runUnaryGuarded (dart:async/zone.dart:987:7)
E/flutter ( 1696): #33     _BufferingStreamSubscription._sendData (dart:async/stream_impl.dart:339:11)
E/flutter ( 1696): #34     _DelayedData.perform (dart:async/stream_impl.dart:594:14)
E/flutter ( 1696): #35     _StreamImplEvents.handleNext (dart:async/stream_impl.dart:710:11)
E/flutter ( 1696): #36     _PendingEvents.schedule.<anonymous closure> (dart:async/stream_impl.dart:670:7)
E/flutter ( 1696): #37     _rootRun (dart:async/zone.dart:1180:38)
E/flutter ( 1696): #38     _CustomZone.run (dart:async/zone.dart:1077:19)
E/flutter ( 1696): #39     _CustomZone.runGuarded (dart:async/zone.dart:979:7)
E/flutter ( 1696): #40     _CustomZone.bindCallbackGuarded.<anonymous closure> (dart:async/zone.dart:1019:23)
E/flutter ( 1696): #41     _rootRun (dart:async/zone.dart:1184:13)
E/flutter ( 1696): #42     _CustomZone.run (dart:async/zone.dart:1077:19)
E/flutter ( 1696): #43     _CustomZone.runGuarded (dart:async/zone.dart:979:7)
E/flutter ( 1696): #44     _CustomZone.bindCallbackGuarded.<anonymous closure> (dart:async/zone.dart:1019:23)
E/flutter ( 1696): #45     _microtaskLoop (dart:async/schedule_microtask.dart:43:21)
E/flutter ( 1696): #46     _startMicrotaskLoop (dart:async/schedule_microtask.dart:52:5)
E/flutter ( 1696): 

Relates to #14

DISCUSSION: Currently we have zero support for admin related things. @lukepighetti do you think we should add admin support to existing entities or make them separate?

todo:

• [ ] Add admin endpoints, regular and mock https://docs.joinmastodon.org/methods/admin/
• [ ] Resolve discussion about whether to add admin support to existing entities or to make separate admin entities

E/flutter (21006): [ERROR:flutter/shell/common/shell.cc(186)] Dart Error: Unhandled exception:
E/flutter (21006): Unsupported operation: Cannot modify an unmodifiable Map
E/flutter (21006): #0      _ImmutableMap.removeWhere (dart:core/runtime/libimmutable_map.dart:118:5)
E/flutter (21006): #1      __Base&Authentication&Utilities.request (package:mastodon/src/utilities.dart:23:31)
E/flutter (21006): <asynchronous suspension>
E/flutter (21006): #2      _Mastodon&_Base&Accounts.verifyCredentials (package:mastodon/src/endpoints/accounts.dart:57:28)
E/flutter (21006): <asynchronous suspension>
E/flutter (21006): #3      AuthBloc._handleToken (package:mastodon/src/bloc/auth.dart:131:38)
E/flutter (21006): <asynchronous suspension>
E/flutter (21006): #4      _RootZone.runUnaryGuarded (dart:async/zone.dart:1314:10)
E/flutter (21006): #5      _BufferingStreamSubscription._sendData (dart:async/stream_impl.dart:336:11)
E/flutter (21006): #6      _DelayedData.perform (dart:async/stream_impl.dart:591:14)
E/flutter (21006): #7      _StreamImplEvents.handleNext (dart:async/stream_impl.dart:707:11)
E/flutter (21006): #8      _PendingEvents.schedule.<anonymous closure> (dart:async/stream_impl.dart:667:7)
E/flutter (21006): #9      _microtaskLoop (dart:async/schedule_microtask.dart:41:21)
E/flutter (21006): #10     _startMicrotaskLoop (dart:async/schedule_microtask.dart:50:5)```

https://docs.joinmastodon.org/methods/timelines/lists/

https://github.com/lukepighetti/mastodon-dart/blob/76cc1dd6917d0bcc14757cdf99f83d7d781c9d76/lib/src/endpoints/timelines.dart#L130-L146

Builds on https://github.com/lukepighetti/mastodon_dart/pull/53

• Switch them to JsonSerializable
• Rename Marker to Markers
• Rename Position to Marker
• Update Marker attribute types

Adds named constructor to instantiate without websocket.

Mastodon.rest(Uri.parse('https://mastodon.social'));

Alternative to https://github.com/lukepighetti/mastodon_dart/pull/45

This PR

• removes BLoCs (this repo is going 100% stateless)
• removes mocks
• migrates to null safety
• updates all deps
• removes unused deps
• removes library.dart
• renames src/data to src/models
• removes dead example

https://docs.joinmastodon.org/methods/statuses/media/

{
  "id": "22348641",
  "type": "image",
  "url": "https://files.mastodon.social/media_attachments/files/022/348/641/original/cebc6d51be03e509.jpeg",
  "preview_url": "https://files.mastodon.social/media_attachments/files/022/348/641/small/cebc6d51be03e509.jpeg",
  "remote_url": null,
  "text_url": "https://mastodon.social/media/4Zj6ewxzzzDi0g8JnZQ",
  "meta": {
    "focus": {
      "x": -0.69,
      "y": 0.42
    },
    "original": {
      "width": 640,
      "height": 480,
      "size": "640x480",
      "aspect": 1.3333333333333333
    },
    "small": {
      "width": 461,
      "height": 346,
      "size": "461x346",
      "aspect": 1.3323699421965318
    }
  },
  "description": "test uploaded via api",
  "blurhash": "UFBWY:8_0Jxv4mx]t8t64.%M-:IUWGWAt6M}" //////////////////////////////////
}

context https://github.com/woltapp/blurhash https://blurha.sh

Related to #14

Is this needed? I've seen this error get printed in the console, I don't know that we need this as its own entity.

What do you think @lukepighetti

I expect API response formats to become more divergent and buggy as more servers and forks of Mastodon popup. Currently if you request a timeline and one posts triggers a parsing exception (like #51) the entire response is lost. I'd like to see a way to get all the successful statuses and a list of exceptions for the failed statuses. This way users can be shown most of the content and the option to report parse issues to developers.

I'm noodling something similar to the following. What do you think?

class StatusException {
  final Exception exception;
  final String unparsed;
  final String? id;
  final Uri? uri;
  final String? attribute;

  StatusException({
    required this.exception,
    required this.unparsed,
    this.id,
    this.uri,
    this.attribute,
  });
}

class Response {
  final List<Status> statuses;
  final List<StatusException> exceptions;

  Response({
    required this.statuses,
    this.exceptions = const [],
  });
}

client.partialReponse = true; // some way of enabling partial responses
final Response response = await client.timeline();