@twin.org/auditable-item-graph-models 0.0.3-next.0 → 0.0.3-next.10

package/docs/changelog.md

@@ -1,5 +1,125 @@
 # @twin.org/auditable-item-graph-models - Changelog
 
+## [0.0.3-next.10](https://github.com/twinfoundation/auditable-item-graph/compare/auditable-item-graph-models-v0.0.3-next.9...auditable-item-graph-models-v0.0.3-next.10) (2026-02-24)
+
+
+### Features
+
+* add context id features ([#30](https://github.com/twinfoundation/auditable-item-graph/issues/30)) ([a35d37c](https://github.com/twinfoundation/auditable-item-graph/commit/a35d37c0db62a240adde493965c0a9f7971fec45))
+* add data types with fully qualified name ([93e1ee7](https://github.com/twinfoundation/auditable-item-graph/commit/93e1ee7c0f7bad81f003787f797f363864e201af))
+* add ts-to-jsonld-context tool ([08d360e](https://github.com/twinfoundation/auditable-item-graph/commit/08d360e05fd7f8c5bbe6ee4d4e691ffd516db418))
+* add unique flag for alias, and exact match option for id query ([33dbd19](https://github.com/twinfoundation/auditable-item-graph/commit/33dbd19cabd9fbfaba81032f1d1a6527584c3f5a))
+* add validate-locales ([e76e6f6](https://github.com/twinfoundation/auditable-item-graph/commit/e76e6f6b3ec9c447a04315d353442e32233601d3))
+* changeset endpoints ([#44](https://github.com/twinfoundation/auditable-item-graph/issues/44)) ([7c854de](https://github.com/twinfoundation/auditable-item-graph/commit/7c854de39b247d6f24cd94a04a9f99fa9edde51d))
+* eslint migration to flat config ([1b42a3a](https://github.com/twinfoundation/auditable-item-graph/commit/1b42a3a27bd6e32d7816de406b92b6332472edf6))
+* id optional in edge updates ([6b63fe3](https://github.com/twinfoundation/auditable-item-graph/commit/6b63fe34553104843ae15aa5066775f5872859e9))
+* improve comments ([97f311a](https://github.com/twinfoundation/auditable-item-graph/commit/97f311a9cc4353b5020a48a44420c97a2fa0c8d7))
+* improve JSON schemas ([bec8dc1](https://github.com/twinfoundation/auditable-item-graph/commit/bec8dc1f270c6c9710623a192b984cf46f8a5613))
+* replace nextItem property with Link header ([#39](https://github.com/twinfoundation/auditable-item-graph/issues/39)) ([b29a333](https://github.com/twinfoundation/auditable-item-graph/commit/b29a333ca78ca2091e54e3e6f4355f84c350007d))
+* update background task service ([e483ddb](https://github.com/twinfoundation/auditable-item-graph/commit/e483ddbc948f035334f92b8342248caa6abbe441))
+* update contexts ([#35](https://github.com/twinfoundation/auditable-item-graph/issues/35)) ([cdf0989](https://github.com/twinfoundation/auditable-item-graph/commit/cdf0989fe4677a88b757e97e752b7d4c29013a7e))
+* update contexts and namespaces ([#33](https://github.com/twinfoundation/auditable-item-graph/issues/33)) ([5dadb99](https://github.com/twinfoundation/auditable-item-graph/commit/5dadb99773d410aceacaba7ed92c1ccb8b46516b))
+* update dependencies ([6986689](https://github.com/twinfoundation/auditable-item-graph/commit/698668957a1fcb7f85ce2f117914d5980043924f))
+* update edges to use targetId instead of id ([6c5d0e3](https://github.com/twinfoundation/auditable-item-graph/commit/6c5d0e31b6e2ea74bfa2f3344e4be628e5f237af))
+* update framework core ([88ad4e6](https://github.com/twinfoundation/auditable-item-graph/commit/88ad4e6421132c3c6c45579b078d982a26f16990))
+* update targetid json context type ([1e47ca7](https://github.com/twinfoundation/auditable-item-graph/commit/1e47ca7ec3080251d940fd8e58c44ca4fa9457f7))
+* update ts-to-schema generation ([edce91e](https://github.com/twinfoundation/auditable-item-graph/commit/edce91e8272ab361595489458066040caf582df2))
+* use new nameof operators ([3921c4c](https://github.com/twinfoundation/auditable-item-graph/commit/3921c4c9ac53e42459e45f10d9e702afb2797a23))
+* use shared store mechanism ([#10](https://github.com/twinfoundation/auditable-item-graph/issues/10)) ([da035e5](https://github.com/twinfoundation/auditable-item-graph/commit/da035e5eb8f157482b4eb2bdbc689c6c0647ff7d))
+* use standard list json ld types ([8f53836](https://github.com/twinfoundation/auditable-item-graph/commit/8f53836d4c83a98d64d7f5fe0531bb9af09464ae))
+
+
+### Bug Fixes
+
+* only include alias in index if not deleted ([#6](https://github.com/twinfoundation/auditable-item-graph/issues/6)) ([5da3c41](https://github.com/twinfoundation/auditable-item-graph/commit/5da3c419fafa2afefd34b1c570d103012b888a75))
+* query params force coercion ([2dd9afe](https://github.com/twinfoundation/auditable-item-graph/commit/2dd9afe9ec37e2a91c110317fe289f7495c187a0))
+
+## [0.0.3-next.9](https://github.com/twinfoundation/auditable-item-graph/compare/auditable-item-graph-models-v0.0.3-next.8...auditable-item-graph-models-v0.0.3-next.9) (2026-02-23)
+
+
+### Miscellaneous Chores
+
+* **auditable-item-graph-models:** Synchronize repo versions
+
+## [0.0.3-next.8](https://github.com/twinfoundation/auditable-item-graph/compare/auditable-item-graph-models-v0.0.3-next.7...auditable-item-graph-models-v0.0.3-next.8) (2026-02-11)
+
+
+### Miscellaneous Chores
+
+* **auditable-item-graph-models:** Synchronize repo versions
+
+## [0.0.3-next.7](https://github.com/twinfoundation/auditable-item-graph/compare/auditable-item-graph-models-v0.0.3-next.6...auditable-item-graph-models-v0.0.3-next.7) (2026-02-11)
+
+
+### Features
+
+* add ts-to-jsonld-context tool ([08d360e](https://github.com/twinfoundation/auditable-item-graph/commit/08d360e05fd7f8c5bbe6ee4d4e691ffd516db418))
+* changeset endpoints ([#44](https://github.com/twinfoundation/auditable-item-graph/issues/44)) ([7c854de](https://github.com/twinfoundation/auditable-item-graph/commit/7c854de39b247d6f24cd94a04a9f99fa9edde51d))
+* update targetid json context type ([1e47ca7](https://github.com/twinfoundation/auditable-item-graph/commit/1e47ca7ec3080251d940fd8e58c44ca4fa9457f7))
+
+## [0.0.3-next.6](https://github.com/twinfoundation/auditable-item-graph/compare/auditable-item-graph-models-v0.0.3-next.5...auditable-item-graph-models-v0.0.3-next.6) (2026-01-26)
+
+
+### Miscellaneous Chores
+
+* **auditable-item-graph-models:** Synchronize repo versions
+
+## [0.0.3-next.5](https://github.com/twinfoundation/auditable-item-graph/compare/auditable-item-graph-models-v0.0.3-next.4...auditable-item-graph-models-v0.0.3-next.5) (2026-01-23)
+
+
+### Features
+
+* replace nextItem property with Link header ([#39](https://github.com/twinfoundation/auditable-item-graph/issues/39)) ([b29a333](https://github.com/twinfoundation/auditable-item-graph/commit/b29a333ca78ca2091e54e3e6f4355f84c350007d))
+
+## [0.0.3-next.4](https://github.com/twinfoundation/auditable-item-graph/compare/auditable-item-graph-models-v0.0.3-next.3...auditable-item-graph-models-v0.0.3-next.4) (2026-01-22)
+
+
+### Miscellaneous Chores
+
+* **auditable-item-graph-models:** Synchronize repo versions
+
+## [0.0.3-next.3](https://github.com/twinfoundation/auditable-item-graph/compare/auditable-item-graph-models-v0.0.3-next.2...auditable-item-graph-models-v0.0.3-next.3) (2026-01-21)
+
+
+### Features
+
+* update contexts ([#35](https://github.com/twinfoundation/auditable-item-graph/issues/35)) ([cdf0989](https://github.com/twinfoundation/auditable-item-graph/commit/cdf0989fe4677a88b757e97e752b7d4c29013a7e))
+
+## [0.0.3-next.2](https://github.com/twinfoundation/auditable-item-graph/compare/auditable-item-graph-models-v0.0.3-next.1...auditable-item-graph-models-v0.0.3-next.2) (2026-01-14)
+
+
+### Features
+
+* update contexts and namespaces ([#33](https://github.com/twinfoundation/auditable-item-graph/issues/33)) ([5dadb99](https://github.com/twinfoundation/auditable-item-graph/commit/5dadb99773d410aceacaba7ed92c1ccb8b46516b))
+
+## [0.0.3-next.1](https://github.com/twinfoundation/auditable-item-graph/compare/auditable-item-graph-models-v0.0.3-next.0...auditable-item-graph-models-v0.0.3-next.1) (2025-11-28)
+
+
+### Features
+
+* add context id features ([#30](https://github.com/twinfoundation/auditable-item-graph/issues/30)) ([a35d37c](https://github.com/twinfoundation/auditable-item-graph/commit/a35d37c0db62a240adde493965c0a9f7971fec45))
+* add data types with fully qualified name ([93e1ee7](https://github.com/twinfoundation/auditable-item-graph/commit/93e1ee7c0f7bad81f003787f797f363864e201af))
+* add unique flag for alias, and exact match option for id query ([33dbd19](https://github.com/twinfoundation/auditable-item-graph/commit/33dbd19cabd9fbfaba81032f1d1a6527584c3f5a))
+* add validate-locales ([e76e6f6](https://github.com/twinfoundation/auditable-item-graph/commit/e76e6f6b3ec9c447a04315d353442e32233601d3))
+* eslint migration to flat config ([1b42a3a](https://github.com/twinfoundation/auditable-item-graph/commit/1b42a3a27bd6e32d7816de406b92b6332472edf6))
+* id optional in edge updates ([6b63fe3](https://github.com/twinfoundation/auditable-item-graph/commit/6b63fe34553104843ae15aa5066775f5872859e9))
+* improve comments ([97f311a](https://github.com/twinfoundation/auditable-item-graph/commit/97f311a9cc4353b5020a48a44420c97a2fa0c8d7))
+* improve JSON schemas ([bec8dc1](https://github.com/twinfoundation/auditable-item-graph/commit/bec8dc1f270c6c9710623a192b984cf46f8a5613))
+* update background task service ([e483ddb](https://github.com/twinfoundation/auditable-item-graph/commit/e483ddbc948f035334f92b8342248caa6abbe441))
+* update dependencies ([6986689](https://github.com/twinfoundation/auditable-item-graph/commit/698668957a1fcb7f85ce2f117914d5980043924f))
+* update edges to use targetId instead of id ([6c5d0e3](https://github.com/twinfoundation/auditable-item-graph/commit/6c5d0e31b6e2ea74bfa2f3344e4be628e5f237af))
+* update framework core ([88ad4e6](https://github.com/twinfoundation/auditable-item-graph/commit/88ad4e6421132c3c6c45579b078d982a26f16990))
+* update ts-to-schema generation ([edce91e](https://github.com/twinfoundation/auditable-item-graph/commit/edce91e8272ab361595489458066040caf582df2))
+* use new nameof operators ([3921c4c](https://github.com/twinfoundation/auditable-item-graph/commit/3921c4c9ac53e42459e45f10d9e702afb2797a23))
+* use shared store mechanism ([#10](https://github.com/twinfoundation/auditable-item-graph/issues/10)) ([da035e5](https://github.com/twinfoundation/auditable-item-graph/commit/da035e5eb8f157482b4eb2bdbc689c6c0647ff7d))
+* use standard list json ld types ([8f53836](https://github.com/twinfoundation/auditable-item-graph/commit/8f53836d4c83a98d64d7f5fe0531bb9af09464ae))
+
+
+### Bug Fixes
+
+* only include alias in index if not deleted ([#6](https://github.com/twinfoundation/auditable-item-graph/issues/6)) ([5da3c41](https://github.com/twinfoundation/auditable-item-graph/commit/5da3c419fafa2afefd34b1c570d103012b888a75))
+* query params force coercion ([2dd9afe](https://github.com/twinfoundation/auditable-item-graph/commit/2dd9afe9ec37e2a91c110317fe289f7495c187a0))
+
 ## [0.0.2-next.8](https://github.com/twinfoundation/auditable-item-graph/compare/auditable-item-graph-models-v0.0.2-next.7...auditable-item-graph-models-v0.0.2-next.8) (2025-10-09)
 
 

package/docs/reference/index.md

@@ -9,12 +9,17 @@
 - [IAuditableItemGraphAlias](interfaces/IAuditableItemGraphAlias.md)
 - [IAuditableItemGraphAuditedElement](interfaces/IAuditableItemGraphAuditedElement.md)
 - [IAuditableItemGraphChangeset](interfaces/IAuditableItemGraphChangeset.md)
+- [IAuditableItemGraphChangesetList](interfaces/IAuditableItemGraphChangesetList.md)
 - [IAuditableItemGraphComponent](interfaces/IAuditableItemGraphComponent.md)
 - [IAuditableItemGraphEdge](interfaces/IAuditableItemGraphEdge.md)
 - [IAuditableItemGraphPatchOperation](interfaces/IAuditableItemGraphPatchOperation.md)
 - [IAuditableItemGraphResource](interfaces/IAuditableItemGraphResource.md)
 - [IAuditableItemGraphVertex](interfaces/IAuditableItemGraphVertex.md)
 - [IAuditableItemGraphVertexList](interfaces/IAuditableItemGraphVertexList.md)
+- [IAuditableItemGraphChangesetGetRequest](interfaces/IAuditableItemGraphChangesetGetRequest.md)
+- [IAuditableItemGraphChangesetGetResponse](interfaces/IAuditableItemGraphChangesetGetResponse.md)
+- [IAuditableItemGraphChangesetListRequest](interfaces/IAuditableItemGraphChangesetListRequest.md)
+- [IAuditableItemGraphChangesetListResponse](interfaces/IAuditableItemGraphChangesetListResponse.md)
 - [IAuditableItemGraphCreateRequest](interfaces/IAuditableItemGraphCreateRequest.md)
 - [IAuditableItemGraphGetRequest](interfaces/IAuditableItemGraphGetRequest.md)
 - [IAuditableItemGraphGetResponse](interfaces/IAuditableItemGraphGetResponse.md)

package/docs/reference/interfaces/IAuditableItemGraphAlias.md

@@ -41,6 +41,7 @@ JSON-LD Type.
 > `optional` **annotationObject**: `IJsonLdNodeObject`
 
 The JSON-LD annotation object for the alias.
+json-ld namespace:twin-common
 
 ***
 
@@ -49,6 +50,7 @@ The JSON-LD annotation object for the alias.
 > `optional` **aliasFormat**: `string`
 
 The format of the id in the alias.
+json-ld type:sch:Text
 
 ***
 
@@ -57,6 +59,7 @@ The format of the id in the alias.
 > `optional` **dateCreated**: `string`
 
 The date/time of when the element was created.
+json-ld namespace:sch
 
 #### Inherited from
 
@@ -69,6 +72,7 @@ The date/time of when the element was created.
 > `optional` **dateModified**: `string`
 
 The date/time of when the element was modified.
+json-ld namespace:sch
 
 #### Inherited from
 
@@ -81,6 +85,7 @@ The date/time of when the element was modified.
 > `optional` **dateDeleted**: `string`
 
 The date/time of when the element was deleted, as we never actually remove items.
+json-ld namespace:sch
 
 #### Inherited from
 

package/docs/reference/interfaces/IAuditableItemGraphAuditedElement.md

@@ -23,6 +23,7 @@ The id of the element.
 > `optional` **dateCreated**: `string`
 
 The date/time of when the element was created.
+json-ld namespace:sch
 
 ***
 
@@ -31,6 +32,7 @@ The date/time of when the element was created.
 > `optional` **dateModified**: `string`
 
 The date/time of when the element was modified.
+json-ld namespace:sch
 
 ***
 
@@ -39,3 +41,4 @@ The date/time of when the element was modified.
 > `optional` **dateDeleted**: `string`
 
 The date/time of when the element was deleted, as we never actually remove items.
+json-ld namespace:sch

package/docs/reference/interfaces/IAuditableItemGraphChangeset.md

@@ -4,9 +4,9 @@ Interface describing a set of changes to the vertex.
 
 ## Properties
 
-### @context
+### @context?
 
-> **@context**: \[`"https://schema.twindev.org/aig/"`, `"https://schema.twindev.org/common/"`, `...IJsonLdContextDefinitionElement[]`\]
+> `optional` **@context**: \[`"https://schema.twindev.org/aig/"`, `"https://schema.twindev.org/common/"`, `...IJsonLdContextDefinitionElement[]`\]
 
 JSON-LD Context.
 
@@ -33,6 +33,7 @@ The id of the changeset.
 > **dateCreated**: `string`
 
 The date/time of when the changeset was created.
+json-ld namespace:sch
 
 ***
 
@@ -41,6 +42,7 @@ The date/time of when the changeset was created.
 > `optional` **userIdentity**: `string`
 
 The user identity that created the changes.
+json-ld namespace:twin-common
 
 ***
 
@@ -49,6 +51,7 @@ The user identity that created the changes.
 > **patches**: [`IAuditableItemGraphPatchOperation`](IAuditableItemGraphPatchOperation.md)[]
 
 The patches in the changeset.
+json-ld container:set
 
 ***
 
@@ -57,6 +60,7 @@ The patches in the changeset.
 > `optional` **proofId**: `string`
 
 The immutable proof id which contains the signature for this changeset.
+json-ld type:sch:identifier
 
 ***
 
@@ -65,3 +69,4 @@ The immutable proof id which contains the signature for this changeset.
 > `optional` **verification**: `IImmutableProofVerification`
 
 The verification for the changeset.
+json-ld id

package/docs/reference/interfaces/IAuditableItemGraphChangesetGetRequest.md

@@ -0,0 +1,49 @@
+# Interface: IAuditableItemGraphChangesetGetRequest
+
+Get an auditable item graph vertex changeset.
+
+## Properties
+
+### headers?
+
+> `optional` **headers**: `object`
+
+The headers which can be used to determine the response data type.
+
+#### accept
+
+> **accept**: `"application/json"` \| `"application/ld+json"`
+
+***
+
+### pathParams
+
+> **pathParams**: `object`
+
+The parameters from the path.
+
+#### id
+
+> **id**: `string`
+
+The id of the vertex to get the changeset from.
+
+#### changesetId
+
+> **changesetId**: `string`
+
+The id of the changeset to get.
+
+***
+
+### query?
+
+> `optional` **query**: `object`
+
+The query parameters.
+
+#### verifySignatureDepth?
+
+> `optional` **verifySignatureDepth**: [`VerifyDepth`](../type-aliases/VerifyDepth.md)
+
+How many signatures to verify, none, current or all, defaults to "none".

package/docs/reference/interfaces/IAuditableItemGraphChangesetGetResponse.md

@@ -0,0 +1,23 @@
+# Interface: IAuditableItemGraphChangesetGetResponse
+
+Response to getting an auditable item graph vertex changeset.
+
+## Properties
+
+### headers?
+
+> `optional` **headers**: `object`
+
+The headers which can be used to determine the response data type.
+
+#### content-type
+
+> **content-type**: `"application/json"` \| `"application/ld+json"`
+
+***
+
+### body
+
+> **body**: [`IAuditableItemGraphChangeset`](IAuditableItemGraphChangeset.md)
+
+The response body.

package/docs/reference/interfaces/IAuditableItemGraphChangesetList.md

@@ -0,0 +1,28 @@
+# Interface: IAuditableItemGraphChangesetList
+
+Interface describing an auditable item graph changeset list.
+
+## Properties
+
+### @context
+
+> **@context**: \[`"https://schema.org"`, `"https://schema.twindev.org/aig/"`, `...IJsonLdContextDefinitionElement[]`\]
+
+JSON-LD Context.
+
+***
+
+### type
+
+> **type**: \[`"ItemList"`, `"AuditableItemGraphChangesetList"`\]
+
+JSON-LD Type.
+
+***
+
+### itemListElement
+
+> **itemListElement**: [`IAuditableItemGraphChangeset`](IAuditableItemGraphChangeset.md)[]
+
+The list of changesets.
+json-ld namespace:sch

package/docs/reference/interfaces/IAuditableItemGraphChangesetListRequest.md

@@ -0,0 +1,55 @@
+# Interface: IAuditableItemGraphChangesetListRequest
+
+Get an auditable item graph changeset.
+
+## Properties
+
+### headers?
+
+> `optional` **headers**: `object`
+
+The headers which can be used to determine the response data type.
+
+#### accept
+
+> **accept**: `"application/json"` \| `"application/ld+json"`
+
+***
+
+### pathParams
+
+> **pathParams**: `object`
+
+The parameters from the path.
+
+#### id
+
+> **id**: `string`
+
+The id of the changeset to get.
+
+***
+
+### query?
+
+> `optional` **query**: `object`
+
+The query parameters.
+
+#### cursor?
+
+> `optional` **cursor**: `string`
+
+The optional cursor to get next chunk.
+
+#### limit?
+
+> `optional` **limit**: `string`
+
+Limit the number of entities to return.
+
+#### verifySignatureDepth?
+
+> `optional` **verifySignatureDepth**: [`VerifyDepth`](../type-aliases/VerifyDepth.md)
+
+How many signatures to verify, none, current or all, defaults to "none".

package/docs/reference/interfaces/IAuditableItemGraphChangesetListResponse.md

@@ -0,0 +1,27 @@
+# Interface: IAuditableItemGraphChangesetListResponse
+
+Response to getting an auditable item graph changeset list.
+
+## Properties
+
+### headers?
+
+> `optional` **headers**: `object`
+
+The headers which can be used to determine the response data type.
+
+#### content-type
+
+> **content-type**: `"application/json"` \| `"application/ld+json"`
+
+#### link?
+
+> `optional` **link**: `string` \| `string`[]
+
+***
+
+### body
+
+> **body**: [`IAuditableItemGraphChangesetList`](IAuditableItemGraphChangesetList.md)
+
+The response body.

package/docs/reference/interfaces/IAuditableItemGraphComponent.md

@@ -126,11 +126,53 @@ Additional options for the get operation.
 
 Whether to include deleted aliases, resource, edges, defaults to false.
 
-###### includeChangesets?
+###### verifySignatureDepth?
 
-`boolean`
+[`VerifyDepth`](../type-aliases/VerifyDepth.md)
+
+How many signatures to verify, defaults to "none".
+
+#### Returns
+
+`Promise`\<[`IAuditableItemGraphVertex`](IAuditableItemGraphVertex.md)\>
+
+The vertex if found.
+
+#### Throws
+
+NotFoundError if the vertex is not found.
+
+***
+
+### getChangesets()
+
+> **getChangesets**(`id`, `cursor?`, `limit?`, `options?`): `Promise`\<\{ `changesets`: [`IAuditableItemGraphChangesetList`](IAuditableItemGraphChangesetList.md); `cursor?`: `string`; \}\>
+
+Get a graph vertex changeset list.
+
+#### Parameters
+
+##### id
+
+`string`
+
+The id of the vertex to get.
+
+##### cursor?
+
+`string`
+
+The optional cursor to get next chunk.
+
+##### limit?
+
+`number`
 
-Whether to include the changesets of the vertex, defaults to false.
+Limit the number of entities to return.
+
+##### options?
+
+Additional options for the get operation.
 
 ###### verifySignatureDepth?
 
@@ -140,9 +182,9 @@ How many signatures to verify, defaults to "none".
 
 #### Returns
 
-`Promise`\<[`IAuditableItemGraphVertex`](IAuditableItemGraphVertex.md)\>
+`Promise`\<\{ `changesets`: [`IAuditableItemGraphChangesetList`](IAuditableItemGraphChangesetList.md); `cursor?`: `string`; \}\>
 
-The vertex if found.
+The changeset if found.
 
 #### Throws
 
@@ -150,6 +192,42 @@ NotFoundError if the vertex is not found.
 
 ***
 
+### getChangeset()
+
+> **getChangeset**(`id`, `options?`): `Promise`\<[`IAuditableItemGraphChangeset`](IAuditableItemGraphChangeset.md)\>
+
+Get a graph vertex changeset.
+
+#### Parameters
+
+##### id
+
+`string`
+
+The id of the vertex to get.
+
+##### options?
+
+Additional options for the get operation.
+
+###### verifySignatureDepth?
+
+[`VerifyDepth`](../type-aliases/VerifyDepth.md)
+
+How many signatures to verify, defaults to "none".
+
+#### Returns
+
+`Promise`\<[`IAuditableItemGraphChangeset`](IAuditableItemGraphChangeset.md)\>
+
+The changeset if found.
+
+#### Throws
+
+NotFoundError if the vertex or changeset is not found.
+
+***
+
 ### removeVerifiable()
 
 > **removeVerifiable**(`id`): `Promise`\<`void`\>
@@ -178,7 +256,7 @@ NotFoundError if the vertex is not found.
 
 ### query()
 
-> **query**(`options?`, `conditions?`, `orderBy?`, `orderByDirection?`, `properties?`, `cursor?`, `limit?`): `Promise`\<[`IAuditableItemGraphVertexList`](IAuditableItemGraphVertexList.md)\>
+> **query**(`options?`, `conditions?`, `orderBy?`, `orderByDirection?`, `properties?`, `cursor?`, `limit?`): `Promise`\<\{ `entries`: [`IAuditableItemGraphVertexList`](IAuditableItemGraphVertexList.md); `cursor?`: `string`; \}\>
 
 Query the graph for vertices.
 
@@ -250,6 +328,6 @@ Limit the number of entities to return.
 
 #### Returns
 
-`Promise`\<[`IAuditableItemGraphVertexList`](IAuditableItemGraphVertexList.md)\>
+`Promise`\<\{ `entries`: [`IAuditableItemGraphVertexList`](IAuditableItemGraphVertexList.md); `cursor?`: `string`; \}\>
 
 The entities, which can be partial if a limited keys list was provided.

package/docs/reference/interfaces/IAuditableItemGraphEdge.md

@@ -13,6 +13,7 @@ Interface describing an edge between two vertices in an auditable item graph.
 > `optional` **dateCreated**: `string`
 
 The date/time of when the element was created.
+json-ld namespace:sch
 
 #### Inherited from
 
@@ -25,6 +26,7 @@ The date/time of when the element was created.
 > `optional` **dateModified**: `string`
 
 The date/time of when the element was modified.
+json-ld namespace:sch
 
 #### Inherited from
 
@@ -37,6 +39,7 @@ The date/time of when the element was modified.
 > `optional` **dateDeleted**: `string`
 
 The date/time of when the element was deleted, as we never actually remove items.
+json-ld namespace:sch
 
 #### Inherited from
 
@@ -69,6 +72,7 @@ The id of the element.
 > **targetId**: `string`
 
 The target vertex id the edge connects to.
+json-ld type:@id
 
 ***
 
@@ -85,6 +89,7 @@ JSON-LD Type.
 > `optional` **annotationObject**: `IJsonLdNodeObject`
 
 The JSON-LD annotation object for the edge.
+json-ld namespace:twin-common
 
 ***
 
@@ -93,3 +98,4 @@ The JSON-LD annotation object for the edge.
 > **edgeRelationships**: `string`[]
 
 The relationships between the two vertices.
+json-ld container:set

package/docs/reference/interfaces/IAuditableItemGraphGetRequest.md

@@ -38,16 +38,10 @@ The query parameters.
 
 #### includeDeleted?
 
-> `optional` **includeDeleted**: `string` \| `boolean`
+> `optional` **includeDeleted**: `string`
 
 Whether to include deleted aliases, resource, edges, defaults to false.
 
-#### includeChangesets?
-
-> `optional` **includeChangesets**: `string` \| `boolean`
-
-Whether to include the changesets of the vertex, defaults to false.
-
 #### verifySignatureDepth?
 
 > `optional` **verifySignatureDepth**: [`VerifyDepth`](../type-aliases/VerifyDepth.md)

package/docs/reference/interfaces/IAuditableItemGraphListRequest.md

@@ -36,7 +36,7 @@ Which field to look in with the id, defaults to both.
 
 #### idExact?
 
-> `optional` **idExact**: `boolean`
+> `optional` **idExact**: `string`
 
 Find only exact matches, default to false meaning partial matching.
 

package/docs/reference/interfaces/IAuditableItemGraphListResponse.md

@@ -14,6 +14,10 @@ The headers which can be used to determine the response data type.
 
 > **content-type**: `"application/json"` \| `"application/ld+json"`
 
+#### link?
+
+> `optional` **link**: `string` \| `string`[]
+
 ***
 
 ### body