@twin.org/api-models 0.0.2-next.9 → 0.0.3-next.10

package/dist/cjs/index.cjs

@@ -1,154 +0,0 @@
-'use strict';
-
-var core = require('@twin.org/core');
-var web = require('@twin.org/web');
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Factory for creating implementation of mime type processor types.
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-const MimeTypeProcessorFactory = core.Factory.createFactory("mime-type-processor");
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Factory for creating implementation of REST route processor types.
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-const RestRouteProcessorFactory = core.Factory.createFactory("rest-route-processor");
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Factory for creating implementation of socket route processor types.
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-const SocketRouteProcessorFactory = core.Factory.createFactory("socket-route-processor");
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Class to help with processing http errors.
- */
-class HttpErrorHelper {
-    /**
-     * Process the errors from the routes.
-     * @param err The error to process.
-     * @param includeStack Should the stack be included in the error.
-     * @returns The status code and additional error data.
-     */
-    static processError(err, includeStack) {
-        const error = core.BaseError.fromError(err);
-        // If the error or any of its sub errors are of the specific
-        // types then set the http response code accordingly
-        const flattened = core.BaseError.flatten(error);
-        let httpStatusCode = web.HttpStatusCode.internalServerError;
-        if (flattened.some(e => core.BaseError.isErrorName(e, core.GuardError.CLASS_NAME)) ||
-            flattened.some(e => core.BaseError.isErrorName(e, core.ValidationError.CLASS_NAME))) {
-            httpStatusCode = web.HttpStatusCode.badRequest;
-        }
-        else if (flattened.some(e => core.BaseError.isErrorName(e, core.ConflictError.CLASS_NAME)) ||
-            flattened.some(e => core.BaseError.isErrorName(e, core.AlreadyExistsError.CLASS_NAME))) {
-            httpStatusCode = web.HttpStatusCode.conflict;
-        }
-        else if (flattened.some(e => core.BaseError.isErrorName(e, core.NotFoundError.CLASS_NAME))) {
-            httpStatusCode = web.HttpStatusCode.notFound;
-        }
-        else if (flattened.some(e => core.BaseError.isErrorName(e, core.UnauthorizedError.CLASS_NAME))) {
-            httpStatusCode = web.HttpStatusCode.unauthorized;
-        }
-        else if (flattened.some(e => core.BaseError.isErrorName(e, core.NotImplementedError.CLASS_NAME))) {
-            httpStatusCode = web.HttpStatusCode.forbidden;
-        }
-        else if (flattened.some(e => core.BaseError.isErrorName(e, core.UnprocessableError.CLASS_NAME))) {
-            httpStatusCode = web.HttpStatusCode.unprocessableEntity;
-        }
-        const returnError = error.toJsonObject(includeStack);
-        return {
-            error: returnError,
-            httpStatusCode
-        };
-    }
-    /**
-     * Build an error response.
-     * @param response The response to build the error into.
-     * @param error The error to build the response for.
-     * @param statusCode The status code to use for the error.
-     */
-    static buildResponse(response, error, statusCode) {
-        response.headers ??= {};
-        response.headers[web.HeaderTypes.ContentType] = `${web.MimeTypes.Json}; charset=utf-8`;
-        response.body = error;
-        response.statusCode = statusCode;
-    }
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Class to help with handling http parameters.
- */
-class HttpParameterHelper {
-    /**
-     * Convert list query to array.
-     * @param values The values query string.
-     * @returns The array of values.
-     */
-    static arrayFromString(values) {
-        return values?.split(",");
-    }
-    /**
-     * Convert array of values to query string.
-     * @param values The values to combine string.
-     * @returns The combined.
-     */
-    static arrayToString(values) {
-        return values?.join(",");
-    }
-    /**
-     * Convert object string to object.
-     * @param value The value query string.
-     * @returns The object.
-     */
-    static objectFromString(value) {
-        return core.Is.json(value) ? JSON.parse(value) : undefined;
-    }
-    /**
-     * Convert object to query string.
-     * @param value The value to convert to a string.
-     * @returns The converted object.
-     */
-    static objectToString(value) {
-        return core.Is.empty(value) ? undefined : JSON.stringify(value);
-    }
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * The health status of the component.
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-const HealthStatus = {
-    /**
-     * OK.
-     */
-    Ok: "ok",
-    /**
-     * Warning.
-     */
-    Warning: "warning",
-    /**
-     * Error.
-     */
-    Error: "error"
-};
-
-exports.HealthStatus = HealthStatus;
-exports.HttpErrorHelper = HttpErrorHelper;
-exports.HttpParameterHelper = HttpParameterHelper;
-exports.MimeTypeProcessorFactory = MimeTypeProcessorFactory;
-exports.RestRouteProcessorFactory = RestRouteProcessorFactory;
-exports.SocketRouteProcessorFactory = SocketRouteProcessorFactory;

package/dist/esm/index.mjs

@@ -1,147 +0,0 @@
-import { Factory, BaseError, GuardError, ValidationError, ConflictError, AlreadyExistsError, NotFoundError, UnauthorizedError, NotImplementedError, UnprocessableError, Is } from '@twin.org/core';
-import { HttpStatusCode, MimeTypes, HeaderTypes } from '@twin.org/web';
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Factory for creating implementation of mime type processor types.
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-const MimeTypeProcessorFactory = Factory.createFactory("mime-type-processor");
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Factory for creating implementation of REST route processor types.
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-const RestRouteProcessorFactory = Factory.createFactory("rest-route-processor");
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Factory for creating implementation of socket route processor types.
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-const SocketRouteProcessorFactory = Factory.createFactory("socket-route-processor");
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Class to help with processing http errors.
- */
-class HttpErrorHelper {
-    /**
-     * Process the errors from the routes.
-     * @param err The error to process.
-     * @param includeStack Should the stack be included in the error.
-     * @returns The status code and additional error data.
-     */
-    static processError(err, includeStack) {
-        const error = BaseError.fromError(err);
-        // If the error or any of its sub errors are of the specific
-        // types then set the http response code accordingly
-        const flattened = BaseError.flatten(error);
-        let httpStatusCode = HttpStatusCode.internalServerError;
-        if (flattened.some(e => BaseError.isErrorName(e, GuardError.CLASS_NAME)) ||
-            flattened.some(e => BaseError.isErrorName(e, ValidationError.CLASS_NAME))) {
-            httpStatusCode = HttpStatusCode.badRequest;
-        }
-        else if (flattened.some(e => BaseError.isErrorName(e, ConflictError.CLASS_NAME)) ||
-            flattened.some(e => BaseError.isErrorName(e, AlreadyExistsError.CLASS_NAME))) {
-            httpStatusCode = HttpStatusCode.conflict;
-        }
-        else if (flattened.some(e => BaseError.isErrorName(e, NotFoundError.CLASS_NAME))) {
-            httpStatusCode = HttpStatusCode.notFound;
-        }
-        else if (flattened.some(e => BaseError.isErrorName(e, UnauthorizedError.CLASS_NAME))) {
-            httpStatusCode = HttpStatusCode.unauthorized;
-        }
-        else if (flattened.some(e => BaseError.isErrorName(e, NotImplementedError.CLASS_NAME))) {
-            httpStatusCode = HttpStatusCode.forbidden;
-        }
-        else if (flattened.some(e => BaseError.isErrorName(e, UnprocessableError.CLASS_NAME))) {
-            httpStatusCode = HttpStatusCode.unprocessableEntity;
-        }
-        const returnError = error.toJsonObject(includeStack);
-        return {
-            error: returnError,
-            httpStatusCode
-        };
-    }
-    /**
-     * Build an error response.
-     * @param response The response to build the error into.
-     * @param error The error to build the response for.
-     * @param statusCode The status code to use for the error.
-     */
-    static buildResponse(response, error, statusCode) {
-        response.headers ??= {};
-        response.headers[HeaderTypes.ContentType] = `${MimeTypes.Json}; charset=utf-8`;
-        response.body = error;
-        response.statusCode = statusCode;
-    }
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Class to help with handling http parameters.
- */
-class HttpParameterHelper {
-    /**
-     * Convert list query to array.
-     * @param values The values query string.
-     * @returns The array of values.
-     */
-    static arrayFromString(values) {
-        return values?.split(",");
-    }
-    /**
-     * Convert array of values to query string.
-     * @param values The values to combine string.
-     * @returns The combined.
-     */
-    static arrayToString(values) {
-        return values?.join(",");
-    }
-    /**
-     * Convert object string to object.
-     * @param value The value query string.
-     * @returns The object.
-     */
-    static objectFromString(value) {
-        return Is.json(value) ? JSON.parse(value) : undefined;
-    }
-    /**
-     * Convert object to query string.
-     * @param value The value to convert to a string.
-     * @returns The converted object.
-     */
-    static objectToString(value) {
-        return Is.empty(value) ? undefined : JSON.stringify(value);
-    }
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * The health status of the component.
- */
-// eslint-disable-next-line @typescript-eslint/naming-convention
-const HealthStatus = {
-    /**
-     * OK.
-     */
-    Ok: "ok",
-    /**
-     * Warning.
-     */
-    Warning: "warning",
-    /**
-     * Error.
-     */
-    Error: "error"
-};
-
-export { HealthStatus, HttpErrorHelper, HttpParameterHelper, MimeTypeProcessorFactory, RestRouteProcessorFactory, SocketRouteProcessorFactory };

package/dist/types/models/protocol/IHttpRequestIdentity.d.ts

@@ -1,13 +0,0 @@
-/**
- * Context data from the HTTP request identity.
- */
-export interface IHttpRequestIdentity {
-    /**
-     * The identity of the node the request is being performed on.
-     */
-    nodeIdentity?: string;
-    /**
-     * The identity of the requestor if there is an authenticated user.
-     */
-    userIdentity?: string;
-}

package/docs/reference/interfaces/IHttpRequestIdentity.md

@@ -1,23 +0,0 @@
-# Interface: IHttpRequestIdentity
-
-Context data from the HTTP request identity.
-
-## Extended by
-
-- [`IHttpRequestContext`](IHttpRequestContext.md)
-
-## Properties
-
-### nodeIdentity?
-
-> `optional` **nodeIdentity**: `string`
-
-The identity of the node the request is being performed on.
-
-***
-
-### userIdentity?
-
-> `optional` **userIdentity**: `string`
-
-The identity of the requestor if there is an authenticated user.