extra-pool 0.1.0

package/lib/es2015/index.d.ts

@@ -0,0 +1 @@
+export * from './pool';

package/lib/es2015/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./pool"), exports);
+//# sourceMappingURL=index.js.map

package/lib/es2015/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAsB"}

package/lib/es2015/instance.d.ts

@@ -0,0 +1,19 @@
+import { Awaitable } from '@blackglory/prelude';
+import { Deferred } from 'extra-promise';
+export declare enum InstanceState {
+    Creating = "creating",
+    Idle = "idle",
+    Using = "using",
+    Destroying = "destroying",
+    Destroyed = "destroyed"
+}
+export declare class Instance<T> {
+    private destroyValue?;
+    private fsm;
+    readonly _value: Deferred<T>;
+    constructor(createValue: () => Awaitable<T>, destroyValue?: ((value: T) => Awaitable<void>) | undefined);
+    waitForCreated(): Promise<void>;
+    getState(): InstanceState;
+    use<U>(fn: (instance: T) => Awaitable<U>): Promise<U>;
+    destroy(): Promise<void>;
+}

package/lib/es2015/instance.js

@@ -0,0 +1,97 @@
+"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 });
+exports.Instance = exports.InstanceState = void 0;
+const prelude_1 = require("@blackglory/prelude");
+const extra_promise_1 = require("extra-promise");
+const structures_1 = require("@blackglory/structures");
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+var InstanceState;
+(function (InstanceState) {
+    InstanceState["Creating"] = "creating";
+    InstanceState["Idle"] = "idle";
+    InstanceState["Using"] = "using";
+    InstanceState["Destroying"] = "destroying";
+    InstanceState["Destroyed"] = "destroyed";
+})(InstanceState = exports.InstanceState || (exports.InstanceState = {}));
+const instanceSchema = {
+    [InstanceState.Creating]: {
+        created: InstanceState.Idle
+    },
+    [InstanceState.Idle]: {
+        use: InstanceState.Using,
+        destroy: InstanceState.Destroying
+    },
+    [InstanceState.Using]: {
+        used: InstanceState.Idle
+    },
+    [InstanceState.Destroying]: {
+        destroyed: InstanceState.Destroyed
+    },
+    [InstanceState.Destroyed]: {}
+};
+class Instance {
+    constructor(createValue, destroyValue) {
+        this.destroyValue = destroyValue;
+        this._value = new extra_promise_1.Deferred();
+        this.fsm = new structures_1.ObservableFiniteStateMachine(instanceSchema, InstanceState.Creating);
+        (0, prelude_1.go)(() => __awaiter(this, void 0, void 0, function* () {
+            try {
+                const val = yield createValue();
+                this._value.resolve(val);
+                this.fsm.send('created');
+            }
+            catch (e) {
+                this._value.reject(e);
+            }
+        }));
+    }
+    waitForCreated() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this._value;
+        });
+    }
+    getState() {
+        return this.fsm.state;
+    }
+    use(fn) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.fsm.send('use');
+            const value = yield this._value;
+            try {
+                return yield fn(value);
+            }
+            finally {
+                this.fsm.send('used');
+            }
+        });
+    }
+    destroy() {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.fsm.matches(InstanceState.Creating) ||
+                this.fsm.matches(InstanceState.Using)) {
+                yield (0, rxjs_1.firstValueFrom)(this.fsm.observeStateChanges().pipe((0, operators_1.filter)(state => state.newState === InstanceState.Idle)));
+            }
+            if (this.fsm.matches(InstanceState.Idle)) {
+                this.fsm.send('destroy');
+                yield ((_a = this.destroyValue) === null || _a === void 0 ? void 0 : _a.call(this, yield this._value));
+                this.fsm.send('destroyed');
+            }
+            else if (this.fsm.matches(InstanceState.Destroying)) {
+                yield (0, rxjs_1.firstValueFrom)(this.fsm.observeStateChanges().pipe((0, operators_1.filter)(state => state.newState === InstanceState.Destroyed)));
+            }
+        });
+    }
+}
+exports.Instance = Instance;
+//# sourceMappingURL=instance.js.map

package/lib/es2015/instance.js.map

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

package/lib/es2015/pool.d.ts

@@ -0,0 +1,26 @@
+import { CustomError } from '@blackglory/errors';
+import { Awaitable } from '@blackglory/prelude';
+interface IPoolOptions<T> {
+    create: () => Awaitable<T>;
+    destroy?: (value: T) => Awaitable<void>;
+    maxInstances?: number;
+    minInstances?: number;
+    idleTimeout?: number;
+}
+export declare class Pool<T> {
+    private createValue;
+    private destroyValue?;
+    private fsm;
+    private items;
+    private userDeferredQueue;
+    private maxInstances;
+    private minInstances;
+    private idleTimeout;
+    get size(): number;
+    constructor(options: IPoolOptions<T>);
+    use<U>(fn: (instance: T) => Awaitable<U>): Promise<U>;
+    destroy(): Promise<void>;
+}
+export declare class UnavailablePool extends CustomError {
+}
+export {};

package/lib/es2015/pool.js

@@ -0,0 +1,129 @@
+"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 });
+exports.UnavailablePool = exports.Pool = void 0;
+const errors_1 = require("@blackglory/errors");
+const structures_1 = require("@blackglory/structures");
+const extra_promise_1 = require("extra-promise");
+const iterable_operator_1 = require("iterable-operator");
+const instance_1 = require("./instance");
+const extra_timers_1 = require("extra-timers");
+var PoolState;
+(function (PoolState) {
+    PoolState["Running"] = "running";
+    PoolState["Destroying"] = "destroying";
+    PoolState["Destroyed"] = "destroyed";
+})(PoolState || (PoolState = {}));
+const poolSchema = {
+    [PoolState.Running]: {
+        destroy: PoolState.Destroying
+    },
+    [PoolState.Destroying]: {
+        destroyed: PoolState.Destroyed
+    },
+    [PoolState.Destroyed]: {}
+};
+class Pool {
+    constructor(options) {
+        var _a, _b, _c;
+        this.fsm = new structures_1.FiniteStateMachine(poolSchema, PoolState.Running);
+        this.items = new Set();
+        this.userDeferredQueue = new structures_1.Queue();
+        this.createValue = options.create;
+        this.destroyValue = options.destroy;
+        this.maxInstances = (_a = options.maxInstances) !== null && _a !== void 0 ? _a : Infinity;
+        this.minInstances = (_b = options.minInstances) !== null && _b !== void 0 ? _b : 0;
+        this.idleTimeout = (_c = options.idleTimeout) !== null && _c !== void 0 ? _c : 0;
+    }
+    get size() {
+        return this.items.size;
+    }
+    use(fn) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const self = this;
+            const item = (0, iterable_operator_1.find)(this.items, instance => !instance.using);
+            if (item) {
+                return yield use(item);
+            }
+            else {
+                if (this.items.size < this.maxInstances) {
+                    const instance = new instance_1.Instance(this.createValue, this.destroyValue);
+                    const item = {
+                        instance,
+                        using: true
+                    };
+                    this.items.add(item);
+                    return yield use(item);
+                }
+                else {
+                    const deferred = new extra_promise_1.Deferred();
+                    this.userDeferredQueue.enqueue(deferred);
+                    const item = yield deferred;
+                    return yield use(item);
+                }
+            }
+            function use(item) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    item.using = true;
+                    if (item.cancelDeletion) {
+                        item.cancelDeletion();
+                        delete item.cancelDeletion;
+                    }
+                    yield item.instance.waitForCreated();
+                    try {
+                        return yield item.instance.use(fn);
+                    }
+                    finally {
+                        if (self.userDeferredQueue.size > 0) {
+                            self.userDeferredQueue.dequeue().resolve(item);
+                        }
+                        else {
+                            item.using = false;
+                            if (self.items.size > self.minInstances) {
+                                if (self.idleTimeout > 0) {
+                                    item.cancelDeletion = (0, extra_timers_1.setTimeout)(self.idleTimeout, removeItem);
+                                }
+                                else {
+                                    yield removeItem();
+                                }
+                            }
+                        }
+                    }
+                    function removeItem() {
+                        return __awaiter(this, void 0, void 0, function* () {
+                            self.items.delete(item);
+                            yield item.instance.destroy();
+                        });
+                    }
+                });
+            }
+        });
+    }
+    destroy() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.fsm.send('destroy');
+            for (const item of this.items) {
+                yield item.instance.destroy();
+            }
+            this.items.clear();
+            let deferred;
+            while (deferred = this.userDeferredQueue.dequeue()) {
+                deferred.reject(new UnavailablePool());
+            }
+            this.fsm.send('destroyed');
+        });
+    }
+}
+exports.Pool = Pool;
+class UnavailablePool extends errors_1.CustomError {
+}
+exports.UnavailablePool = UnavailablePool;
+//# sourceMappingURL=pool.js.map

package/lib/es2015/pool.js.map

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

package/lib/es2018/index.d.ts

@@ -0,0 +1 @@
+export * from './pool';

package/lib/es2018/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./pool"), exports);
+//# sourceMappingURL=index.js.map

package/lib/es2018/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAsB"}

package/lib/es2018/instance.d.ts

@@ -0,0 +1,19 @@
+import { Awaitable } from '@blackglory/prelude';
+import { Deferred } from 'extra-promise';
+export declare enum InstanceState {
+    Creating = "creating",
+    Idle = "idle",
+    Using = "using",
+    Destroying = "destroying",
+    Destroyed = "destroyed"
+}
+export declare class Instance<T> {
+    private destroyValue?;
+    private fsm;
+    readonly _value: Deferred<T>;
+    constructor(createValue: () => Awaitable<T>, destroyValue?: ((value: T) => Awaitable<void>) | undefined);
+    waitForCreated(): Promise<void>;
+    getState(): InstanceState;
+    use<U>(fn: (instance: T) => Awaitable<U>): Promise<U>;
+    destroy(): Promise<void>;
+}

package/lib/es2018/instance.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Instance = exports.InstanceState = void 0;
+const prelude_1 = require("@blackglory/prelude");
+const extra_promise_1 = require("extra-promise");
+const structures_1 = require("@blackglory/structures");
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+var InstanceState;
+(function (InstanceState) {
+    InstanceState["Creating"] = "creating";
+    InstanceState["Idle"] = "idle";
+    InstanceState["Using"] = "using";
+    InstanceState["Destroying"] = "destroying";
+    InstanceState["Destroyed"] = "destroyed";
+})(InstanceState = exports.InstanceState || (exports.InstanceState = {}));
+const instanceSchema = {
+    [InstanceState.Creating]: {
+        created: InstanceState.Idle
+    },
+    [InstanceState.Idle]: {
+        use: InstanceState.Using,
+        destroy: InstanceState.Destroying
+    },
+    [InstanceState.Using]: {
+        used: InstanceState.Idle
+    },
+    [InstanceState.Destroying]: {
+        destroyed: InstanceState.Destroyed
+    },
+    [InstanceState.Destroyed]: {}
+};
+class Instance {
+    constructor(createValue, destroyValue) {
+        this.destroyValue = destroyValue;
+        this._value = new extra_promise_1.Deferred();
+        this.fsm = new structures_1.ObservableFiniteStateMachine(instanceSchema, InstanceState.Creating);
+        (0, prelude_1.go)(async () => {
+            try {
+                const val = await createValue();
+                this._value.resolve(val);
+                this.fsm.send('created');
+            }
+            catch (e) {
+                this._value.reject(e);
+            }
+        });
+    }
+    async waitForCreated() {
+        await this._value;
+    }
+    getState() {
+        return this.fsm.state;
+    }
+    async use(fn) {
+        this.fsm.send('use');
+        const value = await this._value;
+        try {
+            return await fn(value);
+        }
+        finally {
+            this.fsm.send('used');
+        }
+    }
+    async destroy() {
+        var _a;
+        if (this.fsm.matches(InstanceState.Creating) ||
+            this.fsm.matches(InstanceState.Using)) {
+            await (0, rxjs_1.firstValueFrom)(this.fsm.observeStateChanges().pipe((0, operators_1.filter)(state => state.newState === InstanceState.Idle)));
+        }
+        if (this.fsm.matches(InstanceState.Idle)) {
+            this.fsm.send('destroy');
+            await ((_a = this.destroyValue) === null || _a === void 0 ? void 0 : _a.call(this, await this._value));
+            this.fsm.send('destroyed');
+        }
+        else if (this.fsm.matches(InstanceState.Destroying)) {
+            await (0, rxjs_1.firstValueFrom)(this.fsm.observeStateChanges().pipe((0, operators_1.filter)(state => state.newState === InstanceState.Destroyed)));
+        }
+    }
+}
+exports.Instance = Instance;
+//# sourceMappingURL=instance.js.map

package/lib/es2018/instance.js.map

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

package/lib/es2018/pool.d.ts

@@ -0,0 +1,26 @@
+import { CustomError } from '@blackglory/errors';
+import { Awaitable } from '@blackglory/prelude';
+interface IPoolOptions<T> {
+    create: () => Awaitable<T>;
+    destroy?: (value: T) => Awaitable<void>;
+    maxInstances?: number;
+    minInstances?: number;
+    idleTimeout?: number;
+}
+export declare class Pool<T> {
+    private createValue;
+    private destroyValue?;
+    private fsm;
+    private items;
+    private userDeferredQueue;
+    private maxInstances;
+    private minInstances;
+    private idleTimeout;
+    get size(): number;
+    constructor(options: IPoolOptions<T>);
+    use<U>(fn: (instance: T) => Awaitable<U>): Promise<U>;
+    destroy(): Promise<void>;
+}
+export declare class UnavailablePool extends CustomError {
+}
+export {};

package/lib/es2018/pool.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnavailablePool = exports.Pool = void 0;
+const errors_1 = require("@blackglory/errors");
+const structures_1 = require("@blackglory/structures");
+const extra_promise_1 = require("extra-promise");
+const iterable_operator_1 = require("iterable-operator");
+const instance_1 = require("./instance");
+const extra_timers_1 = require("extra-timers");
+var PoolState;
+(function (PoolState) {
+    PoolState["Running"] = "running";
+    PoolState["Destroying"] = "destroying";
+    PoolState["Destroyed"] = "destroyed";
+})(PoolState || (PoolState = {}));
+const poolSchema = {
+    [PoolState.Running]: {
+        destroy: PoolState.Destroying
+    },
+    [PoolState.Destroying]: {
+        destroyed: PoolState.Destroyed
+    },
+    [PoolState.Destroyed]: {}
+};
+class Pool {
+    constructor(options) {
+        var _a, _b, _c;
+        this.fsm = new structures_1.FiniteStateMachine(poolSchema, PoolState.Running);
+        this.items = new Set();
+        this.userDeferredQueue = new structures_1.Queue();
+        this.createValue = options.create;
+        this.destroyValue = options.destroy;
+        this.maxInstances = (_a = options.maxInstances) !== null && _a !== void 0 ? _a : Infinity;
+        this.minInstances = (_b = options.minInstances) !== null && _b !== void 0 ? _b : 0;
+        this.idleTimeout = (_c = options.idleTimeout) !== null && _c !== void 0 ? _c : 0;
+    }
+    get size() {
+        return this.items.size;
+    }
+    async use(fn) {
+        const self = this;
+        const item = (0, iterable_operator_1.find)(this.items, instance => !instance.using);
+        if (item) {
+            return await use(item);
+        }
+        else {
+            if (this.items.size < this.maxInstances) {
+                const instance = new instance_1.Instance(this.createValue, this.destroyValue);
+                const item = {
+                    instance,
+                    using: true
+                };
+                this.items.add(item);
+                return await use(item);
+            }
+            else {
+                const deferred = new extra_promise_1.Deferred();
+                this.userDeferredQueue.enqueue(deferred);
+                const item = await deferred;
+                return await use(item);
+            }
+        }
+        async function use(item) {
+            item.using = true;
+            if (item.cancelDeletion) {
+                item.cancelDeletion();
+                delete item.cancelDeletion;
+            }
+            await item.instance.waitForCreated();
+            try {
+                return await item.instance.use(fn);
+            }
+            finally {
+                if (self.userDeferredQueue.size > 0) {
+                    self.userDeferredQueue.dequeue().resolve(item);
+                }
+                else {
+                    item.using = false;
+                    if (self.items.size > self.minInstances) {
+                        if (self.idleTimeout > 0) {
+                            item.cancelDeletion = (0, extra_timers_1.setTimeout)(self.idleTimeout, removeItem);
+                        }
+                        else {
+                            await removeItem();
+                        }
+                    }
+                }
+            }
+            async function removeItem() {
+                self.items.delete(item);
+                await item.instance.destroy();
+            }
+        }
+    }
+    async destroy() {
+        this.fsm.send('destroy');
+        for (const item of this.items) {
+            await item.instance.destroy();
+        }
+        this.items.clear();
+        let deferred;
+        while (deferred = this.userDeferredQueue.dequeue()) {
+            deferred.reject(new UnavailablePool());
+        }
+        this.fsm.send('destroyed');
+    }
+}
+exports.Pool = Pool;
+class UnavailablePool extends errors_1.CustomError {
+}
+exports.UnavailablePool = UnavailablePool;
+//# sourceMappingURL=pool.js.map

package/lib/es2018/pool.js.map

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