@tillhub/schemas 6.127.0 → 6.130.0

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+# [6.130.0](https://github.com/tillhub/schemas/compare/v6.129.0...v6.130.0) (2022-03-24)
+
+
+### Features
+
+* **configuration:** features ([e15fedd](https://github.com/tillhub/schemas/commit/e15fedd))
+* **configurations:** features ([bfc0bf2](https://github.com/tillhub/schemas/commit/bfc0bf2))
+* **configurations:** features ([66bcd70](https://github.com/tillhub/schemas/commit/66bcd70))
+
+# [6.129.0](https://github.com/tillhub/schemas/compare/v6.128.0...v6.129.0) (2022-03-21)
+
+
+### Features
+
+* **reasons:** add type "POS price change" #API-1409 ([#683](https://github.com/tillhub/schemas/issues/683)) ([1de76ff](https://github.com/tillhub/schemas/commit/1de76ff)), closes [#API-1409](https://github.com/tillhub/schemas/issues/API-1409) [#API-1409](https://github.com/tillhub/schemas/issues/API-1409)
+
+# [6.128.0](https://github.com/tillhub/schemas/compare/v6.127.0...v6.128.0) (2022-03-18)
+
+
+### Features
+
+* **branches:** add receipt_footer_image to branches model ([#682](https://github.com/tillhub/schemas/issues/682)) ([132523f](https://github.com/tillhub/schemas/commit/132523f))
+
 # [6.127.0](https://github.com/tillhub/schemas/compare/v6.126.0...v6.127.0) (2022-03-15)
 
 

package/lib/common/base.js

@@ -1,8 +1,18 @@
+const dateObject = require('./date_object')
+
 /**
  * Create common base object
  * @param {Object} [options]
  */
-function baseObject (options = {}) {
+function baseObject ({
+  splitDate = false
+} = {}) {
+  const dateType = splitDate ? dateObject : {
+    type: 'string',
+    format: 'date-time',
+    example: '2019-03-17T21:12:04.849Z'
+  }
+
   return {
     id: {
       description: 'Unique entity ID',
@@ -11,16 +21,12 @@ function baseObject (options = {}) {
       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'
+      ...dateType,
+      description: 'The date and time entity was created'
     },
     updated_at: {
-      description: 'The date and time entity was updated',
-      type: 'string',
-      format: 'date-time',
-      example: '2019-03-17T21:12:04.849Z'
+      ...dateType,
+      description: 'The date and time entity was updated'
     }
   }
 }

package/lib/common/images.js

@@ -1,3 +1,5 @@
+const { anyOf } = require('../helpers/payload-or-null')
+
 const definedSizes = {
   '1x': {
     description: 'Image transformed to predefined small size',
@@ -31,7 +33,11 @@ const definedSizes = {
   }
 }
 
-function getImages (sizes = ['1x', '2x', '3x', 'avatar'], strict = false) {
+const getImages = ({
+  sizes = ['1x', '2x', '3x', 'avatar'],
+  strict = false,
+  description = 'Images object with URLs of various types of images'
+}) => {
   const sizesMap = sizes.reduce((memo, size) => {
     if (!definedSizes[size]) {
       throw new ReferenceError(`Size '${size}' is not defined`)
@@ -42,8 +48,8 @@ function getImages (sizes = ['1x', '2x', '3x', 'avatar'], strict = false) {
   }, {})
 
   return {
-    description: 'Images object with URLs of various types of images',
-    anyOf: [{
+    description,
+    ...anyOf({
       type: 'object',
       additionalProperties: !strict,
       properties: {
@@ -54,9 +60,8 @@ function getImages (sizes = ['1x', '2x', '3x', 'avatar'], strict = false) {
           type: 'string',
           format: 'uri'
         }
-      } }, {
-      type: 'null'
-    }]
+      }
+    })
   }
 }
 

package/lib/v0/branches/base.js

@@ -124,7 +124,12 @@ module.exports = {
       }
     ]
   },
-  images: getImages(),
+  images: getImages({
+    description: 'A Tillhub image object with URLs to display images this for this branch.'
+  }),
+  receipt_footer_images: getImages({
+    description: 'A Tillhub image object with URLs to display receipt footer image this for this branch.'
+  }),
   image: {
     description: 'DEPRECATED. Omit or set null.',
     anyOf: [

package/lib/v0/customers/base.js

@@ -154,7 +154,7 @@ module.exports = {
       format: 'date-time'
     })
   },
-  images: getImages(['1x', '2x', '3x', 'avatar', 'gallery']),
+  images: getImages({ sizes: ['1x', '2x', '3x', 'avatar', 'gallery'] }),
   image: {
     description: 'DEPRECATED. Omit or set null.',
     ...anyOf({

package/lib/v0/reasons/base.js

@@ -3,6 +3,8 @@ const { oneOf } = require('../../helpers/payload-or-null')
 module.exports = {
   name: {
     ...oneOf([{
+      description: 'The reason name',
+      example: 'Returned goods',
       type: 'string',
       minLength: 1,
       maxLength: 128
@@ -10,6 +12,8 @@ module.exports = {
   },
   description: {
     ...oneOf([{
+      description: 'The reason description',
+      example: 'Goods were returned by the customer',
       type: 'string',
       minLength: 1,
       maxLength: 4096
@@ -56,26 +60,33 @@ module.exports = {
     type: 'boolean'
   },
   active: {
+    description: 'The reason is active',
     type: 'boolean'
   },
   type: {
+    description: 'The reason type',
+    example: 'expense',
     type: 'string',
     enum: [
       'refund',
+      'pos_price_change',
       'stock_change',
       'expense',
       'deposit'
     ]
   },
   noted_required: {
+    description: 'The action must be noted',
     type: 'boolean',
     default: false
   },
   image_required: {
+    description: 'The image must be enclosed',
     type: 'boolean',
     default: false
   },
   approval_required: {
+    description: 'The action must be approved by supervisor',
     type: 'boolean',
     default: false
   }

package/lib/v0/reasons/create.js

@@ -1,5 +1,5 @@
+const baseObject = require('../../common/base')
 const base = require('./base')
-const defaultResponse = require('./default-response')
 
 module.exports.request = {
   $id: 'https://schemas.tillhub.com/v0/reasons.create.request.schema.json',
@@ -22,5 +22,8 @@ module.exports.response = {
     'id',
     'name'
   ],
-  properties: defaultResponse
+  properties: {
+    ...baseObject(),
+    ...base
+  }
 }

package/lib/v0/reasons/index.js

@@ -1,2 +1,3 @@
 module.exports.create = require('./create')
+module.exports.read = require('./read')
 module.exports.update = require('./update')

package/lib/v0/reasons/read.js

@@ -0,0 +1,38 @@
+const baseObject = require('../../common/base')
+const commonResponse = require('../../common/response')
+
+const base = require('./base')
+
+module.exports.all = {
+  response: {
+    $id: 'https://schemas.tillhub.com/v0/reasons.read.all.response.schema.json',
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    ...commonResponse({
+      resultItems: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          ...baseObject({ splitDate: true }),
+          ...base
+        }
+      }
+    })
+  }
+}
+
+module.exports.one = {
+  response: {
+    $id: 'https://schemas.tillhub.com/v0/reasons.read.one.response.schema.json',
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    ...commonResponse({
+      resultItems: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          ...baseObject({ splitDate: true }),
+          ...base
+        }
+      }
+    })
+  }
+}

package/lib/v0/reasons/update.js

@@ -1,5 +1,5 @@
+const baseObject = require('../../common/base')
 const base = require('./base')
-const defaultResponse = require('./default-response')
 
 module.exports.request = {
   $id: 'https://schemas.tillhub.com/v0/reasons.update.request.schema.json',
@@ -18,5 +18,8 @@ module.exports.response = {
   required: [
     'id'
   ],
-  properties: defaultResponse
+  properties: {
+    ...baseObject(),
+    ...base
+  }
 }

package/lib/v1/configurations/items/features.js

@@ -133,6 +133,49 @@ module.exports = oneOf({
           default: 'info'
         }
       }
+    }),
+    manual_reference: oneOf({
+      description: 'defines behavior for manually assigning external references to a cart',
+      type: 'object',
+      additionalProperties: false,
+      properties: {
+        enabled: {
+          description: 'Specifies if - for given conditions - an external reference can be assigned manually to a cart (e.g. via the cart menu).',
+          type: 'boolean',
+          default: false
+        },
+        request_on_checkout: {
+          description: 'Specifies if - for given conditions - an external reference will be requested on checkout (skippable).',
+          type: 'string',
+          enum: [
+            'never',
+            'if_missing',
+            'always'
+          ],
+          default: 'if_missing'
+        },
+        custom_prompt: oneOf({
+          description: 'Custom override of the question text before adding this reference manually.',
+          type: 'string',
+          example: 'There seems to be no order number set. Do you want to add it manually?',
+          minLength: 2,
+          maxLength: 512
+        }),
+        number_format: {
+          description: 'The format of the reference number that is being validated against the input',
+          type: 'string',
+          format: 'regex',
+          example: '^[_A-Za-z0-9-+]+(\\.[_A-Za-z0-9-+]+)*@[A-Za-z0-9-]+(\\.[A-Za-z0-9-]+)*(\\.[A-Za-z‌​]{2,})$',
+          default: '^(VAU)?[0-9]{7,11}$'
+        },
+        number_length_max: {
+          description: 'The maxiumum length of the reference number (as a helper for the UI)',
+          type: 'integer',
+          minimum: 2,
+          maximum: 99,
+          default: 14
+        }
+      }
     })
   }
 })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tillhub/schemas",
-  "version": "6.127.0",
+  "version": "6.130.0",
   "private": false,
   "description": "All Tillhub API OpenAPI 3 compatible JSON Schemas.",
   "main": "./lib/index.js",

package/lib/v0/reasons/default-response.js

@@ -1,17 +0,0 @@
-const base = require('./base')
-
-module.exports = {
-  ...base,
-  id: {
-    type: 'string',
-    format: 'uuid'
-  },
-  created_at: {
-    type: 'string',
-    format: 'date-time'
-  },
-  updated_at: {
-    type: 'string',
-    format: 'date-time'
-  }
-}