Releases

Features

• model: add method stringifyOptions (#254) (03cbd69)

Bug Fixes

• parser: fix behaviour when stringifying arrays (6098689), closes #214

Features

• builder: add when method (8f08c8f), closes #219
• builder: add support to pass an object as argument in where and whereIn methods (d77b365), closes #205

Bug Fixes

• model: merge request config recursively (dc617da)
• model: prevent request config from ditching private data (#185) (4b12b18)
• model: throw an error if operations are used with custom (#173) (eef91b1), closes #172

Bug Fixes

• add missing config static method (#167) (b733e45)

Features

• add typescript support (#168) (1d8122f), closes #104

Bug Fixes

• builder: multiple nested filters were not working (#154) (72de598)
• builder: use typeof instead of constructor for checks (644ab4e)

Bug Fixes

• deps: add missing dependency qs (80a7636)

Features

• builder: accept array for include, append and orderBy (#148) (0d7ac00)
• builder: add support to nested filters (#141) (faf3d1e)
• model: add methods with, all and $all (#147) (db39511)
• model: add support to configuration at query builder (#142) (e46d63e)
• model: add support to upload files (#143) (a93cf5e), closes #83

Bug Fixes

• model: fix typo in for error message (fbd2bca)

Features

• model: handle 'data' wrapped responses for create and update (#109) (1bc6248) (@fadugyamfi)
• model: add support to nested keys for relations (#127) (095c1c3) (@JoaoPedroAS51)

Bug Fixes

• model: add null check in isValidId (#115) (279f9dc) (@guirociozanini)
• model: relations are not being applied if any is null (#134) (92932cc) (@JoaoPedroAS51)

Docs

• add new documentation website :tada: (#130) (e1afa2a) (@JoaoPedroAS51)

See https://robsontenorio.github.io/vue-api-query/

Bump

Thanks @JoaoPedroAS51 !

You can also apply a model instance to a nested object by setting the key and the model in relations method.

If the backend responds with:

// response from API for /posts/1
{
  title: 'My title'
  body: 'Some text here',
  user: {
    firstName: 'John',
    lastName: 'Doe'
  }
}

We just need to set user to User model:

/models/Post.js

class Post extends Model {
  relations () {
    return {
      // Apply User model to `user` object
      user: User
    }
  }
}

It also works for collections. So if the backend responds with:

// response from API for /comments
{
  text: 'Some text here',
  user: {
    firstName: 'John',
    lastName: 'Doe'
  },
  replies: [
    {
      text: 'A reply here',
      user: {
        firstName: 'Joe',
        lastName: 'Doe'
      }
    },
    {
      text: 'Another reply here',
      user: {
        firstName: 'Mary',
        lastName: 'Doe'
      },
      replies: [
        {
          text: 'Yes, this is the reply of the reply!',
          user: {
            firstName: 'Max',
            lastName: 'Doe'
          }
        }
      ]
    }
  ]
}

Then we just need to set user to User model and replies to Comment model:

/models/Comment.js

class Comment extends Model {
  relations () {
    return {
      // Apply User model to `user` object
      user: User,
      // Apply Comment model to each object of `replies` array
      replies: Comment
    }
  }
}

• Update all dependencies
• Small fix on README @manniL
• Reset query string @MichMich
• save() method makes a PUT request to the correct URL on nested object thas was fetched with find() method @taai

Thanks to @Peter-Krebs for reviewing.

Thanks @rossity for #67

Thanks @leeovery for #61.

Introduces new fetch style request for find() and first() methods. See README for more info.

let user = await User.$find(1)

let user = await User.$first()

Thanks @peterquentin

Thanks @Peter-Krebs

The custom() method can be called with multiple arguments to build resource endpoints and hierarchies. Simply supply them in the correct order. Any combination of strings and models is possible.

    let user = new User({ id: 1 })
    let post = new Post()

    // GET /users/1/posts/latest
    const result = await Post.custom(user, post, 'latest').get()

Update dependencies

Updated to latest babel and eslint features.

Added ability to customize query parameter names

If you need to change default values just override parametersName() on your Base Model. So, the generated query string will use this new values.

import { Model as BaseModel } from 'vue-api-query'

export default class Model extends BaseModel {

  parameterNames () {
    return {
      include: 'include_custom',
      filter: 'filter_custom',
      sort: 'sort_custom',
      fields: 'fields_custom',
      append: 'append_custom',
      page: 'page_custom',
      limit: 'limit_custom'
    }
  }
}

Thanks @suth https://github.com/robsontenorio/vue-api-query/pull/42

Fix array strategy validation for SSR

Got error on using vue-api-query with NUXT on universal mode (SSR)

Thanks @MisterEffix https://github.com/robsontenorio/vue-api-query/pull/43

 let user = new User({id: 1})
 let post = await user.posts().first()

 // Related objects go in order of their appearance in the URL.
 let comment = new Comment({text: 'for() takes multiple objects.'}).for(user, post)
  // POST /users/1/posts/1/comments
 await comment.save()

If you need to get a nested resource, without getting the parent model at first, you can do something like this.

// GET /users/1/posts

let User = new User({id: 1})
let Post = await User.posts().get()

// GET /users/1/posts/2
let User = new User({id: 1})
let Post = await User.posts().find(2)

• Tag 1.0.0 stable
• for() method for creating new related objects

Creating new related objects is easy. Just use the for() method, passing the related object.

  let post = new Post({title: 'Woo!'})  

  // POST /posts
  await post.save()

  let comment = new Comment({text: 'New one for this post'}).for(post)

  // POST /posts/1/comments
  await comment.save()

If you need to pass any extra param not provided by vue-api-query pattern, just use the params() method while querying:

// GET /users?doSomething=yes&process=no

let users = await User
  .params({
    doSomething: 'yes',
    process: 'no'
  })
  .get()

Of course you can chain it with other methods, including on relationships.

// GET /posts/1/comments?include=user&blah=123

let comments = await post
  .comments()
  .include('user')
  .params({blah: 123})
  .get()

In case your model does not work with default primary key ('id').

Support PUT, POST, DELETE for nested relationships

Fix internal variable name

• Add select() for sparse fields

• Remove find() restriction for integers

• add delete() method

• add "fetch style request" with $get()
• add pagination with page() and limit()