ioredis-streams 0.0.1

package/.eslintrc.json

@@ -0,0 +1,24 @@
+{
+  "env": {
+    "es6": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/eslint-recommended"
+  ],
+  "globals": {
+    "Atomics": "readonly",
+    "SharedArrayBuffer": "readonly"
+  },
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": 6,
+    "sourceType": "module"
+  },
+  "plugins": [
+    "@typescript-eslint"
+  ],
+  "rules": {
+    "no-unused-vars": "off"
+  }
+}

package/.nycrc

@@ -0,0 +1,20 @@
+{
+  "extension": [
+      ".ts", ".js"
+  ],
+  "include": [
+      "**/interfaces/**",
+      "**/uow/**",
+      "**/utils/**"
+  ],
+  "exclude": [
+      "**/*.d.ts",
+      "**/*.spec.ts"
+  ],
+  "reporter": [
+      "html",
+      "cobertura",
+      "text"
+  ],
+  "all": true
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Zaid Al-Omari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# ioredis-streams
+redis streams with events handlers 
+
+## Contacts:
+1. Package Owner: **Zaid Al-Omari**

package/dist/index.d.ts

@@ -0,0 +1,107 @@
+import loggerFactory from '@log4js-node/log4js-api';
+import Redis from 'ioredis';
+export declare const getExistingRedisClient: (config?: {
+    host: string;
+    port: number;
+}) => Redis.Redis;
+export declare const getNewRedisClient: (config?: {
+    host: string;
+    port: number;
+}) => Redis.Redis;
+export declare class RedisStreams {
+    protected peerName: string;
+    protected groups: Map<string, Map<string, StreamGroupConsumer>>;
+    protected config: RedisStreamsConfig;
+    constructor(peerName: string, config?: Partial<RedisStreamsConfig>);
+    private getConsumerRedis;
+    private getProducerRedis;
+    private static getDefaultConfigs;
+    private buildConsumerConfigs;
+    private register;
+    private getStreamsMap;
+    group(groupName: string): ConsumerGroup;
+    private stream;
+    private _currentPipeline;
+    private getRedisPipeline;
+    private doProduce;
+}
+export interface IEvent<T, EventName extends string = string> {
+    time: number;
+    name: EventName;
+    v: string;
+    data: T;
+}
+export declare type EventProccessor = <T>(id: string, event: string, eventObj: IEvent<T>) => Promise<void>;
+export declare type DeadLetterEvent = IEvent<{
+    id: string;
+    message: string[];
+    stream: string;
+    group: string;
+}>;
+export declare type RedisStreamsConfig = {
+    redis: {
+        host: string;
+        port: number;
+    };
+    logger: loggerFactory.Logger;
+    deadLetters?: {
+        stream: string;
+        maxRetries: number;
+        maxSize: number;
+    };
+};
+export declare type RegisterConsumerConfigs = {
+    readBlockTime: number;
+    claimIdleTime: number;
+    batchSize: number;
+    mode: 'parallel' | 'serial';
+    maxLen: number;
+};
+export declare type ConsumerConfigs = RegisterConsumerConfigs & {
+    peerName: string;
+    streamName: string;
+    groupName: string;
+    logger?: loggerFactory.Logger;
+    deadLetters?: {
+        handler: (...event: DeadLetterEvent[]) => Promise<void>;
+        maxRetries: number;
+    };
+};
+export declare type EventHandler<T> = (id: string, event: IEvent<T>) => Promise<void>;
+export declare type HandleFunc = <T = any, E = string>(event: E | '*', handler: EventHandler<T>) => {
+    handle: HandleFunc;
+    consume: () => Promise<{
+        stop: () => void;
+        continue: () => void;
+    }>;
+};
+export declare type ProduceFunc = <T>(...events: IEvent<T>[]) => {
+    produceMany: ProduceFunc;
+    flush: () => Promise<void>;
+};
+export declare type StreamGroupConsumer = {
+    handle: HandleFunc;
+    produce: <T>(...events: IEvent<T>[]) => Promise<void>;
+    produceMany: ProduceFunc;
+    with: <O extends FunctionsMap<R>, R>(events: O) => WithTypedHandlers<O, R>;
+};
+export declare type ConsumerGroup = {
+    stream: (streamName: string, config?: Partial<RegisterConsumerConfigs>) => StreamGroupConsumer;
+};
+export declare type HandleFunction<O extends FunctionsMap<R>, R> = <N extends (keyof O & string)>(event: N, handler: NamedEventHandler<ReturnType<O[N], N>>) => {
+    handle: HandleFunction<O, R>;
+    consume: () => Promise<{
+        stop: () => void;
+        continue: () => void;
+    }>;
+};
+declare type WithTypedHandlers<T extends FunctionsMap<R>, R> = T & {
+    handle: HandleFunction<T, R>;
+};
+declare type UnrwapPromiseEvent<T, N extends string> = T extends Promise<IEvent<infer D>> ? IEvent<D, N> : unknown;
+declare type ReturnType<T, N extends string> = T extends (...args: any[]) => infer R ? UnrwapPromiseEvent<R, N> : unknown;
+declare type FunctionsMap<T> = {
+    [func in keyof T]: T[func];
+};
+declare type NamedEventHandler<E> = (id: string, event: E) => Promise<void>;
+export {};

package/dist/index.js

@@ -0,0 +1,356 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisStreams = exports.getNewRedisClient = exports.getExistingRedisClient = void 0;
+const log4js_api_1 = __importDefault(require("@log4js-node/log4js-api"));
+const ioredis_1 = __importDefault(require("ioredis"));
+const redisHost = process.env.REDIS_HOST;
+const redisPort = parseInt(process.env.REDIS_PORT || '0');
+const getDefaultRedisConfigs = () => {
+    if (!redisHost || redisHost === '') {
+        throw new Error('No redis connection provided (REDIS_HOST) ...');
+    }
+    if (!redisPort || redisPort === 0) {
+        throw new Error('No redis connection provided (REDIS_PORT) ...');
+    }
+    return {
+        host: process.env.REDIS_HOST || '',
+        port: parseInt(process.env.REDIS_PORT || '0')
+    };
+};
+let _redisClient;
+const getExistingRedisClient = (config = getDefaultRedisConfigs()) => {
+    if (!_redisClient) {
+        _redisClient = new ioredis_1.default(config);
+    }
+    return _redisClient;
+};
+exports.getExistingRedisClient = getExistingRedisClient;
+const getNewRedisClient = (config = getDefaultRedisConfigs()) => {
+    return new ioredis_1.default(config);
+};
+exports.getNewRedisClient = getNewRedisClient;
+class RedisStreams {
+    peerName;
+    groups = new Map();
+    config;
+    constructor(peerName, config) {
+        this.peerName = peerName;
+        this.config = RedisStreams.getDefaultConfigs(peerName, config);
+    }
+    getConsumerRedis() {
+        return (0, exports.getNewRedisClient)(this.config.redis);
+    }
+    getProducerRedis() {
+        return (0, exports.getExistingRedisClient)(this.config.redis);
+    }
+    static getDefaultConfigs(peerName, config) {
+        return Object.assign({
+            redis: getDefaultRedisConfigs(),
+            logger: log4js_api_1.default.getLogger(peerName),
+        }, config || {});
+    }
+    buildConsumerConfigs(streamName, groupName, config) {
+        return Object.assign({
+            claimIdleTime: 15000,
+            groupName,
+            batchSize: 5,
+            mode: 'parallel',
+            readBlockTime: 5000,
+            peerName: this.peerName,
+            maxLen: 100000,
+            streamName,
+            deadLetters: this.config.deadLetters ? {
+                maxRetries: this.config.deadLetters.maxRetries,
+                handler: async (...events) => {
+                    if (!this.config.deadLetters)
+                        return;
+                    const redis = this.getProducerRedis().pipeline();
+                    this.doProduce(redis, this.config.deadLetters.stream, this.config.deadLetters.maxSize, ...events);
+                    await redis.exec();
+                }
+            } : undefined
+        }, config || {});
+    }
+    register(streamName, groupName, handlers, config) {
+        const handler = async (id, event, eventObj) => {
+            let handle = handlers.get(event);
+            if (!handle)
+                handle = handlers.get('*');
+            if (!handle) {
+                this.config.logger.warn('No handler for:', groupName, streamName, event, id);
+                return;
+            }
+            ;
+            return handle(id, eventObj);
+        };
+        const newStream = new StreamConsumer(this.getConsumerRedis(), handler, config);
+        return newStream;
+    }
+    getStreamsMap(groupName) {
+        let streams = this.groups.get(groupName);
+        if (!streams) {
+            streams = new Map();
+            this.groups.set(groupName, streams);
+        }
+        return streams;
+    }
+    group(groupName) {
+        const streams = this.getStreamsMap(groupName);
+        return {
+            stream: (streamName, config) => {
+                const stream = streams.get(streamName);
+                if (stream)
+                    return stream;
+                const newStream = this.stream(streamName, groupName, config);
+                streams.set(streamName, newStream);
+                return newStream;
+            }
+        };
+    }
+    stream(streamName, groupName, config) {
+        const handlers = new Map();
+        const readyConfigs = this.buildConsumerConfigs(streamName, groupName, config);
+        const stream = this.register(streamName, groupName, handlers, readyConfigs);
+        const consume = async () => {
+            await stream.init();
+            stream.start();
+            return {
+                stop: () => stream.dispose(),
+                continue: () => { stream.start(); return; }
+            };
+        };
+        const handle = (event, handler) => {
+            handlers.set(event, handler);
+            return { handle, consume };
+        };
+        const produceMany = (...events) => {
+            const redis = this.doProduce(this.getRedisPipeline(), streamName, readyConfigs.maxLen, ...events);
+            return {
+                produceMany,
+                flush: async () => {
+                    this._currentPipeline = undefined;
+                    await redis.exec();
+                }
+            };
+        };
+        const produce = async (...events) => {
+            await this.doProduce(this.getProducerRedis().pipeline(), streamName, readyConfigs.maxLen, ...events).exec();
+        };
+        const newStream = {
+            handle,
+            produceMany,
+            produce,
+            with: (events) => augmentEvents(events, newStream)
+        };
+        return newStream;
+    }
+    _currentPipeline;
+    getRedisPipeline() {
+        if (!this._currentPipeline)
+            this._currentPipeline = this.getProducerRedis().multi();
+        return this._currentPipeline;
+    }
+    doProduce(redis, stream, maxLen, ...events) {
+        if (events.length === 0)
+            return redis;
+        for (const one of events) {
+            const eventString = JSON.stringify(one);
+            if (typeof maxLen === 'number') {
+                redis = redis.xadd(stream, 'MAXLEN', '~', String(maxLen), '*', one.name, eventString);
+            }
+            else {
+                redis = redis.xadd(stream, '*', one.name, eventString);
+            }
+        }
+        return redis;
+    }
+}
+exports.RedisStreams = RedisStreams;
+class StreamConsumer {
+    redis;
+    processEvent;
+    config;
+    logger;
+    disposing = false;
+    lastReadId = '0-0';
+    checkBacklog = true;
+    buffer;
+    constructor(redis, processEvent, config) {
+        this.redis = redis;
+        this.processEvent = processEvent;
+        this.config = config;
+        if (this.config.logger)
+            this.logger = this.config.logger;
+        else
+            this.logger = log4js_api_1.default.getLogger(this.config.streamName + ':Consumer');
+        if (!this.config.batchSize)
+            this.config.batchSize = 5;
+        this.buffer = new ConsumerBuffer({
+            ack: async (...ids) => {
+                await this.redis.xack(this.config.streamName, this.config.groupName, ...ids);
+            },
+            error: async (id, message, error) => {
+                this.logger.error(`Error during processMessage on stream '${this.config.streamName}' with id '${id}'`, error);
+            },
+            process: async (id, message) => {
+                return this.processMessage(id, message);
+            },
+            mode: this.config.mode || 'parallel',
+            size: this.config.batchSize
+        });
+    }
+    async init() {
+        await this.redis.xgroup('CREATE', this.config.streamName, this.config.groupName, '$', 'MKSTREAM').catch(err => {
+            if (!err.message.includes('BUSYGROUP')) {
+                this.logger.error(err);
+                throw err;
+            }
+        });
+        this.logger.trace('Ready...');
+    }
+    async start() {
+        this.logger.trace('Started...');
+        await this.tryReading();
+    }
+    async tryReading() {
+        while (!this.disposing) {
+            try {
+                const claimedAnything = await this.doClaim();
+                if (claimedAnything && !this.disposing)
+                    continue;
+                const dataAvaliable = await this.doRead();
+                if (dataAvaliable && !this.disposing)
+                    continue;
+            }
+            catch (err) {
+                this.logger.error('Error while tryReading', err);
+            }
+        }
+    }
+    lastTimePendingCheck = 0;
+    async doClaim() {
+        if (this.lastTimePendingCheck + this.config.claimIdleTime >= Date.now())
+            return false;
+        const result = await this.redis.xpending(this.config.streamName, this.config.groupName, 'IDLE', this.config.claimIdleTime, '-', '+', this.config.batchSize);
+        this.lastTimePendingCheck = Date.now();
+        if (!result.length)
+            return false;
+        const toBeClaimedMessages = result.map(([id]) => id);
+        const streamsEntries = await this.redis.xclaim(this.config.streamName, this.config.groupName, this.config.peerName, this.config.claimIdleTime, ...toBeClaimedMessages);
+        const deadMessages = result.reduce((p, [id, , , counter]) => {
+            return (counter >= (this.config.deadLetters?.maxRetries || Number.MAX_VALUE)) ? p.add(id) : p;
+        }, new Set());
+        if (this.config.deadLetters && deadMessages.size) {
+            this.logger.info('Dead Letters', JSON.stringify(Array.from(deadMessages)));
+            const deadStreamsEntries = streamsEntries.filter(([id]) => deadMessages.has(id));
+            await this.publishDeadLetters(...deadStreamsEntries);
+        }
+        const goodStreamsEntries = streamsEntries.filter(([id]) => !deadMessages.has(id));
+        if (goodStreamsEntries.length) {
+            this.logger.info('Claimed', goodStreamsEntries.length);
+            await this.buffer.add(...goodStreamsEntries);
+        }
+        return true;
+    }
+    async doRead() {
+        const streamsEntries = await this.redis.xreadgroup('GROUP', this.config.groupName, this.config.peerName, 'BLOCK', this.config.readBlockTime, 'COUNT', 5, 'STREAMS', this.config.streamName, this.checkBacklog ? this.lastReadId : '>');
+        if (!streamsEntries || streamsEntries.length === 0) {
+            this.checkBacklog = false;
+            return false;
+        }
+        for (const [steamName, streamEntries] of streamsEntries) {
+            if (streamEntries.length === 0) {
+                this.checkBacklog = false;
+                return false;
+            }
+            await this.buffer.add(...streamEntries);
+        }
+        return true;
+    }
+    async processMessage(id, message) {
+        const [event, value] = message;
+        const eventObj = JSON.parse(value);
+        return this.processEvent(id, event, eventObj);
+    }
+    async dispose() {
+        this.disposing = true;
+    }
+    async publishDeadLetters(...messages) {
+        if (!this.config.deadLetters)
+            return;
+        const finalEvents = messages.map(([id, message]) => {
+            return {
+                name: 'deadMessage',
+                v: '1.0.0',
+                time: Date.now(),
+                data: {
+                    id,
+                    message,
+                    stream: this.config.streamName,
+                    group: this.config.groupName,
+                },
+                by: {
+                    userId: this.config.peerName,
+                }
+            };
+        });
+        await this.config.deadLetters.handler(...finalEvents);
+    }
+}
+class ConsumerBuffer {
+    configs;
+    buffer = [];
+    constructor(configs) {
+        this.configs = configs;
+    }
+    get size() {
+        return this.configs.size;
+    }
+    async add(...rawMessages) {
+        this.buffer.push(...rawMessages);
+        return this.do();
+    }
+    isDoing = false;
+    async do() {
+        if (this.isDoing)
+            return;
+        this.isDoing = true;
+        const toBeAck = [];
+        const operations = [];
+        while (this.buffer.length) {
+            const [id, message] = this.buffer.shift();
+            const operation = this.configs.process(id, message)
+                .then(_ => {
+                toBeAck.push(id);
+            })
+                .catch(err => this.configs.error(id, message, err).catch());
+            if (this.configs.mode === 'serial') {
+                await operation;
+                await this.configs.ack(id);
+            }
+            else {
+                operations.push(operation);
+            }
+        }
+        this.isDoing = false;
+        if (this.configs.mode === 'parallel') {
+            await Promise.all(operations);
+            if (toBeAck.length) {
+                await this.configs.ack(...toBeAck);
+            }
+        }
+    }
+}
+const augmentEvents = (events, stream) => {
+    const initial = { ...events, ...stream };
+    return Object.keys(events).reduce((p, c) => {
+        p[c] = (...args) => events[c](...args).then((event) => {
+            return stream.produce(event);
+        });
+        return p;
+    }, initial);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,yEAAoD;AACpD,sDAA4B;AAE5B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;AACzC,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC;AAC1D,MAAM,sBAAsB,GAAG,GAAG,EAAE;IAClC,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,EAAE,EAAE;QAClC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;KACjE;IACD,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,CAAC,EAAE;QACjC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;KACjE;IACD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE;QAClC,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC;KAC9C,CAAA;AACH,CAAC,CAAA;AAED,IAAI,YAAyB,CAAC;AACvB,MAAM,sBAAsB,GAAG,CAAC,MAAM,GAAG,sBAAsB,EAAE,EAAE,EAAE;IAC1E,IAAI,CAAC,YAAY,EAAE;QACjB,YAAY,GAAG,IAAI,iBAAK,CAAC,MAAM,CAAC,CAAC;KAClC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AALW,QAAA,sBAAsB,0BAKjC;AAEK,MAAM,iBAAiB,GAAG,CAAC,MAAM,GAAG,sBAAsB,EAAE,EAAE,EAAE;IACrE,OAAO,IAAI,iBAAK,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC,CAAC;AAFW,QAAA,iBAAiB,qBAE5B;AAEF,MAAa,YAAY;IAKD;IAHZ,MAAM,GAAkD,IAAI,GAAG,EAAE,CAAC;IAClE,MAAM,CAAqB;IAErC,YAAsB,QAAgB,EAAE,MAAoC;QAAtD,aAAQ,GAAR,QAAQ,CAAQ;QACpC,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC;IAEO,gBAAgB;QACtB,OAAO,IAAA,yBAAiB,EAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAEO,gBAAgB;QACtB,OAAO,IAAA,8BAAsB,EAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IAEO,MAAM,CAAC,iBAAiB,CAAC,QAAgB,EAAE,MAAoC;QACrF,OAA2B,MAAM,CAAC,MAAM,CAAqB;YAC3D,KAAK,EAAE,sBAAsB,EAAE;YAC/B,MAAM,EAAE,oBAAa,CAAC,SAAS,CAAC,QAAQ,CAAC;SAC1C,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;IACnB,CAAC;IAEO,oBAAoB,CAAC,UAAkB,EAAE,SAAiB,EAAE,MAAyC;QAC3G,OAAwB,MAAM,CAAC,MAAM,CAAkB;YACrD,aAAa,EAAE,KAAK;YACpB,SAAS;YACT,SAAS,EAAE,CAAC;YACZ,IAAI,EAAE,UAAU;YAChB,aAAa,EAAE,IAAI;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAS;YACxB,MAAM,EAAE,MAAM;YACd,UAAU;YACV,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;gBACrC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU;gBAC9C,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,EAAE;oBAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW;wBAAE,OAAO;oBACrC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,CAAC;oBACjD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;oBAClG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;gBACrB,CAAC;aACF,CAAC,CAAC,CAAC,SAAS;SACd,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;IACnB,CAAC;IAEO,QAAQ,CAAC,UAAkB,EAAE,SAAiB,EAAE,QAAuC,EAAE,MAAuB;QACtH,MAAM,OAAO,GAAG,KAAK,EAAK,EAAU,EAAE,KAAmB,EAAE,QAAmB,EAAE,EAAE;YAChF,IAAI,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,CAAC,MAAM;gBAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC,MAAM,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC7E,OAAO;aACR;YAAA,CAAC;YACF,OAAO,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC9B,CAAC,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/E,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,aAAa,CAAC,SAAiB;QACrC,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE;YACZ,OAAO,GAAG,IAAI,GAAG,EAAe,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;SACrC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,SAAiB;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAC9C,OAAsB;YACpB,MAAM,EAAE,CAAC,UAAkB,EAAE,MAAyC,EAAE,EAAE;gBACxE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBACvC,IAAI,MAAM;oBAAE,OAAO,MAAM,CAAC;gBAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC7D,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;gBACnC,OAAO,SAAS,CAAC;YACnB,CAAC;SACF,CAAA;IACH,CAAC;IAEO,MAAM,CAAC,UAAkB,EAAE,SAAiB,EAAE,MAAyC;QAC7F,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;QACrD,MAAM,YAAY,GAAG,IAAI,CAAC,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;YACzB,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;gBAC5B,QAAQ,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;aAC5C,CAAA;QACH,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,CAAI,KAAmB,EAAE,OAAwB,EAAE,EAAE;YAClE,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAoB,OAAO,CAAC,CAAC;YAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC7B,CAAC,CAAC;QACF,MAAM,WAAW,GAAG,CAAI,GAAG,MAAmB,EAAE,EAAE;YAChD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,UAAU,EAAE,YAAY,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC;YAClG,OAAO;gBACL,WAAW;gBACX,KAAK,EAAE,KAAK,IAAI,EAAE;oBAChB,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;oBAClC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;gBACrB,CAAC;aACF,CAAA;QACH,CAAC,CAAA;QACD,MAAM,OAAO,GAAG,KAAK,EAAK,GAAG,MAAmB,EAAE,EAAE;YAClD,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,YAAY,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9G,CAAC,CAAA;QAED,MAAM,SAAS,GAAwB;YACrC,MAAM;YACN,WAAW;YACX,OAAO;YACP,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC;SACnD,CAAA;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,gBAAgB,CAA6B;IAC7C,gBAAgB;QACtB,IAAI,CAAC,IAAI,CAAC,gBAAgB;YAAE,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,CAAC;QACpF,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAEO,SAAS,CAAI,KAAqB,EAAE,MAAc,EAAE,MAAe,EAAE,GAAG,MAAmB;QACjG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACtC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE;YACxB,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;gBAC9B,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;aACvF;iBAAM;gBACL,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;aACxD;SACF;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AA3ID,oCA2IC;AAED,MAAM,cAAc;IAWN;IACA;IACA;IAXF,MAAM,CAAwB;IAChC,SAAS,GAAG,KAAK,CAAC;IAElB,UAAU,GAAG,KAAK,CAAC;IACnB,YAAY,GAAG,IAAI,CAAC;IAEpB,MAAM,CAAiB;IAE/B,YACY,KAAkB,EAClB,YAA6B,EAC7B,MAAuB;QAFvB,UAAK,GAAL,KAAK,CAAa;QAClB,iBAAY,GAAZ,YAAY,CAAiB;QAC7B,WAAM,GAAN,MAAM,CAAiB;QAEjC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;;YACpD,IAAI,CAAC,MAAM,GAAG,oBAAa,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,WAAW,CAAC,CAAC;QACjF,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC;YAC/B,GAAG,EAAE,KAAK,EAAE,GAAG,GAAa,EAAE,EAAE;gBAC9B,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CACnB,IAAI,CAAC,MAAM,CAAC,UAAU,EACtB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,GAAG,CAC9B,CAAC;YACJ,CAAC;YACD,KAAK,EAAE,KAAK,EAAE,EAAU,EAAE,OAAiB,EAAE,KAAY,EAAE,EAAE;gBAC3D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0CAA0C,IAAI,CAAC,MAAM,CAAC,UAAU,cAAc,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAChH,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,EAAU,EAAE,OAAiB,EAAE,EAAE;gBAC/C,OAAO,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAC1C,CAAC;YACD,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,UAAU;YACpC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CACrB,QAAQ,EACR,IAAI,CAAC,MAAM,CAAC,UAAU,EACtB,IAAI,CAAC,MAAM,CAAC,SAAS,EACrB,GAAG,EACH,UAAU,CACX,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;YACZ,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;gBACtC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACvB,MAAM,GAAG,CAAC;aACX;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAChC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;IACzB,CAAC;IAES,KAAK,CAAC,UAAU;QACxB,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE;YACtB,IAAI;gBACF,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;gBAC5C,IAAI,eAAe,IAAI,CAAC,IAAI,CAAC,SAAS;oBAAE,SAAS;gBACjD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC1C,IAAI,aAAa,IAAI,CAAC,IAAI,CAAC,SAAS;oBAAE,SAAS;aAChD;YAAC,OAAO,GAAG,EAAE;gBACZ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;aAClD;SACF;IACH,CAAC;IAED,oBAAoB,GAAG,CAAC,CAAC;IACjB,KAAK,CAAC,OAAO;QACnB,IAAI,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,IAAI,CAAC,GAAG,EAAE;YAAE,OAAO,KAAK,CAAC;QACtF,MAAM,MAAM,GAAyC,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAC5E,IAAI,CAAC,MAAM,CAAC,UAAU,EACtB,IAAI,CAAC,MAAM,CAAC,SAAS,EACrB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,EACjC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,SAAU,CACjC,CAAC;QACF,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAEjC,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QACrD,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAC5C,IAAI,CAAC,MAAM,CAAC,UAAU,EACtB,IAAI,CAAC,MAAM,CAAC,SAAS,EACrB,IAAI,CAAC,MAAM,CAAC,QAAQ,EACpB,IAAI,CAAC,MAAM,CAAC,aAAa,EACzB,GAAG,mBAAmB,CACvB,CAAC;QAEF,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,AAAD,EAAG,AAAD,EAAG,OAAO,CAAC,EAAE,EAAE;YAC1D,OAAO,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChG,CAAC,EAAE,IAAI,GAAG,EAAU,CAAC,CAAC;QAEtB,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,YAAY,CAAC,IAAI,EAAE;YAChD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC3E,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACjF,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAAC,CAAA;SACrD;QACD,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAClF,IAAI,kBAAkB,CAAC,MAAM,EAAE;YAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;YACvD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,CAAC;SAC9C;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAES,KAAK,CAAC,MAAM;QACpB,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAChD,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,EACpB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,EAClC,OAAO,EAAE,CAAC,EACV,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EACjC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAC1C,CAAC;QACF,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE;YAClD,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAC1B,OAAO,KAAK,CAAC;SACd;QACD,KAAK,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,cAAc,EAAE;YACvD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE;gBAC9B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;gBAC1B,OAAO,KAAK,CAAC;aACd;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC;SACzC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAES,KAAK,CAAC,cAAc,CAAI,EAAU,EAAE,OAAiB;QAC7D,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC;QAC/B,MAAM,QAAQ,GAAc,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;IAC/C,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,GAAG,QAA8B;QACxD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO;QACrC,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE;YACjD,OAAwB;gBACtB,IAAI,EAAE,aAAa;gBACnB,CAAC,EAAE,OAAO;gBACV,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;gBAChB,IAAI,EAAE;oBACJ,EAAE;oBACF,OAAO;oBACP,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;oBAC9B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;iBAC7B;gBACD,EAAE,EAAE;oBACF,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;iBAC7B;aACF,CAAA;QACH,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC;IACxD,CAAC;CACF;AAED,MAAM,cAAc;IAGI;IADtB,MAAM,GAAyB,EAAE,CAAC;IAClC,YAAsB,OAMrB;QANqB,YAAO,GAAP,OAAO,CAM5B;IAED,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAG,WAAiC;QAC5C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC,EAAE,EAAE,CAAC;IACnB,CAAC;IAED,OAAO,GAAG,KAAK,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAoB,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YACzB,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAG,CAAC;YAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC;iBAChD,IAAI,CAAC,CAAC,CAAC,EAAE;gBACR,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnB,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9D,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE;gBAClC,MAAM,SAAS,CAAC;gBAChB,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;aAC5B;iBAAM;gBACL,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;aAC5B;SACF;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE;YACpC,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC9B,IAAI,OAAO,CAAC,MAAM,EAAE;gBAClB,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;aACpC;SACF;IACH,CAAC;CACF;AAED,MAAM,aAAa,GAAG,CAA+B,MAAS,EAAE,MAA2B,EAAE,EAAE;IAC7F,MAAM,OAAO,GAAkD,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACxF,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACzC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAU,EAAE,EAAE;YAChE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC9B,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,CAAC;IACX,CAAC,EAAE,OAAO,CAAC,CAAA;AACb,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "ioredis-streams",
+  "version": "0.0.1",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "author": "Zaid Al-Omari",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Zaid-AlOmari/ioredis-streams"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "./node_modules/.bin/tsc --p tsconfig.json",
+    "test": "cd test; ../node_modules/.bin/tsc -p .; NODE_ENV=test ../node_modules/.bin/nyc ../node_modules/.bin/mocha '../dist-test/**/*.spec.js'",
+    "type-check": "tsc --noEmit",
+    "lint": "./node_modules/.bin/eslint src/*/*.ts --format codeframe",
+    "fix-lint": "./node_modules/.bin/eslint src/*/*.ts --fix"
+  },
+  "dependencies": {
+    "@log4js-node/log4js-api": "^1.0.2",
+    "ioredis": "^4.28.5"
+  },
+  "devDependencies": {
+    "@types/chai": "^4.2.3",
+    "@types/ioredis": "^4.28.5",
+    "@types/mocha": "^5.2.7",
+    "@types/node": "^10.12.2",
+    "@types/sinon": "^7.5.0",
+    "@typescript-eslint/eslint-plugin": "^4.22.0",
+    "@typescript-eslint/experimental-utils": "^4.22.0",
+    "@typescript-eslint/parser": "^4.22.0",
+    "chai": "^4.2.0",
+    "eslint": "^7.0.0",
+    "mocha": "^9.2.2",
+    "nyc": "^15.0.1",
+    "sinon": "^9.0.2",
+    "sinon-chai": "^3.5.0",
+    "source-map-support": "^0.5.19",
+    "typescript": "^4.6.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,488 @@
+import loggerFactory from '@log4js-node/log4js-api';
+import Redis from 'ioredis';
+
+const redisHost = process.env.REDIS_HOST;
+const redisPort = parseInt(process.env.REDIS_PORT || '0');
+const getDefaultRedisConfigs = () => {
+  if (!redisHost || redisHost === '') {
+    throw new Error('No redis connection provided (REDIS_HOST) ...')
+  }
+  if (!redisPort || redisPort === 0) {
+    throw new Error('No redis connection provided (REDIS_PORT) ...')
+  }
+  return {
+    host: process.env.REDIS_HOST || '',
+    port: parseInt(process.env.REDIS_PORT || '0')
+  }
+}
+
+let _redisClient: Redis.Redis;
+export const getExistingRedisClient = (config = getDefaultRedisConfigs()) => {
+  if (!_redisClient) {
+    _redisClient = new Redis(config);
+  }
+  return _redisClient;
+};
+
+export const getNewRedisClient = (config = getDefaultRedisConfigs()) => {
+  return new Redis(config);
+};
+
+export class RedisStreams {
+
+  protected groups: Map<string, Map<string, StreamGroupConsumer>> = new Map();
+  protected config: RedisStreamsConfig;
+
+  constructor(protected peerName: string, config?: Partial<RedisStreamsConfig>) {
+    this.config = RedisStreams.getDefaultConfigs(peerName, config);
+  }
+
+  private getConsumerRedis() {
+    return getNewRedisClient(this.config.redis);
+  }
+
+  private getProducerRedis() {
+    return getExistingRedisClient(this.config.redis);
+  }
+
+  private static getDefaultConfigs(peerName: string, config?: Partial<RedisStreamsConfig>) {
+    return <RedisStreamsConfig>Object.assign(<RedisStreamsConfig>{
+      redis: getDefaultRedisConfigs(),
+      logger: loggerFactory.getLogger(peerName),
+    }, config || {});
+  }
+
+  private buildConsumerConfigs(streamName: string, groupName: string, config?: Partial<RegisterConsumerConfigs>) {
+    return <ConsumerConfigs>Object.assign(<ConsumerConfigs>{
+      claimIdleTime: 15000,
+      groupName,
+      batchSize: 5,
+      mode: 'parallel',
+      readBlockTime: 5000,
+      peerName: this.peerName!,
+      maxLen: 100000,
+      streamName,
+      deadLetters: this.config.deadLetters ? {
+        maxRetries: this.config.deadLetters.maxRetries,
+        handler: async (...events) => {
+          if (!this.config.deadLetters) return;
+          const redis = this.getProducerRedis().pipeline();
+          this.doProduce(redis, this.config.deadLetters.stream, this.config.deadLetters.maxSize, ...events);
+          await redis.exec();
+        }
+      } : undefined
+    }, config || {});
+  }
+
+  private register(streamName: string, groupName: string, handlers: Map<string, EventHandler<{}>>, config: ConsumerConfigs) {
+    const handler = async <T>(id: string, event: string | '*', eventObj: IEvent<T>) => {
+      let handle = handlers.get(event);
+      if (!handle) handle = handlers.get('*');
+      if (!handle) {
+        this.config.logger.warn('No handler for:', groupName, streamName, event, id);
+        return;
+      };
+      return handle(id, eventObj);
+    };
+    const newStream = new StreamConsumer(this.getConsumerRedis(), handler, config);
+    return newStream;
+  }
+
+  private getStreamsMap(groupName: string) {
+    let streams = this.groups.get(groupName);
+    if (!streams) {
+      streams = new Map<string, any>();
+      this.groups.set(groupName, streams);
+    }
+    return streams;
+  }
+
+  group(groupName: string) {
+    const streams = this.getStreamsMap(groupName);
+    return <ConsumerGroup>{
+      stream: (streamName: string, config?: Partial<RegisterConsumerConfigs>) => {
+        const stream = streams.get(streamName);
+        if (stream) return stream;
+        const newStream = this.stream(streamName, groupName, config);
+        streams.set(streamName, newStream);
+        return newStream;
+      }
+    }
+  }
+
+  private stream(streamName: string, groupName: string, config?: Partial<RegisterConsumerConfigs>) {
+    const handlers = new Map<string, EventHandler<{}>>();
+    const readyConfigs = this.buildConsumerConfigs(streamName, groupName, config);
+    const stream = this.register(streamName, groupName, handlers, readyConfigs);
+    const consume = async () => {
+      await stream.init();
+      stream.start();
+      return {
+        stop: () => stream.dispose(),
+        continue: () => { stream.start(); return; }
+      }
+    };
+    const handle = <T>(event: string | '*', handler: EventHandler<T>) => {
+      handlers.set(event, <EventHandler<{}>>handler);
+      return { handle, consume };
+    };
+    const produceMany = <T>(...events: IEvent<T>[]) => {
+      const redis = this.doProduce(this.getRedisPipeline(), streamName, readyConfigs.maxLen, ...events);
+      return {
+        produceMany,
+        flush: async () => {
+          this._currentPipeline = undefined;
+          await redis.exec();
+        }
+      }
+    }
+    const produce = async <T>(...events: IEvent<T>[]) => {
+      await this.doProduce(this.getProducerRedis().pipeline(), streamName, readyConfigs.maxLen, ...events).exec();
+    }
+
+    const newStream = <StreamGroupConsumer>{
+      handle,
+      produceMany,
+      produce,
+      with: (events) => augmentEvents(events, newStream)
+    }
+    return newStream;
+  }
+
+  private _currentPipeline: Redis.Pipeline | undefined;
+  private getRedisPipeline() {
+    if (!this._currentPipeline) this._currentPipeline = this.getProducerRedis().multi();
+    return this._currentPipeline;
+  }
+
+  private doProduce<T>(redis: Redis.Pipeline, stream: string, maxLen?: number, ...events: IEvent<T>[]) {
+    if (events.length === 0) return redis;
+    for (const one of events) {
+      const eventString = JSON.stringify(one);
+      if (typeof maxLen === 'number') {
+        redis = redis.xadd(stream, 'MAXLEN', '~', String(maxLen), '*', one.name, eventString);
+      } else {
+        redis = redis.xadd(stream, '*', one.name, eventString);
+      }
+    }
+    return redis;
+  }
+}
+
+class StreamConsumer {
+
+  protected logger!: loggerFactory.Logger;
+  private disposing = false;
+
+  private lastReadId = '0-0';
+  private checkBacklog = true;
+
+  private buffer: ConsumerBuffer;
+
+  constructor(
+    protected redis: Redis.Redis,
+    protected processEvent: EventProccessor,
+    protected config: ConsumerConfigs) {
+
+    if (this.config.logger) this.logger = this.config.logger;
+    else this.logger = loggerFactory.getLogger(this.config.streamName + ':Consumer');
+    if (!this.config.batchSize) this.config.batchSize = 5;
+    this.buffer = new ConsumerBuffer({
+      ack: async (...ids: string[]) => {
+        await this.redis.xack(
+          this.config.streamName,
+          this.config.groupName, ...ids
+        );
+      },
+      error: async (id: string, message: string[], error: Error) => {
+        this.logger.error(`Error during processMessage on stream '${this.config.streamName}' with id '${id}'`, error);
+      },
+      process: async (id: string, message: string[]) => {
+        return this.processMessage(id, message);
+      },
+      mode: this.config.mode || 'parallel',
+      size: this.config.batchSize
+    });
+  }
+
+  async init() {
+    await this.redis.xgroup(
+      'CREATE',
+      this.config.streamName,
+      this.config.groupName,
+      '$',
+      'MKSTREAM'
+    ).catch(err => {
+      if (!err.message.includes('BUSYGROUP')) {
+        this.logger.error(err);
+        throw err;
+      }
+    });
+    this.logger.trace('Ready...');
+  }
+
+  async start() {
+    this.logger.trace('Started...');
+    await this.tryReading()
+  }
+
+  protected async tryReading() {
+    while (!this.disposing) {
+      try {
+        const claimedAnything = await this.doClaim()
+        if (claimedAnything && !this.disposing) continue;
+        const dataAvaliable = await this.doRead();
+        if (dataAvaliable && !this.disposing) continue;
+      } catch (err) {
+        this.logger.error('Error while tryReading', err);
+      }
+    }
+  }
+
+  lastTimePendingCheck = 0;
+  private async doClaim() {
+    if (this.lastTimePendingCheck + this.config.claimIdleTime >= Date.now()) return false;
+    const result: ([string, string, number, number])[] = await this.redis.xpending(
+      this.config.streamName,
+      this.config.groupName,
+      'IDLE', this.config.claimIdleTime,
+      '-', '+', this.config.batchSize!
+    );
+    this.lastTimePendingCheck = Date.now();
+    if (!result.length) return false;
+
+    const toBeClaimedMessages = result.map(([id]) => id);
+    const streamsEntries = await this.redis.xclaim(
+      this.config.streamName,
+      this.config.groupName,
+      this.config.peerName,
+      this.config.claimIdleTime,
+      ...toBeClaimedMessages,
+    );
+
+    const deadMessages = result.reduce((p, [id, , , counter]) => {
+      return (counter >= (this.config.deadLetters?.maxRetries || Number.MAX_VALUE)) ? p.add(id) : p;
+    }, new Set<string>());
+
+    if (this.config.deadLetters && deadMessages.size) {
+      this.logger.info('Dead Letters', JSON.stringify(Array.from(deadMessages)));
+      const deadStreamsEntries = streamsEntries.filter(([id]) => deadMessages.has(id));
+      await this.publishDeadLetters(...deadStreamsEntries)
+    }
+    const goodStreamsEntries = streamsEntries.filter(([id]) => !deadMessages.has(id));
+    if (goodStreamsEntries.length) {
+      this.logger.info('Claimed', goodStreamsEntries.length);
+      await this.buffer.add(...goodStreamsEntries);
+    }
+    return true;
+  }
+
+  protected async doRead() {
+    const streamsEntries = await this.redis.xreadgroup(
+      'GROUP', this.config.groupName,
+      this.config.peerName,
+      'BLOCK', this.config.readBlockTime,
+      'COUNT', 5,
+      'STREAMS', this.config.streamName,
+      this.checkBacklog ? this.lastReadId : '>'
+    );
+    if (!streamsEntries || streamsEntries.length === 0) {
+      this.checkBacklog = false;
+      return false;
+    }
+    for (const [steamName, streamEntries] of streamsEntries) {
+      if (streamEntries.length === 0) {
+        this.checkBacklog = false;
+        return false;
+      }
+      await this.buffer.add(...streamEntries);
+    }
+    return true;
+  }
+
+  protected async processMessage<T>(id: string, message: string[]) {
+    const [event, value] = message;
+    const eventObj: IEvent<T> = JSON.parse(value);
+    return this.processEvent(id, event, eventObj)
+  }
+
+  async dispose() {
+    this.disposing = true;
+  }
+
+  async publishDeadLetters(...messages: [string, string[]][]) {
+    if (!this.config.deadLetters) return;
+    const finalEvents = messages.map(([id, message]) => {
+      return <DeadLetterEvent>{
+        name: 'deadMessage',
+        v: '1.0.0',
+        time: Date.now(),
+        data: {
+          id,
+          message,
+          stream: this.config.streamName,
+          group: this.config.groupName,
+        },
+        by: {
+          userId: this.config.peerName,
+        }
+      }
+    });
+    await this.config.deadLetters.handler(...finalEvents);
+  }
+}
+
+class ConsumerBuffer {
+
+  buffer: [string, string[]][] = [];
+  constructor(protected configs: {
+    ack: (...id: string[]) => Promise<void>,
+    process: (id: string, message: string[]) => Promise<void>,
+    error: (id: string, message: string[], error: Error) => Promise<void>,
+    mode: 'parallel' | 'serial',
+    size: number
+  }) {
+
+  }
+
+  get size() {
+    return this.configs.size;
+  }
+
+  async add(...rawMessages: [string, string[]][]) {
+    this.buffer.push(...rawMessages);
+    return this.do();
+  }
+
+  isDoing = false;
+  async do() {
+    if (this.isDoing) return;
+    this.isDoing = true;
+    const toBeAck: string[] = [];
+    const operations: Promise<void>[] = [];
+    while (this.buffer.length) {
+      const [id, message] = this.buffer.shift()!;
+      const operation = this.configs.process(id, message)
+        .then(_ => {
+          toBeAck.push(id);
+        })
+        .catch(err => this.configs.error(id, message, err).catch());
+      if (this.configs.mode === 'serial') {
+        await operation;
+        await this.configs.ack(id);
+      } else {
+        operations.push(operation);
+      }
+    }
+    this.isDoing = false;
+    if (this.configs.mode === 'parallel') {
+      await Promise.all(operations);
+      if (toBeAck.length) {
+        await this.configs.ack(...toBeAck);
+      }
+    }
+  }
+}
+
+const augmentEvents = <T extends FunctionsMap<R>, R>(events: T, stream: StreamGroupConsumer) => {
+  const initial = <WithTypedHandlers<T, R> & StreamGroupConsumer>{ ...events, ...stream };
+  return Object.keys(events).reduce((p, c) => {
+    p[c] = (...args: any[]) => events[c](...args).then((event: any) => {
+      return stream.produce(event)
+    });
+    return p;
+  }, initial)
+}
+
+export interface IEvent<T, EventName extends string = string> {
+  time: number;
+  name: EventName;
+  v: string;
+  data: T;
+}
+
+export type EventProccessor = <T>(id: string, event: string, eventObj: IEvent<T>) => Promise<void>;
+
+export type DeadLetterEvent = IEvent<{
+  id: string,
+  message: string[],
+  stream: string,
+  group: string,
+}>;
+
+export type RedisStreamsConfig = {
+  redis: {
+    host: string,
+    port: number
+  },
+  logger: loggerFactory.Logger;
+  deadLetters?: {
+    stream: string;
+    maxRetries: number;
+    maxSize: number;
+  };
+}
+
+export type RegisterConsumerConfigs = {
+  readBlockTime: number;
+  claimIdleTime: number;
+  batchSize: number;
+  mode: 'parallel' | 'serial';
+  maxLen: number;
+};
+
+export type ConsumerConfigs = RegisterConsumerConfigs & {
+  peerName: string;
+  streamName: string;
+  groupName: string;
+  logger?: loggerFactory.Logger;
+  deadLetters?: {
+    handler: (...event: DeadLetterEvent[]) => Promise<void>
+    maxRetries: number
+  }
+}
+export type EventHandler<T> = (id: string, event: IEvent<T>) => Promise<void>;
+
+export type HandleFunc = <T = any, E = string>(event: E | '*', handler: EventHandler<T>) => {
+  handle: HandleFunc;
+  consume: () => Promise<{
+    stop: () => void;
+    continue: () => void;
+  }>;
+};
+
+export type ProduceFunc = <T>(...events: IEvent<T>[]) => {
+  produceMany: ProduceFunc;
+  flush: () => Promise<void>;
+}
+
+export type StreamGroupConsumer = {
+  handle: HandleFunc;
+  produce: <T>(...events: IEvent<T>[]) => Promise<void>;
+  produceMany: ProduceFunc;
+  with: <O extends FunctionsMap<R>, R>(events: O) => WithTypedHandlers<O, R>;
+}
+
+export type ConsumerGroup = {
+  stream: (streamName: string, config?: Partial<RegisterConsumerConfigs>) => StreamGroupConsumer;
+}
+
+export type HandleFunction<O extends FunctionsMap<R>, R> = <N extends (keyof O & string) >(event: N, handler: NamedEventHandler<ReturnType<O[N], N>>) => {
+  handle: HandleFunction<O, R>;
+  consume: () => Promise<{
+    stop: () => void;
+    continue: () => void;
+  }>;
+};
+
+type WithTypedHandlers<T extends FunctionsMap<R>, R> = T & {
+  handle: HandleFunction<T, R>
+}
+type UnrwapPromiseEvent<T, N extends string> = T extends Promise<IEvent<infer D>> ? IEvent<D, N> : unknown;
+type ReturnType<T, N extends string> = T extends (...args: any[]) => infer R ? UnrwapPromiseEvent<R, N> : unknown;
+
+type FunctionsMap<T> = {
+  [func in keyof T]: T[func];
+};
+
+type NamedEventHandler<E> = (id: string, event: E) => Promise<void>;

package/test/index.spec.ts

@@ -0,0 +1,14 @@
+import 'mocha';
+import chai from 'chai';
+import sinon from 'sinon';
+chai.use(require('sinon-chai'));
+const expect = chai.expect;
+
+
+describe('ioredis-streams', () => {
+  describe('Running ', () => {
+    it('should run', async () => {
+
+    });
+  });
+});

package/test/mocha.opts

@@ -0,0 +1,3 @@
+--require source-map-support/register
+--ui bdd
+--timeout 60000

package/test/tsconfig.json

@@ -0,0 +1,46 @@
+{
+  "compileOnSave": true,
+  "exclude": [
+    "node_modules",
+    "dist"
+  ],
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "*": [
+        "../types/*"
+      ]
+    },
+    "skipLibCheck": true,
+    /* Basic Options */
+    "target": "es5" /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017','ES2018' or 'ESNEXT'. */,
+    "module": "CommonJS" /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', or 'ESNext'. */,
+    "lib": [
+      "es2015",
+      "es2016",
+      "es2017",
+      "es2018"
+    ] /* Specify library files to be included in the compilation. */,
+    "declaration": true /* Generates corresponding '.d.ts' file. */,
+    // "declarationMap": true,                /* Generates a sourcemap for each corresponding '.d.ts' file. */
+    "sourceMap": true /* Generates corresponding '.map' file. */,
+    "outDir": "../dist-test" /* Redirect output structure to the directory. */,
+    "rootDir": ".." /* Specify the root directory of input files. Use to control the output directory structure with --outDir. */,
+    /* Strict Type-Checking Options */
+    "strict": true /* Enable all strict type-checking options. */,
+    "noImplicitAny": false /* Raise error on expressions and declarations with an implied 'any' type. */,
+    "noImplicitReturns": true /* Report error when not all code paths in function return a value. */,
+    "noFallthroughCasesInSwitch": true /* Report errors for fallthrough cases in switch statement. */,
+    /* Module Resolution Options */
+    "moduleResolution": "node" /* Specify module resolution strategy: 'node' (Node.js) or 'classic' (TypeScript pre-1.6). */,
+    "typeRoots": [
+      "../node_modules"
+    ] /* List of folders to include type definitions from. */,
+    "types": [
+      "@types/node"
+    ] /* Type declaration files to be included in compilation. */,
+    "allowSyntheticDefaultImports": true /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */,
+    "esModuleInterop": true /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */,
+    "resolveJsonModule": true
+  }
+}

package/tsconfig.json

@@ -0,0 +1,78 @@
+{
+  "compileOnSave": true,
+  "exclude": [
+    "node_modules",
+    "dist",
+    "test"
+  ],
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "*": [
+        "types/*"
+      ]
+    },
+    "skipLibCheck": true,
+    /* Basic Options */
+    "target": "esnext", /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017','ES2018' or 'ESNEXT'. */
+    "module": "commonjs", /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', or 'ESNext'. */
+    "lib": [
+      "dom",
+      "es2015",
+      "es2016",
+      "es2017"
+    ], /* Specify library files to be included in the compilation. */
+    // "allowJs": true,                          /* Allow javascript files to be compiled. */
+    // "checkJs": true,                          /* Report errors in .js files. */
+    // "jsx": "preserve",                     /* Specify JSX code generation: 'preserve', 'react-native', or 'react'. */
+    "declaration": true, /* Generates corresponding '.d.ts' file. */
+    // "declarationMap": true,                /* Generates a sourcemap for each corresponding '.d.ts' file. */
+    "sourceMap": true, /* Generates corresponding '.map' file. */
+    // "outFile": "./",                       /* Concatenate and emit output to single file. */
+    "outDir": "dist", /* Redirect output structure to the directory. */
+    "rootDir": "./src", /* Specify the root directory of input files. Use to control the output directory structure with --outDir. */
+    // "composite": true,                     /* Enable project compilation */
+    // "removeComments": true,                /* Do not emit comments to output. */
+    // "noEmit": true,                        /* Do not emit outputs. */
+    // "importHelpers": true,                 /* Import emit helpers from 'tslib'. */
+    // "downlevelIteration": true,            /* Provide full support for iterables in 'for-of', spread, and destructuring when targeting 'ES5' or 'ES3'. */
+    // "isolatedModules": true,               /* Transpile each file as a separate module (similar to 'ts.transpileModule'). */
+    /* Strict Type-Checking Options */
+    "strict": true, /* Enable all strict type-checking options. */
+    "noImplicitAny": false, /* Raise error on expressions and declarations with an implied 'any' type. */
+    // "strictNullChecks": true,              /* Enable strict null checks. */
+    // "strictFunctionTypes": true,           /* Enable strict checking of function types. */
+    // "strictPropertyInitialization": true,  /* Enable strict checking of property initialization in classes. */
+    // "noImplicitThis": true,                /* Raise error on 'this' expressions with an implied 'any' type. */
+    // "alwaysStrict": true,                  /* Parse in strict mode and emit "use strict" for each source file. */
+    /* Additional Checks */
+    // "noUnusedLocals": true,                   /* Report errors on unused locals. */
+    // "noUnusedParameters": true,               /* Report errors on unused parameters. */
+    "noImplicitReturns": true, /* Report error when not all code paths in function return a value. */
+    "noFallthroughCasesInSwitch": true, /* Report errors for fallthrough cases in switch statement. */
+    /* Module Resolution Options */
+    "moduleResolution": "node", /* Specify module resolution strategy: 'node' (Node.js) or 'classic' (TypeScript pre-1.6). */
+    // "baseUrl": "./src",                       /* Base directory to resolve non-absolute module names. */
+    // "paths": {},                           /* A series of entries which re-map imports to lookup locations relative to the 'baseUrl'. */
+    // "rootDirs": [],                        /* List of root folders whose combined content represents the structure of the project at runtime. */
+    "typeRoots": [
+      "node_modules"
+    ], /* List of folders to include type definitions from. */
+    "types": [
+      "node"
+    ], /* Type declaration files to be included in compilation. */
+    "allowSyntheticDefaultImports": true, /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */
+    "esModuleInterop": true, /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */
+    // "preserveSymlinks": true,              /* Do not resolve the real path of symlinks. */
+    /* Source Map Options */
+    // "sourceRoot": "./",                    /* Specify the location where debugger should locate TypeScript files instead of source locations. */
+    // "mapRoot": "./",                       /* Specify the location where debugger should locate map files instead of generated locations. */
+    // "inlineSourceMap": true,               /* Emit a single file with source maps instead of having a separate file. */
+    // "inlineSources": true,                 /* Emit the source alongside the sourcemaps within a single file; requires '--inlineSourceMap' or '--sourceMap' to be set. */
+    /* Experimental Options */
+    // "experimentalDecorators": true,        /* Enables experimental support for ES7 decorators. */
+    // "emitDecoratorMetadata": true,         /* Enables experimental support for emitting type metadata for decorators. */
+    /* Advanced Options */
+    // "declarationDir": "lib"                /* Output directory for generated declaration files. */
+  }
+}