@twin.org/federated-catalogue-models 0.0.1-next.2

package/docs/reference/interfaces/IDataResourceEntry.md

@@ -0,0 +1,131 @@
+# Interface: IDataResourceEntry
+
+Interface describing a Data Resource entry.
+
+## Extends
+
+- `ICatalogueBase`.`IDataResource`
+
+## Indexable
+
+\[`key`: `string`\]: `undefined` \| `null` \| `string` \| `number` \| `boolean` \| `string`[] \| `IJsonLdContextDefinition` \| `IJsonLdContextDefinitionElement`[] \| `IJsonLdIdMap` \| `IJsonLdNodeObject` \| `IJsonLdListObject` \| `object` & `object` \| `object` & `object` \| `object` & `object` \| `IJsonLdSetObject` \| `IJsonLdJsonObject` \| `IJsonLdIndexMap` \| `IJsonLdLanguageMap` \| `IJsonLdGraphObject` \| `IJsonLdNodeObject`[] \| `IJsonLdJsonObject`[] \| \{[`key`: `string`]: `string`; \} \| `IJsonLdTypeMap` \| `IJsonLdNodePrimitive`[]
+
+## Properties
+
+### issuer
+
+> **issuer**: `string`
+
+The trusted issuer of the compliance credential
+
+#### Inherited from
+
+`ICatalogueBase.issuer`
+
+***
+
+### validFrom
+
+> **validFrom**: `string`
+
+Valid from (as per W3C VC Data Model v2)
+
+#### Inherited from
+
+`ICatalogueBase.validFrom`
+
+***
+
+### validUntil
+
+> **validUntil**: `string`
+
+Valid until (as per W3C VC Data Model v2)
+
+#### Inherited from
+
+`ICatalogueBase.validUntil`
+
+***
+
+### dateCreated
+
+> **dateCreated**: `string`
+
+The creation date.
+
+#### Inherited from
+
+`ICatalogueBase.dateCreated`
+
+***
+
+### evidence
+
+> **evidence**: `string`[]
+
+The evidences concerning the data resource.
+
+#### Inherited from
+
+`ICatalogueBase.evidence`
+
+***
+
+### @context
+
+> **@context**: [`FederatedCatalogueContextType`](../type-aliases/FederatedCatalogueContextType.md)
+
+The LD Context
+
+#### Overrides
+
+`IDataResource.@context`
+
+***
+
+### producedBy
+
+> **producedBy**: `string`
+
+Overwriting producedBy as we only store the identifier
+
+#### Overrides
+
+`IDataResource.producedBy`
+
+***
+
+### copyrightOwnedBy
+
+> **copyrightOwnedBy**: `string`
+
+Overwriting copyrightOwnedBy as we only store the identifier
+
+#### Overrides
+
+`IDataResource.copyrightOwnedBy`
+
+***
+
+### exposedThrough
+
+> **exposedThrough**: `string`
+
+Overwriting exposedThrough as we only store the id of the Data Exchange Component
+
+#### Overrides
+
+`IDataResource.exposedThrough`
+
+***
+
+### resourcePolicy
+
+> **resourcePolicy**: `IOdrlPolicy`[]
+
+Overwriting to ensure always an array is stored
+
+#### Overrides
+
+`IDataResource.resourcePolicy`

package/docs/reference/interfaces/IDataResourceGetResponse.md

@@ -0,0 +1,11 @@
+# Interface: IDataResourceGetResponse
+
+Service Offering response
+
+## Properties
+
+### body
+
+> **body**: [`IDataResourceEntry`](IDataResourceEntry.md)
+
+The response payload.

package/docs/reference/interfaces/IDataResourceList.md

@@ -0,0 +1,35 @@
+# Interface: IDataResourceList
+
+Interface describing a list of Data Resource entries.
+
+## Properties
+
+### @context
+
+> **@context**: [`FederatedCatalogueContextType`](../type-aliases/FederatedCatalogueContextType.md)
+
+The LD Context.
+
+***
+
+### type
+
+> **type**: `"ItemList"`
+
+The type
+
+***
+
+### itemListElement
+
+> **itemListElement**: `Omit`\<[`IDataResourceEntry`](IDataResourceEntry.md), `"@context"`\>[]
+
+The components of the Collection
+
+***
+
+### nextItem?
+
+> `optional` **nextItem**: `string`
+
+Next item cursor.

package/docs/reference/interfaces/IDataResourceListRequest.md

@@ -0,0 +1,55 @@
+# Interface: IDataResourceListRequest
+
+Get the a list of the data resource entries.
+
+## Extends
+
+- [`IFederatedCatalogueGetRequest`](IFederatedCatalogueGetRequest.md)
+
+## Properties
+
+### query
+
+> **query**: `object`
+
+The query parameters.
+
+#### id?
+
+> `optional` **id**: `string`
+
+The Id of the Data Resource.
+
+#### producedBy?
+
+> `optional` **producedBy**: `string`
+
+The service provider.
+
+#### cursor?
+
+> `optional` **cursor**: `string`
+
+The optional cursor to get next chunk.
+
+#### pageSize?
+
+> `optional` **pageSize**: `number`
+
+The maximum number of entities in a page.
+
+***
+
+### headers?
+
+> `optional` **headers**: `object`
+
+The headers which can be used to determine the response data type.
+
+#### accept
+
+> **accept**: `"application/json"` \| `"application/ld+json"`
+
+#### Inherited from
+
+[`IFederatedCatalogueGetRequest`](IFederatedCatalogueGetRequest.md).[`headers`](IFederatedCatalogueGetRequest.md#headers)

package/docs/reference/interfaces/IDataResourceListResponse.md

@@ -0,0 +1,11 @@
+# Interface: IDataResourceListResponse
+
+Response fo data resource list.
+
+## Properties
+
+### body
+
+> **body**: [`IDataResourceList`](IDataResourceList.md)
+
+The response payload.

package/docs/reference/interfaces/IDataSpaceConnector.md

@@ -0,0 +1,130 @@
+# Interface: IDataSpaceConnector
+
+TWIN Data Space Connector.
+
+## Extends
+
+- `IDataExchangeComponent`
+
+## Extended by
+
+- [`IDataSpaceConnectorEntry`](IDataSpaceConnectorEntry.md)
+
+## Indexable
+
+\[`key`: `string`\]: `undefined` \| `null` \| `string` \| `number` \| `boolean` \| `string`[] \| `IJsonLdContextDefinition` \| `IJsonLdContextDefinitionElement`[] \| `IJsonLdIdMap` \| `IJsonLdNodeObject` \| `IJsonLdListObject` \| `object` & `object` \| `object` & `object` \| `object` & `object` \| `IJsonLdSetObject` \| `IJsonLdJsonObject` \| `IJsonLdIndexMap` \| `IJsonLdLanguageMap` \| `IJsonLdGraphObject` \| `IJsonLdNodeObject`[] \| `IJsonLdJsonObject`[] \| \{[`key`: `string`]: `string`; \} \| `IJsonLdTypeMap` \| `IJsonLdNodePrimitive`[]
+
+## Properties
+
+### @context
+
+> **@context**: `GaiaXContextType`
+
+The LD Context.
+
+#### Overrides
+
+`IDataExchangeComponent.@context`
+
+***
+
+### id
+
+> **id**: `string`
+
+A unique identifier given to this Data Space Connector.
+
+***
+
+### type
+
+> **type**: \[`"DataExchangeComponent"`, `"DataSpaceConnector"`, `...string[]`\]
+
+A Connector is a Data Exchange Component
+
+#### Overrides
+
+`IDataExchangeComponent.type`
+
+***
+
+### identity
+
+> **identity**: `string`
+
+Connector's Identity that allows to know public key of this Connector.
+
+***
+
+### maintainer
+
+> **maintainer**: `string`
+
+Who maintains this Data Space Connector.
+
+***
+
+### name?
+
+> `optional` **name**: `string`
+
+The name of this Data Space Connector
+
+***
+
+### description?
+
+> `optional` **description**: `string`
+
+A description of this Data Space Connector
+
+***
+
+### defaultEndpoint
+
+> **defaultEndpoint**: `IEndpoint`
+
+The default endpoint of the Connector.
+This endpoint can be used as a base to guess other endpoints in case they are not explicitly declared.
+
+***
+
+### subscriptionActivityEndpoint?
+
+> `optional` **subscriptionActivityEndpoint**: `IEndpoint`
+
+The endpoint used for data subscription by Consumers.
+If the endpoint URL is a relative reference to a URL then it should be resolved using the
+default endpoint URL as a base URL.
+
+***
+
+### pushActivityEndpoint
+
+> **pushActivityEndpoint**: `IEndpoint`
+
+The endpoint used by Providers to push data.
+If the endpoint URL is a relative reference to a URL then it should be resolved using the
+default endpoint URL as a base URL.
+
+***
+
+### pullDataEndpoint
+
+> **pullDataEndpoint**: `IEndpoint`
+
+The endpoint used by Consumers to pull data from.
+If the endpoint URL is a relative reference to a URL then it should be resolved using the
+default endpoint URL as a base URL.
+
+***
+
+### offeredResource
+
+> **offeredResource**: `string`[] \| \{[`resourceId`: `string`]: `IDataResource` \| `IJsonLdNodeObject` & `object`; \}
+
+The resources offered by this Connector.
+A resource index is usually a relative reference to the default endpoint base URL.
+Nonetheless if the resource already declares an endpoint URL that one should be taken.
+It is captured the case where the Data Resource is supplied
+via a list of identifiers or through a map indexed by Id

package/docs/reference/interfaces/IDataSpaceConnectorCredential.md

@@ -0,0 +1,43 @@
+# Interface: IDataSpaceConnectorCredential
+
+Participant Credential.
+
+## Extends
+
+- [`ICredential`](ICredential.md)
+
+## Properties
+
+### id
+
+> **id**: `string`
+
+The Id of the credential, it is mandatory.
+
+#### Inherited from
+
+[`ICredential`](ICredential.md).[`id`](ICredential.md#id)
+
+***
+
+### issuer
+
+> **issuer**: `string`
+
+The issuer of the credential, it is mandatory.
+
+#### Inherited from
+
+[`ICredential`](ICredential.md).[`issuer`](ICredential.md#issuer)
+
+***
+
+### credentialSubject
+
+> **credentialSubject**: [`IDataSpaceConnector`](IDataSpaceConnector.md)
+
+The Credential Subject
+
+#### Overrides
+
+[`ICredential`](ICredential.md).[`credentialSubject`](ICredential.md#credentialsubject)

package/docs/reference/interfaces/IDataSpaceConnectorEntry.md

@@ -0,0 +1,224 @@
+# Interface: IDataSpaceConnectorEntry
+
+Interface describing a participant.
+
+## Extends
+
+- [`IDataSpaceConnector`](IDataSpaceConnector.md).`ICatalogueBase`
+
+## Indexable
+
+\[`key`: `string`\]: `undefined` \| `null` \| `string` \| `number` \| `boolean` \| `string`[] \| `IJsonLdContextDefinition` \| `IJsonLdContextDefinitionElement`[] \| `IJsonLdIdMap` \| `IJsonLdNodeObject` \| `IJsonLdListObject` \| `object` & `object` \| `object` & `object` \| `object` & `object` \| `IJsonLdSetObject` \| `IJsonLdJsonObject` \| `IJsonLdIndexMap` \| `IJsonLdLanguageMap` \| `IJsonLdGraphObject` \| `IJsonLdNodeObject`[] \| `IJsonLdJsonObject`[] \| \{[`key`: `string`]: `string`; \} \| `IJsonLdTypeMap` \| `IJsonLdNodePrimitive`[]
+
+## Properties
+
+### issuer
+
+> **issuer**: `string`
+
+The trusted issuer of the compliance credential
+
+#### Inherited from
+
+`ICatalogueBase.issuer`
+
+***
+
+### validFrom
+
+> **validFrom**: `string`
+
+Valid from (as per W3C VC Data Model v2)
+
+#### Inherited from
+
+`ICatalogueBase.validFrom`
+
+***
+
+### validUntil
+
+> **validUntil**: `string`
+
+Valid until (as per W3C VC Data Model v2)
+
+#### Inherited from
+
+`ICatalogueBase.validUntil`
+
+***
+
+### dateCreated
+
+> **dateCreated**: `string`
+
+The creation date.
+
+#### Inherited from
+
+`ICatalogueBase.dateCreated`
+
+***
+
+### evidence
+
+> **evidence**: `string`[]
+
+The evidences concerning the data resource.
+
+#### Inherited from
+
+`ICatalogueBase.evidence`
+
+***
+
+### id
+
+> **id**: `string`
+
+A unique identifier given to this Data Space Connector.
+
+#### Inherited from
+
+[`IDataSpaceConnector`](IDataSpaceConnector.md).[`id`](IDataSpaceConnector.md#id)
+
+***
+
+### type
+
+> **type**: \[`"DataExchangeComponent"`, `"DataSpaceConnector"`, `...string[]`\]
+
+A Connector is a Data Exchange Component
+
+#### Inherited from
+
+[`IDataSpaceConnector`](IDataSpaceConnector.md).[`type`](IDataSpaceConnector.md#type)
+
+***
+
+### identity
+
+> **identity**: `string`
+
+Connector's Identity that allows to know public key of this Connector.
+
+#### Inherited from
+
+[`IDataSpaceConnector`](IDataSpaceConnector.md).[`identity`](IDataSpaceConnector.md#identity)
+
+***
+
+### maintainer
+
+> **maintainer**: `string`
+
+Who maintains this Data Space Connector.
+
+#### Inherited from
+
+[`IDataSpaceConnector`](IDataSpaceConnector.md).[`maintainer`](IDataSpaceConnector.md#maintainer)
+
+***
+
+### name?
+
+> `optional` **name**: `string`
+
+The name of this Data Space Connector
+
+#### Inherited from
+
+[`IDataSpaceConnector`](IDataSpaceConnector.md).[`name`](IDataSpaceConnector.md#name)
+
+***
+
+### description?
+
+> `optional` **description**: `string`
+
+A description of this Data Space Connector
+
+#### Inherited from
+
+[`IDataSpaceConnector`](IDataSpaceConnector.md).[`description`](IDataSpaceConnector.md#description)
+
+***
+
+### defaultEndpoint
+
+> **defaultEndpoint**: `IEndpoint`
+
+The default endpoint of the Connector.
+This endpoint can be used as a base to guess other endpoints in case they are not explicitly declared.
+
+#### Inherited from
+
+[`IDataSpaceConnector`](IDataSpaceConnector.md).[`defaultEndpoint`](IDataSpaceConnector.md#defaultendpoint)
+
+***
+
+### subscriptionActivityEndpoint?
+
+> `optional` **subscriptionActivityEndpoint**: `IEndpoint`
+
+The endpoint used for data subscription by Consumers.
+If the endpoint URL is a relative reference to a URL then it should be resolved using the
+default endpoint URL as a base URL.
+
+#### Inherited from
+
+[`IDataSpaceConnector`](IDataSpaceConnector.md).[`subscriptionActivityEndpoint`](IDataSpaceConnector.md#subscriptionactivityendpoint)
+
+***
+
+### pushActivityEndpoint
+
+> **pushActivityEndpoint**: `IEndpoint`
+
+The endpoint used by Providers to push data.
+If the endpoint URL is a relative reference to a URL then it should be resolved using the
+default endpoint URL as a base URL.
+
+#### Inherited from
+
+[`IDataSpaceConnector`](IDataSpaceConnector.md).[`pushActivityEndpoint`](IDataSpaceConnector.md#pushactivityendpoint)
+
+***
+
+### pullDataEndpoint
+
+> **pullDataEndpoint**: `IEndpoint`
+
+The endpoint used by Consumers to pull data from.
+If the endpoint URL is a relative reference to a URL then it should be resolved using the
+default endpoint URL as a base URL.
+
+#### Inherited from
+
+[`IDataSpaceConnector`](IDataSpaceConnector.md).[`pullDataEndpoint`](IDataSpaceConnector.md#pulldataendpoint)
+
+***
+
+### @context
+
+> **@context**: [`FederatedCatalogueContextType`](../type-aliases/FederatedCatalogueContextType.md)
+
+The LD Context
+
+#### Overrides
+
+[`IDataSpaceConnector`](IDataSpaceConnector.md).[`@context`](IDataSpaceConnector.md#context)
+
+***
+
+### offeredResource
+
+> **offeredResource**: `string`[]
+
+Offered resources. Probably in the future this wll be separated in a different entry so
+that a  Data Space Connector entry does not need to be modified when a new Data Resource
+is offered.
+
+#### Overrides
+
+[`IDataSpaceConnector`](IDataSpaceConnector.md).[`offeredResource`](IDataSpaceConnector.md#offeredresource)

package/docs/reference/interfaces/IDataSpaceConnectorGetResponse.md

@@ -0,0 +1,11 @@
+# Interface: IDataSpaceConnectorGetResponse
+
+Service Offering response
+
+## Properties
+
+### body
+
+> **body**: [`IDataSpaceConnectorEntry`](IDataSpaceConnectorEntry.md)
+
+The response payload.

package/docs/reference/interfaces/IDataSpaceConnectorList.md

@@ -0,0 +1,35 @@
+# Interface: IDataSpaceConnectorList
+
+Interface describing a list of Data Space Connectors.
+
+## Properties
+
+### @context
+
+> **@context**: [`FederatedCatalogueContextType`](../type-aliases/FederatedCatalogueContextType.md)
+
+The LD Context.
+
+***
+
+### type
+
+> **type**: `"ItemList"`
+
+The type
+
+***
+
+### itemListElement
+
+> **itemListElement**: `Omit`\<[`IDataSpaceConnectorEntry`](IDataSpaceConnectorEntry.md), `"@context"`\>[]
+
+The components of the Collection
+
+***
+
+### nextItem?
+
+> `optional` **nextItem**: `string`
+
+Next item cursor.