@twin.org/api-service 0.0.3-next.28 → 0.0.3-next.30

package/docs/reference/classes/UrlTransformerService.md

@@ -0,0 +1,321 @@
+# Class: UrlTransformerService
+
+The URL transformer service for encrypting and decrypting URL parameters.
+
+## Implements
+
+- `IUrlTransformerComponent`
+
+## Constructors
+
+### Constructor
+
+> **new UrlTransformerService**(`options?`): `UrlTransformerService`
+
+Create a new instance of UrlTransformerService.
+
+#### Parameters
+
+##### options?
+
+[`IUrlTransformerServiceConstructorOptions`](../interfaces/IUrlTransformerServiceConstructorOptions.md)
+
+The options to create the service.
+
+#### Returns
+
+`UrlTransformerService`
+
+## Properties
+
+### CLASS\_NAME {#class_name}
+
+> `readonly` `static` **CLASS\_NAME**: `string`
+
+Runtime name for the class.
+
+## Methods
+
+### className() {#classname}
+
+> **className**(): `string`
+
+Returns the class name of the component.
+
+#### Returns
+
+`string`
+
+The class name of the component.
+
+#### Implementation of
+
+`IUrlTransformerComponent.className`
+
+***
+
+### start() {#start}
+
+> **start**(): `Promise`\<`void`\>
+
+The component needs to be started when the node is initialized.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Nothing.
+
+#### Implementation of
+
+`IUrlTransformerComponent.start`
+
+***
+
+### addEncryptedQueryParamToUrl() {#addencryptedqueryparamtourl}
+
+> **addEncryptedQueryParamToUrl**(`url`, `id`, `value`): `Promise`\<`string`\>
+
+Encrypt a named token value and append it as a query parameter to the given URL.
+
+#### Parameters
+
+##### url
+
+`string`
+
+The URL to append the encrypted token to.
+
+##### id
+
+`string`
+
+The logical token identifier (e.g. "tenant").
+
+##### value
+
+`string`
+
+The value to encrypt and add.
+
+#### Returns
+
+`Promise`\<`string`\>
+
+The URL with the encrypted token added as a query parameter.
+
+#### Implementation of
+
+`IUrlTransformerComponent.addEncryptedQueryParamToUrl`
+
+***
+
+### getEncryptedQueryParam() {#getencryptedqueryparam}
+
+> **getEncryptedQueryParam**(`queryParams`, `id`): `Promise`\<`string` \| `undefined`\>
+
+Get a named token value from the query parameters.
+
+#### Parameters
+
+##### queryParams
+
+`IHttpRequestQuery` \| `undefined`
+
+The HTTP request query containing the parameters.
+
+##### id
+
+`string`
+
+The logical token identifier (e.g. "tenant").
+
+#### Returns
+
+`Promise`\<`string` \| `undefined`\>
+
+The decrypted token value if it exists.
+
+#### Implementation of
+
+`IUrlTransformerComponent.getEncryptedQueryParam`
+
+***
+
+### addEncryptedParamsToUrl() {#addencryptedparamstourl}
+
+> **addEncryptedParamsToUrl**(`url`, `params`): `Promise`\<`string`\>
+
+Add encrypted key/value pairs to a URL's query string.
+
+#### Parameters
+
+##### url
+
+`string`
+
+The base URL to add parameters to.
+
+##### params
+
+`IHttpRequestQuery`
+
+The key/value pairs to encrypt and append.
+
+#### Returns
+
+`Promise`\<`string`\>
+
+The URL with the encrypted parameters added.
+
+#### Implementation of
+
+`IUrlTransformerComponent.addEncryptedParamsToUrl`
+
+***
+
+### getDecryptedParamsFromQueryParams() {#getdecryptedparamsfromqueryparams}
+
+> **getDecryptedParamsFromQueryParams**(`queryParams`, `keys`): `Promise`\<`IHttpRequestQuery`\>
+
+Decrypt specified keys from a query parameter object and return their plain-text values.
+
+#### Parameters
+
+##### queryParams
+
+`IHttpRequestQuery` \| `undefined`
+
+The HTTP request query containing the encrypted parameters.
+
+##### keys
+
+`string`[]
+
+The keys to decrypt.
+
+#### Returns
+
+`Promise`\<`IHttpRequestQuery`\>
+
+A map of the decrypted key/value pairs that were present.
+
+#### Implementation of
+
+`IUrlTransformerComponent.getDecryptedParamsFromQueryParams`
+
+***
+
+### encryptQueryParams() {#encryptqueryparams}
+
+> **encryptQueryParams**(`httpRequestQuery`, `keys`): `Promise`\<`void`\>
+
+Encrypt query parameters.
+
+#### Parameters
+
+##### httpRequestQuery
+
+`IHttpRequestQuery` \| `undefined`
+
+The HTTP request query containing the parameters to encrypt.
+
+##### keys
+
+`string`[]
+
+The keys of the parameters to encrypt.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+A promise that resolves when the query parameters have been encrypted.
+
+#### Implementation of
+
+`IUrlTransformerComponent.encryptQueryParams`
+
+***
+
+### decryptQueryParams() {#decryptqueryparams}
+
+> **decryptQueryParams**(`httpRequestQuery`, `keys`): `Promise`\<`void`\>
+
+Decrypt query parameters.
+
+#### Parameters
+
+##### httpRequestQuery
+
+`IHttpRequestQuery` \| `undefined`
+
+The HTTP request query containing the encrypted values.
+
+##### keys
+
+`string`[]
+
+The keys of the parameters to decrypt.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+A promise that resolves when the query parameters have been decrypted.
+
+#### Implementation of
+
+`IUrlTransformerComponent.decryptQueryParams`
+
+***
+
+### encryptParam() {#encryptparam}
+
+> **encryptParam**(`paramValue`): `Promise`\<`string`\>
+
+Encrypt a parameter value.
+
+#### Parameters
+
+##### paramValue
+
+`string`
+
+The value of the parameter to encrypt.
+
+#### Returns
+
+`Promise`\<`string`\>
+
+A promise that resolves to the encrypted value of the parameter.
+
+#### Implementation of
+
+`IUrlTransformerComponent.encryptParam`
+
+***
+
+### decryptParam() {#decryptparam}
+
+> **decryptParam**(`encryptedValue`): `Promise`\<`string`\>
+
+Decrypt a parameter value.
+
+#### Parameters
+
+##### encryptedValue
+
+`string`
+
+The encrypted value of the parameter.
+
+#### Returns
+
+`Promise`\<`string`\>
+
+A promise that resolves to the decrypted value of the parameter.
+
+#### Implementation of
+
+`IUrlTransformerComponent.decryptParam`

package/docs/reference/functions/generateRestRoutesHealth.md

@@ -0,0 +1,25 @@
+# Function: generateRestRoutesHealth()
+
+> **generateRestRoutesHealth**(`baseRouteName`, `componentName`): `IRestRoute`\<`any`, `any`\>[]
+
+The REST routes for server health.
+
+## Parameters
+
+### baseRouteName
+
+`string`
+
+Prefix to prepend to the paths.
+
+### componentName
+
+`string`
+
+The name of the component to use in the routes stored in the ComponentFactory.
+
+## Returns
+
+`IRestRoute`\<`any`, `any`\>[]
+
+The generated routes.

package/docs/reference/functions/serverReadyz.md

@@ -0,0 +1,31 @@
+# Function: serverReadyz()
+
+> **serverReadyz**(`httpRequestContext`, `componentName`, `request`): `Promise`\<`IServerReadyzResponse`\>
+
+Get the readyz for the server.
+
+## Parameters
+
+### httpRequestContext
+
+`IHttpRequestContext`
+
+The request context for the API.
+
+### componentName
+
+`string`
+
+The name of the component to use in the routes.
+
+### request
+
+`INoContentRequest`
+
+The request.
+
+## Returns
+
+`Promise`\<`IServerReadyzResponse`\>
+
+The response object with additional http response properties.

package/docs/reference/index.md

@@ -2,27 +2,36 @@
 
 ## Classes
 
+- [HealthService](classes/HealthService.md)
 - [HostingService](classes/HostingService.md)
 - [InformationService](classes/InformationService.md)
+- [UrlTransformerService](classes/UrlTransformerService.md)
 
 ## Interfaces
 
+- [IHealthServiceConfig](interfaces/IHealthServiceConfig.md)
+- [IHealthServiceConstructorOptions](interfaces/IHealthServiceConstructorOptions.md)
 - [IHostingServiceConfig](interfaces/IHostingServiceConfig.md)
 - [IHostingServiceConstructorOptions](interfaces/IHostingServiceConstructorOptions.md)
 - [IInformationServiceConfig](interfaces/IInformationServiceConfig.md)
 - [IInformationServiceConstructorOptions](interfaces/IInformationServiceConstructorOptions.md)
+- [IUrlTransformerServiceConfig](interfaces/IUrlTransformerServiceConfig.md)
+- [IUrlTransformerServiceConstructorOptions](interfaces/IUrlTransformerServiceConstructorOptions.md)
 
 ## Variables
 
+- [tagsHealth](variables/tagsHealth.md)
 - [tagsInformation](variables/tagsInformation.md)
 - [restEntryPoints](variables/restEntryPoints.md)
 
 ## Functions
 
+- [generateRestRoutesHealth](functions/generateRestRoutesHealth.md)
+- [serverHealth](functions/serverHealth.md)
 - [generateRestRoutesInformation](functions/generateRestRoutesInformation.md)
 - [serverRoot](functions/serverRoot.md)
 - [serverInfo](functions/serverInfo.md)
 - [serverLivez](functions/serverLivez.md)
-- [serverHealth](functions/serverHealth.md)
+- [serverReadyz](functions/serverReadyz.md)
 - [serverFavIcon](functions/serverFavIcon.md)
 - [serverSpec](functions/serverSpec.md)

package/docs/reference/interfaces/IHealthServiceConfig.md

@@ -0,0 +1,17 @@
+# Interface: IHealthServiceConfig
+
+Configuration for the health service.
+
+## Properties
+
+### healthCheckInterval? {#healthcheckinterval}
+
+> `optional` **healthCheckInterval?**: `number`
+
+The interval for checking the health of the components and setting it in the health service.
+
+#### Default
+
+```ts
+30000
+```

package/docs/reference/interfaces/IHealthServiceConstructorOptions.md

@@ -0,0 +1,11 @@
+# Interface: IHealthServiceConstructorOptions
+
+Options for the HealthService constructor.
+
+## Properties
+
+### config? {#config}
+
+> `optional` **config?**: [`IHealthServiceConfig`](IHealthServiceConfig.md)
+
+The configuration for the service.

package/docs/reference/interfaces/IHostingServiceConstructorOptions.md

@@ -1,6 +1,6 @@
 # Interface: IHostingServiceConstructorOptions
 
-Options for the IHostingService constructor.
+Options for the HostingService constructor.
 
 ## Properties
 

package/docs/reference/interfaces/IUrlTransformerServiceConfig.md

@@ -0,0 +1,32 @@
+# Interface: IUrlTransformerServiceConfig
+
+Configuration for the URL transformer service.
+
+## Properties
+
+### paramEncryptionKeyName? {#paramencryptionkeyname}
+
+> `optional` **paramEncryptionKeyName?**: `string`
+
+The name of the key to retrieve from the vault for encryption/decryption of parameters.
+
+#### Default
+
+```ts
+param-encryption
+```
+
+***
+
+### queryParamNames? {#queryparamnames}
+
+> `optional` **queryParamNames?**: `object`
+
+A dictionary mapping logical token identifiers to their URL query parameter names.
+For example: { "tenant": "tenant-token" } maps the logical id "tenant" to the
+query param "tenant-token". When an id is not present the id itself is used as
+the param name.
+
+#### Index Signature
+
+\[`id`: `string`\]: `string`

package/docs/reference/interfaces/IUrlTransformerServiceConstructorOptions.md

@@ -0,0 +1,25 @@
+# Interface: IUrlTransformerServiceConstructorOptions
+
+Options for the UrlTransformerService constructor.
+
+## Properties
+
+### vaultConnectorType? {#vaultconnectortype}
+
+> `optional` **vaultConnectorType?**: `string`
+
+The vault connector type.
+
+#### Default
+
+```ts
+vault
+```
+
+***
+
+### config? {#config}
+
+> `optional` **config?**: [`IUrlTransformerServiceConfig`](IUrlTransformerServiceConfig.md)
+
+The configuration for the service.

package/docs/reference/variables/tagsHealth.md

@@ -0,0 +1,5 @@
+# Variable: tagsHealth
+
+> `const` **tagsHealth**: `ITag`[]
+
+The tag to associate with the routes.

package/locales/en.json

@@ -1 +1,13 @@
-{}
+{
+	"error": {
+		"urlTransformerService": {
+			"encryptionUnavailable": "Encryption is unavailable because no nodeId is configured",
+			"decryptionUnavailable": "Decryption is unavailable because no nodeId is configured",
+			"encryptionFailed": "An error occurred during encryption",
+			"decryptionFailed": "An error occurred during decryption"
+		},
+		"healthService": {
+			"componentHealthCheckFailed": "Health check failed for component \"{className}\""
+		}
+	}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/api-service",
-	"version": "0.0.3-next.28",
+	"version": "0.0.3-next.30",
 	"description": "Information and hosting service implementations with generated REST route handlers.",
 	"repository": {
 		"type": "git",
@@ -14,10 +14,13 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@twin.org/api-models": "0.0.3-next.28",
+		"@twin.org/api-models": "0.0.3-next.30",
 		"@twin.org/context": "next",
 		"@twin.org/core": "next",
+		"@twin.org/engine-models": "next",
+		"@twin.org/logging-models": "next",
 		"@twin.org/nameof": "next",
+		"@twin.org/vault-models": "next",
 		"@twin.org/web": "next"
 	},
 	"main": "./dist/es/index.js",