@twin.org/api-rest-client 0.0.3-next.9 → 0.9.0

package/docs/examples.md

@@ -1 +1,64 @@
-# @twin.org/api-rest-client - Examples
+# Rest Client Examples
+
+Use these snippets to call health, metadata, and specification endpoints from operational tools and integration tests.
+
+## InformationRestClient
+
+```typescript
+import { InformationRestClient } from '@twin.org/api-rest-client';
+
+const client = new InformationRestClient({
+  endpoint: 'https://api.example.org',
+  pathPrefix: 'v1'
+});
+
+console.log(client.className()); // InformationRestClient
+
+const root = await client.root();
+const info = await client.info();
+const icon = await client.favicon();
+
+console.log(root); // twin-api - 1.2.0
+console.log(info.version); // 1.2.0
+console.log((icon?.byteLength ?? 0) > 0); // true
+```
+
+```typescript
+import { InformationRestClient } from '@twin.org/api-rest-client';
+
+const client = new InformationRestClient({
+  endpoint: 'https://api.example.org',
+  pathPrefix: 'v1'
+});
+
+const openApi = await client.spec();
+const live = await client.livez();
+const health = await client.health();
+
+console.log(typeof openApi); // object
+console.log(live); // true
+console.log(health.status); // ok
+```
+
+```typescript
+import { InformationRestClient } from '@twin.org/api-rest-client';
+
+const client = new InformationRestClient({
+  endpoint: 'https://api.example.org',
+  pathPrefix: 'v1'
+});
+
+try {
+  await client.setComponentHealth('database', 'ok');
+} catch (err) {
+  const errorName = err instanceof Error ? err.name : 'Error';
+  console.log(errorName); // NotSupportedError
+}
+
+try {
+  await client.removeComponentHealth('database');
+} catch (err) {
+  const errorName = err instanceof Error ? err.name : 'Error';
+  console.log(errorName); // NotSupportedError
+}
+```

package/docs/reference/classes/HealthRestClient.md

@@ -0,0 +1,145 @@
+# Class: HealthRestClient
+
+The client to connect to the health service.
+
+## Extends
+
+- `BaseRestClient`
+
+## Implements
+
+- `IHealthComponent`
+
+## Constructors
+
+### Constructor
+
+> **new HealthRestClient**(`config`): `HealthRestClient`
+
+Create a new instance of HealthRestClient.
+
+#### Parameters
+
+##### config
+
+`IBaseRestClientConfig`
+
+The configuration for the client.
+
+#### Returns
+
+`HealthRestClient`
+
+#### Overrides
+
+`BaseRestClient.constructor`
+
+## Properties
+
+### CLASS\_NAME {#class_name}
+
+> `readonly` `static` **CLASS\_NAME**: `string`
+
+Runtime name for the class.
+
+## Methods
+
+### getEndpointWithPrefix() {#getendpointwithprefix}
+
+> **getEndpointWithPrefix**(): `string`
+
+Get the endpoint with the prefix for the namespace.
+
+#### Returns
+
+`string`
+
+The endpoint with namespace prefix attached.
+
+#### Inherited from
+
+`BaseRestClient.getEndpointWithPrefix`
+
+***
+
+### fetch() {#fetch}
+
+> **fetch**\<`T`, `U`\>(`route`, `method`, `request?`): `Promise`\<`U`\>
+
+Perform a request in json format.
+
+#### Type Parameters
+
+##### T
+
+`T` *extends* `IHttpRequest`\<`any`\>
+
+##### U
+
+`U` *extends* `IHttpResponse`\<`any`\>
+
+#### Parameters
+
+##### route
+
+`string`
+
+The route of the request.
+
+##### method
+
+`HttpMethod`
+
+The http method.
+
+##### request?
+
+`T`
+
+Request to send to the endpoint.
+
+#### Returns
+
+`Promise`\<`U`\>
+
+The response.
+
+#### Inherited from
+
+`BaseRestClient.fetch`
+
+***
+
+### className() {#classname}
+
+> **className**(): `string`
+
+Returns the class name of the component.
+
+#### Returns
+
+`string`
+
+The class name of the component.
+
+#### Implementation of
+
+`IHealthComponent.className`
+
+***
+
+### healthStatus() {#healthstatus}
+
+> **healthStatus**(): `Promise`\<\{ `status`: `HealthStatus`; `components`: `IHealth`[]; \}\>
+
+Get the server health.
+
+#### Returns
+
+`Promise`\<\{ `status`: `HealthStatus`; `components`: `IHealth`[]; \}\>
+
+The service health.
+
+#### Implementation of
+
+`IHealthComponent.healthStatus`

package/docs/reference/classes/InformationRestClient.md

@@ -36,7 +36,7 @@ The configuration for the client.
 
 ## Properties
 
-### CLASS\_NAME
+### CLASS\_NAME {#class_name}
 
 > `readonly` `static` **CLASS\_NAME**: `string`
 
@@ -44,190 +44,192 @@ Runtime name for the class.
 
 ## Methods
 
-### className()
+### getEndpointWithPrefix() {#getendpointwithprefix}
 
-> **className**(): `string`
+> **getEndpointWithPrefix**(): `string`
 
-Returns the class name of the component.
+Get the endpoint with the prefix for the namespace.
 
 #### Returns
 
 `string`
 
-The class name of the component.
+The endpoint with namespace prefix attached.
 
-#### Implementation of
+#### Inherited from
 
-`IInformationComponent.className`
+`BaseRestClient.getEndpointWithPrefix`
 
 ***
 
-### root()
+### fetch() {#fetch}
 
-> **root**(): `Promise`\<`string`\>
+> **fetch**\<`T`, `U`\>(`route`, `method`, `request?`): `Promise`\<`U`\>
 
-Get the server root.
+Perform a request in json format.
 
-#### Returns
+#### Type Parameters
 
-`Promise`\<`string`\>
+##### T
 
-The root root.
+`T` *extends* `IHttpRequest`\<`any`\>
 
-#### Implementation of
+##### U
 
-`IInformationComponent.root`
+`U` *extends* `IHttpResponse`\<`any`\>
 
-***
+#### Parameters
 
-### info()
+##### route
 
-> **info**(): `Promise`\<`IServerInfo`\>
+`string`
 
-Get the server information.
+The route of the request.
+
+##### method
+
+`HttpMethod`
+
+The http method.
+
+##### request?
+
+`T`
+
+Request to send to the endpoint.
 
 #### Returns
 
-`Promise`\<`IServerInfo`\>
+`Promise`\<`U`\>
 
-The service information.
+The response.
 
-#### Implementation of
+#### Inherited from
 
-`IInformationComponent.info`
+`BaseRestClient.fetch`
 
 ***
 
-### favicon()
+### className() {#classname}
 
-> **favicon**(): `Promise`\<`Uint8Array`\<`ArrayBufferLike`\> \| `undefined`\>
+> **className**(): `string`
 
-Get the favicon.
+Returns the class name of the component.
 
 #### Returns
 
-`Promise`\<`Uint8Array`\<`ArrayBufferLike`\> \| `undefined`\>
+`string`
 
-The favicon.
+The class name of the component.
 
 #### Implementation of
 
-`IInformationComponent.favicon`
+`IInformationComponent.className`
 
 ***
 
-### spec()
+### root() {#root}
 
-> **spec**(): `Promise`\<`unknown`\>
+> **root**(): `Promise`\<`string`\>
 
-Get the OpenAPI spec.
+Get the server root.
 
 #### Returns
 
-`Promise`\<`unknown`\>
+`Promise`\<`string`\>
 
-The OpenAPI spec.
+The root text page content.
 
 #### Implementation of
 
-`IInformationComponent.spec`
+`IInformationComponent.root`
 
 ***
 
-### livez()
+### info() {#info}
 
-> **livez**(): `Promise`\<`boolean`\>
+> **info**(): `Promise`\<`IServerInfo`\>
 
-Is the server live.
+Get the server information.
 
 #### Returns
 
-`Promise`\<`boolean`\>
+`Promise`\<`IServerInfo`\>
 
-True if the server is live.
+The service information.
 
 #### Implementation of
 
-`IInformationComponent.livez`
+`IInformationComponent.info`
 
 ***
 
-### health()
+### favicon() {#favicon}
 
-> **health**(): `Promise`\<`IHealthInfo`\>
+> **favicon**(): `Promise`\<`Uint8Array`\<`ArrayBufferLike`\> \| `undefined`\>
 
-Get the server health.
+Get the favicon.
 
 #### Returns
 
-`Promise`\<`IHealthInfo`\>
+`Promise`\<`Uint8Array`\<`ArrayBufferLike`\> \| `undefined`\>
 
-The service health.
+The favicon.
 
 #### Implementation of
 
-`IInformationComponent.health`
+`IInformationComponent.favicon`
 
 ***
 
-### setComponentHealth()
-
-> **setComponentHealth**(`name`, `status`, `details?`): `Promise`\<`void`\>
+### spec() {#spec}
 
-Set the status of a component.
+> **spec**(): `Promise`\<`unknown`\>
 
-#### Parameters
+Get the OpenAPI spec.
 
-##### name
+#### Returns
 
-`string`
+`Promise`\<`unknown`\>
 
-The component name.
+The OpenAPI spec.
 
-##### status
+#### Implementation of
 
-`HealthStatus`
+`IInformationComponent.spec`
 
-The status of the component.
+***
 
-##### details?
+### livez() {#livez}
 
-`string`
+> **livez**(): `Promise`\<\{ `status`: `"alive"` \| `"dead"`; \}\>
 
-The details for the status.
+Is the server live.
 
 #### Returns
 
-`Promise`\<`void`\>
+`Promise`\<\{ `status`: `"alive"` \| `"dead"`; \}\>
 
-Nothing.
+The liveness status of the server.
 
 #### Implementation of
 
-`IInformationComponent.setComponentHealth`
+`IInformationComponent.livez`
 
 ***
 
-### removeComponentHealth()
-
-> **removeComponentHealth**(`name`): `Promise`\<`void`\>
-
-Remove the status of a component.
+### readyz() {#readyz}
 
-#### Parameters
-
-##### name
-
-`string`
+> **readyz**(): `Promise`\<\{ `status`: `"ready"` \| `"not ready"`; \}\>
 
-The component name.
+Is the server ready.
 
 #### Returns
 
-`Promise`\<`void`\>
+`Promise`\<\{ `status`: `"ready"` \| `"not ready"`; \}\>
 
-Nothing.
+The readiness status of the server.
 
 #### Implementation of
 
-`IInformationComponent.removeComponentHealth`
+`IInformationComponent.readyz`

package/docs/reference/index.md

@@ -2,4 +2,5 @@
 
 ## Classes
 
+- [HealthRestClient](classes/HealthRestClient.md)
 - [InformationRestClient](classes/InformationRestClient.md)

package/locales/en.json

@@ -1,7 +1 @@
-{
-	"error": {
-		"informationRestClient": {
-			"notSupportedOnClient": "The method \"{methodName}\" is not supported on the REST client, it can only be used on a server side component"
-		}
-	}
-}
+{}

package/package.json

@@ -1,10 +1,10 @@
 {
 	"name": "@twin.org/api-rest-client",
-	"version": "0.0.3-next.9",
-	"description": "Information contract implementation which can connect to REST endpoints",
+	"version": "0.9.0",
+	"description": "REST client implementation for consuming information and hosting endpoints.",
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/twinfoundation/api.git",
+		"url": "git+https://github.com/iotaledger/twin-api.git",
 		"directory": "packages/api-rest-client"
 	},
 	"author": "martyn.janes@iota.org",
@@ -14,11 +14,11 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@twin.org/api-core": "0.0.3-next.9",
-		"@twin.org/api-models": "0.0.3-next.9",
-		"@twin.org/core": "next",
-		"@twin.org/nameof": "next",
-		"@twin.org/web": "next"
+		"@twin.org/api-core": "^0.9.0",
+		"@twin.org/api-models": "^0.9.0",
+		"@twin.org/core": "^0.9.0",
+		"@twin.org/nameof": "^0.9.0",
+		"@twin.org/web": "^0.9.0"
 	},
 	"main": "./dist/es/index.js",
 	"types": "./dist/types/index.d.ts",
@@ -44,7 +44,7 @@
 		"api"
 	],
 	"bugs": {
-		"url": "git+https://github.com/twinfoundation/api/issues"
+		"url": "git+https://github.com/iotaledger/twin-api/issues"
 	},
 	"homepage": "https://twindev.org"
 }