@twin.org/rights-management-models 0.0.1-next.10

package/docs/changelog.md

@@ -0,0 +1,85 @@
+# @twin.org/rights-management-models - Changelog
+
+## [0.0.1-next.10](https://github.com/twinfoundation/rights-management/compare/rights-management-models-v0.0.1-next.9...rights-management-models-v0.0.1-next.10) (2025-06-12)
+
+
+### Features
+
+* update dependencies ([dd0a553](https://github.com/twinfoundation/rights-management/commit/dd0a553020b0dc5c41fb6865a2e36bd26045b0b9))
+
+## [0.0.1-next.9](https://github.com/twinfoundation/rights-management/compare/rights-management-models-v0.0.1-next.8...rights-management-models-v0.0.1-next.9) (2025-06-06)
+
+
+### Features
+
+* add publish workflows ([9f4db27](https://github.com/twinfoundation/rights-management/commit/9f4db27cccc724a5061f944b29ed7ed5317c9bbf))
+* pap create, update methods ([#13](https://github.com/twinfoundation/rights-management/issues/13)) ([edb6c9e](https://github.com/twinfoundation/rights-management/commit/edb6c9efcfda55ac96f7594253bf831b4f0e5993))
+* rename pap entity storage to pap service ([38a2c14](https://github.com/twinfoundation/rights-management/commit/38a2c14d8f63a86e398820166c83437be5aca1b8))
+* rights management pap ([#4](https://github.com/twinfoundation/rights-management/issues/4)) ([d1165a9](https://github.com/twinfoundation/rights-management/commit/d1165a92f57128731cfb308d977832e28cf33493))
+* update models based on feedback ([1f11df3](https://github.com/twinfoundation/rights-management/commit/1f11df32bdae5e0a9119e3eee9346b970c5fd345))
+* use shared store mechanism ([#2](https://github.com/twinfoundation/rights-management/issues/2)) ([21c086d](https://github.com/twinfoundation/rights-management/commit/21c086d7be3989858ee28bedb7a1e7b97d65b752))
+
+## [0.0.1-next.8](https://github.com/twinfoundation/rights-management/compare/rights-management-models-v0.0.1-next.7...rights-management-models-v0.0.1-next.8) (2025-06-05)
+
+
+### Features
+
+* pap create, update methods ([#13](https://github.com/twinfoundation/rights-management/issues/13)) ([edb6c9e](https://github.com/twinfoundation/rights-management/commit/edb6c9efcfda55ac96f7594253bf831b4f0e5993))
+
+## [0.0.1-next.7](https://github.com/twinfoundation/rights-management/compare/rights-management-models-v0.0.1-next.6...rights-management-models-v0.0.1-next.7) (2025-06-02)
+
+
+### Miscellaneous Chores
+
+* **rights-management-models:** Synchronize repo versions
+
+## [0.0.1-next.6](https://github.com/twinfoundation/rights-management/compare/rights-management-models-v0.0.1-next.5...rights-management-models-v0.0.1-next.6) (2025-05-29)
+
+
+### Miscellaneous Chores
+
+* **rights-management-models:** Synchronize repo versions
+
+## [0.0.1-next.5](https://github.com/twinfoundation/rights-management/compare/rights-management-models-v0.0.1-next.4...rights-management-models-v0.0.1-next.5) (2025-05-29)
+
+
+### Features
+
+* rename pap entity storage to pap service ([38a2c14](https://github.com/twinfoundation/rights-management/commit/38a2c14d8f63a86e398820166c83437be5aca1b8))
+
+## [0.0.1-next.4](https://github.com/twinfoundation/rights-management/compare/rights-management-models-v0.0.1-next.3...rights-management-models-v0.0.1-next.4) (2025-05-28)
+
+
+### Miscellaneous Chores
+
+* **rights-management-models:** Synchronize repo versions
+
+## [0.0.1-next.3](https://github.com/twinfoundation/rights-management/compare/rights-management-models-v0.0.1-next.2...rights-management-models-v0.0.1-next.3) (2025-05-28)
+
+
+### Features
+
+* add publish workflows ([9f4db27](https://github.com/twinfoundation/rights-management/commit/9f4db27cccc724a5061f944b29ed7ed5317c9bbf))
+* rights management pap ([#4](https://github.com/twinfoundation/rights-management/issues/4)) ([d1165a9](https://github.com/twinfoundation/rights-management/commit/d1165a92f57128731cfb308d977832e28cf33493))
+* update models based on feedback ([1f11df3](https://github.com/twinfoundation/rights-management/commit/1f11df32bdae5e0a9119e3eee9346b970c5fd345))
+* use shared store mechanism ([#2](https://github.com/twinfoundation/rights-management/issues/2)) ([21c086d](https://github.com/twinfoundation/rights-management/commit/21c086d7be3989858ee28bedb7a1e7b97d65b752))
+
+## [0.0.1-next.2](https://github.com/twinfoundation/rights-management/compare/rights-management-models-v0.0.1-next.1...rights-management-models-v0.0.1-next.2) (2025-04-17)
+
+
+### Features
+
+* add publish workflows ([9f4db27](https://github.com/twinfoundation/rights-management/commit/9f4db27cccc724a5061f944b29ed7ed5317c9bbf))
+* update models based on feedback ([1f11df3](https://github.com/twinfoundation/rights-management/commit/1f11df32bdae5e0a9119e3eee9346b970c5fd345))
+* use shared store mechanism ([#2](https://github.com/twinfoundation/rights-management/issues/2)) ([21c086d](https://github.com/twinfoundation/rights-management/commit/21c086d7be3989858ee28bedb7a1e7b97d65b752))
+
+## [0.0.1-next.2](https://github.com/twinfoundation/rights-management/compare/rights-management-models-v0.0.1-next.1...rights-management-models-v0.0.1-next.2) (2025-03-28)
+
+
+### Features
+
+* add publish workflows ([9f4db27](https://github.com/twinfoundation/rights-management/commit/9f4db27cccc724a5061f944b29ed7ed5317c9bbf))
+
+## v0.0.1-next.1
+
+- Initial Release

package/docs/examples.md

@@ -0,0 +1 @@
+# @twin.org/rights-management-models - Examples

package/docs/reference/index.md

@@ -0,0 +1,22 @@
+# @twin.org/rights-management-models
+
+## Interfaces
+
+- [IPolicyAdministrationPointComponent](interfaces/IPolicyAdministrationPointComponent.md)
+- [IPolicyDecisionPointComponent](interfaces/IPolicyDecisionPointComponent.md)
+- [IPolicyEnforcementPointComponent](interfaces/IPolicyEnforcementPointComponent.md)
+- [IPolicyExecutionPointComponent](interfaces/IPolicyExecutionPointComponent.md)
+- [IPolicyInformationPointComponent](interfaces/IPolicyInformationPointComponent.md)
+- [IPolicyManagementPointComponent](interfaces/IPolicyManagementPointComponent.md)
+- [IRightsManagementComponent](interfaces/IRightsManagementComponent.md)
+- [IPapCreateRequest](interfaces/IPapCreateRequest.md)
+- [IPapQueryRequest](interfaces/IPapQueryRequest.md)
+- [IPapQueryResponse](interfaces/IPapQueryResponse.md)
+- [IPapRemoveRequest](interfaces/IPapRemoveRequest.md)
+- [IPapRetrieveRequest](interfaces/IPapRetrieveRequest.md)
+- [IPapRetrieveResponse](interfaces/IPapRetrieveResponse.md)
+- [IPapUpdateRequest](interfaces/IPapUpdateRequest.md)
+
+## Type Aliases
+
+- [PolicyActionCallback](type-aliases/PolicyActionCallback.md)

package/docs/reference/interfaces/IPapCreateRequest.md

@@ -0,0 +1,11 @@
+# Interface: IPapCreateRequest
+
+The request structure for creating a policy.
+
+## Properties
+
+### body
+
+> **body**: `Omit`\<`IOdrlPolicy`, `"uid"`\>
+
+The body of the request - the policy to create (uid will be auto-generated).

package/docs/reference/interfaces/IPapQueryRequest.md

@@ -0,0 +1,29 @@
+# Interface: IPapQueryRequest
+
+The request structure for querying policies.
+
+## Properties
+
+### query?
+
+> `optional` **query**: `object`
+
+The query parameters of the request.
+
+#### conditions?
+
+> `optional` **conditions**: `string`
+
+The condition for the query.
+
+#### pageSize?
+
+> `optional` **pageSize**: `string`
+
+The number of entries to return per page.
+
+#### cursor?
+
+> `optional` **cursor**: `string`
+
+The cursor to get next chunk of data, returned in previous response.

package/docs/reference/interfaces/IPapQueryResponse.md

@@ -0,0 +1,23 @@
+# Interface: IPapQueryResponse
+
+The response structure for querying policies.
+
+## Properties
+
+### body
+
+> **body**: `object`
+
+The body of the response.
+
+#### cursor?
+
+> `optional` **cursor**: `string`
+
+The cursor for the next page of results, if there are more results available.
+
+#### policies
+
+> **policies**: `IOdrlPolicy`[]
+
+The policies matching the query.

package/docs/reference/interfaces/IPapRemoveRequest.md

@@ -0,0 +1,17 @@
+# Interface: IPapRemoveRequest
+
+The request structure for removing a policy.
+
+## Properties
+
+### pathParams
+
+> **pathParams**: `object`
+
+The path parameters of the request.
+
+#### id
+
+> **id**: `string`
+
+The ID of the policy to remove.

package/docs/reference/interfaces/IPapRetrieveRequest.md

@@ -0,0 +1,17 @@
+# Interface: IPapRetrieveRequest
+
+The request structure for retrieving a policy.
+
+## Properties
+
+### pathParams
+
+> **pathParams**: `object`
+
+The path parameters of the request.
+
+#### id
+
+> **id**: `string`
+
+The ID of the policy to retrieve.

package/docs/reference/interfaces/IPapRetrieveResponse.md

@@ -0,0 +1,11 @@
+# Interface: IPapRetrieveResponse
+
+The response structure for retrieving a policy.
+
+## Properties
+
+### body
+
+> **body**: `IOdrlPolicy`
+
+The body of the response.

package/docs/reference/interfaces/IPapUpdateRequest.md

@@ -0,0 +1,25 @@
+# Interface: IPapUpdateRequest
+
+The request structure for updating a policy.
+
+## Properties
+
+### pathParams
+
+> **pathParams**: `object`
+
+The path parameters of the request.
+
+#### id
+
+> **id**: `string`
+
+The ID of the policy to update.
+
+***
+
+### body
+
+> **body**: `IOdrlPolicy`
+
+The body of the request - the policy to update (must include uid).

package/docs/reference/interfaces/IPolicyAdministrationPointComponent.md

@@ -0,0 +1,129 @@
+# Interface: IPolicyAdministrationPointComponent
+
+Interface describing a Policy Administration Point (PAP) component that manages ODRL policies.
+
+## Extends
+
+- `IComponent`
+
+## Methods
+
+### create()
+
+> **create**(`policy`): `Promise`\<`string`\>
+
+Create a new policy with auto-generated UID.
+
+#### Parameters
+
+##### policy
+
+`Omit`\<`IOdrlPolicy`, `"uid"`\>
+
+The policy to create (uid will be auto-generated).
+
+#### Returns
+
+`Promise`\<`string`\>
+
+The UID of the created policy.
+
+***
+
+### update()
+
+> **update**(`policy`): `Promise`\<`void`\>
+
+Update an existing policy.
+
+#### Parameters
+
+##### policy
+
+`IOdrlPolicy`
+
+The policy to update (must include uid).
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Nothing.
+
+***
+
+### retrieve()
+
+> **retrieve**(`policyId`): `Promise`\<`IOdrlPolicy`\>
+
+Retrieve a policy.
+
+#### Parameters
+
+##### policyId
+
+`string`
+
+The id of the policy to retrieve.
+
+#### Returns
+
+`Promise`\<`IOdrlPolicy`\>
+
+The policy.
+
+***
+
+### remove()
+
+> **remove**(`policyId`): `Promise`\<`void`\>
+
+Remove a policy.
+
+#### Parameters
+
+##### policyId
+
+`string`
+
+The id of the policy to remove.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Nothing.
+
+***
+
+### query()
+
+> **query**(`conditions?`, `cursor?`, `pageSize?`): `Promise`\<\{ `cursor?`: `string`; `policies`: `IOdrlPolicy`[]; \}\>
+
+Query the policies using the specified conditions.
+
+#### Parameters
+
+##### conditions?
+
+`EntityCondition`\<`IOdrlPolicy`\>
+
+The conditions to use for the query.
+
+##### cursor?
+
+`string`
+
+The cursor to use for pagination.
+
+##### pageSize?
+
+`number`
+
+The number of results to return per page.
+
+#### Returns
+
+`Promise`\<\{ `cursor?`: `string`; `policies`: `IOdrlPolicy`[]; \}\>
+
+Cursor for next page of results and the policies matching the query.

package/docs/reference/interfaces/IPolicyDecisionPointComponent.md

@@ -0,0 +1,67 @@
+# Interface: IPolicyDecisionPointComponent
+
+Interface describing a Policy Decision Point (PDP) contract.
+Decides if a party can be granted access to a resource, will retrieve policies
+from the Policy Management Point (PMP) and any additional information from the
+Policy Information Point (PIP). When a decision is made, the Policy Execution
+Point (PEP) will execute any registered actions.
+
+## Extends
+
+- `IComponent`
+
+## Methods
+
+### evaluate()
+
+> **evaluate**\<`T`\>(`assetType`, `action`, `data`, `userIdentity`, `nodeIdentity`): `Promise`\<`IOdrlPolicy`[]\>
+
+Evaluate requests from a Policy Enforcement Point (PEP).
+Uses the Policy Management Point (PMP) to retrieve the policies and the
+Policy Information Point (PIP) to retrieve additional information.
+Executes any actions on the Policy Execution Point (PEP) when the decision is made.
+
+#### Type Parameters
+
+##### T
+
+`T` = `unknown`
+
+#### Parameters
+
+##### assetType
+
+`string`
+
+The type of asset being processed.
+
+##### action
+
+`string`
+
+The action being performed on the asset.
+
+##### data
+
+The data to make a decision on.
+
+`undefined` | `T`
+
+##### userIdentity
+
+`string`
+
+The user identity to use in the decision making.
+
+##### nodeIdentity
+
+`string`
+
+The node identity to use in the decision making.
+
+#### Returns
+
+`Promise`\<`IOdrlPolicy`[]\>
+
+Returns the policy decisions which apply to the data so that the PEP
+can manipulate the data accordingly.

package/docs/reference/interfaces/IPolicyEnforcementPointComponent.md

@@ -0,0 +1,62 @@
+# Interface: IPolicyEnforcementPointComponent
+
+Interface describing a Policy Enforcement Point (PEP) contract.
+Intercepts data and uses the Policy Decision Point (PDP) to make decisions on
+access to a resource, based on the decision a manipulated data object can
+be returned.
+
+## Extends
+
+- `IComponent`
+
+## Methods
+
+### intercept()
+
+> **intercept**\<`T`\>(`assetType`, `action`, `data`, `userIdentity`, `nodeIdentity`): `Promise`\<`undefined` \| `T`\>
+
+Process the data using Policy Decision Point (PDP) and return the manipulated data.
+
+#### Type Parameters
+
+##### T
+
+`T` = `unknown`
+
+#### Parameters
+
+##### assetType
+
+`string`
+
+The type of asset being processed.
+
+##### action
+
+`string`
+
+The action being performed on the asset.
+
+##### data
+
+The data to process.
+
+`undefined` | `T`
+
+##### userIdentity
+
+`string`
+
+The user identity to use in the decision making.
+
+##### nodeIdentity
+
+`string`
+
+The node identity to use in the decision making.
+
+#### Returns
+
+`Promise`\<`undefined` \| `T`\>
+
+The manipulated data with any policies applied.

package/docs/reference/interfaces/IPolicyExecutionPointComponent.md

@@ -0,0 +1,124 @@
+# Interface: IPolicyExecutionPointComponent
+
+Interface describing a Policy Execution Point (PXP) contract.
+When a decision is made by the Policy Decision Point (PDP),
+the Policy Execution Point (PEP) will execute any
+registered actions based on the decision.
+
+## Extends
+
+- `IComponent`
+
+## Methods
+
+### executeActions()
+
+> **executeActions**\<`T`\>(`assetType`, `action`, `data`, `userIdentity`, `nodeIdentity`, `policies`): `Promise`\<`void`\>
+
+Execute actions based on the PDP's decisions.
+
+#### Type Parameters
+
+##### T
+
+`T` = `unknown`
+
+#### Parameters
+
+##### assetType
+
+`string`
+
+The type of asset being processed.
+
+##### action
+
+`string`
+
+The action being performed on the asset.
+
+##### data
+
+The data used in the decision by the PDP.
+
+`undefined` | `T`
+
+##### userIdentity
+
+`string`
+
+The user identity to use in the decision making.
+
+##### nodeIdentity
+
+`string`
+
+The node identity to use in the decision making.
+
+##### policies
+
+`IOdrlPolicy`[]
+
+The policies that apply to the data.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Nothing.
+
+***
+
+### registerAction()
+
+> **registerAction**\<`T`\>(`actionId`, `action`): `Promise`\<`void`\>
+
+Register an action to be executed.
+
+#### Type Parameters
+
+##### T
+
+`T` = `unknown`
+
+#### Parameters
+
+##### actionId
+
+`string`
+
+The id of the action to register.
+
+##### action
+
+[`PolicyActionCallback`](../type-aliases/PolicyActionCallback.md)\<`T`\>
+
+The action to execute.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Nothing.
+
+***
+
+### unregisterAction()
+
+> **unregisterAction**(`actionId`): `Promise`\<`void`\>
+
+Unregister an action from the execution point.
+
+#### Parameters
+
+##### actionId
+
+`string`
+
+The id of the action to unregister.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Nothing.

package/docs/reference/interfaces/IPolicyInformationPointComponent.md

@@ -0,0 +1,61 @@
+# Interface: IPolicyInformationPointComponent
+
+Interface describing a Policy Information Point (PEP) contract.
+Provides additional information to the Policy Decision Point (PDP) when
+it is making decisions.
+
+## Extends
+
+- `IComponent`
+
+## Methods
+
+### retrieve()
+
+> **retrieve**\<`T`\>(`assetType`, `action`, `data`, `userIdentity`, `nodeIdentity`): `Promise`\<`IJsonLdNodeObject`[]\>
+
+Retrieve additional information which is relevant in the PDP decision making.
+
+#### Type Parameters
+
+##### T
+
+`T` = `unknown`
+
+#### Parameters
+
+##### assetType
+
+`string`
+
+The type of asset being processed.
+
+##### action
+
+`string`
+
+The action being performed on the asset.
+
+##### data
+
+The data to get any additional information for.
+
+`undefined` | `T`
+
+##### userIdentity
+
+`string`
+
+The user identity to get additional information for.
+
+##### nodeIdentity
+
+`string`
+
+The node identity to get additional information for.
+
+#### Returns
+
+`Promise`\<`IJsonLdNodeObject`[]\>
+
+Returns additional information based on the data and identities.