@twin.org/rights-management-models 0.0.3-next.9 → 0.9.0

package/dist/es/models/pnp/IPolicyNegotiationAdminPointComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"IPolicyNegotiationAdminPointComponent.js","sourceRoot":"","sources":["../../../../src/models/pnp/IPolicyNegotiationAdminPointComponent.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type { DataspaceProtocolContractNegotiationStateType } from \"@twin.org/standards-dataspace-protocol\";\nimport type { IPolicyNegotiation } from \"./IPolicyNegotiation.js\";\n\n/**\n * Interface describing a Policy Negotiation Admin Point (PNAP) contract.\n * Components performs administration tasks on the policy negotiations.\n * https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#negotiation-protocol\n */\nexport interface IPolicyNegotiationAdminPointComponent extends IComponent {\n\t/**\n\t * Retrieves a policy negotiation.\n\t * @param id The ID of the policy to retrieve the negotiation for.\n\t * @returns The policy negotiation.\n\t */\n\tget(id: string): Promise<IPolicyNegotiation>;\n\n\t/**\n\t * Sets a policy negotiation.\n\t * @param negotiation The updated policy negotiation.\n\t * @returns Nothing.\n\t */\n\tset(negotiation: IPolicyNegotiation): Promise<void>;\n\n\t/**\n\t * Cancels an ongoing negotiation for a resource.\n\t * @param policyId The ID of the policy to cancel.\n\t * @returns Nothing.\n\t */\n\tremove(policyId: string): Promise<void>;\n\n\t/**\n\t * Get a list of the negotiations.\n\t * @param status The state of the negotiations to retrieve.\n\t * @param cursor The cursor to use for pagination.\n\t * @returns A list of negotiations and cursor if there are more entries.\n\t */\n\tquery(\n\t\tstatus?: DataspaceProtocolContractNegotiationStateType,\n\t\tcursor?: string\n\t): Promise<{ items: IPolicyNegotiation[]; cursor?: string }>;\n}\n"]}
+{"version":3,"file":"IPolicyNegotiationAdminPointComponent.js","sourceRoot":"","sources":["../../../../src/models/pnp/IPolicyNegotiationAdminPointComponent.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type { DataspaceProtocolContractNegotiationStateType } from \"@twin.org/standards-dataspace-protocol\";\nimport type { IPolicyNegotiation } from \"./IPolicyNegotiation.js\";\n\n/**\n * Interface describing a Policy Negotiation Admin Point (PNAP) contract.\n * Components performs administration tasks on the policy negotiations.\n * @see https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#negotiation-protocol\n */\nexport interface IPolicyNegotiationAdminPointComponent extends IComponent {\n\t/**\n\t * Pre-registers a consumer-side negotiation entry.\n\t * id must be the consumer's chosen consumerPid — it becomes the primary key used by offerFromProvider().\n\t * @param id The consumer-side negotiation identifier.\n\t * @returns The negotiation id (same as the caller-supplied id).\n\t */\n\tcreate(id: string): Promise<string>;\n\n\t/**\n\t * Retrieves a policy negotiation.\n\t * @param id The ID of the policy to retrieve the negotiation for.\n\t * @returns The policy negotiation.\n\t */\n\tget(id: string): Promise<IPolicyNegotiation>;\n\n\t/**\n\t * Sets a policy negotiation.\n\t * @param negotiation The updated policy negotiation.\n\t * @returns A promise that resolves when the negotiation has been stored.\n\t */\n\tset(negotiation: IPolicyNegotiation): Promise<void>;\n\n\t/**\n\t * Cancels an ongoing negotiation for a resource.\n\t * @param policyId The ID of the policy to cancel.\n\t * @returns A promise that resolves when the negotiation has been removed.\n\t */\n\tremove(policyId: string): Promise<void>;\n\n\t/**\n\t * Get a list of the negotiations.\n\t * @param status The state of the negotiations to retrieve.\n\t * @param cursor The cursor to use for pagination.\n\t * @returns A list of negotiations and cursor if there are more entries.\n\t */\n\tquery(\n\t\tstatus?: DataspaceProtocolContractNegotiationStateType,\n\t\tcursor?: string\n\t): Promise<{ items: IPolicyNegotiation[]; cursor?: string }>;\n}\n"]}

package/dist/es/models/pnp/IPolicyNegotiationPointComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"IPolicyNegotiationPointComponent.js","sourceRoot":"","sources":["../../../../src/models/pnp/IPolicyNegotiationPointComponent.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type {\n\tIDataspaceProtocolContractAgreementMessage,\n\tIDataspaceProtocolContractAgreementVerificationMessage,\n\tIDataspaceProtocolContractNegotiation,\n\tIDataspaceProtocolContractNegotiationError,\n\tIDataspaceProtocolContractNegotiationEventMessage,\n\tIDataspaceProtocolContractNegotiationTerminationMessage,\n\tIDataspaceProtocolContractOfferMessage,\n\tIDataspaceProtocolContractRequestMessage\n} from \"@twin.org/standards-dataspace-protocol\";\n\n/**\n * Interface describing a Policy Negotiation Point (PNP) contract.\n * When receiving a request from another component, the PNP will negotiate the terms\n * of the request and determine the appropriate policies to create.\n * https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#negotiation-protocol\n */\nexport interface IPolicyNegotiationPointComponent extends IComponent {\n\t/**\n\t * Get the current state of the negotiation.\n\t * @param id The id of the negotiation to retrieve.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The current state of the negotiation or an error.\n\t */\n\tgetNegotiation(\n\t\tid: string,\n\t\ttrustPayload: unknown\n\t): Promise<IDataspaceProtocolContractNegotiation | IDataspaceProtocolContractNegotiationError>;\n\n\t/**\n\t * Send a request to a provider.\n\t * @param url The url of the provider to send the request to.\n\t * @param requesterId The id of the requester to use for the request, will use the registered requester to provide update.\n\t * @param odrlOfferId The id of the offer to request.\n\t * @param publicOrigin The public origin url of this PNP service.\n\t * @returns The negotiation id.\n\t */\n\tsendRequestToProvider(\n\t\turl: string,\n\t\trequesterId: string,\n\t\todrlOfferId: string,\n\t\tpublicOrigin: string\n\t): Promise<string>;\n\n\t/**\n\t * Processes an incoming request on a provider from a consumer.\n\t * @param message The negotiation request.\n\t * @param publicOrigin The public origin url of this PNP service.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The current state of the contract negotiation or an error.\n\t */\n\trequestFromConsumer(\n\t\tmessage: IDataspaceProtocolContractRequestMessage,\n\t\tpublicOrigin: string,\n\t\ttrustPayload: unknown\n\t): Promise<IDataspaceProtocolContractNegotiation | IDataspaceProtocolContractNegotiationError>;\n\n\t/**\n\t * An offer has been received by a consumer.\n\t * @param message The offer being received by the consumer.\n\t * @param publicOrigin The public origin url of this PNP service.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The current state of the contract negotiation or an error.\n\t */\n\tofferFromProvider(\n\t\tmessage: IDataspaceProtocolContractOfferMessage,\n\t\tpublicOrigin: string,\n\t\ttrustPayload: unknown\n\t): Promise<IDataspaceProtocolContractNegotiation | IDataspaceProtocolContractNegotiationError>;\n\n\t/**\n\t * An agreement has been received by a consumer.\n\t * @param message The agreement message to send.\n\t * @param publicOrigin The public origin url of this PNP service.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The error if there is one.\n\t */\n\tagreementFromProvider(\n\t\tmessage: IDataspaceProtocolContractAgreementMessage,\n\t\tpublicOrigin: string,\n\t\ttrustPayload: unknown\n\t): Promise<IDataspaceProtocolContractNegotiationError | undefined>;\n\n\t/**\n\t * An agreement verification has been received by a provider.\n\t * @param message The agreement verification message to send.\n\t * @param publicOrigin The public origin url of this PNP service.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The error if there is one.\n\t */\n\tagreementVerificationFromConsumer(\n\t\tmessage: IDataspaceProtocolContractAgreementVerificationMessage,\n\t\tpublicOrigin: string,\n\t\ttrustPayload: unknown\n\t): Promise<IDataspaceProtocolContractNegotiationError | undefined>;\n\n\t/**\n\t * An event has been received by the provider or consumer.\n\t * @param message The event message to send.\n\t * @param destination The destination is provider or consumer.\n\t * @param publicOrigin The public origin url of this PNP service.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The error if there is one.\n\t */\n\tevent(\n\t\tmessage: IDataspaceProtocolContractNegotiationEventMessage,\n\t\tdestination: \"provider\" | \"consumer\",\n\t\tpublicOrigin: string,\n\t\ttrustPayload: unknown\n\t): Promise<IDataspaceProtocolContractNegotiationError | undefined>;\n\n\t/**\n\t * A termination message has been received by the provider or consumer.\n\t * @param message The termination message to send.\n\t * @param destination The destination is provider or consumer.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The error if there is one.\n\t */\n\tterminate(\n\t\tmessage: IDataspaceProtocolContractNegotiationTerminationMessage,\n\t\tdestination: \"provider\" | \"consumer\",\n\t\ttrustPayload: unknown\n\t): Promise<IDataspaceProtocolContractNegotiationError | undefined>;\n}\n"]}
+{"version":3,"file":"IPolicyNegotiationPointComponent.js","sourceRoot":"","sources":["../../../../src/models/pnp/IPolicyNegotiationPointComponent.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type {\n\tIDataspaceProtocolContractAgreementMessage,\n\tIDataspaceProtocolContractAgreementVerificationMessage,\n\tIDataspaceProtocolContractNegotiation,\n\tIDataspaceProtocolContractNegotiationError,\n\tIDataspaceProtocolContractNegotiationEventMessage,\n\tIDataspaceProtocolContractNegotiationTerminationMessage,\n\tIDataspaceProtocolContractOfferMessage,\n\tIDataspaceProtocolContractRequestMessage\n} from \"@twin.org/standards-dataspace-protocol\";\n\n/**\n * Interface describing a Policy Negotiation Point (PNP) contract.\n * When receiving a request from another component, the PNP will negotiate the terms\n * of the request and determine the appropriate policies to create.\n * @see https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#negotiation-protocol\n */\nexport interface IPolicyNegotiationPointComponent extends IComponent {\n\t/**\n\t * Get the current state of the negotiation.\n\t * @param id The id of the negotiation to retrieve.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The current state of the negotiation or an error.\n\t */\n\tgetNegotiation(\n\t\tid: string,\n\t\ttrustPayload: unknown\n\t): Promise<IDataspaceProtocolContractNegotiation | IDataspaceProtocolContractNegotiationError>;\n\n\t/**\n\t * Send a request to a provider.\n\t * @param url The url of the provider to send the request to.\n\t * @param requesterType The type of the requester to use for the request, will use the registered requester to provide update.\n\t * @param odrlOfferId The id of the offer to request.\n\t * @param publicOrigin The public origin url of this PNP service.\n\t * @returns The negotiation id.\n\t */\n\tsendRequestToProvider(\n\t\turl: string,\n\t\trequesterType: string,\n\t\todrlOfferId: string,\n\t\tpublicOrigin: string\n\t): Promise<string>;\n\n\t/**\n\t * Processes an incoming request on a provider from a consumer.\n\t * @param message The negotiation request.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The current state of the contract negotiation or an error.\n\t */\n\trequestFromConsumer(\n\t\tmessage: IDataspaceProtocolContractRequestMessage,\n\t\ttrustPayload: unknown\n\t): Promise<IDataspaceProtocolContractNegotiation | IDataspaceProtocolContractNegotiationError>;\n\n\t/**\n\t * An offer has been received by a consumer.\n\t * @param message The offer being received by the consumer.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The current state of the contract negotiation or an error.\n\t */\n\tofferFromProvider(\n\t\tmessage: IDataspaceProtocolContractOfferMessage,\n\t\ttrustPayload: unknown\n\t): Promise<IDataspaceProtocolContractNegotiation | IDataspaceProtocolContractNegotiationError>;\n\n\t/**\n\t * An agreement has been received by a consumer.\n\t * @param message The agreement message to send.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The error if there is one.\n\t */\n\tagreementFromProvider(\n\t\tmessage: IDataspaceProtocolContractAgreementMessage,\n\t\ttrustPayload: unknown\n\t): Promise<IDataspaceProtocolContractNegotiationError | undefined>;\n\n\t/**\n\t * An agreement verification has been received by a provider.\n\t * @param message The agreement verification message to send.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The error if there is one.\n\t */\n\tagreementVerificationFromConsumer(\n\t\tmessage: IDataspaceProtocolContractAgreementVerificationMessage,\n\t\ttrustPayload: unknown\n\t): Promise<IDataspaceProtocolContractNegotiationError | undefined>;\n\n\t/**\n\t * An event has been received by the provider or consumer.\n\t * @param message The event message to send.\n\t * @param destination The destination is provider or consumer.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The error if there is one.\n\t */\n\tevent(\n\t\tmessage: IDataspaceProtocolContractNegotiationEventMessage,\n\t\tdestination: \"provider\" | \"consumer\",\n\t\ttrustPayload: unknown\n\t): Promise<IDataspaceProtocolContractNegotiationError | undefined>;\n\n\t/**\n\t * A termination message has been received by the provider or consumer.\n\t * @param message The termination message to send.\n\t * @param destination The destination is provider or consumer.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The error if there is one.\n\t */\n\tterminate(\n\t\tmessage: IDataspaceProtocolContractNegotiationTerminationMessage,\n\t\tdestination: \"provider\" | \"consumer\",\n\t\ttrustPayload: unknown\n\t): Promise<IDataspaceProtocolContractNegotiationError | undefined>;\n\n\t/**\n\t * Send a terminate message to a consumer at the given callback address.\n\t * Used by stall cleanup to notify consumers that their negotiation has been terminated.\n\t * @param callbackAddress The consumer callback URL to send the termination to.\n\t * @param providerPid The provider negotiation id.\n\t * @param consumerPid The consumer negotiation id.\n\t * @returns Resolves when the terminate message has been sent.\n\t */\n\tsendTerminateToConsumer(\n\t\tcallbackAddress: string,\n\t\tproviderPid: string,\n\t\tconsumerPid: string\n\t): Promise<void>;\n}\n"]}

package/dist/es/models/pnp/IPolicyNegotiator.js.map

@@ -1 +1 @@
-{"version":3,"file":"IPolicyNegotiator.js","sourceRoot":"","sources":["../../../../src/models/pnp/IPolicyNegotiator.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type { IOdrlAgreement, IOdrlOffer } from \"@twin.org/standards-w3c-odrl\";\nimport type { IPolicyInformation } from \"../pip/IPolicyInformation.js\";\n\n/**\n * Interface describing a Policy Negotiator.\n */\nexport interface IPolicyNegotiator extends IComponent {\n\t/**\n\t * Determines if the negotiator supports the given offer.\n\t * @param offer The offer to check.\n\t * @returns Sets the supports flag if it can be offered, and the interventionRequired flag if manual agreement is needed.\n\t */\n\tsupportsOffer(offer: IOdrlOffer): boolean;\n\n\t/**\n\t * Handle the offer.\n\t * @param offer The offer to check.\n\t * @param information Information provided by the requester to determine if a policy can be created.\n\t * @returns Sets the accepted flag if it can be offered, and the interventionRequired flag if manual agreement is needed.\n\t */\n\thandleOffer(\n\t\toffer: IOdrlOffer,\n\t\tinformation?: IPolicyInformation\n\t): Promise<{\n\t\taccepted: boolean;\n\t\tinterventionRequired: boolean;\n\t}>;\n\n\t/**\n\t * Create an agreement based on the offer.\n\t * @param offer The offer to create the agreement from.\n\t * @param information Information provided by the requester to aid in the creation of the agreement.\n\t * @returns The agreement created from the offer or undefined if an agreement could not be created.\n\t */\n\tcreateAgreement(\n\t\toffer: IOdrlOffer,\n\t\tinformation?: IPolicyInformation\n\t): Promise<IOdrlAgreement | undefined>;\n}\n"]}
+{"version":3,"file":"IPolicyNegotiator.js","sourceRoot":"","sources":["../../../../src/models/pnp/IPolicyNegotiator.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type {\n\tIDataspaceProtocolAgreement,\n\tIDataspaceProtocolOffer\n} from \"@twin.org/standards-dataspace-protocol\";\nimport type { IOdrlParty } from \"@twin.org/standards-w3c-odrl\";\nimport type { IRightsManagementInformation } from \"../IRightsManagementInformation.js\";\n\n/**\n * Interface describing a Policy Negotiator.\n */\nexport interface IPolicyNegotiator extends IComponent {\n\t/**\n\t * Determines if the negotiator supports the given offer.\n\t * @param offer The offer to check.\n\t * @returns True if the negotiator supports the given offer.\n\t */\n\tsupportsOffer(offer: IDataspaceProtocolOffer): boolean;\n\n\t/**\n\t * Handle the offer.\n\t * @param offer The offer to check.\n\t * @param information Information provided by the requester to determine if a policy can be created.\n\t * @returns Sets the accepted flag if it can be offered, and the interventionRequired flag if manual agreement is needed.\n\t */\n\thandleOffer(\n\t\toffer: IDataspaceProtocolOffer,\n\t\tinformation?: IRightsManagementInformation\n\t): Promise<{\n\t\taccepted: boolean;\n\t\tinterventionRequired: boolean;\n\t}>;\n\n\t/**\n\t * Create an agreement based on the offer.\n\t * @param offer The offer to create the agreement from.\n\t * @param assignee The assignee of the agreement.\n\t * @param information Information provided by the requester to aid in the creation of the agreement.\n\t * @returns The agreement created from the offer or undefined if an agreement could not be created.\n\t */\n\tcreateAgreement(\n\t\toffer: IDataspaceProtocolOffer,\n\t\tassignee: string | IOdrlParty,\n\t\tinformation?: IRightsManagementInformation\n\t): Promise<IDataspaceProtocolAgreement | undefined>;\n}\n"]}

package/dist/es/models/pnp/IPolicyRequester.js.map

@@ -1 +1 @@
-{"version":3,"file":"IPolicyRequester.js","sourceRoot":"","sources":["../../../../src/models/pnp/IPolicyRequester.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type { IOdrlAgreement, IOdrlOffer } from \"@twin.org/standards-w3c-odrl\";\n\n/**\n * Interface describing a Policy Requester.\n */\nexport interface IPolicyRequester extends IComponent {\n\t/**\n\t * The unique id of the requester.\n\t * @returns The requester id.\n\t */\n\trequesterId(): string;\n\n\t/**\n\t * A policy has been offered by a provider, let the requester know about it.\n\t * @param negotiationId The id of the negotiation.\n\t * @param offer The offer sent by the provider.\n\t * @returns True if the offer was accepted, false otherwise.\n\t */\n\toffer(negotiationId: string, offer: IOdrlOffer): Promise<boolean>;\n\n\t/**\n\t * A policy agreement has been sent by a provider, let the requester know about it.\n\t * @param negotiationId The id of the negotiation.\n\t * @param agreement The agreement sent by the provider.\n\t * @returns True if the agreement was accepted, false otherwise.\n\t */\n\tagreement(negotiationId: string, agreement: IOdrlAgreement): Promise<boolean>;\n\n\t/**\n\t * A policy finalisation has been sent by a provider, let the requester know about it.\n\t * @param negotiationId The id of the negotiation.\n\t * @returns Nothing.\n\t */\n\tfinalised(negotiationId: string): Promise<void>;\n\n\t/**\n\t * A policy termination has been sent by a provider, let the requester know about it.\n\t * @param negotiationId The id of the negotiation.\n\t * @returns Nothing.\n\t */\n\tterminated(negotiationId: string): Promise<void>;\n}\n"]}
+{"version":3,"file":"IPolicyRequester.js","sourceRoot":"","sources":["../../../../src/models/pnp/IPolicyRequester.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type { JsonLdObjectWithOptionalContext } from \"@twin.org/data-json-ld\";\nimport type {\n\tIDataspaceProtocolAgreement,\n\tIDataspaceProtocolOffer\n} from \"@twin.org/standards-dataspace-protocol\";\n\n/**\n * Interface describing a Policy Requester.\n */\nexport interface IPolicyRequester extends IComponent {\n\t/**\n\t * A policy has been offered by a provider, let the requester know about it.\n\t * @param negotiationId The id of the negotiation.\n\t * @param offer The offer sent by the provider.\n\t * @returns True if the offer was accepted, false otherwise.\n\t */\n\toffer(\n\t\tnegotiationId: string,\n\t\toffer: JsonLdObjectWithOptionalContext<IDataspaceProtocolOffer>\n\t): Promise<boolean>;\n\n\t/**\n\t * A policy agreement has been sent by a provider, let the requester know about it.\n\t * @param negotiationId The id of the negotiation.\n\t * @param agreement The agreement sent by the provider.\n\t * @returns True if the agreement was accepted, false otherwise.\n\t */\n\tagreement(\n\t\tnegotiationId: string,\n\t\tagreement: JsonLdObjectWithOptionalContext<IDataspaceProtocolAgreement>\n\t): Promise<boolean>;\n\n\t/**\n\t * A policy finalisation has been sent by a provider, let the requester know about it.\n\t * @param negotiationId The id of the negotiation.\n\t * @returns A promise that resolves when the finalisation has been processed.\n\t */\n\tfinalised(negotiationId: string): Promise<void>;\n\n\t/**\n\t * A policy termination has been sent by a provider, let the requester know about it.\n\t * @param negotiationId The id of the negotiation.\n\t * @returns A promise that resolves when the termination has been processed.\n\t */\n\tterminated(negotiationId: string): Promise<void>;\n}\n"]}

package/dist/es/models/policyMetadataContext.js

@@ -0,0 +1,17 @@
+// Copyright 2026 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Minimal inline JSON-LD context for PAP-managed schema.org policy metadata terms.
+ * Avoids importing the full schema.org vocabulary, which collides with ODRL terms such as Offer and target.
+ */
+export const POLICY_METADATA_CONTEXT = {
+    /**
+     * schema.org dateCreated term IRI.
+     */
+    dateCreated: "https://schema.org/dateCreated",
+    /**
+     * schema.org dateModified term IRI.
+     */
+    dateModified: "https://schema.org/dateModified"
+};
+//# sourceMappingURL=policyMetadataContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policyMetadataContext.js","sourceRoot":"","sources":["../../../src/models/policyMetadataContext.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACtC;;OAEG;IACH,WAAW,EAAE,gCAAgC;IAC7C;;OAEG;IACH,YAAY,EAAE,iCAAiC;CACtC,CAAC","sourcesContent":["// Copyright 2026 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * Minimal inline JSON-LD context for PAP-managed schema.org policy metadata terms.\n * Avoids importing the full schema.org vocabulary, which collides with ODRL terms such as Offer and target.\n */\nexport const POLICY_METADATA_CONTEXT = {\n\t/**\n\t * schema.org dateCreated term IRI.\n\t */\n\tdateCreated: \"https://schema.org/dateCreated\",\n\t/**\n\t * schema.org dateModified term IRI.\n\t */\n\tdateModified: \"https://schema.org/dateModified\"\n} as const;\n"]}

package/dist/es/models/pxp/IPolicyExecutionAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"IPolicyExecutionAction.js","sourceRoot":"","sources":["../../../../src/models/pxp/IPolicyExecutionAction.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type { IOdrlPolicy } from \"@twin.org/standards-w3c-odrl\";\nimport type { IPolicyLocator } from \"../IPolicyLocator.js\";\nimport type { IPolicyDecision } from \"../pdp/IPolicyDecision.js\";\nimport type { PolicyDecisionStage } from \"../pdp/policyDecisionStage.js\";\n\n/**\n * Interface for policy execution actions.\n */\nexport interface IPolicyExecutionAction extends IComponent {\n\t/**\n\t * Which stages should the action be executed at.\n\t * @returns List of stages.\n\t */\n\tsupportedStages(): PolicyDecisionStage[];\n\n\t/**\n\t * Execute function type for policy actions.\n\t * @param stage The stage of the policy decision.\n\t * @param locator The locator to find relevant policies.\n\t * @param policies The policies that apply to the data.\n\t * @param decisions The decisions made by the PDP.\n\t * @param data The data to process.\n\t * @returns A promise that resolves when the action is complete.\n\t */\n\texecute<D = unknown>(\n\t\tstage: PolicyDecisionStage,\n\t\tlocator: IPolicyLocator,\n\t\tpolicies?: IOdrlPolicy[],\n\t\tdecisions?: IPolicyDecision[],\n\t\tdata?: D\n\t): Promise<void>;\n}\n"]}
+{"version":3,"file":"IPolicyExecutionAction.js","sourceRoot":"","sources":["../../../../src/models/pxp/IPolicyExecutionAction.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type { OdrlActionType } from \"@twin.org/standards-w3c-odrl\";\nimport type { IRightsManagementPolicy } from \"../IRightsManagementPolicy.js\";\nimport type { IPolicyDecision } from \"../pdp/IPolicyDecision.js\";\nimport type { PolicyDecisionStage } from \"../pdp/policyDecisionStage.js\";\n\n/**\n * Interface for policy execution actions.\n */\nexport interface IPolicyExecutionAction extends IComponent {\n\t/**\n\t * Which stages should the action be executed at.\n\t * @returns List of stages.\n\t */\n\tsupportedStages(): PolicyDecisionStage[];\n\n\t/**\n\t * Execute function type for policy actions.\n\t * @param policy The policy that applied to the data.\n\t * @param decisions The decisions made by the PDP.\n\t * @param data The data to process.\n\t * @param action The action that was evaluated.\n\t * @param stage The stage of the policy decision.\n\t * @returns A promise that resolves when the action is complete.\n\t */\n\texecute<D = unknown>(\n\t\tpolicy: IRightsManagementPolicy,\n\t\tdecisions: IPolicyDecision[],\n\t\tdata: D | undefined,\n\t\taction: OdrlActionType | string | undefined,\n\t\tstage: PolicyDecisionStage\n\t): Promise<void>;\n}\n"]}

package/dist/es/models/pxp/IPolicyExecutionPointComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"IPolicyExecutionPointComponent.js","sourceRoot":"","sources":["../../../../src/models/pxp/IPolicyExecutionPointComponent.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type { IOdrlPolicy } from \"@twin.org/standards-w3c-odrl\";\nimport type { IPolicyLocator } from \"../IPolicyLocator.js\";\nimport type { IPolicyDecision } from \"../pdp/IPolicyDecision.js\";\nimport type { PolicyDecisionStage } from \"../pdp/policyDecisionStage.js\";\n\n/**\n * Interface describing a Policy Execution Point (PXP) contract.\n * When a decision is made by the Policy Decision Point (PDP),\n * the Policy Execution Point (PXP) will execute any\n * registered actions based on the decision.\n */\nexport interface IPolicyExecutionPointComponent extends IComponent {\n\t/**\n\t * Execute actions based on the PDP's decisions.\n\t * @param stage The stage at which the PXP is executed in the PDP.\n\t * @param locator The locator to find relevant policies.\n\t * @param policies The policies that apply to the data.\n\t * @param decisions The decisions made by the PDP.\n\t * @param data The data used in the decision by the PDP.\n\t * @returns Nothing.\n\t */\n\texecuteActions<D = unknown>(\n\t\tstage: PolicyDecisionStage,\n\t\tlocator: IPolicyLocator,\n\t\tpolicies?: IOdrlPolicy[],\n\t\tdecisions?: IPolicyDecision[],\n\t\tdata?: D\n\t): Promise<void>;\n}\n"]}
+{"version":3,"file":"IPolicyExecutionPointComponent.js","sourceRoot":"","sources":["../../../../src/models/pxp/IPolicyExecutionPointComponent.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type { OdrlActionType } from \"@twin.org/standards-w3c-odrl\";\nimport type { IRightsManagementPolicy } from \"../IRightsManagementPolicy.js\";\nimport type { IPolicyDecision } from \"../pdp/IPolicyDecision.js\";\nimport type { PolicyDecisionStage } from \"../pdp/policyDecisionStage.js\";\n\n/**\n * Interface describing a Policy Execution Point (PXP) contract.\n * When a decision is made by the Policy Decision Point (PDP),\n * the Policy Execution Point (PXP) will execute any\n * registered actions based on the decision.\n */\nexport interface IPolicyExecutionPointComponent extends IComponent {\n\t/**\n\t * Execute actions based on the PDP's decisions.\n\t * @param policy The policy that applied to the data.\n\t * @param decisions The decisions made by the PDP.\n\t * @param data The data used in the decision by the PDP.\n\t * @param action The action that was evaluated.\n\t * @param stage The stage at which the PXP is executed in the PDP.\n\t * @returns A promise that resolves when all registered actions have been executed.\n\t */\n\texecuteActions<D = unknown>(\n\t\tpolicy: IRightsManagementPolicy,\n\t\tdecisions: IPolicyDecision[],\n\t\tdata: D | undefined,\n\t\taction: OdrlActionType | string | undefined,\n\t\tstage: PolicyDecisionStage\n\t): Promise<void>;\n}\n"]}

package/dist/es/utils/odrlPolicyHelper.js

@@ -1,120 +1,247 @@
-// Copyright 2025 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-import { Is } from "@twin.org/core";
+import { ArrayHelper, GeneralError, Guards, Is, ObjectHelper } from "@twin.org/core";
 /**
  * Helper methods for Odrl Policies.
  */
 export class OdrlPolicyHelper {
     /**
-     * Find the expiration date of the policy.
-     * @param policy The policy to check.
-     * @param assetType The type of the asset, if undefined will match any asset type.
-     * @param action The action to check, if undefined will match any action.
-     * @returns The expiration date of the policy, or undefined if not found.
+     * The class name of the Policy Administration Point Service.
      */
-    static findExpirationDate(policy, assetType, action) {
-        if (Is.arrayValue(policy.permission)) {
-            for (const permission of policy.permission) {
-                const matchesPermission = OdrlPolicyHelper.matchTargetAndAction(permission.target, permission.action, {
-                    assetType,
-                    action
-                });
-                if (matchesPermission && Is.arrayValue(permission.constraint)) {
-                    for (const constraint of permission.constraint) {
-                        if (constraint.leftOperand === "dateTime" &&
-                            constraint.operator === "lteq" &&
-                            Is.dateTimeString(constraint.rightOperand)) {
-                            return constraint.rightOperand;
+    static CLASS_NAME = "OdrlPolicyHelper";
+    /**
+     * Get the UID of an ODRL policy or related object if available.
+     * @param object The ODRL policy or related object to get the UID from.
+     * @returns The UID of the object if available, otherwise undefined.
+     */
+    static getUid(object) {
+        return ObjectHelper.extractProperty(object, ["@id", "id", "uid"], false);
+    }
+    /**
+     * Get the type of an ODRL policy or related object if available.
+     * @param object The ODRL policy or related object to get the type from.
+     * @returns The type of the object if available, otherwise undefined.
+     */
+    static getType(object) {
+        return ObjectHelper.extractProperty(object, ["@type", "type"], false);
+    }
+    /**
+     * Extract assignee identity from policy.
+     * @param policy The policy to extract the assignee from.
+     * @returns Assignee id.
+     * @throws GeneralError if assignee is missing or invalid.
+     */
+    static extractAssigneeIdentity(policy) {
+        if (Is.empty(policy.assignee)) {
+            throw new GeneralError(OdrlPolicyHelper.CLASS_NAME, "policyMissingAssignee", {
+                policyType: OdrlPolicyHelper.getType(policy) ?? "",
+                policyId: OdrlPolicyHelper.getUid(policy) ?? ""
+            });
+        }
+        const assignees = ArrayHelper.fromObjectOrArray(policy.assignee);
+        const assigneeIds = [];
+        for (const assignee of assignees) {
+            const assigneeId = Is.string(assignee) ? assignee : OdrlPolicyHelper.getUid(assignee);
+            Guards.stringValue(OdrlPolicyHelper.CLASS_NAME, "assigneeId", assigneeId);
+            assigneeIds.push(assigneeId);
+        }
+        return assigneeIds.length <= 1 ? assigneeIds[0] : assigneeIds;
+    }
+    /**
+     * Extract assigner identity from policy.
+     * @param policy The policy to extract the assigner from.
+     * @returns Assigner id.
+     * @throws GeneralError if assigner is missing or invalid.
+     */
+    static extractAssignerIdentity(policy) {
+        if (Is.empty(policy.assigner)) {
+            throw new GeneralError(OdrlPolicyHelper.CLASS_NAME, "policyMissingAssigner", {
+                policyType: OdrlPolicyHelper.getType(policy) ?? "",
+                policyId: OdrlPolicyHelper.getUid(policy) ?? ""
+            });
+        }
+        const assigners = ArrayHelper.fromObjectOrArray(policy.assigner);
+        const assignerIds = [];
+        for (const assigner of assigners) {
+            const assignerId = Is.string(assigner) ? assigner : OdrlPolicyHelper.getUid(assigner);
+            Guards.stringValue(OdrlPolicyHelper.CLASS_NAME, "assignerId", assignerId);
+            assignerIds.push(assignerId);
+        }
+        return assignerIds.length <= 1 ? assignerIds[0] : assignerIds;
+    }
+    /**
+     * Normalize party value(s) into identifier strings when possible.
+     * Handles single parties or arrays of parties by returning all discovered identifiers.
+     * @param party The party to normalize.
+     * @returns The party identifiers, or undefined when not available.
+     */
+    static getPartyIds(party) {
+        const ids = [];
+        if (Is.empty(party)) {
+            return ids;
+        }
+        if (Is.stringValue(party)) {
+            ids.push(party);
+            return ids;
+        }
+        if (Is.arrayValue(party)) {
+            for (const item of party) {
+                const childIds = OdrlPolicyHelper.getPartyIds(item);
+                if (!Is.empty(childIds)) {
+                    for (const childId of childIds) {
+                        if (!ids.includes(childId)) {
+                            ids.push(childId);
                         }
                     }
                 }
             }
+            return ids;
         }
+        if (Is.object(party)) {
+            const uid = OdrlPolicyHelper.getUid(party);
+            if (Is.stringValue(uid) && !ids.includes(uid)) {
+                ids.push(uid);
+            }
+        }
+        return ids;
     }
     /**
-     * Match the target to the requested asset type.
-     * @param target The target to match.
-     * @param matchAssetType The asset type to match.
-     * @param matchResourceId The resource id to match.
-     * @returns True if the target is empty, the target matches the requested asset, false otherwise.
+     * Get the dataset targets from policy.
+     * @param policy The policy to extract the dataset targets from.
+     * @returns Top-level targets (deduped).
      */
-    static matchAsset(target, matchAssetType, matchResourceId) {
-        if (Is.empty(target) || Is.empty(matchAssetType)) {
-            return true;
-        }
-        if (Is.arrayValue(target)) {
-            return target.some(t => OdrlPolicyHelper.matchAsset(t, matchAssetType));
+    static getDatasetTargets(policy) {
+        const targetIds = [];
+        const policyTargets = ArrayHelper.fromObjectOrArray(policy.target ?? []);
+        for (const target of policyTargets) {
+            OdrlPolicyHelper.collectTarget(target, targetIds);
         }
-        if (Is.stringValue(target)) {
-            return target === matchAssetType;
-        }
-        // TODO: This currently only handles the simple case of matching a single asset type.
-        // we need further processing if the target is more complex.
-        // we also need to support the resource id matching.
-        return false;
+        return Array.from(new Set(targetIds));
     }
     /**
-     * Match the action to the asset type.
-     * @param action The action to match.
-     * @param matchAction The action to match.
-     * @returns True if the action is empty, the action matches the asset type, false otherwise.
+     * Get targets from policy.
+     * Walks both the policy-level target field and the target field on every
+     * permission, prohibition, and obligation rule so that policies that store
+     * their target exclusively on a rule are correctly indexed for query().
+     * @param policy The policy to extract the targets from.
+     * @returns Targets.
      */
-    static matchAction(action, matchAction) {
-        if (Is.empty(action) || Is.empty(matchAction)) {
-            return true;
+    static getTargets(policy) {
+        const targetIds = OdrlPolicyHelper.getDatasetTargets(policy);
+        const rules = OdrlPolicyHelper.collectRules(policy);
+        for (const rule of rules) {
+            const ruleTargets = ArrayHelper.fromObjectOrArray(rule.target ?? []);
+            for (const target of ruleTargets) {
+                OdrlPolicyHelper.collectTarget(target, targetIds);
+            }
         }
-        if (Is.arrayValue(action)) {
-            return action.some(a => OdrlPolicyHelper.matchAction(a, matchAction));
+        return Array.from(new Set(targetIds));
+    }
+    /**
+     * Get actions from policy.
+     * Walks both the policy-level action field and the action field on every
+     * permission, prohibition, and obligation rule so that policies that store
+     * their action exclusively on a rule are correctly indexed for query().
+     * @param policy The policy to extract the actions from.
+     * @returns Actions.
+     */
+    static getActions(policy) {
+        const actions = [];
+        const policyActions = ArrayHelper.fromObjectOrArray(policy.action ?? []);
+        for (const action of policyActions) {
+            OdrlPolicyHelper.collectAction(action, actions);
         }
-        if (Is.stringValue(action)) {
-            return action === matchAction;
+        const rules = OdrlPolicyHelper.collectRules(policy);
+        for (const rule of rules) {
+            const ruleActions = ArrayHelper.fromObjectOrArray(rule.action ?? []);
+            for (const action of ruleActions) {
+                OdrlPolicyHelper.collectAction(action, actions);
+            }
         }
-        // TODO: This currently only handles the simple case of matching a single action type.
-        // we need further processing if the action is more complex.
-        return false;
+        return Array.from(new Set(actions));
     }
     /**
-     * Match the assignee.
-     * @param assignee The assignee to match.
-     * @param matchAssignee The assignee to match.
-     * @returns True if the assignee is empty, the assignee matches the asset type, false otherwise.
+     * Does the policy match.
+     * @param policy The policy to try and match.
+     * @param options The matching options.
+     * @param options.assignee The assignee to match.
+     * @param options.assigner The assigner to match.
+     * @param options.target The target to match.
+     * @param options.action The action to match.
+     * @returns True if the policy matches.
      */
-    static matchAssignee(assignee, matchAssignee) {
-        if (Is.empty(assignee) || Is.empty(matchAssignee)) {
-            return true;
+    static matchPolicy(policy, options) {
+        if (Is.empty(policy)) {
+            return false;
+        }
+        if (Is.stringValue(options.assignee)) {
+            const assigneeIds = OdrlPolicyHelper.getPartyIds(policy.assignee);
+            if (!assigneeIds.includes(options.assignee)) {
+                return false;
+            }
+        }
+        if (Is.stringValue(options.assigner)) {
+            const assignerIds = OdrlPolicyHelper.getPartyIds(policy.assigner);
+            if (!assignerIds.includes(options.assigner)) {
+                return false;
+            }
+        }
+        if (Is.stringValue(options.target)) {
+            const targets = OdrlPolicyHelper.getTargets(policy);
+            if (!targets.includes(options.target)) {
+                return false;
+            }
         }
-        if (Is.stringValue(assignee)) {
-            return assignee === matchAssignee;
+        if (Is.stringValue(options.action)) {
+            const actions = OdrlPolicyHelper.getActions(policy);
+            if (!actions.includes(options.action)) {
+                return false;
+            }
         }
-        // TODO: This currently only handles the simple case of matching a single assignee.
-        // we need further processing if the assignee is more complex.
-        return false;
+        return true;
     }
     /**
-     * Match the target and action to the requested asset type and action.
-     * @param target The target to match.
-     * @param action The action to match.
-     * @param locator The locator to match resource id if provided.
-     * @returns True if the target and action match the requested asset type and action, false otherwise.
+     * Collect all rule objects (permission, prohibition, obligation) from a policy.
+     * @param policy The policy to collect rules from.
+     * @returns Flattened array of all rules.
+     * @internal
      */
-    static matchTargetAndAction(target, action, locator) {
-        const assetTypeMatch = OdrlPolicyHelper.matchAsset(target, locator?.assetType, locator?.resourceId);
-        const actionMatch = OdrlPolicyHelper.matchAction(action, locator?.action);
-        return assetTypeMatch && actionMatch;
+    static collectRules(policy) {
+        const rules = [];
+        rules.push(...ArrayHelper.fromObjectOrArray(policy.permission ?? []), ...ArrayHelper.fromObjectOrArray(policy.prohibition ?? []), ...ArrayHelper.fromObjectOrArray(policy.obligation ?? []));
+        return rules;
     }
     /**
-     * Match the complete locator.
-     * @param assignee The assignee to match.
-     * @param target The target to match.
-     * @param action The action to match.
-     * @param locator The locator to match resource id if provided.
-     * @returns True if the complete locator matches, false otherwise.
+     * Extract a target string from a target value and push it to the accumulator.
+     * @param target The target value to extract from.
+     * @param accumulator The array to push the target string into.
+     * @internal
      */
-    static matchLocator(assignee, target, action, locator) {
-        const assetTypeMatch = OdrlPolicyHelper.matchAsset(target, locator?.assetType, locator?.resourceId);
-        const assigneeMatch = OdrlPolicyHelper.matchAssignee(assignee, locator?.assignee);
-        const actionMatch = OdrlPolicyHelper.matchAction(action, locator?.action);
-        return assetTypeMatch && assigneeMatch && actionMatch;
+    static collectTarget(target, accumulator) {
+        if (Is.object(target)) {
+            const uid = OdrlPolicyHelper.getUid(target);
+            if (Is.stringValue(uid)) {
+                accumulator.push(uid);
+            }
+        }
+        else if (Is.stringValue(target)) {
+            accumulator.push(target);
+        }
+    }
+    /**
+     * Extract an action string from an action value and push it to the accumulator.
+     * @param action The action value to extract from.
+     * @param accumulator The array to push the action string into.
+     * @internal
+     */
+    static collectAction(action, accumulator) {
+        if (Is.object(action)) {
+            const uid = OdrlPolicyHelper.getUid(action);
+            if (Is.stringValue(uid)) {
+                accumulator.push(uid);
+            }
+        }
+        else if (Is.stringValue(action)) {
+            accumulator.push(action);
+        }
     }
 }
 //# sourceMappingURL=odrlPolicyHelper.js.map

package/dist/es/utils/odrlPolicyHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"odrlPolicyHelper.js","sourceRoot":"","sources":["../../../src/utils/odrlPolicyHelper.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { Is } from \"@twin.org/core\";\nimport type { IOdrlPolicy } from \"@twin.org/standards-w3c-odrl\";\nimport type { IPolicyLocator } from \"../models/IPolicyLocator.js\";\n\n/**\n * Helper methods for Odrl Policies.\n */\nexport class OdrlPolicyHelper {\n\t/**\n\t * Find the expiration date of the policy.\n\t * @param policy The policy to check.\n\t * @param assetType The type of the asset, if undefined will match any asset type.\n\t * @param action The action to check, if undefined will match any action.\n\t * @returns The expiration date of the policy, or undefined if not found.\n\t */\n\tpublic static findExpirationDate(\n\t\tpolicy: IOdrlPolicy,\n\t\tassetType?: string,\n\t\taction?: string\n\t): string | undefined {\n\t\tif (Is.arrayValue(policy.permission)) {\n\t\t\tfor (const permission of policy.permission) {\n\t\t\t\tconst matchesPermission = OdrlPolicyHelper.matchTargetAndAction(\n\t\t\t\t\tpermission.target,\n\t\t\t\t\tpermission.action,\n\t\t\t\t\t{\n\t\t\t\t\t\tassetType,\n\t\t\t\t\t\taction\n\t\t\t\t\t}\n\t\t\t\t);\n\t\t\t\tif (matchesPermission && Is.arrayValue(permission.constraint)) {\n\t\t\t\t\tfor (const constraint of permission.constraint) {\n\t\t\t\t\t\tif (\n\t\t\t\t\t\t\tconstraint.leftOperand === \"dateTime\" &&\n\t\t\t\t\t\t\tconstraint.operator === \"lteq\" &&\n\t\t\t\t\t\t\tIs.dateTimeString(constraint.rightOperand)\n\t\t\t\t\t\t) {\n\t\t\t\t\t\t\treturn constraint.rightOperand as string;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Match the target to the requested asset type.\n\t * @param target The target to match.\n\t * @param matchAssetType The asset type to match.\n\t * @param matchResourceId The resource id to match.\n\t * @returns True if the target is empty, the target matches the requested asset, false otherwise.\n\t */\n\tpublic static matchAsset(\n\t\ttarget?: IOdrlPolicy[\"target\"],\n\t\tmatchAssetType?: string,\n\t\tmatchResourceId?: string\n\t): boolean {\n\t\tif (Is.empty(target) || Is.empty(matchAssetType)) {\n\t\t\treturn true;\n\t\t}\n\n\t\tif (Is.arrayValue(target)) {\n\t\t\treturn target.some(t => OdrlPolicyHelper.matchAsset(t, matchAssetType));\n\t\t}\n\n\t\tif (Is.stringValue(target)) {\n\t\t\treturn target === matchAssetType;\n\t\t}\n\n\t\t// TODO: This currently only handles the simple case of matching a single asset type.\n\t\t// we need further processing if the target is more complex.\n\t\t// we also need to support the resource id matching.\n\t\treturn false;\n\t}\n\n\t/**\n\t * Match the action to the asset type.\n\t * @param action The action to match.\n\t * @param matchAction The action to match.\n\t * @returns True if the action is empty, the action matches the asset type, false otherwise.\n\t */\n\tpublic static matchAction(action?: IOdrlPolicy[\"action\"], matchAction?: string): boolean {\n\t\tif (Is.empty(action) || Is.empty(matchAction)) {\n\t\t\treturn true;\n\t\t}\n\n\t\tif (Is.arrayValue(action)) {\n\t\t\treturn action.some(a => OdrlPolicyHelper.matchAction(a, matchAction));\n\t\t}\n\n\t\tif (Is.stringValue(action)) {\n\t\t\treturn action === matchAction;\n\t\t}\n\n\t\t// TODO: This currently only handles the simple case of matching a single action type.\n\t\t// we need further processing if the action is more complex.\n\t\treturn false;\n\t}\n\n\t/**\n\t * Match the assignee.\n\t * @param assignee The assignee to match.\n\t * @param matchAssignee The assignee to match.\n\t * @returns True if the assignee is empty, the assignee matches the asset type, false otherwise.\n\t */\n\tpublic static matchAssignee(assignee?: IOdrlPolicy[\"assignee\"], matchAssignee?: string): boolean {\n\t\tif (Is.empty(assignee) || Is.empty(matchAssignee)) {\n\t\t\treturn true;\n\t\t}\n\n\t\tif (Is.stringValue(assignee)) {\n\t\t\treturn assignee === matchAssignee;\n\t\t}\n\n\t\t// TODO: This currently only handles the simple case of matching a single assignee.\n\t\t// we need further processing if the assignee is more complex.\n\t\treturn false;\n\t}\n\n\t/**\n\t * Match the target and action to the requested asset type and action.\n\t * @param target The target to match.\n\t * @param action The action to match.\n\t * @param locator The locator to match resource id if provided.\n\t * @returns True if the target and action match the requested asset type and action, false otherwise.\n\t */\n\tpublic static matchTargetAndAction(\n\t\ttarget?: IOdrlPolicy[\"target\"],\n\t\taction?: IOdrlPolicy[\"action\"],\n\t\tlocator?: Omit<IPolicyLocator, \"assignee\">\n\t): boolean {\n\t\tconst assetTypeMatch = OdrlPolicyHelper.matchAsset(\n\t\t\ttarget,\n\t\t\tlocator?.assetType,\n\t\t\tlocator?.resourceId\n\t\t);\n\t\tconst actionMatch = OdrlPolicyHelper.matchAction(action, locator?.action);\n\t\treturn assetTypeMatch && actionMatch;\n\t}\n\n\t/**\n\t * Match the complete locator.\n\t * @param assignee The assignee to match.\n\t * @param target The target to match.\n\t * @param action The action to match.\n\t * @param locator The locator to match resource id if provided.\n\t * @returns True if the complete locator matches, false otherwise.\n\t */\n\tpublic static matchLocator(\n\t\tassignee?: IOdrlPolicy[\"assignee\"],\n\t\ttarget?: IOdrlPolicy[\"target\"],\n\t\taction?: IOdrlPolicy[\"action\"],\n\t\tlocator?: IPolicyLocator\n\t): boolean {\n\t\tconst assetTypeMatch = OdrlPolicyHelper.matchAsset(\n\t\t\ttarget,\n\t\t\tlocator?.assetType,\n\t\t\tlocator?.resourceId\n\t\t);\n\t\tconst assigneeMatch = OdrlPolicyHelper.matchAssignee(assignee, locator?.assignee);\n\t\tconst actionMatch = OdrlPolicyHelper.matchAction(action, locator?.action);\n\t\treturn assetTypeMatch && assigneeMatch && actionMatch;\n\t}\n}\n"]}
+{"version":3,"file":"odrlPolicyHelper.js","sourceRoot":"","sources":["../../../src/utils/odrlPolicyHelper.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { ObjectOrArray } from \"@twin.org/core\";\nimport { ArrayHelper, GeneralError, Guards, Is, ObjectHelper } from \"@twin.org/core\";\nimport { nameof } from \"@twin.org/nameof\";\nimport type { IDataspaceProtocolPolicy } from \"@twin.org/standards-dataspace-protocol\";\nimport type {\n\tIOdrlAction,\n\tIOdrlAsset,\n\tIOdrlAssetCollection,\n\tIOdrlDuty,\n\tIOdrlParty,\n\tIOdrlPartyCollection,\n\tIOdrlPermission,\n\tIOdrlProhibition,\n\tIOdrlRule,\n\tOdrlActionType\n} from \"@twin.org/standards-w3c-odrl\";\nimport type { IRightsManagementPolicy } from \"../models/IRightsManagementPolicy.js\";\n\n/**\n * Helper methods for Odrl Policies.\n */\nexport class OdrlPolicyHelper {\n\t/**\n\t * The class name of the Policy Administration Point Service.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<OdrlPolicyHelper>();\n\n\t/**\n\t * Get the UID of an ODRL policy or related object if available.\n\t * @param object The ODRL policy or related object to get the UID from.\n\t * @returns The UID of the object if available, otherwise undefined.\n\t */\n\tpublic static getUid(object: object | undefined): string | undefined {\n\t\treturn ObjectHelper.extractProperty<string>(object, [\"@id\", \"id\", \"uid\"], false);\n\t}\n\n\t/**\n\t * Get the type of an ODRL policy or related object if available.\n\t * @param object The ODRL policy or related object to get the type from.\n\t * @returns The type of the object if available, otherwise undefined.\n\t */\n\tpublic static getType(object: object | undefined): string | undefined {\n\t\treturn ObjectHelper.extractProperty<string>(object, [\"@type\", \"type\"], false);\n\t}\n\n\t/**\n\t * Extract assignee identity from policy.\n\t * @param policy The policy to extract the assignee from.\n\t * @returns Assignee id.\n\t * @throws GeneralError if assignee is missing or invalid.\n\t */\n\tpublic static extractAssigneeIdentity(policy: IDataspaceProtocolPolicy): ObjectOrArray<string> {\n\t\tif (Is.empty(policy.assignee)) {\n\t\t\tthrow new GeneralError(OdrlPolicyHelper.CLASS_NAME, \"policyMissingAssignee\", {\n\t\t\t\tpolicyType: OdrlPolicyHelper.getType(policy) ?? \"\",\n\t\t\t\tpolicyId: OdrlPolicyHelper.getUid(policy) ?? \"\"\n\t\t\t});\n\t\t}\n\n\t\tconst assignees = ArrayHelper.fromObjectOrArray(policy.assignee);\n\t\tconst assigneeIds: string[] = [];\n\t\tfor (const assignee of assignees) {\n\t\t\tconst assigneeId = Is.string(assignee) ? assignee : OdrlPolicyHelper.getUid(assignee);\n\t\t\tGuards.stringValue(OdrlPolicyHelper.CLASS_NAME, nameof(assigneeId), assigneeId);\n\t\t\tassigneeIds.push(assigneeId);\n\t\t}\n\n\t\treturn assigneeIds.length <= 1 ? assigneeIds[0] : assigneeIds;\n\t}\n\n\t/**\n\t * Extract assigner identity from policy.\n\t * @param policy The policy to extract the assigner from.\n\t * @returns Assigner id.\n\t * @throws GeneralError if assigner is missing or invalid.\n\t */\n\tpublic static extractAssignerIdentity(policy: IDataspaceProtocolPolicy): ObjectOrArray<string> {\n\t\tif (Is.empty(policy.assigner)) {\n\t\t\tthrow new GeneralError(OdrlPolicyHelper.CLASS_NAME, \"policyMissingAssigner\", {\n\t\t\t\tpolicyType: OdrlPolicyHelper.getType(policy) ?? \"\",\n\t\t\t\tpolicyId: OdrlPolicyHelper.getUid(policy) ?? \"\"\n\t\t\t});\n\t\t}\n\n\t\tconst assigners = ArrayHelper.fromObjectOrArray(policy.assigner);\n\t\tconst assignerIds: string[] = [];\n\n\t\tfor (const assigner of assigners) {\n\t\t\tconst assignerId = Is.string(assigner) ? assigner : OdrlPolicyHelper.getUid(assigner);\n\t\t\tGuards.stringValue(OdrlPolicyHelper.CLASS_NAME, nameof(assignerId), assignerId);\n\t\t\tassignerIds.push(assignerId);\n\t\t}\n\n\t\treturn assignerIds.length <= 1 ? assignerIds[0] : assignerIds;\n\t}\n\n\t/**\n\t * Normalize party value(s) into identifier strings when possible.\n\t * Handles single parties or arrays of parties by returning all discovered identifiers.\n\t * @param party The party to normalize.\n\t * @returns The party identifiers, or undefined when not available.\n\t */\n\tpublic static getPartyIds(\n\t\tparty?:\n\t\t\t| string\n\t\t\t| IOdrlParty\n\t\t\t| IOdrlPartyCollection\n\t\t\t| (string | IOdrlParty | IOdrlPartyCollection)[]\n\t): string[] {\n\t\tconst ids: string[] = [];\n\n\t\tif (Is.empty(party)) {\n\t\t\treturn ids;\n\t\t}\n\n\t\tif (Is.stringValue(party)) {\n\t\t\tids.push(party);\n\t\t\treturn ids;\n\t\t}\n\n\t\tif (Is.arrayValue(party)) {\n\t\t\tfor (const item of party) {\n\t\t\t\tconst childIds = OdrlPolicyHelper.getPartyIds(item);\n\t\t\t\tif (!Is.empty(childIds)) {\n\t\t\t\t\tfor (const childId of childIds) {\n\t\t\t\t\t\tif (!ids.includes(childId)) {\n\t\t\t\t\t\t\tids.push(childId);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn ids;\n\t\t}\n\n\t\tif (Is.object<IOdrlParty>(party)) {\n\t\t\tconst uid = OdrlPolicyHelper.getUid(party);\n\t\t\tif (Is.stringValue(uid) && !ids.includes(uid)) {\n\t\t\t\tids.push(uid);\n\t\t\t}\n\t\t}\n\n\t\treturn ids;\n\t}\n\n\t/**\n\t * Get the dataset targets from policy.\n\t * @param policy The policy to extract the dataset targets from.\n\t * @returns Top-level targets (deduped).\n\t */\n\tpublic static getDatasetTargets(policy: IRightsManagementPolicy): string[] {\n\t\tconst targetIds: string[] = [];\n\n\t\tconst policyTargets = ArrayHelper.fromObjectOrArray<IOdrlAsset | IOdrlAssetCollection | string>(\n\t\t\tpolicy.target ?? []\n\t\t);\n\t\tfor (const target of policyTargets) {\n\t\t\tOdrlPolicyHelper.collectTarget(target, targetIds);\n\t\t}\n\n\t\treturn Array.from(new Set(targetIds));\n\t}\n\n\t/**\n\t * Get targets from policy.\n\t * Walks both the policy-level target field and the target field on every\n\t * permission, prohibition, and obligation rule so that policies that store\n\t * their target exclusively on a rule are correctly indexed for query().\n\t * @param policy The policy to extract the targets from.\n\t * @returns Targets.\n\t */\n\tpublic static getTargets(policy: IRightsManagementPolicy): string[] {\n\t\tconst targetIds: string[] = OdrlPolicyHelper.getDatasetTargets(policy);\n\n\t\tconst rules = OdrlPolicyHelper.collectRules(policy);\n\t\tfor (const rule of rules) {\n\t\t\tconst ruleTargets = ArrayHelper.fromObjectOrArray<IOdrlAsset | IOdrlAssetCollection | string>(\n\t\t\t\trule.target ?? []\n\t\t\t);\n\t\t\tfor (const target of ruleTargets) {\n\t\t\t\tOdrlPolicyHelper.collectTarget(target, targetIds);\n\t\t\t}\n\t\t}\n\n\t\treturn Array.from(new Set(targetIds));\n\t}\n\n\t/**\n\t * Get actions from policy.\n\t * Walks both the policy-level action field and the action field on every\n\t * permission, prohibition, and obligation rule so that policies that store\n\t * their action exclusively on a rule are correctly indexed for query().\n\t * @param policy The policy to extract the actions from.\n\t * @returns Actions.\n\t */\n\tpublic static getActions(policy: IRightsManagementPolicy): string[] {\n\t\tconst actions: string[] = [];\n\n\t\tconst policyActions = ArrayHelper.fromObjectOrArray<OdrlActionType | string | IOdrlAction>(\n\t\t\tpolicy.action ?? []\n\t\t);\n\t\tfor (const action of policyActions) {\n\t\t\tOdrlPolicyHelper.collectAction(action, actions);\n\t\t}\n\n\t\tconst rules = OdrlPolicyHelper.collectRules(policy);\n\t\tfor (const rule of rules) {\n\t\t\tconst ruleActions = ArrayHelper.fromObjectOrArray<OdrlActionType | string | IOdrlAction>(\n\t\t\t\trule.action ?? []\n\t\t\t);\n\t\t\tfor (const action of ruleActions) {\n\t\t\t\tOdrlPolicyHelper.collectAction(action, actions);\n\t\t\t}\n\t\t}\n\n\t\treturn Array.from(new Set(actions));\n\t}\n\n\t/**\n\t * Does the policy match.\n\t * @param policy The policy to try and match.\n\t * @param options The matching options.\n\t * @param options.assignee The assignee to match.\n\t * @param options.assigner The assigner to match.\n\t * @param options.target The target to match.\n\t * @param options.action The action to match.\n\t * @returns True if the policy matches.\n\t */\n\tpublic static matchPolicy(\n\t\tpolicy: IRightsManagementPolicy | undefined,\n\t\toptions: {\n\t\t\tassignee?: string;\n\t\t\tassigner?: string;\n\t\t\ttarget?: string;\n\t\t\taction?: string;\n\t\t}\n\t): boolean {\n\t\tif (Is.empty(policy)) {\n\t\t\treturn false;\n\t\t}\n\n\t\tif (Is.stringValue(options.assignee)) {\n\t\t\tconst assigneeIds = OdrlPolicyHelper.getPartyIds(policy.assignee);\n\t\t\tif (!assigneeIds.includes(options.assignee)) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\n\t\tif (Is.stringValue(options.assigner)) {\n\t\t\tconst assignerIds = OdrlPolicyHelper.getPartyIds(policy.assigner);\n\t\t\tif (!assignerIds.includes(options.assigner)) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\n\t\tif (Is.stringValue(options.target)) {\n\t\t\tconst targets = OdrlPolicyHelper.getTargets(policy);\n\t\t\tif (!targets.includes(options.target)) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\n\t\tif (Is.stringValue(options.action)) {\n\t\t\tconst actions = OdrlPolicyHelper.getActions(policy);\n\t\t\tif (!actions.includes(options.action)) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\n\t\treturn true;\n\t}\n\n\t/**\n\t * Collect all rule objects (permission, prohibition, obligation) from a policy.\n\t * @param policy The policy to collect rules from.\n\t * @returns Flattened array of all rules.\n\t * @internal\n\t */\n\tprivate static collectRules(policy: IRightsManagementPolicy): IOdrlRule[] {\n\t\tconst rules: IOdrlRule[] = [];\n\t\trules.push(\n\t\t\t...ArrayHelper.fromObjectOrArray<IOdrlPermission>(policy.permission ?? []),\n\t\t\t...ArrayHelper.fromObjectOrArray<IOdrlProhibition>(policy.prohibition ?? []),\n\t\t\t...ArrayHelper.fromObjectOrArray<IOdrlDuty>(policy.obligation ?? [])\n\t\t);\n\t\treturn rules;\n\t}\n\n\t/**\n\t * Extract a target string from a target value and push it to the accumulator.\n\t * @param target The target value to extract from.\n\t * @param accumulator The array to push the target string into.\n\t * @internal\n\t */\n\tprivate static collectTarget(\n\t\ttarget: IOdrlAsset | IOdrlAssetCollection | string,\n\t\taccumulator: string[]\n\t): void {\n\t\tif (Is.object<IOdrlAsset>(target)) {\n\t\t\tconst uid = OdrlPolicyHelper.getUid(target);\n\t\t\tif (Is.stringValue(uid)) {\n\t\t\t\taccumulator.push(uid);\n\t\t\t}\n\t\t} else if (Is.stringValue(target)) {\n\t\t\taccumulator.push(target);\n\t\t}\n\t}\n\n\t/**\n\t * Extract an action string from an action value and push it to the accumulator.\n\t * @param action The action value to extract from.\n\t * @param accumulator The array to push the action string into.\n\t * @internal\n\t */\n\tprivate static collectAction(\n\t\taction: OdrlActionType | string | IOdrlAction,\n\t\taccumulator: string[]\n\t): void {\n\t\tif (Is.object<IOdrlAction>(action)) {\n\t\t\tconst uid = OdrlPolicyHelper.getUid(action);\n\t\t\tif (Is.stringValue(uid)) {\n\t\t\t\taccumulator.push(uid);\n\t\t\t}\n\t\t} else if (Is.stringValue(action)) {\n\t\t\taccumulator.push(action);\n\t\t}\n\t}\n}\n"]}

package/dist/types/factories/policyObligationEnforcerFactory.d.ts

@@ -0,0 +1,6 @@
+import { Factory } from "@twin.org/core";
+import type { IPolicyObligationEnforcer } from "../models/pdp/IPolicyObligationEnforcer.js";
+/**
+ * Factory for managing policy obligation enforcer registration and retrieval.
+ */
+export declare const PolicyObligationEnforcerFactory: Factory<IPolicyObligationEnforcer>;

package/dist/types/index.d.ts

@@ -1,24 +1,24 @@
-export * from "./factories/dataAccessHandlerFactory.js";
 export * from "./factories/policyArbiterFactory.js";
 export * from "./factories/policyEnforcementProcessorFactory.js";
 export * from "./factories/policyExecutionActionFactory.js";
 export * from "./factories/policyInformationSourceFactory.js";
 export * from "./factories/policyNegotiatorFactory.js";
+export * from "./factories/policyObligationEnforcerFactory.js";
 export * from "./factories/policyRequesterFactory.js";
-export * from "./models/api/dap/IDapCreateRequest.js";
-export * from "./models/api/dap/IDapGetRequest.js";
-export * from "./models/api/dap/IDapGetResponse.js";
-export * from "./models/api/dap/IDapQueryRequest.js";
-export * from "./models/api/dap/IDapQueryResponse.js";
-export * from "./models/api/dap/IDapRemoveRequest.js";
-export * from "./models/api/dap/IDapUpdateRequest.js";
 export * from "./models/api/pap/IPapCreateRequest.js";
+export * from "./models/api/pap/IPapGetAgreementRequest.js";
+export * from "./models/api/pap/IPapGetAgreementResponse.js";
+export * from "./models/api/pap/IPapGetOfferRequest.js";
+export * from "./models/api/pap/IPapGetOfferResponse.js";
 export * from "./models/api/pap/IPapGetRequest.js";
 export * from "./models/api/pap/IPapGetResponse.js";
+export * from "./models/api/pap/IPapGetSetRequest.js";
+export * from "./models/api/pap/IPapGetSetResponse.js";
 export * from "./models/api/pap/IPapQueryRequest.js";
 export * from "./models/api/pap/IPapQueryResponse.js";
 export * from "./models/api/pap/IPapRemoveRequest.js";
 export * from "./models/api/pap/IPapUpdateRequest.js";
+export * from "./models/api/pnap/IPnapCreateRequest.js";
 export * from "./models/api/pnap/IPnapGetRequest.js";
 export * from "./models/api/pnap/IPnapGetResponse.js";
 export * from "./models/api/pnap/IPnapQueryRequest.js";
@@ -34,24 +34,24 @@ export * from "./models/api/pnp/IPnpNegotiateRequest.js";
 export * from "./models/api/pnp/IPnpNegotiationGetRequest.js";
 export * from "./models/api/pnp/IPnpOfferRequest.js";
 export * from "./models/api/pnp/IPnpTerminateRequest.js";
-export * from "./models/dap/IDataAccessHandler.js";
-export * from "./models/dap/IDataAccessPointComponent.js";
-export * from "./models/dap/IDataAccessRequestPointComponent.js";
-export * from "./models/dap/jsonLd/IDataAccessQuery.js";
-export * from "./models/dap/jsonLd/IDataAccessQueryResponse.js";
-export * from "./models/dap/jsonLd/IDataAccessRequest.js";
-export * from "./models/dap/jsonLd/IDataAccessRequestWithObject.js";
-export * from "./models/IPolicyLocator.js";
+export * from "./models/IRightsManagementAgreement.js";
+export * from "./models/IRightsManagementInformation.js";
+export * from "./models/IRightsManagementOffer.js";
+export * from "./models/IRightsManagementPolicy.js";
+export * from "./models/IRightsManagementPolicyMetadata.js";
+export * from "./models/IRightsManagementPolicyTrust.js";
+export * from "./models/IRightsManagementSet.js";
+export * from "./models/odrlProfiles.js";
 export * from "./models/pap/IPolicyAdministrationPointComponent.js";
+export * from "./models/pap/IPolicyLocator.js";
 export * from "./models/pdp/IPolicyArbiter.js";
 export * from "./models/pdp/IPolicyDecision.js";
 export * from "./models/pdp/IPolicyDecisionPointComponent.js";
+export * from "./models/pdp/IPolicyObligationEnforcer.js";
 export * from "./models/pdp/policyDecision.js";
 export * from "./models/pdp/policyDecisionStage.js";
 export * from "./models/pep/IPolicyEnforcementPointComponent.js";
 export * from "./models/pep/IPolicyEnforcementProcessor.js";
-export * from "./models/pip/IPolicyInformation.js";
-export * from "./models/pip/IPolicyInformationItems.js";
 export * from "./models/pip/IPolicyInformationPointComponent.js";
 export * from "./models/pip/IPolicyInformationSource.js";
 export * from "./models/pip/policyInformationAccessMode.js";
@@ -61,10 +61,10 @@ export * from "./models/pnp/IPolicyNegotiationAdminPointComponent.js";
 export * from "./models/pnp/IPolicyNegotiationPointComponent.js";
 export * from "./models/pnp/IPolicyNegotiator.js";
 export * from "./models/pnp/IPolicyRequester.js";
+export * from "./models/policyMetadataContext.js";
 export * from "./models/pxp/IPolicyExecutionAction.js";
 export * from "./models/pxp/IPolicyExecutionPointComponent.js";
 export * from "./models/rightsManagementContexts.js";
 export * from "./models/rightsManagementNamespaces.js";
 export * from "./models/rightsManagementTypes.js";
-export * from "./utils/locatorHelper.js";
 export * from "./utils/odrlPolicyHelper.js";

package/dist/types/models/IRightsManagementAgreement.d.ts

@@ -0,0 +1,8 @@
+import type { IDataspaceProtocolAgreement } from "@twin.org/standards-dataspace-protocol";
+import type { IRightsManagementPolicyMetadata } from "./IRightsManagementPolicyMetadata.js";
+import type { IRightsManagementPolicyTrust } from "./IRightsManagementPolicyTrust.js";
+/**
+ * Agreement policy returned by PAP, including optional PAP-managed lifecycle metadata.
+ */
+export interface IRightsManagementAgreement extends IDataspaceProtocolAgreement, IRightsManagementPolicyMetadata, IRightsManagementPolicyTrust {
+}