fetchja 1.0.0

package/dist/index.js

@@ -0,0 +1,2 @@
+import x from"pluralize";function n(t){if(Array.isArray(t))return t.map(n);let e={id:t.id,type:t.type};for(let r in t.attributes)e[r]=t.attributes[r];for(let r in t.relationships)t.relationships[r].data&&(e[r]=t.relationships[r].data);return e}function g(t){let e={};for(let r of t)e[r.type]||(e[r.type]={}),e[r.type][r.id]=n(r);return e}function h(t){let e={};if(t.data&&(e.data=n(t.data)),t.meta&&(e.meta=t.meta),t.included){let r=g(t.included),s=i=>r[i.type][i.id];for(let i of e.data)for(let o in i){let a=i[o];typeof a=="object"&&(i[o]=Array.isArray(a)?a.map(s):s(a))}}return e}function c(t){if(t.response){let{data:e}=t.response;e?.errors&&(t.errors=e.errors)}throw t}function k(t,e,r){return typeof t=="object"&&t!==null?(r.relationships||(r.relationships={}),r.relationships[e]={data:t.id?{id:t.id,type:t.type||e}:t,links:t.links,meta:t.meta}):(r.attributes||(r.attributes={}),r.attributes[e]=t),r}function f(t,e,r={camelCaseTypes:s=>s,pluralTypes:s=>s}){try{if(e===null||Array.isArray(e)&&!e.length)return{data:e};let s={type:r.pluralTypes(r.camelCaseTypes(t))};e.id&&(s.id=String(e.id));for(let i in e)["id","type"].includes(i)||k(e[i],i,s);return JSON.stringify({data:s})}catch(s){c(s)}}function y(t,e={},r=""){let s=Array.isArray(e);for(let i in e){let o=e[i],a=r?`${r}[${s?"":i}]`:i;o instanceof Object?y(t,o,a):t.append(a,o)}}function m(t={}){let e=new URLSearchParams;return y(e,t),e}function d(t,e={resourceCase:r=>r,pluralize:r=>r}){let r=t.split("/"),s=r.pop(),i=r.join("/");return[s,`${i}/${e.pluralize(e.resourceCase(s))}`]}function u(t){return t.toLowerCase().replace(/[-_](.)/g,(e,r)=>r.toUpperCase()).replace(/^(.)/,e=>e.toLowerCase())}function C(t){return t.replace(/([a-z])([A-Z])/g,"$1-$2").replace(/_/g,"-").toLowerCase()}function b(t){return t.replace(/([a-z])([A-Z])/g,"$1_$2").replace(/-/g,"_").toLowerCase()}var l="application/vnd.api+json",p=class{constructor(e={headers:{}}){this.baseURL=e.baseURL,this.headers={Accept:l,"Content-Type":l,...e.headers},this.queryFormatter=typeof e.queryFormatter=="function"?e.queryFormatter:s=>m(s),this.camelCaseTypes=e.camelCaseTypes===!1?s=>s:u;let r={camel:u,kebab:C,snake:b,default:s=>s};this.resourceCase=r[e.resourceCase]||r.default,this.pluralize=e.pluralize===!1?s=>s:x,this.onResponseError=s=>s,this.fetch=this.get,this.update=this.patch,this.create=this.post,this.remove=this.delete}#e(e){return d(e,{resourceCase:this.resourceCase,pluralize:this.pluralize})}async request(e={method:"GET",headers:{}}){let r=new URL(e.url,this.baseURL||e.baseURL);e.params&&(r.search=this.queryFormatter(e.params));let s=new Headers({...this.headers,...e.headers});e.body&&(e.body=f(e.type,e.body,{camelCaseTypes:this.camelCaseTypes,pluralTypes:this.pluralize}));try{let i=await fetch(r,{method:e.method,body:e.body,headers:s});if(!i.ok)throw this.onResponseError(i),new Error(i.statusText);let o={};for(let[w,z]of i.headers.entries())o[w]=z;let a=o["content-type"],T=a&&a.includes(l)?await i.json():{};return{...h(T),status:i.status,statusText:i.statusText,headers:o}}catch(i){throw i}}get(e,r={method:"GET"}){try{return r.url=e.split("/").map(s=>this.resourceCase(s)).filter(Boolean).join("/"),this.request(r)}catch(s){throw c(s)}}patch(e,r,s={method:"PATCH"}){try{let[i,o]=this.#e(e);return this.request({url:r?.id?`${o}/${r.id}`:o,body:r,type:i,...s})}catch(i){throw c(i)}}post(e,r,s={method:"POST"}){try{let[i,o]=this.#e(e);return this.request({url:o,body:r,type:i,...s})}catch(i){throw c(i)}}delete(e,r,s={method:"DELETE"}){try{let[i,o]=this.#e(e);return this.request({url:`${o}/${r}`,body:{id:r},type:i,...s})}catch(i){throw c(i)}}};export{p as default};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.js", "../src/utils/deattribute.js", "../src/utils/deserialize.js", "../src/utils/error-parser.js", "../src/utils/serialize.js", "../src/utils/query-formatter.js", "../src/utils/split-model.js", "../src/utils/camel-case.js", "../src/utils/kebab-case.js", "../src/utils/snake-case.js"],
+  "sourcesContent": ["import pluralize from 'pluralize'\n\nimport { deserialize } from './utils/deserialize.js'\nimport { serialize } from './utils/serialize.js'\n\nimport { errorParser } from './utils/error-parser.js'\nimport { queryFormatter } from './utils/query-formatter.js'\nimport { splitModel } from './utils/split-model.js'\n\nimport { camelCase } from './utils/camel-case.js'\nimport { kebabCase } from './utils/kebab-case.js'\nimport { snakeCase } from './utils/snake-case.js'\n\nconst jsonType = 'application/vnd.api+json'\n\n/**\n * Options for Fetchja.\n * \n * @typedef {Object} FetchjaOptions\n * @property {string} baseURL The base URL for all requests.\n * @property {Object} headers The headers to include in all requests.\n * @property {Function} queryFormatter A function to format query parameters.\n * @property {string} resourceCase The case to use for resource names.\n * @property {boolean} pluralize Pluralize resource names.\n */\n\n/**\n * Fetchja is a simple wrapper around the Fetch API.\n * \n * @class Fetchja\n * @param {FetchjaOptions} [options] Options for Fetchja.\n */\nexport default class Fetchja {\n  constructor (options = {\n    headers: {}\n  }) {\n    this.baseURL = options.baseURL\n\n    // Headers\n    this.headers = {\n      Accept: jsonType,\n      'Content-Type': jsonType,\n      ...options.headers\n    }\n\n    // Query\n    this.queryFormatter = typeof options.queryFormatter === 'function'\n      ? options.queryFormatter\n      : object => queryFormatter(object)\n\n    // Camel Case Types\n    this.camelCaseTypes = options.camelCaseTypes === false\n      ? string => string\n      : camelCase\n\n    // Resource Case\n    const cases = {\n      camel: camelCase,\n      kebab: kebabCase,\n      snake: snakeCase,\n\n      default: string => string\n    }\n\n    this.resourceCase = cases[options.resourceCase] || cases.default\n    \n    // Pluralise\n    this.pluralize = options.pluralize === false\n      ? string => string\n      : pluralize\n    \n    // Interceptors\n    this.onResponseError = error => error\n\n    // Alias\n    this.fetch = this.get\n    this.update = this.patch\n    this.create = this.post\n    this.remove = this.delete\n  }\n\n  #splitModel (model) {\n    return splitModel(model, {\n      resourceCase: this.resourceCase,\n      pluralize: this.pluralize\n    })\n  }\n\n  async request (options = {\n    method: 'GET',\n    headers: {}\n  }) {\n    const url = new URL(options.url, this.baseURL || options.baseURL)\n\n    // Params\n    if (options.params) {\n      url.search = this.queryFormatter(options.params)\n    }\n\n    // Headers\n    const headers = new Headers({\n      ...this.headers,\n      ...options.headers\n    })\n\n    // Body\n    if (options.body) {\n      options.body = serialize(options.type, options.body, {\n        camelCaseTypes: this.camelCaseTypes,\n        pluralTypes: this.pluralize\n      })\n    }\n\n    // Fetch\n    try {\n      const response = await fetch(url, {\n        method: options.method,\n        body: options.body,\n        headers\n      })\n\n      if (!response.ok) {\n        this.onResponseError(response)\n        throw new Error(response.statusText)\n      }\n\n      // Response Headers\n      const responseHeaders = {}\n\n      for (const [key, value] of response.headers.entries()) {\n        responseHeaders[key] = value\n      }\n\n      const contentType = responseHeaders['content-type']\n\n      // Response Data\n      const data = contentType && contentType.includes(jsonType)\n        ? await response.json()\n        : {}\n\n      // Return\n      return {\n        ...deserialize(data),\n\n        status: response.status,\n        statusText: response.statusText,\n        headers: responseHeaders\n      }\n    } catch (error) {\n      throw error\n    }\n  }\n\n  get (model, options = { method: 'GET' }) {\n    try {\n      options.url = model.split('/')\n        .map(part => this.resourceCase(part))\n        .filter(Boolean)\n        .join('/')\n\n      return this.request(options)\n    } catch (error) {\n      throw errorParser(error)\n    }\n  }\n\n  patch (model, body, options = { method: 'PATCH' }) {\n    try {\n      const [type, url] = this.#splitModel(model)\n\n      return this.request({\n        url: body?.id ? `${url}/${body.id}` : url,\n        body,\n        type,\n\n        ...options\n      })\n    } catch (error) {\n      throw errorParser(error)\n    }\n  }\n\n  post (model, body, options = { method: 'POST' }) {\n    try {\n      const [type, url] = this.#splitModel(model)\n\n      return this.request({\n        url,\n        body,\n        type,\n\n        ...options\n      })\n    } catch (error) {\n      throw errorParser(error)\n    }\n  }\n\n  delete (model, id, options = { method: 'DELETE' }) {\n    try {\n      const [type, url] = this.#splitModel(model)\n\n      return this.request({\n        url: `${url}/${id}`,\n        body: { id },\n        type,\n\n        ...options\n      })\n    } catch (error) {\n      throw errorParser(error)\n    }\n  }\n}\n", "/**\n * Deattribute JSON:API data.\n *\n * @param {Object|Object[]} data The JSON:API data to deattribute.\n * @returns {Object} The deattributed data.\n */\nexport function deattribute (data) {\n  if (Array.isArray(data)) {\n    return data.map(deattribute)\n  }\n\n  const output = {\n    id: data.id,\n    type: data.type\n  }\n\n  for (const key in data.attributes) {\n    output[key] = data.attributes[key]\n  }\n\n  for (const key in data.relationships) {\n    if (data.relationships[key].data) {\n      output[key] = data.relationships[key].data\n    }\n  }\n\n  return output\n}", "import { deattribute } from './deattribute.js'\n\n/**\n * Group included JSON:API data by type and ID.\n *\n * @param {Object[]} included The included JSON:API data.\n * @returns {Object} The grouped included data.\n */\nfunction groupIncluded (included) {\n  const groups = {}\n\n  for (const item of included) {\n    if (!groups[item.type]) {\n      groups[item.type] = {}\n    }\n\n    groups[item.type][item.id] = deattribute(item)\n  }\n\n  return groups\n}\n\n/**\n * Deserialises a JSON-API response.\n *\n * @param {Object} response The JSON-API response.\n * @returns {Object} The deserialised response.\n */\nexport function deserialize (response) {\n  const output = {}\n\n  if (response.data) {\n    output.data = deattribute(response.data)\n  }\n\n  if (response.meta) {\n    output.meta = response.meta\n  }\n\n  if (response.included) {\n    const included = groupIncluded(response.included)\n    const getIncluded = item => included[item.type][item.id]\n\n    for (const item of output.data) {\n      for (const key in item) {\n        const itemKey = item[key]\n\n        if (typeof itemKey === 'object') {\n          item[key] = Array.isArray(itemKey)\n            ? itemKey.map(getIncluded)\n            : getIncluded(itemKey)\n        }\n      }\n    }\n  }\n\n  return output\n}", "/**\n * Parse the error response from the API.\n *\n * @param {Object} error The error object.\n * @throws {Error} The parsed error object.\n */\nexport function errorParser (error) {\n  if (error.response) {\n    const { data } = error.response\n\n    if (data?.errors) {\n      error.errors = data.errors\n    }\n  }\n\n  throw error\n}\n", "import { errorParser } from './error-parser.js'\n\nfunction serializeNode (node, key, data) {\n  if (typeof node === 'object' && node !== null) {\n    if (!data.relationships) {\n      data.relationships = {}\n    }\n\n    data.relationships[key] = {\n      data: node.id ? { id: node.id, type: node.type || key } : node,\n      links: node.links,\n      meta: node.meta\n    }\n  } else {\n    if (!data.attributes) {\n      data.attributes = {}\n    }\n\n    data.attributes[key] = node\n  }\n\n  return data\n}\n\nexport function serialize (type, data, options = {\n  camelCaseTypes: string => string,\n  pluralTypes: string => string\n}) {\n  try {\n    if (data === null || (Array.isArray(data) && !data.length)) {\n      return { data }\n    }\n\n    const output = {\n      type: options.pluralTypes(options.camelCaseTypes(type))\n    }\n\n    if (data.id) {\n      output.id = String(data.id)\n    }\n\n    for (const key in data) {\n      if (['id', 'type'].includes(key)) {\n        continue\n      }\n\n      serializeNode(data[key], key, output)\n    }\n\n    return  JSON.stringify({ data: output })\n  } catch (error) {\n    errorParser(error)\n  }\n}", "/**\n * Loop through an object and build a query string.\n * \n * @param {URLSearchParams} query The query to append to.\n * @param {Object} object The object to loop through.\n * @param {string} prefix The prefix to use.\n * @returns {void}\n * @private\n */\nfunction buildQuery (query, object = {}, prefix = '') {\n  const isArray = Array.isArray(object)\n\n  for (const key in object) {\n    const value = object[key]\n    const withPrefix = prefix ? `${prefix}[${isArray ? '' : key}]` : key\n\n    value instanceof Object\n      ? buildQuery(query, value, withPrefix)\n      : query.append(withPrefix, value)\n  }\n}\n\n/**\n * Format query parameters.\n * \n * @param {Object} parameters The parameters to format.\n * @returns {URLSearchParams} The formatted query.\n */\nexport function queryFormatter (parameters = {}) {\n  const query = new URLSearchParams()\n  buildQuery(query, parameters)\n\n  return query\n}\n", "/**\n * Split a model name from a URL.\n *\n * @param {string} url The URL to split.\n * @param {Object} options The options to use.\n * @returns {string[]} The model and resource.\n */\nexport function splitModel (url, options = {\n  resourceCase: string => string,\n  pluralize: string => string\n}) {\n  const parts = url.split('/')\n  const model = parts.pop()\n  const resource = parts.join('/')\n\n  return [\n    model,\n    `${resource}/${options.pluralize(options.resourceCase(model))}`\n  ]\n}\n", "/**\n * Convert a string from snake_case and kebab-case to camelCase.\n *\n * @param {string} input The string to convert.\n * @returns {string} The converted string.\n */\nexport function camelCase (input) {\n  return input\n    .toLowerCase()\n    .replace(/[-_](.)/g, (_, char) => char.toUpperCase())\n    .replace(/^(.)/, (char) => char.toLowerCase())\n}\n", "/**\n * Convert a string from camelCase and snake_case to kebab-case.\n *\n * @param {string} input The string to convert.\n * @returns {string} The converted string.\n */\nexport function kebabCase (input) {\n  return input\n    .replace(/([a-z])([A-Z])/g, '$1-$2')\n    .replace(/_/g, '-')\n    .toLowerCase()\n}\n", "/**\n * Converts a string from camelCase and kebab-case to snake_case.\n *\n * @param {string} input The string to convert.\n * @returns {string} The converted string.\n */\nexport function snakeCase (input) {\n  return input\n  .replace(/([a-z])([A-Z])/g, '$1_$2')\n  .replace(/-/g, '_')\n  .toLowerCase()\n}\n"],
+  "mappings": "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",
+  "names": ["pluralize", "deattribute", "data", "output", "key", "groupIncluded", "included", "groups", "item", "deattribute", "deserialize", "response", "output", "getIncluded", "key", "itemKey", "errorParser", "error", "data", "serializeNode", "node", "key", "data", "serialize", "type", "options", "string", "output", "error", "errorParser", "buildQuery", "query", "object", "prefix", "isArray", "key", "value", "withPrefix", "queryFormatter", "parameters", "splitModel", "url", "options", "string", "parts", "model", "resource", "camelCase", "input", "_", "char", "kebabCase", "input", "snakeCase", "input", "jsonType", "Fetchja", "options", "object", "queryFormatter", "string", "camelCase", "cases", "kebabCase", "snakeCase", "pluralize", "error", "#splitModel", "model", "splitModel", "url", "headers", "serialize", "response", "responseHeaders", "key", "value", "contentType", "data", "deserialize", "part", "errorParser", "body", "type", "id"]
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "fetchja",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "type": "module",
+  "scripts": {
+    "build": "esbuild src/index.js --bundle --format=esm --packages=external --minify --sourcemap --outfile=dist/index.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "Caio Tarifa <caio@yahoo.com>",
+  "license": "ISC",
+  "description": "The ultimate JavaScript library designed to make your JSON:API interactions seamless and intuitive.",
+  "dependencies": {
+    "pluralize": "^8.0.0"
+  },
+  "devDependencies": {
+    "esbuild": "0.21.5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/caiotarifa/fetchja.git"
+  },
+  "bugs": {
+    "url": "https://github.com/caiotarifa/fetchja/issues"
+  },
+  "homepage": "https://github.com/caiotarifa/fetchja#readme"
+}

package/readme.md

@@ -0,0 +1,36 @@
+# Fetchja
+
+Welcome to **Fetchja**, the ultimate JavaScript library designed to make your JSON:API interactions seamless and intuitive. Inspired by the renowned [Kitsu](https://github.com/wopian/kitsu) library, Fetchja leverages the native Fetch API, ensuring a lightweight and efficient experience.
+
+## Why Fetchja?
+
+- ⚡️ **Lightweight and Fast**: Built on the native Fetch API, Fetchja ensures minimal overhead and maximum performance.
+- 🎨 **Intuitive Design**: Easy-to-understand methods and configurations make Fetchja accessible for developers of all levels.
+- 💪 **Flexible and Customizable**: Tailor Fetchja to your needs with customizable headers, query parameters, and resource cases.
+
+## Installation
+
+To get started with Fetchja, simply install it via `npm` along with the `pluralize` library:
+
+```bash
+$ npm install fetchja pluralize
+```
+
+## Getting Started
+
+Here's a quick example to get you up and running with Fetchja:
+
+```javascript
+import { Fetchja } from 'fetchja'
+
+const api = new Fetchja({
+  baseURL: 'https://api.example.com'
+});
+
+try {
+  const response = await api.get('/posts')
+  console.log(response)
+} catch (error) {
+  console.error(error)
+}
+```

package/src/index.js

@@ -0,0 +1,214 @@
+import pluralize from 'pluralize'
+
+import { deserialize } from './utils/deserialize.js'
+import { serialize } from './utils/serialize.js'
+
+import { errorParser } from './utils/error-parser.js'
+import { queryFormatter } from './utils/query-formatter.js'
+import { splitModel } from './utils/split-model.js'
+
+import { camelCase } from './utils/camel-case.js'
+import { kebabCase } from './utils/kebab-case.js'
+import { snakeCase } from './utils/snake-case.js'
+
+const jsonType = 'application/vnd.api+json'
+
+/**
+ * Options for Fetchja.
+ * 
+ * @typedef {Object} FetchjaOptions
+ * @property {string} baseURL The base URL for all requests.
+ * @property {Object} headers The headers to include in all requests.
+ * @property {Function} queryFormatter A function to format query parameters.
+ * @property {string} resourceCase The case to use for resource names.
+ * @property {boolean} pluralize Pluralize resource names.
+ */
+
+/**
+ * Fetchja is a simple wrapper around the Fetch API.
+ * 
+ * @class Fetchja
+ * @param {FetchjaOptions} [options] Options for Fetchja.
+ */
+export default class Fetchja {
+  constructor (options = {
+    headers: {}
+  }) {
+    this.baseURL = options.baseURL
+
+    // Headers
+    this.headers = {
+      Accept: jsonType,
+      'Content-Type': jsonType,
+      ...options.headers
+    }
+
+    // Query
+    this.queryFormatter = typeof options.queryFormatter === 'function'
+      ? options.queryFormatter
+      : object => queryFormatter(object)
+
+    // Camel Case Types
+    this.camelCaseTypes = options.camelCaseTypes === false
+      ? string => string
+      : camelCase
+
+    // Resource Case
+    const cases = {
+      camel: camelCase,
+      kebab: kebabCase,
+      snake: snakeCase,
+
+      default: string => string
+    }
+
+    this.resourceCase = cases[options.resourceCase] || cases.default
+    
+    // Pluralise
+    this.pluralize = options.pluralize === false
+      ? string => string
+      : pluralize
+    
+    // Interceptors
+    this.onResponseError = error => error
+
+    // Alias
+    this.fetch = this.get
+    this.update = this.patch
+    this.create = this.post
+    this.remove = this.delete
+  }
+
+  #splitModel (model) {
+    return splitModel(model, {
+      resourceCase: this.resourceCase,
+      pluralize: this.pluralize
+    })
+  }
+
+  async request (options = {
+    method: 'GET',
+    headers: {}
+  }) {
+    const url = new URL(options.url, this.baseURL || options.baseURL)
+
+    // Params
+    if (options.params) {
+      url.search = this.queryFormatter(options.params)
+    }
+
+    // Headers
+    const headers = new Headers({
+      ...this.headers,
+      ...options.headers
+    })
+
+    // Body
+    if (options.body) {
+      options.body = serialize(options.type, options.body, {
+        camelCaseTypes: this.camelCaseTypes,
+        pluralTypes: this.pluralize
+      })
+    }
+
+    // Fetch
+    try {
+      const response = await fetch(url, {
+        method: options.method,
+        body: options.body,
+        headers
+      })
+
+      if (!response.ok) {
+        this.onResponseError(response)
+        throw new Error(response.statusText)
+      }
+
+      // Response Headers
+      const responseHeaders = {}
+
+      for (const [key, value] of response.headers.entries()) {
+        responseHeaders[key] = value
+      }
+
+      const contentType = responseHeaders['content-type']
+
+      // Response Data
+      const data = contentType && contentType.includes(jsonType)
+        ? await response.json()
+        : {}
+
+      // Return
+      return {
+        ...deserialize(data),
+
+        status: response.status,
+        statusText: response.statusText,
+        headers: responseHeaders
+      }
+    } catch (error) {
+      throw error
+    }
+  }
+
+  get (model, options = { method: 'GET' }) {
+    try {
+      options.url = model.split('/')
+        .map(part => this.resourceCase(part))
+        .filter(Boolean)
+        .join('/')
+
+      return this.request(options)
+    } catch (error) {
+      throw errorParser(error)
+    }
+  }
+
+  patch (model, body, options = { method: 'PATCH' }) {
+    try {
+      const [type, url] = this.#splitModel(model)
+
+      return this.request({
+        url: body?.id ? `${url}/${body.id}` : url,
+        body,
+        type,
+
+        ...options
+      })
+    } catch (error) {
+      throw errorParser(error)
+    }
+  }
+
+  post (model, body, options = { method: 'POST' }) {
+    try {
+      const [type, url] = this.#splitModel(model)
+
+      return this.request({
+        url,
+        body,
+        type,
+
+        ...options
+      })
+    } catch (error) {
+      throw errorParser(error)
+    }
+  }
+
+  delete (model, id, options = { method: 'DELETE' }) {
+    try {
+      const [type, url] = this.#splitModel(model)
+
+      return this.request({
+        url: `${url}/${id}`,
+        body: { id },
+        type,
+
+        ...options
+      })
+    } catch (error) {
+      throw errorParser(error)
+    }
+  }
+}

package/src/utils/camel-case.js

@@ -0,0 +1,12 @@
+/**
+ * Convert a string from snake_case and kebab-case to camelCase.
+ *
+ * @param {string} input The string to convert.
+ * @returns {string} The converted string.
+ */
+export function camelCase (input) {
+  return input
+    .toLowerCase()
+    .replace(/[-_](.)/g, (_, char) => char.toUpperCase())
+    .replace(/^(.)/, (char) => char.toLowerCase())
+}

package/src/utils/deattribute.js

@@ -0,0 +1,28 @@
+/**
+ * Deattribute JSON:API data.
+ *
+ * @param {Object|Object[]} data The JSON:API data to deattribute.
+ * @returns {Object} The deattributed data.
+ */
+export function deattribute (data) {
+  if (Array.isArray(data)) {
+    return data.map(deattribute)
+  }
+
+  const output = {
+    id: data.id,
+    type: data.type
+  }
+
+  for (const key in data.attributes) {
+    output[key] = data.attributes[key]
+  }
+
+  for (const key in data.relationships) {
+    if (data.relationships[key].data) {
+      output[key] = data.relationships[key].data
+    }
+  }
+
+  return output
+}

package/src/utils/deserialize.js

@@ -0,0 +1,58 @@
+import { deattribute } from './deattribute.js'
+
+/**
+ * Group included JSON:API data by type and ID.
+ *
+ * @param {Object[]} included The included JSON:API data.
+ * @returns {Object} The grouped included data.
+ */
+function groupIncluded (included) {
+  const groups = {}
+
+  for (const item of included) {
+    if (!groups[item.type]) {
+      groups[item.type] = {}
+    }
+
+    groups[item.type][item.id] = deattribute(item)
+  }
+
+  return groups
+}
+
+/**
+ * Deserialises a JSON-API response.
+ *
+ * @param {Object} response The JSON-API response.
+ * @returns {Object} The deserialised response.
+ */
+export function deserialize (response) {
+  const output = {}
+
+  if (response.data) {
+    output.data = deattribute(response.data)
+  }
+
+  if (response.meta) {
+    output.meta = response.meta
+  }
+
+  if (response.included) {
+    const included = groupIncluded(response.included)
+    const getIncluded = item => included[item.type][item.id]
+
+    for (const item of output.data) {
+      for (const key in item) {
+        const itemKey = item[key]
+
+        if (typeof itemKey === 'object') {
+          item[key] = Array.isArray(itemKey)
+            ? itemKey.map(getIncluded)
+            : getIncluded(itemKey)
+        }
+      }
+    }
+  }
+
+  return output
+}

package/src/utils/error-parser.js

@@ -0,0 +1,17 @@
+/**
+ * Parse the error response from the API.
+ *
+ * @param {Object} error The error object.
+ * @throws {Error} The parsed error object.
+ */
+export function errorParser (error) {
+  if (error.response) {
+    const { data } = error.response
+
+    if (data?.errors) {
+      error.errors = data.errors
+    }
+  }
+
+  throw error
+}

package/src/utils/kebab-case.js

@@ -0,0 +1,12 @@
+/**
+ * Convert a string from camelCase and snake_case to kebab-case.
+ *
+ * @param {string} input The string to convert.
+ * @returns {string} The converted string.
+ */
+export function kebabCase (input) {
+  return input
+    .replace(/([a-z])([A-Z])/g, '$1-$2')
+    .replace(/_/g, '-')
+    .toLowerCase()
+}

package/src/utils/query-formatter.js

@@ -0,0 +1,34 @@
+/**
+ * Loop through an object and build a query string.
+ * 
+ * @param {URLSearchParams} query The query to append to.
+ * @param {Object} object The object to loop through.
+ * @param {string} prefix The prefix to use.
+ * @returns {void}
+ * @private
+ */
+function buildQuery (query, object = {}, prefix = '') {
+  const isArray = Array.isArray(object)
+
+  for (const key in object) {
+    const value = object[key]
+    const withPrefix = prefix ? `${prefix}[${isArray ? '' : key}]` : key
+
+    value instanceof Object
+      ? buildQuery(query, value, withPrefix)
+      : query.append(withPrefix, value)
+  }
+}
+
+/**
+ * Format query parameters.
+ * 
+ * @param {Object} parameters The parameters to format.
+ * @returns {URLSearchParams} The formatted query.
+ */
+export function queryFormatter (parameters = {}) {
+  const query = new URLSearchParams()
+  buildQuery(query, parameters)
+
+  return query
+}

package/src/utils/serialize.js

@@ -0,0 +1,54 @@
+import { errorParser } from './error-parser.js'
+
+function serializeNode (node, key, data) {
+  if (typeof node === 'object' && node !== null) {
+    if (!data.relationships) {
+      data.relationships = {}
+    }
+
+    data.relationships[key] = {
+      data: node.id ? { id: node.id, type: node.type || key } : node,
+      links: node.links,
+      meta: node.meta
+    }
+  } else {
+    if (!data.attributes) {
+      data.attributes = {}
+    }
+
+    data.attributes[key] = node
+  }
+
+  return data
+}
+
+export function serialize (type, data, options = {
+  camelCaseTypes: string => string,
+  pluralTypes: string => string
+}) {
+  try {
+    if (data === null || (Array.isArray(data) && !data.length)) {
+      return { data }
+    }
+
+    const output = {
+      type: options.pluralTypes(options.camelCaseTypes(type))
+    }
+
+    if (data.id) {
+      output.id = String(data.id)
+    }
+
+    for (const key in data) {
+      if (['id', 'type'].includes(key)) {
+        continue
+      }
+
+      serializeNode(data[key], key, output)
+    }
+
+    return  JSON.stringify({ data: output })
+  } catch (error) {
+    errorParser(error)
+  }
+}

package/src/utils/snake-case.js

@@ -0,0 +1,12 @@
+/**
+ * Converts a string from camelCase and kebab-case to snake_case.
+ *
+ * @param {string} input The string to convert.
+ * @returns {string} The converted string.
+ */
+export function snakeCase (input) {
+  return input
+  .replace(/([a-z])([A-Z])/g, '$1_$2')
+  .replace(/-/g, '_')
+  .toLowerCase()
+}

package/src/utils/split-model.js

@@ -0,0 +1,20 @@
+/**
+ * Split a model name from a URL.
+ *
+ * @param {string} url The URL to split.
+ * @param {Object} options The options to use.
+ * @returns {string[]} The model and resource.
+ */
+export function splitModel (url, options = {
+  resourceCase: string => string,
+  pluralize: string => string
+}) {
+  const parts = url.split('/')
+  const model = parts.pop()
+  const resource = parts.join('/')
+
+  return [
+    model,
+    `${resource}/${options.pluralize(options.resourceCase(model))}`
+  ]
+}