barely-effect 0.1.0

package/dist/time/Clock.d.ts

@@ -0,0 +1,21 @@
+import { type DurationLike } from "./temporal";
+type PublicInterface<T> = {
+    [K in keyof T]: T[K];
+};
+export type IClock = PublicInterface<AbstractClock>;
+export declare abstract class AbstractClock implements IClock {
+    abstract now(): Temporal.Instant;
+    nowDate(): Date;
+}
+export declare class Clock extends AbstractClock {
+    now(): Temporal.Instant;
+}
+export declare class TestClock extends AbstractClock {
+    private _now;
+    constructor(_now: Temporal.Instant);
+    now(): Temporal.Instant;
+    advance(duration: DurationLike): void;
+    reset(now: Temporal.Instant): void;
+}
+export {};
+//# sourceMappingURL=Clock.d.ts.map

package/dist/time/Clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Clock.d.ts","sourceRoot":"","sources":["../../src/time/Clock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,KAAK,eAAe,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAA;AAElD,MAAM,MAAM,MAAM,GAAG,eAAe,CAAC,aAAa,CAAC,CAAA;AAEnD,8BAAsB,aAAc,YAAW,MAAM;IACnD,QAAQ,CAAC,GAAG,IAAI,QAAQ,CAAC,OAAO;IAEhC,OAAO,IAAI,IAAI;CAGhB;AAED,qBAAa,KAAM,SAAQ,aAAa;IACtC,GAAG,IAAI,QAAQ,CAAC,OAAO;CAGxB;AAED,qBAAa,SAAU,SAAQ,aAAa;IAC9B,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,QAAQ,CAAC,OAAO;IAI1C,GAAG,IAAI,QAAQ,CAAC,OAAO;IAIvB,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAIrC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,GAAG,IAAI;CAGnC"}

package/dist/time/Clock.js

@@ -0,0 +1,27 @@
+import {} from "./temporal.js";
+export class AbstractClock {
+    nowDate() {
+        return new Date(this.now().epochMilliseconds);
+    }
+}
+export class Clock extends AbstractClock {
+    now() {
+        return Temporal.Now.instant();
+    }
+}
+export class TestClock extends AbstractClock {
+    _now;
+    constructor(_now) {
+        super();
+        this._now = _now;
+    }
+    now() {
+        return this._now;
+    }
+    advance(duration) {
+        this._now = this._now.add(Temporal.Duration.from(duration));
+    }
+    reset(now) {
+        this._now = now;
+    }
+}

package/dist/time/temporal.d.ts

@@ -0,0 +1,5 @@
+export type DurationLike = Omit<Temporal.DurationLike, "microseconds" | "nanoseconds"> | Omit<Temporal.Duration, "microseconds" | "nanoseconds">;
+export declare function multiplyDuration(base: Temporal.Duration, factor: number): Temporal.Duration;
+export declare function durationToMs(duration: Temporal.Duration): number;
+export declare function prettyPrintDuration(duration: Temporal.Duration): string;
+//# sourceMappingURL=temporal.d.ts.map

package/dist/time/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../../src/time/temporal.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,cAAc,GAAG,aAAa,CAAC,GAC3D,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa,CAAC,CAAA;AAE3D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAW3F;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAEhE;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAkBvE"}

package/dist/time/temporal.js

@@ -0,0 +1,39 @@
+export function multiplyDuration(base, factor) {
+    return Temporal.Duration.from({
+        years: Math.round(base.years * factor),
+        months: Math.round(base.months * factor),
+        weeks: Math.round(base.weeks * factor),
+        days: Math.round(base.days * factor),
+        hours: Math.round(base.hours * factor),
+        minutes: Math.round(base.minutes * factor),
+        seconds: Math.round(base.seconds * factor),
+        milliseconds: Math.round(base.milliseconds * factor),
+    });
+}
+export function durationToMs(duration) {
+    return duration.total("milliseconds");
+}
+export function prettyPrintDuration(duration) {
+    // note: there is Intl.DurationFormat("en", { style: "narrow" }).format(duration) which should do the same thing but:
+    // 1. It's not available in node <= 22, Intl.DurationFormat is not available
+    // 2. Exact formatting output is dependent on ICU data and on some environments (CI) months get formatted as m instead of mo
+    // for these reasons it's better to always use bespoke implementation
+    const parts = [];
+    if (duration.years)
+        parts.push(`${duration.years}y`);
+    if (duration.months)
+        parts.push(`${duration.months}mo`);
+    if (duration.weeks)
+        parts.push(`${duration.weeks}w`);
+    if (duration.days)
+        parts.push(`${duration.days}d`);
+    if (duration.hours)
+        parts.push(`${duration.hours}h`);
+    if (duration.minutes)
+        parts.push(`${duration.minutes}m`);
+    if (duration.seconds)
+        parts.push(`${duration.seconds}s`);
+    if (duration.milliseconds)
+        parts.push(`${duration.milliseconds}ms`);
+    return parts.join(" ");
+}

package/dist/utils/jsonStringify.d.ts

@@ -0,0 +1,7 @@
+export declare function jsonStringifyAll(value: object, space?: number): string;
+export interface PrettyJsonStringifyAllOptions {
+    space?: number;
+    singleLineUntilLength?: number;
+}
+export declare function prettyJsonStringifyAll(value: object, options?: PrettyJsonStringifyAllOptions): string;
+//# sourceMappingURL=jsonStringify.d.ts.map

package/dist/utils/jsonStringify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonStringify.d.ts","sourceRoot":"","sources":["../../src/utils/jsonStringify.ts"],"names":[],"mappings":"AAYA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,6BAA6B,GACtC,MAAM,CAYR"}

package/dist/utils/jsonStringify.js

@@ -0,0 +1,23 @@
+function replacer(_k, v) {
+    if (typeof v === "bigint") {
+        return v.toString();
+    }
+    if (v instanceof Promise) {
+        return "Promise";
+    }
+    return v;
+}
+export function jsonStringifyAll(value, space) {
+    return JSON.stringify(value, replacer, space);
+}
+export function prettyJsonStringifyAll(value, options) {
+    const singleLineUntilLength = options?.singleLineUntilLength;
+    const space = options?.space;
+    if (singleLineUntilLength !== undefined) {
+        const compact = jsonStringifyAll(value);
+        if (compact.length <= singleLineUntilLength) {
+            return compact;
+        }
+    }
+    return jsonStringifyAll(value, space);
+}

package/dist/utils/runMain.d.ts

@@ -0,0 +1,3 @@
+import { Effect } from "effect";
+export declare function runMain<E>(program: Effect.Effect<void, E>): Promise<void>;
+//# sourceMappingURL=runMain.d.ts.map

package/dist/utils/runMain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runMain.d.ts","sourceRoot":"","sources":["../../src/utils/runMain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAQ,MAAM,QAAQ,CAAA;AAkF5C,wBAAsB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/E"}

package/dist/utils/runMain.js

@@ -0,0 +1,75 @@
+import { Cause, Effect, Exit } from "effect";
+import { ansiColors } from "../ansi-colors/index.js";
+function prettyValue(value) {
+    if (value instanceof Error) {
+        return value.message || value.name;
+    }
+    return String(value);
+}
+function findDeepestError(value) {
+    if (!(value instanceof Object)) {
+        return undefined;
+    }
+    for (const v of Object.values(value)) {
+        if (v instanceof Error) {
+            return findDeepestError(v) ?? v;
+        }
+    }
+    return value instanceof Error ? value : undefined;
+}
+function formatStackTrace(stack) {
+    const lines = stack.split("\n");
+    const stackLines = lines.filter((line) => line.trimStart().startsWith("at "));
+    return stackLines.map((line) => ansiColors.gray(`  ${line.trim()}`)).join("\n");
+}
+function prettyReason(reason) {
+    const lines = [];
+    if (Cause.isFailReason(reason)) {
+        const error = reason.error;
+        const name = error instanceof Object && "_tag" in error ? String(error._tag) : String(error);
+        const args = error instanceof Object
+            ? Object.entries(error)
+                .filter(([key]) => key !== "_tag")
+                .map(([key, value]) => `  ${ansiColors.cyan(key)}: ${prettyValue(value)}`)
+            : undefined;
+        lines.push(ansiColors.red(name));
+        if (args?.length) {
+            lines.push(...args);
+        }
+        const deepestError = error instanceof Object ? findDeepestError(error) : undefined;
+        const stackSource = deepestError ?? (error instanceof Error ? error : undefined);
+        if (stackSource?.stack) {
+            lines.push(formatStackTrace(stackSource.stack));
+        }
+    }
+    else if (Cause.isDieReason(reason)) {
+        lines.push(ansiColors.bold(ansiColors.red("Die")));
+        lines.push(`  ${prettyValue(reason.defect)}`);
+        const stackSource = reason.defect instanceof Object
+            ? (findDeepestError(reason.defect) ??
+                (reason.defect instanceof Error ? reason.defect : undefined))
+            : undefined;
+        if (stackSource?.stack) {
+            lines.push(formatStackTrace(stackSource.stack));
+        }
+    }
+    else if (Cause.isInterruptReason(reason)) {
+        lines.push(ansiColors.bold(ansiColors.yellow("Interrupt")) +
+            (reason.fiberId != null ? ansiColors.gray(` (fiber #${String(reason.fiberId)})`) : ""));
+    }
+    return lines.join("\n");
+}
+function prettyCause(cause) {
+    return cause.reasons.map((reason) => prettyReason(reason)).join("\n\n");
+}
+export async function runMain(program) {
+    const exit = await Effect.runPromiseExit(program);
+    Exit.match(exit, {
+        onSuccess: () => process.exit(0),
+        onFailure: (cause) => {
+            process.stderr.write(ansiColors.bold(ansiColors.red("Fatal error occured\n")) + "\n");
+            process.stderr.write(prettyCause(cause) + "\n");
+            process.exit(1);
+        },
+    });
+}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "barely-effect",
+  "version": "0.1.0",
+  "description": "A missing standard library for TypeScript, providing utilities for async orchestration, error handling, filesystem abstraction, and common patterns",
+  "keywords": [
+    "async",
+    "result",
+    "stdlib",
+    "task",
+    "typescript",
+    "utilities"
+  ],
+  "license": "MIT",
+  "author": "Kris Kaczor",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/krzkaczor/barely-effect.git"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./platform/filesystem": {
+      "types": "./dist/platform/filesystem/index.d.ts",
+      "default": "./dist/platform/filesystem/index.js"
+    },
+    "./platform/getPort": {
+      "types": "./dist/platform/getPort/index.d.ts",
+      "default": "./dist/platform/getPort/index.js"
+    },
+    "./platform/JsonHttpClient": {
+      "types": "./dist/platform/JsonHttpClient/index.d.ts",
+      "default": "./dist/platform/JsonHttpClient/index.js"
+    },
+    "./platform/ProcessContext": {
+      "types": "./dist/platform/ProcessContext/index.d.ts",
+      "default": "./dist/platform/ProcessContext/index.js"
+    },
+    "./platform/safeFetch": {
+      "types": "./dist/platform/safeFetch/index.d.ts",
+      "default": "./dist/platform/safeFetch/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && bun run scripts/fix-imports.ts && cp ../../README.md .",
+    "lint": "oxlint --type-aware --type-check --deny-warnings",
+    "lint:fix": "bun run lint --fix --fix-dangerously --fix-suggestions",
+    "test": "bun test",
+    "test:vitest": "bun run scripts/transform-tests-for-vitest.ts && vitest run",
+    "fix": "cd ../.. && bun run fix"
+  },
+  "dependencies": {
+    "effect": "4.0.0-beta.23",
+    "remeda": "^2.32.0",
+    "temporal-polyfill": "^0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "vitest": "^3.0.0",
+    "zod": "^4.3.5"
+  }
+}