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

package/docs/reference/interfaces/IAuditableItemGraphComponent.md

@@ -8,7 +8,7 @@ Interface describing an auditable item graph contract.
 
 ## Methods
 
-### create()
+### create() {#create}
 
 > **create**(`vertex`): `Promise`\<`string`\>
 
@@ -18,31 +18,9 @@ Create a new graph vertex.
 
 ##### vertex
 
-The vertex to create.
-
-###### annotationObject?
-
-`IJsonLdNodeObject`
-
-The annotation object for the vertex as JSON-LD.
-
-###### aliases?
-
-`object`[]
-
-Alternative aliases that can be used to identify the vertex.
-
-###### resources?
-
-`object`[]
-
-The resources attached to the vertex.
+`Omit`\<[`IAuditableItemGraphVertex`](IAuditableItemGraphVertex.md), `"id"`\>
 
-###### edges?
-
-`object`[]
-
-The edges connected to the vertex.
+The vertex to create.
 
 #### Returns
 
@@ -52,57 +30,55 @@ The id of the new graph item.
 
 ***
 
-### update()
+### update() {#update}
 
 > **update**(`vertex`): `Promise`\<`void`\>
 
-Update a graph vertex.
+Update a graph vertex (PUT — full replacement of vertex state).
+Concurrent updates for the same vertex are serialized via `Mutex` on the vertex id.
+Multi-replica deployments are not coordinated.
 
 #### Parameters
 
 ##### vertex
 
-The vertex to update.
-
-###### id
+[`IAuditableItemGraphVertex`](IAuditableItemGraphVertex.md)
 
-`string`
-
-The id of the vertex to update.
-
-###### annotationObject?
+The vertex to update.
 
-`IJsonLdNodeObject`
+#### Returns
 
-The annotation object for the vertex as JSON-LD.
+`Promise`\<`void`\>
 
-###### aliases?
+A promise that resolves when the vertex has been updated.
 
-`object`[]
+***
 
-Alternative aliases that can be used to identify the vertex.
+### updatePartial() {#updatepartial}
 
-###### resources?
+> **updatePartial**(`partial`): `Promise`\<`void`\>
 
-`object`[]
+Partially update a graph vertex (PATCH); only properties that are not undefined are applied.
+Sub-lists use explicit `{ add, remove }` patch objects. Serialized with `update()` via `Mutex`
+on the same vertex id.
 
-The resources attached to the vertex.
+#### Parameters
 
-###### edges?
+##### partial
 
-`object`[]
+[`IAuditableItemGraphPartialVertex`](IAuditableItemGraphPartialVertex.md)
 
-The edges connected to the vertex.
+The partial vertex update (must include `id`).
 
 #### Returns
 
 `Promise`\<`void`\>
 
-Nothing.
+A promise that resolves when the partial update has been applied.
 
 ***
 
-### get()
+### get() {#get}
 
 > **get**(`id`, `options?`): `Promise`\<[`IAuditableItemGraphVertex`](IAuditableItemGraphVertex.md)\>
 
@@ -144,7 +120,7 @@ NotFoundError if the vertex is not found.
 
 ***
 
-### getChangesets()
+### getChangesets() {#getchangesets}
 
 > **getChangesets**(`id`, `cursor?`, `limit?`, `options?`): `Promise`\<\{ `changesets`: [`IAuditableItemGraphChangesetList`](IAuditableItemGraphChangesetList.md); `cursor?`: `string`; \}\>
 
@@ -192,7 +168,7 @@ NotFoundError if the vertex is not found.
 
 ***
 
-### getChangeset()
+### getChangeset() {#getchangeset}
 
 > **getChangeset**(`id`, `options?`): `Promise`\<[`IAuditableItemGraphChangeset`](IAuditableItemGraphChangeset.md)\>
 
@@ -228,11 +204,85 @@ NotFoundError if the vertex or changeset is not found.
 
 ***
 
-### removeVerifiable()
+### getVersion() {#getversion}
+
+> **getVersion**(`id`, `version`): `Promise`\<[`IAuditableItemGraphVertex`](IAuditableItemGraphVertex.md)\>
+
+Get a graph vertex at a specific version.
+
+#### Parameters
+
+##### id
+
+`string`
+
+The id of the vertex.
+
+##### version
+
+`number`
+
+The version number to retrieve.
+
+#### Returns
+
+`Promise`\<[`IAuditableItemGraphVertex`](IAuditableItemGraphVertex.md)\>
+
+The vertex reconstructed at that version.
+
+#### Throws
+
+NotFoundError if the vertex or version is not found.
+
+***
+
+### getVersions() {#getversions}
+
+> **getVersions**(`id`, `options?`): `Promise`\<[`IAuditableItemGraphVertexVersionList`](IAuditableItemGraphVertexVersionList.md)\>
+
+Get all versions of a graph vertex.
+
+#### Parameters
+
+##### id
+
+`string`
+
+The id of the vertex.
+
+##### options?
+
+Additional options for the operation.
+
+###### after?
+
+`string`
+
+Only return versions created after this ISO 8601 timestamp (exclusive).
+
+###### before?
+
+`string`
+
+Only return versions created before this ISO 8601 timestamp (exclusive).
+
+#### Returns
+
+`Promise`\<[`IAuditableItemGraphVertexVersionList`](IAuditableItemGraphVertexVersionList.md)\>
+
+The list of vertex versions.
+
+#### Throws
+
+NotFoundError if the vertex is not found.
+
+***
+
+### removeProof() {#removeproof}
 
-> **removeVerifiable**(`id`): `Promise`\<`void`\>
+> **removeProof**(`id`): `Promise`\<`void`\>
 
-Remove the verifiable storage for an item.
+Remove the proof for an item.
 
 #### Parameters
 
@@ -240,13 +290,13 @@ Remove the verifiable storage for an item.
 
 `string`
 
-The id of the vertex to remove the storage from.
+The id of the vertex to remove the proof from.
 
 #### Returns
 
 `Promise`\<`void`\>
 
-Nothing.
+A promise that resolves when the proof has been removed from all changesets.
 
 #### Throws
 
@@ -254,7 +304,7 @@ NotFoundError if the vertex is not found.
 
 ***
 
-### query()
+### query() {#query}
 
 > **query**(`options?`, `conditions?`, `orderBy?`, `orderByDirection?`, `properties?`, `cursor?`, `limit?`): `Promise`\<\{ `entries`: [`IAuditableItemGraphVertexList`](IAuditableItemGraphVertexList.md); `cursor?`: `string`; \}\>
 
@@ -292,15 +342,15 @@ Include vertices with specific resource types.
 
 ##### conditions?
 
-`IComparator`[]
+`EntityCondition`\<[`IAuditableItemGraphVertex`](IAuditableItemGraphVertex.md)\>
 
 Conditions to use in the query.
 
 ##### orderBy?
 
-The order for the results, defaults to dateCreated.
+`"dateCreated"` \| `"dateModified"`
 
-`"dateCreated"` | `"dateModified"`
+The order for the results, defaults to dateCreated.
 
 ##### orderByDirection?
 

package/docs/reference/interfaces/IAuditableItemGraphCreateRequest.md

@@ -4,32 +4,8 @@ Create an auditable item graph vertex.
 
 ## Properties
 
-### body
+### body {#body}
 
-> **body**: `object`
+> **body**: `Omit`\<[`IAuditableItemGraphVertex`](IAuditableItemGraphVertex.md), `"id"`\>
 
 The data to be used in the vertex.
-
-#### annotationObject?
-
-> `optional` **annotationObject**: `IJsonLdNodeObject`
-
-The object to be used in the vertex as JSON-LD.
-
-#### aliases?
-
-> `optional` **aliases**: `object`[]
-
-Alternative aliases that can be used to identify the vertex.
-
-#### resources?
-
-> `optional` **resources**: `object`[]
-
-The resources attached to the vertex.
-
-#### edges?
-
-> `optional` **edges**: `object`[]
-
-The edges connected to the vertex.

package/docs/reference/interfaces/IAuditableItemGraphEdge.md

@@ -8,12 +8,11 @@ Interface describing an edge between two vertices in an auditable item graph.
 
 ## Properties
 
-### dateCreated?
+### dateCreated? {#datecreated}
 
-> `optional` **dateCreated**: `string`
+> `optional` **dateCreated?**: `string`
 
 The date/time of when the element was created.
-json-ld namespace:schema
 
 #### Inherited from
 
@@ -21,12 +20,11 @@ json-ld namespace:schema
 
 ***
 
-### dateModified?
+### dateModified? {#datemodified}
 
-> `optional` **dateModified**: `string`
+> `optional` **dateModified?**: `string`
 
 The date/time of when the element was modified.
-json-ld namespace:schema
 
 #### Inherited from
 
@@ -34,12 +32,11 @@ json-ld namespace:schema
 
 ***
 
-### dateDeleted?
+### dateDeleted? {#datedeleted}
 
-> `optional` **dateDeleted**: `string`
+> `optional` **dateDeleted?**: `string`
 
 The date/time of when the element was deleted, as we never actually remove items.
-json-ld namespace:schema
 
 #### Inherited from
 
@@ -47,17 +44,17 @@ json-ld namespace:schema
 
 ***
 
-### @context
+### @context? {#context}
 
-> **@context**: `"https://schema.twindev.org/aig/"` \| \[`"https://schema.twindev.org/aig/"`, `...IJsonLdContextDefinitionElement[]`\]
+> `optional` **@context?**: `"https://schema.twindev.org/aig/"` \| \[`"https://schema.twindev.org/aig/"`, `...IJsonLdContextDefinitionElement[]`\]
 
 JSON-LD Context.
 
 ***
 
-### id?
+### id? {#id}
 
-> `optional` **id**: `string`
+> `optional` **id?**: `string`
 
 The id of the element.
 
@@ -67,16 +64,15 @@ The id of the element.
 
 ***
 
-### targetId
+### targetId {#targetid}
 
 > **targetId**: `string`
 
 The target vertex id the edge connects to.
-json-ld type:@id
 
 ***
 
-### type
+### type {#type}
 
 > **type**: `"AuditableItemGraphEdge"`
 
@@ -84,18 +80,16 @@ JSON-LD Type.
 
 ***
 
-### annotationObject?
+### annotationObject? {#annotationobject}
 
-> `optional` **annotationObject**: `IJsonLdNodeObject`
+> `optional` **annotationObject?**: `IJsonLdNodeObject`
 
 The JSON-LD annotation object for the edge.
-json-ld namespace:twin-common
 
 ***
 
-### edgeRelationships
+### edgeRelationships {#edgerelationships}
 
 > **edgeRelationships**: `string`[]
 
 The relationships between the two vertices.
-json-ld container:set

package/docs/reference/interfaces/IAuditableItemGraphEventBusVertexCreated.md

@@ -4,7 +4,7 @@ Event bus payload for vertex created.
 
 ## Properties
 
-### id
+### id {#id}
 
 > **id**: `string`
 

package/docs/reference/interfaces/IAuditableItemGraphEventBusVertexUpdated.md

@@ -4,7 +4,7 @@ Event bus payload for vertex updated.
 
 ## Properties
 
-### id
+### id {#id}
 
 > **id**: `string`
 
@@ -12,7 +12,7 @@ The id of the vertex updated.
 
 ***
 
-### patches
+### patches {#patches}
 
 > **patches**: `IPatchOperation`[]
 

package/docs/reference/interfaces/IAuditableItemGraphGetRequest.md

@@ -4,9 +4,9 @@ Get an auditable item graph vertex.
 
 ## Properties
 
-### headers?
+### headers? {#headers}
 
-> `optional` **headers**: `object`
+> `optional` **headers?**: `object`
 
 The headers which can be used to determine the response data type.
 
@@ -16,7 +16,7 @@ The headers which can be used to determine the response data type.
 
 ***
 
-### pathParams
+### pathParams {#pathparams}
 
 > **pathParams**: `object`
 
@@ -30,20 +30,20 @@ The id of the vertex to get.
 
 ***
 
-### query?
+### query? {#query}
 
-> `optional` **query**: `object`
+> `optional` **query?**: `object`
 
 The query parameters.
 
 #### includeDeleted?
 
-> `optional` **includeDeleted**: `string`
+> `optional` **includeDeleted?**: `string`
 
 Whether to include deleted aliases, resource, edges, defaults to false.
 
 #### verifySignatureDepth?
 
-> `optional` **verifySignatureDepth**: [`VerifyDepth`](../type-aliases/VerifyDepth.md)
+> `optional` **verifySignatureDepth?**: [`VerifyDepth`](../type-aliases/VerifyDepth.md)
 
 How many signatures to verify, none, current or all, defaults to "none".

package/docs/reference/interfaces/IAuditableItemGraphGetResponse.md

@@ -4,9 +4,9 @@ Response to getting an auditable item graph vertex.
 
 ## Properties
 
-### headers?
+### headers? {#headers}
 
-> `optional` **headers**: `object`
+> `optional` **headers?**: `object`
 
 The headers which can be used to determine the response data type.
 
@@ -16,7 +16,7 @@ The headers which can be used to determine the response data type.
 
 ***
 
-### body
+### body {#body}
 
 > **body**: [`IAuditableItemGraphVertex`](IAuditableItemGraphVertex.md)
 

package/docs/reference/interfaces/IAuditableItemGraphListPatch.md

@@ -0,0 +1,25 @@
+# Interface: IAuditableItemGraphListPatch\<TItem\>
+
+PATCH operations for a sub-list on a vertex.
+
+## Type Parameters
+
+### TItem
+
+`TItem` = [`IAuditableItemGraphEdge`](IAuditableItemGraphEdge.md) \| [`IAuditableItemGraphAlias`](IAuditableItemGraphAlias.md) \| [`IAuditableItemGraphResource`](IAuditableItemGraphResource.md)
+
+## Properties
+
+### add? {#add}
+
+> `optional` **add?**: `TItem`[]
+
+Items to add or update in the active set.
+
+***
+
+### remove? {#remove}
+
+> `optional` **remove?**: `string`[]
+
+Identifiers of items to remove from the active set (soft-delete).

package/docs/reference/interfaces/IAuditableItemGraphListRequest.md

@@ -4,9 +4,9 @@ Get the a list of the vertices with matching ids or aliases.
 
 ## Properties
 
-### headers?
+### headers? {#headers}
 
-> `optional` **headers**: `object`
+> `optional` **headers?**: `object`
 
 The headers which can be used to determine the response data type.
 
@@ -16,68 +16,68 @@ The headers which can be used to determine the response data type.
 
 ***
 
-### query?
+### query? {#query}
 
-> `optional` **query**: `object`
+> `optional` **query?**: `object`
 
 The query parameters.
 
 #### id?
 
-> `optional` **id**: `string`
+> `optional` **id?**: `string`
 
 The id or alias to try and find.
 
 #### idMode?
 
-> `optional` **idMode**: `"id"` \| `"alias"` \| `"both"`
+> `optional` **idMode?**: `"id"` \| `"alias"` \| `"both"`
 
 Which field to look in with the id, defaults to both.
 
 #### idExact?
 
-> `optional` **idExact**: `string`
+> `optional` **idExact?**: `string`
 
 Find only exact matches, default to false meaning partial matching.
 
 #### resourceTypes?
 
-> `optional` **resourceTypes**: `string`
+> `optional` **resourceTypes?**: `string`
 
 Include vertices with specific resource types, comma separated.
 
 #### conditions?
 
-> `optional` **conditions**: `string`
+> `optional` **conditions?**: `string`
 
-The conditions to filter the streams, JSON stringified IComparator[].
+The conditions to filter the streams, JSON stringified EntityCondition<IAuditableItemGraphVertex>.
 
 #### orderBy?
 
-> `optional` **orderBy**: `"dateCreated"` \| `"dateModified"`
+> `optional` **orderBy?**: `"dateCreated"` \| `"dateModified"`
 
 The order for the results, default to dateCreated.
 
 #### orderByDirection?
 
-> `optional` **orderByDirection**: `SortDirection`
+> `optional` **orderByDirection?**: `SortDirection`
 
 The direction for the order, defaults to desc.
 
 #### properties?
 
-> `optional` **properties**: `string`
+> `optional` **properties?**: `string`
 
 The properties to return as a comma separated list, defaults to "id,dateCreated,aliases,annotationObject".
 
 #### cursor?
 
-> `optional` **cursor**: `string`
+> `optional` **cursor?**: `string`
 
 The optional cursor to get next chunk.
 
 #### limit?
 
-> `optional` **limit**: `string`
+> `optional` **limit?**: `string`
 
 Limit the number of entities to return.

package/docs/reference/interfaces/IAuditableItemGraphListResponse.md

@@ -4,9 +4,9 @@ The response to getting the a list of the vertices with matching ids or aliases.
 
 ## Properties
 
-### headers?
+### headers? {#headers}
 
-> `optional` **headers**: `object`
+> `optional` **headers?**: `object`
 
 The headers which can be used to determine the response data type.
 
@@ -16,11 +16,11 @@ The headers which can be used to determine the response data type.
 
 #### link?
 
-> `optional` **link**: `string` \| `string`[]
+> `optional` **link?**: `string` \| `string`[]
 
 ***
 
-### body
+### body {#body}
 
 > **body**: [`IAuditableItemGraphVertexList`](IAuditableItemGraphVertexList.md)