superlib 0.1.0

package/dist/platform/filesystem/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/filesystem/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/platform/filesystem/index.js

@@ -0,0 +1,4 @@
+export {} from "./IFileSystem.js";
+export { FileSystem } from "./FileSystem.js";
+export { MemoryFileSystem } from "./MemoryFileSystem.js";
+export { AbsolutePath } from "./AbsolutePath.js";

package/dist/platform/getPort/checkPort.d.ts

@@ -0,0 +1,2 @@
+export declare function checkPort(port: number): Promise<boolean>;
+//# sourceMappingURL=checkPort.d.ts.map

package/dist/platform/getPort/checkPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkPort.d.ts","sourceRoot":"","sources":["../../../src/platform/getPort/checkPort.ts"],"names":[],"mappings":"AAGA,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAW9D"}

package/dist/platform/getPort/checkPort.js

@@ -0,0 +1,49 @@
+import { createServer } from "node:net";
+import { networkInterfaces } from "node:os";
+export async function checkPort(port) {
+    const hosts = getLocalHosts();
+    for (const host of hosts) {
+        const available = await checkPortOnHost(port, host);
+        if (!available) {
+            return false;
+        }
+    }
+    return true;
+}
+function getLocalHosts() {
+    const interfaces = networkInterfaces();
+    const hosts = new Set([undefined, "0.0.0.0"]);
+    for (const networkInterface of Object.values(interfaces)) {
+        if (networkInterface) {
+            for (const config of networkInterface) {
+                hosts.add(config.address);
+            }
+        }
+    }
+    return hosts;
+}
+function checkPortOnHost(port, host) {
+    return new Promise((resolve) => {
+        try {
+            const server = createServer();
+            server.unref();
+            server.on("error", (error) => {
+                // EADDRNOTAVAIL/EINVAL: host doesn't support binding, skip it
+                if (error.code === "EADDRNOTAVAIL" || error.code === "EINVAL") {
+                    resolve(true);
+                }
+                else {
+                    resolve(false);
+                }
+            });
+            server.listen(port, host, () => {
+                server.close(() => {
+                    resolve(true);
+                });
+            });
+        }
+        catch {
+            resolve(false);
+        }
+    });
+}

package/dist/platform/getPort/getPort.d.ts

@@ -0,0 +1,8 @@
+import { type IRandom } from "../../random";
+interface GetPortDependencies {
+    random: IRandom;
+    checkPort: (port: number) => Promise<boolean>;
+}
+export declare function getPort(dependencies?: GetPortDependencies): Promise<number>;
+export {};
+//# sourceMappingURL=getPort.d.ts.map

package/dist/platform/getPort/getPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPort.d.ts","sourceRoot":"","sources":["../../../src/platform/getPort/getPort.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAGvD,UAAU,mBAAmB;IAC3B,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAE9C;AAED,wBAAsB,OAAO,CAC3B,YAAY,GAAE,mBAA6D,GAC1E,OAAO,CAAC,MAAM,CAAC,CAUjB"}

package/dist/platform/getPort/getPort.js

@@ -0,0 +1,13 @@
+import { RealRandom } from "../../random/index.js";
+import { checkPort } from "./checkPort.js";
+export async function getPort(dependencies = { random: new RealRandom(), checkPort }) {
+    while (true) {
+        const port = dependencies.random.nextInteger(LOW_PORT, HIGH_PORT);
+        const isAvailable = await dependencies.checkPort(port);
+        if (isAvailable) {
+            return port;
+        }
+    }
+}
+const LOW_PORT = 49152;
+const HIGH_PORT = 65535;

package/dist/platform/getPort/index.d.ts

@@ -0,0 +1,2 @@
+export { getPort } from "./getPort";
+//# sourceMappingURL=index.d.ts.map

package/dist/platform/getPort/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/getPort/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA"}

package/dist/platform/getPort/index.js

@@ -0,0 +1 @@
+export { getPort } from "./getPort.js";

package/dist/platform/safeFetch/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./makeSafeFetch";
+//# sourceMappingURL=index.d.ts.map

package/dist/platform/safeFetch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/safeFetch/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA"}

package/dist/platform/safeFetch/index.js

@@ -0,0 +1 @@
+export * from "./makeSafeFetch.js";

package/dist/platform/safeFetch/makeSafeFetch.d.ts

@@ -0,0 +1,23 @@
+import type { TimeoutErr } from "../../task/timeout";
+import type { DurationLike } from "../../time";
+import { type Result } from "../../basic";
+import { type RetryOptions } from "../../task/retry";
+export interface SafeFetchOptions {
+    retry?: RetryOptions<SafeFetchResult> & {
+        untilStatus?: UntilStatusFn;
+    };
+    timeout?: DurationLike;
+}
+type UntilStatusFn = (status: number) => boolean;
+export type SafeFetchError = {
+    type: "fetch/network";
+    cause: unknown;
+} | {
+    type: "fetch/http";
+    status: number;
+} | TimeoutErr;
+export type SafeFetchResult = Result<Response, SafeFetchError>;
+export type SafeFetch = (...args: Parameters<typeof fetch>) => Promise<SafeFetchResult>;
+export declare function makeSafeFetch(options: SafeFetchOptions): SafeFetch;
+export {};
+//# sourceMappingURL=makeSafeFetch.d.ts.map

package/dist/platform/safeFetch/makeSafeFetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeSafeFetch.d.ts","sourceRoot":"","sources":["../../../src/platform/safeFetch/makeSafeFetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,OAAO,EAAwB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAE/D,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,YAAY,CAAC,eAAe,CAAC,GAAG;QAAE,WAAW,CAAC,EAAE,aAAa,CAAA;KAAE,CAAA;IACvE,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB;AAED,KAAK,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;AAEhD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC,UAAU,CAAA;AAEd,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAA;AAE9D,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;AAEvF,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA0BlE"}

package/dist/platform/safeFetch/makeSafeFetch.js

@@ -0,0 +1,19 @@
+import { Err, Ok, ResultAsync } from "../../basic/index.js";
+import { Task } from "../../task/index.js";
+import {} from "../../task/retry.js";
+export function makeSafeFetch(options) {
+    const untilStatus = options.retry?.untilStatus ?? ((status) => status >= 200 && status < 300);
+    return async (url, requestInit = {}) => {
+        const fetchTask = async () => {
+            return ResultAsync.try(() => fetch(url, requestInit), (error) => ({ type: "fetch/network", cause: error }))
+                .andThen((response) => {
+                if (!untilStatus(response.status)) {
+                    return Err({ type: "fetch/http", status: response.status });
+                }
+                return Ok(response);
+            })
+                .toPromise();
+        };
+        return Task.pipe(fetchTask, options.timeout && Task.timeout({ timeout: options.timeout, useResult: true }), options.retry && Task.retry(options.retry));
+    };
+}

package/dist/random/FixedRandom.d.ts

@@ -0,0 +1,12 @@
+import type { IRandom } from "./Random";
+export declare class FixedRandom implements IRandom {
+    private readonly sequence;
+    private index;
+    constructor(sequence: any[]);
+    private takeValue;
+    next(): number;
+    nextInteger(min: number, max: number): number;
+    nextNumber(min: number, max: number): number;
+    nextBoolean(): boolean;
+}
+//# sourceMappingURL=FixedRandom.d.ts.map

package/dist/random/FixedRandom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FixedRandom.d.ts","sourceRoot":"","sources":["../../src/random/FixedRandom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAIvC,qBAAa,WAAY,YAAW,OAAO;IAE7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IADrC,OAAO,CAAC,KAAK,CAAI;gBACY,QAAQ,EAAE,GAAG,EAAE;IAE5C,OAAO,CAAC,SAAS;IAOjB,IAAI,IAAI,MAAM;IAUd,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAoB7C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAc5C,WAAW,IAAI,OAAO;CAKvB"}

package/dist/random/FixedRandom.js

@@ -0,0 +1,43 @@
+import { assert } from "../basic/index.js";
+export class FixedRandom {
+    sequence;
+    index = 0;
+    constructor(sequence) {
+        this.sequence = sequence;
+    }
+    takeValue(methodName) {
+        assert(this.index < this.sequence.length, `FixedRandom.${methodName} sequence is exhausted`);
+        const value = this.sequence[this.index];
+        this.index += 1;
+        return value;
+    }
+    next() {
+        const value = this.takeValue("next");
+        assert(Number.isFinite(value), `FixedRandom.next expected number, got: ${value}`);
+        assert(value >= 0 && value < 1, `FixedRandom.next expected number in range <0;1), got: ${value}`);
+        return value;
+    }
+    nextInteger(min, max) {
+        assert(Number.isInteger(min) && !Number.isNaN(min), `min is expected to be an integer, was: ${min}`);
+        assert(Number.isInteger(max) && !Number.isNaN(max), `max is expected to be an integer, was: ${max}`);
+        assert(min < max, `expected min to be less than max, min=${min} max=${max}`);
+        const value = this.takeValue("nextInteger");
+        assert(Number.isInteger(value), `FixedRandom.nextInteger expected integer, got: ${value}`);
+        assert(value >= min && value <= max, `FixedRandom.nextInteger expected integer in range <${min};${max}>, got: ${value}`);
+        return value;
+    }
+    nextNumber(min, max) {
+        assert(Number.isFinite(min), `min is expected to be a number, was: ${min}`);
+        assert(Number.isFinite(max), `max is expected to be a number, was: ${max}`);
+        assert(min < max, `expected min to be less than max, min=${min} max=${max}`);
+        const value = this.takeValue("nextNumber");
+        assert(Number.isFinite(value), `FixedRandom.nextNumber expected number, got: ${value}`);
+        assert(value >= min && value < max, `FixedRandom.nextNumber expected number in range <${min};${max}), got: ${value}`);
+        return value;
+    }
+    nextBoolean() {
+        const value = this.takeValue("nextBoolean");
+        assert(typeof value === "boolean", `FixedRandom.nextBoolean expected boolean, got: ${value}`);
+        return value;
+    }
+}

package/dist/random/Random.d.ts

@@ -0,0 +1,18 @@
+import type { PublicInterface } from "../types";
+export type IRandom = PublicInterface<AbstractRandom>;
+export declare abstract class AbstractRandom {
+    /**
+     * Returns next random number in range of <0;1)
+     */
+    abstract next(): number;
+    /**
+     * Returns next random integer in range of <min;max>
+     */
+    nextInteger(min: number, max: number): number;
+    /**
+     * Returns next random number in range of <min, max)
+     */
+    nextNumber(min: number, max: number): number;
+    nextBoolean(): boolean;
+}
+//# sourceMappingURL=Random.d.ts.map

package/dist/random/Random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Random.d.ts","sourceRoot":"","sources":["../../src/random/Random.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAI/C,MAAM,MAAM,OAAO,GAAG,eAAe,CAAC,cAAc,CAAC,CAAA;AAErD,8BAAsB,cAAc;IAClC;;OAEG;IACH,QAAQ,CAAC,IAAI,IAAI,MAAM;IAEvB;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAc7C;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAQ5C,WAAW,IAAI,OAAO;CAGvB"}

package/dist/random/Random.js

@@ -0,0 +1,24 @@
+import { assert } from "../basic/assert.js";
+export class AbstractRandom {
+    /**
+     * Returns next random integer in range of <min;max>
+     */
+    nextInteger(min, max) {
+        assert(Number.isInteger(min) && !Number.isNaN(min), `min is expected to be an integer, was: ${min}`);
+        assert(Number.isInteger(max) && !Number.isNaN(max), `max is expected to be an integer, was: ${max}`);
+        assert(min < max, `expected min to be less than max, min=${min} max=${max}`);
+        return Math.floor(this.next() * (max - min + 1)) + min;
+    }
+    /**
+     * Returns next random number in range of <min, max)
+     */
+    nextNumber(min, max) {
+        assert(Number.isFinite(min), `min is expected to be a number, was: ${min}`);
+        assert(Number.isFinite(max), `max is expected to be a number, was: ${max}`);
+        assert(min < max, `expected min to be less than max, min=${min} max=${max}`);
+        return this.next() * (max - min) + min;
+    }
+    nextBoolean() {
+        return this.nextInteger(0, 1) === 1;
+    }
+}

package/dist/random/RealRandom.d.ts

@@ -0,0 +1,5 @@
+import { AbstractRandom } from "./Random";
+export declare class RealRandom extends AbstractRandom {
+    next(): number;
+}
+//# sourceMappingURL=RealRandom.d.ts.map

package/dist/random/RealRandom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RealRandom.d.ts","sourceRoot":"","sources":["../../src/random/RealRandom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAEzC,qBAAa,UAAW,SAAQ,cAAc;IAC5C,IAAI,IAAI,MAAM;CAGf"}

package/dist/random/RealRandom.js

@@ -0,0 +1,6 @@
+import { AbstractRandom } from "./Random.js";
+export class RealRandom extends AbstractRandom {
+    next() {
+        return Math.random();
+    }
+}

package/dist/random/SeededRandom.d.ts

@@ -0,0 +1,10 @@
+import { AbstractRandom } from "./Random";
+export declare class SeededRandom extends AbstractRandom {
+    private m;
+    private a;
+    private c;
+    private state;
+    constructor(seed?: number);
+    next(): number;
+}
+//# sourceMappingURL=SeededRandom.d.ts.map

package/dist/random/SeededRandom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeededRandom.d.ts","sourceRoot":"","sources":["../../src/random/SeededRandom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAEzC,qBAAa,YAAa,SAAQ,cAAc;IAC9C,OAAO,CAAC,CAAC,CAAU;IACnB,OAAO,CAAC,CAAC,CAAa;IACtB,OAAO,CAAC,CAAC,CAAQ;IACjB,OAAO,CAAC,KAAK,CAAQ;gBAET,IAAI,GAAE,MAAgB;IAK3B,IAAI,IAAI,MAAM;CAItB"}

package/dist/random/SeededRandom.js

@@ -0,0 +1,15 @@
+import { AbstractRandom } from "./Random.js";
+export class SeededRandom extends AbstractRandom {
+    m = 2 ** 31;
+    a = 1103515245;
+    c = 12345;
+    state;
+    constructor(seed = 4202137) {
+        super();
+        this.state = seed >>> 0; // force to uint32
+    }
+    next() {
+        this.state = (this.a * this.state + this.c) % this.m;
+        return this.state / this.m;
+    }
+}

package/dist/random/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./Random";
+export { RealRandom } from "./RealRandom";
+export { SeededRandom } from "./SeededRandom";
+export { FixedRandom } from "./FixedRandom";
+//# sourceMappingURL=index.d.ts.map

package/dist/random/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/random/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/dist/random/index.js

@@ -0,0 +1,4 @@
+export * from "./Random.js";
+export { RealRandom } from "./RealRandom.js";
+export { SeededRandom } from "./SeededRandom.js";
+export { FixedRandom } from "./FixedRandom.js";

package/dist/schema/StandardSchema.d.ts

@@ -0,0 +1,60 @@
+/** The Standard Schema interface. */
+export interface StandardSchemaV1<Input = unknown, Output = Input> {
+    /** The Standard Schema properties. */
+    readonly "~standard": StandardSchemaV1.Props<Input, Output>;
+}
+export declare namespace StandardSchemaV1 {
+    /** The Standard Schema properties interface. */
+    interface Props<Input = unknown, Output = Input> {
+        /** The version number of the standard. */
+        readonly version: 1;
+        /** The vendor name of the schema library. */
+        readonly vendor: string;
+        /** Validates unknown input values. */
+        readonly validate: (value: unknown, options?: StandardSchemaV1.Options) => Result<Output> | Promise<Result<Output>>;
+        /** Inferred types associated with the schema. */
+        readonly types?: Types<Input, Output> | undefined;
+    }
+    /** The result interface of the validate function. */
+    type Result<Output> = SuccessResult<Output> | FailureResult;
+    /** The result interface if validation succeeds. */
+    interface SuccessResult<Output> {
+        /** The typed output value. */
+        readonly value: Output;
+        /** A falsy value for `issues` indicates success. */
+        readonly issues?: undefined;
+    }
+    interface Options {
+        /** Explicit support for additional vendor-specific parameters, if needed. */
+        readonly libraryOptions?: Record<string, unknown> | undefined;
+    }
+    /** The result interface if validation fails. */
+    interface FailureResult {
+        /** The issues of failed validation. */
+        readonly issues: ReadonlyArray<Issue>;
+    }
+    /** The issue interface of the failure output. */
+    interface Issue {
+        /** The error message of the issue. */
+        readonly message: string;
+        /** The path of the issue, if any. */
+        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+    }
+    /** The path segment interface of the issue. */
+    interface PathSegment {
+        /** The key representing a path segment. */
+        readonly key: PropertyKey;
+    }
+    /** The Standard Schema types interface. */
+    interface Types<Input = unknown, Output = Input> {
+        /** The input type of the schema. */
+        readonly input: Input;
+        /** The output type of the schema. */
+        readonly output: Output;
+    }
+    /** Infers the input type of a Standard Schema. */
+    type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
+    /** Infers the output type of a Standard Schema. */
+    type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
+}
+//# sourceMappingURL=StandardSchema.d.ts.map

package/dist/schema/StandardSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StandardSchema.d.ts","sourceRoot":"","sources":["../../src/schema/StandardSchema.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;IAC/D,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CAC5D;AAED,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,gDAAgD;IAChD,UAAiB,KAAK,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;QACpD,0CAA0C;QAC1C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;QACnB,6CAA6C;QAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,sCAAsC;QACtC,QAAQ,CAAC,QAAQ,EAAE,CACjB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,KAC/B,MAAM,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;QAC7C,iDAAiD;QACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;KAClD;IAED,qDAAqD;IACrD,KAAY,MAAM,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAA;IAElE,mDAAmD;IACnD,UAAiB,aAAa,CAAC,MAAM;QACnC,8BAA8B;QAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,oDAAoD;QACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;KAC5B;IAED,UAAiB,OAAO;QACtB,6EAA6E;QAC7E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;KAC9D;IAED,gDAAgD;IAChD,UAAiB,aAAa;QAC5B,uCAAuC;QACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAA;KACtC;IAED,iDAAiD;IACjD,UAAiB,KAAK;QACpB,sCAAsC;QACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,qCAAqC;QACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,SAAS,CAAA;KACrE;IAED,+CAA+C;IAC/C,UAAiB,WAAW;QAC1B,2CAA2C;QAC3C,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;KAC1B;IAED,2CAA2C;IAC3C,UAAiB,KAAK,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;QACpD,oCAAoC;QACpC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;QACrB,qCAAqC;QACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KACxB;IAED,kDAAkD;IAClD,KAAY,UAAU,CAAC,MAAM,SAAS,gBAAgB,IAAI,WAAW,CACnE,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAC7B,CAAC,OAAO,CAAC,CAAA;IAEV,mDAAmD;IACnD,KAAY,WAAW,CAAC,MAAM,SAAS,gBAAgB,IAAI,WAAW,CACpE,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAC7B,CAAC,QAAQ,CAAC,CAAA;CACZ"}

package/dist/schema/StandardSchema.js

@@ -0,0 +1 @@
+export {};

package/dist/schema/validateSchema.d.ts

@@ -0,0 +1,9 @@
+import type { StandardSchemaV1 } from "./StandardSchema";
+import { type Result } from "../basic";
+export type ValidationError = {
+    type: "schema/validate";
+    issue: ReadonlyArray<StandardSchemaV1.Issue>;
+};
+export type ValidateSchemaResult<T> = Result<T, ValidationError>;
+export declare function validateSchema<T>(schema: StandardSchemaV1<T>, value: unknown): ValidateSchemaResult<T>;
+//# sourceMappingURL=validateSchema.d.ts.map

package/dist/schema/validateSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateSchema.d.ts","sourceRoot":"","sources":["../../src/schema/validateSchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD,OAAO,EAAmB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAEvD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,iBAAiB,CAAA;IACvB,KAAK,EAAE,aAAa,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;CAC7C,CAAA;AACD,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,eAAe,CAAC,CAAA;AAEhE,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,KAAK,EAAE,OAAO,GACb,oBAAoB,CAAC,CAAC,CAAC,CAUzB"}

package/dist/schema/validateSchema.js

@@ -0,0 +1,9 @@
+import { assert, Err, Ok } from "../basic/index.js";
+export function validateSchema(schema, value) {
+    const result = schema["~standard"].validate(value);
+    assert(!(result instanceof Promise), "Only sync validation supported at the moment");
+    if (result.issues) {
+        return Err({ type: "schema/validate", issue: result.issues });
+    }
+    return Ok(result.value);
+}

package/dist/task/all.d.ts

@@ -0,0 +1,14 @@
+import type { Task } from "./types";
+export type AllOptions = {
+    concurrency: number | `batches-of-${number}` | "unbounded";
+};
+export declare function all<T extends unknown[]>(tasks: {
+    [K in keyof T]: Task<T[K]>;
+}, options: AllOptions): Promise<{
+    [K in keyof T]: Awaited<T[K]>;
+}>;
+export declare function all<K extends PropertyKey, R extends Record<K, Task<unknown>>>(tasks: R, options: AllOptions): Promise<{
+    [P in keyof R]: Awaited<ReturnType<R[P]>>;
+}>;
+export declare function allWithArray<T>(tasks: ReadonlyArray<Task<T>>, options: AllOptions): Promise<T[]>;
+//# sourceMappingURL=all.d.ts.map

package/dist/task/all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"all.d.ts","sourceRoot":"","sources":["../../src/task/all.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAInC,MAAM,MAAM,UAAU,GAAG;IACvB,WAAW,EAAE,MAAM,GAAG,cAAc,MAAM,EAAE,GAAG,WAAW,CAAA;CAC3D,CAAA;AAED,wBAAsB,GAAG,CAAC,CAAC,SAAS,OAAO,EAAE,EAC3C,KAAK,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,EACrC,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,CAAA;AAE7C,wBAAsB,GAAG,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,EACjF,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,CAAA;AA4BzD,wBAAsB,YAAY,CAAC,CAAC,EAClC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAC7B,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,CAAC,EAAE,CAAC,CAsDd"}

package/dist/task/all.js

@@ -0,0 +1,61 @@
+import { chunk, zip } from "remeda";
+import { assert } from "../basic/index.js";
+export async function all(taskArrayOrObject, options) {
+    if (Array.isArray(taskArrayOrObject)) {
+        return allWithArray(taskArrayOrObject, options);
+    }
+    const entries = Object.entries(taskArrayOrObject);
+    const keys = entries.map((e) => e[0]);
+    const values = entries.map((e) => e[1]);
+    const result = await allWithArray(values, options);
+    const resultObject = Object.fromEntries(zip(keys, result));
+    return resultObject;
+}
+function assertPositiveIntegerConcurrency(value) {
+    assert(value > 0 && Number.isFinite(value) && Number.isInteger(value), `options.concurrency must be a positive integer (got ${value})`);
+}
+export async function allWithArray(tasks, options) {
+    if (options.concurrency === "unbounded" || options.concurrency === Number.POSITIVE_INFINITY) {
+        return Promise.all(tasks.map((t) => t()));
+    }
+    if (typeof options.concurrency === "string" && options.concurrency.startsWith("batches-of-")) {
+        const batchSizeRaw = Number(options.concurrency.slice("batches-of-".length));
+        assertPositiveIntegerConcurrency(batchSizeRaw);
+        const batchSize = batchSizeRaw;
+        const chunks = chunk(tasks, batchSize);
+        let result = [];
+        for (const c of chunks) {
+            result = result.concat(await allWithArray(c, { concurrency: "unbounded" }));
+        }
+        return result;
+    }
+    const concurrency = options.concurrency;
+    assertPositiveIntegerConcurrency(concurrency);
+    if (tasks.length === 0) {
+        return [];
+    }
+    const results = Array.from({ length: tasks.length });
+    let nextIndex = 0;
+    let cancelled = false; // prevent extra scheduling after a failure
+    async function worker() {
+        while (true) {
+            if (cancelled) {
+                return;
+            }
+            const i = nextIndex++;
+            if (i >= tasks.length) {
+                return;
+            }
+            try {
+                results[i] = await tasks[i]();
+            }
+            catch (err) {
+                cancelled = true;
+                throw err;
+            }
+        }
+    }
+    const workerCount = Math.min(concurrency, tasks.length);
+    await Promise.all(Array.from({ length: workerCount }, worker));
+    return results;
+}

package/dist/task/index.d.ts

@@ -0,0 +1,15 @@
+import { all } from "./all";
+import { pipe } from "./pipe";
+import { retry } from "./retry";
+import { timeout } from "./timeout";
+import { type Task as TaskTypeReexport } from "./types";
+export declare const Task: {
+    all: typeof all;
+    pipe: typeof pipe;
+    retry: typeof retry;
+    timeout: typeof timeout;
+};
+export declare namespace Task {
+    type Task<T> = TaskTypeReexport<T>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/task/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,KAAK,IAAI,IAAI,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAEvD,eAAO,MAAM,IAAI;;;;;CAKhB,CAAA;AAED,yBAAiB,IAAI,CAAC;IACpB,KAAY,IAAI,CAAC,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAA;CAC1C"}

package/dist/task/index.js

@@ -0,0 +1,11 @@
+import { all } from "./all.js";
+import { pipe } from "./pipe.js";
+import { retry } from "./retry.js";
+import { timeout } from "./timeout.js";
+import {} from "./types.js";
+export const Task = {
+    all,
+    pipe,
+    retry,
+    timeout,
+};

package/dist/task/pipe.d.ts

@@ -0,0 +1,8 @@
+import type { Task, TaskMapper } from "./types";
+export declare function pipe<A>(task: Task<A>): Promise<A>;
+export declare function pipe<A, B>(task: Task<A>, m1: TaskMapper<A, B> | undefined): Promise<B>;
+export declare function pipe<A, B, C>(task: Task<A>, m1: TaskMapper<A, B> | undefined, m2: TaskMapper<B, C> | undefined): Promise<C>;
+export declare function pipe<A, B, C, D>(task: Task<A>, m1: TaskMapper<A, B> | undefined, m2: TaskMapper<B, C> | undefined, m3: TaskMapper<C, D> | undefined): Promise<D>;
+export declare function pipe<A, B, C, D, E>(task: Task<A>, m1: TaskMapper<A, B> | undefined, m2: TaskMapper<B, C> | undefined, m3: TaskMapper<C, D> | undefined, m4: TaskMapper<D, E> | undefined): Promise<E>;
+export declare function pipe<A, B, C, D, E, F>(task: Task<A>, m1: TaskMapper<A, B> | undefined, m2: TaskMapper<B, C> | undefined, m3: TaskMapper<C, D> | undefined, m4: TaskMapper<D, E> | undefined, m5: TaskMapper<E, F> | undefined): Promise<F>;
+//# sourceMappingURL=pipe.d.ts.map

package/dist/task/pipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../../src/task/pipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAE/C,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAClD,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AACvF,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC1B,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAChC,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,GAC/B,OAAO,CAAC,CAAC,CAAC,CAAA;AACb,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAC7B,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAChC,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAChC,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,GAC/B,OAAO,CAAC,CAAC,CAAC,CAAA;AACb,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAChC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAChC,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAChC,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAChC,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,GAC/B,OAAO,CAAC,CAAC,CAAC,CAAA;AACb,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EACnC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAChC,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAChC,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAChC,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAChC,EAAE,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,GAC/B,OAAO,CAAC,CAAC,CAAC,CAAA"}

package/dist/task/pipe.js

@@ -0,0 +1,11 @@
+export function pipe(task, ...steps) {
+    let acc = task;
+    for (const map of steps) {
+        // @note: mappers can be undefined which makes applying mappers conditionally easy
+        if (!map) {
+            continue;
+        }
+        acc = map(acc);
+    }
+    return acc();
+}

package/dist/task/retry.d.ts

@@ -0,0 +1,27 @@
+import type { Task, TaskMapper } from "./types";
+import { ErrResult, Result } from "../basic";
+import { type IRandom } from "../random";
+import { type DurationLike } from "../time";
+export type ErrResultOrError<T> = T extends Result<any, infer E> ? ErrResult<unknown, E> : unknown;
+export interface RetryOptions<R> {
+    until?: (error: ErrResultOrError<R>) => boolean;
+    times: number;
+    delay: DurationLike | RetryDelayPolicy;
+}
+export type RetryDelayPolicy = (attempt: number) => DurationLike;
+export interface RetryDependencies {
+    random: IRandom;
+}
+export declare function retry<T>(task: Task<T>, options: RetryOptions<T>, dependencies?: RetryDependencies): Promise<T>;
+export declare function retry<T>(options: RetryOptions<T>, dependencies?: RetryDependencies): TaskMapper<T, T>;
+export declare function ExponentialBackoffRetryPolicy(base: DurationLike): RetryDelayPolicy;
+interface JitteredRetryOptions {
+    minFactor?: number;
+    maxFactor?: number;
+}
+interface JitteredRetryDependencies {
+    random: IRandom;
+}
+export declare function JitteredRetryPolicy(base: DurationLike | RetryDelayPolicy, options?: JitteredRetryOptions, dependencies?: JitteredRetryDependencies): RetryDelayPolicy;
+export {};
+//# sourceMappingURL=retry.d.ts.map

package/dist/task/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/task/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAE/C,OAAO,EAAU,SAAS,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACpD,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,WAAW,CAAA;AACpD,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,SAAS,CAAA;AAEpE,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,OAAO,CAAA;AAElG,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,YAAY,GAAG,gBAAgB,CAAA;CACvC;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,CAAA;AAEhE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,wBAAgB,KAAK,CAAC,CAAC,EACrB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,YAAY,CAAC,EAAE,iBAAiB,GAC/B,OAAO,CAAC,CAAC,CAAC,CAAA;AACb,wBAAgB,KAAK,CAAC,CAAC,EACrB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,YAAY,CAAC,EAAE,iBAAiB,GAC/B,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAqDnB,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,YAAY,GAAG,gBAAgB,CAKlF;AAED,UAAU,oBAAoB;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,UAAU,yBAAyB;IACjC,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,YAAY,GAAG,gBAAgB,EACrC,OAAO,CAAC,EAAE,oBAAoB,EAC9B,YAAY,CAAC,EAAE,yBAAyB,GACvC,gBAAgB,CAgBlB"}