feat-model-push-unique (#159)

* feat: add `pushUnique` method to ensure an array doesn't contain duplicates

* chore: update files modified by CI [skip ci]

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

packages/model/docs/classes/Model.md

@@ -49,6 +49,7 @@ Create a simple object model
 - [patch](Model.md#patch)
 - [pull](Model.md#pull)
 - [push](Model.md#push)
+- [pushUnique](Model.md#pushunique)
 - [remove](Model.md#remove)
 - [set](Model.md#set)
 - [toJSON](Model.md#tojson)
@@ -538,6 +539,25 @@ Push a value to an array path
 
 ___
 
+### pushUnique
+
+▸ **pushUnique**(`key`, `value`): [`Model`](Model.md)<`T`, `D`\>
+
+Push a value to an array path if it doesn't exist
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `key` | [`ModelKey`](../README.md#modelkey) |
+| `value` | `any` |
+
+#### Returns
+
+[`Model`](Model.md)<`T`, `D`\>
+
+___
+
 ### remove
 
 ▸ **remove**(`key`): [`Model`](Model.md)<`T`, `D`\>

packages/model/src/index.ts

@@ -15,7 +15,7 @@ import {
 	uuid,
 	VariableType
 } from '@snickbit/utilities'
-import objectPath, {ObjectPathBound} from 'object-path'
+import objectPath, {ensureExists, ObjectPathBound} from 'object-path'
 
 export type ModelId = number | string | undefined
 
@@ -462,11 +462,22 @@ export class Model<T extends object = any, D = Partial<T>> {
 	/**
 	 * Push a value to an array path
 	 */
-	push(key: ModelKey, ...values) {
+	push(key: ModelKey, ...values: any[]) {
 		this.data.push(this.checkKey(key), ...values)
 		return this
 	}
 
+	/**
+	 * Push a value to an array path if it doesn't exist
+	 */
+	pushUnique(key: ModelKey, value: ModelValue) {
+		const current = this.get(key)
+		if (!current.includes(value)) {
+			this.push(key, value)
+		}
+		return this
+	}
+
 	/**
 	 * Get the value of a path and remove it
 	 */