@tillhub/schemas 6.118.0 → 6.121.0

package/CHANGELOG.md

@@ -1,3 +1,36 @@
+# [6.121.0](https://github.com/tillhub/schemas/compare/v6.120.0...v6.121.0) (2022-02-21)
+
+
+### Bug Fixes
+
+* **tests:** remove require() errors ([f2b6a16](https://github.com/tillhub/schemas/commit/f2b6a16))
+
+
+### Features
+
+* **customers:** add rmissing schemas #API-1393 ([#672](https://github.com/tillhub/schemas/issues/672)) ([a4b8f30](https://github.com/tillhub/schemas/commit/a4b8f30)), closes [#API-1393](https://github.com/tillhub/schemas/issues/API-1393) [#API-1393](https://github.com/tillhub/schemas/issues/API-1393)
+
+# [6.120.0](https://github.com/tillhub/schemas/compare/v6.119.0...v6.120.0) (2022-02-17)
+
+
+### Features
+
+* **branches:** add detailed branches schema #API-1392 ([#671](https://github.com/tillhub/schemas/issues/671)) ([3232d2b](https://github.com/tillhub/schemas/commit/3232d2b)), closes [#API-1392](https://github.com/tillhub/schemas/issues/API-1392) [#API-1392](https://github.com/tillhub/schemas/issues/API-1392)
+
+# [6.119.0](https://github.com/tillhub/schemas/compare/v6.118.1...v6.119.0) (2022-02-15)
+
+
+### Features
+
+* **audits:** add audit logs response schema #API-1331 ([#668](https://github.com/tillhub/schemas/issues/668)) ([057c73e](https://github.com/tillhub/schemas/commit/057c73e)), closes [#API-1331](https://github.com/tillhub/schemas/issues/API-1331) [#API-1331](https://github.com/tillhub/schemas/issues/API-1331)
+
+## [6.118.1](https://github.com/tillhub/schemas/compare/v6.118.0...v6.118.1) (2022-02-14)
+
+
+### Bug Fixes
+
+* **docs:** fixing the children type on category_trees ([141dc8e](https://github.com/tillhub/schemas/commit/141dc8e))
+
 # [6.118.0](https://github.com/tillhub/schemas/compare/v6.117.1...v6.118.0) (2022-02-10)
 
 

package/lib/common/address.js

@@ -1,7 +1,7 @@
-module.exports = {
-  type: 'object',
-  additionalProperties: false,
-  required: [
+const { oneOf } = require('../helpers/payload-or-null')
+
+function getAddress ({
+  required = [
     'lines',
     'street',
     'locality',
@@ -10,10 +10,21 @@ module.exports = {
     'country',
     'type'
   ],
-  properties: {
-    lines: {
-      oneOf: [
-        {
+  availableTypes = [
+    'local',
+    'delivery',
+    'billing'
+  ]
+} = {}) {
+  return {
+    type: 'object',
+    additionalProperties: false,
+    required,
+    properties: {
+      lines: {
+        description: 'Address details',
+        example: 'Penthouse',
+        ...oneOf({
           type: 'array',
           minItems: 1,
           maxItems: 4,
@@ -21,91 +32,65 @@ module.exports = {
             type: 'string',
             minLength: 1
           }
-        },
-        {
-          type: 'null'
-        }
-      ]
-    },
-    street: {
-      oneOf: [
-        {
+        })
+      },
+      street: {
+        description: 'Street name',
+        example: 'Genthiner Str.',
+        ...oneOf({
           type: 'string'
-        },
-        {
-          type: 'null'
-        }
-      ]
-    },
-    street_number: {
-      oneOf: [
-        {
+        })
+      },
+      street_number: {
+        description: 'Building number',
+        example: '34',
+        ...oneOf({
           type: 'string'
-        },
-        {
-          type: 'null'
-        }
-      ]
-    },
-    locality: {
-      oneOf: [
-        {
+        })
+      },
+      locality: {
+        description: 'Locality name (city, village, etc.)',
+        example: 'Berlin',
+        ...oneOf({
           type: 'string'
-        },
-        {
-          type: 'null'
-        }
-      ]
-    },
-    region: {
-      oneOf: [
-        {
+        })
+      },
+      region: {
+        description: 'Region name',
+        example: 'Branderburg',
+        ...oneOf({
           type: 'string'
-        },
-        {
-          type: 'null'
-        }
-      ]
-    },
-    postal_code: {
-      oneOf: [
-        {
+        })
+      },
+      postal_code: {
+        description: 'Postal code',
+        example: '10785',
+        ...oneOf({
           type: 'string',
           maxLength: 10
-        },
-        {
-          type: 'null'
-        }
-      ]
-    },
-    country: {
-      oneOf: [
-        {
+        })
+      },
+      country: {
+        description: 'Country',
+        example: 'Germany',
+        ...oneOf({
           type: 'string',
           minLength: 2,
           maxLength: 2,
           pattern: '^[A-Z]{2}$'
-        },
-        {
-          type: 'null'
-        }
-      ],
-      'default': null
-    },
-    type: {
-      oneOf: [
-        {
+        }),
+        'default': null
+      },
+      type: {
+        description: 'Address type',
+        example: 'delivery',
+        ...oneOf({
           type: 'string',
-          'enum': [
-            'local',
-            'delivery',
-            'billing'
-          ]
-        },
-        {
-          type: 'null'
-        }
-      ]
+          'enum': availableTypes
+        })
+      }
     }
   }
 }
+
+module.exports = { getAddress }

package/lib/common/base.js

@@ -5,16 +5,19 @@
 function baseObject (options = {}) {
   return {
     id: {
+      description: 'Unique entity ID',
       type: 'string',
       format: 'uuid',
       example: '936835f7-2d75-41d2-9001-38ed6e458328'
     },
     created_at: {
+      description: 'The date and time entity was created',
       type: 'string',
       format: 'date-time',
       example: '2019-03-17T21:12:04.849Z'
     },
     updated_at: {
+      description: 'The date and time entity was updated',
       type: 'string',
       format: 'date-time',
       example: '2019-03-17T21:12:04.849Z'

package/lib/common/images.js

@@ -0,0 +1,63 @@
+const definedSizes = {
+  '1x': {
+    description: 'Image transformed to predefined small size',
+    example: 'https://my-storage.io/images/f5a3cc72-7fb5-4d2c-bda5-9b2983c7e879_1x.png',
+    type: 'string',
+    format: 'uri'
+  },
+  '2x': {
+    description: 'Image transformed to predefined medium size',
+    example: 'https://my-storage.io/images/f5a3cc72-7fb5-4d2c-bda5-9b2983c7e879_2x.png',
+    type: 'string',
+    format: 'uri'
+  },
+  '3x': {
+    description: 'Image transformed to predefined big size',
+    example: 'https://my-storage.io/images/f5a3cc72-7fb5-4d2c-bda5-9b2983c7e879_1x.png',
+    type: 'string',
+    format: 'uri'
+  },
+  gallery: {
+    description: 'Image transformed to predefined size to use in gallery',
+    example: 'https://my-storage.io/images/f5a3cc72-7fb5-4d2c-bda5-9b2983c7e879_gallery.png',
+    type: 'string',
+    format: 'uri'
+  },
+  avatar: {
+    description: 'Image transformed to predefined size to use as "avatar"',
+    example: 'https://my-storage.io/images/f5a3cc72-7fb5-4d2c-bda5-9b2983c7e879_avatar.png',
+    type: 'string',
+    format: 'uri'
+  }
+}
+
+function getImages (sizes = ['1x', '2x', '3x', 'avatar'], strict = false) {
+  const sizesMap = sizes.reduce((memo, size) => {
+    if (!definedSizes[size]) {
+      throw new ReferenceError(`Size '${size}' is not defined`)
+    }
+
+    memo[size] = { ...definedSizes[size] }
+    return memo
+  }, {})
+
+  return {
+    description: 'Images object with URLs of various types of images',
+    anyOf: [{
+      type: 'object',
+      additionalProperties: !strict,
+      properties: {
+        ...sizesMap,
+        original: {
+          description: 'Original image',
+          example: 'https://my-storage.io/images/f5a3cc72-7fb5-4d2c-bda5-9b2983c7e879.png',
+          type: 'string',
+          format: 'uri'
+        }
+      } }, {
+      type: 'null'
+    }]
+  }
+}
+
+module.exports = { getImages }

package/lib/common/query.js

@@ -0,0 +1,64 @@
+const standardParams = {
+  start: {
+    description: 'The start date to filter entities by "updated_at" field value',
+    example: '2022-02-01T00:00:00.000Z',
+    type: 'string',
+    format: 'date-time'
+  },
+  end: {
+    description: 'The end date to filter entities by "updated_at" field value',
+    example: '2022-02-28T23:59:59.999Z',
+    type: 'string',
+    format: 'date-time'
+  },
+  limit: {
+    description: 'The maximum amount of entries on page (for paginated output)',
+    example: 50,
+    type: 'integer',
+    minimum: 1
+  },
+  active: {
+    description: 'Filter entities by "active" field value',
+    example: 'true',
+    type: 'string',
+    enum: ['true', 'false']
+  },
+  deleted: {
+    description: 'Filter entities which are deleted or not',
+    example: 'true',
+    type: 'string',
+    enum: ['true', 'false']
+  }
+}
+
+/**
+ * Generate a common query for entities set
+ * @param {Object} required Required fields to restrict the amount of entries
+ */
+function getQuery ({
+  standard = ['start', 'end'],
+  required = ['start', 'end'],
+  additional = {}
+} = {}) {
+  const properties = standard.reduce((memo, paramName) => {
+    if (!standardParams[paramName]) {
+      throw new ReferenceError(`Parameter '${paramName}' is not standard`)
+    }
+
+    memo[paramName] = { ...standardParams[paramName] }
+
+    return memo
+  }, {})
+
+  Object.assign(properties, additional)
+
+  return {
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    additionalProperties: false,
+    type: 'object',
+    required,
+    properties
+  }
+}
+
+module.exports = getQuery

package/lib/common/response.js

@@ -1,25 +1,26 @@
 const cursor = {
   type: 'object',
+  description: 'Optional cursor in paginated API calls. The cursor next field must be called as fully quantifiable URI in order to hit the next if available.',
   additionalProperties: false,
-  description: 'Optional cursor in pagable API calls. The cursor next field must be called as fully qualifyable URI in order to hit the next page',
+  required: ['self'],
   properties: {
     next: {
       type: 'string',
       format: 'uri',
       description: 'The URI pointing to the next page.',
-      example: 'https://api.tillhub.com/api/v1/products/061f91a3-eba2-40b8-9a76-115189d6741e?first=2018-07-02T21%3A47%3A44.382Z&page=0&size=10&cursor_field=updated_at'
+      example: 'https://api.tillhub.com/api/v1/products/061f91a3-eba2-40b8-9a76-115189d6741e?cursor=2018-07-02T21%3A47%3A44.382Z&size=10&cursor_field=updated_at'
     },
     first: {
       type: 'string',
       format: 'uri',
       description: 'The URI pointing to the the first page.',
-      example: 'https://api.tillhub.com/api/v1/products/061f91a3-eba2-40b8-9a76-115189d6741e?first=2018-07-02T21%3A47%3A44.382Z&page=1&size=10&cursor_field=updated_at'
+      example: 'https://api.tillhub.com/api/v1/products/061f91a3-eba2-40b8-9a76-115189d6741e?cursor=2018-07-02T21%3A47%3A44.382Z&size=10&cursor_field=updated_at'
     },
     self: {
       type: 'string',
       format: 'uri',
       description: 'The URI pointing to this page.',
-      example: 'https://api.tillhub.com/api/v1/products/061f91a3-eba2-40b8-9a76-115189d6741e?first=2018-07-02T21%3A47%3A44.382Z&page=0&size=10&cursor_field=updated_at'
+      example: 'https://api.tillhub.com/api/v1/products/061f91a3-eba2-40b8-9a76-115189d6741e?cursor=2018-07-02T21%3A47%3A44.382Z&size=10&cursor_field=updated_at'
     }
   }
 }
@@ -47,14 +48,14 @@ function commonResponse ({ resultItems, results, additionals } = {}, { hasCursor
       msg: {
         type: 'string',
         minLength: 1,
-        example: 'Queried transactions sucessefully.',
-        description: 'Any English sentence, meant as information for developers and implementers. Avoid displaying this to the users and especially do not expect thos messages to stay stable.'
+        example: 'Queried transactions successfully.',
+        description: 'Any English sentence, meant as information for developers and implementers. Avoid displaying this to the users and especially do not expect those messages to stay stable.'
       },
       msg_localised: {
+        description: 'Optional localized message that can be displayed to the user if existing. The language can be set by in the request or will fallback to English.',
+        example: 'Abgefragte Transaktionen erfolgreich.',
         type: 'string',
-        minLength: 1,
-        example: 'Queried transactions sucessefully.',
-        description: 'Optional localised message that can be displayed to the user if existing. The language can be set by in the request or will fallback to English.'
+        minLength: 1
       },
       request: {
         type: 'object',
@@ -84,7 +85,7 @@ function commonResponse ({ resultItems, results, additionals } = {}, { hasCursor
     }
   }
 
-  if (hasCursor) response.cursor = cursor
+  if (hasCursor) response.properties.cursor = cursor
 
   return response
 }

package/lib/v0/audits/index.js

@@ -0,0 +1,3 @@
+module.exports = {
+  logs: require('./logs')
+}

package/lib/v0/audits/logs/base.js

@@ -0,0 +1,81 @@
+const { oneOf } = require('../../../helpers/payload-or-null')
+
+const changeEntry = {
+  type: 'object',
+  additionalProperties: false,
+  properties: {
+    op: {
+      description: 'Operation type',
+      type: 'string',
+      enum: [
+        'add',
+        'replace',
+        'remove'
+      ]
+    },
+    path: {
+      description: 'Changed property path (with dot as separator)',
+      type: 'string',
+      example: 'images.0.url'
+    },
+    value: {
+      description: 'Changed value',
+      type: 'string',
+      example: 'This is it'
+    }
+  }
+}
+
+module.exports = {
+  type: {
+    description: 'Log type (entity type and action type)',
+    type: 'string',
+    example: 'product.update'
+  },
+  old: oneOf({
+    description: 'Old data',
+    type: 'object',
+    example: {}
+  }),
+  new: oneOf({
+    description: 'New data',
+    type: 'object',
+    example: {
+      id: '0f91b67b-b1eb-4aba-827a-3a83ff967c5e',
+      name: 'Foo bar'
+    }
+  }),
+  change: oneOf({
+    description: 'Changes between old and new',
+    type: 'array',
+    items: changeEntry
+  }),
+  description: oneOf({
+    description: 'Description',
+    type: 'string',
+    example: 'Login attempt from service account'
+  }),
+  issuer: oneOf({
+    description: 'Issuer data',
+    type: 'object',
+    properties: {
+      sub_user: {
+        description: 'Sub-user (person authorized under organization account) UUID',
+        type: 'string',
+        format: 'uuid',
+        example: '8ddb94bf-98cf-4832-9833-c118ebf04675'
+      }
+    }
+  }),
+  metadata: oneOf({
+    description: 'Metadata',
+    type: 'object',
+    properties: {
+      user_agent: {
+        description: 'User-agent data',
+        type: 'string',
+        example: 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/97.0.4692.99 Safari/537.36'
+      }
+    }
+  })
+}

package/lib/v0/audits/logs/index.js

@@ -0,0 +1,3 @@
+module.exports = {
+  read: require('./read')
+}

package/lib/v0/audits/logs/read.js

@@ -0,0 +1,30 @@
+const commonBase = { ...require('../../../common/base') }
+const commonResponse = require('../../../common/response')
+const { oneOf } = require('../../../helpers/payload-or-null')
+
+const base = require('./base')
+
+// Logs are read-only
+delete commonBase.updated_at
+
+module.exports.response = {
+  $id: 'https://schemas.tillhub.com/v0/audits.logs.read.response.schema.json',
+  $schema: 'http://json-schema.org/draft-07/schema#',
+  additionalProperties: false,
+  ...commonResponse({
+    resultItems: {
+      type: 'object',
+      required: ['id', 'created_at', 'insert_id', 'type'],
+      additionalProperties: false,
+      properties: {
+        ...commonBase,
+        insert_id: oneOf({
+          description: 'Sequential counter',
+          type: 'integer',
+          example: 16259
+        }),
+        ...base
+      }
+    }
+  }, { hasCursor: true })
+}