@velarscript/server 0.18.1 → 0.19.0

package/README.md

@@ -2,9 +2,58 @@
 
 The official convention-based VelarScript server application framework. It is
 activated explicitly in `velar.json`, composes `@velarscript/node`, and owns
-root `application.yml` loading,
-application startup assembly, and typed application-scoped connection
-lifecycle.
+root `application.yml` loading, application startup assembly, typed
+application-scoped connection lifecycle, and a target-specific realtime
+session module.
+
+The realtime boundary has two deliberate layers:
+
+- `velar/websocket` owns HTTP upgrade, frames, Origin admission, close codes,
+  transport limits, and the physical connection.
+- server-target `velar/realtime.realtimeSession` owns the repeatable application session:
+  decode, sequential command handling, one bounded outbound mailbox, one
+  writer, failure policy, cleanup, and close notification.
+
+Applications still own authentication, rooms, subscriptions, command/event
+types, serialization, authorization, and delivery guarantees. A shared
+protocol package can therefore be consumed by both server and browser without
+making the server framework depend on one client or one wire format.
+
+```velar fragment
+import {Bytes} from "velar/binary"
+import {RealtimeFailureAction, RealtimePeer, realtimeSession} from "velar/realtime"
+import {WebSocketConnection} from "velar/websocket"
+
+type Command:
+    operation: string
+
+type ServerEvent:
+    event: string
+
+def decode(message: string | Bytes) -> Command:
+    if message is string: return Json.parse(message, Command)
+    throw Error("Binary commands are not supported")
+
+def encode(event: ServerEvent) -> string | Bytes:
+    return Json.stringify(event)
+
+async def receive(command: Command, peer: RealtimePeer<ServerEvent>):
+    await peer.send({event: command.operation})
+
+async def session(connection: WebSocketConnection):
+    await realtimeSession(
+        connection,
+        {decode, encode},
+        receive,
+        failed=async (_failure, _peer) => RealtimeFailureAction.close,
+    )
+```
+
+`send` waits until that message reaches the transport. `trySend` never waits
+and returns `false` when the session mailbox is full. Inbound commands are
+handled in wire order. The framework deliberately does not replay commands or
+claim stronger-than-WebSocket delivery; sequence numbers, acknowledgements,
+resume cursors, and idempotency keys belong to the shared application protocol.
 
 `authenticate(credential, verify)` turns one checked `security` descriptor into
 a request-scoped `Provider<Identity>`. The verifier must resolve to a typed

package/dist/compiler.d.ts

@@ -1,5 +1,5 @@
 import { type CompilerExtension, type ModuleInterface } from "@velarscript/compiler";
-export declare const VELAR_SERVER_API_VERSION = "0.13";
+export declare const VELAR_SERVER_API_VERSION = "0.14";
 export declare const serverModuleInterfaces: ReadonlyMap<string, ModuleInterface>;
 export declare const serverModuleSources: ReadonlyMap<string, string>;
 export declare const velarCompilerExtension: CompilerExtension;

package/dist/compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAErB,MAAM,uBAAuB,CAAC;AAgB/B,eAAO,MAAM,wBAAwB,SAAS,CAAC;AAoE/C,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAA4B,CAAC;AAQrG,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAyB,CAAC;AAKtF,eAAO,MAAM,sBAAsB,EAAE,iBA+BnC,CAAC;AAEH,OAAO,EAAC,qBAAqB,EAAE,KAAK,iBAAiB,EAAC,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EAGtB,KAAK,eAAe,EAErB,MAAM,uBAAuB,CAAC;AAiB/B,eAAO,MAAM,wBAAwB,SAAS,CAAC;AA8N/C,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAA4B,CAAC;AASrG,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAyB,CAAC;AAMtF,eAAO,MAAM,sBAAsB,EAAE,iBA+BnC,CAAC;AAEH,OAAO,EAAC,qBAAqB,EAAE,KAAK,iBAAiB,EAAC,MAAM,qBAAqB,CAAC"}

package/dist/compiler.js

@@ -2,13 +2,21 @@ import {} from "@velarscript/compiler";
 import { VELAR_STRICT_JSON_RUNTIME, VELAR_TYPE_REGISTRY_RUNTIME, } from "@velarscript/compiler/extension";
 import { VELAR_NODE_API_VERSION, nodeModuleDependencies, nodeModuleInterfaces, nodeModuleSources, velarNodeCompilerExtension, } from "@velarscript/node/compiler";
 import { inferServerIntrinsic } from "./analyzer.js";
+import { VELAR_SERVER_REALTIME_RUNTIME } from "./realtime-runtime.js";
 import { VELAR_SERVER_RUNTIME } from "./runtime.js";
-export const VELAR_SERVER_API_VERSION = "0.13";
+export const VELAR_SERVER_API_VERSION = "0.14";
 const unknownType = { kind: "unknown" };
 const stringType = { kind: "string" };
 const numberType = { kind: "number" };
+const boolType = { kind: "bool" };
+const nullType = { kind: "null" };
+const errorType = { kind: "class", name: "Error" };
+const bytesType = { kind: "named", name: "Bytes", identity: "velar/binary#type:Bytes" };
+const durationType = { kind: "named", name: "Duration" };
 const serverType = { kind: "named", name: "Server", identity: "velar/serve#type:Server" };
 const serveAppType = { kind: "named", name: "ServeApp", identity: "velar/serve#type:ServeApp" };
+const webSocketConnectionType = { kind: "named", name: "WebSocketConnection", identity: "velar/websocket#type:WebSocketConnection" };
+const webSocketCloseType = { kind: "named", name: "WebSocketClose", identity: "velar/websocket#type:WebSocketClose" };
 const providerType = {
     kind: "extension",
     extensionId: "@velarscript/node",
@@ -28,18 +36,133 @@ function functionType(parameterNames, parameters, result, requiredParameters = p
 function intrinsic(name, parameterNames, parameters, result, requiredParameters = parameters.length) {
     return { kind: "intrinsic", name, parameterNames, parameters, requiredParameters, result };
 }
-function moduleInterface(exports) {
+const realtimeWireType = { kind: "union", members: [stringType, bytesType] };
+const realtimeFailureIdentity = "velar/realtime#type:RealtimeFailure";
+const realtimeFailureType = { kind: "named", name: "RealtimeFailure", identity: realtimeFailureIdentity };
+const realtimeFailureActionIdentity = "velar/realtime#enum:RealtimeFailureAction";
+const realtimeFailureActionMembers = new Set(["continue", "close"]);
+const realtimeFailureActionType = { kind: "enum", name: "RealtimeFailureAction", identity: realtimeFailureActionIdentity };
+const realtimePeerStateIdentity = "velar/realtime#enum:RealtimePeerState";
+const realtimePeerStateMembers = new Set(["open", "closing", "closed"]);
+const realtimePeerStateType = { kind: "enum", name: "RealtimePeerState", identity: realtimePeerStateIdentity };
+const realtimeBackpressureIdentity = "velar/realtime#class:RealtimeBackpressureError";
+const realtimePeerIdentity = "velar/realtime#type:RealtimePeer";
+const realtimeCodecIdentity = "velar/realtime#type:RealtimeCodec";
+const realtimePeerElement = { kind: "parameter", name: "T", index: 0 };
+const realtimeCodecIncoming = { kind: "parameter", name: "Incoming", index: 0 };
+const realtimeCodecOutgoing = { kind: "parameter", name: "Outgoing", index: 1 };
+function genericApplication(name, identity, arguments_) {
+    const labels = arguments_.map((argument, index) => argument.kind === "parameter" ? argument.name : `T${index + 1}`);
+    return { kind: "named", name: `${name}<${labels.join(", ")}>`, identity, application: { declaration: identity, name, arguments: arguments_ } };
+}
+const realtimePeerOf = (value) => genericApplication("RealtimePeer", realtimePeerIdentity, [value]);
+const realtimeCodecOf = (incoming, outgoing) => genericApplication("RealtimeCodec", realtimeCodecIdentity, [incoming, outgoing]);
+const realtimePeerTemplate = {
+    identity: realtimePeerIdentity,
+    name: "RealtimePeer",
+    parameterNames: ["T"],
+    parameterBounds: [null],
+    fields: new Map([
+        ["state", functionType([], [], realtimePeerStateType)],
+        ["send", functionType(["message"], [realtimePeerElement], promise(nullType))],
+        ["trySend", functionType(["message"], [realtimePeerElement], boolType)],
+        ["close", functionType(["code", "reason"], [numberType, stringType], promise(nullType), 0)],
+    ]),
+    readonlyFields: new Set(["state", "send", "trySend", "close"]),
+};
+const realtimeCodecTemplate = {
+    identity: realtimeCodecIdentity,
+    name: "RealtimeCodec",
+    parameterNames: ["Incoming", "Outgoing"],
+    parameterBounds: [null, null],
+    fields: new Map([
+        ["decode", functionType(["message"], [realtimeWireType], realtimeCodecIncoming)],
+        ["encode", functionType(["message"], [realtimeCodecOutgoing], realtimeWireType)],
+    ]),
+    readonlyFields: new Set(["decode", "encode"]),
+};
+const realtimeGenericTypes = new Map([
+    ["RealtimePeer", realtimePeerTemplate],
+    ["RealtimeCodec", realtimeCodecTemplate],
+]);
+const realtimeFailureFields = new Map([
+    ["phase", stringType],
+    ["error", errorType],
+    ["recoverable", boolType],
+]);
+const realtimeFailureActionInfo = {
+    identity: realtimeFailureActionIdentity,
+    members: realtimeFailureActionMembers,
+    wireValues: new Map([...realtimeFailureActionMembers].map((member) => [member, member])),
+};
+const realtimePeerStateInfo = {
+    identity: realtimePeerStateIdentity,
+    members: realtimePeerStateMembers,
+    wireValues: new Map([...realtimePeerStateMembers].map((member) => [member, member])),
+};
+const realtimeBackpressureClass = {
+    identity: realtimeBackpressureIdentity,
+    parameters: [stringType],
+    parameterNames: ["message"],
+    requiredParameters: 0,
+    base: "Error",
+    abstract: false,
+    fields: new Map(),
+    getters: new Set(),
+    abstractGetters: new Set(),
+    methods: new Map(),
+    abstractMethods: new Set(),
+    staticFields: new Map(),
+    staticGetters: new Set(),
+    staticMethods: new Map(),
+};
+const realtimeSessionOptions = {
+    kind: "object",
+    fields: new Map([
+        ["maxQueuedMessages", numberType],
+        ["maxQueuedBytes", numberType],
+        ["drainTimeout", durationType],
+    ]),
+    optionalFields: new Set(["maxQueuedMessages", "maxQueuedBytes", "drainTimeout"]),
+};
+const realtimeInput = { kind: "parameter", name: "Incoming", index: 0 };
+const realtimeOutput = { kind: "parameter", name: "Outgoing", index: 1 };
+const realtimePeerOutput = realtimePeerOf(realtimeOutput);
+const realtimeCleanup = functionType([], [], promise(nullType));
+const realtimeOpened = functionType(["peer"], [realtimePeerOutput], promise({ kind: "optional", inner: realtimeCleanup }));
+const realtimeReceive = functionType(["message", "peer"], [realtimeInput, realtimePeerOutput], promise(nullType));
+const realtimeFailed = functionType(["failure", "peer"], [realtimeFailureType, realtimePeerOutput], promise(realtimeFailureActionType));
+const realtimeClosed = functionType(["peer", "close"], [realtimePeerOutput, webSocketCloseType], promise(nullType));
+const optionalFunction = (value) => ({ kind: "optional", inner: value });
+const realtimeSessionFunction = {
+    kind: "function",
+    typeParameterNames: ["Incoming", "Outgoing"],
+    parameterNames: ["connection", "codec", "receive", "opened", "failed", "closed", "options"],
+    parameters: [
+        webSocketConnectionType,
+        realtimeCodecOf(realtimeInput, realtimeOutput),
+        realtimeReceive,
+        optionalFunction(realtimeOpened),
+        optionalFunction(realtimeFailed),
+        optionalFunction(realtimeClosed),
+        realtimeSessionOptions,
+    ],
+    requiredParameters: 3,
+    result: promise(nullType),
+};
+function moduleInterface(exports, namedTypes = new Map(), namedTypeIdentities = new Map(), enums = new Map(), classes = new Map(), namedTypeReadonlyFields = new Map(), genericTypes = new Map()) {
     return {
         exports,
         mutableExports: new Set(),
         reactiveExports: new Map(),
         reExports: new Map(),
-        namedTypes: new Map(),
-        namedTypeReadonlyFields: new Map(),
-        namedTypeIdentities: new Map(),
+        namedTypes,
+        namedTypeReadonlyFields,
+        namedTypeIdentities,
+        genericTypes,
         typeAliases: new Map(),
-        enums: new Map(),
-        classes: new Map(),
+        enums,
+        classes,
         tests: [],
         extensionExports: new Map(),
         extensionData: new Map(),
@@ -51,8 +174,21 @@ const serverModuleInterface = moduleInterface(new Map([
     ["configuration", intrinsic("server.configuration", ["target", "path", "maxBytes"], [unknownType, { kind: "union", members: [stringType, { kind: "null" }] }, numberType], promise(unknownType), 1)],
     ["database", intrinsic("server.database", ["connect", "disconnect"], [unknownType, unknownType], providerType)],
 ]));
+const serverRealtimeModuleInterface = moduleInterface(new Map([
+    ["RealtimeBackpressureError", { kind: "classConstructor", name: "RealtimeBackpressureError", identity: realtimeBackpressureIdentity }],
+    ["RealtimeCodec", { kind: "typeObject", name: "RealtimeCodec", value: realtimeCodecOf(realtimeCodecIncoming, realtimeCodecOutgoing) }],
+    ["RealtimeFailure", { kind: "typeObject", name: "RealtimeFailure", value: realtimeFailureType }],
+    ["RealtimeFailureAction", { kind: "enumObject", name: "RealtimeFailureAction", identity: realtimeFailureActionIdentity, members: realtimeFailureActionMembers }],
+    ["RealtimePeer", { kind: "typeObject", name: "RealtimePeer", value: realtimePeerOf(realtimePeerElement) }],
+    ["RealtimePeerState", { kind: "enumObject", name: "RealtimePeerState", identity: realtimePeerStateIdentity, members: realtimePeerStateMembers }],
+    ["realtimeSession", realtimeSessionFunction],
+]), new Map([["RealtimeFailure", realtimeFailureFields]]), new Map([["RealtimeFailure", realtimeFailureIdentity]]), new Map([
+    ["RealtimeFailureAction", realtimeFailureActionInfo],
+    ["RealtimePeerState", realtimePeerStateInfo],
+]), new Map([["RealtimeBackpressureError", realtimeBackpressureClass]]), new Map([["RealtimeFailure", new Set(realtimeFailureFields.keys())]]), realtimeGenericTypes);
 const composedModuleInterfaces = new Map(nodeModuleInterfaces);
 composedModuleInterfaces.set("velar/server", serverModuleInterface);
+composedModuleInterfaces.set("velar/realtime", serverRealtimeModuleInterface);
 export const serverModuleInterfaces = composedModuleInterfaces;
 const composedModuleSources = new Map(nodeModuleSources);
 composedModuleSources.set("velar/server", String.raw `
@@ -60,9 +196,11 @@ ${VELAR_STRICT_JSON_RUNTIME}
 ${VELAR_TYPE_REGISTRY_RUNTIME}
 ${VELAR_SERVER_RUNTIME}
 `.trimStart());
+composedModuleSources.set("velar/realtime", VELAR_SERVER_REALTIME_RUNTIME);
 export const serverModuleSources = composedModuleSources;
 const serverModuleDependencies = new Map(nodeModuleDependencies);
 serverModuleDependencies.set("velar/server", ["velar/fs", "velar/serve"]);
+serverModuleDependencies.set("velar/realtime", ["velar/websocket"]);
 export const velarCompilerExtension = Object.freeze({
     id: "@velarscript/server",
     contract: Object.freeze({

package/dist/compiler.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { VELAR_SERVER_API_VERSION } from "./compiler.ts";
 export { velarProjectExtension, type VelarServerConfig } from "./project-config.ts";
-export declare const VELAR_SERVER_MODULES: readonly ["velar/server"];
+export declare const VELAR_SERVER_MODULES: readonly ["velar/server", "velar/realtime"];
 export declare const VELAR_SERVER_CONFIGURATION_FILES: readonly ["application.yml"];
 export interface VelarServerFrameworkManifest {
     readonly name: "@velarscript/server";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAC,qBAAqB,EAAE,KAAK,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AAElF,eAAO,MAAM,oBAAoB,2BAEtB,CAAC;AAEZ,eAAO,MAAM,gCAAgC,8BAElC,CAAC;AAEZ,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,kBAAkB,EAAE,OAAO,gCAAgC,CAAC;CACtE;AAED,eAAO,MAAM,oBAAoB,EAAE,4BAKjC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAC,qBAAqB,EAAE,KAAK,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AAElF,eAAO,MAAM,oBAAoB,6CAGtB,CAAC;AAEZ,eAAO,MAAM,gCAAgC,8BAElC,CAAC;AAEZ,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,kBAAkB,EAAE,OAAO,gCAAgC,CAAC;CACtE;AAED,eAAO,MAAM,oBAAoB,EAAE,4BAKjC,CAAC"}

package/dist/index.js

@@ -3,6 +3,7 @@ export { VELAR_SERVER_API_VERSION } from "./compiler.js";
 export { velarProjectExtension } from "./project-config.js";
 export const VELAR_SERVER_MODULES = Object.freeze([
     "velar/server",
+    "velar/realtime",
 ]);
 export const VELAR_SERVER_CONFIGURATION_FILES = Object.freeze([
     "application.yml",

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAC,qBAAqB,EAAyB,MAAM,qBAAqB,CAAC;AAElF,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,cAAc;CACN,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5D,iBAAiB;CACT,CAAC,CAAC;AASZ,MAAM,CAAC,MAAM,oBAAoB,GAAiC,MAAM,CAAC,MAAM,CAAC;IAC9E,IAAI,EAAE,qBAAqB;IAC3B,UAAU,EAAE,wBAAwB;IACpC,OAAO,EAAE,oBAAoB;IAC7B,kBAAkB,EAAE,gCAAgC;CACrD,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAC,qBAAqB,EAAyB,MAAM,qBAAqB,CAAC;AAElF,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,cAAc;IACd,gBAAgB;CACR,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5D,iBAAiB;CACT,CAAC,CAAC;AASZ,MAAM,CAAC,MAAM,oBAAoB,GAAiC,MAAM,CAAC,MAAM,CAAC;IAC9E,IAAI,EAAE,qBAAqB;IAC3B,UAAU,EAAE,wBAAwB;IACpC,OAAO,EAAE,oBAAoB;IAC7B,kBAAkB,EAAE,gCAAgC;CACrD,CAAC,CAAC"}

package/dist/realtime-runtime.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Application-level WebSocket session ownership for the server target of
+ * `velar/realtime`.
+ *
+ * The Node target still owns frames and the physical connection. This layer
+ * owns the repeatable application pattern: one bounded outbound mailbox, one
+ * writer, sequential inbound dispatch, deterministic cleanup, and one public
+ * failure policy. Codecs and business delivery guarantees remain application
+ * values.
+ */
+export declare const VELAR_SERVER_REALTIME_RUNTIME: string;
+//# sourceMappingURL=realtime-runtime.d.ts.map

package/dist/realtime-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-runtime.d.ts","sourceRoot":"","sources":["../src/realtime-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B,QAoY7B,CAAC"}

package/dist/realtime-runtime.js

@@ -0,0 +1,400 @@
+/**
+ * Application-level WebSocket session ownership for the server target of
+ * `velar/realtime`.
+ *
+ * The Node target still owns frames and the physical connection. This layer
+ * owns the repeatable application pattern: one bounded outbound mailbox, one
+ * writer, sequential inbound dispatch, deterministic cleanup, and one public
+ * failure policy. Codecs and business delivery guarantees remain application
+ * values.
+ */
+export const VELAR_SERVER_REALTIME_RUNTIME = String.raw `
+import { WebSocketClosedError as __velarRealtimeTransportClosed, WebSocketConnection as __velarRealtimeConnection } from "velar/websocket";
+
+const __velarRealtimePeers = new WeakMap();
+const __velarRealtimeApply = Reflect.apply;
+const __velarRealtimeArray = Array;
+const __velarRealtimeArrayIsArray = Array.isArray;
+const __velarRealtimeFreeze = Object.freeze;
+const __velarRealtimeGetOwnPropertyDescriptor = Object.getOwnPropertyDescriptor;
+const __velarRealtimeGetOwnPropertyNames = Object.getOwnPropertyNames;
+const __velarRealtimeArrayIncludes = Array.prototype.includes;
+const __velarRealtimeNumberIsSafeInteger = Number.isSafeInteger;
+const __velarRealtimePromise = Promise;
+const __velarRealtimePromiseReject = Promise.reject;
+const __velarRealtimePromiseThen = Promise.prototype.then;
+const __velarRealtimeStringCharCodeAt = String.prototype.charCodeAt;
+const __velarRealtimeWeakMapGet = WeakMap.prototype.get;
+const __velarRealtimeWeakMapHas = WeakMap.prototype.has;
+const __velarRealtimeWeakMapSet = WeakMap.prototype.set;
+const __velarRealtimeSetTimeout = globalThis.setTimeout;
+const __velarRealtimeClearTimeout = globalThis.clearTimeout;
+const __velarRealtimeOptionNames = __velarRealtimeFreeze(["maxQueuedMessages", "maxQueuedBytes", "drainTimeout"]);
+const __velarRealtimeDefaultQueuedMessages = 64;
+const __velarRealtimeDefaultQueuedBytes = 1024 * 1024;
+const __velarRealtimeDefaultDrainTimeout = 5000;
+
+export class RealtimeBackpressureError extends Error {
+  constructor(message = "Realtime session outbound queue is full") { super(message); this.name = "RealtimeBackpressureError"; }
+}
+
+function __velarRealtimeCall(operation, receiver, arguments_) {
+  return __velarRealtimeApply(operation, receiver, arguments_);
+}
+
+function __velarRealtimeRejected(failure) {
+  return __velarRealtimeCall(__velarRealtimePromiseReject, __velarRealtimePromise, [failure]);
+}
+
+function __velarRealtimeRecord(value, label, allowed = null) {
+  if (value === null || typeof value !== "object" || __velarRealtimeCall(__velarRealtimeArrayIsArray, Array, [value])) {
+    throw new TypeError(label + " must be a record");
+  }
+  const names = __velarRealtimeCall(__velarRealtimeGetOwnPropertyNames, Object, [value]);
+  for (let index = 0; index < names.length; index += 1) {
+    const name = names[index];
+    if (allowed !== null && !__velarRealtimeCall(__velarRealtimeArrayIncludes, allowed, [name])) throw new TypeError(label + " has unknown field '" + name + "'");
+    const descriptor = __velarRealtimeCall(__velarRealtimeGetOwnPropertyDescriptor, Object, [value, name]);
+    if (!descriptor?.enumerable || !("value" in descriptor)) throw new TypeError(label + " fields must be enumerable data values");
+  }
+  return value;
+}
+
+function __velarRealtimeOption(options, name) {
+  const descriptor = __velarRealtimeCall(__velarRealtimeGetOwnPropertyDescriptor, Object, [options, name]);
+  return descriptor && "value" in descriptor ? descriptor.value : undefined;
+}
+
+function __velarRealtimeInteger(value, fallback, minimum, maximum, label) {
+  if (value === undefined || value === null) return fallback;
+  if (!__velarRealtimeCall(__velarRealtimeNumberIsSafeInteger, Number, [value]) || value < minimum || value > maximum) {
+    throw new RangeError(label + " must be an integer from " + minimum + " through " + maximum);
+  }
+  return value;
+}
+
+function __velarRealtimeDuration(value, fallback, label) {
+  if (value === undefined || value === null) return fallback;
+  if (typeof value !== "string") throw new TypeError(label + " must be Duration");
+  const match = /^([+-]?(?:\d+(?:\.\d+)?|\.\d+))(ms|s)$/.exec(value);
+  if (!match) throw new TypeError(label + " must be Duration such as 5s");
+  const milliseconds = Number(match[1]) * (match[2] === "s" ? 1000 : 1);
+  if (!Number.isFinite(milliseconds) || milliseconds < 0 || milliseconds > 2147483647) {
+    throw new RangeError(label + " is outside the supported range");
+  }
+  return milliseconds;
+}
+
+function __velarRealtimeOptions(value = {}) {
+  const options = __velarRealtimeRecord(value, "Realtime session options", __velarRealtimeOptionNames);
+  return __velarRealtimeFreeze({
+    maxQueuedMessages: __velarRealtimeInteger(__velarRealtimeOption(options, "maxQueuedMessages"), __velarRealtimeDefaultQueuedMessages, 1, 10000, "Realtime maxQueuedMessages"),
+    maxQueuedBytes: __velarRealtimeInteger(__velarRealtimeOption(options, "maxQueuedBytes"), __velarRealtimeDefaultQueuedBytes, 1, 64 * 1024 * 1024, "Realtime maxQueuedBytes"),
+    drainTimeout: __velarRealtimeDuration(__velarRealtimeOption(options, "drainTimeout"), __velarRealtimeDefaultDrainTimeout, "Realtime drainTimeout"),
+  });
+}
+
+function __velarRealtimeCodec(value) {
+  const codec = __velarRealtimeRecord(value, "Realtime codec", ["decode", "encode"]);
+  const decode = __velarRealtimeOption(codec, "decode");
+  const encode = __velarRealtimeOption(codec, "encode");
+  if (typeof decode !== "function" || typeof encode !== "function") {
+    throw new TypeError("Realtime codec requires decode and encode functions");
+  }
+  return __velarRealtimeFreeze({decode, encode});
+}
+
+function __velarRealtimeCallback(value, label) {
+  if (value !== null && typeof value !== "function") throw new TypeError(label + " must be a function or null");
+  return value;
+}
+
+function __velarRealtimeUtf8Size(value, maximum) {
+  let size = 0;
+  for (let index = 0; index < value.length; index += 1) {
+    const code = __velarRealtimeCall(__velarRealtimeStringCharCodeAt, value, [index]);
+    if (code < 0x80) size += 1;
+    else if (code < 0x800) size += 2;
+    else if (code >= 0xd800 && code <= 0xdbff && index + 1 < value.length) {
+      const following = __velarRealtimeCall(__velarRealtimeStringCharCodeAt, value, [index + 1]);
+      if (following >= 0xdc00 && following <= 0xdfff) { size += 4; index += 1; }
+      else size += 3;
+    } else size += 3;
+    if (size > maximum) return size;
+  }
+  return size;
+}
+
+function __velarRealtimeMessage(value, label, maximum) {
+  if (typeof value === "string") {
+    const size = __velarRealtimeUtf8Size(value, maximum);
+    return size > maximum ? null : {wire: value, size};
+  }
+  if (value instanceof Uint8Array) {
+    if (value.byteLength > maximum) return null;
+    const wire = new Uint8Array(value.byteLength);
+    wire.set(value);
+    return {wire, size: wire.byteLength};
+  }
+  throw new TypeError(label + " must be text or Bytes");
+}
+
+function __velarRealtimeFailure(phase, failure, recoverable) {
+  const error = failure instanceof Error ? failure : new Error("Realtime " + phase + " failed");
+  return __velarRealtimeFreeze({phase, error, recoverable});
+}
+
+function __velarRealtimePeerState(peer) {
+  const state = __velarRealtimeCall(__velarRealtimeWeakMapGet, __velarRealtimePeers, [peer]);
+  if (!state) throw new TypeError("RealtimePeer method requires a RealtimePeer receiver");
+  return state;
+}
+
+function __velarRealtimeRejectQueued(state, failure) {
+  while (state.queueSize > 0) {
+    const entry = state.queue[state.queueHead];
+    state.queue[state.queueHead] = null;
+    state.queueHead = (state.queueHead + 1) % state.queue.length;
+    state.queueSize -= 1;
+    state.queuedBytes -= entry.size;
+    entry.reject(failure);
+  }
+  state.queueHead = 0;
+  state.queuedBytes = 0;
+}
+
+function __velarRealtimeWake(state) {
+  if (state.wake !== null) { const wake = state.wake; state.wake = null; wake(null); }
+}
+
+function __velarRealtimeEnqueue(state, value, observed) {
+  if (!state.accepting) {
+    if (observed) return __velarRealtimeRejected(new __velarRealtimeTransportClosed("Realtime session is closing"));
+    return false;
+  }
+  if (state.queueSize >= state.options.maxQueuedMessages) {
+    if (observed) return __velarRealtimeRejected(new RealtimeBackpressureError());
+    return false;
+  }
+  let message;
+  try {
+    const remaining = state.options.maxQueuedBytes - state.queuedBytes;
+    message = __velarRealtimeMessage(__velarRealtimeCall(state.codec.encode, undefined, [value]), "Realtime codec encode result", remaining);
+  }
+  catch (failure) {
+    state.writeFailure ??= __velarRealtimeFailure("encode", failure, false);
+    state.accepting = false;
+    __velarRealtimeWake(state);
+    if (observed) return __velarRealtimeRejected(state.writeFailure.error);
+    throw state.writeFailure.error;
+  }
+  if (message === null) {
+    if (observed) return __velarRealtimeRejected(new RealtimeBackpressureError());
+    return false;
+  }
+  const position = (state.queueHead + state.queueSize) % state.queue.length;
+  if (!observed) {
+    state.queue[position] = {wire: message.wire, size: message.size, resolve: () => {}, reject: () => {}};
+    state.queueSize += 1;
+    state.queuedBytes += message.size;
+    __velarRealtimeWake(state);
+    return true;
+  }
+  return new __velarRealtimePromise((resolve, reject) => {
+    state.queue[position] = {wire: message.wire, size: message.size, resolve, reject};
+    state.queueSize += 1;
+    state.queuedBytes += message.size;
+    __velarRealtimeWake(state);
+  });
+}
+
+const __velarRealtimePeerPrototype = __velarRealtimeFreeze({
+  state() {
+    const state = __velarRealtimePeerState(this);
+    if (state.done) return "closed";
+    if (!state.accepting) return "closing";
+    return "open";
+  },
+  send(value) { return __velarRealtimeEnqueue(__velarRealtimePeerState(this), value, true); },
+  trySend(value) { return __velarRealtimeEnqueue(__velarRealtimePeerState(this), value, false); },
+  close(code = 1000, reason = "") {
+    const state = __velarRealtimePeerState(this);
+    if (!__velarRealtimeCall(__velarRealtimeNumberIsSafeInteger, Number, [code]) || code < 1000 || code > 4999) {
+      return __velarRealtimeRejected(new RangeError("Realtime close code must be from 1000 through 4999"));
+    }
+    if (typeof reason !== "string" || __velarRealtimeUtf8Size(reason, 123) > 123) {
+      return __velarRealtimeRejected(new RangeError("Realtime close reason cannot exceed 123 UTF-8 bytes"));
+    }
+    if (!state.done && state.requestedClose === null) state.requestedClose = {code, reason};
+    state.accepting = false;
+    __velarRealtimeWake(state);
+    return state.closePromise;
+  },
+});
+
+function __velarRealtimeCreatePeer(connection, codec, options) {
+  let resolveClose;
+  const closePromise = new __velarRealtimePromise(resolve => { resolveClose = resolve; });
+  const peer = Object.create(__velarRealtimePeerPrototype);
+  const state = {connection, codec, options, queue: new __velarRealtimeArray(options.maxQueuedMessages), queueHead: 0, queueSize: 0, queuedBytes: 0, wake: null, accepting: true, done: false, requestedClose: null, writeFailure: null, closePromise, resolveClose};
+  __velarRealtimeCall(__velarRealtimeWeakMapSet, __velarRealtimePeers, [peer, state]);
+  return __velarRealtimeFreeze(peer);
+}
+
+function __velarRealtimeTimed(source, milliseconds) {
+  if (milliseconds === 0) return source;
+  return new __velarRealtimePromise((resolve, reject) => {
+    let settled = false;
+    const timer = __velarRealtimeSetTimeout(() => {
+      if (settled) return;
+      settled = true;
+      reject(new RealtimeBackpressureError("Realtime session did not drain before its deadline"));
+    }, milliseconds);
+    __velarRealtimeCall(__velarRealtimePromiseThen, source, [
+      value => { if (!settled) { settled = true; __velarRealtimeClearTimeout(timer); resolve(value); } },
+      failure => { if (!settled) { settled = true; __velarRealtimeClearTimeout(timer); reject(failure); } },
+    ]);
+  });
+}
+
+async function __velarRealtimeWrite(peer) {
+  const state = __velarRealtimePeerState(peer);
+  try {
+    while (state.accepting || state.queueSize > 0) {
+      if (state.queueSize === 0) {
+        await new __velarRealtimePromise(resolve => { state.wake = resolve; });
+        continue;
+      }
+      const entry = state.queue[state.queueHead];
+      state.queue[state.queueHead] = null;
+      state.queueHead = (state.queueHead + 1) % state.queue.length;
+      state.queueSize -= 1;
+      state.queuedBytes -= entry.size;
+      try {
+        await __velarRealtimeTimed(state.connection.send(entry.wire), state.options.drainTimeout);
+        entry.resolve(null);
+      } catch (failure) {
+        entry.reject(failure);
+        state.writeFailure = __velarRealtimeFailure("send", failure, false);
+        state.accepting = false;
+        __velarRealtimeRejectQueued(state, state.writeFailure.error);
+        break;
+      }
+    }
+  } finally {
+    const close = state.requestedClose ?? (state.writeFailure === null ? {code: 1000, reason: "Realtime session finished"} : {code: 1011, reason: "Realtime send failed"});
+    try { await state.connection.close(close.code, close.reason); } catch {}
+    state.resolveClose(null);
+  }
+}
+
+async function __velarRealtimeFailureAction(callback, failure, peer) {
+  if (callback === null) return "close";
+  const action = await callback(failure, peer);
+  if (action !== "continue" && action !== "close") throw new TypeError("Realtime failure callback must return RealtimeFailureAction.continue or RealtimeFailureAction.close");
+  if (!failure.recoverable && action === "continue") return "close";
+  return action;
+}
+
+export async function realtimeSession(connection, codec, receive, opened = null, failed = null, closed = null, options = {}) {
+  connection = __velarRealtimeConnection.parse(connection);
+  codec = __velarRealtimeCodec(codec);
+  if (typeof receive !== "function") throw new TypeError("realtimeSession receive must be a function");
+  opened = __velarRealtimeCallback(opened, "realtimeSession opened");
+  failed = __velarRealtimeCallback(failed, "realtimeSession failed");
+  closed = __velarRealtimeCallback(closed, "realtimeSession closed");
+  const peer = __velarRealtimeCreatePeer(connection, codec, __velarRealtimeOptions(options));
+  const state = __velarRealtimePeerState(peer);
+  const writer = __velarRealtimeWrite(peer);
+  let cleanup = null;
+  let terminalFailure = null;
+  let terminalFailureReported = false;
+  try {
+    if (opened !== null) {
+      try {
+        cleanup = await opened(peer);
+        if (cleanup !== null && typeof cleanup !== "function") throw new TypeError("realtimeSession opened must resolve to a cleanup function or null");
+      } catch (failure) {
+        terminalFailure = __velarRealtimeFailure("opened", failure, false);
+        terminalFailureReported = true;
+        try { await __velarRealtimeFailureAction(failed, terminalFailure, peer); }
+        finally { state.requestedClose = {code: 1011, reason: "Realtime session setup failed"}; }
+        return null;
+      }
+    }
+    while (state.accepting) {
+      let wire;
+      try { wire = await connection.next(); }
+      catch (failure) { terminalFailure = __velarRealtimeFailure("transport", failure, false); break; }
+      if (wire === null) break;
+      let message;
+      try { message = __velarRealtimeCall(codec.decode, undefined, [wire]); }
+      catch (failure) {
+        const decoded = __velarRealtimeFailure("decode", failure, true);
+        if (await __velarRealtimeFailureAction(failed, decoded, peer) === "continue") continue;
+        state.requestedClose = {code: 1007, reason: "Realtime message is invalid"};
+        break;
+      }
+      try { await receive(message, peer); }
+      catch (failure) {
+        const handled = __velarRealtimeFailure("receive", failure, true);
+        if (await __velarRealtimeFailureAction(failed, handled, peer) === "continue") continue;
+        state.requestedClose = {code: 1011, reason: "Realtime command failed"};
+        break;
+      }
+      if (state.writeFailure !== null) { terminalFailure = state.writeFailure; break; }
+    }
+  } finally {
+    state.accepting = false;
+    __velarRealtimeWake(state);
+    let cleanupFailure = null;
+    if (cleanup !== null) {
+      try { await cleanup(); }
+      catch (failure) { cleanupFailure = failure; }
+    }
+    try { await writer; }
+    catch (failure) { terminalFailure ??= __velarRealtimeFailure("send", failure, false); }
+    const close = await connection.closeInfo();
+    state.done = true;
+    if (terminalFailure !== null && failed !== null && terminalFailure !== state.writeFailure && !terminalFailureReported) {
+      try { await __velarRealtimeFailureAction(failed, terminalFailure, peer); } catch {}
+    }
+    if (closed !== null) await closed(peer, close);
+    if (cleanupFailure !== null) throw cleanupFailure;
+  }
+  return null;
+}
+
+const __velarRealtimePeerType = __velarRealtimeFreeze({
+  is(value) { return __velarRealtimeCall(__velarRealtimeWeakMapHas, __velarRealtimePeers, [value]); },
+  parse(value) { if (!this.is(value)) throw new TypeError("Value does not match RealtimePeer"); return value; },
+});
+const __velarRealtimeCodecType = __velarRealtimeFreeze({
+  is(value) { try { __velarRealtimeCodec(value); return true; } catch { return false; } },
+  parse(value) { return __velarRealtimeCodec(value); },
+});
+const __velarRealtimeFailureType = __velarRealtimeFreeze({
+  is(value) { return value !== null && typeof value === "object" && typeof value.phase === "string" && value.error instanceof Error && typeof value.recoverable === "boolean"; },
+  parse(value) { if (!this.is(value)) throw new TypeError("Value does not match RealtimeFailure"); return value; },
+});
+
+export const RealtimePeer = __velarRealtimeFreeze({...__velarRealtimePeerType, of() { return __velarRealtimePeerType; }});
+export const RealtimeCodec = __velarRealtimeFreeze({...__velarRealtimeCodecType, of() { return __velarRealtimeCodecType; }});
+export const RealtimeFailure = __velarRealtimeFailureType;
+export const RealtimeFailureAction = __velarRealtimeFreeze({
+  continue: "continue",
+  close: "close",
+  is(value) { return value === "continue" || value === "close"; },
+  parse(value) { if (!this.is(value)) throw new TypeError("Value does not match RealtimeFailureAction"); return value; },
+  values() { return ["continue", "close"]; },
+});
+export const RealtimePeerState = __velarRealtimeFreeze({
+  open: "open",
+  closing: "closing",
+  closed: "closed",
+  is(value) { return value === "open" || value === "closing" || value === "closed"; },
+  parse(value) { if (!this.is(value)) throw new TypeError("Value does not match RealtimePeerState"); return value; },
+  values() { return ["open", "closing", "closed"]; },
+});
+`.trimStart();
+//# sourceMappingURL=realtime-runtime.js.map

package/dist/realtime-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-runtime.js","sourceRoot":"","sources":["../src/realtime-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoYtD,CAAC,SAAS,EAAE,CAAC"}

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oBAAoB,QAgLpB,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,QAiLpB,CAAC"}

package/dist/runtime.js

@@ -177,5 +177,6 @@ export function database(connect, disconnect) {
     true,
   );
 }
+
 `.trimStart();
 //# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4EAA4E;AAC5E,sEAAsE;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgL7C,CAAC,SAAS,EAAE,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4EAA4E;AAC5E,sEAAsE;AAEtE,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiL7C,CAAC,SAAS,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velarscript/server",
-  "version": "0.18.1",
+  "version": "0.19.0",
   "description": "The official convention-based VelarScript server application framework.",
   "license": "Apache-2.0",
   "type": "module",
@@ -27,16 +27,16 @@
   "velar": {
     "extension": {
       "kind": "application",
-      "apiVersion": "0.13",
+      "apiVersion": "0.14",
       "manifestKey": "server",
       "composes": {
-        "@velarscript/node": "0.13"
+        "@velarscript/node": "0.14"
       }
     }
   },
   "dependencies": {
-    "@velarscript/compiler": "0.18.1",
-    "@velarscript/node": "0.18.1",
+    "@velarscript/compiler": "0.19.0",
+    "@velarscript/node": "0.19.0",
     "yaml": "^2.9.0"
   },
   "exports": {