@twin.org/attestation-models 0.0.1-next.3 → 0.0.1-next.30

package/dist/cjs/index.cjs

@@ -1,7 +1,208 @@
 'use strict';
 
+var dataCore = require('@twin.org/data-core');
 var core = require('@twin.org/core');
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * The contexts of attestation data.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const AttestationContexts = {
+    /**
+     * The context root for the attestation types.
+     */
+    ContextRoot: "https://schema.twindev.org/attestation/",
+    /**
+     * The context root for the common types.
+     */
+    ContextRootCommon: "https://schema.twindev.org/common/"
+};
+
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * The types of attestation data.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const AttestationTypes = {
+    /**
+     * Represents attestation information.
+     */
+    Information: "Information",
+    /**
+     * Represents attestation JWT proof.
+     */
+    JwtProof: "JwtProof"
+};
+
+var $schema$1 = "https://json-schema.org/draft/2020-12/schema";
+var $id$1 = "https://schema.twindev.org/attestation/AttestationInformation";
+var description$1 = "Interface describing the collated attestation information.";
+var type$1 = "object";
+var properties$1 = {
+	"@context": {
+		type: "array",
+		minItems: 3,
+		items: {
+			$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
+		},
+		description: "JSON-LD Context.",
+		prefixItems: [
+			{
+				type: "string",
+				"const": "https://schema.twindev.org/attestation/"
+			},
+			{
+				type: "string",
+				"const": "https://schema.twindev.org/common/"
+			},
+			{
+				type: "string",
+				"const": "https://schema.org"
+			}
+		]
+	},
+	type: {
+		type: "string",
+		"const": "Information",
+		description: "JSON-LD Type."
+	},
+	id: {
+		type: "string",
+		description: "The unique identifier of the attestation."
+	},
+	dateCreated: {
+		type: "string",
+		description: "Created date/time of the attestation in ISO format."
+	},
+	dateTransferred: {
+		type: "string",
+		description: "Transferred date/time of the attestation in ISO format, can be blank if holder identity is owner."
+	},
+	ownerIdentity: {
+		type: "string",
+		description: "The identity of the owner."
+	},
+	holderIdentity: {
+		type: "string",
+		description: "The identity of the current holder, can be undefined if owner is still the holder."
+	},
+	attestationObject: {
+		$ref: "https://schema.twindev.org/json-ld/JsonLdNodeObject",
+		description: "The data that was attested."
+	},
+	proof: {
+		$ref: "https://schema.twindev.org/json-ld/JsonLdNodeObject",
+		description: "The proof for the attested data."
+	},
+	verified: {
+		type: "boolean",
+		description: "Whether the attestation has been verified."
+	},
+	verificationFailure: {
+		type: "string",
+		description: "The verification failure message."
+	}
+};
+var required$1 = [
+	"@context",
+	"type",
+	"id",
+	"dateCreated",
+	"ownerIdentity",
+	"attestationObject"
+];
+var additionalProperties$1 = false;
+var AttestationInformationSchema = {
+	$schema: $schema$1,
+	$id: $id$1,
+	description: description$1,
+	type: type$1,
+	properties: properties$1,
+	required: required$1,
+	additionalProperties: additionalProperties$1
+};
+
+var $schema = "https://json-schema.org/draft/2020-12/schema";
+var $id = "https://schema.twindev.org/attestation/AttestationJwtProof";
+var description = "Interface describing an attestation proof.";
+var type = "object";
+var properties = {
+	"@context": {
+		anyOf: [
+			{
+				type: "string",
+				"const": "https://schema.twindev.org/attestation/"
+			},
+			{
+				type: "array",
+				minItems: 1,
+				items: {
+					$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
+				},
+				prefixItems: [
+					{
+						type: "string",
+						"const": "https://schema.twindev.org/attestation/"
+					}
+				]
+			}
+		],
+		description: "JSON-LD Context."
+	},
+	type: {
+		type: "string",
+		"const": "JwtProof",
+		description: "The type of the proof."
+	},
+	value: {
+		type: "string",
+		description: "The value of the proof."
+	}
+};
+var required = [
+	"@context",
+	"type",
+	"value"
+];
+var additionalProperties = false;
+var AttestationJwtProofSchema = {
+	$schema: $schema,
+	$id: $id,
+	description: description,
+	type: type,
+	properties: properties,
+	required: required,
+	additionalProperties: additionalProperties
+};
+
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Handle all the data types for attestation.
+ */
+class AttestationDataTypes {
+    /**
+     * Register all the data types.
+     */
+    static registerTypes() {
+        dataCore.DataTypeHandlerFactory.register(`${AttestationContexts.ContextRoot}${AttestationTypes.Information}`, () => ({
+            context: AttestationContexts.ContextRoot,
+            type: AttestationTypes.Information,
+            defaultValue: {},
+            jsonSchema: async () => AttestationInformationSchema
+        }));
+        dataCore.DataTypeHandlerFactory.register(`${AttestationContexts.ContextRoot}${AttestationTypes.JwtProof}`, () => ({
+            context: AttestationContexts.ContextRoot,
+            type: AttestationTypes.JwtProof,
+            defaultValue: {},
+            jsonSchema: async () => AttestationJwtProofSchema
+        }));
+    }
+}
+
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 /**
@@ -11,3 +212,6 @@ var core = require('@twin.org/core');
 const AttestationConnectorFactory = core.Factory.createFactory("attestation");
 
 exports.AttestationConnectorFactory = AttestationConnectorFactory;
+exports.AttestationContexts = AttestationContexts;
+exports.AttestationDataTypes = AttestationDataTypes;
+exports.AttestationTypes = AttestationTypes;

package/dist/esm/index.mjs

@@ -1,5 +1,206 @@
+import { DataTypeHandlerFactory } from '@twin.org/data-core';
 import { Factory } from '@twin.org/core';
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * The contexts of attestation data.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const AttestationContexts = {
+    /**
+     * The context root for the attestation types.
+     */
+    ContextRoot: "https://schema.twindev.org/attestation/",
+    /**
+     * The context root for the common types.
+     */
+    ContextRootCommon: "https://schema.twindev.org/common/"
+};
+
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * The types of attestation data.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const AttestationTypes = {
+    /**
+     * Represents attestation information.
+     */
+    Information: "Information",
+    /**
+     * Represents attestation JWT proof.
+     */
+    JwtProof: "JwtProof"
+};
+
+var $schema$1 = "https://json-schema.org/draft/2020-12/schema";
+var $id$1 = "https://schema.twindev.org/attestation/AttestationInformation";
+var description$1 = "Interface describing the collated attestation information.";
+var type$1 = "object";
+var properties$1 = {
+	"@context": {
+		type: "array",
+		minItems: 3,
+		items: {
+			$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
+		},
+		description: "JSON-LD Context.",
+		prefixItems: [
+			{
+				type: "string",
+				"const": "https://schema.twindev.org/attestation/"
+			},
+			{
+				type: "string",
+				"const": "https://schema.twindev.org/common/"
+			},
+			{
+				type: "string",
+				"const": "https://schema.org"
+			}
+		]
+	},
+	type: {
+		type: "string",
+		"const": "Information",
+		description: "JSON-LD Type."
+	},
+	id: {
+		type: "string",
+		description: "The unique identifier of the attestation."
+	},
+	dateCreated: {
+		type: "string",
+		description: "Created date/time of the attestation in ISO format."
+	},
+	dateTransferred: {
+		type: "string",
+		description: "Transferred date/time of the attestation in ISO format, can be blank if holder identity is owner."
+	},
+	ownerIdentity: {
+		type: "string",
+		description: "The identity of the owner."
+	},
+	holderIdentity: {
+		type: "string",
+		description: "The identity of the current holder, can be undefined if owner is still the holder."
+	},
+	attestationObject: {
+		$ref: "https://schema.twindev.org/json-ld/JsonLdNodeObject",
+		description: "The data that was attested."
+	},
+	proof: {
+		$ref: "https://schema.twindev.org/json-ld/JsonLdNodeObject",
+		description: "The proof for the attested data."
+	},
+	verified: {
+		type: "boolean",
+		description: "Whether the attestation has been verified."
+	},
+	verificationFailure: {
+		type: "string",
+		description: "The verification failure message."
+	}
+};
+var required$1 = [
+	"@context",
+	"type",
+	"id",
+	"dateCreated",
+	"ownerIdentity",
+	"attestationObject"
+];
+var additionalProperties$1 = false;
+var AttestationInformationSchema = {
+	$schema: $schema$1,
+	$id: $id$1,
+	description: description$1,
+	type: type$1,
+	properties: properties$1,
+	required: required$1,
+	additionalProperties: additionalProperties$1
+};
+
+var $schema = "https://json-schema.org/draft/2020-12/schema";
+var $id = "https://schema.twindev.org/attestation/AttestationJwtProof";
+var description = "Interface describing an attestation proof.";
+var type = "object";
+var properties = {
+	"@context": {
+		anyOf: [
+			{
+				type: "string",
+				"const": "https://schema.twindev.org/attestation/"
+			},
+			{
+				type: "array",
+				minItems: 1,
+				items: {
+					$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
+				},
+				prefixItems: [
+					{
+						type: "string",
+						"const": "https://schema.twindev.org/attestation/"
+					}
+				]
+			}
+		],
+		description: "JSON-LD Context."
+	},
+	type: {
+		type: "string",
+		"const": "JwtProof",
+		description: "The type of the proof."
+	},
+	value: {
+		type: "string",
+		description: "The value of the proof."
+	}
+};
+var required = [
+	"@context",
+	"type",
+	"value"
+];
+var additionalProperties = false;
+var AttestationJwtProofSchema = {
+	$schema: $schema,
+	$id: $id,
+	description: description,
+	type: type,
+	properties: properties,
+	required: required,
+	additionalProperties: additionalProperties
+};
+
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Handle all the data types for attestation.
+ */
+class AttestationDataTypes {
+    /**
+     * Register all the data types.
+     */
+    static registerTypes() {
+        DataTypeHandlerFactory.register(`${AttestationContexts.ContextRoot}${AttestationTypes.Information}`, () => ({
+            context: AttestationContexts.ContextRoot,
+            type: AttestationTypes.Information,
+            defaultValue: {},
+            jsonSchema: async () => AttestationInformationSchema
+        }));
+        DataTypeHandlerFactory.register(`${AttestationContexts.ContextRoot}${AttestationTypes.JwtProof}`, () => ({
+            context: AttestationContexts.ContextRoot,
+            type: AttestationTypes.JwtProof,
+            defaultValue: {},
+            jsonSchema: async () => AttestationJwtProofSchema
+        }));
+    }
+}
+
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 /**
@@ -8,4 +209,4 @@ import { Factory } from '@twin.org/core';
 // eslint-disable-next-line @typescript-eslint/naming-convention
 const AttestationConnectorFactory = Factory.createFactory("attestation");
 
-export { AttestationConnectorFactory };
+export { AttestationConnectorFactory, AttestationContexts, AttestationDataTypes, AttestationTypes };

package/dist/types/dataTypes/attestationDataTypes.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Handle all the data types for attestation.
+ */
+export declare class AttestationDataTypes {
+    /**
+     * Register all the data types.
+     */
+    static registerTypes(): void;
+}

package/dist/types/index.d.ts

@@ -1,12 +1,13 @@
+export * from "./dataTypes/attestationDataTypes";
 export * from "./factories/attestationConnectorFactory";
+export * from "./models/api/IAttestationCreateRequest";
+export * from "./models/api/IAttestationDestroyRequest";
+export * from "./models/api/IAttestationGetRequest";
+export * from "./models/api/IAttestationGetResponse";
+export * from "./models/api/IAttestationTransferRequest";
+export * from "./models/attestationContexts";
+export * from "./models/attestationTypes";
 export * from "./models/IAttestationComponent";
 export * from "./models/IAttestationConnector";
 export * from "./models/IAttestationInformation";
-export * from "./models/IAttestationProof";
-export * from "./models/api/IAttestationAttestRequest";
-export * from "./models/api/IAttestationAttestResponse";
-export * from "./models/api/IAttestationDestroyRequest";
-export * from "./models/api/IAttestationTransferRequest";
-export * from "./models/api/IAttestationTransferResponse";
-export * from "./models/api/IAttestationVerifyRequest";
-export * from "./models/api/IAttestationVerifyResponse";
+export * from "./models/IAttestationJwtProof";

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

@@ -1,4 +1,5 @@
 import type { IComponent } from "@twin.org/core";
+import type { IJsonLdNodeObject } from "@twin.org/data-json-ld";
 import type { IAttestationInformation } from "./IAttestationInformation";
 /**
  * Interface describing an attestation contract.
@@ -6,37 +7,33 @@ import type { IAttestationInformation } from "./IAttestationInformation";
 export interface IAttestationComponent extends IComponent {
     /**
      * Attest the data and return the collated information.
-     * @param verificationMethodId The identity verification method to use for attesting the data.
-     * @param data The data to attest.
+     * @param attestationObject The data to attest.
      * @param namespace The namespace of the connector to use for the attestation, defaults to component configured namespace.
      * @param identity The identity to perform the attestation operation with.
      * @param nodeIdentity The node identity to include in the attestation.
-     * @returns The collated attestation data.
+     * @returns The id of the attestation.
      */
-    attest<T = unknown>(verificationMethodId: string, data: T, namespace?: string, identity?: string, nodeIdentity?: string): Promise<IAttestationInformation<T>>;
+    create(attestationObject: IJsonLdNodeObject, namespace?: string, identity?: string, nodeIdentity?: string): Promise<string>;
     /**
      * Resolve and verify the attestation id.
-     * @param attestationId The attestation id to verify.
+     * @param id The attestation id to verify.
      * @returns The verified attestation details.
      */
-    verify<T = unknown>(attestationId: string): Promise<{
-        verified: boolean;
-        failure?: string;
-        information?: Partial<IAttestationInformation<T>>;
-    }>;
+    get(id: string): Promise<IAttestationInformation>;
     /**
      * Transfer the attestation to a new holder.
      * @param attestationId The attestation to transfer.
      * @param holderIdentity The identity to transfer the attestation to.
+     * @param holderAddress The address to transfer the attestation to.
      * @param identity The identity to perform the attestation operation with.
-     * @returns The updated attestation details.
+     * @returns Nothing.
      */
-    transfer<T = unknown>(attestationId: string, holderIdentity: string, identity?: string): Promise<IAttestationInformation<T>>;
+    transfer(attestationId: string, holderIdentity: string, holderAddress: string, identity?: string): Promise<void>;
     /**
      * Destroy the attestation.
      * @param attestationId The attestation to transfer.
      * @param identity The identity to perform the attestation operation with.
-     * @returns The updated attestation details.
+     * @returns Nothing.
      */
     destroy(attestationId: string, identity?: string): Promise<void>;
 }

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

@@ -1,4 +1,5 @@
 import type { IComponent } from "@twin.org/core";
+import type { IJsonLdNodeObject } from "@twin.org/data-json-ld";
 import type { IAttestationInformation } from "./IAttestationInformation";
 /**
  * Interface describing an attestation connector.
@@ -7,31 +8,26 @@ export interface IAttestationConnector extends IComponent {
     /**
      * Attest the data and return the collated information.
      * @param controller The controller identity of the user to access the vault keys.
-     * @param address The controller address for the attestation.
      * @param verificationMethodId The identity verification method to use for attesting the data.
-     * @param data The data to attest.
+     * @param attestationObject The data to attest.
      * @returns The collated attestation data.
      */
-    attest<T = unknown>(controller: string, address: string, verificationMethodId: string, data: T): Promise<IAttestationInformation<T>>;
+    create(controller: string, verificationMethodId: string, attestationObject: IJsonLdNodeObject): Promise<string>;
     /**
      * Resolve and verify the attestation id.
-     * @param attestationId The attestation id to verify.
+     * @param id The attestation id to verify.
      * @returns The verified attestation details.
      */
-    verify<T = unknown>(attestationId: string): Promise<{
-        verified: boolean;
-        failure?: string;
-        information?: Partial<IAttestationInformation<T>>;
-    }>;
+    get(id: string): Promise<IAttestationInformation>;
     /**
      * Transfer the attestation to a new holder.
      * @param controller The controller identity of the user to access the vault keys.
      * @param attestationId The attestation to transfer.
      * @param holderIdentity The holder identity of the attestation.
      * @param holderAddress The new controller address of the attestation belonging to the holder.
-     * @returns The updated attestation details.
+     * @returns Nothing.
      */
-    transfer<T = unknown>(controller: string, attestationId: string, holderIdentity: string, holderAddress: string): Promise<IAttestationInformation<T>>;
+    transfer(controller: string, attestationId: string, holderIdentity: string, holderAddress: string): Promise<void>;
     /**
      * Destroy the attestation.
      * @param controller The controller identity of the user to access the vault keys.

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

@@ -1,8 +1,24 @@
-import type { IAttestationProof } from "./IAttestationProof";
+import type { IJsonLdContextDefinitionElement, IJsonLdNodeObject } from "@twin.org/data-json-ld";
+import type { SchemaOrgContexts } from "@twin.org/standards-schema-org";
+import type { AttestationContexts } from "./attestationContexts";
+import type { AttestationTypes } from "./attestationTypes";
 /**
  * Interface describing the collated attestation information.
  */
-export interface IAttestationInformation<T = unknown> {
+export interface IAttestationInformation {
+    /**
+     * JSON-LD Context.
+     */
+    "@context": [
+        typeof AttestationContexts.ContextRoot,
+        typeof AttestationContexts.ContextRootCommon,
+        typeof SchemaOrgContexts.ContextRoot,
+        ...IJsonLdContextDefinitionElement[]
+    ];
+    /**
+     * JSON-LD Type.
+     */
+    type: typeof AttestationTypes.Information;
     /**
      * The unique identifier of the attestation.
      */
@@ -10,15 +26,15 @@ export interface IAttestationInformation<T = unknown> {
     /**
      * Created date/time of the attestation in ISO format.
      */
-    created: string;
+    dateCreated: string;
     /**
-     * The identity of the owner.
+     * Transferred date/time of the attestation in ISO format, can be blank if holder identity is owner.
      */
-    ownerIdentity: string;
+    dateTransferred?: string;
     /**
-     * Transferred date/time of the attestation in ISO format, can be blank if holder identity is owner.
+     * The identity of the owner.
      */
-    transferred?: string;
+    ownerIdentity: string;
     /**
      * The identity of the current holder, can be undefined if owner is still the holder.
      */
@@ -26,9 +42,17 @@ export interface IAttestationInformation<T = unknown> {
     /**
      * The data that was attested.
      */
-    data: T;
+    attestationObject: IJsonLdNodeObject;
     /**
      * The proof for the attested data.
      */
-    proof: IAttestationProof;
+    proof?: IJsonLdNodeObject;
+    /**
+     * Whether the attestation has been verified.
+     */
+    verified?: boolean;
+    /**
+     * The verification failure message.
+     */
+    verificationFailure?: string;
 }

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

@@ -0,0 +1,20 @@
+import type { IJsonLdContextDefinitionElement } from "@twin.org/data-json-ld";
+import type { AttestationContexts } from "./attestationContexts";
+import type { AttestationTypes } from "./attestationTypes";
+/**
+ * Interface describing an attestation proof.
+ */
+export interface IAttestationJwtProof {
+    /**
+     * JSON-LD Context.
+     */
+    "@context": typeof AttestationContexts.ContextRoot | [typeof AttestationContexts.ContextRoot, ...IJsonLdContextDefinitionElement[]];
+    /**
+     * The type of the proof.
+     */
+    type: typeof AttestationTypes.JwtProof;
+    /**
+     * The value of the proof.
+     */
+    value: string;
+}

package/dist/types/models/api/{IAttestationAttestRequest.d.ts → IAttestationCreateRequest.d.ts}

@@ -1,19 +1,16 @@
+import type { IJsonLdNodeObject } from "@twin.org/data-json-ld";
 /**
- * Attest the data and return the collated attestation details.
+ * Attest the data and return the id of the attestation.
  */
-export interface IAttestationAttestRequest {
+export interface IAttestationCreateRequest {
     /**
      * The data to be used in the signing.
      */
     body: {
-        /**
-         * The identity verification method to use for attesting the data.
-         */
-        verificationMethodId: string;
         /**
          * The data object to attest.
          */
-        data: unknown;
+        attestationObject: IJsonLdNodeObject;
         /**
          * The namespace of the connector to use for the attestation, defaults to component configured namespace.
          */