@codiac.io/codiac-cli 1.2.18

package/lib/relay/relay-container.js

@@ -0,0 +1,298 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelayContainer = void 0;
+const tslib_1 = require("tslib");
+const node_docker_api_1 = require("node-docker-api");
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const reqp = require("request-promise");
+// import * as request from 'request';
+// import { Container } from "node-docker-api/lib/container";
+const os = require("os");
+const codiac_error_1 = require("@codiac.io/codiac-common/contracts/codiac-error");
+const IBetterLogger_1 = require("@codiac.io/codiac-common/IBetterLogger");
+const cli_tools_1 = require("@codiac.io/cli-tools");
+const inversify_1 = require("inversify");
+const codiac_ops_common_1 = require("@codiac.io/codiac-ops-common");
+const child_process_1 = require("child_process");
+const DEFAULT_IMAGE_NAME = "codiacimages/codiac-relay";
+const DEFAULT_IMAGE_TAG = "1.2.33";
+const DEFUALT_CONTIANER_NAME = "codiac-relay";
+const DEFAULT_HEALTH_CHECK_URL = "http://localhost:5799/heartbeat-json"; //  /ready-state";
+const DEFAULT_RETRY_TIMOUT_IN_MINUTES = 1;
+let RelayContainer = class RelayContainer {
+    constructor(styler, logger, healthCheckUrl = DEFAULT_HEALTH_CHECK_URL, retryTimeOut = DEFAULT_RETRY_TIMOUT_IN_MINUTES, projectRoot) {
+        this.styler = styler;
+        this.logger = logger;
+        this.healthCheckUrl = healthCheckUrl;
+        this.retryTimeOut = retryTimeOut;
+        this.projectRoot = projectRoot;
+        this.imageName = DEFAULT_IMAGE_NAME;
+        this.imageTag = DEFAULT_IMAGE_TAG;
+        this.containerName = DEFUALT_CONTIANER_NAME;
+        this.isWin = process.platform === "win32";
+        // https://github.com/apocas/dockerode/issues/290
+        this.socketPath = this.isWin
+            ? "//./pipe/docker_engine"
+            : "/var/run/docker.sock";
+        this.startSubj = new rxjs_1.Subject();
+        this.dockerFailedSubj = new rxjs_1.Subject();
+        this.dockerSubj = new rxjs_1.Subject();
+        // started is based on the container we're trying to start
+        this.startFailedSubj = new rxjs_1.Subject();
+        this.readySubj = new rxjs_1.ReplaySubject();
+        this.readyFailed$ = new rxjs_1.Subject();
+        this.promisifyStream = (stream) => new Promise((resolve, reject) => {
+            stream.on('data', (d) => console.log(d.toString()));
+            stream.on('end', resolve);
+            stream.on('error', reject);
+        });
+        this._cliExec = new cli_tools_1.CliExec(logger);
+        this.getDocker();
+        // The api's may already be running. Let's see.
+        this.healthCheck();
+        //  If we find docker is not started, we put ourselves into a loop, asking the user to kick it on
+        this.dockerFailed$
+            .pipe((0, operators_1.delay)(10000))
+            .pipe((0, operators_1.tap)(_ => {
+            this.logger.debug("Attempting to get service again");
+            this.getDocker();
+        }))
+            .subscribe();
+        // If docker is running but the api's are not, let's try to start the container optimistically
+        (0, rxjs_1.combineLatest)([this.docker$, this.readyFailed$])
+            .pipe((0, operators_1.tap)(docker => {
+            this.execStart();
+        }))
+            .pipe((0, operators_1.takeUntil)(this.ready$))
+            .subscribe();
+        // If docker is running but the conainer failed to start. Kick on CONTAINER from image
+        (0, rxjs_1.combineLatest)([this.docker$, this.startFailed$])
+            .pipe((0, operators_1.tap)(([docker, containerName]) => {
+            this.createContainer();
+        }))
+            .subscribe();
+        // Now our pipelines are defined and hot.  We fire off the catalyst and notify user.
+        this.readyFailed$
+            .pipe((0, operators_1.take)(1))
+            .pipe((0, operators_1.tap)(() => {
+            this.logger.notice(this.styler.hilite(`Starting Services...`));
+        }))
+            .pipe((0, operators_1.tap)(() => {
+            // every three seconds we're going to health check until either ready or timeout
+            (0, rxjs_1.interval)(3000)
+                .pipe((0, operators_1.take)(100))
+                .pipe((0, operators_1.timeout)(this.retryTimeOut * 60000)) //minutes to miliseconds
+                .pipe((0, operators_1.takeUntil)(this.ready$))
+                .subscribe(() => this.healthCheck());
+        }))
+            .subscribe();
+    }
+    get start$() {
+        return this.startSubj.asObservable();
+    }
+    get dockerFailed$() {
+        return this.dockerFailedSubj.asObservable();
+    }
+    get docker$() {
+        return this.dockerSubj.asObservable();
+    }
+    get startFailed$() {
+        return this.startFailedSubj.asObservable();
+    }
+    get ready$() {
+        return this.readySubj.asObservable();
+    }
+    init() { } //  REMOVE THIS AFTER WE GET THE RELAY-CONTRACTS STRAIGHT IN THE CLI
+    healthCheck() {
+        try {
+            this.logger.debug(`Checking ${this.containerName} health now...`);
+            reqp.get(this.healthCheckUrl)
+                .then(response => {
+                this.logger.trace(`...${this.containerName} ready.`);
+                // this.watchLogs();
+                this.readySubj.next(true);
+            })
+                .catch(error => {
+                this.logger.debug(`...${this.containerName} failed to respond`);
+                this.readyFailed$.next();
+                this.startSubj.next(this.containerName);
+            });
+        }
+        catch (error) {
+            this.logger.debug("Health check failed ", JSON.stringify(error, null, 2));
+            this.readyFailed$.next();
+        }
+    }
+    stop() {
+        // fire off this command in a separate cli window
+        let cmdStop = `docker stop ${this.containerName}`;
+        let result$ = new rxjs_1.Subject();
+        result$.subscribe();
+        let options = {
+            cwd: this.projectRoot,
+            // stdio: "inherit",
+            // stdio: [process.stdin, process.stdout, process.stderr, process.st],  // TODO:  Capture stderr instead
+            shell: true
+        };
+        const ls = (0, child_process_1.spawn)(cmdStop, options);
+        // ls.stdout?.on('data', (data: any) => {
+        //   result$.next(true);
+        // });
+        // ls.stdout?.on('error', (data: any) => {
+        //   result$.next(false);
+        // });
+        // ls.on('error', (data: any) => {
+        //   result$.next(false);
+        // });
+        ls.on('close', (data) => {
+            result$.next(false);
+        });
+        return result$.asObservable();
+    }
+    remove() {
+        // fire off this command in a separate cli window
+        let cmdStop = `docker rm ${this.containerName} -f`;
+        let result$ = new rxjs_1.Subject();
+        result$.subscribe();
+        let options = {
+            cwd: this.projectRoot,
+            // stdio: "inherit",
+            // stdio: [process.stdin, process.stdout, process.stderr, process.st],  // TODO:  Capture stderr instead
+            shell: true
+        };
+        const ls = (0, child_process_1.spawn)(cmdStop, options);
+        // ls.stdout?.on('data', (data: any) => {
+        //   result$.next(true);
+        // });
+        // ls.stdout?.on('error', (data: any) => {
+        //   result$.next(false);
+        // });
+        ls.on('close', (data) => {
+            result$.next(false);
+        });
+        return result$.asObservable();
+    }
+    destroy() {
+        throw new codiac_error_1.CodiacError("Not yet implemented");
+    }
+    execStart() {
+        const containerStarted$ = new rxjs_1.Subject();
+        //Slow ya roll playboy. let her get ready
+        containerStarted$
+            .pipe((0, operators_1.concatMap)(() => this.ready$))
+            .subscribe();
+        this.docker.container.get(this.containerName).start().then(container => {
+            containerStarted$.next(true);
+        })
+            .catch(error => {
+            this.logger.debug(`Failed to start ${this.containerName}`, error);
+            this.startFailedSubj.next(this.containerName);
+        });
+    }
+    watchLogs() {
+        const container = this.docker.container.get(this.containerName);
+        container.logs({
+            follow: true,
+            stdout: true,
+            stderr: true
+        })
+            .then(stream => {
+            this.promisifyStream(stream);
+        });
+    }
+    createContainer() {
+        this.logger.debug(`Creating ${this.containerName} from image: ${this.imageName}:${this.imageTag}`);
+        const output = new rxjs_1.Subject();
+        this.docker.container.create({
+            Image: `${this.imageName}:${this.imageTag}`,
+            name: `${this.containerName}`,
+            Hostname: `${this.containerName}`,
+            ExposedPorts: {
+                "5799/tcp": {},
+                "5798/tcp": {},
+            },
+            HostConfig: {
+                Binds: [
+                    `${os.homedir}/.codiac:/root/.codiac`
+                    // `${os.homedir}/.kube:/root/.kube`,
+                    // `${os.homedir}/.azure:/root/.azure`
+                ],
+                PortBindings: {
+                    "5799/tcp": [
+                        {
+                            HostPort: "5799"
+                        }
+                    ],
+                    "5798/tcp": [
+                        {
+                            HostPort: "5798"
+                        }
+                    ]
+                },
+            },
+            Volumes: {
+                "/root/.codiac": {}
+                // "/root/.kube": {},
+                // "/root/.azure": {}
+            },
+        })
+            .then(container => {
+            output.next(container);
+            this.logger.trace(`Created ${this.containerName}`);
+            this.execStart();
+        })
+            .catch(error => {
+            if (error.statusCode == 409)
+                this.execStart(); //Already in use
+            else {
+                this.logger.debug(`Failed to create ${this.containerName}`, JSON.stringify(error, null, 2));
+                this.pullImage();
+            }
+            output.next(error);
+        });
+        output.subscribe();
+        return output.asObservable();
+    }
+    pullImage() {
+        const output = new rxjs_1.Subject();
+        this.logger.notice("Fetching Codiac Relay image. This may take a few minutes...");
+        this._cliExec.execAsyncStdOut(`docker pull ${this.imageName}:${this.imageTag}`, { cwd: this.projectRoot }, IBetterLogger_1.LogLevel.debug, true)
+            .then((fullfulled) => {
+            this.logger.debug('pull response', fullfulled);
+            this.createContainer();
+            output.next('pull complete');
+        })
+            .catch(error => {
+            this.logger.debug(`Pull Failed.`);
+        });
+        output.subscribe();
+        return output.asObservable();
+    }
+    getDocker() {
+        const docker = new node_docker_api_1.Docker({ socketPath: this.socketPath });
+        (0, rxjs_1.from)(docker.info())
+            .pipe((0, operators_1.map)((info) => {
+            if (!info)
+                throw null;
+            this.docker = docker;
+            this.dockerSubj.next(docker);
+            this.logger.debug("Docker is running");
+            return this.docker;
+        }))
+            .pipe((0, operators_1.catchError)(error => {
+            // cli.action.stop();
+            this.logger.error('Can you start docker for me?"');
+            this.dockerFailedSubj.next();
+            return (0, rxjs_1.of)(this.docker);
+        }))
+            .pipe((0, operators_1.take)(1))
+            .subscribe();
+    }
+};
+RelayContainer = tslib_1.__decorate([
+    tslib_1.__param(0, (0, inversify_1.inject)(codiac_ops_common_1.INTERFACES_OPS.IOutputStyler)),
+    tslib_1.__metadata("design:paramtypes", [Object, Object, String, Number, String])
+], RelayContainer);
+exports.RelayContainer = RelayContainer;
+//# sourceMappingURL=relay-container.js.map

package/lib/relay/relay-container.js.map

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

package/lib/relay/wsclient/relay-socket-listener.d.ts

@@ -0,0 +1,68 @@
+import { interfaces } from "inversify";
+import { IBetterLogger } from "@codiac.io/codiac-common";
+import { SocketActionHandler } from './socket-contracts';
+/** Configuration for the relay web socket client
+ * (ie: duplex comms with the relay via Websocket)  */
+export declare class RelaySocketListenerSettings {
+    constructor();
+    /** Fully qualified url of the target web socket service. */
+    url?: string | undefined;
+    /** The pause in mmilliseconds to wait after a connection failure before attempting to reconnect.  */
+    reconnectIntervalMs?: number | undefined;
+    /** The number of retries on a failed connection before throwing exception. */
+    reconnectAttempts?: number | undefined;
+}
+/**
+ * **USAGE:**
+ *
+ * At bootstrap time...
+ * ```
+ * RelaySocketListenerService.bootstrap(ioc, { reconnectIntervalMs: 2000 });
+ * ```
+ * At ctor injection...
+ * ```
+ * export class MyClass {
+ *  constructor(@inject(RelaySocketListener) private socket: RelaySocketListener) { ... }
+ *
+ *  public doSomething() {
+ *    // wire up a msg handler...
+ *    this.socket.listenFor("MyAction", msg => {
+ *      console.log(`I just got a ${msg.action}, with cid: ${msg.correlationId}`);
+ *    });
+ *
+ *    // Start listening (if its not already)
+ *    this.socket.start();
+ *  }
+ * }
+ * ```
+ */
+export declare class RelaySocketListener {
+    private logger;
+    static bootstrap(ioc: interfaces.Container, settings?: RelaySocketListenerSettings | undefined): void;
+    static readonly DEFAULT_SETTINGS: Required<RelaySocketListenerSettings>;
+    constructor(settings: RelaySocketListenerSettings, logger: IBetterLogger);
+    private readonly settings;
+    private rxWebsocketSubject;
+    /** Connects and initiates the listeners.
+     * Returns the SocketId.
+     * (IDEMPOTENT) Lazy-start: this method wont duplicate connections if it's already connected to the remote websocket server.
+     */
+    start(): Promise<string>;
+    /** (IDEMPOTENT) Lazy-stop: this method can be called even if the (one-and-only) socket is already closed. */
+    stop(): void;
+    /** Late-bound subscribers to incoming messages, mapped by `SocketAction.action`.
+     *
+     * If multiple handlers are registered for a given action,
+     * they get fired in order they subscribed (first-come first served).
+     */
+    private subscribers;
+    /** Returns the subscription id for the handler (reqd for unsubcribing).
+     */
+    listenFor(action: string, handler: SocketActionHandler): string;
+    /** Removes the given listener.  (IDEMPOTENT) Returns whether a handler was indeed removed (false if it didn't exist).
+     *
+     * Throws any exceptions. */
+    unlisten(action: string, subscriptionId: string): boolean;
+    /** Fires any registered handlers. */
+    private routeInboundMessage;
+}

package/lib/relay/wsclient/relay-socket-listener.js

@@ -0,0 +1,165 @@
+"use strict";
+var RelaySocketListener_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelaySocketListener = exports.RelaySocketListenerSettings = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("inversify");
+const _ = require("lodash");
+const guid_typescript_1 = require("guid-typescript");
+const stringify = require("json-stringify-safe");
+const codiac_common_1 = require("@codiac.io/codiac-common");
+const rx_websocket_subject_1 = require("./rx-websocket-subject");
+/** Configuration for the relay web socket client
+ * (ie: duplex comms with the relay via Websocket)  */
+let RelaySocketListenerSettings = class RelaySocketListenerSettings {
+    constructor() { }
+};
+RelaySocketListenerSettings = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__metadata("design:paramtypes", [])
+], RelaySocketListenerSettings);
+exports.RelaySocketListenerSettings = RelaySocketListenerSettings;
+/** Meta added to a message handler for facility in managing message subscribers. */
+class HandlerSubx {
+    constructor(id, handler) {
+        this.id = id;
+        this.handler = handler;
+    }
+}
+/**
+ * **USAGE:**
+ *
+ * At bootstrap time...
+ * ```
+ * RelaySocketListenerService.bootstrap(ioc, { reconnectIntervalMs: 2000 });
+ * ```
+ * At ctor injection...
+ * ```
+ * export class MyClass {
+ *  constructor(@inject(RelaySocketListener) private socket: RelaySocketListener) { ... }
+ *
+ *  public doSomething() {
+ *    // wire up a msg handler...
+ *    this.socket.listenFor("MyAction", msg => {
+ *      console.log(`I just got a ${msg.action}, with cid: ${msg.correlationId}`);
+ *    });
+ *
+ *    // Start listening (if its not already)
+ *    this.socket.start();
+ *  }
+ * }
+ * ```
+ */
+let RelaySocketListener = RelaySocketListener_1 = class RelaySocketListener {
+    static bootstrap(ioc, settings) {
+        ioc.bind(RelaySocketListenerSettings).toConstantValue(settings !== null && settings !== void 0 ? settings : {});
+        ioc.bind(RelaySocketListener_1).toSelf().inSingletonScope(); // <-- There can be only one socket connection from the CLI.
+    }
+    constructor(settings, logger) {
+        this.logger = logger;
+        /** Fires any registered handlers. */
+        this.routeInboundMessage = (msg) => {
+            var _a, _b;
+            if (msg.action) {
+                let actionMsg = msg;
+                let subxs = this.subscribers[actionMsg.action];
+                if (subxs && subxs.length > 0) {
+                    for (let subx of subxs) {
+                        try {
+                            this.logger.debug(`Handling inbound [${actionMsg.action}] SocketAction [handler id: ${subx.id}]...`);
+                            /* TODO: await */ subx.handler(actionMsg);
+                        }
+                        catch (err) {
+                            this.logger.error(`Unhandled error in [${actionMsg.action}] SocketAction handler [id: ${subx.id}]: ${(_a = err.name) !== null && _a !== void 0 ? _a : ""} ${(_b = err.message) !== null && _b !== void 0 ? _b : "(No details available)"}`);
+                        }
+                    }
+                }
+                else {
+                    this.logger.warn(`Received unhandled [${actionMsg.action}] message from [${this.settings.url}];`);
+                }
+            }
+            else {
+                this.logger.warn(`Received unrecognized WebSocket message.`, stringify(msg));
+            }
+            return msg; // <--- Do we need to return this?
+        };
+        this.settings = _.assignIn({}, RelaySocketListener_1.DEFAULT_SETTINGS, settings);
+        this.subscribers = {};
+    }
+    /** Connects and initiates the listeners.
+     * Returns the SocketId.
+     * (IDEMPOTENT) Lazy-start: this method wont duplicate connections if it's already connected to the remote websocket server.
+     */
+    start() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                // if (this.rxWebsocketSubject?.connectionStatus !== connected) {
+                if (this.rxWebsocketSubject == undefined) {
+                    this.rxWebsocketSubject = new rx_websocket_subject_1.RxWebsocketSubject(this.settings.url, this.settings.reconnectIntervalMs, this.settings.reconnectAttempts, this.routeInboundMessage, this.logger);
+                }
+                this.rxWebsocketSubject.onSocketConnection((err, socketId) => {
+                    if (err) {
+                        reject(err);
+                    }
+                    else {
+                        resolve(socketId);
+                    }
+                });
+                this.rxWebsocketSubject.connect();
+                this.rxWebsocketSubject.subscribe();
+                // }
+                // How do we observe the connection status and return the socketId once connected?
+                // resolve("fakeSocketId-123-345");
+            }));
+        });
+    }
+    /** (IDEMPOTENT) Lazy-stop: this method can be called even if the (one-and-only) socket is already closed. */
+    stop() {
+        if (this.rxWebsocketSubject) {
+            if (this.rxWebsocketSubject.closed !== true /* .isStopped ? */) {
+                this.rxWebsocketSubject.complete(); // Is this right?
+            }
+        }
+    }
+    /** Returns the subscription id for the handler (reqd for unsubcribing).
+     */
+    listenFor(action, handler) {
+        if (this.subscribers[action] == undefined) {
+            this.subscribers[action] = [];
+        }
+        let subx = {
+            id: guid_typescript_1.Guid.create().toString(),
+            handler: handler
+        };
+        this.subscribers[action].push(subx);
+        return subx.id;
+    }
+    /** Removes the given listener.  (IDEMPOTENT) Returns whether a handler was indeed removed (false if it didn't exist).
+     *
+     * Throws any exceptions. */
+    unlisten(action, subscriptionId) {
+        let existings = this.subscribers[action];
+        if (existings && existings.length > 0) {
+            let removed = _.remove(existings, x => x.id === subscriptionId);
+            return Boolean(removed.length > 0);
+        }
+        else {
+            return false;
+        }
+    }
+};
+RelaySocketListener.DEFAULT_SETTINGS = {
+    url: "ws://localhost:5798",
+    reconnectIntervalMs: 2000,
+    /** Deliberately kept short because the retry is limited to a single cli command execution,
+     * not an ongoing user session (thus it needs to fail fast).  */
+    reconnectAttempts: 5
+};
+RelaySocketListener = RelaySocketListener_1 = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__param(0, (0, inversify_1.inject)(RelaySocketListenerSettings)),
+    tslib_1.__param(1, (0, inversify_1.inject)(codiac_common_1.INTERFACES.IBetterLogger)),
+    tslib_1.__metadata("design:paramtypes", [RelaySocketListenerSettings, Object])
+], RelaySocketListener);
+exports.RelaySocketListener = RelaySocketListener;
+//# sourceMappingURL=relay-socket-listener.js.map

package/lib/relay/wsclient/relay-socket-listener.js.map

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

package/lib/relay/wsclient/relay-websocket-client.d.ts

@@ -0,0 +1,33 @@
+import { IBetterLogger } from "@codiac.io/codiac-common";
+import { interfaces } from "inversify";
+import { RelaySocketListenerSettings } from "./relay-socket-listener";
+import { SocketActionHandler } from './socket-contracts';
+import { ApiUserCreds } from "../../apis/codiac-api/common/api-user-creds";
+export declare class RelayWebsocketClient {
+    private credentials;
+    private logger;
+    static bootstrap(ioc: interfaces.Container, settings?: RelaySocketListenerSettings | undefined): void;
+    static readonly DEFAULT_SETTINGS: Required<RelaySocketListenerSettings>;
+    constructor(credentials: ApiUserCreds, settings: RelaySocketListenerSettings, logger: IBetterLogger);
+    private readonly settings;
+    private socket;
+    open(): Promise<string>;
+    close(): Promise<void>;
+    /** Late-bound subscribers to incoming messages, mapped by `SocketAction.action`.
+   *
+   * If multiple handlers are registered for a given action,
+   * they get fired in order they subscribed (first-come first served).
+   */
+    private subscribers;
+    /** Returns the subscription id for the handler (reqd for unsubcribing).
+     */
+    listenFor(action: string, handler: SocketActionHandler): string;
+    /** Removes the given listener.  (IDEMPOTENT) Returns whether a handler was indeed removed (false if it didn't exist).
+     *
+     * Throws any exceptions. */
+    unlisten(action: string, subscriptionId: string): boolean;
+    /** Fires any registered handlers.
+     * (and doesnt wait for them).
+    */
+    private routeInboundMessage;
+}