@moqtap/codec 0.2.0 → 0.2.2

package/dist/drafts/draft12/session-fsm.d.ts

@@ -0,0 +1,55 @@
+import type { AnnounceState, FetchState, SessionPhase, SubscriptionState, TransitionResult, ValidationResult } from "../../core/session-types.js";
+import type { Draft12Message, Draft12MessageType } from "./types.js";
+export declare class Draft12SessionFSM {
+    private _phase;
+    private _role;
+    private _subscriptions;
+    private _announces;
+    private _fetches;
+    private _requestIds;
+    constructor(role: "client" | "server");
+    get phase(): SessionPhase;
+    get role(): "client" | "server";
+    get subscriptions(): ReadonlyMap<bigint, SubscriptionState>;
+    get announces(): ReadonlyMap<string, AnnounceState>;
+    get fetches(): ReadonlyMap<bigint, FetchState>;
+    get legalOutgoing(): ReadonlySet<Draft12MessageType>;
+    get legalIncoming(): ReadonlySet<Draft12MessageType>;
+    private checkRole;
+    private checkDuplicateRequestId;
+    private checkKnownRequestId;
+    validateOutgoing(message: Draft12Message): ValidationResult<Draft12MessageType>;
+    receive(message: Draft12Message): TransitionResult<Draft12MessageType>;
+    send(message: Draft12Message): TransitionResult<Draft12MessageType>;
+    private applyTransition;
+    private handleClientSetup;
+    private handleServerSetup;
+    private handleGoAway;
+    private requireReady;
+    private handleSubscribe;
+    private handleSubscribeOk;
+    private handleSubscribeError;
+    private handleSubscribeUpdate;
+    private handleSubscribeDone;
+    private handleUnsubscribe;
+    private handleAnnounce;
+    private handleAnnounceOk;
+    private handleAnnounceError;
+    private handleUnannounce;
+    private handleAnnounceCancel;
+    private handlePublish;
+    private handlePublishOk;
+    private handlePublishError;
+    private handleFetch;
+    private handleFetchOk;
+    private handleFetchError;
+    private handleFetchCancel;
+    private handleSubscribeAnnounces;
+    private handleSubscribeAnnouncesOk;
+    private handleSubscribeAnnouncesError;
+    private handleTrackStatusRequest;
+    private handleTrackStatusResponse;
+    private handleReadyPhaseMessage;
+    reset(): void;
+}
+//# sourceMappingURL=session-fsm.d.ts.map

package/dist/drafts/draft12/session-fsm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-fsm.d.ts","sourceRoot":"","sources":["../../../src/drafts/draft12/session-fsm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EAEV,YAAY,EAEZ,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAOrC,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAWrE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,cAAc,CAAwC;IAC9D,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,WAAW,CAAqB;gBAE5B,IAAI,EAAE,QAAQ,GAAG,QAAQ;IAIrC,IAAI,KAAK,IAAI,YAAY,CAExB;IACD,IAAI,IAAI,IAAI,QAAQ,GAAG,QAAQ,CAE9B;IACD,IAAI,aAAa,IAAI,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAE1D;IACD,IAAI,SAAS,IAAI,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAElD;IACD,IAAI,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAE7C;IAED,IAAI,aAAa,IAAI,WAAW,CAAC,kBAAkB,CAAC,CAEnD;IAED,IAAI,aAAa,IAAI,WAAW,CAAC,kBAAkB,CAAC,CAEnD;IAED,OAAO,CAAC,SAAS;IA0BjB,OAAO,CAAC,uBAAuB;IAe/B,OAAO,CAAC,mBAAmB;IAe3B,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB,CAAC,kBAAkB,CAAC;IAoB/E,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB,CAAC,kBAAkB,CAAC;IAMtE,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB,CAAC,kBAAkB,CAAC;IAMnE,OAAO,CAAC,eAAe;IA8EvB,OAAO,CAAC,iBAAiB;IA6BzB,OAAO,CAAC,iBAAiB;IA6BzB,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,iBAAiB;IAmCzB,OAAO,CAAC,oBAAoB;IAuC5B,OAAO,CAAC,qBAAqB;IAiC7B,OAAO,CAAC,mBAAmB;IA6B3B,OAAO,CAAC,iBAAiB;IA+BzB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,aAAa;IAmCrB,OAAO,CAAC,gBAAgB;IA6BxB,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,wBAAwB;IAahC,OAAO,CAAC,0BAA0B;IAYlC,OAAO,CAAC,6BAA6B;IAcrC,OAAO,CAAC,wBAAwB;IAahC,OAAO,CAAC,yBAAyB;IAcjC,OAAO,CAAC,uBAAuB;IAM/B,KAAK,IAAI,IAAI;CAOd"}

package/dist/drafts/draft12/session-fsm.js

@@ -0,0 +1,569 @@
+import { CLIENT_ONLY_MESSAGES, getLegalIncoming, getLegalOutgoing, SERVER_ONLY_MESSAGES, } from "./rules.js";
+function violation(code, message, currentPhase, offendingMessage) {
+    return { code, message, currentPhase, offendingMessage };
+}
+export class Draft12SessionFSM {
+    _phase = "idle";
+    _role;
+    _subscriptions = new Map();
+    _announces = new Map();
+    _fetches = new Map();
+    _requestIds = new Set();
+    constructor(role) {
+        this._role = role;
+    }
+    get phase() {
+        return this._phase;
+    }
+    get role() {
+        return this._role;
+    }
+    get subscriptions() {
+        return this._subscriptions;
+    }
+    get announces() {
+        return this._announces;
+    }
+    get fetches() {
+        return this._fetches;
+    }
+    get legalOutgoing() {
+        return getLegalOutgoing(this._phase, this._role);
+    }
+    get legalIncoming() {
+        return getLegalIncoming(this._phase, this._role);
+    }
+    checkRole(message, direction) {
+        const senderRole = direction === "outbound" ? this._role : this._role === "client" ? "server" : "client";
+        if (CLIENT_ONLY_MESSAGES.has(message.type) && senderRole !== "client") {
+            return violation("ROLE_VIOLATION", `${message.type} can only be sent by client`, this._phase, message.type);
+        }
+        if (SERVER_ONLY_MESSAGES.has(message.type) && senderRole !== "server") {
+            return violation("ROLE_VIOLATION", `${message.type} can only be sent by server`, this._phase, message.type);
+        }
+        return null;
+    }
+    checkDuplicateRequestId(requestId, msgType) {
+        if (this._requestIds.has(requestId)) {
+            return violation("DUPLICATE_REQUEST_ID", `Request ID ${requestId} already in use`, this._phase, msgType);
+        }
+        return null;
+    }
+    checkKnownRequestId(requestId, msgType) {
+        if (!this._requestIds.has(requestId)) {
+            return violation("UNKNOWN_REQUEST_ID", `No request with ID ${requestId}`, this._phase, msgType);
+        }
+        return null;
+    }
+    validateOutgoing(message) {
+        const roleViolation = this.checkRole(message, "outbound");
+        if (roleViolation)
+            return { ok: false, violation: roleViolation };
+        if (!this.legalOutgoing.has(message.type)) {
+            return {
+                ok: false,
+                violation: violation(this._phase === "idle" || this._phase === "setup"
+                    ? "MESSAGE_BEFORE_SETUP"
+                    : "UNEXPECTED_MESSAGE", `Cannot send ${message.type} in phase ${this._phase}`, this._phase, message.type),
+            };
+        }
+        return { ok: true };
+    }
+    receive(message) {
+        const roleViolation = this.checkRole(message, "inbound");
+        if (roleViolation)
+            return { ok: false, violation: roleViolation };
+        return this.applyTransition(message, "inbound");
+    }
+    send(message) {
+        const roleViolation = this.checkRole(message, "outbound");
+        if (roleViolation)
+            return { ok: false, violation: roleViolation };
+        return this.applyTransition(message, "outbound");
+    }
+    applyTransition(message, direction) {
+        const sideEffects = [];
+        switch (message.type) {
+            case "client_setup":
+                return this.handleClientSetup(direction);
+            case "server_setup":
+                return this.handleServerSetup(direction);
+            case "goaway":
+                return this.handleGoAway(message, sideEffects);
+            // Subscribe lifecycle
+            case "subscribe":
+                return this.handleSubscribe(message, sideEffects);
+            case "subscribe_ok":
+                return this.handleSubscribeOk(message, sideEffects);
+            case "subscribe_error":
+                return this.handleSubscribeError(message, sideEffects);
+            case "subscribe_update":
+                return this.handleSubscribeUpdate(message, sideEffects);
+            case "subscribe_done":
+                return this.handleSubscribeDone(message, sideEffects);
+            case "unsubscribe":
+                return this.handleUnsubscribe(message, sideEffects);
+            // Announce lifecycle
+            case "announce":
+                return this.handleAnnounce(message, sideEffects);
+            case "announce_ok":
+                return this.handleAnnounceOk(message, sideEffects);
+            case "announce_error":
+                return this.handleAnnounceError(message, sideEffects);
+            case "unannounce":
+                return this.handleUnannounce(message, sideEffects);
+            case "announce_cancel":
+                return this.handleAnnounceCancel(message, sideEffects);
+            // Publish lifecycle
+            case "publish":
+                return this.handlePublish(message, sideEffects);
+            case "publish_ok":
+                return this.handlePublishOk(message, sideEffects);
+            case "publish_error":
+                return this.handlePublishError(message, sideEffects);
+            // Fetch lifecycle
+            case "fetch":
+                return this.handleFetch(message, sideEffects);
+            case "fetch_ok":
+                return this.handleFetchOk(message, sideEffects);
+            case "fetch_error":
+                return this.handleFetchError(message, sideEffects);
+            case "fetch_cancel":
+                return this.handleFetchCancel(message, sideEffects);
+            // Subscribe announces lifecycle
+            case "subscribe_announces":
+                return this.handleSubscribeAnnounces(message, sideEffects);
+            case "subscribe_announces_ok":
+                return this.handleSubscribeAnnouncesOk(message, sideEffects);
+            case "subscribe_announces_error":
+                return this.handleSubscribeAnnouncesError(message, sideEffects);
+            // Track status lifecycle
+            case "track_status_request":
+                return this.handleTrackStatusRequest(message, sideEffects);
+            case "track_status":
+                return this.handleTrackStatusResponse(message, sideEffects);
+            // Other ready-phase messages
+            default:
+                return this.handleReadyPhaseMessage(message);
+        }
+    }
+    handleClientSetup(direction) {
+        if (this._phase !== "idle") {
+            return {
+                ok: false,
+                violation: violation("SETUP_VIOLATION", "CLIENT_SETUP already sent/received", this._phase, "client_setup"),
+            };
+        }
+        if (direction === "outbound" && this._role !== "client") {
+            return {
+                ok: false,
+                violation: violation("ROLE_VIOLATION", "Only client can send CLIENT_SETUP", this._phase, "client_setup"),
+            };
+        }
+        this._phase = "setup";
+        return { ok: true, phase: this._phase, sideEffects: [] };
+    }
+    handleServerSetup(direction) {
+        if (this._phase !== "setup") {
+            return {
+                ok: false,
+                violation: violation("SETUP_VIOLATION", "SERVER_SETUP before CLIENT_SETUP", this._phase, "server_setup"),
+            };
+        }
+        if (direction === "outbound" && this._role !== "server") {
+            return {
+                ok: false,
+                violation: violation("ROLE_VIOLATION", "Only server can send SERVER_SETUP", this._phase, "server_setup"),
+            };
+        }
+        this._phase = "ready";
+        return { ok: true, phase: this._phase, sideEffects: [{ type: "session-ready" }] };
+    }
+    handleGoAway(message, sideEffects) {
+        if (this._phase !== "ready" && this._phase !== "draining") {
+            return {
+                ok: false,
+                violation: violation("UNEXPECTED_MESSAGE", `GOAWAY not valid in phase ${this._phase}`, this._phase, "goaway"),
+            };
+        }
+        this._phase = "draining";
+        const goaway = message;
+        sideEffects.push({ type: "session-draining", goAwayUri: goaway.new_session_uri });
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    requireReady(msgType) {
+        if (this._phase !== "ready" && this._phase !== "draining") {
+            return violation(this._phase === "idle" || this._phase === "setup"
+                ? "MESSAGE_BEFORE_SETUP"
+                : "UNEXPECTED_MESSAGE", `${msgType} requires ready phase, current: ${this._phase}`, this._phase, msgType);
+        }
+        return null;
+    }
+    // ─── Subscribe lifecycle ───
+    handleSubscribe(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const sub = message;
+        const dupErr = this.checkDuplicateRequestId(sub.request_id, message.type);
+        if (dupErr)
+            return { ok: false, violation: dupErr };
+        this._requestIds.add(sub.request_id);
+        this._subscriptions.set(sub.request_id, {
+            subscribeId: sub.request_id,
+            phase: "pending",
+            trackNamespace: sub.track_namespace,
+            trackName: sub.track_name,
+        });
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleSubscribeOk(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const ok = message;
+        const idErr = this.checkKnownRequestId(ok.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        const existing = this._subscriptions.get(ok.request_id);
+        if (!existing)
+            return {
+                ok: false,
+                violation: violation("UNKNOWN_REQUEST_ID", `No subscription with request ID ${ok.request_id}`, this._phase, message.type),
+            };
+        if (existing.phase !== "pending")
+            return {
+                ok: false,
+                violation: violation("STATE_VIOLATION", `Subscription ${ok.request_id} is ${existing.phase}, not pending`, this._phase, message.type),
+            };
+        this._subscriptions.set(ok.request_id, { ...existing, phase: "active" });
+        sideEffects.push({ type: "subscription-activated", subscribeId: ok.request_id });
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleSubscribeError(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const subErr = message;
+        const idErr = this.checkKnownRequestId(subErr.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        const existing = this._subscriptions.get(subErr.request_id);
+        if (!existing)
+            return {
+                ok: false,
+                violation: violation("UNKNOWN_REQUEST_ID", `No subscription with request ID ${subErr.request_id}`, this._phase, message.type),
+            };
+        if (existing.phase !== "pending")
+            return {
+                ok: false,
+                violation: violation("STATE_VIOLATION", `Subscription ${subErr.request_id} is ${existing.phase}, not pending`, this._phase, message.type),
+            };
+        this._subscriptions.set(subErr.request_id, { ...existing, phase: "error" });
+        sideEffects.push({
+            type: "subscription-ended",
+            subscribeId: subErr.request_id,
+            reason: subErr.reason_phrase,
+        });
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleSubscribeUpdate(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const update = message;
+        const idErr = this.checkKnownRequestId(update.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        const existing = this._subscriptions.get(update.request_id);
+        if (!existing)
+            return {
+                ok: false,
+                violation: violation("UNKNOWN_REQUEST_ID", `No subscription with request ID ${update.request_id}`, this._phase, message.type),
+            };
+        if (existing.phase !== "active")
+            return {
+                ok: false,
+                violation: violation("STATE_VIOLATION", `Subscription ${update.request_id} is ${existing.phase}, not active`, this._phase, message.type),
+            };
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleSubscribeDone(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const done = message;
+        const idErr = this.checkKnownRequestId(done.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        const existing = this._subscriptions.get(done.request_id);
+        if (!existing)
+            return {
+                ok: false,
+                violation: violation("UNKNOWN_REQUEST_ID", `No subscription with request ID ${done.request_id}`, this._phase, message.type),
+            };
+        this._subscriptions.set(done.request_id, { ...existing, phase: "done" });
+        sideEffects.push({
+            type: "subscription-ended",
+            subscribeId: done.request_id,
+            reason: done.reason_phrase,
+        });
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleUnsubscribe(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const unsub = message;
+        const idErr = this.checkKnownRequestId(unsub.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        const existing = this._subscriptions.get(unsub.request_id);
+        if (!existing)
+            return {
+                ok: false,
+                violation: violation("UNKNOWN_REQUEST_ID", `No subscription with request ID ${unsub.request_id}`, this._phase, message.type),
+            };
+        this._subscriptions.set(unsub.request_id, { ...existing, phase: "done" });
+        sideEffects.push({
+            type: "subscription-ended",
+            subscribeId: unsub.request_id,
+            reason: "unsubscribed",
+        });
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    // ─── Announce lifecycle ───
+    handleAnnounce(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const ann = message;
+        const nsKey = ann.track_namespace.join("/");
+        this._requestIds.add(ann.request_id);
+        this._announces.set(nsKey, { namespace: ann.track_namespace, phase: "pending" });
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleAnnounceOk(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const ok = message;
+        const idErr = this.checkKnownRequestId(ok.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleAnnounceError(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const annErr = message;
+        const idErr = this.checkKnownRequestId(annErr.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleUnannounce(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const unann = message;
+        const nsKey = unann.track_namespace.join("/");
+        const existing = this._announces.get(nsKey);
+        if (existing) {
+            this._announces.delete(nsKey);
+            sideEffects.push({ type: "announce-ended", namespace: unann.track_namespace });
+        }
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleAnnounceCancel(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const cancel = message;
+        const nsKey = cancel.track_namespace.join("/");
+        const existing = this._announces.get(nsKey);
+        if (existing) {
+            this._announces.delete(nsKey);
+            sideEffects.push({ type: "announce-ended", namespace: cancel.track_namespace });
+        }
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    // ─── Publish lifecycle ───
+    handlePublish(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const pub = message;
+        const dupErr = this.checkDuplicateRequestId(pub.request_id, message.type);
+        if (dupErr)
+            return { ok: false, violation: dupErr };
+        this._requestIds.add(pub.request_id);
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handlePublishOk(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const ok = message;
+        const idErr = this.checkKnownRequestId(ok.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handlePublishError(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const pubErr = message;
+        const idErr = this.checkKnownRequestId(pubErr.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    // ─── Fetch lifecycle ───
+    handleFetch(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const fetch = message;
+        const dupErr = this.checkDuplicateRequestId(fetch.request_id, message.type);
+        if (dupErr)
+            return { ok: false, violation: dupErr };
+        this._requestIds.add(fetch.request_id);
+        this._fetches.set(fetch.request_id, { requestId: fetch.request_id, phase: "pending" });
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleFetchOk(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const ok = message;
+        const idErr = this.checkKnownRequestId(ok.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        const existing = this._fetches.get(ok.request_id);
+        if (!existing)
+            return {
+                ok: false,
+                violation: violation("UNKNOWN_REQUEST_ID", `No fetch with request ID ${ok.request_id}`, this._phase, message.type),
+            };
+        if (existing.phase !== "pending")
+            return {
+                ok: false,
+                violation: violation("STATE_VIOLATION", `Fetch ${ok.request_id} is ${existing.phase}, not pending`, this._phase, message.type),
+            };
+        this._fetches.set(ok.request_id, { ...existing, phase: "active" });
+        sideEffects.push({ type: "fetch-activated", requestId: ok.request_id });
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleFetchError(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const fetchErr = message;
+        const idErr = this.checkKnownRequestId(fetchErr.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        const existing = this._fetches.get(fetchErr.request_id);
+        if (!existing)
+            return {
+                ok: false,
+                violation: violation("UNKNOWN_REQUEST_ID", `No fetch with request ID ${fetchErr.request_id}`, this._phase, message.type),
+            };
+        this._fetches.set(fetchErr.request_id, { ...existing, phase: "error" });
+        sideEffects.push({
+            type: "fetch-ended",
+            requestId: fetchErr.request_id,
+            reason: fetchErr.reason_phrase,
+        });
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleFetchCancel(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const cancel = message;
+        const idErr = this.checkKnownRequestId(cancel.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        const existing = this._fetches.get(cancel.request_id);
+        if (!existing)
+            return {
+                ok: false,
+                violation: violation("UNKNOWN_REQUEST_ID", `No fetch with request ID ${cancel.request_id}`, this._phase, message.type),
+            };
+        this._fetches.set(cancel.request_id, { ...existing, phase: "cancelled" });
+        sideEffects.push({ type: "fetch-ended", requestId: cancel.request_id, reason: "cancelled" });
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    // ─── Subscribe announces lifecycle ───
+    handleSubscribeAnnounces(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const sa = message;
+        const dupErr = this.checkDuplicateRequestId(sa.request_id, message.type);
+        if (dupErr)
+            return { ok: false, violation: dupErr };
+        this._requestIds.add(sa.request_id);
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleSubscribeAnnouncesOk(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const ok = message;
+        const idErr = this.checkKnownRequestId(ok.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleSubscribeAnnouncesError(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const saErr = message;
+        const idErr = this.checkKnownRequestId(saErr.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    // ─── Track status lifecycle ───
+    handleTrackStatusRequest(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const tsr = message;
+        const dupErr = this.checkDuplicateRequestId(tsr.request_id, message.type);
+        if (dupErr)
+            return { ok: false, violation: dupErr };
+        this._requestIds.add(tsr.request_id);
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    handleTrackStatusResponse(message, sideEffects) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        const ts = message;
+        const idErr = this.checkKnownRequestId(ts.request_id, message.type);
+        if (idErr)
+            return { ok: false, violation: idErr };
+        return { ok: true, phase: this._phase, sideEffects };
+    }
+    // ─── Generic ready-phase handler ───
+    handleReadyPhaseMessage(message) {
+        const err = this.requireReady(message.type);
+        if (err)
+            return { ok: false, violation: err };
+        return { ok: true, phase: this._phase, sideEffects: [] };
+    }
+    reset() {
+        this._phase = "idle";
+        this._subscriptions.clear();
+        this._announces.clear();
+        this._fetches.clear();
+        this._requestIds.clear();
+    }
+}
+//# sourceMappingURL=session-fsm.js.map