@kohost/api-client 1.0.0-beta.5 → 3.0.0-beta.100

package/README.md

@@ -0,0 +1,71 @@
+[![npm version](https://badge.fury.io/js/@kohost%2Fapi-client.svg)](https://badge.fury.io/js/@kohost%2Fapi-client) [![Use Case Synced](https://github.com/kohost/api-client/actions/workflows/sync-use-cases.yml/badge.svg?branch=master)](https://github.com/kohost/api-client/actions/workflows/sync-use-cases.yml)
+
+# Kohost API Client
+
+Kohost API Client is a Node.js and Browser library for interacting with the Kohost API. It provides a simple and convenient way to access the API, as well as standard models, schemas, commands, and events.
+
+## Installation
+
+```bash
+npm install @kohost/api-client
+```
+
+## Usage
+
+The library consists of several modules, including:
+
+- Models: Defines the models used in the API.
+- Errors: Defines the error objects returned by the API.
+- Commands: Defines the available commands for managing hosting resources.
+- Events: Defines the events emitted by the API.
+- defs: Defines the API endpoint definitions.
+- utils: Contains utility functions.
+- Client: The main http client for interacting with the API
+
+```javascript
+import { Client } from "@kohost/api-client";
+
+const kohost = new Client({
+  url: "https://localhost:8080/v3",
+  propertyId: "development",
+});
+```
+
+## Authentication
+
+Currently, the only supported mode of Authentication with the API is via an HTTP Only cookie. You can login a user via the following command to get a cookie.
+
+### Requesting a Login Token
+
+```javascript
+const email = "help@kohost.io";
+
+await kohost.RequestLoginLink({
+  data: { email },
+});
+
+/** OR via Phone **/
+
+const phone = "+17025555555";
+
+await kohost.RequestLoginLink({
+  data: { phone },
+});
+```
+
+Click the link in the email or SMS to authenticate.
+
+### Using a Token
+
+Simply use the `LoginUser` use case to provide a user ID via the `sub` parameter, along with the `token` parameter.
+
+```javascript
+const sub = "user-id-from-api";
+const token = "token-provided-by-api";
+
+await kohost.LoginUser({
+  data: { sub, token },
+});
+```
+
+A successful response will set an HTTP only cookie in the browser.

package/dist/cjs/AMQPClient/index.js

@@ -0,0 +1,296 @@
+const Errors = require("../Errors");
+const amqp = require("amqplib");
+const crypto = require("crypto");
+const isFatalError = require("amqplib/lib/connection").isFatalError;
+const debug = require("debug")("kohost:amqp-client");
+
+const HEADER_KEY_ORGANIZATION_ID = "X-Organization-Id";
+const HEADER_KEY_PROPERTY_ID = "X-Property-Id";
+const HEADER_KEY_DRIVER = "X-Driver";
+const HEADER_KEY_COMMAND_NAME = "X-Command-Name";
+const HEADER_KEY_EVENT_NAME = "X-Event-Name";
+
+const exchanges = {
+  // routes commands based on `command-name` header and in many cases `property-id` header
+  Commands: {
+    name: "kohost.commands",
+    type: "headers",
+    options: {
+      durable: true,
+    },
+  },
+  // routes events based on routing keys
+  DriverEvents: {
+    name: "kohost.events.drivers",
+    type: "topic",
+    options: {
+      durable: true,
+    },
+  },
+  AppEvents: {
+    name: "kohost.events.app",
+    type: "topic",
+    options: {
+      durable: true,
+    },
+  },
+  Direct: {
+    name: "kohost.direct",
+    type: "direct",
+    options: {
+      durable: true,
+    },
+  },
+  Replies: {
+    name: "kohost.replies",
+    type: "topic",
+    options: {
+      durable: true,
+    },
+  },
+  // dead letter exchange
+  dlx: {
+    name: "kohost.dlx",
+    type: "direct",
+  },
+};
+
+class KohostAMQPClient {
+  static get Message() {
+    return Message;
+  }
+
+  static get exchanges() {
+    return exchanges;
+  }
+  static generateCorrelationId() {
+    return crypto.randomUUID();
+  }
+
+  static validateMessage(message) {
+    if (!message) throw new Error("Message is required");
+  }
+
+  static parseError(err) {
+    let type;
+    let message;
+    let options = {};
+    if (err.message && err.type) {
+      const { message: errMessage, type: errType, ...rest } = err;
+      type = errType;
+      message = errMessage;
+      options = rest;
+    } else {
+      message = "Unknown Error";
+    }
+
+    debug("parseError", type, message, options);
+
+    switch (type) {
+      case "RequestError":
+        return new Errors.RequestError(message, options);
+
+      case "AuthenticationError":
+        return new Errors.AuthenticationError(message, options);
+
+      case "ValidationError":
+        return new Errors.ValidationError(message, options);
+
+      case "NotFoundError":
+        return new Errors.NotFoundError(message, options);
+
+      case "UnprocessableRequestError":
+        return new Errors.UnprocessableRequestError(message, options);
+
+      default:
+        return new Error(message, options);
+    }
+  }
+
+  static parseMessage(message) {
+    let error = null;
+    let data = {};
+    let query = {};
+    let context = {};
+    let headers = {};
+
+    const isCommand = message?.properties?.type === "Command";
+    const isEvent = message?.properties?.type === "Event";
+
+    const messageHeaders = message?.properties?.headers || {};
+
+    const commandName = messageHeaders[HEADER_KEY_COMMAND_NAME] || null;
+    const eventName = messageHeaders[HEADER_KEY_EVENT_NAME] || null;
+
+    if (message.content) {
+      try {
+        const payload =
+          message.properties?.contentType === "application/json"
+            ? JSON.parse(message.content.toString())
+            : message.content.toString();
+        data = payload?.data || {};
+        error = payload?.error;
+        query = payload?.query || {};
+        context = payload?.context || {};
+      } catch (error) {
+        data = message.content.toString();
+      }
+    }
+
+    if (message?.properties?.headers) {
+      const orgHeader = message.properties.headers[HEADER_KEY_ORGANIZATION_ID];
+      const propertyHeader = message.properties.headers[HEADER_KEY_PROPERTY_ID];
+      const driverHeader = message.properties.headers[HEADER_KEY_DRIVER];
+
+      if (orgHeader) {
+        context.organizationId = orgHeader;
+        headers[HEADER_KEY_ORGANIZATION_ID] = orgHeader;
+      }
+
+      if (propertyHeader) {
+        context.propertyId = propertyHeader;
+        headers[HEADER_KEY_PROPERTY_ID] = propertyHeader;
+      }
+
+      if (driverHeader) {
+        context.driver = driverHeader;
+        headers[HEADER_KEY_DRIVER] = driverHeader;
+      }
+    }
+
+    const parsed = {};
+
+    if (error) parsed.error = this.parseError(error);
+
+    parsed.data = data;
+    parsed.query = query;
+    parsed.context = context;
+    parsed.headers = headers;
+
+    if (isEvent && eventName) parsed.event = eventName;
+    else if (isCommand && commandName) parsed.command = commandName;
+
+    debug("amqp parsed %o", parsed);
+
+    return parsed;
+  }
+
+  static getMessage(message) {
+    if (!message?.content) return null;
+    const payload = JSON.parse(message.content.toString());
+    const data = payload?.data;
+    return data;
+  }
+
+  static isFatalError(err) {
+    return isFatalError(err);
+  }
+
+  async createConnection(connection, options = {}) {
+    return await amqp.connect(connection, options);
+  }
+
+  static createMessage(content) {
+    return new Message(content);
+  }
+
+  async createChannel(connection) {
+    const channel = await connection.createChannel();
+    return channel;
+  }
+
+  async assertExchange(channel, { exchange, type, options }) {
+    return await channel.assertExchange(exchange, type, options);
+  }
+
+  async assertQueue(channel, { queue, options }) {
+    return await channel.assertQueue(queue, options);
+  }
+
+  async bindQueue(channel, { queue, exchange, routingKey, args }) {
+    return await channel.bindQueue(queue, exchange, routingKey, args);
+  }
+
+  async bindExchange(channel, { source, destination, routingKey, args }) {
+    return await channel.bindExchange(destination, source, routingKey, args);
+  }
+
+  async subscribeToQueue(channel, { queue, cb, options }) {
+    return await channel.consume(queue, cb, options);
+  }
+
+  publishToExchange(channel, { exchange, routingKey, content, options }) {
+    return channel.publish(exchange, routingKey, content, options);
+  }
+}
+
+class Message {
+  constructor(content) {
+    this.toExchange = null;
+    this.content = content;
+    this.options = {
+      contentType: "application/json",
+      timestamp: Date.now(),
+    };
+    this.routingKey = "";
+  }
+
+  get correlationId() {
+    return this.options.correlationId || null;
+  }
+
+  to({ exchange }) {
+    if (typeof exchange === "undefined")
+      throw new Error("Exchange is required");
+    this.toExchange = exchange;
+    return this;
+  }
+
+  withType(type) {
+    this.options.type = type;
+    return this;
+  }
+
+  withRoutingKey(routingKey) {
+    this.routingKey = routingKey;
+    return this;
+  }
+
+  withHeaders(headers) {
+    if (!this.options.headers) this.options.headers = {};
+    this.options.headers = { ...this.options.headers, ...headers };
+    return this;
+  }
+
+  withContext(context) {
+    for (let key in context) {
+      this.withHeaders({ [key]: context[key] });
+    }
+    return this;
+  }
+
+  withCorrelationId(correlationId) {
+    this.options.correlationId = correlationId;
+    return this;
+  }
+
+  withReplyTo(queue) {
+    this.options.replyTo = queue;
+    return this;
+  }
+
+  build() {
+    let content = this.content;
+    if (content.build && typeof content.build === "function")
+      content = content.build();
+
+    return {
+      exchange: this.toExchange,
+      content: Buffer.from(JSON.stringify(content)),
+      options: this.options,
+      routingKey: this.routingKey,
+    };
+  }
+}
+
+module.exports = KohostAMQPClient;