@sera4/essentia 1.1.65 → 3.0.6

package/dist/ts/queue/index.js

@@ -0,0 +1,371 @@
+import amqp from "amqplib/callback_api.js";
+import logger from "./queue-logger.js";
+import urlParse from "url-parse";
+import { Publisher } from "./publisher.js";
+import { Subscriber } from "./subscriber.js";
+/**
+ * An interface to AMQP service
+ */
+class S4Queue {
+    constructor() {
+        this.connection = null;
+        this.connectionTestChannel = null;
+        this.retry = 10;
+        this.pubs = {};
+        this.subs = {};
+    }
+    /**
+     * Tests the connection to the service.
+     * Internally, the same connection is used for test
+     * and production code, but a separate channel is opened.
+     * Once the channel is obtained, there is an assert on the
+     * existence of a topic exchange called '--health-check--'.
+     * The following must be satisfied for the test to pass
+     * 1. must be connected
+     * 2. must have a test channel
+     * 3. must assert the exchange
+     */
+    async testConnection() {
+        if (!this.isConnected()) {
+            this.connectionTestChannel = null;
+            throw new Error("queue service not connected");
+        }
+        this.connectionTestChannel = this.connectionTestChannel || await this.connection.createChannel();
+        if (!this.connectionTestChannel) {
+            throw new Error("queue service failed to obtain a channel");
+        }
+        await this.connectionTestChannel.assertExchange("--health-check--", "topic", { durable: false });
+    }
+    /**
+     * Opens a connection to AMQP server.
+     * @param options Connection parameters. At the very least options.connectionUrl must be present.
+     */
+    async openConnection(options) {
+        logger.setEnabled(options.logEnabled || false);
+        if (this.connection) {
+            logger.warn("Already initialized");
+            return;
+        }
+        const retry = parseInt(options.retryInterval?.toString() || "10");
+        this.retry = retry || 10;
+        logger.debug("Attempting connection...");
+        // The docs say there is amqp.connect returning
+        // a promise, but this version doesn't seem to like
+        // when a callback isn't provided, therefore run
+        // in a new Promise
+        return new Promise((resolve, reject) => {
+            // We may run into issues with SNI TLS if
+            // we host with 3rd parties using our own certs.
+            // To avoid any issues, let's parse the url
+            // and provide the server name in the socket options
+            const urlParts = urlParse(options.connectionUrl);
+            const socketOptions = { servername: urlParts.hostname };
+            amqp.connect(options.connectionUrl, socketOptions, (err, conn) => {
+                if (err) {
+                    logger.error("Error while connecting", err);
+                    logger.error("Attempting again in", this.retry, "seconds");
+                    return setTimeout(() => this.openConnection(options), this.retry * 1000);
+                }
+                this.connection = conn;
+                if (!this.connection) {
+                    return reject(new Error("Failed to obtain connection"));
+                }
+                else {
+                    this.updatePubsAndSubsConnectionRef(conn);
+                }
+                this.connection.on("error", (err) => {
+                    logger.error("connection error", err);
+                    // Do not attempt to reconnect as the
+                    // 'close' event will also be emitted
+                    // if this error closes the connection
+                });
+                this.connection.on("close", (err) => {
+                    logger.error("connection closed");
+                    this.connection = null;
+                    if (err) {
+                        logger.error("connection closed due to error:", err);
+                        logger.error("Reconnecting in", this.retry, "seconds");
+                        setTimeout(() => this.openConnection(options), this.retry * 1000);
+                    }
+                    else {
+                        // If there was no error, it is us who closed
+                        // this connection, thus a reconnection will not
+                        // be attempted.
+                        logger.debug("Will not re-attempt");
+                    }
+                });
+                logger.debug("Connected");
+                resolve();
+            });
+        });
+    }
+    /**
+     * Closes the connection to AMQP server
+     * and clears the registered publishers
+     * and subscribers
+     */
+    async closeConnection() {
+        return new Promise((resolve, reject) => {
+            if (!this.connection) {
+                return resolve();
+            }
+            this.connection.close((err) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    this.subs = {};
+                    this.pubs = {};
+                    this.connection = null;
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Returns whether we have an active connection
+     * or not.
+     */
+    isConnected() {
+        return this.connection != null && typeof (this.connection) != 'undefined';
+    }
+    /**
+     * @deprecated Use registerPublisher
+     * Registers a new direct publisher on the given exchange.
+     * If exchange doesn't exist, one will be created.
+     * @param exchange the name of the exchange on AMQP service.
+     */
+    async registerDirectPublisher(exchange) {
+        return this.registerPublisher({ exchange: { name: exchange, type: "direct" } });
+    }
+    /**
+     * @deprecated Use registerPublisher
+     * Registers a new topic publisher on the given exchange.
+     * If exchange doesn't exist, one will be created.
+     * @param exchange the name of the exchange on AMQP service.
+     */
+    async registerTopicPublisher(exchange) {
+        return this.registerPublisher({ exchange: { name: exchange, type: "topic" } });
+    }
+    /**
+     * @deprecated Use registerPublisher
+     * Registers a new fanout publisher on the given exchange.
+     * If exchange doesn't exist, one will be created.
+     * @param exchange the name of the exchange on AMQP service.
+     */
+    async registerFanoutPublisher(exchange) {
+        return this.registerPublisher({ exchange: { name: exchange, type: "fanout" } });
+    }
+    /**
+     * Registers a new publisher
+     * @param options connection options.
+     */
+    async registerPublisher(options) {
+        const { exchange } = options;
+        const { name } = exchange;
+        if (Object.keys(this.pubs).includes(name)) {
+            throw new Error(`Publisher ${name} already registered`);
+        }
+        const p = new Publisher(exchange, name);
+        await p.init(this.connection);
+        this.pubs[name] = p;
+    }
+    /**
+     * Checks whether or not a publisher with given parameters
+     * has been registered already
+     * @param exchange the name of the exchange.
+     * @returns true if registered already, false otherwise
+     */
+    hasPublisher(exchange) {
+        return Object.keys(this.pubs).includes(exchange);
+    }
+    /**
+     * Removes a previously registered publisher
+     * @param options
+     */
+    async unregisterPublisher(options) {
+        const { exchange } = options;
+        const { name } = exchange;
+        if (!Object.keys(this.pubs).includes(name)) {
+            throw new Error(`Publisher ${name} not registered`);
+        }
+        const p = this.pubs[name];
+        await p.closeChannel();
+        delete this.pubs[name];
+        logger.debug("Unregistered publisher", name);
+    }
+    /**
+     * @deprecated Use registerSubscriber
+     * Registers a new direct subscriber on a given exchange and queue.
+     * If exchange and queue don't exists, they'll be created
+     * and bound through the provided routing key.
+     * @param exchange the name of the exchange.
+     * @param queue the name of the queue.
+     * @param key the name of the routing key.
+     */
+    async registerDirectSubscriber(exchange, queue, key) {
+        const options = {
+            key,
+            exchange: { name: exchange, type: "direct" },
+            queue: { name: queue }
+        };
+        return this.registerSubscriber(options);
+    }
+    /**
+     * @deprecated Use registerSubscriber
+     * Registers a new topic subscriber on a given exchange and queue.
+     * If exchange and queue don't exists, they'll be created
+     * and bound through the provided routing key.
+     * @param exchange the name of the exchange.
+     * @param queue the name of the queue.
+     * @param key the name of the routing key.
+     */
+    async registerTopicSubscriber(exchange, queue, key) {
+        const options = {
+            key,
+            exchange: { name: exchange, type: "topic" },
+            queue: { name: queue }
+        };
+        return this.registerSubscriber(options);
+    }
+    /**
+     * An overloaded version of registering a subscriber
+     * allowing for more fine tuned parameters
+     * @param options subscribing options
+     */
+    async registerSubscriber(options) {
+        const { exchange, queue, key } = options;
+        const name = `${exchange.name}-${queue.name}-${key}`;
+        if (Object.keys(this.subs).includes(name)) {
+            throw new Error(`Subscriber ${name} already registered`);
+        }
+        const s = new Subscriber(exchange, queue, key, name);
+        await s.init(this.connection);
+        this.subs[name] = s;
+    }
+    /**
+     * Checks whether or not a subscriber with given parameters
+     * has been registered already
+     * @param exchange the name of the exchange.
+     * @param queue the name of the queue.
+     * @param key the name of the routing key.
+     * @returns true if registered already, false otherwise
+     */
+    hasSubscriber(exchange, queue, key) {
+        const name = `${exchange}-${queue}-${key}`;
+        return Object.keys(this.subs).includes(name);
+    }
+    /**
+     * Removes a previously registered subscriber
+     * @param options
+     */
+    async unregisterSubscriber(options) {
+        const { exchange, queue, key } = options;
+        const name = `${exchange.name}-${queue.name}-${key}`;
+        if (!Object.keys(this.subs).includes(name)) {
+            throw new Error(`Subscriber ${name} not registered`);
+        }
+        const s = this.subs[name];
+        await s.closeChannel();
+        delete this.subs[name];
+        logger.debug("Unregistered subscriber", name);
+    }
+    /**
+     * Publishes a message on a given exchange with routing key.
+     * @param exchange the name of the exchange.
+     * @param key the name of the routing key.
+     * @param msg a JSON object as the message.
+     */
+    async publishDirectMessage(exchange, key, msg) {
+        return this.publishMessage(exchange, key, msg);
+    }
+    /**
+     * Publishes a message on a given exchange with a topic.
+     * @param exchange the name of the exchange.
+     * @param topic the name of the topic.
+     * @param msg a JSON object as the message.
+     */
+    async publishTopicMessage(exchange, topic, msg) {
+        return this.publishMessage(exchange, topic, msg);
+    }
+    /**
+     * Publish a message to the exchange
+     * @param exchange name of exchange
+     * @param key name of the key or topic
+     * @param msg payload to be published
+     */
+    async publishMessage(exchange, key, msg) {
+        if (!key) {
+            throw new Error(`Key argument not defined`);
+        }
+        const p = this.pubs[exchange];
+        if (!p) {
+            throw new Error(`No PUB for ${exchange} found`);
+        }
+        let content = msg;
+        if (content.constructor !== ({}).constructor) {
+            // if not in JSON format, let's make it so
+            content = {
+                msg: msg
+            };
+        }
+        return await p.publish({ key, content });
+    }
+    /**
+     * Binds an exchange to a queue
+     * @param exchange the name of the exchange.
+     * @param queue the name of the queue.
+     * @param pattern (optional) pattern for routing key
+     */
+    async bindQueueToExchange(exchange, queue, pattern) {
+        const p = this.pubs[exchange];
+        if (!p) {
+            throw new Error(`No PUB for ${exchange} found`);
+        }
+        if (!queue) {
+            throw new Error(`Binding a queue requires a queue name`);
+        }
+        return await p.bindQueue(queue, pattern || "");
+    }
+    /**
+     * Adds a listener for a specific key.
+     * If a subscriber that was registered was found
+     * with that key, the listener is added, otherwise
+     * it's ignored
+     * @param key AMQP routing key
+     * @param listener callback
+     */
+    addMessageListener(key, listener) {
+        Object.keys(this.subs).forEach(k => {
+            const s = this.subs[k];
+            if (s.key === key) {
+                s.registerCallback(listener);
+            }
+        });
+    }
+    /**
+     * Updates the connection reference to all the previously
+     * registered publishers and subscribers.
+     * After we successfully establish a connection and register pubs/subs,
+     * it's possible for the connection to break. This object will try
+     * to re-establish a new connection every 3 seconds (or whatever configuration is set)
+     * and if a new connection is established, we need to pass that connection to
+     * all our pubs/subs, otherwise they'll be operating with old/stale references
+     * @param connRef a new connection reference to the AMQP service
+     */
+    updatePubsAndSubsConnectionRef(connRef) {
+        Object.keys(this.pubs).forEach(k => {
+            logger.debug(`Updating publisher ${k} with a new connection object`);
+            const p = this.pubs[k];
+            p.init(connRef);
+        });
+        Object.keys(this.subs).forEach(k => {
+            logger.debug(`Updating subscriber ${k} with a new connection object`);
+            const s = this.subs[k];
+            s.init(connRef);
+        });
+    }
+}
+const queue = new S4Queue();
+export default queue;
+//# sourceMappingURL=index.js.map

package/dist/ts/queue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../ts/queue/index.ts"],"names":[],"mappings":"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"}

package/dist/ts/queue/publisher.d.ts

@@ -0,0 +1,41 @@
+interface Exchange {
+    name: string;
+    type: string;
+    options?: any;
+}
+interface PublishMessage {
+    key: string;
+    content: any;
+}
+/**
+ * A publisher for AMQP service
+ */
+export declare class Publisher {
+    private exchange;
+    private name;
+    private channel;
+    /**
+     * @param exchange AMQP exchange configuration
+     * @param name a name to identify this publisher in the logs
+     */
+    constructor(exchange: Exchange, name: string);
+    /**
+     * Initializes this publisher with a connection
+     * and asserts the exchange exists
+     * @param conn amqp connection object
+     */
+    init(conn: any): Promise<void>;
+    /**
+     * Publishes a message to AMQP
+     * @param msg A json object to be published to AMQP.
+     * A tracking uuid for the message will be returned.
+     */
+    publish(msg: PublishMessage): Promise<string>;
+    /**
+     * Closes the channel
+     * @returns promise
+     */
+    closeChannel(): Promise<void>;
+    bindQueue(queue: string, pattern: string, args?: any): Promise<void>;
+}
+export {};

package/dist/ts/queue/publisher.js

@@ -0,0 +1,84 @@
+import logger from "./queue-logger.js";
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * A publisher for AMQP service
+ */
+export class Publisher {
+    /**
+     * @param exchange AMQP exchange configuration
+     * @param name a name to identify this publisher in the logs
+     */
+    constructor(exchange, name) {
+        this.exchange = exchange;
+        this.name = name;
+        this.channel = null;
+    }
+    /**
+     * Initializes this publisher with a connection
+     * and asserts the exchange exists
+     * @param conn amqp connection object
+     */
+    async init(conn) {
+        logger.debug(`Initializing PUB channel for ${this.name}`);
+        if (this.channel) {
+            logger.warn(`PUB channel for ${this.name} already initialized`);
+            return;
+        }
+        this.channel = await conn.createConfirmChannel();
+        if (!this.channel) {
+            throw new Error(`Cannot create PUB channel for ${this.name}`);
+        }
+        logger.debug(`Initialized PUB channel for ${this.name}`);
+        const { name, type, options } = this.exchange;
+        await this.channel.assertExchange(name, type, options);
+        this.channel.on("error", (err) => {
+            logger.debug(`Connection error for ${this.name}`, err);
+            this.channel = null;
+        });
+        this.channel.on("close", () => {
+            logger.debug(`Connection closed for ${this.name}`);
+            this.channel = null;
+        });
+    }
+    /**
+     * Publishes a message to AMQP
+     * @param msg A json object to be published to AMQP.
+     * A tracking uuid for the message will be returned.
+     */
+    async publish(msg) {
+        if (!this.channel) {
+            throw new Error(`No channel for ${this.name} to publish`);
+        }
+        const parcel = {
+            tracking_id: uuidv4(),
+            timestamp: new Date(),
+            data: msg.content
+        };
+        logger.debug("Publishing message");
+        logger.debug("Key", msg.key);
+        logger.debug("Data", parcel);
+        const content = Buffer.from(JSON.stringify(parcel));
+        const res = await this.channel.publish(this.exchange.name, msg.key, content, { persistent: true });
+        if (!res) {
+            throw new Error("Channel write buffer is full");
+        }
+        return parcel.tracking_id;
+    }
+    /**
+     * Closes the channel
+     * @returns promise
+     */
+    async closeChannel() {
+        if (this.channel) {
+            logger.debug("Closing publishing channel", this.name);
+            return this.channel.close();
+        }
+        else {
+            logger.error("Can't close a null publishing channel");
+        }
+    }
+    async bindQueue(queue, pattern, args) {
+        await this.channel.bindQueue(queue, this.exchange.name, pattern, args);
+    }
+}
+//# sourceMappingURL=publisher.js.map

package/dist/ts/queue/publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.js","sourceRoot":"","sources":["../../../ts/queue/publisher.ts"],"names":[],"mappings":"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"}

package/dist/ts/queue/queue-logger.d.ts

@@ -0,0 +1,10 @@
+interface QueueLogger {
+    debug(...args: any[]): void;
+    log(...args: any[]): void;
+    warn(...args: any[]): void;
+    info(...args: any[]): void;
+    error(...args: any[]): void;
+    setEnabled(enabled: boolean): void;
+}
+declare const helpers: QueueLogger;
+export default helpers;

package/dist/ts/queue/queue-logger.js

@@ -0,0 +1,35 @@
+import { S4Logger } from "../logger/s4-logger.js";
+const logger = new S4Logger();
+let enabled = false;
+const helpers = {
+    debug(...args) {
+        if (enabled) {
+            logger.debug(":: AMQP ::", ...args);
+        }
+    },
+    log(...args) {
+        if (enabled) {
+            logger.debug(":: AMQP ::", ...args);
+        }
+    },
+    warn(...args) {
+        if (enabled) {
+            logger.warn(":: AMQP ::", ...args);
+        }
+    },
+    info(...args) {
+        if (enabled) {
+            logger.info(":: AMQP ::", ...args);
+        }
+    },
+    error(...args) {
+        if (enabled) {
+            logger.error(":: AMQP ::", ...args);
+        }
+    },
+    setEnabled(e) {
+        enabled = e;
+    }
+};
+export default helpers;
+//# sourceMappingURL=queue-logger.js.map

package/dist/ts/queue/queue-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-logger.js","sourceRoot":"","sources":["../../../ts/queue/queue-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;AAC9B,IAAI,OAAO,GAAG,KAAK,CAAC;AAWpB,MAAM,OAAO,GAAgB;IAC3B,KAAK,CAAC,GAAG,IAAW;QAClB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,GAAG,CAAC,GAAG,IAAW;QAChB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAG,IAAW;QACjB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAG,IAAW;QACjB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,IAAW;QAClB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,UAAU,CAAC,CAAU;QACnB,OAAO,GAAG,CAAC,CAAC;IACd,CAAC;CACF,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/ts/queue/subscriber.d.ts

@@ -0,0 +1,55 @@
+interface Exchange {
+    name: string;
+    type: string;
+    options?: any;
+}
+interface Queue {
+    name: string;
+    options?: any;
+}
+interface MessagePayload {
+    metadata: any;
+    error?: any;
+    original_content?: string;
+    [key: string]: any;
+}
+type MessageCallback = (payload: MessagePayload, error?: any) => void;
+/**
+ * A subscriber for AMQP service
+ */
+export declare class Subscriber {
+    private exchange;
+    private queue;
+    private _key;
+    private name;
+    private channel;
+    private callbacks;
+    get key(): string;
+    /**
+     * Builds a subscriber
+     * @param exchange name of the AMQP exchange
+     * @param queue name of the AMQP service
+     * @param key routing key. This will be used to bind the queue to the exchange
+     * @param name a useful name to be printed in the logs
+     */
+    constructor(exchange: Exchange, queue: Queue, key: string, name: string);
+    /**
+     * Initializes the subscriber on the given connection.
+     * During this call, the exchange and the queues are asserted
+     * and bound via the key provided in the constructor.
+     * @param conn amqp connection object
+     */
+    init(conn: any): Promise<void>;
+    /**
+     * Closes the channel
+     * @returns promise
+     */
+    closeChannel(): Promise<void>;
+    /**
+     * Register a new callback to receive message through this
+     * subscriber object
+     * @param cb A callback to be called when a message arrives
+     */
+    registerCallback(cb: MessageCallback): void;
+}
+export {};