brass-runtime 1.14.0 → 1.15.0

package/dist/stream-FQm9h4Mg.d.ts

@@ -0,0 +1,74 @@
+import { Z as ZIO, O as Option, E as Exit, A as Async } from './effect-CMOQKX8y.js';
+
+type Empty<R, E, A> = {
+    readonly _tag: "Empty";
+};
+type Emit<R, E, A> = {
+    readonly _tag: "Emit";
+    readonly value: ZIO<R, E, A>;
+};
+type Concat<R, E, A> = {
+    readonly _tag: "Concat";
+    readonly left: ZStream<R, E, A>;
+    readonly right: ZStream<R, E, A>;
+};
+type Flatten<R, E, A> = {
+    readonly _tag: "Flatten";
+    readonly stream: ZStream<R, E, ZStream<R, E, A>>;
+};
+type FromPull<R, E, A> = {
+    readonly _tag: "FromPull";
+    readonly pull: ZIO<R, Option<E>, [A, ZStream<R, E, A>]>;
+};
+type Merge<R, E, A> = {
+    readonly _tag: "Merge";
+    readonly left: ZStream<R, E, A>;
+    readonly right: ZStream<R, E, A>;
+    readonly flip: boolean;
+};
+type Scoped<R, E, A> = {
+    readonly _tag: "Scoped";
+    readonly acquire: ZIO<R, E, ZStream<R, E, A>>;
+    readonly release: (exit: Exit<any, any>) => Async<R, any, void>;
+};
+type Managed<R, E, A> = {
+    readonly _tag: "Managed";
+    readonly acquire: ZIO<R, E, {
+        stream: ZStream<R, E, A>;
+        release: (exit: Exit<any, any>) => Async<R, any, void>;
+    }>;
+};
+type FromArray<R, E, A> = {
+    readonly _tag: "FromArray";
+    readonly values: readonly A[];
+};
+type ZStream<R, E, A> = Empty<R, E, A> | Emit<R, E, A> | Concat<R, E, A> | FromPull<R, E, A> | FromArray<R, E, A> | Flatten<R, E, A> | Merge<R, E, A> | Scoped<R, E, A> | Managed<R, E, A>;
+type Normalize<E> = (u: unknown) => E;
+declare const widenOpt: <E1, E2>(opt: Option<E1>) => Option<E1 | E2>;
+declare const fromPull: <R, E, A>(pull: ZIO<R, Option<E>, [A, ZStream<R, E, A>]>) => ZStream<R, E, A>;
+declare const unwrapScoped: <R, E, A>(acquire: ZIO<R, E, ZStream<R, E, A>>, release: (exit: Exit<any, any>) => Async<R, any, void>) => ZStream<R, E, A>;
+declare const managedStream: <R, E, A>(acquire: ZIO<R, E, {
+    stream: ZStream<R, E, A>;
+    release: (exit: Exit<any, any>) => Async<R, any, void>;
+}>) => ZStream<R, E, A>;
+declare const mergeStream: <R, E, A>(left: ZStream<R, E, A>, right: ZStream<R, E, A>, flip?: boolean) => ZStream<R, E, A>;
+declare const emptyStream: <R, E, A>() => ZStream<R, E, A>;
+declare const emitStream: <R, E, A>(value: ZIO<R, E, A>) => ZStream<R, E, A>;
+declare const concatStream: <R, E, A>(left: ZStream<R, E, A>, right: ZStream<R, E, A>) => ZStream<R, E, A>;
+declare const flattenStream: <R, E, A>(stream: ZStream<R, E, ZStream<R, E, A>>) => ZStream<R, E, A>;
+declare function merge<R, E, A>(left: ZStream<R, E, A>, right: ZStream<R, E, A>): ZStream<R, E, A>;
+declare function uncons<R, E, A>(self: ZStream<R, E, A>): ZIO<R, Option<E>, [A, ZStream<R, E, A>]>;
+declare function assertNever(x: never, msg?: string): never;
+declare function mapStream<R, E, A, B>(self: ZStream<R, E, A>, f: (a: A) => B): ZStream<R, E, B>;
+declare function rangeStream(start: number, end: number): ZStream<unknown, never, number>;
+declare function zip<R, E1, A, E2, B>(left: ZStream<R, E1, A>, right: ZStream<R, E2, B>): ZStream<R, E1 | E2, [A, B]>;
+declare function foreachStream<R, E, A, R2, E2>(stream: ZStream<R, E, A>, f: (a: A) => Async<R2, E2, void>): Async<R & R2, E | E2, void>;
+declare function fromArray<A>(values: readonly A[]): ZStream<unknown, never, A>;
+declare function collectStream<R, E, A>(stream: ZStream<R, E, A>): ZIO<R, E, A[]>;
+type ReadableStreamOptions = {
+    signal?: AbortSignal;
+    onRelease?: () => void;
+};
+declare function streamFromReadableStream<E>(body: ReadableStream<Uint8Array> | null | undefined, normalizeError: Normalize<E>, options?: ReadableStreamOptions): ZStream<unknown, E, Uint8Array>;
+
+export { type Concat as C, type Emit as E, type Flatten as F, type Managed as M, type Normalize as N, type ReadableStreamOptions as R, type Scoped as S, type ZStream as Z, type Empty as a, type FromArray as b, type FromPull as c, type Merge as d, assertNever as e, collectStream as f, concatStream as g, emitStream as h, emptyStream as i, flattenStream as j, foreachStream as k, fromArray as l, fromPull as m, managedStream as n, mapStream as o, merge as p, mergeStream as q, rangeStream as r, streamFromReadableStream as s, unwrapScoped as t, uncons as u, widenOpt as w, zip as z };

package/dist/tracing-DNT9jEbr.d.ts

@@ -0,0 +1,106 @@
+import { A as Async } from './effect-CMOQKX8y.js';
+
+type CircuitBreakerState = "closed" | "open" | "half-open";
+type CircuitBreakerError = {
+    readonly _tag: "CircuitBreakerOpen";
+    readonly openSince: number;
+    readonly failures: number;
+};
+type CircuitBreakerConfig = {
+    /** Number of consecutive failures before opening the circuit. Default: 5 */
+    readonly failureThreshold?: number;
+    /** Time in ms to wait before transitioning from OPEN to HALF_OPEN. Default: 30000 */
+    readonly resetTimeoutMs?: number;
+    /** Number of successes in HALF_OPEN needed to close the circuit. Default: 1 */
+    readonly successThreshold?: number;
+    /** Custom predicate: should this error count as a failure? Default: all errors count. */
+    readonly isFailure?: (error: unknown) => boolean;
+    /** Called on state transitions (for observability). */
+    readonly onStateChange?: (from: CircuitBreakerState, to: CircuitBreakerState) => void;
+};
+type CircuitBreakerStats = {
+    readonly state: CircuitBreakerState;
+    readonly failures: number;
+    readonly successes: number;
+    readonly totalRequests: number;
+    readonly totalFailures: number;
+    readonly totalSuccesses: number;
+    readonly totalRejected: number;
+    readonly lastFailureTime: number | null;
+    readonly lastSuccessTime: number | null;
+};
+type CircuitBreaker = {
+    /** Current state of the circuit breaker. */
+    readonly state: () => CircuitBreakerState;
+    /** Run an effect through the circuit breaker. */
+    readonly protect: <R, E, A>(effect: Async<R, E, A>) => Async<R, E | CircuitBreakerError, A>;
+    /** Get current stats. */
+    readonly stats: () => CircuitBreakerStats;
+    /** Manually reset to closed state. */
+    readonly reset: () => void;
+};
+/**
+ * Creates a circuit breaker.
+ *
+ * ```ts
+ * const breaker = makeCircuitBreaker({ failureThreshold: 3, resetTimeoutMs: 10000 });
+ *
+ * // Protect an effect:
+ * const result = await run(breaker.protect(callExternalService()));
+ * // Throws CircuitBreakerOpen if circuit is open
+ * ```
+ */
+declare function makeCircuitBreaker(config?: CircuitBreakerConfig): CircuitBreaker;
+
+type SpanContext = {
+    readonly traceId: string;
+    readonly spanId: string;
+    readonly parentSpanId?: string;
+};
+type SpanStatus = "ok" | "error" | "unset";
+type Span = {
+    readonly name: string;
+    readonly context: SpanContext;
+    readonly startTime: number;
+    endTime?: number;
+    status: SpanStatus;
+    readonly attributes: Record<string, string | number | boolean>;
+    readonly events: SpanEvent[];
+};
+type SpanEvent = {
+    readonly name: string;
+    readonly time: number;
+    readonly attributes?: Record<string, string | number | boolean>;
+};
+type TracerConfig = {
+    /** Service name for span metadata. */
+    readonly serviceName: string;
+    /** Called when a span ends (for export). */
+    readonly onSpanEnd?: (span: Span) => void;
+    /** Sampling rate (0.0 to 1.0). Default: 1.0 (sample everything). */
+    readonly sampleRate?: number;
+};
+type Tracer = {
+    /** Wrap an effect in a span. */
+    readonly span: <R, E, A>(name: string, effect: Async<R, E, A>, attributes?: Record<string, string | number | boolean>) => Async<R, E, A>;
+    /** Get all completed spans (for testing). */
+    readonly spans: () => readonly Span[];
+    /** Clear collected spans. */
+    readonly clear: () => void;
+};
+/**
+ * Creates a tracer that wraps effects in spans.
+ *
+ * ```ts
+ * const tracer = makeTracer({ serviceName: "my-app" });
+ *
+ * const result = await run(
+ *   tracer.span("fetchUser", fetchUser(id), { userId: id })
+ * );
+ *
+ * console.log(tracer.spans()); // all completed spans
+ * ```
+ */
+declare function makeTracer(config: TracerConfig): Tracer;
+
+export { type CircuitBreaker as C, type Span as S, type Tracer as T, type CircuitBreakerConfig as a, type CircuitBreakerError as b, type CircuitBreakerState as c, type CircuitBreakerStats as d, type SpanContext as e, type SpanEvent as f, type SpanStatus as g, type TracerConfig as h, makeTracer as i, makeCircuitBreaker as m };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brass-runtime",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "Effect runtime utilities for TypeScript",
   "license": "MIT",
   "author": "Augusto Vivaldelli",
@@ -18,6 +18,11 @@
       "import": "./dist/http/index.mjs",
       "require": "./dist/http/index.cjs"
     },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.mjs",
+      "require": "./dist/core/index.cjs"
+    },
     "./agent": {
       "types": "./dist/agent/index.d.ts",
       "import": "./dist/agent/index.mjs",
@@ -55,7 +60,9 @@
     "clean": "rimraf dist wasm/pkg",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
+    "test:coverage": "COVERAGE_GATE=baseline vitest run --coverage",
+    "test:coverage:report": "COVERAGE_GATE=off vitest run --coverage",
+    "test:coverage:100": "COVERAGE_GATE=100 vitest run --coverage",
     "test:types": "tsc -p tsconfig.json --noEmit",
     "check": "npm run test:types && npm run test && npm run test:coverage",
     "check:full": "npm run clean && npm run build && npm run test",
@@ -84,7 +91,8 @@
     "agent:vscode:reinstall:global": "npm run agent:vscode:uninstall:global && npm run agent:vscode:install:global",
     "benchmark": "tsx src/benchmarks/runner.ts",
     "benchmark:json": "tsx src/benchmarks/runner.ts --json",
-    "test:coverage:html": "vitest run --coverage --reporter=default",
+    "context": "node scripts/context-pack.mjs",
+    "test:coverage:html": "COVERAGE_GATE=off vitest run --coverage --reporter=default",
     "build:wasm": "cd crates/brass-runtime-wasm-engine && wasm-pack build --target nodejs --out-dir ../../wasm/pkg",
     "build:ts": "tsup",
     "validate:cjs": "node scripts/validate-cjs.mjs"