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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +21 -0
  3. package/dist/cjs/index.cjs +121 -0
  4. package/dist/esm/index.mjs +116 -0
  5. package/dist/types/index.d.ts +41 -0
  6. package/dist/types/models/ICatalogueBase.d.ts +25 -0
  7. package/dist/types/models/ICatalogueEntry.d.ts +8 -0
  8. package/dist/types/models/IComplianceCredential.d.ts +37 -0
  9. package/dist/types/models/IComplianceEvidence.d.ts +26 -0
  10. package/dist/types/models/IComplianceVerificationResult.d.ts +19 -0
  11. package/dist/types/models/ICredential.d.ts +21 -0
  12. package/dist/types/models/IFederatedCatalogue.d.ts +89 -0
  13. package/dist/types/models/IVerificationResult.d.ts +13 -0
  14. package/dist/types/models/api/ICatalogueEntryGetRequest.d.ts +15 -0
  15. package/dist/types/models/api/ICompliancePresentationRequest.d.ts +9 -0
  16. package/dist/types/models/api/IDataResourceGetResponse.d.ts +10 -0
  17. package/dist/types/models/api/IDataResourceListRequest.d.ts +27 -0
  18. package/dist/types/models/api/IDataResourceListResponse.d.ts +10 -0
  19. package/dist/types/models/api/IDataSpaceConnectorGetResponse.d.ts +10 -0
  20. package/dist/types/models/api/IDataSpaceConnectorListRequest.d.ts +27 -0
  21. package/dist/types/models/api/IDataSpaceConnectorListResponse.d.ts +10 -0
  22. package/dist/types/models/api/IFederatedCatalogueGetRequest.d.ts +12 -0
  23. package/dist/types/models/api/IParticipantGetResponse.d.ts +10 -0
  24. package/dist/types/models/api/IParticipantListRequest.d.ts +31 -0
  25. package/dist/types/models/api/IParticipantListResponse.d.ts +10 -0
  26. package/dist/types/models/api/IServiceOfferingGetResponse.d.ts +10 -0
  27. package/dist/types/models/api/IServiceOfferingListRequest.d.ts +27 -0
  28. package/dist/types/models/api/IServiceOfferingListResponse.d.ts +10 -0
  29. package/dist/types/models/data-resource/IDataResourceCredential.d.ts +11 -0
  30. package/dist/types/models/data-resource/IDataResourceEntry.d.ts +29 -0
  31. package/dist/types/models/data-resource/IDataResourceList.d.ts +25 -0
  32. package/dist/types/models/data-space-connector/IDataSpaceConnector.d.ts +77 -0
  33. package/dist/types/models/data-space-connector/IDataSpaceConnectorCredential.d.ts +11 -0
  34. package/dist/types/models/data-space-connector/IDataSpaceConnectorEntry.d.ts +18 -0
  35. package/dist/types/models/data-space-connector/IDataSpaceConnectorList.d.ts +25 -0
  36. package/dist/types/models/federatedCatalogueContextInstances.d.ts +14 -0
  37. package/dist/types/models/federatedCatalogueContextType.d.ts +11 -0
  38. package/dist/types/models/federatedCatalogueContexts.d.ts +13 -0
  39. package/dist/types/models/federatedCatalogueEntryType.d.ts +7 -0
  40. package/dist/types/models/federatedCatalogueTypes.d.ts +25 -0
  41. package/dist/types/models/participant/IParticipantCredential.d.ts +11 -0
  42. package/dist/types/models/participant/IParticipantEntry.d.ts +12 -0
  43. package/dist/types/models/participant/IParticipantList.d.ts +25 -0
  44. package/dist/types/models/service-offering/IServiceOfferingCredential.d.ts +11 -0
  45. package/dist/types/models/service-offering/IServiceOfferingEntry.d.ts +25 -0
  46. package/dist/types/models/service-offering/IServiceOfferingList.d.ts +25 -0
  47. package/dist/types/models/verificationFailureReasons.d.ts +53 -0
  48. package/docs/changelog.md +12 -0
  49. package/docs/examples.md +1 -0
  50. package/docs/overview.md +21 -0
  51. package/docs/reference/classes/FederatedCatalogueContextInstances.md +29 -0
  52. package/docs/reference/index.md +57 -0
  53. package/docs/reference/interfaces/ICatalogueEntryGetRequest.md +37 -0
  54. package/docs/reference/interfaces/IComplianceCredential.md +103 -0
  55. package/docs/reference/interfaces/IComplianceEvidence.md +45 -0
  56. package/docs/reference/interfaces/ICompliancePresentationRequest.md +11 -0
  57. package/docs/reference/interfaces/IComplianceVerificationResult.md +55 -0
  58. package/docs/reference/interfaces/ICredential.md +51 -0
  59. package/docs/reference/interfaces/IDataResourceCredential.md +43 -0
  60. package/docs/reference/interfaces/IDataResourceEntry.md +131 -0
  61. package/docs/reference/interfaces/IDataResourceGetResponse.md +11 -0
  62. package/docs/reference/interfaces/IDataResourceList.md +35 -0
  63. package/docs/reference/interfaces/IDataResourceListRequest.md +55 -0
  64. package/docs/reference/interfaces/IDataResourceListResponse.md +11 -0
  65. package/docs/reference/interfaces/IDataSpaceConnector.md +130 -0
  66. package/docs/reference/interfaces/IDataSpaceConnectorCredential.md +43 -0
  67. package/docs/reference/interfaces/IDataSpaceConnectorEntry.md +224 -0
  68. package/docs/reference/interfaces/IDataSpaceConnectorGetResponse.md +11 -0
  69. package/docs/reference/interfaces/IDataSpaceConnectorList.md +35 -0
  70. package/docs/reference/interfaces/IDataSpaceConnectorListRequest.md +55 -0
  71. package/docs/reference/interfaces/IDataSpaceConnectorListResponse.md +11 -0
  72. package/docs/reference/interfaces/IFederatedCatalogue.md +313 -0
  73. package/docs/reference/interfaces/IFederatedCatalogueGetRequest.md +23 -0
  74. package/docs/reference/interfaces/IParticipantCredential.md +43 -0
  75. package/docs/reference/interfaces/IParticipantEntry.md +83 -0
  76. package/docs/reference/interfaces/IParticipantGetResponse.md +11 -0
  77. package/docs/reference/interfaces/IParticipantList.md +35 -0
  78. package/docs/reference/interfaces/IParticipantListRequest.md +61 -0
  79. package/docs/reference/interfaces/IParticipantListResponse.md +11 -0
  80. package/docs/reference/interfaces/IServiceOfferingCredential.md +43 -0
  81. package/docs/reference/interfaces/IServiceOfferingEntry.md +119 -0
  82. package/docs/reference/interfaces/IServiceOfferingGetResponse.md +11 -0
  83. package/docs/reference/interfaces/IServiceOfferingList.md +35 -0
  84. package/docs/reference/interfaces/IServiceOfferingListRequest.md +55 -0
  85. package/docs/reference/interfaces/IServiceOfferingListResponse.md +11 -0
  86. package/docs/reference/interfaces/IVerificationResult.md +23 -0
  87. package/docs/reference/type-aliases/FederatedCatalogueContextType.md +5 -0
  88. package/docs/reference/type-aliases/FederatedCatalogueContexts.md +5 -0
  89. package/docs/reference/type-aliases/FederatedCatalogueEntryType.md +5 -0
  90. package/docs/reference/type-aliases/FederatedCatalogueTypes.md +5 -0
  91. package/docs/reference/type-aliases/ICatalogueEntry.md +5 -0
  92. package/docs/reference/type-aliases/VerificationFailureReasons.md +5 -0
  93. package/docs/reference/variables/FederatedCatalogueContexts.md +13 -0
  94. package/docs/reference/variables/FederatedCatalogueTypes.md +31 -0
  95. package/docs/reference/variables/VerificationFailureReasons.md +73 -0
  96. package/package.json +44 -0
@@ -0,0 +1,119 @@
1
+ # Interface: IServiceOfferingEntry
2
+
3
+ Interface describing a Service Offering.
4
+
5
+ ## Extends
6
+
7
+ - `ICatalogueBase`.`IServiceOffering`
8
+
9
+ ## Indexable
10
+
11
+ \[`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`[]
12
+
13
+ ## Properties
14
+
15
+ ### issuer
16
+
17
+ > **issuer**: `string`
18
+
19
+ The trusted issuer of the compliance credential
20
+
21
+ #### Inherited from
22
+
23
+ `ICatalogueBase.issuer`
24
+
25
+ ***
26
+
27
+ ### validFrom
28
+
29
+ > **validFrom**: `string`
30
+
31
+ Valid from (as per W3C VC Data Model v2)
32
+
33
+ #### Inherited from
34
+
35
+ `ICatalogueBase.validFrom`
36
+
37
+ ***
38
+
39
+ ### validUntil
40
+
41
+ > **validUntil**: `string`
42
+
43
+ Valid until (as per W3C VC Data Model v2)
44
+
45
+ #### Inherited from
46
+
47
+ `ICatalogueBase.validUntil`
48
+
49
+ ***
50
+
51
+ ### dateCreated
52
+
53
+ > **dateCreated**: `string`
54
+
55
+ The creation date.
56
+
57
+ #### Inherited from
58
+
59
+ `ICatalogueBase.dateCreated`
60
+
61
+ ***
62
+
63
+ ### evidence
64
+
65
+ > **evidence**: `string`[]
66
+
67
+ The evidences concerning the data resource.
68
+
69
+ #### Inherited from
70
+
71
+ `ICatalogueBase.evidence`
72
+
73
+ ***
74
+
75
+ ### @context
76
+
77
+ > **@context**: [`FederatedCatalogueContextType`](../type-aliases/FederatedCatalogueContextType.md)
78
+
79
+ The LD Context
80
+
81
+ #### Overrides
82
+
83
+ `IServiceOffering.@context`
84
+
85
+ ***
86
+
87
+ ### providedBy
88
+
89
+ > **providedBy**: `string`
90
+
91
+ Overwrites providedBy as we only store identifier as string
92
+
93
+ #### Overrides
94
+
95
+ `IServiceOffering.providedBy`
96
+
97
+ ***
98
+
99
+ ### aggregationOfResources?
100
+
101
+ > `optional` **aggregationOfResources**: `string`[]
102
+
103
+ Overwrites aggregationOfResources as we only store identifier as string
104
+
105
+ #### Overrides
106
+
107
+ `IServiceOffering.aggregationOfResources`
108
+
109
+ ***
110
+
111
+ ### servicePolicy
112
+
113
+ > **servicePolicy**: `IOdrlPolicy`[]
114
+
115
+ The service policy is always stored as an array
116
+
117
+ #### Overrides
118
+
119
+ `IServiceOffering.servicePolicy`
@@ -0,0 +1,11 @@
1
+ # Interface: IServiceOfferingGetResponse
2
+
3
+ Service Offering response
4
+
5
+ ## Properties
6
+
7
+ ### body
8
+
9
+ > **body**: [`IServiceOfferingEntry`](IServiceOfferingEntry.md)
10
+
11
+ The response payload.
@@ -0,0 +1,35 @@
1
+ # Interface: IServiceOfferingList
2
+
3
+ Interface describing a list of Service Offering Entries.
4
+
5
+ ## Properties
6
+
7
+ ### @context
8
+
9
+ > **@context**: [`FederatedCatalogueContextType`](../type-aliases/FederatedCatalogueContextType.md)
10
+
11
+ The LD Context.
12
+
13
+ ***
14
+
15
+ ### type
16
+
17
+ > **type**: `"ItemList"`
18
+
19
+ The type
20
+
21
+ ***
22
+
23
+ ### itemListElement
24
+
25
+ > **itemListElement**: `Omit`\<[`IServiceOfferingEntry`](IServiceOfferingEntry.md), `"@context"`\>[]
26
+
27
+ The components of the Collection
28
+
29
+ ***
30
+
31
+ ### nextItem?
32
+
33
+ > `optional` **nextItem**: `string`
34
+
35
+ Next item cursor.
@@ -0,0 +1,55 @@
1
+ # Interface: IServiceOfferingListRequest
2
+
3
+ Get the a list of the service offering entries.
4
+
5
+ ## Extends
6
+
7
+ - [`IFederatedCatalogueGetRequest`](IFederatedCatalogueGetRequest.md)
8
+
9
+ ## Properties
10
+
11
+ ### headers?
12
+
13
+ > `optional` **headers**: `object`
14
+
15
+ The headers which can be used to determine the response data type.
16
+
17
+ #### accept
18
+
19
+ > **accept**: `"application/json"` \| `"application/ld+json"`
20
+
21
+ #### Inherited from
22
+
23
+ [`IFederatedCatalogueGetRequest`](IFederatedCatalogueGetRequest.md).[`headers`](IFederatedCatalogueGetRequest.md#headers)
24
+
25
+ ***
26
+
27
+ ### query
28
+
29
+ > **query**: `object`
30
+
31
+ The query parameters.
32
+
33
+ #### id?
34
+
35
+ > `optional` **id**: `string`
36
+
37
+ The Service Offering Id.
38
+
39
+ #### providedBy?
40
+
41
+ > `optional` **providedBy**: `string`
42
+
43
+ The service provider.
44
+
45
+ #### cursor?
46
+
47
+ > `optional` **cursor**: `string`
48
+
49
+ The optional cursor to get next chunk.
50
+
51
+ #### pageSize?
52
+
53
+ > `optional` **pageSize**: `number`
54
+
55
+ The maximum number of entities in a page.
@@ -0,0 +1,11 @@
1
+ # Interface: IServiceOfferingListResponse
2
+
3
+ Response for Service Offering list
4
+
5
+ ## Properties
6
+
7
+ ### body
8
+
9
+ > **body**: [`IServiceOfferingList`](IServiceOfferingList.md)
10
+
11
+ The response payload.
@@ -0,0 +1,23 @@
1
+ # Interface: IVerificationResult
2
+
3
+ Verification Result
4
+
5
+ ## Extended by
6
+
7
+ - [`IComplianceVerificationResult`](IComplianceVerificationResult.md)
8
+
9
+ ## Properties
10
+
11
+ ### verified
12
+
13
+ > **verified**: `boolean`
14
+
15
+ True if verified. False the opposite.
16
+
17
+ ***
18
+
19
+ ### verificationFailureReason?
20
+
21
+ > `optional` **verificationFailureReason**: `string`
22
+
23
+ Verification failure reason.
@@ -0,0 +1,5 @@
1
+ # Type Alias: FederatedCatalogueContextType
2
+
3
+ > **FederatedCatalogueContextType** = \[*typeof* `SchemaOrgContexts.ContextRoot`, *typeof* `GaiaXContexts.GaiaXLdContext`, *typeof* [`ContextRoot`](../variables/FederatedCatalogueContexts.md#contextroot)\]
4
+
5
+ Type that defines the LD Context for the Federated Catalogue entities and entries.
@@ -0,0 +1,5 @@
1
+ # Type Alias: FederatedCatalogueContexts
2
+
3
+ > **FederatedCatalogueContexts** = *typeof* [`FederatedCatalogueContexts`](../variables/FederatedCatalogueContexts.md)\[keyof *typeof* [`FederatedCatalogueContexts`](../variables/FederatedCatalogueContexts.md)\]
4
+
5
+ The Exported types
@@ -0,0 +1,5 @@
1
+ # Type Alias: FederatedCatalogueEntryType
2
+
3
+ > **FederatedCatalogueEntryType** = *typeof* `GaiaXTypes.Participant` \| *typeof* `GaiaXTypes.DataExchangeComponent` \| *typeof* `GaiaXTypes.DataResource` \| *typeof* `GaiaXTypes.ServiceOffering` \| *typeof* [`DataSpaceConnector`](../variables/FederatedCatalogueTypes.md#dataspaceconnector)
4
+
5
+ Types of entries in the Federated Catalogue
@@ -0,0 +1,5 @@
1
+ # Type Alias: FederatedCatalogueTypes
2
+
3
+ > **FederatedCatalogueTypes** = *typeof* [`FederatedCatalogueTypes`](../variables/FederatedCatalogueTypes.md)\[keyof *typeof* [`FederatedCatalogueTypes`](../variables/FederatedCatalogueTypes.md)\]
4
+
5
+ The Exported types
@@ -0,0 +1,5 @@
1
+ # Type Alias: ICatalogueEntry
2
+
3
+ > **ICatalogueEntry** = [`IParticipantEntry`](../interfaces/IParticipantEntry.md) \| [`IDataSpaceConnectorEntry`](../interfaces/IDataSpaceConnectorEntry.md) \| [`IServiceOfferingEntry`](../interfaces/IServiceOfferingEntry.md) \| [`IDataResourceEntry`](../interfaces/IDataResourceEntry.md)
4
+
5
+ Catalogue entry base fields.
@@ -0,0 +1,5 @@
1
+ # Type Alias: VerificationFailureReasons
2
+
3
+ > **VerificationFailureReasons** = *typeof* [`VerificationFailureReasons`](../variables/VerificationFailureReasons.md)\[keyof *typeof* [`VerificationFailureReasons`](../variables/VerificationFailureReasons.md)\]
4
+
5
+ The verification failure Reasons.
@@ -0,0 +1,13 @@
1
+ # Variable: FederatedCatalogueContexts
2
+
3
+ > `const` **FederatedCatalogueContexts**: `object`
4
+
5
+ The LD context concerning the Federated Catalogue.
6
+
7
+ ## Type declaration
8
+
9
+ ### ContextRoot
10
+
11
+ > `readonly` **ContextRoot**: `"https://schema.twindev.org/federated-catalogue/types.jsonld"` = `"https://schema.twindev.org/federated-catalogue/types.jsonld"`
12
+
13
+ A Credential that is compliant.
@@ -0,0 +1,31 @@
1
+ # Variable: FederatedCatalogueTypes
2
+
3
+ > `const` **FederatedCatalogueTypes**: `object`
4
+
5
+ The types concerning the Federated Catalogue.
6
+
7
+ ## Type declaration
8
+
9
+ ### CompliantCredential
10
+
11
+ > `readonly` **CompliantCredential**: `"CompliantCredential"` = `"CompliantCredential"`
12
+
13
+ A Credential that is compliant.
14
+
15
+ ### ComplianceCredential
16
+
17
+ > `readonly` **ComplianceCredential**: `"ComplianceCredential"` = `"ComplianceCredential"`
18
+
19
+ A Compliance Credential.
20
+
21
+ ### DataSpaceConnector
22
+
23
+ > `readonly` **DataSpaceConnector**: `"DataSpaceConnector"` = `"DataSpaceConnector"`
24
+
25
+ A Data Space Connector.
26
+
27
+ ### Id
28
+
29
+ > `readonly` **Id**: `"id"` = `"id"`
30
+
31
+ Id property.
@@ -0,0 +1,73 @@
1
+ # Variable: VerificationFailureReasons
2
+
3
+ > `const` **VerificationFailureReasons**: `object`
4
+
5
+ The verification failure reasons.
6
+
7
+ ## Type declaration
8
+
9
+ ### InvalidCredentialType
10
+
11
+ > `readonly` **InvalidCredentialType**: `"invalidCredentialType"` = `"invalidCredentialType"`
12
+
13
+ Credential type is invalid.
14
+
15
+ ### InvalidIssuer
16
+
17
+ > `readonly` **InvalidIssuer**: `"invalidIssuer"` = `"invalidIssuer"`
18
+
19
+ The issuer is invalid.
20
+
21
+ ### NotValidYet
22
+
23
+ > `readonly` **NotValidYet**: `"notValidYet"` = `"notValidYet"`
24
+
25
+ Credential is not valid yet.
26
+
27
+ ### Expired
28
+
29
+ > `readonly` **Expired**: `"expired"` = `"expired"`
30
+
31
+ Credential ahs expired.
32
+
33
+ ### EvidenceCannotBeVerified
34
+
35
+ > `readonly` **EvidenceCannotBeVerified**: `"evidenceCannotBeVerified"` = `"evidenceCannotBeVerified"`
36
+
37
+ Credential's evidence cannot be verified.
38
+
39
+ ### NoValidityEndPeriod
40
+
41
+ > `readonly` **NoValidityEndPeriod**: `"noValidityEndPeriod"` = `"noValidityEndPeriod"`
42
+
43
+ Credential has no expiration.
44
+
45
+ ### MissingSubject
46
+
47
+ > `readonly` **MissingSubject**: `"missingSubject"` = `"missingSubject"`
48
+
49
+ Credential's subject is missing.
50
+
51
+ ### MissingEvidences
52
+
53
+ > `readonly` **MissingEvidences**: `"missingEvidences"` = `"missingEvidences"`
54
+
55
+ Credential's evidences are missing.
56
+
57
+ ### GeneralVerificationError
58
+
59
+ > `readonly` **GeneralVerificationError**: `"generalVerificationError"` = `"generalVerificationError"`
60
+
61
+ General error happened while verifying and the credential cannot be deemed as verified.
62
+
63
+ ### IntegrityCheckFailed
64
+
65
+ > `readonly` **IntegrityCheckFailed**: `"integrityCheckFailed"` = `"integrityCheckFailed"`
66
+
67
+ Credential's integrity check has failed
68
+
69
+ ### EvidenceCannotBeRetrieved
70
+
71
+ > `readonly` **EvidenceCannotBeRetrieved**: `"evidenceCannotBeRetrieved"` = `"evidenceCannotBeRetrieved"`
72
+
73
+ Credential's Evidence cannot be retrieved.
package/package.json ADDED
@@ -0,0 +1,44 @@
1
+ {
2
+ "name": "@twin.org/federated-catalogue-models",
3
+ "version": "0.0.1-next.2",
4
+ "description": "Models which define the structure of the Federated Catalogue Service",
5
+ "repository": {
6
+ "type": "git",
7
+ "url": "https://github.com/twinfoundation/federated-catalogue.git",
8
+ "directory": "packages/federated-catalogue-models"
9
+ },
10
+ "author": "jose.cantera@iota.org",
11
+ "license": "Apache-2.0",
12
+ "type": "module",
13
+ "engines": {
14
+ "node": ">=20.0.0"
15
+ },
16
+ "dependencies": {
17
+ "@twin.org/core": "next",
18
+ "@twin.org/data-json-ld": "next",
19
+ "@twin.org/entity": "next",
20
+ "@twin.org/nameof": "next",
21
+ "@twin.org/standards-gaia-x": "next",
22
+ "@twin.org/standards-schema-org": "next",
23
+ "@twin.org/standards-w3c-did": "next",
24
+ "@twin.org/standards-w3c-odrl": "next"
25
+ },
26
+ "main": "./dist/cjs/index.cjs",
27
+ "module": "./dist/esm/index.mjs",
28
+ "types": "./dist/types/index.d.ts",
29
+ "exports": {
30
+ ".": {
31
+ "types": "./dist/types/index.d.ts",
32
+ "require": "./dist/cjs/index.cjs",
33
+ "import": "./dist/esm/index.mjs"
34
+ },
35
+ "./locales/*.json": "./locales/*.json"
36
+ },
37
+ "files": [
38
+ "dist/cjs",
39
+ "dist/esm",
40
+ "dist/types",
41
+ "locales",
42
+ "docs"
43
+ ]
44
+ }