@moqtap/codec 0.1.1 → 0.2.0

package/src/drafts/draft15/index.ts

@@ -0,0 +1,121 @@
+export type { Draft15Codec } from "./codec.js";
+export {
+  createDataStreamDecoder,
+  createDraft15Codec,
+  createFetchStreamDecoder,
+  createStreamDecoder,
+  createSubgroupStreamDecoder,
+  decodeDatagram,
+  decodeDataStream,
+  decodeFetchStream,
+  decodeMessage,
+  decodeSubgroupStream,
+  encodeDatagram,
+  encodeFetchStream,
+  encodeMessage,
+  encodeSubgroupStream,
+} from "./codec.js";
+export {
+  MESSAGE_ID_MAP,
+  MESSAGE_TYPE_MAP,
+  MSG_CLIENT_SETUP,
+  MSG_FETCH,
+  MSG_FETCH_CANCEL,
+  MSG_FETCH_OK,
+  MSG_GOAWAY,
+  MSG_MAX_REQUEST_ID,
+  MSG_PUBLISH,
+  MSG_PUBLISH_DONE,
+  MSG_PUBLISH_NAMESPACE,
+  MSG_PUBLISH_NAMESPACE_CANCEL,
+  MSG_PUBLISH_NAMESPACE_DONE,
+  MSG_PUBLISH_OK,
+  MSG_REQUEST_ERROR,
+  MSG_REQUEST_OK,
+  MSG_REQUESTS_BLOCKED,
+  MSG_SERVER_SETUP,
+  MSG_SUBSCRIBE,
+  MSG_SUBSCRIBE_NAMESPACE,
+  MSG_SUBSCRIBE_OK,
+  MSG_SUBSCRIBE_UPDATE,
+  MSG_TRACK_STATUS,
+  MSG_UNSUBSCRIBE,
+  MSG_UNSUBSCRIBE_NAMESPACE,
+  SETUP_PARAM_AUTHORITY,
+  SETUP_PARAM_MAX_AUTH_TOKEN_CACHE_SIZE,
+  SETUP_PARAM_MAX_REQUEST_ID,
+  SETUP_PARAM_MOQT_IMPLEMENTATION,
+  SETUP_PARAM_PATH,
+} from "./messages.js";
+export {
+  BIDIRECTIONAL_MESSAGES,
+  CLIENT_ONLY_MESSAGES,
+  CONTROL_MESSAGES,
+  getLegalIncoming,
+  getLegalOutgoing,
+  SERVER_ONLY_MESSAGES,
+} from "./rules.js";
+export type {
+  FetchPhase,
+  FetchState,
+  ProtocolViolation,
+  ProtocolViolationCode,
+  PublishPhase,
+  PublishState,
+  SessionPhase,
+  SessionState,
+  SessionStateOptions,
+  SideEffect,
+  SubscriptionPhase,
+  SubscriptionState,
+  TransitionResult,
+  ValidationResult,
+} from "./session.js";
+// Session state machine
+export { createDraft15SessionState } from "./session.js";
+export { Draft15SessionFSM } from "./session-fsm.js";
+export type {
+  DatagramObject,
+  DataStreamEvent,
+  DataStreamHeader,
+  Draft15BaseMessage,
+  Draft15ClientSetup,
+  Draft15DataStream,
+  Draft15Fetch,
+  Draft15FetchCancel,
+  Draft15FetchOk,
+  Draft15GoAway,
+  Draft15MaxRequestId,
+  Draft15Message,
+  Draft15MessageType,
+  Draft15Params,
+  Draft15Publish,
+  Draft15PublishDone,
+  Draft15PublishNamespace,
+  Draft15PublishNamespaceCancel,
+  Draft15PublishNamespaceDone,
+  Draft15PublishOk,
+  Draft15RequestError,
+  Draft15RequestOk,
+  Draft15RequestsBlocked,
+  Draft15ServerSetup,
+  Draft15SetupParams,
+  Draft15Subscribe,
+  Draft15SubscribeNamespace,
+  Draft15SubscribeOk,
+  Draft15SubscribeUpdate,
+  Draft15TrackStatus,
+  Draft15Unsubscribe,
+  Draft15UnsubscribeNamespace,
+  FetchObjectPayload,
+  FetchStream,
+  FetchStreamHeader,
+  JoiningFetch,
+  LargestObject,
+  ObjectPayload,
+  StandaloneFetch,
+  SubgroupStream,
+  SubgroupStreamHeader,
+  SubscriptionFilter,
+  UnknownParam,
+} from "./types.js";

package/src/drafts/draft15/messages.ts

@@ -0,0 +1,64 @@
+// Draft-15 message type wire IDs
+
+export const MSG_SUBSCRIBE_UPDATE = 0x02n;
+export const MSG_SUBSCRIBE = 0x03n;
+export const MSG_SUBSCRIBE_OK = 0x04n;
+export const MSG_REQUEST_ERROR = 0x05n;
+export const MSG_PUBLISH_NAMESPACE = 0x06n;
+export const MSG_REQUEST_OK = 0x07n;
+export const MSG_PUBLISH_NAMESPACE_DONE = 0x09n;
+export const MSG_UNSUBSCRIBE = 0x0an;
+export const MSG_PUBLISH_DONE = 0x0bn;
+export const MSG_PUBLISH_NAMESPACE_CANCEL = 0x0cn;
+export const MSG_TRACK_STATUS = 0x0dn;
+export const MSG_GOAWAY = 0x10n;
+export const MSG_SUBSCRIBE_NAMESPACE = 0x11n;
+export const MSG_UNSUBSCRIBE_NAMESPACE = 0x14n;
+export const MSG_MAX_REQUEST_ID = 0x15n;
+export const MSG_FETCH = 0x16n;
+export const MSG_FETCH_CANCEL = 0x17n;
+export const MSG_FETCH_OK = 0x18n;
+export const MSG_REQUESTS_BLOCKED = 0x1an;
+export const MSG_PUBLISH = 0x1dn;
+export const MSG_PUBLISH_OK = 0x1en;
+export const MSG_CLIENT_SETUP = 0x20n;
+export const MSG_SERVER_SETUP = 0x21n;
+
+// Setup parameter type IDs
+export const SETUP_PARAM_PATH = 0x01n;
+export const SETUP_PARAM_MAX_REQUEST_ID = 0x02n;
+export const SETUP_PARAM_MAX_AUTH_TOKEN_CACHE_SIZE = 0x04n;
+export const SETUP_PARAM_AUTHORITY = 0x05n;
+export const SETUP_PARAM_MOQT_IMPLEMENTATION = 0x07n;
+
+// Map from wire ID to message type name
+export const MESSAGE_TYPE_MAP: ReadonlyMap<bigint, string> = new Map([
+  [MSG_CLIENT_SETUP, "client_setup"],
+  [MSG_SERVER_SETUP, "server_setup"],
+  [MSG_SUBSCRIBE, "subscribe"],
+  [MSG_SUBSCRIBE_OK, "subscribe_ok"],
+  [MSG_SUBSCRIBE_UPDATE, "subscribe_update"],
+  [MSG_UNSUBSCRIBE, "unsubscribe"],
+  [MSG_PUBLISH, "publish"],
+  [MSG_PUBLISH_OK, "publish_ok"],
+  [MSG_PUBLISH_DONE, "publish_done"],
+  [MSG_PUBLISH_NAMESPACE, "publish_namespace"],
+  [MSG_PUBLISH_NAMESPACE_DONE, "publish_namespace_done"],
+  [MSG_PUBLISH_NAMESPACE_CANCEL, "publish_namespace_cancel"],
+  [MSG_SUBSCRIBE_NAMESPACE, "subscribe_namespace"],
+  [MSG_UNSUBSCRIBE_NAMESPACE, "unsubscribe_namespace"],
+  [MSG_FETCH, "fetch"],
+  [MSG_FETCH_OK, "fetch_ok"],
+  [MSG_FETCH_CANCEL, "fetch_cancel"],
+  [MSG_TRACK_STATUS, "track_status"],
+  [MSG_REQUEST_OK, "request_ok"],
+  [MSG_REQUEST_ERROR, "request_error"],
+  [MSG_GOAWAY, "goaway"],
+  [MSG_MAX_REQUEST_ID, "max_request_id"],
+  [MSG_REQUESTS_BLOCKED, "requests_blocked"],
+]);
+
+// Reverse map from message type name to wire ID
+export const MESSAGE_ID_MAP: ReadonlyMap<string, bigint> = new Map(
+  [...MESSAGE_TYPE_MAP.entries()].map(([id, name]) => [name, id]),
+);

package/src/drafts/draft15/rules.ts

@@ -0,0 +1,95 @@
+import type { Draft15MessageType } from "./types.js";
+
+// All draft-15 control messages
+export const CONTROL_MESSAGES: ReadonlySet<Draft15MessageType> = new Set([
+  "client_setup",
+  "server_setup",
+  "subscribe",
+  "subscribe_ok",
+  "subscribe_update",
+  "unsubscribe",
+  "publish",
+  "publish_ok",
+  "publish_done",
+  "publish_namespace",
+  "publish_namespace_done",
+  "publish_namespace_cancel",
+  "subscribe_namespace",
+  "unsubscribe_namespace",
+  "fetch",
+  "fetch_ok",
+  "fetch_cancel",
+  "track_status",
+  "request_ok",
+  "request_error",
+  "goaway",
+  "max_request_id",
+  "requests_blocked",
+]);
+
+// Draft-15 is symmetric: only setup messages are role-restricted.
+export const CLIENT_ONLY_MESSAGES: ReadonlySet<Draft15MessageType> = new Set(["client_setup"]);
+
+export const SERVER_ONLY_MESSAGES: ReadonlySet<Draft15MessageType> = new Set(["server_setup"]);
+
+// Messages that are bidirectional (both client and server can send)
+export const BIDIRECTIONAL_MESSAGES: ReadonlySet<Draft15MessageType> = new Set([
+  "subscribe",
+  "subscribe_ok",
+  "subscribe_update",
+  "unsubscribe",
+  "publish",
+  "publish_ok",
+  "publish_done",
+  "publish_namespace",
+  "publish_namespace_done",
+  "publish_namespace_cancel",
+  "subscribe_namespace",
+  "unsubscribe_namespace",
+  "fetch",
+  "fetch_ok",
+  "fetch_cancel",
+  "track_status",
+  "request_ok",
+  "request_error",
+  "goaway",
+  "max_request_id",
+  "requests_blocked",
+]);
+
+// Messages legal in each session phase -- for outbound validation
+export function getLegalOutgoing(
+  phase: string,
+  role: "client" | "server",
+): Set<Draft15MessageType> {
+  const legal = new Set<Draft15MessageType>();
+
+  switch (phase) {
+    case "idle":
+      if (role === "client") legal.add("client_setup");
+      break;
+    case "setup":
+      if (role === "server") legal.add("server_setup");
+      break;
+    case "ready": {
+      legal.add("goaway");
+      for (const msg of BIDIRECTIONAL_MESSAGES) {
+        legal.add(msg);
+      }
+      break;
+    }
+    case "draining":
+      // Limited set during draining
+      break;
+  }
+
+  return legal;
+}
+
+export function getLegalIncoming(
+  phase: string,
+  role: "client" | "server",
+): Set<Draft15MessageType> {
+  const remoteRole = role === "client" ? "server" : "client";
+  return getLegalOutgoing(phase, remoteRole);
+}