@moqtap/codec 0.2.3 → 0.4.0

package/src/drafts/draft14/index.ts

@@ -1,4 +1,6 @@
-export type { Draft14Codec } from "./codec.js";
+export const DRAFT_VERSION = 0xff00000en
+
+export type { Draft14Codec } from './codec.js'
 export {
   createDataStreamDecoder,
   createDraft14Codec,
@@ -14,7 +16,7 @@ export {
   encodeFetchStream,
   encodeMessage,
   encodeSubgroupStream,
-} from "./codec.js";
+} from './codec.js'
 export {
   MESSAGE_ID_MAP,
   MESSAGE_TYPE_MAP,
@@ -51,7 +53,7 @@ export {
   PARAM_MAX_REQUEST_ID,
   PARAM_PATH,
   PARAM_ROLE,
-} from "./messages.js";
+} from './messages.js'
 export {
   BIDIRECTIONAL_MESSAGES,
   CLIENT_ONLY_MESSAGES,
@@ -59,7 +61,7 @@ export {
   getLegalIncoming,
   getLegalOutgoing,
   SERVER_ONLY_MESSAGES,
-} from "./rules.js";
+} from './rules.js'
 export type {
   FetchPhase,
   FetchState,
@@ -69,17 +71,17 @@ export type {
   PublishState,
   SessionPhase,
   SessionState,
-  SessionStateOptions,
   SideEffect,
   SubscriptionPhase,
   SubscriptionState,
   TransitionResult,
   ValidationResult,
-} from "./session.js";
+} from './session.js'
+export { createDraft14SessionState } from './session.js'
 // Session state machine
-export { createDraft14SessionState } from "./session.js";
-export { Draft14SessionFSM } from "./session-fsm.js";
+export { Draft14SessionFSM } from './session-fsm.js'
 export type {
+  AuthorizationToken,
   DatagramObject,
   DataStreamEvent,
   DataStreamHeader,
@@ -118,10 +120,16 @@ export type {
   Draft14TrackStatusOk,
   Draft14Unsubscribe,
   Draft14UnsubscribeNamespace,
+  FetchObjectPayload,
   FetchStream,
   FetchStreamHeader,
+  FetchTypeValue,
+  FilterTypeValue,
+  GroupOrderValue,
+  Location,
   ObjectPayload,
   SubgroupStream,
   SubgroupStreamHeader,
   UnknownParam,
-} from "./types.js";
+} from './types.js'
+export { FetchType, FilterType, GroupOrder } from './types.js'

package/src/drafts/draft14/messages.ts

@@ -1,76 +1,76 @@
 // Draft-14 message type wire IDs
 
-export const MSG_SUBSCRIBE_UPDATE = 0x02n;
-export const MSG_SUBSCRIBE = 0x03n;
-export const MSG_SUBSCRIBE_OK = 0x04n;
-export const MSG_SUBSCRIBE_ERROR = 0x05n;
-export const MSG_PUBLISH_NAMESPACE = 0x06n;
-export const MSG_PUBLISH_NAMESPACE_OK = 0x07n;
-export const MSG_PUBLISH_NAMESPACE_ERROR = 0x08n;
-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_TRACK_STATUS_OK = 0x0en;
-export const MSG_TRACK_STATUS_ERROR = 0x0fn;
-export const MSG_GOAWAY = 0x10n;
-export const MSG_SUBSCRIBE_NAMESPACE = 0x11n;
-export const MSG_SUBSCRIBE_NAMESPACE_OK = 0x12n;
-export const MSG_SUBSCRIBE_NAMESPACE_ERROR = 0x13n;
-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_FETCH_ERROR = 0x19n;
-export const MSG_REQUESTS_BLOCKED = 0x1an;
-export const MSG_PUBLISH = 0x1dn;
-export const MSG_PUBLISH_OK = 0x1en;
-export const MSG_PUBLISH_ERROR = 0x1fn;
-export const MSG_CLIENT_SETUP = 0x20n;
-export const MSG_SERVER_SETUP = 0x21n;
+export const MSG_SUBSCRIBE_UPDATE = 0x02n
+export const MSG_SUBSCRIBE = 0x03n
+export const MSG_SUBSCRIBE_OK = 0x04n
+export const MSG_SUBSCRIBE_ERROR = 0x05n
+export const MSG_PUBLISH_NAMESPACE = 0x06n
+export const MSG_PUBLISH_NAMESPACE_OK = 0x07n
+export const MSG_PUBLISH_NAMESPACE_ERROR = 0x08n
+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_TRACK_STATUS_OK = 0x0en
+export const MSG_TRACK_STATUS_ERROR = 0x0fn
+export const MSG_GOAWAY = 0x10n
+export const MSG_SUBSCRIBE_NAMESPACE = 0x11n
+export const MSG_SUBSCRIBE_NAMESPACE_OK = 0x12n
+export const MSG_SUBSCRIBE_NAMESPACE_ERROR = 0x13n
+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_FETCH_ERROR = 0x19n
+export const MSG_REQUESTS_BLOCKED = 0x1an
+export const MSG_PUBLISH = 0x1dn
+export const MSG_PUBLISH_OK = 0x1en
+export const MSG_PUBLISH_ERROR = 0x1fn
+export const MSG_CLIENT_SETUP = 0x20n
+export const MSG_SERVER_SETUP = 0x21n
 
 // Parameter type IDs
-export const PARAM_ROLE = 0x00n;
-export const PARAM_PATH = 0x01n;
-export const PARAM_MAX_REQUEST_ID = 0x02n;
+export const PARAM_ROLE = 0x00n
+export const PARAM_PATH = 0x01n
+export const PARAM_MAX_REQUEST_ID = 0x02n
 
 // 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_SUBSCRIBE_ERROR, "subscribe_error"],
-  [MSG_UNSUBSCRIBE, "unsubscribe"],
-  [MSG_PUBLISH, "publish"],
-  [MSG_PUBLISH_OK, "publish_ok"],
-  [MSG_PUBLISH_ERROR, "publish_error"],
-  [MSG_PUBLISH_DONE, "publish_done"],
-  [MSG_PUBLISH_NAMESPACE, "publish_namespace"],
-  [MSG_PUBLISH_NAMESPACE_OK, "publish_namespace_ok"],
-  [MSG_PUBLISH_NAMESPACE_ERROR, "publish_namespace_error"],
-  [MSG_PUBLISH_NAMESPACE_DONE, "publish_namespace_done"],
-  [MSG_PUBLISH_NAMESPACE_CANCEL, "publish_namespace_cancel"],
-  [MSG_SUBSCRIBE_NAMESPACE, "subscribe_namespace"],
-  [MSG_SUBSCRIBE_NAMESPACE_OK, "subscribe_namespace_ok"],
-  [MSG_SUBSCRIBE_NAMESPACE_ERROR, "subscribe_namespace_error"],
-  [MSG_UNSUBSCRIBE_NAMESPACE, "unsubscribe_namespace"],
-  [MSG_FETCH, "fetch"],
-  [MSG_FETCH_OK, "fetch_ok"],
-  [MSG_FETCH_ERROR, "fetch_error"],
-  [MSG_FETCH_CANCEL, "fetch_cancel"],
-  [MSG_TRACK_STATUS, "track_status"],
-  [MSG_TRACK_STATUS_OK, "track_status_ok"],
-  [MSG_TRACK_STATUS_ERROR, "track_status_error"],
-  [MSG_GOAWAY, "goaway"],
-  [MSG_MAX_REQUEST_ID, "max_request_id"],
-  [MSG_REQUESTS_BLOCKED, "requests_blocked"],
-]);
+  [MSG_CLIENT_SETUP, 'client_setup'],
+  [MSG_SERVER_SETUP, 'server_setup'],
+  [MSG_SUBSCRIBE, 'subscribe'],
+  [MSG_SUBSCRIBE_OK, 'subscribe_ok'],
+  [MSG_SUBSCRIBE_UPDATE, 'subscribe_update'],
+  [MSG_SUBSCRIBE_ERROR, 'subscribe_error'],
+  [MSG_UNSUBSCRIBE, 'unsubscribe'],
+  [MSG_PUBLISH, 'publish'],
+  [MSG_PUBLISH_OK, 'publish_ok'],
+  [MSG_PUBLISH_ERROR, 'publish_error'],
+  [MSG_PUBLISH_DONE, 'publish_done'],
+  [MSG_PUBLISH_NAMESPACE, 'publish_namespace'],
+  [MSG_PUBLISH_NAMESPACE_OK, 'publish_namespace_ok'],
+  [MSG_PUBLISH_NAMESPACE_ERROR, 'publish_namespace_error'],
+  [MSG_PUBLISH_NAMESPACE_DONE, 'publish_namespace_done'],
+  [MSG_PUBLISH_NAMESPACE_CANCEL, 'publish_namespace_cancel'],
+  [MSG_SUBSCRIBE_NAMESPACE, 'subscribe_namespace'],
+  [MSG_SUBSCRIBE_NAMESPACE_OK, 'subscribe_namespace_ok'],
+  [MSG_SUBSCRIBE_NAMESPACE_ERROR, 'subscribe_namespace_error'],
+  [MSG_UNSUBSCRIBE_NAMESPACE, 'unsubscribe_namespace'],
+  [MSG_FETCH, 'fetch'],
+  [MSG_FETCH_OK, 'fetch_ok'],
+  [MSG_FETCH_ERROR, 'fetch_error'],
+  [MSG_FETCH_CANCEL, 'fetch_cancel'],
+  [MSG_TRACK_STATUS, 'track_status'],
+  [MSG_TRACK_STATUS_OK, 'track_status_ok'],
+  [MSG_TRACK_STATUS_ERROR, 'track_status_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/draft14/rules.ts

@@ -1,113 +1,113 @@
-import type { Draft14MessageType } from "./types.js";
+import type { Draft14MessageType } from './types.js'
 
 // All draft-14 control messages
 export const CONTROL_MESSAGES: ReadonlySet<Draft14MessageType> = new Set([
-  "client_setup",
-  "server_setup",
-  "subscribe",
-  "subscribe_ok",
-  "subscribe_update",
-  "subscribe_error",
-  "unsubscribe",
-  "publish",
-  "publish_ok",
-  "publish_error",
-  "publish_done",
-  "publish_namespace",
-  "publish_namespace_ok",
-  "publish_namespace_error",
-  "publish_namespace_done",
-  "publish_namespace_cancel",
-  "subscribe_namespace",
-  "subscribe_namespace_ok",
-  "subscribe_namespace_error",
-  "unsubscribe_namespace",
-  "fetch",
-  "fetch_ok",
-  "fetch_error",
-  "fetch_cancel",
-  "track_status",
-  "track_status_ok",
-  "track_status_error",
-  "goaway",
-  "max_request_id",
-  "requests_blocked",
-]);
+  'client_setup',
+  'server_setup',
+  'subscribe',
+  'subscribe_ok',
+  'subscribe_update',
+  'subscribe_error',
+  'unsubscribe',
+  'publish',
+  'publish_ok',
+  'publish_error',
+  'publish_done',
+  'publish_namespace',
+  'publish_namespace_ok',
+  'publish_namespace_error',
+  'publish_namespace_done',
+  'publish_namespace_cancel',
+  'subscribe_namespace',
+  'subscribe_namespace_ok',
+  'subscribe_namespace_error',
+  'unsubscribe_namespace',
+  'fetch',
+  'fetch_ok',
+  'fetch_error',
+  'fetch_cancel',
+  'track_status',
+  'track_status_ok',
+  'track_status_error',
+  'goaway',
+  'max_request_id',
+  'requests_blocked',
+])
 
 // Draft-14 is more symmetric: only setup messages are role-restricted.
 // All other messages can be sent by both client and server.
-export const CLIENT_ONLY_MESSAGES: ReadonlySet<Draft14MessageType> = new Set(["client_setup"]);
+export const CLIENT_ONLY_MESSAGES: ReadonlySet<Draft14MessageType> = new Set(['client_setup'])
 
-export const SERVER_ONLY_MESSAGES: ReadonlySet<Draft14MessageType> = new Set(["server_setup"]);
+export const SERVER_ONLY_MESSAGES: ReadonlySet<Draft14MessageType> = new Set(['server_setup'])
 
 // Messages that are bidirectional (both client and server can send)
 export const BIDIRECTIONAL_MESSAGES: ReadonlySet<Draft14MessageType> = new Set([
-  "subscribe",
-  "subscribe_ok",
-  "subscribe_update",
-  "subscribe_error",
-  "unsubscribe",
-  "publish",
-  "publish_ok",
-  "publish_error",
-  "publish_done",
-  "publish_namespace",
-  "publish_namespace_ok",
-  "publish_namespace_error",
-  "publish_namespace_done",
-  "publish_namespace_cancel",
-  "subscribe_namespace",
-  "subscribe_namespace_ok",
-  "subscribe_namespace_error",
-  "unsubscribe_namespace",
-  "fetch",
-  "fetch_ok",
-  "fetch_error",
-  "fetch_cancel",
-  "track_status",
-  "track_status_ok",
-  "track_status_error",
-  "goaway",
-  "max_request_id",
-  "requests_blocked",
-]);
+  'subscribe',
+  'subscribe_ok',
+  'subscribe_update',
+  'subscribe_error',
+  'unsubscribe',
+  'publish',
+  'publish_ok',
+  'publish_error',
+  'publish_done',
+  'publish_namespace',
+  'publish_namespace_ok',
+  'publish_namespace_error',
+  'publish_namespace_done',
+  'publish_namespace_cancel',
+  'subscribe_namespace',
+  'subscribe_namespace_ok',
+  'subscribe_namespace_error',
+  'unsubscribe_namespace',
+  'fetch',
+  'fetch_ok',
+  'fetch_error',
+  'fetch_cancel',
+  'track_status',
+  'track_status_ok',
+  'track_status_error',
+  'goaway',
+  'max_request_id',
+  'requests_blocked',
+])
 
 // Messages legal in each session phase -- for outbound validation
 export function getLegalOutgoing(
   phase: string,
-  role: "client" | "server",
+  role: 'client' | 'server',
 ): Set<Draft14MessageType> {
-  const legal = new Set<Draft14MessageType>();
+  const legal = new Set<Draft14MessageType>()
 
   switch (phase) {
-    case "idle":
-      if (role === "client") legal.add("client_setup");
-      break;
-    case "setup":
-      if (role === "server") legal.add("server_setup");
-      break;
-    case "ready": {
+    case 'idle':
+      if (role === 'client') legal.add('client_setup')
+      break
+    case 'setup':
+      if (role === 'server') legal.add('server_setup')
+      break
+    case 'ready': {
       // Both roles can send goaway
-      legal.add("goaway");
+      legal.add('goaway')
       // All bidirectional messages are legal for both roles
       for (const msg of BIDIRECTIONAL_MESSAGES) {
-        legal.add(msg);
+        legal.add(msg)
       }
-      break;
+      break
     }
-    case "draining":
+    case 'draining':
       // Limited set during draining - can still finish active operations
-      break;
+      break
   }
 
-  return legal;
+  return legal
 }
 
 export function getLegalIncoming(
   phase: string,
-  role: "client" | "server",
+  role: 'client' | 'server',
 ): Set<Draft14MessageType> {
   // Incoming from remote = the other role's outgoing
-  const remoteRole = role === "client" ? "server" : "client";
-  return getLegalOutgoing(phase, remoteRole);
+  const remoteRole = role === 'client' ? 'server' : 'client'
+  return getLegalOutgoing(phase, remoteRole)
 }