@twin.org/api-models 0.0.3-next.5 → 0.0.3-next.50

package/docs/reference/interfaces/ITenant.md

@@ -0,0 +1,67 @@
+# Interface: ITenant
+
+Model defining the tenant.
+
+## Properties
+
+### id {#id}
+
+> **id**: `string`
+
+The unique identifier for the tenant.
+
+***
+
+### apiKey {#apikey}
+
+> **apiKey**: `string`
+
+The api key for the tenant.
+
+***
+
+### label {#label}
+
+> **label**: `string`
+
+The label of the tenant.
+
+***
+
+### dateCreated {#datecreated}
+
+> **dateCreated**: `string`
+
+The date the tenant was created.
+
+***
+
+### dateModified {#datemodified}
+
+> **dateModified**: `string`
+
+The date the tenant was modified.
+
+***
+
+### publicOrigin? {#publicorigin}
+
+> `optional` **publicOrigin?**: `string`
+
+The public origin available to the public for accessing the API.
+
+***
+
+### organizationId {#organizationid}
+
+> **organizationId**: `string`
+
+The organization id for the tenant.
+
+***
+
+### organizationIdLegacy? {#organizationidlegacy}
+
+> `optional` **organizationIdLegacy?**: `string`[]
+
+Optional list of organization aliases that can are used for legacy lookups.

package/docs/reference/interfaces/ITenantAdminComponent.md

@@ -0,0 +1,227 @@
+# Interface: ITenantAdminComponent
+
+Configuration for the tenant admin component
+
+## Extends
+
+- `IComponent`
+
+## Methods
+
+### create() {#create}
+
+> **create**(`tenant`): `Promise`\<`string`\>
+
+Create a tenant.
+
+#### Parameters
+
+##### tenant
+
+`Omit`\<[`ITenant`](ITenant.md), `"id"` \| `"dateCreated"` \| `"dateModified"`\> & `object`
+
+The tenant to store.
+
+#### Returns
+
+`Promise`\<`string`\>
+
+The tenant id.
+
+***
+
+### update() {#update}
+
+> **update**(`tenant`): `Promise`\<`void`\>
+
+Update a tenant.
+
+#### Parameters
+
+##### tenant
+
+`Partial`\<`Omit`\<[`ITenant`](ITenant.md), `"dateCreated"` \| `"dateModified"`\>\>
+
+The tenant to update.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+A promise that resolves when the tenant has been updated.
+
+***
+
+### get() {#get}
+
+> **get**(`tenantId`): `Promise`\<[`ITenant`](ITenant.md)\>
+
+Get a tenant by its id.
+
+#### Parameters
+
+##### tenantId
+
+`string`
+
+The id of the tenant.
+
+#### Returns
+
+`Promise`\<[`ITenant`](ITenant.md)\>
+
+The tenant.
+
+#### Throws
+
+Error if the tenant is not found.
+
+***
+
+### getByApiKey() {#getbyapikey}
+
+> **getByApiKey**(`apiKey`): `Promise`\<[`ITenant`](ITenant.md)\>
+
+Get a tenant by its api key.
+
+#### Parameters
+
+##### apiKey
+
+`string`
+
+The api key of the tenant.
+
+#### Returns
+
+`Promise`\<[`ITenant`](ITenant.md)\>
+
+The tenant.
+
+#### Throws
+
+Error if the tenant is not found.
+
+***
+
+### getByPublicOrigin() {#getbypublicorigin}
+
+> **getByPublicOrigin**(`publicOrigin`): `Promise`\<[`ITenant`](ITenant.md)\>
+
+Get a tenant by its public origin.
+
+#### Parameters
+
+##### publicOrigin
+
+`string`
+
+The origin of the tenant.
+
+#### Returns
+
+`Promise`\<[`ITenant`](ITenant.md)\>
+
+The tenant.
+
+#### Throws
+
+Error if the tenant is not found.
+
+***
+
+### remove() {#remove}
+
+> **remove**(`tenantId`): `Promise`\<`void`\>
+
+Remove a tenant by its id.
+
+#### Parameters
+
+##### tenantId
+
+`string`
+
+The id of the tenant.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+A promise that resolves when the tenant has been removed.
+
+#### Throws
+
+Error if the tenant is not found.
+
+***
+
+### getTenantByOrganizationId() {#gettenantbyorganizationid}
+
+> **getTenantByOrganizationId**(`organizationId`, `includeLegacy?`): `Promise`\<[`ITenant`](ITenant.md)\>
+
+Get a tenant by its organization id, optionally searching legacy ids.
+
+#### Parameters
+
+##### organizationId
+
+`string`
+
+The organization id of the tenant.
+
+##### includeLegacy?
+
+`boolean`
+
+Whether to also search the legacy organization id array.
+
+#### Returns
+
+`Promise`\<[`ITenant`](ITenant.md)\>
+
+The tenant.
+
+#### Throws
+
+Error if the tenant is not found.
+
+***
+
+### query() {#query}
+
+> **query**(`conditions?`, `properties?`, `cursor?`, `limit?`): `Promise`\<\{ `tenants`: [`ITenant`](ITenant.md)[]; `cursor?`: `string`; \}\>
+
+Query tenants with pagination.
+
+#### Parameters
+
+##### conditions?
+
+`EntityCondition`\<[`ITenant`](ITenant.md)\>
+
+The conditions to filter the tenants.
+
+##### properties?
+
+keyof [`ITenant`](ITenant.md)[]
+
+The properties to include in the returned tenants.
+
+##### cursor?
+
+`string`
+
+The cursor to start from.
+
+##### limit?
+
+`number`
+
+The maximum number of tenants to return.
+
+#### Returns
+
+`Promise`\<\{ `tenants`: [`ITenant`](ITenant.md)[]; `cursor?`: `string`; \}\>
+
+The tenants and the next cursor if more tenants are available.

package/docs/reference/interfaces/ITooManyRequestsResponse.md

@@ -0,0 +1,19 @@
+# Interface: ITooManyRequestsResponse
+
+The request resulted in too many requests, see the content for more details.
+
+## Properties
+
+### statusCode {#statuscode}
+
+> **statusCode**: `429`
+
+Response status code.
+
+***
+
+### body {#body}
+
+> **body**: `IError`
+
+The body which contains the error.

package/docs/reference/interfaces/IUnauthorizedResponse.md

@@ -4,7 +4,7 @@ You are not authorized to use the API or no credentials were supplied, see the c
 
 ## Properties
 
-### statusCode
+### statusCode {#statuscode}
 
 > **statusCode**: `401`
 
@@ -12,7 +12,7 @@ Response status code.
 
 ***
 
-### body
+### body {#body}
 
 > **body**: `IError`
 

package/docs/reference/interfaces/IUnprocessableEntityResponse.md

@@ -4,7 +4,7 @@ The server cannot process the request, see the content for more details.
 
 ## Properties
 
-### statusCode
+### statusCode {#statuscode}
 
 > **statusCode**: `422`
 
@@ -12,7 +12,7 @@ Response status code.
 
 ***
 
-### body
+### body {#body}
 
 > **body**: `IError`
 

package/docs/reference/interfaces/IWebServer.md

@@ -2,6 +2,10 @@
 
 Interface describing a web server.
 
+## Extends
+
+- `IComponent`
+
 ## Type Parameters
 
 ### T
@@ -10,7 +14,7 @@ Interface describing a web server.
 
 ## Methods
 
-### getInstance()
+### getInstance() {#getinstance}
 
 > **getInstance**(): `T`
 
@@ -24,7 +28,7 @@ The web server instance.
 
 ***
 
-### build()
+### build() {#build}
 
 > **build**(`restRouteProcessors?`, `restRoutes?`, `socketRouteProcessors?`, `socketRoutes?`, `options?`): `Promise`\<`void`\>
 
@@ -66,11 +70,11 @@ Options for building the server.
 
 `Promise`\<`void`\>
 
-Nothing.
+A promise that resolves when the server is fully built and ready to start.
 
 ***
 
-### start()
+### start() {#start}
 
 > **start**(): `Promise`\<`void`\>
 
@@ -80,11 +84,15 @@ Start the server.
 
 `Promise`\<`void`\>
 
-Nothing.
+A promise that resolves when the server is listening for connections.
+
+#### Overrides
+
+`IComponent.start`
 
 ***
 
-### stop()
+### stop() {#stop}
 
 > **stop**(): `Promise`\<`void`\>
 
@@ -94,4 +102,26 @@ Stop the server.
 
 `Promise`\<`void`\>
 
-Nothing.
+A promise that resolves when the server has shut down all connections.
+
+#### Overrides
+
+`IComponent.stop`
+
+***
+
+### health() {#health}
+
+> **health**(): `Promise`\<`IHealth`[]\>
+
+Returns the health status of the component.
+
+#### Returns
+
+`Promise`\<`IHealth`[]\>
+
+The health status of the component, can return multiple entries for elements within the component.
+
+#### Overrides
+
+`IComponent.health`

package/docs/reference/interfaces/IWebServerOptions.md

@@ -4,9 +4,9 @@ Options for the web server.
 
 ## Properties
 
-### port?
+### port? {#port}
 
-> `optional` **port**: `number`
+> `optional` **port?**: `number`
 
 The port to bind the web server to.
 
@@ -18,9 +18,9 @@ The port to bind the web server to.
 
 ***
 
-### host?
+### host? {#host}
 
-> `optional` **host**: `string`
+> `optional` **host?**: `string`
 
 The address to bind the web server to.
 
@@ -32,9 +32,9 @@ localhost
 
 ***
 
-### methods?
+### methods? {#methods}
 
-> `optional` **methods**: `HttpMethod`[]
+> `optional` **methods?**: `HttpMethod`[]
 
 The methods that the server accepts.
 
@@ -46,25 +46,25 @@ The methods that the server accepts.
 
 ***
 
-### allowedHeaders?
+### allowedHeaders? {#allowedheaders}
 
-> `optional` **allowedHeaders**: `string`[]
+> `optional` **allowedHeaders?**: `string`[]
 
 Any additional allowed headers.
 
 ***
 
-### exposedHeaders?
+### exposedHeaders? {#exposedheaders}
 
-> `optional` **exposedHeaders**: `string`[]
+> `optional` **exposedHeaders?**: `string`[]
 
 And additional exposed headers.
 
 ***
 
-### corsOrigins?
+### corsOrigins? {#corsorigins}
 
-> `optional` **corsOrigins**: `string` \| `string`[]
+> `optional` **corsOrigins?**: `string` \| `string`[]
 
 The allowed CORS domains.
 
@@ -73,3 +73,12 @@ The allowed CORS domains.
 ```ts
 ["*"]
 ```
+
+***
+
+### publicOrigin? {#publicorigin}
+
+> `optional` **publicOrigin?**: `string`
+
+The public origin of the server, used for constructing the request URL.
+If not provided, it will be determined from the incoming request.

package/docs/reference/type-aliases/HttpContextIdKeys.md

@@ -0,0 +1,5 @@
+# Type Alias: HttpContextIdKeys
+
+> **HttpContextIdKeys** = *typeof* [`HttpContextIdKeys`](../variables/HttpContextIdKeys.md)\[keyof *typeof* [`HttpContextIdKeys`](../variables/HttpContextIdKeys.md)\]
+
+HTTP definition of some context keys.

package/docs/reference/variables/HttpContextIdKeys.md

@@ -0,0 +1,37 @@
+# Variable: HttpContextIdKeys
+
+> `const` **HttpContextIdKeys**: `object`
+
+HTTP definition of some context keys.
+
+## Type Declaration
+
+### IpAddress {#ipaddress}
+
+> `readonly` **IpAddress**: `"ipAddress"` = `"ipAddress"`
+
+IP address of the client.
+
+### UserAgent {#useragent}
+
+> `readonly` **UserAgent**: `"userAgent"` = `"userAgent"`
+
+User agent of the client.
+
+### CorrelationId {#correlationid}
+
+> `readonly` **CorrelationId**: `"correlationId"` = `"correlationId"`
+
+Correlation ID of the request.
+
+### PublicOrigin {#publicorigin}
+
+> `readonly` **PublicOrigin**: `"publicOrigin"` = `"publicOrigin"`
+
+Public Origin of the request.
+
+### LocalOrigin {#localorigin}
+
+> `readonly` **LocalOrigin**: `"localOrigin"` = `"localOrigin"`
+
+Local Origin of the request.

package/package.json

@@ -1,10 +1,10 @@
 {
 	"name": "@twin.org/api-models",
-	"version": "0.0.3-next.5",
-	"description": "Contains models and classes for use with APIs",
+	"version": "0.0.3-next.50",
+	"description": "Shared API contracts, route types, and response models used across services and clients.",
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/twinfoundation/api.git",
+		"url": "git+https://github.com/iotaledger/twin-api.git",
 		"directory": "packages/api-models"
 	},
 	"author": "martyn.janes@iota.org",
@@ -16,6 +16,7 @@
 	"dependencies": {
 		"@twin.org/context": "next",
 		"@twin.org/core": "next",
+		"@twin.org/entity": "next",
 		"@twin.org/nameof": "next",
 		"@twin.org/web": "next"
 	},
@@ -47,7 +48,7 @@
 		"schemas"
 	],
 	"bugs": {
-		"url": "git+https://github.com/twinfoundation/api/issues"
+		"url": "git+https://github.com/iotaledger/twin-api/issues"
 	},
 	"homepage": "https://twindev.org"
 }

package/dist/es/factories/authenticationGeneratorFactory.js

@@ -1,9 +0,0 @@
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-import { Factory } from "@twin.org/core";
-/**
- * Factory for creating implementation of authentication generator types.
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-export const AuthenticationGeneratorFactory = Factory.createFactory("authentication-generator");
-//# sourceMappingURL=authenticationGeneratorFactory.js.map

package/dist/es/factories/authenticationGeneratorFactory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"authenticationGeneratorFactory.js","sourceRoot":"","sources":["../../../src/factories/authenticationGeneratorFactory.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC;;GAEG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,8BAA8B,GAAG,OAAO,CAAC,aAAa,CAClE,0BAA0B,CAC1B,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { Factory } from \"@twin.org/core\";\nimport type { IAuthenticationGenerator } from \"../models/client/IAuthenticationGenerator.js\";\n\n/**\n * Factory for creating implementation of authentication generator types.\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const AuthenticationGeneratorFactory = Factory.createFactory<IAuthenticationGenerator>(\n\t\"authentication-generator\"\n);\n"]}

package/dist/es/models/client/IAuthenticationGenerator.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=IAuthenticationGenerator.js.map

package/dist/es/models/client/IAuthenticationGenerator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IAuthenticationGenerator.js","sourceRoot":"","sources":["../../../../src/models/client/IAuthenticationGenerator.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type { IHttpHeaders } from \"@twin.org/web\";\n\n/**\n * Definition for the authentication generator component.\n */\nexport interface IAuthenticationGenerator extends IComponent {\n\t/**\n\t * Adds authentication information to the request headers.\n\t * @param requestHeaders The request headers to add authentication information to.\n\t * @param authData Optional authentication data passed from the request.\n\t * @returns A promise that resolves when the authentication information has been added.\n\t */\n\taddAuthentication(requestHeaders: IHttpHeaders, authData?: unknown): Promise<void>;\n}\n"]}

package/dist/es/models/services/IHealthInfo.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=IHealthInfo.js.map

package/dist/es/models/services/IHealthInfo.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IHealthInfo.js","sourceRoot":"","sources":["../../../../src/models/services/IHealthInfo.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { HealthStatus } from \"./healthStatus.js\";\n\n/**\n * The status of the server.\n */\nexport interface IHealthInfo {\n\t/**\n\t * The status.\n\t */\n\tstatus: HealthStatus;\n\n\t/**\n\t * The status of the components.\n\t */\n\tcomponents?: {\n\t\t/**\n\t\t * The name of the component.\n\t\t */\n\t\tname: string;\n\n\t\t/**\n\t\t * The status of the component.\n\t\t */\n\t\tstatus: HealthStatus;\n\n\t\t/**\n\t\t * The details for the status.\n\t\t */\n\t\tdetails?: string;\n\t}[];\n}\n"]}

package/dist/es/models/services/healthStatus.js

@@ -1,21 +0,0 @@
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * The health status of the component.
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-export const HealthStatus = {
-    /**
-     * OK.
-     */
-    Ok: "ok",
-    /**
-     * Warning.
-     */
-    Warning: "warning",
-    /**
-     * Error.
-     */
-    Error: "error"
-};
-//# sourceMappingURL=healthStatus.js.map

package/dist/es/models/services/healthStatus.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"healthStatus.js","sourceRoot":"","sources":["../../../../src/models/services/healthStatus.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AAEvC;;GAEG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B;;OAEG;IACH,EAAE,EAAE,IAAI;IAER;;OAEG;IACH,OAAO,EAAE,SAAS;IAElB;;OAEG;IACH,KAAK,EAAE,OAAO;CACL,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * The health status of the component.\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const HealthStatus = {\n\t/**\n\t * OK.\n\t */\n\tOk: \"ok\",\n\n\t/**\n\t * Warning.\n\t */\n\tWarning: \"warning\",\n\n\t/**\n\t * Error.\n\t */\n\tError: \"error\"\n} as const;\n\n/**\n * The health status of the component.\n */\nexport type HealthStatus = (typeof HealthStatus)[keyof typeof HealthStatus];\n"]}

package/dist/types/factories/authenticationGeneratorFactory.d.ts

@@ -1,6 +0,0 @@
-import { Factory } from "@twin.org/core";
-import type { IAuthenticationGenerator } from "../models/client/IAuthenticationGenerator.js";
-/**
- * Factory for creating implementation of authentication generator types.
- */
-export declare const AuthenticationGeneratorFactory: Factory<IAuthenticationGenerator>;

package/dist/types/models/client/IAuthenticationGenerator.d.ts

@@ -1,14 +0,0 @@
-import type { IComponent } from "@twin.org/core";
-import type { IHttpHeaders } from "@twin.org/web";
-/**
- * Definition for the authentication generator component.
- */
-export interface IAuthenticationGenerator extends IComponent {
-    /**
-     * Adds authentication information to the request headers.
-     * @param requestHeaders The request headers to add authentication information to.
-     * @param authData Optional authentication data passed from the request.
-     * @returns A promise that resolves when the authentication information has been added.
-     */
-    addAuthentication(requestHeaders: IHttpHeaders, authData?: unknown): Promise<void>;
-}