@tillhub/schemas 6.128.0 → 6.131.0

package/CHANGELOG.md

@@ -1,3 +1,27 @@
+# [6.131.0](https://github.com/tillhub/schemas/compare/v6.130.0...v6.131.0) (2022-03-29)
+
+
+### Features
+
+* **customers:** Make bare minimum mandatory in customer creation schema ([#684](https://github.com/tillhub/schemas/issues/684)) ([ebc4273](https://github.com/tillhub/schemas/commit/ebc4273))
+* **customers:** Make bare minimum mandatory in customer creation schema ([#685](https://github.com/tillhub/schemas/issues/685)) ([5d95430](https://github.com/tillhub/schemas/commit/5d95430))
+
+# [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)
 
 

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/v0/customers/base.js

@@ -24,10 +24,8 @@ module.exports = {
   lastname: {
     example: 'Fett',
     description: 'Last name',
-    ...anyOf({
-      type: 'string',
-      maxLength: 128
-    })
+    type: 'string',
+    maxLength: 128
   },
   middlename: {
     description: 'Middle name',

package/lib/v0/customers/create.js

@@ -1,4 +1,3 @@
-const { anyOf } = require('../../helpers/payload-or-null')
 const baseObject = require('../../common/base')
 const commonResponse = require('../../common/response')
 
@@ -11,17 +10,9 @@ module.exports = {
     additionalProperties: false,
     type: 'object',
     properties: base,
-    ...anyOf([{
-      required: [
-        'firstname'
-      ]
-    }, {
-      required: [
-        'lastname'
-      ]
-    }
-    ]),
-    required: []
+    required: [
+      'lastname'
+    ]
   },
   response: {
     $id: 'https://schemas.tillhub.com/v0/customers.create.response.schema.json',

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.128.0",
+  "version": "6.131.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'
-  }
-}