@kohost/api-client 1.0.0-alpha.3 → 1.0.0-beta.0

package/models/index.js

@@ -1,13 +1,11 @@
-const IotGateway = require("./iotGateway");
 const Switch = require("./switch");
 const Alarm = require("./alarm");
 const Dimmer = require("./dimmer");
 const Lock = require("./lock");
-const SceneController = require("./sceneController");
 const Thermostat = require("./thermostat");
 const WindowCovering = require("./windowCovering");
+const Identification = require("./identification");
 const User = require("./user");
-const ACL = require("./acl");
 const Courtesy = require("./courtesy");
 const Camera = require("./camera");
 const MotionSensor = require("./motionSensor");
@@ -18,9 +16,11 @@ const Application = require("./application");
 const Space = require("./space");
 const Ticket = require("./ticket");
 const Scene = require("./scene");
-const Integration = require("./integration");
 const Gateway = require("./gateway");
+const Product = require("./product");
 const DiscoveredDevice = require("./discoveredDevice");
+const Credential = require("./credential");
+const ShortLink = require("./shortLink");
 
 const AdminCustomer = require("./admin/customer");
 const AdminProperty = require("./admin/property");
@@ -31,26 +31,26 @@ module.exports = {
     Property: AdminProperty,
   },
   Gateway,
-  IotGateway,
   Switch,
   Alarm,
   Dimmer,
   Lock,
   Courtesy,
   Camera,
-  SceneController,
   MotionSensor,
   Thermostat,
   WindowCovering,
   MediaSource,
+  Identification,
+  Product,
   User,
-  ACL,
   Room,
-  Application, 
+  Application,
   Space,
   Ticket,
   Scene,
-  Integration,
   DiscoveredDevice,
   Reservation,
+  Credential,
+  ShortLink,
 };

package/models/kohost.js

@@ -54,10 +54,11 @@ class Kohost {
 
   _validate(data) {
     const valid = this.validator(data);
-    if (!valid)
+    if (!valid) {
       throw new ValidationError(`Invalid ${this.constructor.name}`, {
-        cause: this.validator.errors,
-      });
+        cause: this.validator.errors,   
+    });    }
+   
   }
 
   static generateId() {

package/models/product.js

@@ -0,0 +1,30 @@
+// Create the Product Model
+const schemas = require("../utils/schema");
+const schema = require("../schemas/product.json");
+const Kohost = require("./kohost");
+
+schemas.add(schema);
+const validator = schemas.compile(schema);  
+
+class Product extends Kohost {
+  constructor(data) {
+    super(data);
+  }
+}
+
+Object.defineProperty(Product.prototype, "schema", {
+  value: schema,
+});
+
+Object.defineProperty(Product.prototype, "validator", {
+  get: function () {
+    return validator;
+  },
+});
+
+Object.defineProperty(Product, "validProperties", {
+  value: Object.keys(schema.properties),
+});
+
+
+module.exports = Product;

package/models/reservation.js

@@ -17,6 +17,53 @@ class Reservation extends Kohost {
   get hasPayment() {
     return this.paymentId?.length > 0;
   }
+
+  range(tz) {
+    const start = new Date(this.checkInDateTime);
+    const end = new Date(this.checkOutDateTime);
+
+    // output Dec 19-23 if same month and year
+    if (
+      start.getMonth() === end.getMonth() &&
+      start.getFullYear() === end.getFullYear()
+    ) {
+      return `${start.toLocaleString("default", {
+        month: "short",
+        timeZone: tz,
+      })} ${start.toLocaleString("default", {
+        timeZone: tz,
+        day: "numeric",
+      })}-${end.toLocaleString("default", {
+        timeZone: tz,
+        day: "numeric",
+      })}`;
+    }
+
+    // output Dec 19 - Jan 2 if different month and year
+    return `${start.toLocaleString("default", {
+      month: "short",
+      timeZone: tz,
+    })} ${start.getDate()} - ${end.toLocaleString("default", {
+      month: "short",
+      timeZone: tz,
+    })} ${end.getDate()}`;
+  }
+
+  checkInTime(tz) {
+    return new Date(this.checkInDateTime).toLocaleString("default", {
+      hour: "numeric",
+      minute: "numeric",
+      timeZone: tz,
+    });
+  }
+
+  checkOutTime(tz) {
+    return new Date(this.checkOutDateTime).toLocaleString("default", {
+      hour: "numeric",
+      minute: "numeric",
+      timeZone: tz,
+    });
+  }
 }
 
 Object.defineProperty(Reservation.prototype, "schema", {

package/models/room.js

@@ -11,7 +11,6 @@ const Thermostat = require("./thermostat");
 const Lock = require("./lock");
 const WindowCovering = require("./windowCovering");
 const Courtesy = require("./courtesy");
-const SceneController = require("./sceneController");
 const Camera = require("./camera");
 const Alarm = require("./alarm");
 const Source = require("./mediaSource");
@@ -37,7 +36,6 @@ class Room extends Kohost {
       "lock",
       "windowCovering",
       "courtesy",
-      "sceneController",
       "camera",
       "source",
       "motionSensor",
@@ -79,10 +77,6 @@ class Room extends Kohost {
     return this.courtesy?.length > 0;
   }
 
-  get hasSceneController() {
-    return this.sceneControllers?.length > 0;
-  }
-
   get hasCamera() {
     return this.cameras?.length > 0;
   }
@@ -135,7 +129,7 @@ function mapRoomData(data) {
   });
 
   roomData.thermostats?.map((thermostat) => {
-    if (thermostat instanceof Thermostat) return thermostat;
+    if (thermostat instanceof Thermostat) return thermostat; 
     else return new Thermostat(thermostat);
   });
 
@@ -154,11 +148,6 @@ function mapRoomData(data) {
     else return new Source(source);
   });
 
-  roomData.sceneControllers?.map((sceneController) => {
-    if (sceneController instanceof SceneController) return sceneController;
-    else return new SceneController(sceneController);
-  });
-
   roomData.cameras?.map((camera) => {
     if (camera instanceof Camera) return camera;
     else return new Camera(camera);

package/models/shortLink.js

@@ -0,0 +1,29 @@
+// Create the Lock Model
+const schemas = require("../utils/schema");
+const schema = require("../schemas/shortLink.json");
+const Kohost = require("./kohost");
+
+schemas.add(schema);
+const validator = schemas.compile(schema);
+
+class ShortLink extends Kohost {
+  constructor(data) {
+    super(data);
+  }
+}
+
+Object.defineProperty(ShortLink.prototype, "schema", {
+  value: schema,
+});
+
+Object.defineProperty(ShortLink.prototype, "validator", {
+  get: function () {
+    return validator;
+  },
+});
+
+Object.defineProperty(ShortLink, "validProperties", {
+  value: Object.keys(schema.properties),
+});
+
+module.exports = ShortLink;

package/models/space.js

@@ -10,7 +10,7 @@ const Room = require("./room");
 schemas.add(schema);
 const validator = schemas.compile(schema);
 
-class Space extends Kohost {
+class Space extends Kohost { 
   constructor(data) {
     const spaceData = mapSpaceData(data);
     super(spaceData);

package/models/thermostat.js

@@ -11,16 +11,16 @@ class Thermostat extends Kohost {
   }
 
   toCelsius() {
-    if (this.temperatureScale === "farenheit")
+    if (this.temperatureScale === "fahrenheit")
       this.currentTemperature = ((this.currentTemperature - 32) * 5) / 9;
     this.temperatureScale = "celsius";
     return this.currentTemperature;
   }
 
-  toFarenheit() {
+  toFahrenheit() {
     if (this.temperatureScale === "celsius")
       this.currentTemperature = (this.currentTemperature * 9) / 5 + 32;
-    this.temperatureScale = "farenheit";
+    this.temperatureScale = "fahrenheit";
     return this.currentTemperature;
   }
 

package/models/user.js

@@ -1,13 +1,11 @@
 // Create the User Model
 const schemas = require("../utils/schema");
 const schema = require("../schemas/user.json");
-const idSchema = require("../schemas/identification.json");
 const paymentSchema = require("../schemas/payment.json");
 const Kohost = require("./kohost");
 
 const { nanoid } = require("nanoid/async");
 
-schemas.add(idSchema);
 schemas.add(paymentSchema);
 schemas.add(schema);
 

package/models/windowCovering.js

@@ -11,7 +11,7 @@ class WindowCovering extends Kohost {
     super(data);
   }
 
-  static getActionDelta(old, _new) {
+  static getActionDelta(old, _new) {  
     const delta = {};
     for (const action in _new) {
       if (this.actionProperties?.includes(action)) {

package/package.json

@@ -1,17 +1,9 @@
 {
-  "dependencies": {
-    "ajv": "^8.11.0",
-    "ajv-formats": "^2.1.1",
-    "axios": "^1.0.0",
-    "lodash.clonedeep": "^4.5.0",
-    "lodash.findlast": "^4.6.0",
-    "lodash.sortby": "^4.7.0",
-    "nanoid": "^3.3.4"
-  },
   "name": "@kohost/api-client",
-  "version": "1.0.0-alpha.3",
+  "version": "1.0.0-beta.0",
   "description": "API client for Kohost utils",
   "main": "index.js",
+  "module": "index.js",
   "scripts": {
     "test": "jest",
     "test:watch": "jest --watchAll",
@@ -30,6 +22,15 @@
     "lint-staged": "^13.0.3",
     "prettier": "^2.5.1"
   },
+  "dependencies": {
+    "ajv": "^8.11.0",
+    "ajv-formats": "^2.1.1",
+    "axios": "^1.0.0",
+    "lodash.clonedeep": "^4.5.0",
+    "lodash.findlast": "^4.6.0",
+    "lodash.sortby": "^4.7.0",
+    "nanoid": "^3.3.4"
+  },
   "lint-staged": {
     "*.js": "eslint --cache --fix",
     "*.{js,css,md,json}": "prettier --write"

package/schemas/admin/property.json

@@ -4,7 +4,7 @@
   "title": "Property",
   "type": "object",
   "description": "A property is a physical asset or building",
-  "required": ["id", "name", "type"],
+  "required": ["id", "name", "type", "hostname"],
   "properties": {
     "id": {
       "$ref": "https://api.kohost.app/schemas/v3/definitions/common.json#/definitions/id"
@@ -19,6 +19,12 @@
     "timezone": {
       "type": "string"
     },
+    "smsNumber": {
+      "type": "string"
+    },
+    "hostname": {
+      "type": "string"
+    },
     "address": {
       "type": "object",
       "properties": {
@@ -45,6 +51,126 @@
     "longitude": {
       "type": "number"
     },
+    "appManifest": {
+      "type": "object",
+
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "short_name": {
+          "type": "string"
+        },
+        "scope": {
+          "type": "string"
+        },
+        "start_url": {
+          "type": "string"
+        },
+        "themeColor": {
+          "type": "string"
+        },
+        "backgroundColor": {
+          "type": "string"
+        },
+        "display": {
+          "type": "string",
+          "enum": ["fullscreen", "standalone", "minimal-ui", "browser"],
+          "default": "fullscreen"
+        },
+        "orientation": {
+          "type": "string",
+          "enum": ["portrait", "landscape"],
+          "default": "portrait"
+        },
+        "splash": {
+          "type": "object",
+          "properties": {
+            "src": {
+              "type": "string"
+            },
+            "type": {
+              "type": "string"
+            },
+            "sizes": {
+              "type": "string"
+            }
+          }
+        },
+        "icons": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "src": {
+                "type": "string"
+              },
+              "sizes": {
+                "type": "string"
+              },
+              "type": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "logo": {
+          "type": "object",
+          "properties": {
+            "src": {
+              "type": "string"
+            },
+            "type": {
+              "type": "string"
+            },
+            "sizes": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "default": {
+        "name": "Kohost",
+        "short_name": "Kohost",
+        "start_url": "/",
+        "scope": "/",
+        "display": "fullscreen",
+        "orientation": "portrait",
+        "theme_color": "#1d1f22",
+        "background_color": "#1d1f22",
+        "icons": [
+          {
+            "src": "https://cdn.kohost.app/defaultIcon.png",
+            "sizes": "512x512",
+            "type": "image/png"
+          }
+        ],
+        "splash": {
+          "src": "https://cdn.kohost.app/defaultSplash.jpg",
+          "sizes": "1500x800",
+          "type": "image/jpg"
+        },
+        "logo": {
+          "src": "https://cdn.kohost.app/defaultLogo.png",
+          "sizes": "300x75",
+          "type": "image/png"
+        }
+      }
+    },
+    "appFeatures": {
+      "type": "object",
+      "properties": {
+        "RoomControl": {},
+        "CheckIn": {},
+        "CheckOut": {},
+        "Concierge": {},
+        "Elevator": {}
+      },
+      "additionalProperties": false,
+      "default": {
+        "RoomControl": {}
+      }
+    },
     "credentials": {
       "type": "object",
       "additionalProperties": true

package/schemas/camera.json

@@ -11,9 +11,6 @@
     "type": {
       "$ref": "https://api.kohost.app/schemas/v3/definitions/device.json#/definitions/type"
     },
-    "systemData": {
-      "$ref": "https://api.kohost.app/schemas/v3/definitions/device.json#/definitions/systemData"
-    },
     "supportedNotifications": {
       "$ref": "https://api.kohost.app/schemas/v3/definitions/device.json#/definitions/supportedNotifications"
     },
@@ -34,6 +31,9 @@
           "type": ["string", "null"]
         }
       }
+    },
+    "systemData": {
+      "$ref": "https://api.kohost.app/schemas/v3/definitions/device.json#/definitions/systemData"
     }
   },
   "additionalProperties": false,

package/schemas/courtesy.json

@@ -11,9 +11,6 @@
     "type": {
       "$ref": "https://api.kohost.app/schemas/v3/definitions/device.json#/definitions/type"
     },
-    "systemData": {
-      "$ref": "https://api.kohost.app/schemas/v3/definitions/device.json#/definitions/systemData"
-    },
     "supportedNotifications": {
       "$ref": "https://api.kohost.app/schemas/v3/definitions/device.json#/definitions/supportedNotifications"
     },
@@ -30,6 +27,9 @@
     "state": {
       "type": "string",
       "$ref": "#/properties/supportedStates/items"
+    },
+    "systemData": {
+      "$ref": "https://api.kohost.app/schemas/v3/definitions/device.json#/definitions/systemData"
     }
   },
   "additionalProperties": false,

package/schemas/credential.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "https://api.kohost.app/schemas/v3/credential.json",
+  "title": "Credential",
+  "type": "object",
+  "required": ["type", "credential", "expires"],
+  "properties": {
+    "id": {
+      "$ref": "https://api.kohost.app/schemas/v3/definitions/common.json#/definitions/id"
+    },
+    "type": {
+      "type": "string",
+      "enum": ["verificationCode", "token"]
+    },
+    "credential": {
+      "type": "string"
+    },
+    "user": {
+      "type": "string"
+    },
+    "userAgent": {
+      "type": "string"
+    },
+    "expires": {
+      "string": "string"
+    }
+  }
+}

package/schemas/definitions/common.json

@@ -9,6 +9,10 @@
       "type": "object",
       "default": {}
     },
+    "metadata": {
+      "type": "object",
+      "default": {}
+    },
     "createdAt": {
       "type": ["string", "object"],
       "format": "date-time"
@@ -16,6 +20,55 @@
     "updatedAt": {
       "type": ["string", "object"],
       "format": "date-time"
+    },
+    "file": {
+      "type":"object",
+      "required": ["name", "type", "data"],
+      "properties": {
+        "name": {
+          "type":"string",
+          "description": "Name of the file."
+        },
+        "type": {
+          "type":"string",
+          "description": "MIME type of the file (e.g. application/pdf)."
+        },
+        "data": {
+          "type":"string",
+          "description": "Base64-encoded data of the file."
+        }
+      }
+    },
+    "address": {
+      "type":"object",
+      "properties": {
+        "id": {
+          "type":"string"
+        },
+        "line1": {
+          "type":"string"
+        },
+        "line2": {
+          "type":"string"
+        },
+        "line3": {
+          "type":"string"
+        },
+        "city": {
+          "type":"string"
+        },
+        "state": {
+          "type":"string"
+        },
+        "postalCode": {
+          "type":"string"
+        },
+        "countryCode": {
+          "type":"string",
+          "minLength": 2,
+          "maxLength": 2
+        }
+      }
     }
   }
 }

package/schemas/definitions/device.json

@@ -20,10 +20,11 @@
         "thermostat",
         "lock",
         "courtesy",
-        "sceneController"
+        "sceneController",
+        "gateway"
       ]
     },
-    "name": {
+    "name": { 
       "type": "string"
     },
     "subType": {
@@ -34,6 +35,11 @@
       "uniqueItems": true,
       "items": {
         "enum": [
+          "button 1",
+          "button 2",
+          "button 3",
+          "button 4",
+          "button 5",
           "idle",
           "powerHasBeedApplied",
           "acMainsDisconnected",
@@ -60,6 +66,11 @@
           "minimum": 1655907956593
         }
       }
+    },
+    "batteryLevel": {
+      "type":"number",
+      "minimum": 0,
+      "maximum": 100
     }
   }
 }

package/schemas/dimmer.json

@@ -14,9 +14,6 @@
     "subType": {
       "$ref": "https://api.kohost.app/schemas/v3/definitions/device.json#/definitions/subType"
     },
-    "systemData": {
-      "$ref": "https://api.kohost.app/schemas/v3/definitions/device.json#/definitions/systemData"
-    },
     "supportedNotifications": {
       "$ref": "https://api.kohost.app/schemas/v3/definitions/device.json#/definitions/supportedNotifications"
     },
@@ -27,6 +24,9 @@
       "type": "number",
       "minimum": 0,
       "maximum": 100
+    },
+    "systemData": {
+      "$ref": "https://api.kohost.app/schemas/v3/definitions/device.json#/definitions/systemData"
     }
   },
   "additionalProperties": false,