prool 0.0.0 → 0.0.1

package/_lib/pool.js

@@ -0,0 +1,134 @@
+import getPort from 'get-port';
+/**
+ * Defines an instance pool. Instances can be started, cached, and stopped against an identifier.
+ *
+ * @example
+ * ```
+ * const pool = definePool({
+ *  instance: anvil(),
+ * })
+ *
+ * const instance_1 = await pool.start(1)
+ * const instance_2 = await pool.start(2)
+ * const instance_3 = await pool.start(3)
+ * ```
+ */
+export function definePool(parameters) {
+    const { instance, limit } = parameters;
+    const instances = new Map();
+    // Define promise instances for mutators to avoid race conditions, and return
+    // identical instances of the promises (instead of duplicating them).
+    // We utilize `Promise.withResolvers` instead of `new Promise((resolve, reject) => ...)`
+    // to avoid async Promise executor functions (https://biomejs.dev/linter/rules/no-async-promise-executor/).
+    const promises = {
+        destroy: new Map(),
+        destroyAll: undefined,
+        start: new Map(),
+        stop: new Map(),
+        stopAll: undefined,
+    };
+    return {
+        _internal: {
+            instance,
+        },
+        async destroy(key) {
+            const destroyPromise = promises.destroy.get(key);
+            if (destroyPromise)
+                return destroyPromise;
+            const resolver = Promise.withResolvers();
+            try {
+                promises.destroy.set(key, resolver.promise);
+                await this.stop(key);
+                instances.delete(key);
+                resolver.resolve();
+            }
+            catch (error) {
+                resolver.reject(error);
+            }
+            return resolver.promise;
+        },
+        async destroyAll() {
+            if (promises.destroyAll)
+                return promises.destroyAll;
+            const resolver = Promise.withResolvers();
+            try {
+                promises.destroyAll = resolver.promise;
+                await Promise.all([...instances.keys()].map((key) => this.destroy(key)));
+                promises.destroyAll = undefined;
+                resolver.resolve();
+            }
+            catch (error) {
+                resolver.reject(error);
+            }
+        },
+        async start(key, options = {}) {
+            const startPromise = promises.start.get(key);
+            if (startPromise)
+                return startPromise;
+            const resolver = Promise.withResolvers();
+            try {
+                promises.start.set(key, resolver.promise);
+                if (limit && instances.size >= limit)
+                    throw new Error(`Instance limit of ${limit} reached.`);
+                const { port = await getPort() } = options;
+                const instance_ = instances.get(key) || instance.create({ port });
+                await instance_.start();
+                instances.set(key, instance_);
+                resolver.resolve(instance_);
+            }
+            catch (error) {
+                resolver.reject(error);
+            }
+            finally {
+                promises.start.delete(key);
+            }
+            return resolver.promise;
+        },
+        async stop(key) {
+            const stopPromise = promises.stop.get(key);
+            if (stopPromise)
+                return stopPromise;
+            const resolver = Promise.withResolvers();
+            try {
+                promises.stop.set(key, resolver.promise);
+                const instance_ = instances.get(key);
+                if (!instance_) {
+                    resolver.resolve();
+                    return;
+                }
+                await instance_.stop();
+                resolver.resolve();
+            }
+            catch (error) {
+                resolver.reject(error);
+            }
+            finally {
+                promises.stop.delete(key);
+            }
+        },
+        async stopAll() {
+            if (promises.stopAll)
+                return promises.stopAll;
+            const resolver = Promise.withResolvers();
+            try {
+                promises.stopAll = resolver.promise;
+                await Promise.all([...instances.keys()].map((key) => this.stop(key)));
+                promises.stopAll = undefined;
+                resolver.resolve();
+            }
+            catch (error) {
+                resolver.reject(error);
+            }
+        },
+        get size() {
+            return instances.size;
+        },
+        entries: instances.entries.bind(instances),
+        keys: instances.keys.bind(instances),
+        forEach: instances.forEach.bind(instances),
+        get: instances.get.bind(instances).bind(instances),
+        has: instances.has.bind(instances),
+        values: instances.values.bind(instances),
+    };
+}
+//# sourceMappingURL=pool.js.map

package/_lib/pool.js.map

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

package/_lib/proxy.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import { type IncomingMessage, type Server, type ServerResponse } from 'node:http';
+import type { AddressInfo } from 'node:net';
+import { type DefinePoolParameters } from './pool.js';
+export type DefineProxyPoolParameters = DefinePoolParameters & ({
+    /** Host to run the server on. */
+    host?: string | undefined;
+    /** Port to run the server on. */
+    port: number;
+} | {
+    host?: undefined;
+    port?: undefined;
+});
+export type DefineProxyPoolReturnType = Omit<Server<typeof IncomingMessage, typeof ServerResponse>, 'address'> & {
+    address(): AddressInfo | null;
+    start(): Promise<() => Promise<void>>;
+    stop(): Promise<void>;
+};
+export declare function defineProxyPool(parameters: DefineProxyPoolParameters): DefineProxyPoolReturnType;
+//# sourceMappingURL=proxy.d.ts.map

package/_lib/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../proxy.ts"],"names":[],"mappings":";;AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,cAAc,EAEpB,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAG3C,OAAO,EAAE,KAAK,oBAAoB,EAAc,MAAM,WAAW,CAAA;AAGjE,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,GAC1D,CACI;IACE,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;CACb,GACD;IACE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB,CACJ,CAAA;AAEH,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,MAAM,CAAC,OAAO,eAAe,EAAE,OAAO,cAAc,CAAC,EACrD,SAAS,CACV,GAAG;IACF,OAAO,IAAI,WAAW,GAAG,IAAI,CAAA;IAC7B,KAAK,IAAI,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IACrC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB,CAAA;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,yBAAyB,GACpC,yBAAyB,CAiG3B"}

package/_lib/proxy.js

@@ -0,0 +1,93 @@
+import { createServer, } from 'node:http';
+import { createProxyServer } from 'http-proxy';
+import { definePool } from './pool.js';
+import { extractPath } from './utils.js';
+export function defineProxyPool(parameters) {
+    const { host = '::', instance, limit, port } = parameters;
+    const pool = definePool({ instance, limit });
+    const proxy = createProxyServer({
+        ignorePath: true,
+        ws: true,
+    });
+    const server = createServer(async (request, response) => {
+        try {
+            const url = request.url;
+            if (!url) {
+                response.end();
+                return;
+            }
+            const { id, path } = extractPath(url);
+            if (typeof id === 'number' && path === '/') {
+                const { host, port } = pool.get(id) || (await pool.start(id));
+                return proxy.web(request, response, {
+                    target: `http://${host}:${port}`,
+                });
+            }
+            if (typeof id === 'number' && path === '/start') {
+                const { host, port } = await pool.start(id);
+                response
+                    .writeHead(200, { 'Content-Type': 'application/json' })
+                    .end(JSON.stringify({ host, port }));
+                return;
+            }
+            if (typeof id === 'number' && path === '/stop') {
+                await pool.stop(id);
+                response.writeHead(200, { 'Content-Type': 'application/json' }).end();
+                return;
+            }
+            if (typeof id === 'number' && path === '/messages') {
+                const messages = pool.get(id)?.messages.get() || [];
+                response
+                    .writeHead(200, { 'Content-Type': 'application/json' })
+                    .end(JSON.stringify(messages));
+                return;
+            }
+            if (path === '/healthcheck') {
+                response.writeHead(200, { 'Content-Type': 'application/json' }).end();
+                return;
+            }
+            response.writeHead(404, { 'Content-Type': 'application/json' }).end();
+            return;
+        }
+        catch (error) {
+            response
+                .writeHead(400, { 'Content-Type': 'application/json' })
+                .end(JSON.stringify({ message: error.message }));
+            return;
+        }
+    });
+    server.on('upgrade', async (request, socket, head) => {
+        const url = request.url;
+        if (!url) {
+            socket.destroy(new Error('Unsupported request'));
+            return;
+        }
+        const { id, path } = extractPath(url);
+        if (typeof id === 'number' && path === '/') {
+            const { host, port } = pool.get(id) || (await pool.start(id));
+            proxy.ws(request, socket, head, {
+                target: `ws://${host}:${port}`,
+            });
+            return;
+        }
+        socket.destroy(new Error('Unsupported request'));
+        return;
+    });
+    return Object.assign(server, {
+        start() {
+            return new Promise((resolve) => {
+                if (port)
+                    server.listen(port, host, () => resolve(this.stop));
+                else
+                    server.listen(() => resolve(this.stop));
+            });
+        },
+        async stop() {
+            await Promise.allSettled([
+                new Promise((resolve, reject) => server.close((error) => (error ? reject(error) : resolve()))),
+                pool.destroyAll(),
+            ]);
+        },
+    });
+}
+//# sourceMappingURL=proxy.js.map

package/_lib/proxy.js.map

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

package/_lib/utils.d.ts

@@ -0,0 +1,35 @@
+export type ExtractPathReturnType = {
+    id: number | undefined;
+    path: string;
+};
+/**
+ * Parse a request url into an object containing the id and path.
+ *
+ * @param request The request url.
+ * @returns The parsed request context or undefined.
+ */
+export declare function extractPath(request: string): ExtractPathReturnType;
+/**
+ * Strips ANSI color codes from a string.
+ *
+ * @param message The string to strip.
+ * @returns The stripped string.
+ */
+export declare function stripColors(message: string): string;
+/**
+ * Converts an object of options to an array of command line arguments.
+ *
+ * @param options The options object.
+ * @returns The command line arguments.
+ */
+export declare function toArgs(options: {
+    [key: string]: Record<string, string> | string | boolean | number | bigint | undefined;
+}): string[];
+/**
+ * Converts a camelCase string to a flag case string.
+ *
+ * @param key The camelCase string.
+ * @returns The flag case string.
+ */
+export declare function toFlagCase(key: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/_lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAkBlE;AAMD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,UAE1C;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE;IAC9B,CAAC,GAAG,EAAE,MAAM,GACR,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,CAAA;CACd,YAsBA;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,UAErC"}

package/_lib/utils.js

@@ -0,0 +1,71 @@
+/**
+ * Parse a request url into an object containing the id and path.
+ *
+ * @param request The request url.
+ * @returns The parsed request context or undefined.
+ */
+export function extractPath(request) {
+    const host = 'http://localhost'; // Dummy value for URL constructor
+    const url = new URL(`${host}${request ?? '/'}`);
+    const [idOrPath, ...pathname] = url.pathname
+        .split('/')
+        .filter((part) => part !== '');
+    const id = !Number.isNaN(Number(idOrPath)) && Number(idOrPath) > 0
+        ? Number(idOrPath)
+        : undefined;
+    const path = `/${typeof id === 'number'
+        ? pathname.join('/')
+        : [idOrPath, ...pathname].join('/')}`;
+    return { id, path };
+}
+const ansiColorRegex = 
+// biome-ignore lint/suspicious/noControlCharactersInRegex: <explanation>
+/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
+/**
+ * Strips ANSI color codes from a string.
+ *
+ * @param message The string to strip.
+ * @returns The stripped string.
+ */
+export function stripColors(message) {
+    return message.replace(ansiColorRegex, '');
+}
+/**
+ * Converts an object of options to an array of command line arguments.
+ *
+ * @param options The options object.
+ * @returns The command line arguments.
+ */
+export function toArgs(options) {
+    return Object.entries(options).flatMap(([key, value]) => {
+        if (value === undefined)
+            return [];
+        if (typeof value === 'object' && value !== null)
+            return Object.entries(value).flatMap(([subKey, subValue]) => {
+                if (subValue === undefined)
+                    return [];
+                const flag = toFlagCase(key);
+                const value = `${subKey}: ${subValue}`;
+                return [flag, value];
+            });
+        const flag = toFlagCase(key);
+        if (value === false)
+            return [];
+        if (value === true)
+            return [flag];
+        const stringified = value.toString();
+        if (stringified === '')
+            return [flag];
+        return [flag, stringified];
+    });
+}
+/**
+ * Converts a camelCase string to a flag case string.
+ *
+ * @param key The camelCase string.
+ * @returns The flag case string.
+ */
+export function toFlagCase(key) {
+    return `--${key.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`)}`;
+}
+//# sourceMappingURL=utils.js.map

package/_lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../utils.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,IAAI,GAAG,kBAAkB,CAAA,CAAC,kCAAkC;IAClE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,OAAO,IAAI,GAAG,EAAE,CAAC,CAAA;IAC/C,MAAM,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,QAAQ;SACzC,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAA;IAEhC,MAAM,EAAE,GACN,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QACrD,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QAClB,CAAC,CAAC,SAAS,CAAA;IACf,MAAM,IAAI,GAAG,IACX,OAAO,EAAE,KAAK,QAAQ;QACpB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QACpB,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CACtC,EAAE,CAAA;IAEF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;AACrB,CAAC;AAED,MAAM,cAAc;AAClB,yEAAyE;AACzE,6EAA6E,CAAA;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAA;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,OAQtB;IACC,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACtD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,CAAA;QAElC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE;gBAC1D,IAAI,QAAQ,KAAK,SAAS;oBAAE,OAAO,EAAE,CAAA;gBACrC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;gBAC5B,MAAM,KAAK,GAAG,GAAG,MAAM,KAAK,QAAQ,EAAE,CAAA;gBACtC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YACtB,CAAC,CAAC,CAAA;QAEJ,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;QAE5B,IAAI,KAAK,KAAK,KAAK;YAAE,OAAO,EAAE,CAAA;QAC9B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,CAAA;QAEjC,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;QACpC,IAAI,WAAW,KAAK,EAAE;YAAE,OAAO,CAAC,IAAI,CAAC,CAAA;QAErC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,KAAK,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAA;AAC3E,CAAC"}

package/exports/index.test.ts

@@ -0,0 +1,12 @@
+import { expect, test } from 'vitest'
+import * as exports from './index.js'
+
+test('exports', () => {
+  expect(Object.keys(exports)).toMatchInlineSnapshot(`
+    [
+      "defineInstance",
+      "definePool",
+      "defineProxyPool",
+    ]
+  `)
+})

package/exports/index.ts

@@ -0,0 +1,20 @@
+export {
+  type DefineInstanceFn,
+  type Instance,
+  type InstanceOptions,
+  type InstanceStartOptions,
+  defineInstance,
+} from '../instance.js'
+
+export {
+  type DefinePoolParameters,
+  type DefinePoolReturnType,
+  type Pool,
+  definePool,
+} from '../pool.js'
+
+export {
+  type DefineProxyPoolParameters,
+  type DefineProxyPoolReturnType,
+  defineProxyPool,
+} from '../proxy.js'

package/exports/instances.test.ts

@@ -0,0 +1,10 @@
+import { expect, test } from 'vitest'
+import * as exports from './instances.js'
+
+test('exports', () => {
+  expect(Object.keys(exports)).toMatchInlineSnapshot(`
+    [
+      "anvil",
+    ]
+  `)
+})

package/exports/instances.ts

@@ -0,0 +1 @@
+export { type AnvilParameters, anvil } from '../instances/anvil.js'