0.75.0

Closes #152

CHANGELOG.md

@@ -1,3 +1,12 @@
+# [0.75.0](https://gitlab.com/openstapps/core/compare/v0.74.0...v0.75.0) (2023-02-28)
+
+
+### Features
+
+* add rating for things ([28eacf7](https://gitlab.com/openstapps/core/commit/28eacf7925f84caa129cad4b94fb449effd4d6ea)), closes [#152](https://gitlab.com/openstapps/core/issues/152)
+
+
+
 # [0.74.0](https://gitlab.com/openstapps/core/compare/v0.73.0...v0.74.0) (2023-01-30)
 
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@openstapps/core",
-  "version": "0.74.0",
+  "version": "0.75.0",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openstapps/core",
-  "version": "0.74.0",
+  "version": "0.75.0",
   "description": "StAppsCore - Generalized model of data",
   "keywords": [
     "Model",

src/protocol/route.ts

@@ -27,6 +27,7 @@ import {SCFeedbackRequest, SCFeedbackResponse, SCFeedbackRoute} from './routes/f
 import {SCSearchRequest, SCSearchResponse, SCSearchRoute} from './routes/search';
 import {SCMultiSearchRequest, SCMultiSearchResponse, SCMultiSearchRoute} from './routes/search-multi';
 import {SCThingUpdateRequest, SCThingUpdateResponse, SCThingUpdateRoute} from './routes/thing-update';
+import {SCRatingRequest, SCRatingResponse, SCRatingRoute} from './routes/rating';
 
 /**
  * Possible Verbs for HTTP requests
@@ -166,6 +167,7 @@ export type SCRequests =
   | SCBulkAddRequest
   | SCBulkDoneRequest
   | SCFeedbackRequest
+  | SCRatingRequest
   | SCIndexRequest
   | SCMultiSearchRequest
   | SCSearchRequest
@@ -180,6 +182,7 @@ export type SCResponses =
   | SCBulkAddResponse
   | SCBulkDoneResponse
   | SCFeedbackResponse
+  | SCRatingResponse
   | SCIndexResponse
   | SCMultiSearchResponse
   | SCSearchResponse
@@ -198,6 +201,8 @@ export type SCAssociatedResponse<REQUEST> = REQUEST extends SCBookAvailabilityRe
   ? SCBulkDoneResponse
   : REQUEST extends SCFeedbackRequest
   ? SCFeedbackResponse
+  : REQUEST extends SCRatingRequest
+  ? SCRatingResponse
   : REQUEST extends SCIndexRequest
   ? SCIndexResponse
   : REQUEST extends SCMultiSearchRequest
@@ -221,6 +226,8 @@ export type SCAssociatedRequest<RESPONSE> = RESPONSE extends SCBookAvailabilityR
   ? SCBulkDoneRequest
   : RESPONSE extends SCFeedbackResponse
   ? SCFeedbackRequest
+  : RESPONSE extends SCRatingResponse
+  ? SCRatingRequest
   : RESPONSE extends SCIndexResponse
   ? SCIndexRequest
   : RESPONSE extends SCMultiSearchResponse
@@ -244,6 +251,8 @@ export type SCAssignedRequest<ROUTE extends SCAbstractRoute> = ROUTE extends SCB
   ? SCBulkDoneRequest
   : ROUTE extends SCFeedbackRoute
   ? SCFeedbackRequest
+  : ROUTE extends SCRatingRoute
+  ? SCRatingRequest
   : ROUTE extends SCIndexRoute
   ? SCIndexRequest
   : ROUTE extends SCMultiSearchRoute
@@ -267,6 +276,8 @@ export type SCAssignedResponse<ROUTE extends SCAbstractRoute> = ROUTE extends SC
   ? SCBulkDoneResponse
   : ROUTE extends SCFeedbackRoute
   ? SCFeedbackResponse
+  : ROUTE extends SCRatingRoute
+  ? SCRatingResponse
   : ROUTE extends SCIndexRoute
   ? SCIndexResponse
   : ROUTE extends SCMultiSearchRoute

src/protocol/routes/rating.ts

@@ -0,0 +1,77 @@
+/*
+ * Copyright (C) 2019-2023 Open StApps
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by the Free
+ * Software Foundation, version 3.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import {StatusCodes} from 'http-status-codes';
+import {SCInternalServerErrorResponse} from '../errors/internal-server-error';
+import {SCMethodNotAllowedErrorResponse} from '../errors/method-not-allowed';
+import {SCRequestBodyTooLargeErrorResponse} from '../errors/request-body-too-large';
+import {SCSyntaxErrorResponse} from '../errors/syntax-error';
+import {SCUnsupportedMediaTypeErrorResponse} from '../errors/unsupported-media-type';
+import {SCAbstractRoute, SCRouteHttpVerbs} from '../route';
+import {SCThing} from '../../things/abstract/thing';
+import {SCUserGroupSetting} from '../../things/setting';
+import {SCValidationErrorResponse} from '../errors/validation';
+
+/**
+ * User rating from the app
+ * Plugin needs to define its own rating request to hit the target rating system.
+ * That request should extend this one and contain timestamp and other needed data.
+ *
+ * @validatable
+ */
+export interface SCRatingRequest {
+  /**
+   * Number of rating stars
+   */
+  rating: 1 | 2 | 3 | 4 | 5;
+
+  /**
+   * User's group in the app
+   */
+  userGroup: SCUserGroupSetting['value'];
+
+  /**
+   * UID of the thing that is rated
+   */
+  uid: SCThing['uid'];
+}
+
+/**
+ * A response to a rating request
+ *
+ * @validatable
+ */
+export interface SCRatingResponse {}
+
+/**
+ * Route for rating submission
+ */
+export class SCRatingRoute extends SCAbstractRoute {
+  constructor() {
+    super();
+    this.errorNames = [
+      SCInternalServerErrorResponse,
+      SCMethodNotAllowedErrorResponse,
+      SCRequestBodyTooLargeErrorResponse,
+      SCSyntaxErrorResponse,
+      SCUnsupportedMediaTypeErrorResponse,
+      SCValidationErrorResponse,
+    ];
+    this.method = SCRouteHttpVerbs.POST;
+    this.requestBodyName = 'SCRatingRequest';
+    this.responseBodyName = 'SCRatingResponse';
+    this.statusCodeSuccess = StatusCodes.OK;
+    this.urlPath = '/rating';
+  }
+}