fetchja 1.4.0 → 2.1.0

package/src/utils/deserialize.js

@@ -1,93 +0,0 @@
-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
-}
-
-/**
- * Checks if a value is an object.
- *
- * @param {*} object The value to check.
- * @returns {boolean} Whether the value is an object.
- */
-function hasObject (object) {
-  return typeof object === 'object' && object !== null
-}
-
-/**
- * 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 => item.type in included
-      ? included[item.type][item.id]
-      : item
-
-    const replace = item => Array.isArray(item)
-      ? item.map(getIncluded)
-      : getIncluded(item)
-
-    // Replace relationships with included data.
-    for (const type in included) {
-      for (const id in included[type]) {
-        for (const key in included[type][id]) {
-          const item = included[type][id][key]
-
-          if (hasObject(item)) {
-            included[type][id][key] = replace(item)
-          }
-        }
-      }
-    }
-
-    // Replace relationships in the main data with included data.
-    if (Array.isArray(output.data)) {
-      for (const item of output.data) {
-        for (const key in item) {
-          if (hasObject(item[key])) {
-            item[key] = replace(item[key])
-          }
-        }
-      }
-    } else if (hasObject(output.data)) {
-      for (const key in output.data) {
-        if (hasObject(output.data[key])) {
-          output.data[key] = replace(output.data[key])
-        }
-      }
-    }
-  }
-
-  return output
-}

package/src/utils/error-parser.js

@@ -1,17 +0,0 @@
-/**
- * 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

@@ -1,12 +0,0 @@
-/**
- * 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

@@ -1,34 +0,0 @@
-/**
- * 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

@@ -1,98 +0,0 @@
-import { errorParser } from './error-parser.js'
-
-/**
- * Checks if a value is an object.
- *
- * @param {*} object The object to check.
- * @returns {boolean} Whether the value is an object.
- */
-function hasObject (object) {
-  return typeof object === 'object' && object !== null
-}
-
-/**
- * Serialises a JSON-API request.
- * 
- * @param {string} type The entity name.
- * @param {Object} request The request to serialise.
- * @param {Object} options The serialisation options.
- * @returns {string} The JSON serialised request.
- */
-export function serialize (type, request, options = {
-  camelCaseTypes: string => string,
-  pluralTypes: string => string
-}) {
-  const included = []
-
-  function include (node, subtype) {
-    if (!hasObject(node)) {
-      return
-    }
-
-    if (!node.id) {
-      throw new Error('All included resources must have an ID.')
-    }
-
-    if (!included.find(item => item.id === node.id)) {
-      included.push(extractData(node, subtype))
-    }
-  }
-
-  function extractData (node, subtype) {
-    const data = {
-      type: options.pluralTypes(options.camelCaseTypes(subtype))
-    }
-
-    for (const key in node) {
-      if (key === 'type') {
-        continue
-      }
-
-      if (key === 'id') {
-        data.id = String(node.id)
-        continue
-      }
-      
-      const value = node[key]
-
-      // Is this a relationship?
-      if (typeof value === 'object') {
-        data.relationships = data.relationships || {}
-
-        // One-To-Many / Many-To-Many
-        if (Array.isArray(value)) {
-          data.relationships[key] = {
-            data: value.map(item => {
-              include(item, key)
-              return { type: item.type || key, id: item.id }
-            })
-          }
-
-          continue
-        }
-
-        // One-To-One
-        data.relationships[key] = {
-          data: { type: value.type || key, id: value.id }
-        }
-
-        include(value, key)
-
-        continue
-      }
-
-      // Is this an attribute?
-      data.attributes = data.attributes || {}
-      data.attributes[key] = node[key]
-    }
-
-    return data
-  }
-
-  try {
-    const data = extractData(request, type)
-    return JSON.stringify({ data, included })
-  } catch (error) {
-    errorParser(error)
-  }
-}

package/src/utils/snake-case.js

@@ -1,12 +0,0 @@
-/**
- * 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

@@ -1,20 +0,0 @@
-/**
- * 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))}`
-  ]
-}

package/tests/utils/camel-case.test.js

@@ -1,30 +0,0 @@
-import assert from 'assert'
-import { camelCase } from '../../src/utils/camel-case.js'
-
-// Test 1: snake_case to camelCase.
-assert.strictEqual(
-  camelCase('hello_world'),
-  'helloWorld',
-  'Should convert snake_case to camelCase.'
-)
-
-// Test 2: kebab-case to camelCase.
-assert.strictEqual(
-  camelCase('hello-world'),
-  'helloWorld',
-  'Should convert kebab-case to camelCase.'
-)
-
-// Test 3: Mixed case to camelCase.
-assert.strictEqual(
-  camelCase('HELLO_WORLD_123'),
-  'helloWorld123',
-  'Should convert mixed case to camelCase.'
-)
-
- // Test 4: Empty string.
-assert.strictEqual(
-  camelCase(''),
-  '',
-  'Should return an empty string.'
-)

package/tests/utils/kebab-case.test.js

@@ -1,30 +0,0 @@
-import assert from 'assert'
-import { kebabCase } from '../../src/utils/kebab-case.js'
-
-// Test 1: camelCase to kebab-case.
-assert.strictEqual(
-  kebabCase('helloWorld'),
-  'hello-world',
-  'Should convert camelCase to kebab-case.'
-)
-
-// Test 2: snake_case to kebab-case.
-assert.strictEqual(
-  kebabCase('hello_world'),
-  'hello-world',
-  'Should convert snake_case to kebab-case.'
-)
-
-// Test 3: Mixed case to kebab-case.
-assert.strictEqual(
-  kebabCase('HELLO_WORLD_123'),
-  'hello-world-123',
-  'Should convert mixed case to kebab-case.'
-)
-
-// Test 4: Empty string.
-assert.strictEqual(
-  kebabCase(''),
-  '',
-  'Should return an empty string.'
-)

package/tests/utils/snake-case.test.js

@@ -1,30 +0,0 @@
-import assert from 'assert'
-import { snakeCase } from '../../src/utils/snake-case.js'
-
-// Test 1: camelCase to snake_case.
-assert.strictEqual(
-  snakeCase('helloWorld'),
-  'hello_world',
-  'Should convert camelCase to snake_case.'
-)
-
-// Test 2: kebab-case to snake_case.
-assert.strictEqual(
-  snakeCase('hello-world'),
-  'hello_world',
-  'Should convert kebab-case to snake_case.'
-)
-
-// Test 3: Mixed case to snake_case.
-assert.strictEqual(
-  snakeCase('HELLO_WORLD_123'),
-  'hello_world_123',
-  'Should convert mixed case to snake_case.'
-)
-
-// Test 4: Empty string.
-assert.strictEqual(
-  snakeCase(''),
-  '',
-  'Should return an empty string.'
-)