@brickert/kerio-connect-api 0.0.4 → 0.0.5

package/index.d.ts

@@ -72,6 +72,7 @@ export interface GenericResponse {
             }
         }
         result?: {
+            viewport?: Array;
             userDetails?: object;
             list?: Array<object> | Array<IPAddressGroupItem>;
             totalItems?: number;
@@ -104,6 +105,7 @@ export class Kerio extends WebClient {
 
     IPAddressGroups: IPAddressGroup;
     Session: Session;
+    Logs: Logs;
 
     login(user: KerioUser): void;
 
@@ -243,4 +245,21 @@ export interface KerioInstanceUserResponse {
     roles: {
         userRole: string;
     }
+}
+
+export class Logs extends KerioModules {
+    /**
+     * Get logs from the specified log and number of most recent lines. Defaults to the last 5 security logs.
+     * @param logName 
+     * @param line_count
+     * @returns An array of log lines structured with timestamp (DD/MMM/YYYY HH:MM:SS) in Kerio Connect's server timezone and the message
+     */
+    list(logName: logName, line_count: number): Promise<Array<LogLineObject>>;
+}
+
+export type logName = "config" | "debug" | "error" | "mail" | "security" | "spam" | "warning";
+
+export interface LogLineObject {
+    timestamp: string;
+    message: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brickert/kerio-connect-api",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "An unofficial API wrapper for Kerio Connect Mail Server jsonrpc Admin API.",
   "keywords": [
     "kerio",

package/src/ipaddressgroups.js

@@ -358,6 +358,13 @@ export class IPAddressGroup extends KerioModules {
         }
     }
 
+    /**
+     * Remove IPAddressGroupItem(s) of type 'host' by the description name from this group name. TAKE CARE as this will remove all items upto the specified max limit that share the same name. You may limit number of items to remove. They are sorted by their unique ID.
+     * @param {string} description Name of the group item(s)
+     * @param {string} group_name Name of the IPAddressGroup string to remove from
+     * @param {number} remove_limit Max number of group items to remove upto. Specifying -1 will remove ALL by the description name
+     * @returns Returns an array of host IP addresses that were removed
+     */
     async removeHostFromIPAddressGroupByDesc(description = null, group_name = null, remove_limit = 1) {
         try {
 

package/src/kerio.js

@@ -1,4 +1,5 @@
 import { IPAddressGroup } from "./ipaddressgroups.js";
+import { Logs } from "./logs.js";
 import { Session } from "./session.js";
 import { WebClient } from "./client.js";
 import { CronJob } from 'cron';
@@ -21,6 +22,8 @@ export class Kerio extends WebClient {
 
         this.IPAddressGroups = new IPAddressGroup(this);
 
+        this.Logs = new Logs(this);
+
         this.Session = new Session(this);
 
         this.logger = pino({

package/src/logs.js

@@ -0,0 +1,107 @@
+import { KerioModules } from './modules.js';
+
+/**
+ * @type {import('../index.js').Logs}
+ */
+export class Logs extends KerioModules {
+
+    /**
+     * Get logs from the specified log and number of most recent lines. Defaults to the last 5 security logs.
+     * @param {import('../index.js').logName} logName
+     * @param {number} line_count 
+     * @returns {Promise<Array<import('../index.js').LogLineObject>>} An array of log lines structured with timestamp (DD/MMM/YYYY HH:MM:SS) in Kerio Connect's server timezone and the message
+     */
+    async list(logName = "security", line_count = 5) {
+        try {
+
+            if (!this.instance.logged_in) {
+
+                this.reset();
+
+                throw {
+                    name: "KerioClientSessionError",
+                    message: `Kerio session invalid. Try logging in again.`,
+                    type: 'Kerio',
+                    from: "Kerio.Logs.list"
+                }
+            }
+
+            if (!Number.isInteger(line_count) && line_count < 0) {
+                throw {
+                    name: "KerioLogListCountError",
+                    message: `Invalid log line count while processing API method 'Logs.get' for log '${logName}'`,
+                    type: 'Kerio',
+                    from: "Kerio.Logs.list"
+                }
+            }
+
+            if (!["config", "debug", "error", "mail", "security", "spam", "warning"].includes(logName)) {
+                throw {
+                    name: "KerioLogNameError",
+                    message: `Invalid log name while processing API method 'Logs.get' for log '${logName}'`,
+                    type: 'Kerio',
+                    from: "Kerio.Logs.list"
+                }
+            }
+
+            let log_list_response = await this.sessionedRequest({
+                http_method: 'POST',
+                api_method: 'Logs.get',
+                auth: {
+                    cookie: this.instance.session_cookie,
+                    token: this.instance.x_token
+                },
+                body_params: {
+                    logName: logName,
+                    fromLine : -1,
+                    countLines: line_count
+                }
+            });
+
+            let response_body = log_list_response._body;
+
+            if (!response_body.result?.errors && !response_body?.error) {
+
+                var logLinesResult = new Array();
+
+                if (response_body.result.viewport.length > 0) {
+
+                    response_body.result.viewport.forEach(line => {
+
+                        let timestamp_string = line.content.split("]")[0];
+                        timestamp_string = timestamp_string.substring(1, timestamp_string.length).trim();
+
+                        let message = line.content.split("]")[1].trim();
+
+                        logLinesResult.push({
+                            timestamp: timestamp_string,
+                            message
+                        });
+
+                    });
+                }
+
+                this.instance.logger.debug({
+                    name: "KerioLogsList",
+                    message: `listed ${logLinesResult.length} log lines from Log '${logName}'`,
+                    type: 'Kerio',
+                    from: "Kerio.Logs.list"
+                });
+
+                return logLinesResult;
+
+            } else {
+                throw {
+                    name: "KerioRequestError",
+                    message: `Error occured while fetching results from API method 'Logs.get' for log '${logName}'`,
+                    type: 'Kerio',
+                    from: "Kerio.Logs.list"
+                }
+            }
+
+        } catch (e) {
+            this.instance.logger.error(e);
+            throw e;
+        }
+    }
+}