@sellout/service 0.0.1

package/.dist/BaseService.d.ts

@@ -0,0 +1,22 @@
+import { IConnectionManager, ILogManager, IServiceOpts } from "./interfaces";
+import Segment from "./Segment";
+/**
+ * Provides the abstract class for all service implementations.
+ */
+declare class BaseService {
+    opts: IServiceOpts;
+    serviceName: string;
+    connectionMgr: IConnectionManager;
+    logger: ILogManager;
+    storage: any;
+    segment: Segment;
+    collectDefaultMetrics: any;
+    constructor(opts: IServiceOpts);
+    isReady(): boolean;
+    /**
+     * Register message listeners here.
+     */
+    register(): void;
+    run(): void;
+}
+export default BaseService;

package/.dist/BaseService.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const Prometheus = require("prom-client");
+const express = require("express");
+const env_1 = require("./env");
+const Sentry = require("@sentry/node");
+const Segment_1 = require("./Segment");
+/**
+ * Provides the abstract class for all service implementations.
+ */
+class BaseService {
+    constructor(opts) {
+        this.opts = opts;
+        this.connectionMgr = this.opts.connectionMgr;
+        this.logger = this.opts.logManager;
+        this.serviceName = this.opts.serviceName;
+        this.storage = this.opts.storageManager;
+        this.segment = new Segment_1.default(env_1.SEGMENT_IO_WRITE_KEY, this.logger);
+        /**
+         * Initialize Sentry
+         */
+        if (env_1.SENTRY_DSN) {
+            this.logger.info("Sentry - Initializing with environment ${NODE_ENV}...");
+            Sentry.init({
+                dsn: env_1.SENTRY_DSN,
+                environment: env_1.NODE_ENV,
+            });
+        }
+        else {
+            this.logger.warn("Sentry - No DSN supplied, skipping initialization...");
+        }
+        // Enable/Disable Prometheus
+        if (!env_1.DISABLE_PROMETHEUS) {
+            // set up Prometheus client metrics gathering
+            const collectDefaultMetrics = Prometheus.collectDefaultMetrics;
+            // collectDefaultMetrics({ timeout: 5000 });
+            collectDefaultMetrics();
+            // initialize Express app
+            const app = express();
+            const metricsPort = 5499; // todo: parameterize this
+            // Metrics endpoint
+            app.get('/metrics', (req, res) => {
+                res.set('Content-Type', Prometheus.register.contentType);
+                res.end(Prometheus.register.metrics());
+            });
+            app.get('/readiness', (req, res) => {
+                if (this.isReady()) {
+                    res.status(200).send('OK');
+                }
+                else {
+                    res.status(500).send('Not ready');
+                }
+            });
+            // as long as the event loop is running this should run
+            app.get('/liveness', (req, res) => {
+                res.status(200).send('OK');
+            });
+            // listen for metrics requests
+            app.listen(metricsPort, () => this.logger.info(`Service '${this.serviceName}' listening for metrics requests on port ${metricsPort}.`));
+        }
+    }
+    // override to have derived classes declare non-readiness to k8s
+    isReady() {
+        return true;
+    }
+    /**
+     * Register message listeners here.
+     */
+    register() {
+        throw new Error("Not Implemented: register method in Service class.");
+    }
+    run() {
+        throw new Error("Not Implemented: run method in Service class.");
+    }
+}
+exports.default = BaseService;
+//# sourceMappingURL=BaseService.js.map

package/.dist/BaseService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseService.js","sourceRoot":"","sources":["../src/BaseService.ts"],"names":[],"mappings":";;AACA,0CAA0C;AAC1C,mCAAmC;AACnC,+BAKe;AACf,uCAAuC;AACvC,uCAAgC;AAEhC;;GAEG;AACH,MAAM,WAAW;IASf,YAAY,IAAkB;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAO,CAAC,0BAAoB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAE9D;;WAEG;QACH,IAAI,gBAAU,EAAE;YACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;YAC1E,MAAM,CAAC,IAAI,CAAC;gBACV,GAAG,EAAE,gBAAU;gBACf,WAAW,EAAE,cAAQ;aACtB,CAAC,CAAC;SACJ;aAAM;YACL,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;SAC1E;QAED,4BAA4B;QAC5B,IAAG,CAAC,wBAAkB,EAAE;YACtB,6CAA6C;YAC7C,MAAM,qBAAqB,GAAG,UAAU,CAAC,qBAAqB,CAAC;YAC/D,4CAA4C;YAC5C,qBAAqB,EAAE,CAAC;YAExB,yBAAyB;YACzB,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;YACtB,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,0BAA0B;YAEpD,mBAAmB;YACnB,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBAC/B,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;gBACxD,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;YACxC,CAAC,CAAC,CAAC;YAEH,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBACjC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE;oBAClB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;iBAC5B;qBAAM;oBACL,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;iBACnC;YACH,CAAC,CAAC,CAAC;YAEH,uDAAuD;YACvD,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBAChC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC,CAAC,CAAC;YAEH,8BAA8B;YAC9B,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,WAAW,4CAA4C,WAAW,GAAG,CAAC,CAAC,CAAC;SACzI;IACH,CAAC;IAED,gEAAgE;IACzD,OAAO;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACI,QAAQ;QACb,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAEM,GAAG;QACR,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;CACF;AAED,kBAAe,WAAW,CAAC"}

package/.dist/ConsoleLogManager.d.ts

@@ -0,0 +1,9 @@
+import { ILogManager, ILogManagerOpts } from "./interfaces";
+declare class ConsoleLogManager implements ILogManager {
+    opts: ILogManagerOpts;
+    constructor(opts: ILogManagerOpts);
+    info(msg: string, ...params: string[]): void;
+    warn(msg: string, ...params: string[]): void;
+    error(msg: string, ...params: string[]): void;
+}
+export default ConsoleLogManager;

package/.dist/ConsoleLogManager.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class ConsoleLogManager {
+    constructor(opts) {
+        this.opts = opts;
+    }
+    info(msg, ...params) {
+        console.info(msg, ...params);
+    }
+    warn(msg, ...params) {
+        console.warn(msg, ...params);
+    }
+    error(msg, ...params) {
+        console.error(msg, ...params);
+    }
+}
+exports.default = ConsoleLogManager;
+//# sourceMappingURL=ConsoleLogManager.js.map

package/.dist/ConsoleLogManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleLogManager.js","sourceRoot":"","sources":["../src/ConsoleLogManager.ts"],"names":[],"mappings":";;AAEA,MAAM,iBAAiB;IAGrB,YAAY,IAAqB;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAEM,IAAI,CAAC,GAAW,EAAE,GAAG,MAAgB;QAC1C,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;IAC/B,CAAC;IAEM,IAAI,CAAC,GAAW,EAAE,GAAG,MAAgB;QAC1C,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;IAC/B,CAAC;IAEM,KAAK,CAAC,GAAW,EAAE,GAAG,MAAgB;QAC3C,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;IAChC,CAAC;CACF;AAED,kBAAe,iBAAiB,CAAC"}

package/.dist/MongoConnectionManager.d.ts

@@ -0,0 +1,9 @@
+export default class MongoConnectionManager {
+    connected: boolean;
+    mongoConnectionString: string;
+    isReplicaSet: boolean;
+    private mongoose;
+    private mongoConnectionStringInternal;
+    constructor(mongoose: any, mongoConnectionString: string, username?: string, password?: string);
+    connect(): Promise<void>;
+}

package/.dist/MongoConnectionManager.js

@@ -0,0 +1,52 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const wait_1 = require("@sellout/utils/.dist/wait");
+class MongoConnectionManager {
+    constructor(mongoose, mongoConnectionString, username = '', password = '') {
+        const parsed = new URL(mongoConnectionString);
+        parsed.username = username;
+        parsed.password = password;
+        parsed.pathname = '/admin';
+        this.connected = false;
+        this.mongoConnectionStringInternal = parsed.toString();
+        this.isReplicaSet = parsed.protocol === 'mongodb+srv:';
+        // redact username/password from publicly available connection string
+        parsed.username = '__user__';
+        parsed.password = '__pass__';
+        this.mongoConnectionString = parsed.toString();
+        this.mongoose = mongoose;
+    }
+    connect() {
+        return __awaiter(this, void 0, void 0, function* () {
+            while (!this.connected) {
+                console.log('Attempting to connect to Mongo...');
+                this.mongoose.connect(this.mongoConnectionStringInternal, {
+                    ssl: false,
+                    useUnifiedTopology: true,
+                    useNewUrlParser: true,
+                })
+                    .then(() => {
+                    this.connected = true;
+                    console.log(`Connected to MongoDB: ${this.mongoConnectionString}`);
+                })
+                    .catch((e) => {
+                    console.error(`There was an error connecting to MongoDB: ${this.mongoConnectionString}`);
+                    console.error(e);
+                });
+                // wait five seconds before trying again
+                yield wait_1.default(5000);
+            }
+        });
+    }
+}
+exports.default = MongoConnectionManager;
+//# sourceMappingURL=MongoConnectionManager.js.map

package/.dist/MongoConnectionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongoConnectionManager.js","sourceRoot":"","sources":["../src/MongoConnectionManager.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,oDAA6C;AAE7C,MAAqB,sBAAsB;IAOzC,YAAY,QAAa,EAAE,qBAA6B,EAAE,WAAmB,EAAE,EAAE,WAAmB,EAAE;QACpG,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,qBAAqB,CAAC,CAAC;QAE9C,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC3B,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC3B,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAE3B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,6BAA6B,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvD,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,QAAQ,KAAK,cAAc,CAAC;QAEvD,qEAAqE;QACrE,MAAM,CAAC,QAAQ,GAAG,UAAU,CAAC;QAC7B,MAAM,CAAC,QAAQ,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,qBAAqB,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEY,OAAO;;YAClB,OAAM,CAAC,IAAI,CAAC,SAAS,EAAE;gBACrB,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;gBACjD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE;oBACxD,GAAG,EAAE,KAAK;oBACV,kBAAkB,EAAE,IAAI;oBACxB,eAAe,EAAE,IAAI;iBACtB,CAAC;qBACC,IAAI,CAAC,GAAG,EAAE;oBACT,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;oBACtB,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC;gBACrE,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,CAAM,EAAE,EAAE;oBAChB,OAAO,CAAC,KAAK,CAAC,6CAA6C,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC;oBACzF,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACnB,CAAC,CAAC,CAAC;gBAEL,wCAAwC;gBACxC,MAAM,cAAI,CAAC,IAAI,CAAC,CAAC;aAClB;QACH,CAAC;KAAA;CACF;AA9CD,yCA8CC"}

package/.dist/NatsConnectionManager.d.ts

@@ -0,0 +1,115 @@
+/// <reference types="node" />
+import { IConnectionManager, ILogManager, ISubscriptionRoutes } from './interfaces';
+/**
+ * Exposes connection operations for NATS.
+ */
+declare class NatsConnectionManager implements IConnectionManager {
+    /**
+     * Exception representing an error that occurred during invocation of
+     * a message handler.
+     *
+     */
+    static MESSAGE_HANDLER_ERROR: {
+        new (errors: any, messageSubject: string): {
+            errors: any;
+            name: string;
+            message: string;
+            stack?: string | undefined;
+        };
+        captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+        prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+        stackTraceLimit: number;
+    };
+    /**
+     * Exception caused by request timeout.
+     */
+    static TIMEOUT_ERROR: {
+        new (errors: any): {
+            errors: any;
+            name: string;
+            message: string;
+            stack?: string | undefined;
+        };
+        captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+        prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+        stackTraceLimit: number;
+    };
+    natsServers: string[];
+    private verbose;
+    private defaultRequestTimeout;
+    private conn;
+    private logPrefix;
+    private logger;
+    /**
+     * Manages connections to NATS servers.
+     * @constructor
+     *
+     * @param {boolean} verbose - Log all events if true
+     */
+    constructor(natsServers: string[], logger: ILogManager, verbose?: boolean, defaultRequestTimeout?: number);
+    /**
+     * Connect to one of the specified servers.
+     *
+     * @param {string[]} servers - Array of server URLs for NATS (server is randomly chosen)
+     */
+    connect(waitForConnect?: boolean): void;
+    /**
+     * Close active connections.
+     */
+    close(): void;
+    /**
+     * Expose event system of Nats client.
+     *
+     * @param event
+     * @callback cb
+     */
+    on(event: string, cb: (...args: any[]) => void): void;
+    /**
+     * Subscribes a service listener to its methods within a NATS queue.
+     *
+     * IMPORTANT: Ensure service message handlers are defined via arrow functions
+     *            to ensure instance variables of the class are accessible within
+     *            the scope of the handlers.
+     *
+     * @param service - Service Id of listener
+     * @param @optional {string} - Optional name of queue to subscribe
+     * @param {SubscriptionRoutes} routes - Mapping of method Ids to handlers
+     */
+    subscribe(serviceId: string, queue: string, routes: ISubscriptionRoutes): void;
+    subscribeBroadcast(serviceId: string, routes: ISubscriptionRoutes): void;
+    subscribeTopic(topicQualifier: string, queue: string | undefined, routes: ISubscriptionRoutes): void;
+    /**
+     * Publish request for service.
+     *
+     * @param {string} serviceId - Service Id of receipient
+     * @param {string} method - Id of method to call
+     * @param {Buffer} req - Request buffer
+     * @callback cb - Reply callback
+     * @param { number}  [timeout] - Register a default timeout for requests
+     */
+    send: (serviceId: string, method: string, req: Buffer, cb: (error: any, reply: any) => void, timeout?: number | undefined) => void;
+    /**
+     * Publish a broadcast message
+     */
+    sendBroadcast: (messageId: string, req: Buffer, cb: (error: any, reply: any) => void) => void;
+    /**
+     * Publish asynchronous request for service.
+     *
+     * @param {string} serviceId - Service Id of receipient
+     * @param {string} method - Id of method to call
+     * @param {Buffer} req - Request buffer
+     * @callback cb - Reply callback
+     */
+    sendAsync: (serviceId: string, method: string, req: Buffer, cb: (error: any, reply: any) => void) => void;
+    /**
+     * Register for logged connection events
+     */
+    private enableLogging;
+    /**
+     * Log a message
+     *
+     * @param msg
+     */
+    private logMessage;
+}
+export default NatsConnectionManager;

package/.dist/NatsConnectionManager.js

@@ -0,0 +1,215 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+const NATS = require("nats");
+const BROADCAST_PREFIX = 'BROADCAST'; /* Prefix for broadcast messages */
+/**
+ * Exposes connection operations for NATS.
+ */
+class NatsConnectionManager {
+    /**
+     * Manages connections to NATS servers.
+     * @constructor
+     *
+     * @param {boolean} verbose - Log all events if true
+     */
+    constructor(natsServers, logger, verbose = false, defaultRequestTimeout = 60000) {
+        this.logPrefix = 'NatsConnectionManager';
+        /**
+         * Publish request for service.
+         *
+         * @param {string} serviceId - Service Id of receipient
+         * @param {string} method - Id of method to call
+         * @param {Buffer} req - Request buffer
+         * @callback cb - Reply callback
+         * @param { number}  [timeout] - Register a default timeout for requests
+         */
+        // tslint:disable-next-line:max-line-length
+        this.send = (serviceId, method, req, cb, timeout) => {
+            const subject = [serviceId, method].join('.');
+            const msgId = this.conn.requestOne(subject, req, {}, timeout == null ? this.defaultRequestTimeout : timeout, (reply) => {
+                this.logMessage(`Sending message: ${subject} (${msgId})`);
+                if (reply.code && reply.code === NATS.REQ_TIMEOUT) {
+                    this.logMessage(`Reply for (${msgId}): ${JSON.stringify(reply)}`, true);
+                    const error = new NatsConnectionManager.TIMEOUT_ERROR({
+                        message: `Timeout sending request: ${subject} (${msgId})`,
+                    });
+                    cb(error, null);
+                    return;
+                }
+                this.logMessage(`Received reply: ${subject} (${msgId})`);
+                cb(null, reply);
+            });
+        };
+        /**
+         * Publish a broadcast message
+         */
+        this.sendBroadcast = (messageId, req, cb) => {
+            return this.sendAsync(BROADCAST_PREFIX, messageId, req, cb);
+        };
+        /**
+         * Publish asynchronous request for service.
+         *
+         * @param {string} serviceId - Service Id of receipient
+         * @param {string} method - Id of method to call
+         * @param {Buffer} req - Request buffer
+         * @callback cb - Reply callback
+         */
+        this.sendAsync = (serviceId, method, req, cb) => {
+            const subject = [serviceId, method].join('.');
+            this.conn.publish(subject, req, (reply) => {
+                this.logMessage(`Queued message: ${subject}`);
+                // NATS always returns "undefined" for publish, since reply is N/A.
+                // Protobuf Services require _some_ kind of Type (cannot be undefined or void).
+                // thus, return an empty `<Buffer >` here, which can be marshalled to the `google.protobuf.Empty` type.
+                const empty = Buffer.from([]);
+                cb(null, empty);
+            });
+        };
+        this.logger = logger;
+        this.natsServers = natsServers;
+        this.verbose = verbose;
+        if (process.env.NATS_TIMEOUT) {
+            this.defaultRequestTimeout = parseInt(process.env.NATS_TIMEOUT, 10);
+        }
+        else {
+            this.defaultRequestTimeout = defaultRequestTimeout;
+        }
+    }
+    /**
+     * Connect to one of the specified servers.
+     *
+     * @param {string[]} servers - Array of server URLs for NATS (server is randomly chosen)
+     */
+    connect(waitForConnect = true) {
+        const opts = {};
+        opts.servers = this.natsServers;
+        opts.preserveBuffers = true;
+        opts.verbose = this.verbose;
+        opts.waitOnFirstConnect = waitForConnect;
+        opts.maxReconnectAttempts = -1; /* Infinite reconnect attempts */
+        this.conn = NATS.connect(opts);
+        this.enableLogging();
+    }
+    /**
+     * Close active connections.
+     */
+    close() {
+        this.conn.close();
+    }
+    /**
+     * Expose event system of Nats client.
+     *
+     * @param event
+     * @callback cb
+     */
+    on(event, cb) {
+        this.conn.on(event, cb);
+    }
+    /**
+     * Subscribes a service listener to its methods within a NATS queue.
+     *
+     * IMPORTANT: Ensure service message handlers are defined via arrow functions
+     *            to ensure instance variables of the class are accessible within
+     *            the scope of the handlers.
+     *
+     * @param service - Service Id of listener
+     * @param @optional {string} - Optional name of queue to subscribe
+     * @param {SubscriptionRoutes} routes - Mapping of method Ids to handlers
+     */
+    subscribe(serviceId, queue, routes) {
+        this.logMessage(`Subscribing handlers for service='${serviceId}', queue='${queue}'`);
+        const topic = [serviceId, '>'].join('.');
+        return this.subscribeTopic(topic, queue, routes); /* Match all topics containing Service Id */
+    }
+    subscribeBroadcast(serviceId, routes) {
+        const routeNames = Object.keys(routes);
+        this.logMessage(`Subscribing handlers for broadcast: [${routeNames.join(', ')}]`);
+        routeNames.forEach((r) => {
+            const topic = [BROADCAST_PREFIX, r].join('.');
+            const queue = `${serviceId}-${r}`;
+            this.subscribeTopic(topic, queue, { [r]: routes[r] });
+        });
+    }
+    subscribeTopic(topicQualifier, queue, routes) {
+        const opts = {};
+        opts.queue = queue;
+        this.conn.subscribe(topicQualifier, opts, (req, reply, subject) => {
+            const method = subject.substring(subject.indexOf('.') + 1);
+            const handler = routes[method];
+            this.logMessage(`Receive message: full subject=${subject}, method=${method}, replyTo=${reply} `);
+            handler.process(req).then((resp) => {
+                if (reply) {
+                    this.logMessage(`Publishing reply: ${reply}`);
+                    this.conn.publish(reply, resp);
+                }
+                else {
+                    this.logMessage('No reply required');
+                }
+            }, (reason) => {
+                this.logMessage(`Handler failed. Reason= ${reason}`, false);
+                throw new NatsConnectionManager.MESSAGE_HANDLER_ERROR(reason, subject);
+            });
+        });
+    }
+    /**
+     * Register for logged connection events
+     */
+    enableLogging() {
+        /**
+         * GENERIC ERROR LOGGING
+         */
+        this.conn.on('error', (err) => {
+            this.logMessage(err, false);
+        });
+        if (!this.verbose) {
+            return;
+        }
+        /**
+         * VERBOSE EVENT LOGGING
+         */
+        this.conn.on('connect', (conn) => {
+            this.logMessage(`Connection established to ${conn.currentServer.url.host}`);
+        });
+        this.conn.on('disconnect', () => {
+            this.logMessage('Disconnected', false);
+        });
+        this.conn.on('reconnect', () => {
+            this.logMessage('Reconnected', false);
+        });
+        this.conn.on('close', () => {
+            this.logMessage('Connection closed');
+        });
+    }
+    /**
+     * Log a message
+     *
+     * @param msg
+     */
+    logMessage(msg, info = true) {
+        if (!info || this.verbose) {
+            this.logger.info(`(${this.logPrefix}) ${msg}`);
+        }
+    }
+}
+/**
+ * Exception representing an error that occurred during invocation of
+ * a message handler.
+ *
+ */
+NatsConnectionManager.MESSAGE_HANDLER_ERROR = class extends Error {
+    constructor(errors, messageSubject) {
+        super(`Error from message handler for '${messageSubject}'. Reason = ${JSON.stringify(errors)}`);
+        this.errors = errors;
+    }
+};
+/**
+ * Exception caused by request timeout.
+ */
+NatsConnectionManager.TIMEOUT_ERROR = class extends Error {
+    constructor(errors) {
+        super('NATS Timeout');
+        this.errors = errors;
+    }
+};
+exports.default = NatsConnectionManager;
+//# sourceMappingURL=NatsConnectionManager.js.map

package/.dist/NatsConnectionManager.js.map

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

package/.dist/PbAsyncMessageHandler.d.ts

@@ -0,0 +1,15 @@
+import { PbMessageHandler } from './PbMessageHandler';
+/**
+ * Provides a wrapper around asynchronous Protobuf messages that don't return a response.
+ * Incoming buffers are decoded, the handler method is called using staticly-compiled
+ * Protobuf definitions.
+ */
+export declare class PbAsyncMessageHandler extends PbMessageHandler {
+    /**
+     * @constructor
+     * @param method - Message handler method to be invoked
+     * @param requestCls - Request class provided by Protobuf
+     */
+    constructor(method: any, requestCls: any);
+}
+export default PbAsyncMessageHandler;

package/.dist/PbAsyncMessageHandler.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const pb = require("@sellout/models/.dist/sellout-proto");
+const PbMessageHandler_1 = require("./PbMessageHandler");
+/* Message handler wrapper method for unidirectional calls */
+function invokeWithEmptyResponse(method) {
+    return (req) => method(req).then(() => Promise.resolve(pb.google.protobuf.Empty.create()));
+}
+/**
+ * Provides a wrapper around asynchronous Protobuf messages that don't return a response.
+ * Incoming buffers are decoded, the handler method is called using staticly-compiled
+ * Protobuf definitions.
+ */
+class PbAsyncMessageHandler extends PbMessageHandler_1.PbMessageHandler {
+    /**
+     * @constructor
+     * @param method - Message handler method to be invoked
+     * @param requestCls - Request class provided by Protobuf
+     */
+    constructor(method, requestCls) {
+        super(invokeWithEmptyResponse(method), requestCls, pb.google.protobuf.Empty);
+    }
+}
+exports.PbAsyncMessageHandler = PbAsyncMessageHandler;
+exports.default = PbAsyncMessageHandler;
+//# sourceMappingURL=PbAsyncMessageHandler.js.map

package/.dist/PbAsyncMessageHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PbAsyncMessageHandler.js","sourceRoot":"","sources":["../src/PbAsyncMessageHandler.ts"],"names":[],"mappings":";;AAAA,0DAA0D;AAC1D,yDAAsD;AAGtD,6DAA6D;AAC7D,SAAS,uBAAuB,CAAC,MAAM;IACrC,OAAO,CAAC,GAAW,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACrG,CAAC;AAED;;;;GAIG;AACH,MAAa,qBAAsB,SAAQ,mCAAgB;IAEzD;;;;OAIG;IACH,YAAY,MAAM,EAAE,UAAU;QAC5B,KAAK,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/E,CAAC;CAEF;AAXD,sDAWC;AAED,kBAAe,qBAAqB,CAAC"}

package/.dist/PbBroadcastProxy.d.ts

@@ -0,0 +1,25 @@
+import { Broadcast } from "@sellout/models/.dist/sellout-proto";
+import { IConnectionManager } from './interfaces';
+import { PbServiceProxy } from './PbServiceProxy';
+export default class PbBroadcastProxy extends PbServiceProxy<Broadcast.Publisher> {
+    constructor(conn: IConnectionManager);
+    activate(svc?: any): Broadcast.Publisher;
+    /**
+     * Provides handler logic for RPC sender. Note: use of arrow function
+     * required to maintain instance context.
+     *
+     * @param method
+     * @param requestData
+     * @param callback
+     */
+    protected sendRpcImpl: (method: any, requestData: any, callback: any) => never;
+    /**
+     * Provides handler logic for RPC sender. Note: use of arrow function
+     * required to maintain instance context.
+     *
+     * @param method
+     * @param requestData
+     * @param callback
+     */
+    protected sendRpcImplAsync: (method: any, requestData: any, callback: any) => void;
+}

package/.dist/PbBroadcastProxy.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const sellout_proto_1 = require("@sellout/models/.dist/sellout-proto");
+const PbServiceProxy_1 = require("./PbServiceProxy");
+class PbBroadcastProxy extends PbServiceProxy_1.PbServiceProxy {
+    constructor(conn) {
+        super(conn, 'BROADCAST');
+        /**
+         * Provides handler logic for RPC sender. Note: use of arrow function
+         * required to maintain instance context.
+         *
+         * @param method
+         * @param requestData
+         * @param callback
+         */
+        this.sendRpcImpl = (method, requestData, callback) => {
+            throw ('PbBroadcastProxy does not support synchronous calls');
+        };
+        /**
+         * Provides handler logic for RPC sender. Note: use of arrow function
+         * required to maintain instance context.
+         *
+         * @param method
+         * @param requestData
+         * @param callback
+         */
+        this.sendRpcImplAsync = (method, requestData, callback) => {
+            try {
+                this.conn.sendBroadcast(method.name, requestData, callback);
+            }
+            catch (e) {
+                callback(e, null);
+            }
+        };
+    }
+    activate(svc = sellout_proto_1.Broadcast.Publisher) {
+        return super.activate(svc, true);
+    }
+}
+exports.default = PbBroadcastProxy;
+//# sourceMappingURL=PbBroadcastProxy.js.map