@twin.org/api-models 0.0.1-next.5 → 0.0.1-next.8

package/dist/cjs/index.cjs

@@ -121,6 +121,39 @@ class HttpParameterHelper {
             return conditionsList.join(",");
         }
     }
+    /**
+     * Convert the sort string to a list of sort properties.
+     * @param sortProperties The sort properties query string.
+     * @returns The list of sort properties.
+     */
+    static sortPropertiesFromString(sortProperties) {
+        const sortParts = sortProperties?.split(",") ?? [];
+        const sortPropertyList = [];
+        for (const conditionPart of sortParts) {
+            const parts = conditionPart.split("|");
+            if (parts.length === 2) {
+                sortPropertyList.push({
+                    property: parts[0],
+                    sortDirection: parts[1]
+                });
+            }
+        }
+        return sortPropertyList.length === 0 ? undefined : sortPropertyList;
+    }
+    /**
+     * Convert the sort properties to a string parameter.
+     * @param sortProperties The sort properties to convert.
+     * @returns The string version of the sort properties.
+     */
+    static sortPropertiesToString(sortProperties) {
+        if (core.Is.arrayValue(sortProperties)) {
+            const sortPropertyList = [];
+            for (const conditionPart of sortProperties) {
+                sortPropertyList.push(`${conditionPart.property}|${conditionPart.sortDirection}`);
+            }
+            return sortPropertyList.join(",");
+        }
+    }
 }
 
 // Copyright 2024 IOTA Stiftung.

package/dist/esm/index.mjs

@@ -119,6 +119,39 @@ class HttpParameterHelper {
             return conditionsList.join(",");
         }
     }
+    /**
+     * Convert the sort string to a list of sort properties.
+     * @param sortProperties The sort properties query string.
+     * @returns The list of sort properties.
+     */
+    static sortPropertiesFromString(sortProperties) {
+        const sortParts = sortProperties?.split(",") ?? [];
+        const sortPropertyList = [];
+        for (const conditionPart of sortParts) {
+            const parts = conditionPart.split("|");
+            if (parts.length === 2) {
+                sortPropertyList.push({
+                    property: parts[0],
+                    sortDirection: parts[1]
+                });
+            }
+        }
+        return sortPropertyList.length === 0 ? undefined : sortPropertyList;
+    }
+    /**
+     * Convert the sort properties to a string parameter.
+     * @param sortProperties The sort properties to convert.
+     * @returns The string version of the sort properties.
+     */
+    static sortPropertiesToString(sortProperties) {
+        if (Is.arrayValue(sortProperties)) {
+            const sortPropertyList = [];
+            for (const conditionPart of sortProperties) {
+                sortPropertyList.push(`${conditionPart.property}|${conditionPart.sortDirection}`);
+            }
+            return sortPropertyList.join(",");
+        }
+    }
 }
 
 // Copyright 2024 IOTA Stiftung.

package/dist/types/helpers/httpParameterHelper.d.ts

@@ -1,4 +1,4 @@
-import type { IComparator } from "@twin.org/entity";
+import type { IComparator, SortDirection } from "@twin.org/entity";
 /**
  * Class to help with handling http parameters.
  */
@@ -27,4 +27,22 @@ export declare class HttpParameterHelper {
      * @returns The string version of the comparators.
      */
     static conditionsToString(conditions?: IComparator[]): string | undefined;
+    /**
+     * Convert the sort string to a list of sort properties.
+     * @param sortProperties The sort properties query string.
+     * @returns The list of sort properties.
+     */
+    static sortPropertiesFromString<T = unknown>(sortProperties?: string): {
+        property: keyof T;
+        sortDirection: SortDirection;
+    }[] | undefined;
+    /**
+     * Convert the sort properties to a string parameter.
+     * @param sortProperties The sort properties to convert.
+     * @returns The string version of the sort properties.
+     */
+    static sortPropertiesToString<T = unknown>(sortProperties?: {
+        property: keyof T;
+        sortDirection: SortDirection;
+    }[]): string | undefined;
 }

package/dist/types/index.d.ts

@@ -27,7 +27,10 @@ export * from "./models/responses/success/IOkResponse";
 export * from "./models/routes/IBaseRoute";
 export * from "./models/routes/IRestRoute";
 export * from "./models/routes/IRestRouteEntryPoint";
+export * from "./models/routes/IRestRouteExample";
+export * from "./models/routes/IRestRouteRequestExample";
 export * from "./models/routes/IRestRouteResponseAttachmentOptions";
+export * from "./models/routes/IRestRouteResponseExample";
 export * from "./models/routes/IRestRouteResponseOptions";
 export * from "./models/routes/ISocketRoute";
 export * from "./models/routes/ITag";

package/dist/types/models/routes/IRestRoute.d.ts

@@ -1,5 +1,7 @@
 import type { HttpMethod } from "@twin.org/web";
 import type { IBaseRoute } from "./IBaseRoute";
+import type { IRestRouteRequestExample } from "./IRestRouteRequestExample";
+import type { IRestRouteResponseExample } from "./IRestRouteResponseExample";
 import type { IRestRouteResponseOptions } from "./IRestRouteResponseOptions";
 import type { IHttpRequest } from "../protocol/IHttpRequest";
 import type { IHttpRequestContext } from "../protocol/IHttpRequestContext";
@@ -47,11 +49,7 @@ export interface IRestRoute<T extends IHttpRequest = any, U extends IHttpRespons
         /**
          * Example objects for the request.
          */
-        examples?: {
-            id: string;
-            description?: string;
-            request: T;
-        }[];
+        examples?: IRestRouteRequestExample<T>[];
     };
     /**
      * The type of the response object.
@@ -68,11 +66,7 @@ export interface IRestRoute<T extends IHttpRequest = any, U extends IHttpRespons
         /**
          * Example objects of the response.
          */
-        examples?: {
-            id: string;
-            description?: string;
-            response: U;
-        }[];
+        examples?: IRestRouteResponseExample<U>[];
     }[];
     /**
      * Exclude the route from being included in the spec file.

package/dist/types/models/routes/IRestRouteExample.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Interface which defines a REST route example.
+ */
+export interface IRestRouteExample {
+    /**
+     * Example objects for the request.
+     */
+    id: string;
+    /**
+     * Description of the example.
+     */
+    description?: string;
+}

package/dist/types/models/routes/IRestRouteRequestExample.d.ts

@@ -0,0 +1,10 @@
+import type { IRestRouteExample } from "./IRestRouteExample";
+/**
+ * Interface which defines a REST route request example.
+ */
+export interface IRestRouteRequestExample<T> extends IRestRouteExample {
+    /**
+     * The example request object.
+     */
+    request: T;
+}

package/dist/types/models/routes/IRestRouteResponseExample.d.ts

@@ -0,0 +1,10 @@
+import type { IRestRouteExample } from "./IRestRouteExample";
+/**
+ * Interface which defines a REST route response example.
+ */
+export interface IRestRouteResponseExample<T> extends IRestRouteExample {
+    /**
+     * The example response object.
+     */
+    response: T;
+}

package/docs/changelog.md

@@ -1,5 +1,5 @@
 # @twin.org/api-models - Changelog
 
-## v0.0.1-next.5
+## v0.0.1-next.8
 
 - Initial Release

package/docs/reference/classes/HttpParameterHelper.md

@@ -99,3 +99,51 @@ The conditions to convert.
 `undefined` \| `string`
 
 The string version of the comparators.
+
+***
+
+### sortPropertiesFromString()
+
+> `static` **sortPropertiesFromString**\<`T`\>(`sortProperties`?): `undefined` \| `object`[]
+
+Convert the sort string to a list of sort properties.
+
+#### Type Parameters
+
+• **T** = `unknown`
+
+#### Parameters
+
+• **sortProperties?**: `string`
+
+The sort properties query string.
+
+#### Returns
+
+`undefined` \| `object`[]
+
+The list of sort properties.
+
+***
+
+### sortPropertiesToString()
+
+> `static` **sortPropertiesToString**\<`T`\>(`sortProperties`?): `undefined` \| `string`
+
+Convert the sort properties to a string parameter.
+
+#### Type Parameters
+
+• **T** = `unknown`
+
+#### Parameters
+
+• **sortProperties?**: `object`[]
+
+The sort properties to convert.
+
+#### Returns
+
+`undefined` \| `string`
+
+The string version of the sort properties.

package/docs/reference/index.md

@@ -34,7 +34,10 @@
 - [IBaseRoute](interfaces/IBaseRoute.md)
 - [IRestRoute](interfaces/IRestRoute.md)
 - [IRestRouteEntryPoint](interfaces/IRestRouteEntryPoint.md)
+- [IRestRouteExample](interfaces/IRestRouteExample.md)
+- [IRestRouteRequestExample](interfaces/IRestRouteRequestExample.md)
 - [IRestRouteResponseAttachmentOptions](interfaces/IRestRouteResponseAttachmentOptions.md)
+- [IRestRouteResponseExample](interfaces/IRestRouteResponseExample.md)
 - [IRestRouteResponseOptions](interfaces/IRestRouteResponseOptions.md)
 - [ISocketRoute](interfaces/ISocketRoute.md)
 - [ITag](interfaces/ITag.md)

package/docs/reference/interfaces/IRestRoute.md

@@ -116,7 +116,7 @@ The mime type of the request, defaults to "application/json" if there is a body.
 
 #### examples?
 
-> `optional` **examples**: `object`[]
+> `optional` **examples**: [`IRestRouteRequestExample`](IRestRouteRequestExample.md)\<`T`\>[]
 
 Example objects for the request.
 

package/docs/reference/interfaces/IRestRouteExample.md

@@ -0,0 +1,24 @@
+# Interface: IRestRouteExample
+
+Interface which defines a REST route example.
+
+## Extended by
+
+- [`IRestRouteRequestExample`](IRestRouteRequestExample.md)
+- [`IRestRouteResponseExample`](IRestRouteResponseExample.md)
+
+## Properties
+
+### id
+
+> **id**: `string`
+
+Example objects for the request.
+
+***
+
+### description?
+
+> `optional` **description**: `string`
+
+Description of the example.

package/docs/reference/interfaces/IRestRouteRequestExample.md

@@ -0,0 +1,43 @@
+# Interface: IRestRouteRequestExample\<T\>
+
+Interface which defines a REST route request example.
+
+## Extends
+
+- [`IRestRouteExample`](IRestRouteExample.md)
+
+## Type Parameters
+
+• **T**
+
+## Properties
+
+### id
+
+> **id**: `string`
+
+Example objects for the request.
+
+#### Inherited from
+
+[`IRestRouteExample`](IRestRouteExample.md).[`id`](IRestRouteExample.md#id)
+
+***
+
+### description?
+
+> `optional` **description**: `string`
+
+Description of the example.
+
+#### Inherited from
+
+[`IRestRouteExample`](IRestRouteExample.md).[`description`](IRestRouteExample.md#description)
+
+***
+
+### request
+
+> **request**: `T`
+
+The example request object.

package/docs/reference/interfaces/IRestRouteResponseExample.md

@@ -0,0 +1,43 @@
+# Interface: IRestRouteResponseExample\<T\>
+
+Interface which defines a REST route response example.
+
+## Extends
+
+- [`IRestRouteExample`](IRestRouteExample.md)
+
+## Type Parameters
+
+• **T**
+
+## Properties
+
+### id
+
+> **id**: `string`
+
+Example objects for the request.
+
+#### Inherited from
+
+[`IRestRouteExample`](IRestRouteExample.md).[`id`](IRestRouteExample.md#id)
+
+***
+
+### description?
+
+> `optional` **description**: `string`
+
+Description of the example.
+
+#### Inherited from
+
+[`IRestRouteExample`](IRestRouteExample.md).[`description`](IRestRouteExample.md#description)
+
+***
+
+### response
+
+> **response**: `T`
+
+The example response object.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/api-models",
-	"version": "0.0.1-next.5",
+	"version": "0.0.1-next.8",
 	"description": "Contains models and classes for use with APIs",
 	"repository": {
 		"type": "git",