superlib 1.0.21 → 1.2.1-nightly.20260111.b4a0032

package/README.md

@@ -1,46 +1,27 @@
-# Simple dependency analysis tool for Node and Elm
+# SuperLib
 
-[NpmJs](https://www.npmjs.com/package/superlib)
+Missing standard library for TypeScript
 
 ## Install
 
-    npm install -g superlib
-
-## Requirements
-
-    Node 5.7.0+
-
-## Help
-
-```bash
-lib --help
-libm --help
+```sh
+npm install superlib@nightly
 ```
 
-## Usage
-
-Go to npm/elm project or a folder with many npm project subdirectories and run one of these commands:
-
-    lib
-    lib [dep]
-    libm
-    libm [dep]
-
-or
-
-    lib --path /Path/To/Project
-    libm --path /Path/To/Project
-
-## Tips
+## Features:
 
-If you use `iTerm2 v3.0`, you can click on the links in terminal with `CMD+click`.
+- `Task` primitive to orchestrate async work (retries, timeouts, concurrency etc.)
+- `FileSystem` abstraction and InMemoryFileSystem to test FS interactions
+- `ProcessContext` abstraction with env reader: `env.optionalBoolean("TEST", false)`
+- Optional error handling with `Result` type
+- And many, many smaller utils (`sleep`, `random`, `AbsolutePath` etc.)
 
-## Screenshots
+## Examples
 
-    lib
+- [github-stats](./packages/examples/github-stats/) - Fetches GitHub repository statistics using SuperLib's Task pipeline, SafeFetch, and FileSystem abstractions
 
-![](http://cl.ly/3n3Q3W0c2i10/Screen%20Shot%202016-03-31%20at%2023.47.51.png)
+### License
 
-    libm
+MIT
 
-![](http://cl.ly/3k352J3O1m2D/Screen%20Shot%202016-03-31%20at%2023.48.20.png)
+Special thanks to [davidhq](https://github.com/davidhq) for donating the npm's package name.

package/dist/basic/BaseError.d.ts

@@ -0,0 +1,4 @@
+export declare class BaseError extends Error {
+    constructor(message: string, cause?: unknown);
+}
+//# sourceMappingURL=BaseError.d.ts.map

package/dist/basic/BaseError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseError.d.ts","sourceRoot":"","sources":["../../src/basic/BaseError.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C"}

package/dist/basic/BaseError.js

@@ -0,0 +1,6 @@
+export class BaseError extends Error {
+    constructor(message, cause) {
+        super(message, { cause });
+        this.name = new.target.name; // sets the name of the error to name of the parent class
+    }
+}

package/dist/basic/Result.d.ts

@@ -0,0 +1,29 @@
+export interface TaggedError {
+    type: string;
+}
+export declare abstract class Result<V, E extends TaggedError> {
+    abstract isOk(): this is OkResult<V, E>;
+    abstract isErr(): this is ErrResult<V, E>;
+    abstract unwrap(): V;
+    abstract andThen<V2, E2 extends TaggedError>(mapper: (value: V) => Result<V2, E2>): Result<V2, E | E2>;
+    static try<V, E extends TaggedError>(fn: () => V, catchFn: (e: unknown) => E): Result<V, E>;
+}
+export declare class OkResult<V, E extends TaggedError> extends Result<V, E> {
+    readonly value: V;
+    constructor(value: V);
+    isOk(): this is OkResult<V, E>;
+    isErr(): this is ErrResult<V, E>;
+    unwrap(): V;
+    andThen<V2, E2 extends TaggedError>(mapper: (value: V) => Result<V2, E2>): Result<V2, E | E2>;
+}
+export declare class ErrResult<V, E extends TaggedError> extends Result<V, E> {
+    readonly err: E;
+    constructor(err: E);
+    isOk(): this is OkResult<V, E>;
+    isErr(): this is ErrResult<V, E>;
+    unwrap(): never;
+    andThen<V2, E2 extends TaggedError>(_mapper: (value: V) => Result<V2, E2>): Result<V2, E | E2>;
+}
+export declare function Ok<V = void>(value?: V): OkResult<V, never>;
+export declare function Err<E extends TaggedError>(err: E): ErrResult<never, E>;
+//# sourceMappingURL=Result.d.ts.map

package/dist/basic/Result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Result.d.ts","sourceRoot":"","sources":["../../src/basic/Result.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;CACb;AAED,8BAAsB,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW;IACnD,QAAQ,CAAC,IAAI,IAAI,IAAI,IAAI,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IACvC,QAAQ,CAAC,KAAK,IAAI,IAAI,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;IACzC,QAAQ,CAAC,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,WAAW,EACzC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GACnC,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC;IAGrB,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;CAO5F;AAED,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,CAAE,SAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;aACtC,KAAK,EAAE,CAAC;gBAAR,KAAK,EAAE,CAAC;IAIpC,IAAI,IAAI,IAAI,IAAI,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAI9B,KAAK,IAAI,IAAI,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;IAIhC,MAAM,IAAI,CAAC;IAIF,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,WAAW,EACzC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GACnC,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC;CAGtB;AAED,qBAAa,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,CAAE,SAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;aACvC,GAAG,EAAE,CAAC;gBAAN,GAAG,EAAE,CAAC;IAIlC,IAAI,IAAI,IAAI,IAAI,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAI9B,KAAK,IAAI,IAAI,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;IAIhC,MAAM,IAAI,KAAK;IAIN,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,WAAW,EACzC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GACpC,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC;CAGtB;AAED,wBAAgB,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAE1D;AAED,wBAAgB,GAAG,CAAC,CAAC,SAAS,WAAW,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAEtE"}

package/dist/basic/Result.js

@@ -0,0 +1,55 @@
+export class Result {
+    // @todo: catchFn should be able to return Result<V,E> to turn exception into Ok
+    static try(fn, catchFn) {
+        try {
+            return Ok(fn());
+        }
+        catch (e) {
+            return Err(catchFn(e));
+        }
+    }
+}
+export class OkResult extends Result {
+    value;
+    constructor(value) {
+        super();
+        this.value = value;
+    }
+    isOk() {
+        return true;
+    }
+    isErr() {
+        return false;
+    }
+    unwrap() {
+        return this.value;
+    }
+    andThen(mapper) {
+        return mapper(this.value);
+    }
+}
+export class ErrResult extends Result {
+    err;
+    constructor(err) {
+        super();
+        this.err = err;
+    }
+    isOk() {
+        return false;
+    }
+    isErr() {
+        return true;
+    }
+    unwrap() {
+        throw this.err;
+    }
+    andThen(_mapper) {
+        return this;
+    }
+}
+export function Ok(value) {
+    return new OkResult(value);
+}
+export function Err(err) {
+    return new ErrResult(err);
+}

package/dist/basic/ResultAsync.d.ts

@@ -0,0 +1,9 @@
+import { Result, type TaggedError } from "./Result";
+export declare class ResultAsync<V, E extends TaggedError> {
+    private readonly promisedResult;
+    constructor(promisedResult: Promise<Result<V, E>>);
+    andThen<V2, E2 extends TaggedError>(mapper: (value: V) => Result<V2, E2> | ResultAsync<V2, E2>): ResultAsync<V2, E | E2>;
+    toPromise(): Promise<Result<V, E>>;
+    static try<V, E extends TaggedError>(fn: () => Promise<V>, catchFn: (e: unknown) => E | Result<V, E>): ResultAsync<V, E>;
+}
+//# sourceMappingURL=ResultAsync.d.ts.map

package/dist/basic/ResultAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultAsync.d.ts","sourceRoot":"","sources":["../../src/basic/ResultAsync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AAE5D,qBAAa,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAElE,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,WAAW,EAChC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC,GACzD,WAAW,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC;IAiB1B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAIlC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,EACjC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GACxC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;CAcrB"}

package/dist/basic/ResultAsync.js

@@ -0,0 +1,41 @@
+import { Err, Ok, Result } from "./Result.js";
+export class ResultAsync {
+    promisedResult;
+    constructor(promisedResult) {
+        this.promisedResult = promisedResult;
+    }
+    andThen(mapper) {
+        const result = this.promisedResult.then(async (r) => {
+            if (r.isOk()) {
+                const result = mapper(r.value);
+                if (result instanceof Result) {
+                    return result;
+                }
+                else {
+                    return result.promisedResult;
+                }
+            }
+            else {
+                return r;
+            }
+        });
+        return new ResultAsync(result);
+    }
+    toPromise() {
+        return this.promisedResult;
+    }
+    static try(fn, catchFn) {
+        const result = fn()
+            .then((v) => Ok(v))
+            .catch((e) => {
+            const r = catchFn(e);
+            if (r instanceof Result) {
+                return r;
+            }
+            else {
+                return Err(r);
+            }
+        });
+        return new ResultAsync(result);
+    }
+}

package/dist/basic/assert.d.ts

@@ -0,0 +1,8 @@
+import { BaseError } from "./BaseError";
+export declare class AssertionError extends BaseError {
+    constructor(message?: string);
+}
+export declare function assert(condition: boolean, error?: string | Error): asserts condition;
+export declare function raise(error: string | Error): never;
+export declare function assertNever(x: never): never;
+//# sourceMappingURL=assert.d.ts.map

package/dist/basic/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/basic/assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,qBAAa,cAAe,SAAQ,SAAS;gBAC/B,OAAO,CAAC,EAAE,MAAM;CAO7B;AAED,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,SAAS,CAIpF;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAMlD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAE3C"}

package/dist/basic/assert.js

@@ -0,0 +1,25 @@
+import { BaseError } from "./BaseError.js";
+export class AssertionError extends BaseError {
+    constructor(message) {
+        if (message !== undefined) {
+            super(`assertion failed: ${message}`);
+        }
+        else {
+            super("assertion failed");
+        }
+    }
+}
+export function assert(condition, error) {
+    if (!condition) {
+        raise(error ?? "Assertion failed");
+    }
+}
+export function raise(error) {
+    if (error instanceof Error) {
+        throw error;
+    }
+    throw new AssertionError(error);
+}
+export function assertNever(x) {
+    throw new AssertionError(`assertNever: Unexpected object: ${x}`);
+}

package/dist/basic/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./assert";
+export * from "./BaseError";
+export * from "./Result";
+export * from "./ResultAsync";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/basic/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA"}

package/dist/basic/index.js

@@ -0,0 +1,4 @@
+export * from "./assert.js";
+export * from "./BaseError.js";
+export * from "./Result.js";
+export * from "./ResultAsync.js";

package/dist/decorators/Retry.d.ts

@@ -0,0 +1,3 @@
+import { type RetryDependencies, type RetryOptions } from "../task/retry";
+export declare function Retry<TThis, TArgs extends unknown[], TResult>(options: RetryOptions<TResult>, dependencies?: RetryDependencies): (value: (this: TThis, ...args: TArgs) => Promise<TResult>, context: ClassMethodDecoratorContext<TThis, (this: TThis, ...args: TArgs) => Promise<TResult>>) => (this: TThis, ...args: TArgs) => Promise<TResult>;
+//# sourceMappingURL=Retry.d.ts.map

package/dist/decorators/Retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Retry.d.ts","sourceRoot":"","sources":["../../src/decorators/Retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AAGhF,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EAC3D,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,EAC9B,YAAY,CAAC,EAAE,iBAAiB,GAC/B,CACD,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,EACxD,OAAO,EAAE,2BAA2B,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,KAC3F,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAMrD"}

package/dist/decorators/Retry.js

@@ -0,0 +1,9 @@
+import { retry } from "../task/retry.js";
+import { universalMethodDecorator } from "./common.js";
+export function Retry(options, dependencies) {
+    return universalMethodDecorator((value) => {
+        return function (...args) {
+            return retry(() => value.apply(this, args), options, dependencies);
+        };
+    });
+}

package/dist/decorators/Timeout.d.ts

@@ -0,0 +1,3 @@
+import { type TimeoutOptions } from "../task/timeout";
+export declare function Timeout<TThis, TArgs extends unknown[], TResult>(options: TimeoutOptions): (value: (this: TThis, ...args: TArgs) => Promise<TResult>, context: ClassMethodDecoratorContext<TThis, (this: TThis, ...args: TArgs) => Promise<TResult>>) => (this: TThis, ...args: TArgs) => Promise<TResult>;
+//# sourceMappingURL=Timeout.d.ts.map

package/dist/decorators/Timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timeout.d.ts","sourceRoot":"","sources":["../../src/decorators/Timeout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAG9D,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EAC7D,OAAO,EAAE,cAAc,GACtB,CACD,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,EACxD,OAAO,EAAE,2BAA2B,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,KAC3F,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAMrD"}

package/dist/decorators/Timeout.js

@@ -0,0 +1,9 @@
+import { timeout } from "../task/timeout.js";
+import { universalMethodDecorator } from "./common.js";
+export function Timeout(options) {
+    return universalMethodDecorator((value) => {
+        return function (...args) {
+            return timeout(() => value.apply(this, args), options);
+        };
+    });
+}

package/dist/decorators/common.d.ts

@@ -0,0 +1,2 @@
+export declare function universalMethodDecorator(decorator: (originalFunction: Function) => Function): any;
+//# sourceMappingURL=common.d.ts.map

package/dist/decorators/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/decorators/common.ts"],"names":[],"mappings":"AAGA,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,CAAC,gBAAgB,EAAE,QAAQ,KAAK,QAAQ,GAAG,GAAG,CAoBjG"}

package/dist/decorators/common.js

@@ -0,0 +1,17 @@
+import { assert } from "../basic/index.js";
+// bun only supports legacy TS decorator spec this function deals with all the inconsistencies and supports both standards at the same time
+export function universalMethodDecorator(decorator) {
+    return function (value, context) {
+        if (typeof context === "object" && context !== null && "kind" in context) {
+            assert(context.kind === "method", "Decorator can only be used on methods");
+            return decorator(value);
+        }
+        const descriptor = arguments[2];
+        assert(descriptor?.value instanceof Function, "Decorator can only be used on methods");
+        const original = descriptor.value;
+        return {
+            ...descriptor,
+            value: decorator(original),
+        };
+    };
+}

package/dist/decorators/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA"}

package/dist/decorators/index.js

@@ -0,0 +1,2 @@
+export * from "./Retry.js";
+export * from "./Timeout.js";

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import "temporal-polyfill/global";
+export * from "./time";
+export * from "./task";
+export * from "./basic";
+export * from "./types";
+export * from "./decorators";
+export * from "./random";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,0BAA0B,CAAA;AAEjC,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+import "temporal-polyfill/global";
+export * from "./time/index.js";
+export * from "./task/index.js";
+export * from "./basic/index.js";
+export * from "./types/index.js";
+export * from "./decorators/index.js";
+export * from "./random/index.js";

package/dist/platform/JsonHttpClient/JsonHttpClient.d.ts

@@ -0,0 +1,18 @@
+import type { StandardSchemaV1 } from "../../schema/StandardSchema";
+import { type Result } from "../../basic";
+import { type ValidationError } from "../../schema/validateSchema";
+import { type SafeFetch, type SafeFetchError } from "../safeFetch";
+export type JsonHttpClientError = SafeFetchError | {
+    type: "jsonHttpClient/json-parse";
+    cause: unknown;
+} | ValidationError;
+export declare class JsonHttpClient {
+    private readonly safeFetch;
+    constructor(safeFetch?: SafeFetch);
+    private request;
+    get<T>(url: string, schema: StandardSchemaV1<T>): Promise<Result<T, JsonHttpClientError>>;
+    post<T>(url: string, body: unknown, schema: StandardSchemaV1<T>): Promise<Result<T, JsonHttpClientError>>;
+    patch<T>(url: string, body: unknown, schema: StandardSchemaV1<T>): Promise<Result<T, JsonHttpClientError>>;
+    delete<T>(url: string, schema: StandardSchemaV1<T>): Promise<Result<T, JsonHttpClientError>>;
+}
+//# sourceMappingURL=JsonHttpClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"JsonHttpClient.d.ts","sourceRoot":"","sources":["../../../src/platform/JsonHttpClient/JsonHttpClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAEnE,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClF,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,cAAc,EAEpB,MAAM,cAAc,CAAA;AAErB,MAAM,MAAM,mBAAmB,GAC3B,cAAc,GACd;IAAE,IAAI,EAAE,2BAA2B,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACrD,eAAe,CAAA;AAWnB,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,GAAE,SAAkD;YAE5E,OAAO;IAsBf,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAIzF,IAAI,CAAC,CAAC,EACV,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAOpC,KAAK,CAAC,CAAC,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAOpC,MAAM,CAAC,CAAC,EACZ,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;CAG3C"}

package/dist/platform/JsonHttpClient/JsonHttpClient.js

@@ -0,0 +1,48 @@
+import { ResultAsync } from "../../basic/index.js";
+import { validateSchema } from "../../schema/validateSchema.js";
+import { makeSafeFetch, } from "../safeFetch/index.js";
+const defaultSafeFetchOptions = {
+    retry: {
+        times: 3,
+        delay: { milliseconds: 200 }, // @note: jittered by default
+        untilStatus: (status) => status >= 200 && status < 300,
+    },
+    timeout: { seconds: 5 },
+};
+export class JsonHttpClient {
+    safeFetch;
+    constructor(safeFetch = makeSafeFetch(defaultSafeFetchOptions)) {
+        this.safeFetch = safeFetch;
+    }
+    async request(url, schema, _requestInit) {
+        const requestInit = {
+            ..._requestInit,
+            headers: { ...defaultHeaders, ..._requestInit?.headers },
+        };
+        return new ResultAsync(this.safeFetch(url, requestInit))
+            .andThen((response) => ResultAsync.try(() => response.json(), (err) => ({ type: "jsonHttpClient/json-parse", cause: err })))
+            .andThen((json) => {
+            return validateSchema(schema, json);
+        })
+            .toPromise();
+    }
+    async get(url, schema) {
+        return this.request(url, schema);
+    }
+    async post(url, body, schema) {
+        return this.request(url, schema, {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+    }
+    async patch(url, body, schema) {
+        return this.request(url, schema, {
+            method: "PATCH",
+            body: JSON.stringify(body),
+        });
+    }
+    async delete(url, schema) {
+        return this.request(url, schema, { method: "DELETE" });
+    }
+}
+const defaultHeaders = { "content-type": "application/json" };

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

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

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

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

package/dist/platform/JsonHttpClient/index.js

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

package/dist/platform/ProcessContext/EnvReader.d.ts

@@ -0,0 +1,12 @@
+export declare class EnvReader {
+    private readonly env;
+    constructor(env: Record<string, string | undefined>);
+    string(name: string, defaultValue?: string): string;
+    optionalString(name: string): string | undefined;
+    stringOf<T extends string[]>(key: string, allowedValues: readonly [...T], fallback?: T[number]): T[number];
+    number(name: string, defaultValue?: number): number;
+    optionalNumber(name: string): number | undefined;
+    boolean(name: string, defaultValue?: boolean): boolean;
+    optionalBoolean(name: string): boolean | undefined;
+}
+//# sourceMappingURL=EnvReader.d.ts.map

package/dist/platform/ProcessContext/EnvReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvReader.d.ts","sourceRoot":"","sources":["../../../src/platform/ProcessContext/EnvReader.ts"],"names":[],"mappings":"AAEA,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAEpE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM;IAMnD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIhD,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,EACzB,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,EAC9B,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,GACnB,CAAC,CAAC,MAAM,CAAC;IAoBZ,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM;IAMnD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAehD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO;IAMtD,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;CAiBnD"}

package/dist/platform/ProcessContext/EnvReader.js

@@ -0,0 +1,56 @@
+import { raise } from "../../basic/index.js";
+export class EnvReader {
+    env;
+    constructor(env) {
+        this.env = env;
+    }
+    string(name, defaultValue) {
+        return (this.optionalString(name) ?? defaultValue ?? raise(`Environment variable ${name} not found`));
+    }
+    optionalString(name) {
+        return this.env[name];
+    }
+    stringOf(key, allowedValues, fallback) {
+        const value = this.optionalString(key);
+        if (value === undefined) {
+            return fallback ?? raise(`Environment variable ${key} not found`);
+        }
+        if (allowedValues.includes(value)) {
+            return value;
+        }
+        if (fallback !== undefined) {
+            return fallback;
+        }
+        raise(`Environment variable ${key} has invalid value "${value}". Allowed values: ${allowedValues.join(", ")}`);
+    }
+    number(name, defaultValue) {
+        return (this.optionalNumber(name) ?? defaultValue ?? raise(`Environment variable ${name} not found`));
+    }
+    optionalNumber(name) {
+        const value = this.optionalString(name);
+        if (value === undefined) {
+            return undefined;
+        }
+        const parsed = Number(value);
+        if (Number.isNaN(parsed) || value.trim() === "") {
+            raise(`Environment variable ${name} has invalid number value "${value}"`);
+        }
+        return parsed;
+    }
+    boolean(name, defaultValue) {
+        return (this.optionalBoolean(name) ?? defaultValue ?? raise(`Environment variable ${name} not found`));
+    }
+    optionalBoolean(name) {
+        const value = this.optionalString(name);
+        if (value === undefined) {
+            return undefined;
+        }
+        if (value === "true" || value === "1" || value === "yes") {
+            return true;
+        }
+        if (value === "false" || value === "0" || value === "no") {
+            return false;
+        }
+        raise(`Environment variable ${name} has invalid boolean value "${value}"`);
+    }
+}

package/dist/platform/ProcessContext/ProcessContext.d.ts

@@ -0,0 +1,40 @@
+import { AbsolutePath } from "../filesystem";
+import { EnvReader } from "./EnvReader";
+export interface IProcessContext {
+    readonly cwd: AbsolutePath;
+    readonly env: EnvReader;
+    readonly home: AbsolutePath;
+    pathFromCwd(path: string): AbsolutePath;
+    /**
+     * Resolves and expands paths.
+     * - Absolute paths (e.g., "/usr/local") are returned as-is
+     * - Paths starting with "~" are resolved relative to home directory
+     * - All other paths are resolved relative to current working directory
+     */
+    resolvePath(path: string): AbsolutePath;
+}
+export declare abstract class AbstractProcessContext implements IProcessContext {
+    abstract readonly cwd: AbsolutePath;
+    abstract readonly env: EnvReader;
+    abstract readonly home: AbsolutePath;
+    pathFromCwd(path: string): AbsolutePath;
+    resolvePath(inputPath: string): AbsolutePath;
+}
+export declare class ProcessContext extends AbstractProcessContext {
+    readonly home: AbsolutePath;
+    readonly cwd: AbsolutePath;
+    readonly env: EnvReader;
+    constructor();
+}
+export interface InMemoryProcessContextOptions {
+    cwd?: AbsolutePath;
+    home?: AbsolutePath;
+    env?: Dict<string>;
+}
+export declare class InMemoryProcessContext extends AbstractProcessContext {
+    readonly home: AbsolutePath;
+    readonly cwd: AbsolutePath;
+    readonly env: EnvReader;
+    constructor(options?: InMemoryProcessContextOptions);
+}
+//# sourceMappingURL=ProcessContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessContext.d.ts","sourceRoot":"","sources":["../../../src/platform/ProcessContext/ProcessContext.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAG3B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAA;IACvC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAA;CACxC;AAED,8BAAsB,sBAAuB,YAAW,eAAe;IACrE,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;IAChC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAEpC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAIvC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;CA8B7C;AAED,qBAAa,cAAe,SAAQ,sBAAsB;IACxD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAiC;IAC5D,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAkC;IAC5D,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;;CAOxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,GAAG,CAAC,EAAE,YAAY,CAAA;IAClB,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;CACnB;AAED,qBAAa,sBAAuB,SAAQ,sBAAsB;IAChE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;gBAEX,OAAO,CAAC,EAAE,6BAA6B;CAMpD"}