presidium 4.10.0 → 4.11.0

package/DatabaseLoadBalancer.js

@@ -0,0 +1,3 @@
+const DatabaseServer = require("presidium-db-client-server/DatabaseServer")
+
+module.exports = DatabaseServer

package/Validator.js

@@ -0,0 +1,196 @@
+const Validator = {
+
+  /**
+   * @name Validator.Object
+   *
+   * @docs
+   * ```specscript
+   * Validator.Object(validators Object<function>) -> objectValidator function
+   *
+   * objectValidator(data any) -> result Object
+   * ```
+   */
+  Object(validators) {
+    return function _Object(data) {
+      if (typeof data == "object") {
+        const result = {}
+        for (const key in validators) {
+          const validator = validators[key]
+          const value = data[key]
+          try {
+            const validated = validator(value)
+            if (validated != Validator.Optional) {
+              result[key] = validator(value)
+            }
+          } catch (error) {
+            error.key = key
+            throw error
+          }
+        }
+        return result
+      }
+      const error = new Error("BadObject")
+      error.data = data
+      throw error
+    }
+  },
+
+  /**
+   * @name Validator.Array
+   *
+   * @docs
+   * ```specscript
+   * Validator.Array(data) -> Array
+   *
+   * Validator.Array(validator function) -> arrayValidator
+   *
+   * arrayValidator(data any) -> result Array
+   * ```
+   */
+  Array(data) {
+    if (typeof data == "function") {
+      const validator = data
+      return function _ArrayOf(_data) {
+        if (Array.isArray(_data)) {
+          const result = []
+          for (let i = 0; i < _data.length; i++) {
+            try {
+              result.push(validator(_data[i]))
+            } catch (error) {
+              error.index = i
+              throw error
+            }
+          }
+          return result
+        }
+        const error = new Error("BadArray")
+        error.data = _data
+        throw error
+      }
+    }
+    if (Array.isArray(data)) {
+      return data
+    }
+    const error = new Error("BadArray")
+    error.data = data
+    throw error
+  },
+
+  /**
+   * @name Validator.Number
+   *
+   * @docs
+   * ```specscript
+   * Validator.Number(data any) -> number
+   * ```
+   */
+  Number(data) {
+    if (typeof data == "number") {
+      return data
+    }
+    const error = new Error("BadNumber")
+    error.data = data
+    throw error
+  },
+
+  /**
+   * @name Validator.String
+   *
+   * @docs
+   * ```specscript
+   * Validator.String(data any) -> string
+   * ```
+   */
+  String(data) {
+    if (typeof data == "string") {
+      return data
+    }
+    const error = new Error("BadString")
+    error.data = data
+    throw error
+  },
+
+  /**
+   * @name Validator.Email
+   *
+   * @docs
+   * ```specscript
+   * Validator.Email(data any) -> email string
+   * ```
+   */
+  Email(data) {
+    if (
+      data.includes("@")
+      && data.includes(".")
+      && !data.startsWith("@")
+      && !data.endsWith("@")
+      && !data.startsWith(".")
+      && !data.endsWith(".")
+    ) {
+      return data
+    }
+    const error = new Error("BadEmail")
+    error.data = data
+    throw error
+  },
+
+  /**
+   * @name Validator.Boolean
+   *
+   * @docs
+   * ```specscript
+   * Validator.Boolean(data any) -> boolean
+   * ```
+   */
+  Boolean(data) {
+    if (typeof data == "boolean") {
+      return data
+    }
+    const error = new Error("BadBoolean")
+    error.data = data
+    throw error
+  },
+
+  /**
+   * @name Validator.OneOf
+   *
+   * @docs
+   * ```specscript
+   * Validator.OneOf(...values Arguments) -> oneOfValidator
+   *
+   * oneOfValidator(data any) -> result string|number
+   * ```
+   */
+  OneOf(...values) {
+    return function _OneOf(data) {
+      if (values.includes(data)) {
+        return data
+      }
+      const error = new Error("NotOneOf")
+      error.data = data
+      throw error
+    }
+  },
+
+  /**
+   * @name Validator.Optional
+   *
+   * @docs
+   * ```specscript
+   * Validator.Optional(validator function) -> optionalValidator
+   *
+   * optionalValidator(data any) -> result any
+   * ```
+   */
+  Optional(validator) {
+    return function _Optional(data) {
+      if (data == null) {
+        return Validator.Optional
+      }
+      return validator(data)
+    }
+  },
+
+}
+
+module.exports = Validator

package/index.js

@@ -3,33 +3,35 @@
  */
 
 module.exports = {
-  AwsCredentials: require('./AwsCredentials.js'),
-  DatabaseServer: require('./DatabaseServer.js'),
-  DiskHashTable: require('./DiskHashTable.js'),
-  DiskHashTableClient: require('./DiskHashTableClient.js'),
-  DiskSortedHashTable: require('./DiskSortedHashTable.js'),
-  DiskSortedHashTableClient: require('./DiskSortedHashTableClient.js'),
-  Docker: require('./Docker.js'),
-  DynamoDBGlobalSecondaryIndex: require('./DynamoDBGlobalSecondaryIndex.js'),
-  DynamoDBStream: require('./DynamoDBStream.js'),
-  DynamoDBTable: require('./DynamoDBTable.js'),
-  ECR: require('./ECR.js'),
-  GoogleChromeDevTools: require('./GoogleChromeDevTools.js'),
-  GoogleChromeForTesting: require('./GoogleChromeForTesting.js'),
-  HTTP: require('./HTTP.js'),
-  NpmToken: require('./NpmToken.js'),
-  OptionalValidator: require('./OptionalValidator.js'),
-  Password: require('./Password.js'),
-  Readable: require('./Readable.js'),
-  S3Bucket: require('./S3Bucket.js'),
-  Secrets: require('./Secrets.js'),
-  SecretsManager: require('./SecretsManager.js'),
-  StrictValidator: require('./StrictValidator.js'),
-  TranscribeStream: require('./TranscribeStream.js'),
-  userAgent: require('./userAgent.js'),
-  WebSocket: require('./WebSocket.js'),
-  WebSocketServer: require('./WebSocketServer.js'),
-  WebSocketSecureServer: require('./WebSocketSecureServer.js'),
-  ServerWebSocket: require('./ServerWebSocket.js'),
-  XML: require('./XML.js'),
+  AwsCredentials: require("./AwsCredentials.js"),
+  DatabaseLoadBalancer: require("./DatabaseLoadBalancer.js"),
+  DatabaseServer: require("./DatabaseServer.js"),
+  DiskHashTable: require("./DiskHashTable.js"),
+  DiskHashTableClient: require("./DiskHashTableClient.js"),
+  DiskSortedHashTable: require("./DiskSortedHashTable.js"),
+  DiskSortedHashTableClient: require("./DiskSortedHashTableClient.js"),
+  Docker: require("./Docker.js"),
+  DynamoDBGlobalSecondaryIndex: require("./DynamoDBGlobalSecondaryIndex.js"),
+  DynamoDBStream: require("./DynamoDBStream.js"),
+  DynamoDBTable: require("./DynamoDBTable.js"),
+  ECR: require("./ECR.js"),
+  GoogleChromeDevTools: require("./GoogleChromeDevTools.js"),
+  GoogleChromeForTesting: require("./GoogleChromeForTesting.js"),
+  HTTP: require("./HTTP.js"),
+  NpmToken: require("./NpmToken.js"),
+  OptionalValidator: require("./OptionalValidator.js"),
+  Password: require("./Password.js"),
+  Readable: require("./Readable.js"),
+  S3Bucket: require("./S3Bucket.js"),
+  Secrets: require("./Secrets.js"),
+  SecretsManager: require("./SecretsManager.js"),
+  StrictValidator: require("./StrictValidator.js"),
+  TranscribeStream: require("./TranscribeStream.js"),
+  userAgent: require("./userAgent.js"),
+  WebSocket: require("./WebSocket.js"),
+  WebSocketServer: require("./WebSocketServer.js"),
+  WebSocketSecureServer: require("./WebSocketSecureServer.js"),
+  ServerWebSocket: require("./ServerWebSocket.js"),
+  Validator: require("./Validator.js"),
+  XML: require("./XML.js"),
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "presidium",
-  "version": "4.10.0",
+  "version": "4.11.0",
   "description": "The Presidium library.",
   "author": "Richard Tong",
   "license": "CFOSS",
@@ -13,6 +13,7 @@
   "files": [
     "internal",
     "AwsCredentials.js",
+    "DatabaseLoadBalancer.js",
     "DatabaseServer.js",
     "DiskHashTable.js",
     "DiskHashTableClient.js",
@@ -41,6 +42,7 @@
     "WebSocketServer.js",
     "WebSocketSecureServer.js",
     "ServerWebSocket.js",
+    "Validator.js",
     "XML.js",
     "LICENSE"
   ],