reactor-effect-client 0.7.1 → 0.8.0

package/dist/orchestration/references.js

@@ -1,79 +0,0 @@
-import * as Effect from "effect/Effect";
-import * as FileSystem from "effect/FileSystem";
-import * as Path from "effect/Path";
-import * as Schema from "effect/Schema";
-import * as Http from "effect/unstable/http/HttpClient";
-import * as Result from "effect/Result";
-import { duration } from "../duration.js";
-import { parse, ReactorError } from "../errors.js";
-import { collectBytes } from "../bytes.js";
-import { readFileBytes } from "../session/files.js";
-const failure = (message, detail) => ReactorError.fromCode("Upload", message, {
-    operation: "load reference",
-    outcome: "not-submitted",
-    ...(detail === undefined ? {} : { detail }),
-});
-const load = (uri, maxBytes) => Effect.gen(function* () {
-    if (uri.startsWith("data:")) {
-        const comma = uri.indexOf(",");
-        if (comma < 0 || !uri.slice(0, comma).endsWith(";base64"))
-            return yield* failure("Only base64 data URIs are supported");
-        const encoded = uri.slice(comma + 1);
-        if (encoded.length > 4 * Math.ceil(maxBytes / 3))
-            return yield* failure("Reference exceeds the byte bound");
-        const result = Schema.decodeResult(Schema.Uint8ArrayFromBase64)(encoded);
-        if (result._tag === "Failure")
-            return yield* failure("Invalid base64 reference", result.failure);
-        if (result.success.byteLength > maxBytes)
-            return yield* failure("Reference exceeds the byte bound");
-        return result.success;
-    }
-    if (uri.startsWith("/") || uri.startsWith("file://")) {
-        const path = uri.startsWith("/")
-            ? uri
-            : yield* Effect.gen(function* () {
-                const url = yield* Effect.try({
-                    try: () => new URL(uri),
-                    catch: (cause) => failure("Invalid file URI", cause),
-                });
-                return yield* (yield* Path.Path)
-                    .fromFileUrl(url)
-                    .pipe(Effect.mapError((cause) => failure("Invalid file URI", cause)));
-            });
-        return yield* readFileBytes(path, maxBytes).pipe(Effect.mapError((cause) => ReactorError.is(cause) ? cause : failure("Reference file could not be read", cause)));
-    }
-    if (uri.startsWith("http://") || uri.startsWith("https://")) {
-        const http = Http.withScope(yield* Http.HttpClient);
-        return yield* Effect.scoped(Effect.gen(function* () {
-            const response = yield* http
-                .get(uri)
-                .pipe(Effect.mapError((cause) => failure("Reference download failed", cause)));
-            if (response.status < 200 || response.status >= 300)
-                return yield* failure(`Reference download returned HTTP ${response.status}`);
-            const declared = Number(response.headers["content-length"] ?? "0");
-            if (Number.isFinite(declared) && declared > maxBytes)
-                return yield* failure("Reference exceeds the byte bound");
-            return yield* collectBytes(response.stream, maxBytes).pipe(Effect.mapError((cause) => ReactorError.is(cause) ? cause : failure("Reference download failed", cause)));
-        }));
-    }
-    return yield* failure("Unsupported reference URI scheme");
-});
-/**
- * Every call rereads the URI. The H3 provider deduplicates subsequent uploads by
- * the bytes' hash; a URI cache cannot establish that mutable content is unchanged.
- * This loader works independently of any live provider session.
- */
-export const loadReferenceBytes = (uri, limits) => Effect.gen(function* () {
-    const timeout = parse(() => duration(limits.loadTimeout, "reference load timeout"));
-    if (typeof uri !== "string" ||
-        !Number.isSafeInteger(limits.maxBytes) ||
-        limits.maxBytes <= 0 ||
-        Result.isFailure(timeout)) {
-        return yield* failure("Reference URI and positive finite loading bounds are required");
-    }
-    return yield* load(uri, limits.maxBytes).pipe(Effect.timeoutOrElse({
-        duration: timeout.success,
-        orElse: () => Effect.fail(failure("Reference loading timed out")),
-    }));
-});
-//# sourceMappingURL=references.js.map

package/dist/orchestration/references.js.map

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

package/dist/orchestration/renewal-state.d.ts

@@ -1,84 +0,0 @@
-import type { ClipId } from "./request.js";
-import type { Renewal } from "./types.js";
-/** Pure renewal policy. Inputs are observations, never resource handles or effects. */
-export type RecoveryMode = "reconnect" | "replace";
-export type SourcePhase = {
-    readonly _tag: "Active";
-} | {
-    readonly _tag: "Recovering";
-    readonly mode: RecoveryMode;
-} | {
-    readonly _tag: "Closing";
-} | {
-    readonly _tag: "Closed";
-};
-export type SourceTransition = {
-    readonly _tag: "Recover";
-    readonly mode: RecoveryMode;
-} | {
-    readonly _tag: "Recovered";
-} | {
-    readonly _tag: "Close";
-} | {
-    readonly _tag: "Closed";
-};
-/** Recovery can escalate, but neither a late completion nor another error can reopen a source. */
-export declare const transitionSource: (phase: SourcePhase, event: SourceTransition) => SourcePhase;
-export declare const isClosed: (phase: SourcePhase) => boolean;
-export interface Lifetime {
-    /** When the source opened, in monotonic milliseconds, so wall-clock corrections cannot age it. */
-    readonly openedAt: number;
-    readonly maxSeconds: number;
-}
-export declare const ageMillis: (source: Lifetime, now: number) => number;
-export declare const expired: (source: Lifetime, now: number) => boolean;
-/** Recovery shares the remote lifetime; post-lease accounting has a separate cleanup budget. */
-export declare const recoveryBudget: (source: Lifetime, now: number, timeoutMs: number) => number;
-export interface RenewalFacts {
-    readonly running: boolean;
-    /** Monotonic milliseconds, as `Lifetime.openedAt` and `retryAt` are. */
-    readonly now: number;
-    readonly current: (Lifetime & {
-        readonly phase: SourcePhase;
-    }) | undefined;
-    readonly replacement: "Absent" | "Opening" | SourcePhase;
-    readonly leadSeconds: number;
-    readonly retryAt: number;
-}
-export type RenewalDecision = "Retain" | "Prepare" | "InspectHandoff" | "Expire";
-/** Expiry is checked before sequence, queue, or media readiness can delay retirement. */
-export declare const decideRenewal: (facts: RenewalFacts) => RenewalDecision;
-/** The retiring source's last started clip, as its owner has observed it. */
-export interface FinalClip {
-    readonly video: "not-started" | "count-complete" | "incomplete";
-    readonly clipId: ClipId | undefined;
-    readonly expectedVideoFrames: number;
-    readonly receivedVideoFrames: number;
-    /** Monotonic milliseconds since Ended or the idle fallback; undefined while it plays. */
-    readonly endedAgoMs: number | undefined;
-    readonly graceOrigin: "Ended" | "Idle" | undefined;
-}
-export interface HandoffFacts {
-    readonly sequenceOpen: boolean;
-    readonly currentIdle: boolean;
-    readonly replacementReady: boolean;
-    readonly finalClip: FinalClip;
-    readonly graceMs: number;
-}
-/**
- * Media and provider events arrive on separate readers, so a clip's last frames
- * can land after its Ended. A frame the provider never sent never lands, so a
- * short clip is waited on only for the grace past Ended; waiting for the count
- * instead left the retiring source idle until expiry. The shortfall is still
- * reported, with any earlier loss, on the retirement's tail.
- */
-export declare const finalClipSettled: (clip: Pick<FinalClip, "video" | "endedAgoMs">, graceMs: number) => boolean;
-type Handoff = NonNullable<Extract<Renewal, {
-    readonly _tag: "Switched";
-}>["handoff"]>;
-/** One decision owns both admission and evidence, so the two cannot disagree at a grace boundary. */
-export declare const handoffEvidence: (facts: HandoffFacts) => Omit<Handoff, "replacementSessionId"> | undefined;
-export declare const canHandoff: (facts: HandoffFacts) => boolean;
-export declare const needsReplacement: (phase: SourcePhase, indeterminate: boolean, isExpired: boolean) => boolean;
-export {};
-//# sourceMappingURL=renewal-state.d.ts.map

package/dist/orchestration/renewal-state.d.ts.map

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

package/dist/orchestration/renewal-state.js

@@ -1,95 +0,0 @@
-/** Recovery can escalate, but neither a late completion nor another error can reopen a source. */
-export const transitionSource = (phase, event) => {
-    switch (phase._tag) {
-        case "Closed":
-            return phase;
-        case "Closing":
-            return event._tag === "Closed" ? { _tag: "Closed" } : phase;
-        case "Active":
-            switch (event._tag) {
-                case "Recover":
-                    return { _tag: "Recovering", mode: event.mode };
-                case "Close":
-                    return { _tag: "Closing" };
-                default:
-                    return phase;
-            }
-        case "Recovering":
-            switch (event._tag) {
-                case "Recover":
-                    return event.mode === "replace" ? { _tag: "Recovering", mode: "replace" } : phase;
-                case "Recovered":
-                    return phase.mode === "reconnect" ? { _tag: "Active" } : phase;
-                case "Close":
-                    return { _tag: "Closing" };
-                default:
-                    return phase;
-            }
-    }
-};
-export const isClosed = (phase) => phase._tag === "Closing" || phase._tag === "Closed";
-export const ageMillis = (source, now) => now - source.openedAt;
-export const expired = (source, now) => ageMillis(source, now) >= source.maxSeconds * 1000;
-/** Recovery shares the remote lifetime; post-lease accounting has a separate cleanup budget. */
-export const recoveryBudget = (source, now, timeoutMs) => Math.min(timeoutMs, Math.max(1, source.maxSeconds * 1000 - ageMillis(source, now)));
-/** Expiry is checked before sequence, queue, or media readiness can delay retirement. */
-export const decideRenewal = (facts) => {
-    const current = facts.current;
-    if (!facts.running || current?.phase._tag !== "Active")
-        return "Retain";
-    if (expired(current, facts.now))
-        return "Expire";
-    if (facts.replacement === "Absent") {
-        return ageMillis(current, facts.now) >= (current.maxSeconds - facts.leadSeconds) * 1000 &&
-            facts.now >= facts.retryAt
-            ? "Prepare"
-            : "Retain";
-    }
-    return facts.replacement !== "Opening" && facts.replacement._tag === "Active"
-        ? "InspectHandoff"
-        : "Retain";
-};
-/**
- * Media and provider events arrive on separate readers, so a clip's last frames
- * can land after its Ended. A frame the provider never sent never lands, so a
- * short clip is waited on only for the grace past Ended; waiting for the count
- * instead left the retiring source idle until expiry. The shortfall is still
- * reported, with any earlier loss, on the retirement's tail.
- */
-export const finalClipSettled = (clip, graceMs) => clip.video !== "incomplete" || (clip.endedAgoMs !== undefined && clip.endedAgoMs >= graceMs);
-/** One decision owns both admission and evidence, so the two cannot disagree at a grace boundary. */
-export const handoffEvidence = (facts) => {
-    if (facts.sequenceOpen ||
-        !facts.currentIdle ||
-        !facts.replacementReady ||
-        !finalClipSettled(facts.finalClip, facts.graceMs))
-        return undefined;
-    const clip = facts.finalClip;
-    return Object.freeze({
-        decision: clip.clipId === undefined
-            ? "no-observed-start"
-            : clip.video === "incomplete"
-                ? "grace-elapsed"
-                : "count-complete",
-        finalClip: clip.clipId === undefined
-            ? Object.freeze({ _tag: "NoObservedStart" })
-            : Object.freeze({
-                _tag: "Observed",
-                clipId: clip.clipId,
-                expectedVideoFrames: clip.expectedVideoFrames,
-                receivedVideoFrames: clip.receivedVideoFrames,
-                videoStatus: clip.video === "incomplete" ? "incomplete" : "count-complete",
-            }),
-        grace: clip.endedAgoMs === undefined || clip.graceOrigin === undefined
-            ? Object.freeze({ _tag: "NotObserved" })
-            : Object.freeze({
-                _tag: "Observed",
-                origin: clip.graceOrigin,
-                elapsedMs: clip.endedAgoMs,
-                limitMs: facts.graceMs,
-            }),
-    });
-};
-export const canHandoff = (facts) => handoffEvidence(facts) !== undefined;
-export const needsReplacement = (phase, indeterminate, isExpired) => indeterminate || isExpired || (phase._tag === "Recovering" && phase.mode === "replace");
-//# sourceMappingURL=renewal-state.js.map

package/dist/orchestration/renewal-state.js.map

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

package/dist/orchestration/renewal.d.ts

@@ -1,103 +0,0 @@
-import * as Crypto from "effect/Crypto";
-import * as Duration from "effect/Duration";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as Scope from "effect/Scope";
-import { AcquisitionFailure, ReactorError } from "../errors.js";
-import type { ContinuousHandleShape, HandleShape, Renewal, Source } from "./types.js";
-import type { Engine, Handle, Media } from "./types.js";
-export type { MediaTail, Renewal } from "./types.js";
-/** An opened source and how long its remote session may live. */
-export interface Opened {
-    readonly source: Source;
-    /**
-     * The source's remote session lifetime, positive, or `"Infinity"` for a
-     * source that never expires. A bare number is milliseconds, so build it with
-     * a unit from a grant in seconds: `` `${seconds} seconds` ``.
-     */
-    readonly lifetime: Duration.Input;
-}
-export interface Options<R = never> {
-    readonly open: Effect.Effect<Opened, ReactorError | AcquisitionFailure, Scope.Scope | R>;
-    /**
-     * How long before a source's lifetime ends to prepare its replacement; 30
-     * seconds by default, and zero prepares at expiry. A bare number is
-     * milliseconds, so `lead: 30` is 30 milliseconds.
-     */
-    readonly lead?: Duration.Input | undefined;
-    /**
-     * How long recovering a source's connection may take, and the local cleanup
-     * budget of a retired source; 10 seconds by default. A bare number is
-     * milliseconds.
-     */
-    readonly reconnectTimeout?: Duration.Input | undefined;
-    readonly maxSessions?: number;
-    /**
-     * How long past the retiring source's final clip a planned switch waits for
-     * that clip's missing video frames; 250 milliseconds by default. Frames can
-     * land after the clip's Ended, but one the provider never sent never does,
-     * so the switch then proceeds and `Switched.tail` reports the shortfall. The
-     * grace also starts when the source reports nothing playing, in case Ended
-     * was lost. At most 5 seconds, since the retiring source running dry within
-     * it is not reported as `Starved`. Renewal checks every 100 milliseconds, so
-     * the switch can come up to one check after the grace. A bare number is
-     * milliseconds.
-     */
-    readonly handoffGrace?: Duration.Input | undefined;
-    /**
-     * The video frames the media output keeps for a reader that has not taken
-     * them, 96 by default (4 seconds at 24 fps). Past it the orchestration fails
-     * with `Overflow`.
-     */
-    readonly maxQueuedVideoFrames?: number;
-    /**
-     * The interleaved audio samples the media output keeps for a reader that has
-     * not taken them, 192,000 by default (4 seconds at 48 kHz). Past it the
-     * orchestration fails with `Overflow`.
-     */
-    readonly maxQueuedAudioSamples?: number;
-    /**
-     * Runs for each renewal event, in order, on a reader the handle forks: it
-     * never holds the handle's command permit, so a slow observer delays no
-     * enqueue or control. A failure is logged and the next event still runs.
-     * Events that queue past 4096 end the reader with an `Overflow` warning; use
-     * `observe` to read renewals together with the engine events they follow.
-     */
-    readonly onRenewal?: (event: Renewal) => Effect.Effect<void>;
-}
-/**
- * Each open must supply a globally unique physical source ID; clip IDs must
- * never be reassigned during this handle's lifetime. Continuous mode checks live
- * collisions, but cannot detect historical reuse after eviction with bounded memory.
- * Source/clip IDs are limited to 1024 UTF-16 code units; each source admits at most
- * 4096 accepted IDs and 4096 distinct Started IDs. Sequence history still requires
- * explicit acknowledgement/release and keeps its independent bounds.
- */
-export interface ContinuousOptions<R = never> extends Options<R> {
-    /** Supply globally unique source IDs and never reassign clip IDs; historical reuse cannot be checked after eviction. */
-    readonly open: Options<R>["open"];
-    /** No cumulative successful-open cap when omitted; explicit values retain legacy semantics. */
-    readonly maxSessions?: number;
-    /** Newest complete cleanup details retained, 0..4096; defaults to 64. */
-    readonly retainedSuccessfulCleanups?: number;
-    /**
-     * Incomplete cleanup or unknown-submission records plus outstanding reservations,
-     * 2..4096; defaults to 16. Unknown outcomes can exhaust it despite confirmed termination.
-     */
-    readonly maxUnresolvedCleanups?: number;
-}
-/** Legacy renewal retains complete cleanup history and defaults to 64 successful opens. */
-export declare const make: <R>(options: Options<R>) => Effect.Effect<HandleShape, ReactorError | AcquisitionFailure, Scope.Scope | Crypto.Crypto | R>;
-/**
- * Bounded continuous renewal. Adapters must meet ContinuousOptions' unique-ID
- * precondition. Retired anchors no longer retained can refuse as missing rather
- * than SessionRetired; captured operations remain fenced to their exact incarnation.
- */
-export declare const makeContinuous: <R>(options: ContinuousOptions<R>) => Effect.Effect<ContinuousHandleShape, ReactorError | AcquisitionFailure, Scope.Scope | Crypto.Crypto | R>;
-/**
- * The handle's `Engine`, `Media` and `Handle` services from one orchestration,
- * so the three can never come from two paid session chains. Each build of the
- * layer opens its own chain: bind it to a `const` and provide that one value.
- */
-export declare const layer: <R>(options: Options<R>) => Layer.Layer<Engine | Media | Handle, ReactorError | AcquisitionFailure, Crypto.Crypto | Exclude<R, Scope.Scope>>;
-//# sourceMappingURL=renewal.d.ts.map

package/dist/orchestration/renewal.d.ts.map

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