Model-based Query API only returns 1000 items

[lawmicha]

Currently the query API hardcodes the limit to 1000. when there are more than 1000 items, there's no way to retrieve the pass the 1000th item. We need to define what the query API should look like or before that focus on unblocking the developer by allowing options in the API call to pass in limit and nextToken and return some sort of PaginatedResult<[M]> that the developer can get the nextToken from.

    public static func query<M: Model>(from modelType: M.Type,
                                       where predicate: QueryPredicate? = nil) -> GraphQLRequest<[M]> {
        let document = GraphQLListQuery(from: modelType, predicate: predicate)
        // TODO: decodePath should just be document.name and return `GraphQLRequest<GraphQLListResponse<M>>`
        return GraphQLRequest<[M]>(document: document.stringValue,
                                   variables: document.variables,
                                   responseType: [M].self, // TODO: should be `GraphQLListResponse<M>`
                                   decodePath: document.name + ".items")
    }

[lawmicha]

overall documenting a complex schema use case with different types of directives and how to make calls to AppSync should solve this for P0. closing and referencing to this issue over in that pivotal task