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

package/dist/es/policyInformationSources/staticPolicyInformationSource.js

@@ -1,7 +1,7 @@
 // Copyright 2025 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 import { ComponentFactory, Guards, Is } from "@twin.org/core";
-import { LocatorHelper, PolicyInformationAccessMode } from "@twin.org/rights-management-models";
+import { OdrlPolicyHelper, PolicyInformationAccessMode } from "@twin.org/rights-management-models";
 /**
  * Policy information source which retrieves static information.
  */
@@ -25,7 +25,7 @@ export class StaticPolicyInformationSource {
      * @param options The options for the logging policy source.
      */
     constructor(options) {
-        this._logging = ComponentFactory.getIfExists(options?.loggingComponentType ?? "logging");
+        this._logging = ComponentFactory.getIfExists(options?.loggingComponentType);
         this._information = options?.config?.information ?? [];
     }
     /**
@@ -37,24 +37,22 @@ export class StaticPolicyInformationSource {
     }
     /**
      * Retrieve information from the sources.
-     * @param locator The locator to find relevant policies.
+     * @param policy The policy to retrieve information for if available.
      * @param accessMode The access mode to use for the retrieval.
-     * @param policies The policies that apply to the data.
      * @param data The data to process.
+     * @param action The action to get any additional information for.
      * @returns The objects containing relevant information or undefined if nothing relevant is found.
      */
-    async retrieve(locator, accessMode, policies, data) {
-        Guards.objectValue(StaticPolicyInformationSource.CLASS_NAME, "locator", locator);
+    async retrieve(policy, accessMode, data, action) {
         Guards.arrayOneOf(StaticPolicyInformationSource.CLASS_NAME, "accessMode", accessMode, Object.values(PolicyInformationAccessMode));
-        Guards.stringValue(StaticPolicyInformationSource.CLASS_NAME, "locator.assignee", locator.assignee);
-        const information = [];
+        let information = {};
         await this._logging?.log({
             level: "info",
             source: StaticPolicyInformationSource.CLASS_NAME,
             ts: Date.now(),
             message: "staticRetrieving",
             data: {
-                locator: LocatorHelper.toString(locator),
+                policyId: OdrlPolicyHelper.getUid(policy) ?? "",
                 accessMode
             }
         });
@@ -62,9 +60,13 @@ export class StaticPolicyInformationSource {
             if (info.accessMode === accessMode ||
                 accessMode === PolicyInformationAccessMode.Any ||
                 info.accessMode === PolicyInformationAccessMode.Any) {
-                if (!Is.arrayValue(info.matchLocators) ||
-                    !Is.empty(LocatorHelper.findMatchingLocator(info.matchLocators, locator))) {
-                    information.push(...info.objects);
+                const matchLocators = info.matchLocators;
+                if (!Is.arrayValue(matchLocators) ||
+                    matchLocators.some(locator => OdrlPolicyHelper.matchPolicy(policy, locator))) {
+                    information = {
+                        ...information,
+                        ...info.objects
+                    };
                 }
             }
         }
@@ -74,12 +76,12 @@ export class StaticPolicyInformationSource {
             ts: Date.now(),
             message: "staticRetrieved",
             data: {
-                locator: LocatorHelper.toString(locator),
+                policyId: OdrlPolicyHelper.getUid(policy) ?? "",
                 accessMode,
-                itemCount: information.length
+                itemCount: Object.keys(information).length
             }
         });
-        return information.length > 0 ? information : undefined;
+        return Object.keys(information).length > 0 ? information : undefined;
     }
     /**
      * Add static policy information.
@@ -87,7 +89,7 @@ export class StaticPolicyInformationSource {
      */
     addInformation(info) {
         Guards.arrayOneOf(StaticPolicyInformationSource.CLASS_NAME, "info.accessMode", info.accessMode, Object.values(PolicyInformationAccessMode));
-        Guards.arrayValue(StaticPolicyInformationSource.CLASS_NAME, "info.objects", info.objects);
+        Guards.objectValue(StaticPolicyInformationSource.CLASS_NAME, "info.objects", info.objects);
         this._information.push(info);
     }
 }

package/dist/es/policyInformationSources/staticPolicyInformationSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"staticPolicyInformationSource.js","sourceRoot":"","sources":["../../../src/policyInformationSources/staticPolicyInformationSource.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { ComponentFactory, Guards, Is } from \"@twin.org/core\";\nimport type { IJsonLdNodeObject } from \"@twin.org/data-json-ld\";\nimport type { ILoggingComponent } from \"@twin.org/logging-models\";\nimport { nameof } from \"@twin.org/nameof\";\nimport {\n\tLocatorHelper,\n\tPolicyInformationAccessMode,\n\ttype IPolicyInformationSource,\n\ttype IPolicyLocator\n} from \"@twin.org/rights-management-models\";\nimport type { IOdrlPolicy } from \"@twin.org/standards-w3c-odrl\";\nimport type { IStaticPolicyInformationSource } from \"../models/IStaticPolicyInformationSource.js\";\nimport type { IStaticPolicyInformationSourceConstructorOptions } from \"../models/IStaticPolicyInformationSourceConstructorOptions.js\";\n\n/**\n * Policy information source which retrieves static information.\n */\nexport class StaticPolicyInformationSource implements IPolicyInformationSource {\n\t/**\n\t * The class name of the Static Policy Information Source.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<StaticPolicyInformationSource>();\n\n\t/**\n\t * The logging component.\n\t * @internal\n\t */\n\tprivate readonly _logging?: ILoggingComponent;\n\n\t/**\n\t * The information sources.\n\t * @internal\n\t */\n\tprivate readonly _information: IStaticPolicyInformationSource[];\n\n\t/**\n\t * Create a new instance of StaticPolicyInformationSource.\n\t * @param options The options for the logging policy source.\n\t */\n\tconstructor(options?: IStaticPolicyInformationSourceConstructorOptions) {\n\t\tthis._logging = ComponentFactory.getIfExists<ILoggingComponent>(\n\t\t\toptions?.loggingComponentType ?? \"logging\"\n\t\t);\n\t\tthis._information = options?.config?.information ?? [];\n\t}\n\n\t/**\n\t * Returns the class name of the component.\n\t * @returns The class name of the component.\n\t */\n\tpublic className(): string {\n\t\treturn StaticPolicyInformationSource.CLASS_NAME;\n\t}\n\n\t/**\n\t * Retrieve information from the sources.\n\t * @param locator The locator to find relevant policies.\n\t * @param accessMode The access mode to use for the retrieval.\n\t * @param policies The policies that apply to the data.\n\t * @param data The data to process.\n\t * @returns The objects containing relevant information or undefined if nothing relevant is found.\n\t */\n\tpublic async retrieve<D = unknown>(\n\t\tlocator: IPolicyLocator,\n\t\taccessMode: PolicyInformationAccessMode,\n\t\tpolicies: IOdrlPolicy[],\n\t\tdata?: D\n\t): Promise<IJsonLdNodeObject[] | undefined> {\n\t\tGuards.objectValue<IPolicyLocator>(\n\t\t\tStaticPolicyInformationSource.CLASS_NAME,\n\t\t\tnameof(locator),\n\t\t\tlocator\n\t\t);\n\t\tGuards.arrayOneOf(\n\t\t\tStaticPolicyInformationSource.CLASS_NAME,\n\t\t\tnameof(accessMode),\n\t\t\taccessMode,\n\t\t\tObject.values(PolicyInformationAccessMode)\n\t\t);\n\t\tGuards.stringValue(\n\t\t\tStaticPolicyInformationSource.CLASS_NAME,\n\t\t\tnameof(locator.assignee),\n\t\t\tlocator.assignee\n\t\t);\n\n\t\tconst information: IJsonLdNodeObject[] = [];\n\n\t\tawait this._logging?.log({\n\t\t\tlevel: \"info\",\n\t\t\tsource: StaticPolicyInformationSource.CLASS_NAME,\n\t\t\tts: Date.now(),\n\t\t\tmessage: \"staticRetrieving\",\n\t\t\tdata: {\n\t\t\t\tlocator: LocatorHelper.toString(locator),\n\t\t\t\taccessMode\n\t\t\t}\n\t\t});\n\n\t\tfor (const info of this._information) {\n\t\t\tif (\n\t\t\t\tinfo.accessMode === accessMode ||\n\t\t\t\taccessMode === PolicyInformationAccessMode.Any ||\n\t\t\t\tinfo.accessMode === PolicyInformationAccessMode.Any\n\t\t\t) {\n\t\t\t\tif (\n\t\t\t\t\t!Is.arrayValue(info.matchLocators) ||\n\t\t\t\t\t!Is.empty(LocatorHelper.findMatchingLocator(info.matchLocators, locator))\n\t\t\t\t) {\n\t\t\t\t\tinformation.push(...info.objects);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tawait this._logging?.log({\n\t\t\tlevel: \"info\",\n\t\t\tsource: StaticPolicyInformationSource.CLASS_NAME,\n\t\t\tts: Date.now(),\n\t\t\tmessage: \"staticRetrieved\",\n\t\t\tdata: {\n\t\t\t\tlocator: LocatorHelper.toString(locator),\n\t\t\t\taccessMode,\n\t\t\t\titemCount: information.length\n\t\t\t}\n\t\t});\n\n\t\treturn information.length > 0 ? information : undefined;\n\t}\n\n\t/**\n\t * Add static policy information.\n\t * @param info The static policy information to add.\n\t */\n\tpublic addInformation(info: IStaticPolicyInformationSource): void {\n\t\tGuards.arrayOneOf<string>(\n\t\t\tStaticPolicyInformationSource.CLASS_NAME,\n\t\t\tnameof(info.accessMode),\n\t\t\tinfo.accessMode,\n\t\t\tObject.values(PolicyInformationAccessMode)\n\t\t);\n\t\tGuards.arrayValue<IJsonLdNodeObject>(\n\t\t\tStaticPolicyInformationSource.CLASS_NAME,\n\t\t\tnameof(info.objects),\n\t\t\tinfo.objects\n\t\t);\n\t\tthis._information.push(info);\n\t}\n}\n"]}
+{"version":3,"file":"staticPolicyInformationSource.js","sourceRoot":"","sources":["../../../src/policyInformationSources/staticPolicyInformationSource.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { ComponentFactory, Guards, Is } from \"@twin.org/core\";\nimport type { ILoggingComponent } from \"@twin.org/logging-models\";\nimport { nameof } from \"@twin.org/nameof\";\nimport {\n\tOdrlPolicyHelper,\n\tPolicyInformationAccessMode,\n\ttype IPolicyInformationSource,\n\ttype IRightsManagementInformation,\n\ttype IRightsManagementPolicy\n} from \"@twin.org/rights-management-models\";\nimport type { OdrlActionType } from \"@twin.org/standards-w3c-odrl\";\nimport type { IStaticPolicyInformationSource } from \"../models/IStaticPolicyInformationSource.js\";\nimport type { IStaticPolicyInformationSourceConstructorOptions } from \"../models/IStaticPolicyInformationSourceConstructorOptions.js\";\n\n/**\n * Policy information source which retrieves static information.\n */\nexport class StaticPolicyInformationSource implements IPolicyInformationSource {\n\t/**\n\t * The class name of the Static Policy Information Source.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<StaticPolicyInformationSource>();\n\n\t/**\n\t * The logging component.\n\t * @internal\n\t */\n\tprivate readonly _logging?: ILoggingComponent;\n\n\t/**\n\t * The information sources.\n\t * @internal\n\t */\n\tprivate readonly _information: IStaticPolicyInformationSource[];\n\n\t/**\n\t * Create a new instance of StaticPolicyInformationSource.\n\t * @param options The options for the logging policy source.\n\t */\n\tconstructor(options?: IStaticPolicyInformationSourceConstructorOptions) {\n\t\tthis._logging = ComponentFactory.getIfExists<ILoggingComponent>(options?.loggingComponentType);\n\t\tthis._information = options?.config?.information ?? [];\n\t}\n\n\t/**\n\t * Returns the class name of the component.\n\t * @returns The class name of the component.\n\t */\n\tpublic className(): string {\n\t\treturn StaticPolicyInformationSource.CLASS_NAME;\n\t}\n\n\t/**\n\t * Retrieve information from the sources.\n\t * @param policy The policy to retrieve information for if available.\n\t * @param accessMode The access mode to use for the retrieval.\n\t * @param data The data to process.\n\t * @param action The action to get any additional information for.\n\t * @returns The objects containing relevant information or undefined if nothing relevant is found.\n\t */\n\tpublic async retrieve<D = unknown>(\n\t\tpolicy: IRightsManagementPolicy | undefined,\n\t\taccessMode: PolicyInformationAccessMode,\n\t\tdata?: D,\n\t\taction?: OdrlActionType | string\n\t): Promise<IRightsManagementInformation | undefined> {\n\t\tGuards.arrayOneOf(\n\t\t\tStaticPolicyInformationSource.CLASS_NAME,\n\t\t\tnameof(accessMode),\n\t\t\taccessMode,\n\t\t\tObject.values(PolicyInformationAccessMode)\n\t\t);\n\n\t\tlet information: IRightsManagementInformation = {};\n\n\t\tawait this._logging?.log({\n\t\t\tlevel: \"info\",\n\t\t\tsource: StaticPolicyInformationSource.CLASS_NAME,\n\t\t\tts: Date.now(),\n\t\t\tmessage: \"staticRetrieving\",\n\t\t\tdata: {\n\t\t\t\tpolicyId: OdrlPolicyHelper.getUid(policy) ?? \"\",\n\t\t\t\taccessMode\n\t\t\t}\n\t\t});\n\n\t\tfor (const info of this._information) {\n\t\t\tif (\n\t\t\t\tinfo.accessMode === accessMode ||\n\t\t\t\taccessMode === PolicyInformationAccessMode.Any ||\n\t\t\t\tinfo.accessMode === PolicyInformationAccessMode.Any\n\t\t\t) {\n\t\t\t\tconst matchLocators = info.matchLocators;\n\t\t\t\tif (\n\t\t\t\t\t!Is.arrayValue(matchLocators) ||\n\t\t\t\t\tmatchLocators.some(locator => OdrlPolicyHelper.matchPolicy(policy, locator))\n\t\t\t\t) {\n\t\t\t\t\tinformation = {\n\t\t\t\t\t\t...information,\n\t\t\t\t\t\t...info.objects\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tawait this._logging?.log({\n\t\t\tlevel: \"info\",\n\t\t\tsource: StaticPolicyInformationSource.CLASS_NAME,\n\t\t\tts: Date.now(),\n\t\t\tmessage: \"staticRetrieved\",\n\t\t\tdata: {\n\t\t\t\tpolicyId: OdrlPolicyHelper.getUid(policy) ?? \"\",\n\t\t\t\taccessMode,\n\t\t\t\titemCount: Object.keys(information).length\n\t\t\t}\n\t\t});\n\n\t\treturn Object.keys(information).length > 0 ? information : undefined;\n\t}\n\n\t/**\n\t * Add static policy information.\n\t * @param info The static policy information to add.\n\t */\n\tpublic addInformation(info: IStaticPolicyInformationSource): void {\n\t\tGuards.arrayOneOf<string>(\n\t\t\tStaticPolicyInformationSource.CLASS_NAME,\n\t\t\tnameof(info.accessMode),\n\t\t\tinfo.accessMode,\n\t\t\tObject.values(PolicyInformationAccessMode)\n\t\t);\n\t\tGuards.objectValue<IRightsManagementInformation>(\n\t\t\tStaticPolicyInformationSource.CLASS_NAME,\n\t\t\tnameof(info.objects),\n\t\t\tinfo.objects\n\t\t);\n\t\tthis._information.push(info);\n\t}\n}\n"]}

package/dist/es/policyNegotiators/passThroughPolicyNegotiator.js

@@ -0,0 +1,88 @@
+// Copyright 2025 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { ComponentFactory, Guards, ObjectHelper, Urn } from "@twin.org/core";
+import { OdrlPolicyHelper, RightsManagementNamespaces } from "@twin.org/rights-management-models";
+import { OdrlPolicyType } from "@twin.org/standards-w3c-odrl";
+/**
+ * Pass Through Policy Negotiator.
+ */
+export class PassThroughPolicyNegotiator {
+    /**
+     * The class name of the Pass Through Policy Negotiator.
+     */
+    static CLASS_NAME = "PassThroughPolicyNegotiator";
+    /**
+     * The logging component.
+     * @internal
+     */
+    _logging;
+    /**
+     * Create a new instance of PassThroughPolicyNegotiator.
+     * @param options The options for the pass through policy negotiator.
+     */
+    constructor(options) {
+        this._logging = ComponentFactory.getIfExists(options?.loggingComponentType);
+    }
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className() {
+        return PassThroughPolicyNegotiator.CLASS_NAME;
+    }
+    /**
+     * Determines if the negotiator supports the given offer.
+     * @param offer The offer to check.
+     * @returns True if the negotiator supports the given offer.
+     */
+    supportsOffer(offer) {
+        return true;
+    }
+    /**
+     * Handle the offer.
+     * @param offer The offer to check.
+     * @param information Information provided by the requester to determine if a policy can be created.
+     * @returns Sets the accepted flag if it can be offered, and the interventionRequired flag if manual agreement is needed.
+     */
+    async handleOffer(offer, information) {
+        Guards.object(PassThroughPolicyNegotiator.CLASS_NAME, "offer", offer);
+        await this._logging?.log({
+            level: "info",
+            source: PassThroughPolicyNegotiator.CLASS_NAME,
+            ts: Date.now(),
+            message: "handlingOffer",
+            data: {
+                offerId: OdrlPolicyHelper.getUid(offer) ?? ""
+            }
+        });
+        return {
+            accepted: true,
+            interventionRequired: false
+        };
+    }
+    /**
+     * Create an agreement based on the offer.
+     * @param offer The offer to create the agreement from.
+     * @param assignee The assignee of the agreement.
+     * @param information Information provided by the requester to aid in the creation of the agreement.
+     * @returns The agreement created from the offer or undefined if an agreement could not be created.
+     */
+    async createAgreement(offer, assignee, information) {
+        Guards.object(PassThroughPolicyNegotiator.CLASS_NAME, "offer", offer);
+        await this._logging?.log({
+            level: "info",
+            source: PassThroughPolicyNegotiator.CLASS_NAME,
+            ts: Date.now(),
+            message: "createAgreement",
+            data: {
+                offerId: OdrlPolicyHelper.getUid(offer) ?? ""
+            }
+        });
+        const agreement = ObjectHelper.clone(offer);
+        agreement["@type"] = OdrlPolicyType.Agreement;
+        agreement["@id"] = Urn.generateRandom(RightsManagementNamespaces.Policy).toString(false);
+        agreement.assignee = assignee;
+        return agreement;
+    }
+}
+//# sourceMappingURL=passThroughPolicyNegotiator.js.map

package/dist/es/policyNegotiators/passThroughPolicyNegotiator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passThroughPolicyNegotiator.js","sourceRoot":"","sources":["../../../src/policyNegotiators/passThroughPolicyNegotiator.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAG7E,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAG1B,MAAM,oCAAoC,CAAC;AAM5C,OAAO,EAAE,cAAc,EAAmB,MAAM,8BAA8B,CAAC;AAG/E;;GAEG;AACH,MAAM,OAAO,2BAA2B;IACvC;;OAEG;IACI,MAAM,CAAU,UAAU,iCAAiD;IAElF;;;OAGG;IACc,QAAQ,CAAqB;IAE9C;;;OAGG;IACH,YAAY,OAAwD;QACnE,IAAI,CAAC,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAoB,OAAO,EAAE,oBAAoB,CAAC,CAAC;IAChG,CAAC;IAED;;;OAGG;IACI,SAAS;QACf,OAAO,2BAA2B,CAAC,UAAU,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACI,aAAa,CAAC,KAA8B;QAClD,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,WAAW,CACvB,KAA8B,EAC9B,WAA0C;QAK1C,MAAM,CAAC,MAAM,CACZ,2BAA2B,CAAC,UAAU,WAEtC,KAAK,CACL,CAAC;QAEF,MAAM,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC;YACxB,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,2BAA2B,CAAC,UAAU;YAC9C,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,OAAO,EAAE,eAAe;YACxB,IAAI,EAAE;gBACL,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;aAC7C;SACD,CAAC,CAAC;QAEH,OAAO;YACN,QAAQ,EAAE,IAAI;YACd,oBAAoB,EAAE,KAAK;SAC3B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,eAAe,CAC3B,KAA8B,EAC9B,QAA6B,EAC7B,WAA0C;QAE1C,MAAM,CAAC,MAAM,CACZ,2BAA2B,CAAC,UAAU,WAEtC,KAAK,CACL,CAAC;QAEF,MAAM,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC;YACxB,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,2BAA2B,CAAC,UAAU;YAC9C,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,OAAO,EAAE,iBAAiB;YAC1B,IAAI,EAAE;gBACL,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;aAC7C;SACD,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAA2B,KAAK,CAAC,CAAC;QAEtE,SAAS,CAAC,OAAO,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC;QAC9C,SAAS,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,cAAc,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzF,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAE9B,OAAO,SAAwC,CAAC;IACjD,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { ComponentFactory, Guards, ObjectHelper, Urn } from \"@twin.org/core\";\nimport type { ILoggingComponent } from \"@twin.org/logging-models\";\nimport { nameof } from \"@twin.org/nameof\";\nimport {\n\tOdrlPolicyHelper,\n\tRightsManagementNamespaces,\n\ttype IPolicyNegotiator,\n\ttype IRightsManagementInformation\n} from \"@twin.org/rights-management-models\";\nimport type {\n\tIDataspaceProtocolAgreement,\n\tIDataspaceProtocolOffer,\n\tIDataspaceProtocolPolicy\n} from \"@twin.org/standards-dataspace-protocol\";\nimport { OdrlPolicyType, type IOdrlParty } from \"@twin.org/standards-w3c-odrl\";\nimport type { IPassThroughPolicyNegotiatorConstructorOptions } from \"../models/IPassThroughPolicyNegotiatorConstructorOptions.js\";\n\n/**\n * Pass Through Policy Negotiator.\n */\nexport class PassThroughPolicyNegotiator implements IPolicyNegotiator {\n\t/**\n\t * The class name of the Pass Through Policy Negotiator.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<PassThroughPolicyNegotiator>();\n\n\t/**\n\t * The logging component.\n\t * @internal\n\t */\n\tprivate readonly _logging?: ILoggingComponent;\n\n\t/**\n\t * Create a new instance of PassThroughPolicyNegotiator.\n\t * @param options The options for the pass through policy negotiator.\n\t */\n\tconstructor(options?: IPassThroughPolicyNegotiatorConstructorOptions) {\n\t\tthis._logging = ComponentFactory.getIfExists<ILoggingComponent>(options?.loggingComponentType);\n\t}\n\n\t/**\n\t * Returns the class name of the component.\n\t * @returns The class name of the component.\n\t */\n\tpublic className(): string {\n\t\treturn PassThroughPolicyNegotiator.CLASS_NAME;\n\t}\n\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\tpublic supportsOffer(offer: IDataspaceProtocolOffer): boolean {\n\t\treturn true;\n\t}\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\tpublic async handleOffer(\n\t\toffer: IDataspaceProtocolOffer,\n\t\tinformation?: IRightsManagementInformation\n\t): Promise<{\n\t\taccepted: boolean;\n\t\tinterventionRequired: boolean;\n\t}> {\n\t\tGuards.object<IDataspaceProtocolOffer>(\n\t\t\tPassThroughPolicyNegotiator.CLASS_NAME,\n\t\t\tnameof(offer),\n\t\t\toffer\n\t\t);\n\n\t\tawait this._logging?.log({\n\t\t\tlevel: \"info\",\n\t\t\tsource: PassThroughPolicyNegotiator.CLASS_NAME,\n\t\t\tts: Date.now(),\n\t\t\tmessage: \"handlingOffer\",\n\t\t\tdata: {\n\t\t\t\tofferId: OdrlPolicyHelper.getUid(offer) ?? \"\"\n\t\t\t}\n\t\t});\n\n\t\treturn {\n\t\t\taccepted: true,\n\t\t\tinterventionRequired: false\n\t\t};\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\tpublic async createAgreement(\n\t\toffer: IDataspaceProtocolOffer,\n\t\tassignee: string | IOdrlParty,\n\t\tinformation?: IRightsManagementInformation\n\t): Promise<IDataspaceProtocolAgreement | undefined> {\n\t\tGuards.object<IDataspaceProtocolOffer>(\n\t\t\tPassThroughPolicyNegotiator.CLASS_NAME,\n\t\t\tnameof(offer),\n\t\t\toffer\n\t\t);\n\n\t\tawait this._logging?.log({\n\t\t\tlevel: \"info\",\n\t\t\tsource: PassThroughPolicyNegotiator.CLASS_NAME,\n\t\t\tts: Date.now(),\n\t\t\tmessage: \"createAgreement\",\n\t\t\tdata: {\n\t\t\t\tofferId: OdrlPolicyHelper.getUid(offer) ?? \"\"\n\t\t\t}\n\t\t});\n\n\t\tconst agreement = ObjectHelper.clone<IDataspaceProtocolPolicy>(offer);\n\n\t\tagreement[\"@type\"] = OdrlPolicyType.Agreement;\n\t\tagreement[\"@id\"] = Urn.generateRandom(RightsManagementNamespaces.Policy).toString(false);\n\t\tagreement.assignee = assignee;\n\n\t\treturn agreement as IDataspaceProtocolAgreement;\n\t}\n}\n"]}

package/dist/es/policyObligationEnforcers/passThroughPolicyObligationEnforcer.js

@@ -0,0 +1,56 @@
+// Copyright 2025 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { ComponentFactory, Guards } from "@twin.org/core";
+import { OdrlPolicyHelper } from "@twin.org/rights-management-models";
+/**
+ * Pass Through Policy Obligation Enforcer.
+ */
+export class PassThroughPolicyObligationEnforcer {
+    /**
+     * The class name of the Pass Through Policy Obligation Enforcer.
+     */
+    static CLASS_NAME = "PassThroughPolicyObligationEnforcer";
+    /**
+     * The logging component.
+     * @internal
+     */
+    _logging;
+    /**
+     * Create a new instance of Pass Through Policy Obligation Enforcer.
+     * @param options The options for the pass through policy obligation enforcer.
+     */
+    constructor(options) {
+        this._logging = ComponentFactory.getIfExists(options?.loggingComponentType);
+    }
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className() {
+        return PassThroughPolicyObligationEnforcer.CLASS_NAME;
+    }
+    /**
+     * Enforces obligations regarding policy access to data.
+     * @param policy The policy to evaluate.
+     * @param duty The duty to enforce.
+     * @param information Information provided by the requester to determine if a policy can be created.
+     * @param data The data to make a decision on.
+     * @param action Optional action to make a decision on, if not provided, the enforcer will evaluate all actions in the duty.
+     * @returns Whether the obligations were successfully enforced.
+     */
+    async enforce(policy, duty, information, data, action) {
+        Guards.object(PassThroughPolicyObligationEnforcer.CLASS_NAME, "policy", policy);
+        Guards.object(PassThroughPolicyObligationEnforcer.CLASS_NAME, "duty", duty);
+        await this._logging?.log({
+            level: "info",
+            source: PassThroughPolicyObligationEnforcer.CLASS_NAME,
+            ts: Date.now(),
+            message: "enforcingDuty",
+            data: {
+                policyId: OdrlPolicyHelper.getUid(policy) ?? ""
+            }
+        });
+        return true;
+    }
+}
+//# sourceMappingURL=passThroughPolicyObligationEnforcer.js.map

package/dist/es/policyObligationEnforcers/passThroughPolicyObligationEnforcer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passThroughPolicyObligationEnforcer.js","sourceRoot":"","sources":["../../../src/policyObligationEnforcers/passThroughPolicyObligationEnforcer.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG1D,OAAO,EACN,gBAAgB,EAIhB,MAAM,oCAAoC,CAAC;AAI5C;;GAEG;AACH,MAAM,OAAO,mCAAmC;IAC/C;;OAEG;IACI,MAAM,CAAU,UAAU,yCAAyD;IAE1F;;;OAGG;IACc,QAAQ,CAAqB;IAE9C;;;OAGG;IACH,YAAY,OAAgE;QAC3E,IAAI,CAAC,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAoB,OAAO,EAAE,oBAAoB,CAAC,CAAC;IAChG,CAAC;IAED;;;OAGG;IACI,SAAS;QACf,OAAO,mCAAmC,CAAC,UAAU,CAAC;IACvD,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,OAAO,CACnB,MAA+B,EAC/B,IAAe,EACf,WAA0C,EAC1C,IAAQ,EACR,MAAgC;QAEhC,MAAM,CAAC,MAAM,CACZ,mCAAmC,CAAC,UAAU,YAE9C,MAAM,CACN,CAAC;QACF,MAAM,CAAC,MAAM,CAAY,mCAAmC,CAAC,UAAU,UAAgB,IAAI,CAAC,CAAC;QAE7F,MAAM,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC;YACxB,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,mCAAmC,CAAC,UAAU;YACtD,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,OAAO,EAAE,eAAe;YACxB,IAAI,EAAE;gBACL,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;aAC/C;SACD,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACb,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { ComponentFactory, Guards } from \"@twin.org/core\";\nimport type { ILoggingComponent } from \"@twin.org/logging-models\";\nimport { nameof } from \"@twin.org/nameof\";\nimport {\n\tOdrlPolicyHelper,\n\ttype IPolicyObligationEnforcer,\n\ttype IRightsManagementInformation,\n\ttype IRightsManagementPolicy\n} from \"@twin.org/rights-management-models\";\nimport type { OdrlActionType, IOdrlDuty } from \"@twin.org/standards-w3c-odrl\";\nimport type { IPassThroughPolicyObligationEnforcerConstructorOptions } from \"../models/IPassThroughPolicyObligationEnforcerConstructorOptions.js\";\n\n/**\n * Pass Through Policy Obligation Enforcer.\n */\nexport class PassThroughPolicyObligationEnforcer implements IPolicyObligationEnforcer {\n\t/**\n\t * The class name of the Pass Through Policy Obligation Enforcer.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<PassThroughPolicyObligationEnforcer>();\n\n\t/**\n\t * The logging component.\n\t * @internal\n\t */\n\tprivate readonly _logging?: ILoggingComponent;\n\n\t/**\n\t * Create a new instance of Pass Through Policy Obligation Enforcer.\n\t * @param options The options for the pass through policy obligation enforcer.\n\t */\n\tconstructor(options?: IPassThroughPolicyObligationEnforcerConstructorOptions) {\n\t\tthis._logging = ComponentFactory.getIfExists<ILoggingComponent>(options?.loggingComponentType);\n\t}\n\n\t/**\n\t * Returns the class name of the component.\n\t * @returns The class name of the component.\n\t */\n\tpublic className(): string {\n\t\treturn PassThroughPolicyObligationEnforcer.CLASS_NAME;\n\t}\n\n\t/**\n\t * Enforces obligations regarding policy access to data.\n\t * @param policy The policy to evaluate.\n\t * @param duty The duty to enforce.\n\t * @param information Information provided by the requester to determine if a policy can be created.\n\t * @param data The data to make a decision on.\n\t * @param action Optional action to make a decision on, if not provided, the enforcer will evaluate all actions in the duty.\n\t * @returns Whether the obligations were successfully enforced.\n\t */\n\tpublic async enforce<D = unknown>(\n\t\tpolicy: IRightsManagementPolicy,\n\t\tduty: IOdrlDuty,\n\t\tinformation?: IRightsManagementInformation,\n\t\tdata?: D,\n\t\taction?: OdrlActionType | string\n\t): Promise<boolean> {\n\t\tGuards.object<IRightsManagementPolicy>(\n\t\t\tPassThroughPolicyObligationEnforcer.CLASS_NAME,\n\t\t\tnameof(policy),\n\t\t\tpolicy\n\t\t);\n\t\tGuards.object<IOdrlDuty>(PassThroughPolicyObligationEnforcer.CLASS_NAME, nameof(duty), duty);\n\n\t\tawait this._logging?.log({\n\t\t\tlevel: \"info\",\n\t\t\tsource: PassThroughPolicyObligationEnforcer.CLASS_NAME,\n\t\t\tts: Date.now(),\n\t\t\tmessage: \"enforcingDuty\",\n\t\t\tdata: {\n\t\t\t\tpolicyId: OdrlPolicyHelper.getUid(policy) ?? \"\"\n\t\t\t}\n\t\t});\n\n\t\treturn true;\n\t}\n}\n"]}

package/dist/es/policyRequesters/passThroughPolicyRequester.js

@@ -0,0 +1,103 @@
+// Copyright 2025 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { ComponentFactory } from "@twin.org/core";
+import { OdrlPolicyHelper } from "@twin.org/rights-management-models";
+/**
+ * Pass Through Policy Requester.
+ */
+export class PassThroughPolicyRequester {
+    /**
+     * The class name of the Pass Through Policy Requester.
+     */
+    static CLASS_NAME = "PassThroughPolicyRequester";
+    /**
+     * The logging component.
+     * @internal
+     */
+    _logging;
+    /**
+     * Create a new instance of PassThroughPolicyRequester.
+     * @param options The options for the pass through policy Requester.
+     */
+    constructor(options) {
+        this._logging = ComponentFactory.getIfExists(options?.loggingComponentType);
+    }
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className() {
+        return PassThroughPolicyRequester.CLASS_NAME;
+    }
+    /**
+     * A policy has been offered by a provider, let the request handler know about it.
+     * @param negotiationId The id of the negotiation.
+     * @param offer The offer sent by the provider.
+     * @returns True if the offer was accepted, false otherwise.
+     */
+    async offer(negotiationId, offer) {
+        await this._logging?.log({
+            level: "info",
+            source: PassThroughPolicyRequester.CLASS_NAME,
+            ts: Date.now(),
+            message: "offer",
+            data: {
+                negotiationId,
+                offerId: OdrlPolicyHelper.getUid(offer) ?? ""
+            }
+        });
+        return true;
+    }
+    /**
+     * A policy agreement has been sent by a provider, let the request handler know about it.
+     * @param negotiationId The id of the negotiation.
+     * @param agreement The agreement sent by the provider.
+     * @returns True if the agreement was accepted, false otherwise.
+     */
+    async agreement(negotiationId, agreement) {
+        await this._logging?.log({
+            level: "info",
+            source: PassThroughPolicyRequester.CLASS_NAME,
+            ts: Date.now(),
+            message: "agreement",
+            data: {
+                negotiationId,
+                agreementId: OdrlPolicyHelper.getUid(agreement) ?? ""
+            }
+        });
+        return true;
+    }
+    /**
+     * A policy finalisation has been sent by a provider, let the request handler know about it.
+     * @param negotiationId The id of the negotiation.
+     * @returns A promise that resolves when the finalisation has been processed.
+     */
+    async finalised(negotiationId) {
+        await this._logging?.log({
+            level: "info",
+            source: PassThroughPolicyRequester.CLASS_NAME,
+            ts: Date.now(),
+            message: "finalised",
+            data: {
+                negotiationId
+            }
+        });
+    }
+    /**
+     * A policy termination has been sent by a provider, let the request handler know about it.
+     * @param negotiationId The id of the negotiation.
+     * @returns A promise that resolves when the termination has been processed.
+     */
+    async terminated(negotiationId) {
+        await this._logging?.log({
+            level: "info",
+            source: PassThroughPolicyRequester.CLASS_NAME,
+            ts: Date.now(),
+            message: "terminated",
+            data: {
+                negotiationId
+            }
+        });
+    }
+}
+//# sourceMappingURL=passThroughPolicyRequester.js.map

package/dist/es/policyRequesters/passThroughPolicyRequester.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passThroughPolicyRequester.js","sourceRoot":"","sources":["../../../src/policyRequesters/passThroughPolicyRequester.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,EAAE,gBAAgB,EAAyB,MAAM,oCAAoC,CAAC;AAO7F;;GAEG;AACH,MAAM,OAAO,0BAA0B;IACtC;;OAEG;IACI,MAAM,CAAU,UAAU,gCAAgD;IAEjF;;;OAGG;IACc,QAAQ,CAAqB;IAE9C;;;OAGG;IACH,YAAY,OAAuD;QAClE,IAAI,CAAC,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAoB,OAAO,EAAE,oBAAoB,CAAC,CAAC;IAChG,CAAC;IAED;;;OAGG;IACI,SAAS;QACf,OAAO,0BAA0B,CAAC,UAAU,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,KAAK,CAAC,aAAqB,EAAE,KAA8B;QACvE,MAAM,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC;YACxB,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,0BAA0B,CAAC,UAAU;YAC7C,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE;gBACL,aAAa;gBACb,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;aAC7C;SACD,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,SAAS,CACrB,aAAqB,EACrB,SAAsC;QAEtC,MAAM,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC;YACxB,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,0BAA0B,CAAC,UAAU;YAC7C,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,OAAO,EAAE,WAAW;YACpB,IAAI,EAAE;gBACL,aAAa;gBACb,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;aACrD;SACD,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,SAAS,CAAC,aAAqB;QAC3C,MAAM,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC;YACxB,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,0BAA0B,CAAC,UAAU;YAC7C,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,OAAO,EAAE,WAAW;YACpB,IAAI,EAAE;gBACL,aAAa;aACb;SACD,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,UAAU,CAAC,aAAqB;QAC5C,MAAM,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC;YACxB,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,0BAA0B,CAAC,UAAU;YAC7C,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,OAAO,EAAE,YAAY;YACrB,IAAI,EAAE;gBACL,aAAa;aACb;SACD,CAAC,CAAC;IACJ,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { ComponentFactory } from \"@twin.org/core\";\nimport type { ILoggingComponent } from \"@twin.org/logging-models\";\nimport { nameof } from \"@twin.org/nameof\";\nimport { OdrlPolicyHelper, type IPolicyRequester } from \"@twin.org/rights-management-models\";\nimport type {\n\tIDataspaceProtocolAgreement,\n\tIDataspaceProtocolOffer\n} from \"@twin.org/standards-dataspace-protocol\";\nimport type { IPassThroughPolicyRequesterConstructorOptions } from \"../models/IPassThroughPolicyRequesterConstructorOptions.js\";\n\n/**\n * Pass Through Policy Requester.\n */\nexport class PassThroughPolicyRequester implements IPolicyRequester {\n\t/**\n\t * The class name of the Pass Through Policy Requester.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<PassThroughPolicyRequester>();\n\n\t/**\n\t * The logging component.\n\t * @internal\n\t */\n\tprivate readonly _logging?: ILoggingComponent;\n\n\t/**\n\t * Create a new instance of PassThroughPolicyRequester.\n\t * @param options The options for the pass through policy Requester.\n\t */\n\tconstructor(options?: IPassThroughPolicyRequesterConstructorOptions) {\n\t\tthis._logging = ComponentFactory.getIfExists<ILoggingComponent>(options?.loggingComponentType);\n\t}\n\n\t/**\n\t * Returns the class name of the component.\n\t * @returns The class name of the component.\n\t */\n\tpublic className(): string {\n\t\treturn PassThroughPolicyRequester.CLASS_NAME;\n\t}\n\n\t/**\n\t * A policy has been offered by a provider, let the request handler 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\tpublic async offer(negotiationId: string, offer: IDataspaceProtocolOffer): Promise<boolean> {\n\t\tawait this._logging?.log({\n\t\t\tlevel: \"info\",\n\t\t\tsource: PassThroughPolicyRequester.CLASS_NAME,\n\t\t\tts: Date.now(),\n\t\t\tmessage: \"offer\",\n\t\t\tdata: {\n\t\t\t\tnegotiationId,\n\t\t\t\tofferId: OdrlPolicyHelper.getUid(offer) ?? \"\"\n\t\t\t}\n\t\t});\n\n\t\treturn true;\n\t}\n\n\t/**\n\t * A policy agreement has been sent by a provider, let the request handler 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\tpublic async agreement(\n\t\tnegotiationId: string,\n\t\tagreement: IDataspaceProtocolAgreement\n\t): Promise<boolean> {\n\t\tawait this._logging?.log({\n\t\t\tlevel: \"info\",\n\t\t\tsource: PassThroughPolicyRequester.CLASS_NAME,\n\t\t\tts: Date.now(),\n\t\t\tmessage: \"agreement\",\n\t\t\tdata: {\n\t\t\t\tnegotiationId,\n\t\t\t\tagreementId: OdrlPolicyHelper.getUid(agreement) ?? \"\"\n\t\t\t}\n\t\t});\n\n\t\treturn true;\n\t}\n\n\t/**\n\t * A policy finalisation has been sent by a provider, let the request handler 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\tpublic async finalised(negotiationId: string): Promise<void> {\n\t\tawait this._logging?.log({\n\t\t\tlevel: \"info\",\n\t\t\tsource: PassThroughPolicyRequester.CLASS_NAME,\n\t\t\tts: Date.now(),\n\t\t\tmessage: \"finalised\",\n\t\t\tdata: {\n\t\t\t\tnegotiationId\n\t\t\t}\n\t\t});\n\t}\n\n\t/**\n\t * A policy termination has been sent by a provider, let the request handler 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\tpublic async terminated(negotiationId: string): Promise<void> {\n\t\tawait this._logging?.log({\n\t\t\tlevel: \"info\",\n\t\t\tsource: PassThroughPolicyRequester.CLASS_NAME,\n\t\t\tts: Date.now(),\n\t\t\tmessage: \"terminated\",\n\t\t\tdata: {\n\t\t\t\tnegotiationId\n\t\t\t}\n\t\t});\n\t}\n}\n"]}

package/dist/types/index.d.ts

@@ -1,19 +1,29 @@
-export * from "./dataAccessHandlers/examplePolicyRequester.js";
-export * from "./models/IExampleDataAccessHandlerConstructorOptions.js";
-export * from "./models/IExamplePolicyArbiterConstructorOptions.js";
-export * from "./models/IExamplePolicyEnforcementProcessorConstructorOptions.js";
-export * from "./models/IExamplePolicyNegotiatorConstructorOptions.js";
-export * from "./models/IExamplePolicyRequesterConstructorOptions.js";
+export * from "./models/IAutomationPolicyExecutionActionConfig.js";
+export * from "./models/IAutomationPolicyExecutionActionConstructorOptions.js";
+export * from "./models/IDefaultPolicyArbiterConfig.js";
+export * from "./models/IDefaultPolicyArbiterConstructorOptions.js";
+export * from "./models/IDefaultPolicyEnforcementProcessorConstructorOptions.js";
 export * from "./models/IIdentityPolicyInformationSourceConstructorOptions.js";
+export * from "./models/IIdentityProfilePolicyInformationSourceConstructorOptions.js";
 export * from "./models/ILoggingPolicyExecutionActionConfig.js";
 export * from "./models/ILoggingPolicyExecutionActionConstructorOptions.js";
+export * from "./models/IPassThroughPolicyArbiterConstructorOptions.js";
+export * from "./models/IPassThroughPolicyEnforcementProcessorConstructorOptions.js";
+export * from "./models/IPassThroughPolicyNegotiatorConstructorOptions.js";
+export * from "./models/IPassThroughPolicyObligationEnforcerConstructorOptions.js";
+export * from "./models/IPassThroughPolicyRequesterConstructorOptions.js";
 export * from "./models/IStaticPolicyInformationSource.js";
 export * from "./models/IStaticPolicyInformationSourceConfig.js";
 export * from "./models/IStaticPolicyInformationSourceConstructorOptions.js";
-export * from "./policyArbiters/examplePolicyArbiter.js";
-export * from "./policyEnforcementProcessor/examplePolicyEnforcementProcessor.js";
+export * from "./policyArbiters/defaultPolicyArbiter.js";
+export * from "./policyArbiters/passThroughPolicyArbiter.js";
+export * from "./policyEnforcementProcessor/defaultPolicyEnforcementProcessor.js";
+export * from "./policyEnforcementProcessor/passThroughPolicyEnforcementProcessor.js";
+export * from "./policyExecutionActions/automationPolicyExecutionAction.js";
 export * from "./policyExecutionActions/loggingPolicyExecutionAction.js";
 export * from "./policyInformationSources/identityPolicyInformationSource.js";
+export * from "./policyInformationSources/identityProfilePolicyInformationSource.js";
 export * from "./policyInformationSources/staticPolicyInformationSource.js";
-export * from "./policyNegotiators/examplePolicyNegotiator.js";
-export * from "./policyRequesters/examplePolicyRequester.js";
+export * from "./policyNegotiators/passThroughPolicyNegotiator.js";
+export * from "./policyObligationEnforcers/passThroughPolicyObligationEnforcer.js";
+export * from "./policyRequesters/passThroughPolicyRequester.js";

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

@@ -0,0 +1,9 @@
+/**
+ * Options for the Automation Policy Execution Action Component.
+ */
+export interface IAutomationPolicyExecutionActionConfig {
+    /**
+     * The policy decision stages to trigger the automation actions, if undefined defaults to "inform".
+     */
+    triggerActions?: string[];
+}

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

@@ -0,0 +1,15 @@
+import type { IAutomationPolicyExecutionActionConfig } from "./IAutomationPolicyExecutionActionConfig.js";
+/**
+ * Options for the Automation Policy Execution Action.
+ */
+export interface IAutomationPolicyExecutionActionConstructorOptions {
+    /**
+     * The automation component for executing automation policies.
+     * @default automation
+     */
+    automationComponentType?: string;
+    /**
+     * The configuration for the automation policy execution.
+     */
+    config?: IAutomationPolicyExecutionActionConfig;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * Configuration for the Default Policy Arbiter.
+ */
+export interface IDefaultPolicyArbiterConfig {
+    /**
+     * The maximum depth to traverse when resolving inherited policies.
+     * @default 10
+     */
+    maxInheritanceDepth?: number;
+}

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

@@ -0,0 +1,19 @@
+import type { IDefaultPolicyArbiterConfig } from "./IDefaultPolicyArbiterConfig.js";
+/**
+ * Options for the Default Policy Arbiter.
+ */
+export interface IDefaultPolicyArbiterConstructorOptions {
+    /**
+     * The logging component for policy arbiter.
+     */
+    loggingComponentType?: string;
+    /**
+     * The policy administration point component for retrieving inherited policies.
+     * @default policy-administration-point
+     */
+    policyAdministrationPointComponentType?: string;
+    /**
+     * The configuration options for the default policy arbiter.
+     */
+    config?: IDefaultPolicyArbiterConfig;
+}

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

@@ -0,0 +1,9 @@
+/**
+ * Options for the Default Policy Enforcement Processor.
+ */
+export interface IDefaultPolicyEnforcementProcessorConstructorOptions {
+    /**
+     * The logging component for policy enforcement processor.
+     */
+    loggingComponentType?: string;
+}

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

@@ -4,7 +4,6 @@
 export interface IIdentityPolicyInformationSourceConstructorOptions {
     /**
      * The logging component for logging policy source.
-     * @default logging
      */
     loggingComponentType?: string;
     /**

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

@@ -0,0 +1,14 @@
+/**
+ * Options for the Identity Profile Policy Information Source Component.
+ */
+export interface IIdentityProfilePolicyInformationSourceConstructorOptions {
+    /**
+     * The logging component for logging policy source.
+     */
+    loggingComponentType?: string;
+    /**
+     * The component for retrieving identity profiles.
+     * @default identity-profile
+     */
+    identityProfileComponentType?: string;
+}

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

@@ -13,10 +13,10 @@ export interface ILoggingPolicyExecutionActionConfig {
      */
     includeData?: boolean;
     /**
-     * Whether to include the policies in the log.
+     * Whether to include the policy in the log.
      * @default false
      */
-    includePolicies?: boolean;
+    includePolicy?: boolean;
     /**
      * Whether to include the decisions in the log.
      * @default false

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

@@ -5,7 +5,6 @@ import type { ILoggingPolicyExecutionActionConfig } from "./ILoggingPolicyExecut
 export interface ILoggingPolicyExecutionActionConstructorOptions {
     /**
      * The logging component for logging policy execution.
-     * @default logging
      */
     loggingComponentType?: string;
     /**

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

@@ -0,0 +1,9 @@
+/**
+ * Options for the Pass Through Policy Arbiter.
+ */
+export interface IPassThroughPolicyArbiterConstructorOptions {
+    /**
+     * The logging component for policy arbiter.
+     */
+    loggingComponentType?: string;
+}

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

@@ -0,0 +1,9 @@
+/**
+ * Options for the Pass Through Policy Enforcement Processor.
+ */
+export interface IPassThroughPolicyEnforcementProcessorConstructorOptions {
+    /**
+     * The logging component for policy enforcement processor.
+     */
+    loggingComponentType?: string;
+}

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

@@ -0,0 +1,9 @@
+/**
+ * Options for the Pass Through Policy Negotiator.
+ */
+export interface IPassThroughPolicyNegotiatorConstructorOptions {
+    /**
+     * The logging component for policy negotiator.
+     */
+    loggingComponentType?: string;
+}

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

@@ -0,0 +1,9 @@
+/**
+ * Options for the Pass Through Policy Obligation Enforcer.
+ */
+export interface IPassThroughPolicyObligationEnforcerConstructorOptions {
+    /**
+     * The logging component for the policy obligation enforcer.
+     */
+    loggingComponentType?: string;
+}

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

@@ -0,0 +1,9 @@
+/**
+ * Options for the Pass Through Policy Requester.
+ */
+export interface IPassThroughPolicyRequesterConstructorOptions {
+    /**
+     * The logging component for policy requester.
+     */
+    loggingComponentType?: string;
+}