reactor-effect-client 0.0.0-reserved.0 → 0.2.0

package/dist/orchestration/references.js

@@ -0,0 +1,76 @@
+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 { ReactorError } from "../errors.js";
+import { collectBytes } from "../bytes.js";
+import { readFileBytes } from "../session/files.js";
+const failure = (message, detail) => new ReactorError("Upload", message, {
+    operation: "load reference",
+    outcome: "not-submitted",
+    ...(detail === undefined ? {} : { detail }),
+});
+/**
+ * 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* () {
+    if (typeof uri !== "string" ||
+        !Number.isSafeInteger(limits.maxBytes) ||
+        limits.maxBytes <= 0 ||
+        !Number.isFinite(limits.timeoutMs) ||
+        limits.timeoutMs <= 0) {
+        return yield* Effect.fail(failure("Reference URI and positive finite loading bounds are required"));
+    }
+    if (uri.startsWith("data:")) {
+        const comma = uri.indexOf(",");
+        if (comma < 0 || !uri.slice(0, comma).endsWith(";base64"))
+            return yield* Effect.fail(failure("Only base64 data URIs are supported"));
+        const encoded = uri.slice(comma + 1);
+        if (encoded.length > 4 * Math.ceil(limits.maxBytes / 3))
+            return yield* Effect.fail(failure("Reference exceeds the byte bound"));
+        const result = Schema.decodeUnknownResult(Schema.Uint8ArrayFromBase64)(encoded);
+        if (result._tag === "Failure")
+            return yield* Effect.fail(failure("Invalid base64 reference", result.failure));
+        if (result.success.byteLength > limits.maxBytes)
+            return yield* Effect.fail(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, limits.maxBytes).pipe(Effect.mapError((cause) => cause instanceof ReactorError
+            ? 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* Effect.fail(failure(`Reference download returned HTTP ${response.status}`));
+            const declared = Number(response.headers["content-length"] ?? "0");
+            if (Number.isFinite(declared) && declared > limits.maxBytes)
+                return yield* Effect.fail(failure("Reference exceeds the byte bound"));
+            return yield* collectBytes(response.stream, limits.maxBytes).pipe(Effect.mapError((cause) => cause instanceof ReactorError ? cause : failure("Reference download failed", cause)));
+        }));
+    }
+    return yield* Effect.fail(failure("Unsupported reference URI scheme"));
+}).pipe(Effect.timeoutOrElse({
+    duration: limits.timeoutMs,
+    orElse: () => Effect.fail(failure("Reference loading timed out")),
+}));
+//# sourceMappingURL=references.js.map

package/dist/orchestration/references.js.map

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

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

@@ -0,0 +1,58 @@
+/** 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 {
+    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;
+    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;
+export interface HandoffFacts {
+    readonly sequenceOpen: boolean;
+    readonly currentIdle: boolean;
+    readonly replacementReady: boolean;
+    readonly video: "not-started" | "count-complete" | "incomplete";
+    readonly droppedVideo: bigint | null;
+    readonly droppedAudio: bigint | null;
+}
+/** Unknown pressure never establishes a clean handoff. Queued output remains caller-owned. */
+export declare const canHandoff: (facts: HandoffFacts) => boolean;
+export declare const needsReplacement: (phase: SourcePhase, indeterminate: boolean, isExpired: boolean) => boolean;
+//# sourceMappingURL=renewal-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renewal-state.d.ts","sourceRoot":"","sources":["../../src/orchestration/renewal-state.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC;AAEnD,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC5D;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEhC,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEhC,kGAAkG;AAClG,eAAO,MAAM,gBAAgB,UAAW,WAAW,SAAS,gBAAgB,KAAG,WA2B9E,CAAC;AAEF,eAAO,MAAM,QAAQ,UAAW,WAAW,KAAG,OACO,CAAC;AAEtD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,SAAS,WAAY,QAAQ,OAAO,MAAM,KAAG,MAA+B,CAAC;AAC1F,eAAO,MAAM,OAAO,WAAY,QAAQ,OAAO,MAAM,KAAG,OACJ,CAAC;AAErD,gGAAgG;AAChG,eAAO,MAAM,cAAc,WAAY,QAAQ,OAAO,MAAM,aAAa,MAAM,KAAG,MACG,CAAC;AAEtF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IAC3E,QAAQ,CAAC,WAAW,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAEjF,yFAAyF;AACzF,eAAO,MAAM,aAAa,UAAW,YAAY,KAAG,eAanD,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,GAAG,YAAY,CAAC;IAChE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,8FAA8F;AAC9F,eAAO,MAAM,UAAU,UAAW,YAAY,KAAG,OAMtB,CAAC;AAE5B,eAAO,MAAM,gBAAgB,UACpB,WAAW,iBACH,OAAO,aACX,OAAO,KACjB,OACsF,CAAC"}

package/dist/orchestration/renewal-state.js

@@ -0,0 +1,60 @@
+/** 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 === undefined || 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";
+};
+/** Unknown pressure never establishes a clean handoff. Queued output remains caller-owned. */
+export const canHandoff = (facts) => !facts.sequenceOpen &&
+    facts.currentIdle &&
+    facts.replacementReady &&
+    facts.video !== "incomplete" &&
+    facts.droppedVideo === 0n &&
+    facts.droppedAudio === 0n;
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,76 @@
+import * as Crypto from "effect/Crypto";
+import * as Effect from "effect/Effect";
+import * as Scope from "effect/Scope";
+import { ReactorError } from "../errors.js";
+import type { HandleShape, Source } from "./types.js";
+export interface Options<R = never> {
+    readonly open: Effect.Effect<{
+        readonly source: Source;
+        readonly maxSeconds: number;
+    }, unknown, Scope.Scope | R>;
+    readonly leadSeconds?: number;
+    readonly reconnectTimeoutMs?: number;
+    readonly maxSessions?: number;
+    readonly log?: (message: string) => void;
+    readonly onRenewal?: (event: Renewal) => Effect.Effect<void>;
+}
+export interface MediaTail {
+    readonly video: {
+        readonly framesPerSecond: number;
+        readonly expectedFrames: number;
+        readonly receivedFrames: number;
+        readonly status: "not-started" | "count-complete" | "incomplete";
+    };
+    readonly audio: {
+        readonly receivedSamples: number;
+        readonly status: "unverified";
+    };
+    readonly sourceDrops: {
+        readonly video: bigint | null;
+        readonly audio: bigint | null;
+    };
+    readonly forwarded: {
+        readonly queuedVideoFrames: number;
+        readonly queuedAudioSamples: number;
+    };
+}
+export type Renewal = {
+    readonly _tag: "Opened";
+    readonly sessionId: string;
+    readonly maxSeconds: number;
+} | {
+    readonly _tag: "Prepared";
+} | {
+    readonly _tag: "SetupFailed";
+    readonly reason: string;
+    readonly consecutive: number;
+} | {
+    readonly _tag: "Recovering";
+    readonly sessionId: string;
+    readonly reason: string;
+} | {
+    readonly _tag: "Reconnected";
+    readonly sessionId: string;
+    readonly generation: bigint;
+} | {
+    readonly _tag: "Switched";
+    readonly sessionId: string;
+    readonly ageSeconds: number;
+    readonly tail: MediaTail;
+} | {
+    readonly _tag: "Replaced";
+    readonly reason: string;
+    readonly lostClips: number;
+    readonly sessionId: string;
+    readonly ageSeconds: number;
+    readonly tail: MediaTail;
+} | {
+    readonly _tag: "Failed";
+    readonly reason: string;
+};
+/**
+ * Explicit application policy for renewal, sequence affinity and continuous
+ * recovering media. A physical source still owns each connection generation.
+ */
+export declare const make: <R>(options: Options<R>) => Effect.Effect<HandleShape, ReactorError, Scope.Scope | Crypto.Crypto | R>;
+//# sourceMappingURL=renewal.d.ts.map

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

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