kitsu-core

Kitsu Core

Core JSON:API serialisation and deserialisation components for kitsu

Check out the Migration Guide for breaking changes and new features in 6.x

Features

• JSON-API 1.0 compliant
• Automatically links relationships to data
• Works in Node and on the web
• Uses the Promise API

Node / Browser Support

Package	Package Size*	Node	Chrome	Firefox	Safari	Edge	IE
kitsu-core	4.3 kb	6+	54+	51+	10+	15+
kitsu-core/legacy	4.4 kb	6+	4+	3.5+	3.2+	12+	8+
kitsu-core/node	1.5 kb	6+

* Including all dependencies, minified & gzipped

Install

Yarn / NPM

yarn add kitsu-core
npm install kitsu-core

import { camel } from 'kitsu-core'             // ES Modules and Babel
const { camel } = require('kitsu-core')        // CommonJS and Browserify
const { camel } = require('kitsu-core/legacy') // Legacy IE8+ support
const { camel } = require('kitsu-core/node')   // Lighter node-only package

camel(...)

Try it on RunKit

Packd CDN

<script src='https://bundle.run/kitsu-core@5?name=kitsuCore'></script>
<script src='https://bundle.run/kitsu@5/legacy/index.js?name=kitsuCore'></script>

kitsuCore.camel(...)

Try it on CodePen

API

Table of Contents

• camel
  • Parameters
  • Examples
• deattribute
  • Parameters
  • Examples
• deserialise
  • Parameters
  • Examples
• error
  • Parameters
• filterIncludes
  • Parameters
• kebab
  • Parameters
  • Examples
• linkRelationships
  • Parameters
• query
  • Parameters
• serialise
  • Parameters
  • Examples
• snake
  • Parameters
  • Examples

camel

Converts kebab-case and snake_case into camelCase

Parameters

• s string String to convert

Examples

Convert kebab-case

camel('hello-world') // 'helloWorld'

Convert snake_case

camel('hello_world') // 'helloWorld'

Returns string camelCase formatted string

deattribute

Hoists attributes to be top-level

Parameters

• data (Object | Array) Resource data

Examples

Deattribute an array of resources

// JSON:API 'data' field
const data = [
  {
    id: '1',
    type: 'users',
    attributes: { slug: 'wopian' }
  }
]

const output = await deattribute(data) // [ { id: '1', type: 'users', slug: 'wopian' } ]

Deattribute a resource

// JSON:API 'data' field
const data = {
  id: '1',
  type: 'users',
  attributes: { slug: 'wopian' }
}

const output = await deattribute(data) // { id: '1', type: 'users', slug: 'wopian' }

Returns (Object | Array) Deattributed resource data

deserialise

Deserialises a JSON-API response

Parameters

• obj Object The response

Examples

Deserialise with a basic data object

await deserialise({
  data: {
    id: '1',
    attributes: { liked: true }
  },
  meta: { hello: 'world' }
}) // { data: { id: '1', liked: true }, meta: { hello: 'world' } }

Deserialise with relationships

await deserialise({
  data: {
    id: '1',
    relationships: {
      user: {
        data: {
          type: 'users',
          id: '2' }
      }
    }
  },
  included: [
    {
      type: 'users',
      id: '2',
      attributes: { slug: 'wopian' }
    }
  ]
}) // { data: { id: '1', user: { type: 'users', id: '2', slug: 'wopian' } } }

Returns Object The deserialised response

error

Mutates an error and rethrows it

Parameters

• E Object The Error

• Throws Object The mutated Error

filterIncludes

Filters includes for the specific relationship

Parameters

• included Object The response included object
• opts Object
  • opts.id string The relationship ID
  • opts.type string The relationship type

Returns Array The matched includes

kebab

Converts camelCase into kebab-case

Parameters

• s string camelCase string

Examples

kebab('helloWorld') // 'hello-world'

Returns string kekab-case formatted string

linkRelationships

Links relationships to included data

Parameters

• data Object The response data object
• included Object The response included object

query

Constructs a URL query string for JSON:API parameters

Parameters

• params Object Parameters to parse
• prefix string Prefix for nested parameters - used internally (default null) (optional, default null)

Returns string URL query string

serialise

Serialises an object into a JSON-API structure

Parameters

• model string Request model
• obj Object The data (optional, default {})
• method string Request type (optional, default 'POST')

Examples

Due to its usage in kitsu, it MUST be called with this set in 5.0.x

import { serialise, camel, kebab } from 'kitsu-core'
import plural from 'pluralize'

const output = await serialise.apply({ camel, resCase: kebab, plural }, [ model, obj, 'PATCH' ])

Returns Object The serialised data

snake

Converts camelCase into snake_case

Parameters

• s string camelCase string

Examples

snake('helloWorld') // 'hello_world'

Returns string snake_case formatted string

Contributing

See CONTRIBUTING

Releases

See CHANGELOG

License

All code released under MIT