@twin.org/auditable-item-graph-models 0.0.3-next.9 → 0.9.0-next.2

package/dist/es/models/auditableItemGraphMetrics.js

@@ -0,0 +1,82 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { MetricType } from "@twin.org/telemetry-models";
+import { AuditableItemGraphMetricIds } from "./auditableItemGraphMetricIds.js";
+/**
+ * Metrics registered by the auditable item graph service.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export const AuditableItemGraphMetrics = [
+    {
+        id: AuditableItemGraphMetricIds.VerticesCreated,
+        label: "Vertices created",
+        type: MetricType.Counter
+    },
+    {
+        id: AuditableItemGraphMetricIds.VerticesUpdated,
+        label: "Vertices updated",
+        type: MetricType.Counter
+    },
+    {
+        id: AuditableItemGraphMetricIds.ChangesetsCreated,
+        label: "Changesets created",
+        type: MetricType.Counter
+    },
+    {
+        id: AuditableItemGraphMetricIds.AliasesAdded,
+        label: "Aliases added",
+        type: MetricType.Counter
+    },
+    {
+        id: AuditableItemGraphMetricIds.AliasesModified,
+        label: "Aliases modified",
+        type: MetricType.Counter
+    },
+    {
+        id: AuditableItemGraphMetricIds.AliasesDeleted,
+        label: "Aliases deleted",
+        type: MetricType.Counter
+    },
+    {
+        id: AuditableItemGraphMetricIds.ResourcesAdded,
+        label: "Resources added",
+        type: MetricType.Counter
+    },
+    {
+        id: AuditableItemGraphMetricIds.ResourcesModified,
+        label: "Resources modified",
+        type: MetricType.Counter
+    },
+    {
+        id: AuditableItemGraphMetricIds.ResourcesDeleted,
+        label: "Resources deleted",
+        type: MetricType.Counter
+    },
+    { id: AuditableItemGraphMetricIds.EdgesAdded, label: "Edges added", type: MetricType.Counter },
+    {
+        id: AuditableItemGraphMetricIds.EdgesModified,
+        label: "Edges modified",
+        type: MetricType.Counter
+    },
+    {
+        id: AuditableItemGraphMetricIds.EdgesDeleted,
+        label: "Edges deleted",
+        type: MetricType.Counter
+    },
+    {
+        id: AuditableItemGraphMetricIds.QueriesExecuted,
+        label: "Queries executed",
+        type: MetricType.Counter
+    },
+    {
+        id: AuditableItemGraphMetricIds.VerificationsSucceeded,
+        label: "Verifications succeeded",
+        type: MetricType.Counter
+    },
+    {
+        id: AuditableItemGraphMetricIds.VerificationsFailed,
+        label: "Verifications failed",
+        type: MetricType.Counter
+    }
+];
+//# sourceMappingURL=auditableItemGraphMetrics.js.map

package/dist/es/models/auditableItemGraphMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditableItemGraphMetrics.js","sourceRoot":"","sources":["../../../src/models/auditableItemGraphMetrics.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAyB,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E;;GAEG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,yBAAyB,GAAuB;IAC5D;QACC,EAAE,EAAE,2BAA2B,CAAC,eAAe;QAC/C,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,2BAA2B,CAAC,eAAe;QAC/C,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,2BAA2B,CAAC,iBAAiB;QACjD,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,2BAA2B,CAAC,YAAY;QAC5C,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,2BAA2B,CAAC,eAAe;QAC/C,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,2BAA2B,CAAC,cAAc;QAC9C,KAAK,EAAE,iBAAiB;QACxB,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,2BAA2B,CAAC,cAAc;QAC9C,KAAK,EAAE,iBAAiB;QACxB,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,2BAA2B,CAAC,iBAAiB;QACjD,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,2BAA2B,CAAC,gBAAgB;QAChD,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD,EAAE,EAAE,EAAE,2BAA2B,CAAC,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE;IAC9F;QACC,EAAE,EAAE,2BAA2B,CAAC,aAAa;QAC7C,KAAK,EAAE,gBAAgB;QACvB,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,2BAA2B,CAAC,YAAY;QAC5C,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,2BAA2B,CAAC,eAAe;QAC/C,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,2BAA2B,CAAC,sBAAsB;QACtD,KAAK,EAAE,yBAAyB;QAChC,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,2BAA2B,CAAC,mBAAmB;QACnD,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;CACD,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { type ITelemetryMetric, MetricType } from \"@twin.org/telemetry-models\";\nimport { AuditableItemGraphMetricIds } from \"./auditableItemGraphMetricIds.js\";\n\n/**\n * Metrics registered by the auditable item graph service.\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const AuditableItemGraphMetrics: ITelemetryMetric[] = [\n\t{\n\t\tid: AuditableItemGraphMetricIds.VerticesCreated,\n\t\tlabel: \"Vertices created\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: AuditableItemGraphMetricIds.VerticesUpdated,\n\t\tlabel: \"Vertices updated\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: AuditableItemGraphMetricIds.ChangesetsCreated,\n\t\tlabel: \"Changesets created\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: AuditableItemGraphMetricIds.AliasesAdded,\n\t\tlabel: \"Aliases added\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: AuditableItemGraphMetricIds.AliasesModified,\n\t\tlabel: \"Aliases modified\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: AuditableItemGraphMetricIds.AliasesDeleted,\n\t\tlabel: \"Aliases deleted\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: AuditableItemGraphMetricIds.ResourcesAdded,\n\t\tlabel: \"Resources added\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: AuditableItemGraphMetricIds.ResourcesModified,\n\t\tlabel: \"Resources modified\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: AuditableItemGraphMetricIds.ResourcesDeleted,\n\t\tlabel: \"Resources deleted\",\n\t\ttype: MetricType.Counter\n\t},\n\t{ id: AuditableItemGraphMetricIds.EdgesAdded, label: \"Edges added\", type: MetricType.Counter },\n\t{\n\t\tid: AuditableItemGraphMetricIds.EdgesModified,\n\t\tlabel: \"Edges modified\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: AuditableItemGraphMetricIds.EdgesDeleted,\n\t\tlabel: \"Edges deleted\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: AuditableItemGraphMetricIds.QueriesExecuted,\n\t\tlabel: \"Queries executed\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: AuditableItemGraphMetricIds.VerificationsSucceeded,\n\t\tlabel: \"Verifications succeeded\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: AuditableItemGraphMetricIds.VerificationsFailed,\n\t\tlabel: \"Verifications failed\",\n\t\ttype: MetricType.Counter\n\t}\n];\n"]}

package/dist/es/models/auditableItemGraphTypes.js

@@ -36,6 +36,18 @@ export const AuditableItemGraphTypes = {
     /**
      * Represents patch operation.
      */
-    PatchOperation: "AuditableItemGraphPatchOperation"
+    PatchOperation: "AuditableItemGraphPatchOperation",
+    /**
+     * Represents auditable item graph vertex version list.
+     */
+    VertexVersionList: "AuditableItemGraphVertexVersionList",
+    /**
+     * Represents auditable item graph partial vertex.
+     */
+    PartialVertex: "AuditableItemGraphPartialVertex",
+    /**
+     * Represents auditable item graph list patch.
+     */
+    ListPatch: "AuditableItemGraphListPatch"
 };
 //# sourceMappingURL=auditableItemGraphTypes.js.map

package/dist/es/models/auditableItemGraphTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"auditableItemGraphTypes.js","sourceRoot":"","sources":["../../../src/models/auditableItemGraphTypes.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AAEvC;;GAEG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACtC;;OAEG;IACH,MAAM,EAAE,0BAA0B;IAElC;;OAEG;IACH,UAAU,EAAE,8BAA8B;IAE1C;;OAEG;IACH,KAAK,EAAE,yBAAyB;IAEhC;;OAEG;IACH,QAAQ,EAAE,4BAA4B;IAEtC;;OAEG;IACH,IAAI,EAAE,wBAAwB;IAE9B;;OAEG;IACH,SAAS,EAAE,6BAA6B;IAExC;;OAEG;IACH,aAAa,EAAE,iCAAiC;IAEhD;;OAEG;IACH,cAAc,EAAE,kCAAkC;CACzC,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * The types of auditable item graph data.\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const AuditableItemGraphTypes = {\n\t/**\n\t * Represents auditable item graph vertex.\n\t */\n\tVertex: \"AuditableItemGraphVertex\",\n\n\t/**\n\t * Represents auditable item graph vertex list.\n\t */\n\tVertexList: \"AuditableItemGraphVertexList\",\n\n\t/**\n\t * Represents auditable item graph alias.\n\t */\n\tAlias: \"AuditableItemGraphAlias\",\n\n\t/**\n\t * Represents auditable item graph resource.\n\t */\n\tResource: \"AuditableItemGraphResource\",\n\n\t/**\n\t * Represents auditable item graph edge.\n\t */\n\tEdge: \"AuditableItemGraphEdge\",\n\n\t/**\n\t * Represents auditable item graph changeset.\n\t */\n\tChangeset: \"AuditableItemGraphChangeset\",\n\n\t/**\n\t * Represents auditable item graph changeset list.\n\t */\n\tChangesetList: \"AuditableItemGraphChangesetList\",\n\n\t/**\n\t * Represents patch operation.\n\t */\n\tPatchOperation: \"AuditableItemGraphPatchOperation\"\n} as const;\n\n/**\n * The types of auditable item graph data.\n */\nexport type AuditableItemGraphTypes =\n\t(typeof AuditableItemGraphTypes)[keyof typeof AuditableItemGraphTypes];\n"]}
+{"version":3,"file":"auditableItemGraphTypes.js","sourceRoot":"","sources":["../../../src/models/auditableItemGraphTypes.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AAEvC;;GAEG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACtC;;OAEG;IACH,MAAM,EAAE,0BAA0B;IAElC;;OAEG;IACH,UAAU,EAAE,8BAA8B;IAE1C;;OAEG;IACH,KAAK,EAAE,yBAAyB;IAEhC;;OAEG;IACH,QAAQ,EAAE,4BAA4B;IAEtC;;OAEG;IACH,IAAI,EAAE,wBAAwB;IAE9B;;OAEG;IACH,SAAS,EAAE,6BAA6B;IAExC;;OAEG;IACH,aAAa,EAAE,iCAAiC;IAEhD;;OAEG;IACH,cAAc,EAAE,kCAAkC;IAElD;;OAEG;IACH,iBAAiB,EAAE,qCAAqC;IAExD;;OAEG;IACH,aAAa,EAAE,iCAAiC;IAEhD;;OAEG;IACH,SAAS,EAAE,6BAA6B;CAC/B,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * The types of auditable item graph data.\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const AuditableItemGraphTypes = {\n\t/**\n\t * Represents auditable item graph vertex.\n\t */\n\tVertex: \"AuditableItemGraphVertex\",\n\n\t/**\n\t * Represents auditable item graph vertex list.\n\t */\n\tVertexList: \"AuditableItemGraphVertexList\",\n\n\t/**\n\t * Represents auditable item graph alias.\n\t */\n\tAlias: \"AuditableItemGraphAlias\",\n\n\t/**\n\t * Represents auditable item graph resource.\n\t */\n\tResource: \"AuditableItemGraphResource\",\n\n\t/**\n\t * Represents auditable item graph edge.\n\t */\n\tEdge: \"AuditableItemGraphEdge\",\n\n\t/**\n\t * Represents auditable item graph changeset.\n\t */\n\tChangeset: \"AuditableItemGraphChangeset\",\n\n\t/**\n\t * Represents auditable item graph changeset list.\n\t */\n\tChangesetList: \"AuditableItemGraphChangesetList\",\n\n\t/**\n\t * Represents patch operation.\n\t */\n\tPatchOperation: \"AuditableItemGraphPatchOperation\",\n\n\t/**\n\t * Represents auditable item graph vertex version list.\n\t */\n\tVertexVersionList: \"AuditableItemGraphVertexVersionList\",\n\n\t/**\n\t * Represents auditable item graph partial vertex.\n\t */\n\tPartialVertex: \"AuditableItemGraphPartialVertex\",\n\n\t/**\n\t * Represents auditable item graph list patch.\n\t */\n\tListPatch: \"AuditableItemGraphListPatch\"\n} as const;\n\n/**\n * The types of auditable item graph data.\n */\nexport type AuditableItemGraphTypes =\n\t(typeof AuditableItemGraphTypes)[keyof typeof AuditableItemGraphTypes];\n"]}

package/dist/es/schemas/AuditableItemGraphAlias.json

@@ -1,65 +1,58 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schema.twindev.org/aig/AuditableItemGraphAlias",
+    "title": "AuditableItemGraphAlias",
     "description": "Interface describing an alias for a vertex.",
     "type": "object",
     "properties": {
-        "id": {
-            "type": "string",
-            "description": "The id of the element."
-        },
-        "dateCreated": {
-            "type": "string",
-            "description": "The date/time of when the element was created. json-ld namespace:schema"
-        },
-        "dateModified": {
-            "type": "string",
-            "description": "The date/time of when the element was modified. json-ld namespace:schema"
-        },
-        "dateDeleted": {
-            "type": "string",
-            "description": "The date/time of when the element was deleted, as we never actually remove items. json-ld namespace:schema"
-        },
         "@context": {
             "anyOf": [
                 {
-                    "type": "string",
                     "const": "https://schema.twindev.org/aig/"
                 },
                 {
                     "type": "array",
-                    "minItems": 1,
                     "prefixItems": [
                         {
-                            "type": "string",
                             "const": "https://schema.twindev.org/aig/"
                         }
                     ],
                     "items": {
                         "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
-                    }
+                    },
+                    "minItems": 1
                 }
             ],
             "description": "JSON-LD Context."
         },
-        "type": {
+        "id": {
             "type": "string",
+            "description": "The id of the element."
+        },
+        "type": {
             "const": "AuditableItemGraphAlias",
             "description": "JSON-LD Type."
         },
         "annotationObject": {
             "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject",
-            "description": "The JSON-LD annotation object for the alias. json-ld namespace:twin-common"
+            "description": "The JSON-LD annotation object for the alias."
         },
         "aliasFormat": {
             "type": "string",
-            "description": "The format of the id in the alias. json-ld type:schema:Text"
+            "description": "The format of the id in the alias."
+        },
+        "unique": {
+            "type": "boolean",
+            "description": "Whether the alias should be unique across the graph, meaning that no other vertex can have the same alias. Defaults to false."
         }
     },
     "required": [
-        "@context",
         "id",
         "type"
     ],
-    "additionalProperties": false
+    "allOf": [
+        {
+            "$ref": "https://schema.twindev.org/aig/AuditableItemGraphAuditedElement"
+        }
+    ]
 }

package/dist/es/schemas/AuditableItemGraphAuditedElement.json

@@ -0,0 +1,25 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/aig/AuditableItemGraphAuditedElement",
+    "title": "AuditableItemGraphAuditedElement",
+    "description": "Interface describing the base properties for auditable elements.",
+    "type": "object",
+    "properties": {
+        "id": {
+            "type": "string",
+            "description": "The id of the element."
+        },
+        "dateCreated": {
+            "type": "string",
+            "description": "The date/time of when the element was created."
+        },
+        "dateModified": {
+            "type": "string",
+            "description": "The date/time of when the element was modified."
+        },
+        "dateDeleted": {
+            "type": "string",
+            "description": "The date/time of when the element was deleted, as we never actually remove items."
+        }
+    }
+}

package/dist/es/schemas/AuditableItemGraphChangeset.json

@@ -1,29 +1,27 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schema.twindev.org/aig/AuditableItemGraphChangeset",
+    "title": "AuditableItemGraphChangeset",
     "description": "Interface describing a set of changes to the vertex.",
     "type": "object",
     "properties": {
         "@context": {
             "type": "array",
-            "minItems": 2,
-            "description": "JSON-LD Context.",
             "prefixItems": [
                 {
-                    "type": "string",
                     "const": "https://schema.twindev.org/aig/"
                 },
                 {
-                    "type": "string",
                     "const": "https://schema.twindev.org/common/"
                 }
             ],
             "items": {
                 "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
-            }
+            },
+            "minItems": 2,
+            "description": "JSON-LD Context."
         },
         "type": {
-            "type": "string",
             "const": "AuditableItemGraphChangeset",
             "description": "JSON-LD Type."
         },
@@ -33,26 +31,30 @@
         },
         "dateCreated": {
             "type": "string",
-            "description": "The date/time of when the changeset was created. json-ld namespace:schema"
+            "description": "The date/time of when the changeset was created."
         },
         "userIdentity": {
             "type": "string",
-            "description": "The user identity that created the changes. json-ld namespace:twin-common"
+            "description": "The user identity that created the changes."
         },
         "patches": {
             "type": "array",
             "items": {
                 "$ref": "https://schema.twindev.org/aig/AuditableItemGraphPatchOperation"
             },
-            "description": "The patches in the changeset. json-ld container:set"
+            "description": "The patches in the changeset."
         },
         "proofId": {
             "type": "string",
-            "description": "The immutable proof id which contains the signature for this changeset. json-ld type:schema:identifier"
+            "description": "The immutable proof id which contains the signature for this changeset."
         },
         "verification": {
             "$ref": "https://schema.twindev.org/immutable-proof/ImmutableProofVerification",
-            "description": "The verification for the changeset. json-ld id"
+            "description": "The verification for the changeset."
+        },
+        "version": {
+            "type": "number",
+            "description": "The version number of the vertex after this changeset was applied.\nMaps to https://schema.org/version."
         }
     },
     "required": [
@@ -60,6 +62,5 @@
         "id",
         "dateCreated",
         "patches"
-    ],
-    "additionalProperties": false
+    ]
 }

package/dist/es/schemas/AuditableItemGraphEdge.json

@@ -1,73 +1,62 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schema.twindev.org/aig/AuditableItemGraphEdge",
+    "title": "AuditableItemGraphEdge",
     "description": "Interface describing an edge between two vertices in an auditable item graph.",
     "type": "object",
     "properties": {
-        "id": {
-            "type": "string",
-            "description": "The id of the element."
-        },
-        "dateCreated": {
-            "type": "string",
-            "description": "The date/time of when the element was created. json-ld namespace:schema"
-        },
-        "dateModified": {
-            "type": "string",
-            "description": "The date/time of when the element was modified. json-ld namespace:schema"
-        },
-        "dateDeleted": {
-            "type": "string",
-            "description": "The date/time of when the element was deleted, as we never actually remove items. json-ld namespace:schema"
-        },
         "@context": {
             "anyOf": [
                 {
-                    "type": "string",
                     "const": "https://schema.twindev.org/aig/"
                 },
                 {
                     "type": "array",
-                    "minItems": 1,
                     "prefixItems": [
                         {
-                            "type": "string",
                             "const": "https://schema.twindev.org/aig/"
                         }
                     ],
                     "items": {
                         "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
-                    }
+                    },
+                    "minItems": 1
                 }
             ],
             "description": "JSON-LD Context."
         },
+        "id": {
+            "type": "string",
+            "description": "The id of the element."
+        },
         "targetId": {
             "type": "string",
-            "description": "The target vertex id the edge connects to. json-ld type:@id"
+            "description": "The target vertex id the edge connects to."
         },
         "type": {
-            "type": "string",
             "const": "AuditableItemGraphEdge",
             "description": "JSON-LD Type."
         },
         "annotationObject": {
             "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject",
-            "description": "The JSON-LD annotation object for the edge. json-ld namespace:twin-common"
+            "description": "The JSON-LD annotation object for the edge."
         },
         "edgeRelationships": {
             "type": "array",
             "items": {
                 "type": "string"
             },
-            "description": "The relationships between the two vertices. json-ld container:set"
+            "description": "The relationships between the two vertices."
         }
     },
     "required": [
-        "@context",
         "targetId",
         "type",
         "edgeRelationships"
     ],
-    "additionalProperties": false
+    "allOf": [
+        {
+            "$ref": "https://schema.twindev.org/aig/AuditableItemGraphAuditedElement"
+        }
+    ]
 }

package/dist/es/schemas/AuditableItemGraphListPatch.json

@@ -0,0 +1,33 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/aig/AuditableItemGraphListPatch",
+    "title": "AuditableItemGraphListPatch",
+    "description": "PATCH operations for a sub-list on a vertex.",
+    "type": "object",
+    "properties": {
+        "add": {
+            "type": "array",
+            "items": {
+                "oneOf": [
+                    {
+                        "$ref": "https://schema.twindev.org/aig/AuditableItemGraphEdge"
+                    },
+                    {
+                        "$ref": "https://schema.twindev.org/aig/AuditableItemGraphAlias"
+                    },
+                    {
+                        "$ref": "https://schema.twindev.org/aig/AuditableItemGraphResource"
+                    }
+                ]
+            },
+            "description": "Items to add or update in the active set."
+        },
+        "remove": {
+            "type": "array",
+            "items": {
+                "type": "string"
+            },
+            "description": "Identifiers of items to remove from the active set (soft-delete)."
+        }
+    }
+}

package/dist/es/schemas/AuditableItemGraphPartialVertex.json

@@ -0,0 +1,110 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/aig/AuditableItemGraphPartialVertex",
+    "title": "AuditableItemGraphPartialVertex",
+    "description": "Partial vertex payload for updatePartial (PATCH — requires id).\nSub-lists use explicit `{ add, remove }` patches; bare arrays are not supported.",
+    "type": "object",
+    "properties": {
+        "id": {
+            "type": "string",
+            "description": "The id of the vertex to update."
+        },
+        "@context": {
+            "type": "array",
+            "prefixItems": [
+                {
+                    "const": "https://schema.twindev.org/aig/"
+                },
+                {
+                    "const": "https://schema.twindev.org/common/"
+                }
+            ],
+            "items": {
+                "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
+            },
+            "minItems": 2,
+            "description": "JSON-LD Context."
+        },
+        "type": {
+            "const": "AuditableItemGraphVertex",
+            "description": "JSON-LD Type."
+        },
+        "aliasPatches": {
+            "$ref": "https://schema.twindev.org/aig/AuditableItemGraphListPatch",
+            "description": "Patch operations for aliases."
+        },
+        "resourcePatches": {
+            "$ref": "https://schema.twindev.org/aig/AuditableItemGraphListPatch",
+            "description": "Patch operations for resources."
+        },
+        "edgePatches": {
+            "$ref": "https://schema.twindev.org/aig/AuditableItemGraphListPatch",
+            "description": "Patch operations for edges."
+        }
+    },
+    "required": [
+        "id",
+        "@context"
+    ],
+    "allOf": [
+        {
+            "description": "Interface describing an auditable item graph vertex.",
+            "type": "object",
+            "properties": {
+                "dateCreated": {
+                    "type": "string",
+                    "description": "The date/time of when the element was created."
+                },
+                "dateModified": {
+                    "type": "string",
+                    "description": "The date/time of when the element was modified."
+                },
+                "dateDeleted": {
+                    "type": "string",
+                    "description": "The date/time of when the element was deleted, as we never actually remove items."
+                },
+                "@context": {
+                    "type": "array",
+                    "prefixItems": [
+                        {
+                            "const": "https://schema.twindev.org/aig/"
+                        },
+                        {
+                            "const": "https://schema.twindev.org/common/"
+                        }
+                    ],
+                    "items": {
+                        "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
+                    },
+                    "minItems": 2,
+                    "description": "JSON-LD Context.",
+                    "$comment": "Inherited from AuditableItemGraphVertex"
+                },
+                "organizationIdentity": {
+                    "type": "string",
+                    "description": "The identity of the organization which controls the vertex.",
+                    "$comment": "Inherited from AuditableItemGraphVertex"
+                },
+                "annotationObject": {
+                    "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject",
+                    "description": "The JSON-LD annotation object for the vertex.",
+                    "$comment": "Inherited from AuditableItemGraphVertex"
+                },
+                "verified": {
+                    "type": "boolean",
+                    "description": "Is the vertex verified, will only be populated when verification is requested.",
+                    "$comment": "Inherited from AuditableItemGraphVertex"
+                },
+                "version": {
+                    "type": "number",
+                    "description": "The version of the vertex, populated only when getting a specific version.\nMaps to https://schema.org/version.",
+                    "$comment": "Inherited from AuditableItemGraphVertex"
+                }
+            },
+            "required": [
+                "@context"
+            ],
+            "$comment": "Inlined utility base type AuditableItemGraphVertex so utility transformations can operate on concrete properties instead of a $ref."
+        }
+    ]
+}

package/dist/es/schemas/AuditableItemGraphPatchOperation.json

@@ -1,64 +1,72 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schema.twindev.org/aig/AuditableItemGraphPatchOperation",
+    "title": "AuditableItemGraphPatchOperation",
     "description": "The patch operation for JSON diffs.",
     "type": "object",
     "properties": {
         "@context": {
             "anyOf": [
                 {
-                    "type": "string",
                     "const": "https://schema.twindev.org/aig/"
                 },
                 {
                     "type": "array",
-                    "minItems": 1,
                     "prefixItems": [
                         {
-                            "type": "string",
                             "const": "https://schema.twindev.org/aig/"
                         }
                     ],
                     "items": {
                         "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
-                    }
+                    },
+                    "minItems": 1
                 }
             ],
             "description": "JSON-LD Context."
         },
         "type": {
-            "type": "string",
             "const": "AuditableItemGraphPatchOperation",
             "description": "JSON-LD Type."
         },
         "patchOperation": {
-            "type": "string",
-            "enum": [
-                "add",
-                "remove",
-                "replace",
-                "move",
-                "copy",
-                "test"
+            "anyOf": [
+                {
+                    "const": "add"
+                },
+                {
+                    "const": "remove"
+                },
+                {
+                    "const": "replace"
+                },
+                {
+                    "const": "move"
+                },
+                {
+                    "const": "copy"
+                },
+                {
+                    "const": "test"
+                }
             ],
-            "description": "The operation that was performed on the item. json-ld type:schema:Text"
+            "description": "The operation that was performed on the item."
         },
         "patchPath": {
             "type": "string",
-            "description": "The path to the object that was changed. json-ld type:schema:Text"
+            "description": "The path to the object that was changed."
         },
         "patchFrom": {
             "type": "string",
-            "description": "The path the value was copied or moved from. json-ld type:schema:Text"
+            "description": "The path the value was copied or moved from."
         },
         "patchValue": {
-            "description": "The value to add. json-ld type:json"
+            "description": "The value to add."
         }
     },
     "required": [
         "type",
         "patchOperation",
         "patchPath"
-    ],
-    "additionalProperties": false
+    ]
 }