feat(Template): add Template utility

package.json

@@ -1,6 +1,6 @@
 {
   "name": "moysklad-api-model",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Объектная модель API МойСклад для TypeScript проектов",
   "main": "build/src/index.js",
   "types": "build/src/index.d.ts",

src/model/EntityRef.ts

@@ -7,5 +7,6 @@ import type { MetaType } from './MetaType'
 
 export interface EntityRef<T extends MetaType = MetaType>
   extends MoyskladObject {
+  /** Метаданные сущности */
   readonly meta: Meta<T>
 }

src/model/utils/Template.ts

@@ -0,0 +1,18 @@
+import type { Document, DocumentMetaType } from '../Document'
+
+// TODO Указать конкретные типы документов которые можно создавать этим методом
+
+// TODO API гибок и позволяет отправлять при создании объекта не обязательные
+// и лишние поля. В типах нельзя позволять такую вольность, хотя на практике
+// подобное может быть удобно.
+
+// Другими словами, при получении шаблона его необходимо будет деструктурировать
+// в случае, когда шаблон ынужно обогащать доп. данными
+
+/**
+ * Шаблон нового документа `/entity/{type}/new`
+ */
+export type Template<T extends Document<DocumentMetaType>> = Omit<
+  T,
+  'meta' | 'id' | 'accountId' | 'updated'
+>

src/model/utils/index.ts

@@ -1,5 +1,6 @@
 export * from './Expand'
 export * from './Patch'
+export * from './Template'
 
 // https://stackoverflow.com/questions/49579094/typescript-conditional-types-filter-out-readonly-properties-pick-only-requir
 

test/model/utils/Template.test.ts

@@ -0,0 +1,8 @@
+import type { CustomerOrder, Template } from '../../../src'
+
+const t1 = {} as Template<CustomerOrder>
+
+// @ts-expect-error
+t1.id
+
+t1.agent.meta