@unito/integration-api 8.0.6 → 8.0.8

package/dist/schemas/createItemResponsePayload.json

@@ -0,0 +1,58 @@
+{
+  "$id": "https://unito.io/integration_api/createItemResponsePayload.schema.json",
+  "title": "CreateItemResponsePayload",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["path", "canonicalPath"],
+  "properties": {
+    "path": {
+      "type": "string",
+      "format": "uri-reference",
+      "pattern": "^\/.*$"
+    },
+    "fields": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "relations": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string",
+        "format": "uri-reference",
+        "pattern": "^\/.*$"
+      }
+    },
+    "requestSchema": {
+      "$ref": "https://unito.io/integration_api/requestSchema.schema.json"
+    },
+    "canonicalPath": {
+      "type": "string"
+    },
+    "errors": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["source", "code", "message"],
+        "properties": {
+          "source": {
+            "type": "string"
+          },
+          "code": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          },
+          "details": {
+            "type": "object",
+            "additionalProperties": true
+          },
+          "originalError": {
+            "$ref": "https://unito.io/integration_api/error.schema.json"
+          }
+        }
+      }
+    }
+  }
+}

package/dist/schemas/updateItemResponsePayload.json

@@ -0,0 +1,48 @@
+{
+  "$id": "https://unito.io/integration_api/updateItemResponsePayload.schema.json",
+  "title": "UpdateItemResponsePayload",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["fields", "relations", "canonicalPath"],
+  "properties": {
+    "fields": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "relations": {
+      "type": "array",
+      "items": {
+        "$ref": "https://unito.io/integration_api/relation.schema.json"
+      }
+    },
+    "canonicalPath": {
+      "type": "string"
+    },
+    "errors": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["source", "code", "message"],
+        "properties": {
+          "source": {
+            "type": "string"
+          },
+          "code": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          },
+          "details": {
+            "type": "object",
+            "additionalProperties": true
+          },
+          "originalError": {
+            "$ref": "https://unito.io/integration_api/error.schema.json"
+          }
+        }
+      }
+    }
+  }
+}

package/dist/src/compatibilities.d.ts

@@ -407,7 +407,7 @@ export declare const fieldTypeCompatibilityMatrix: {
         readonly richText: {};
         readonly html: {};
         readonly markdown: {};
-        readonly string: null;
+        readonly string: {};
         readonly url: null;
     };
     readonly html: {

package/dist/src/compatibilities.js

@@ -349,7 +349,7 @@ export const fieldTypeCompatibilityMatrix = {
         [Api.FieldValueTypes.RICH_TEXT]: {},
         [Api.FieldValueTypes.RICH_TEXT_HTML]: {},
         [Api.FieldValueTypes.RICH_TEXT_MARKDOWN]: {},
-        [Api.FieldValueTypes.STRING]: null,
+        [Api.FieldValueTypes.STRING]: {},
         [Api.FieldValueTypes.URL]: null,
     },
     [Api.FieldValueTypes.RICH_TEXT_HTML]: {

package/dist/src/index.cjs

@@ -102,9 +102,6 @@ const StatusCodes = {
  */
 const RelationSchemaDefaultValues = {
     CAN_READ_ITEM: true,
-    CAN_CREATE_ITEM: true,
-    CAN_UPDATE_ITEM: true,
-    CAN_DELETE_ITEM: false,
     CAN_ADD_FIELDS: false,
 };
 /**
@@ -628,7 +625,7 @@ const fieldTypeCompatibilityMatrix = {
         [FieldValueTypes.RICH_TEXT]: {},
         [FieldValueTypes.RICH_TEXT_HTML]: {},
         [FieldValueTypes.RICH_TEXT_MARKDOWN]: {},
-        [FieldValueTypes.STRING]: null,
+        [FieldValueTypes.STRING]: {},
         [FieldValueTypes.URL]: null,
     },
     [FieldValueTypes.RICH_TEXT_HTML]: {

package/dist/src/types.d.ts

@@ -536,6 +536,31 @@ export type UpdateItemRequestPayload = CreateItemRequestPayload & {
         };
     };
 };
+/**
+ * Describes a field the integration accepted in the request body but did not send to,
+ * or that was not successfully accepted by, the provider. Reported alongside a 2xx
+ * response so the caller knows the resource was created/updated but the listed
+ * locations were dropped.
+ */
+export type FieldError = Error & {
+    /**
+     * JSONPath query (dot/bracket notation) locating the problematic field on the request body.
+     * e.g. "name", "customFields.priority", "tags[0]"
+     */
+    source: string;
+};
+/**
+ * A CreateItemResponsePayload describes the shape of a response from an item creation endpoint.
+ */
+export type CreateItemResponsePayload<T extends RelationSchema | undefined = undefined> = ItemSummary<T> & {
+    errors?: FieldError[];
+};
+/**
+ * An UpdateItemResponsePayload describes the shape of a response from an item update endpoint.
+ */
+export type UpdateItemResponsePayload<T extends RelationSchema | undefined = undefined> = Item<T> & {
+    errors?: FieldError[];
+};
 /**
  * A Request Schema describes how a path should be accessed.
  */
@@ -691,9 +716,6 @@ export type WebhookParseResponsePayload = WebhookParsedItem | WebhookItem | (Web
  */
 export declare const RelationSchemaDefaultValues: {
     readonly CAN_READ_ITEM: true;
-    readonly CAN_CREATE_ITEM: true;
-    readonly CAN_UPDATE_ITEM: true;
-    readonly CAN_DELETE_ITEM: false;
     readonly CAN_ADD_FIELDS: false;
 };
 /**

package/dist/src/types.js

@@ -100,9 +100,6 @@ export const StatusCodes = {
  */
 export const RelationSchemaDefaultValues = {
     CAN_READ_ITEM: true,
-    CAN_CREATE_ITEM: true,
-    CAN_UPDATE_ITEM: true,
-    CAN_DELETE_ITEM: false,
     CAN_ADD_FIELDS: false,
 };
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unito/integration-api",
-  "version": "8.0.6",
+  "version": "8.0.8",
   "description": "The Unito Integration API",
   "type": "module",
   "types": "./dist/src/index.d.ts",