@uncorded/protocol 0.1.0

package/README.md

@@ -0,0 +1,22 @@
+# @uncorded/protocol
+
+Wire protocol for UnCorded — MessagePack codec, opcodes, and branded types.
+
+> Internal dependency. Most plugin developers should install `@uncorded/plugin-server` or `@uncorded/plugin-client` instead.
+
+## Install
+
+```bash
+bun add @uncorded/protocol
+```
+
+## What's Included
+
+- **MessagePack codec** — `encode()` / `decode()` for binary WebSocket frames
+- **Opcodes** and close codes for the WebSocket protocol
+- **Branded types** — `UserId`, `ServerId`, `ChannelId`, `MessageId`, `PluginId`
+- **Zod schemas** for runtime validation of protocol messages
+
+## Docs
+
+[uncorded.app/create-plugin/docs](https://uncorded.app/create-plugin/docs)

package/dist/branded.d.ts

@@ -0,0 +1,29 @@
+type Brand<T, B extends string> = T & {
+    readonly __brand: B;
+};
+export type UserId = Brand<string, "UserId">;
+export type ServerId = Brand<string, "ServerId">;
+export type ChannelId = Brand<string, "ChannelId">;
+export type MessageId = Brand<string, "MessageId">;
+export type InviteCode = Brand<string, "InviteCode">;
+export type FileReceiptId = Brand<string, "FileReceiptId">;
+export type DmChannelId = Brand<string, "DmChannelId">;
+/** Union type for any channel ID (server channel or DM channel) */
+export type AnyChannelId = ChannelId | DmChannelId;
+export type SubscriptionId = Brand<string, "SubscriptionId">;
+export type ReportId = Brand<string, "ReportId">;
+export type RoleId = Brand<string, "RoleId">;
+export type PluginId = Brand<string, "PluginId">;
+export declare function userId(raw: string): UserId;
+export declare function serverId(raw: string): ServerId;
+export declare function channelId(raw: string): ChannelId;
+export declare function messageId(raw: string): MessageId;
+export declare function inviteCode(raw: string): InviteCode;
+export declare function fileReceiptId(raw: string): FileReceiptId;
+export declare function dmChannelId(raw: string): DmChannelId;
+export declare function subscriptionId(raw: string): SubscriptionId;
+export declare function reportId(raw: string): ReportId;
+export declare function roleId(raw: string): RoleId;
+export declare function pluginId(raw: string): PluginId;
+export {};
+//# sourceMappingURL=branded.d.ts.map

package/dist/branded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branded.d.ts","sourceRoot":"","sources":["../src/branded.ts"],"names":[],"mappings":"AAAA,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7C,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACjD,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACnD,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACnD,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AACrD,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAC3D,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AACvD,mEAAmE;AACnE,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,CAAC;AACnD,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAC7D,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACjD,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7C,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAOjD,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG1C;AACD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAG9C;AACD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAGhD;AACD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAGhD;AACD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAGlD;AACD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAGxD;AACD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAGpD;AACD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAG1D;AACD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAG9C;AACD,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG1C;AACD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAG9C"}

package/dist/branded.js

@@ -0,0 +1,50 @@
+// Cast constructors (brand raw strings at application boundaries)
+function assertNonEmpty(raw, label) {
+    if (!raw)
+        throw new Error(`${label} must not be empty`);
+}
+export function userId(raw) {
+    assertNonEmpty(raw, "UserId");
+    return raw;
+}
+export function serverId(raw) {
+    assertNonEmpty(raw, "ServerId");
+    return raw;
+}
+export function channelId(raw) {
+    assertNonEmpty(raw, "ChannelId");
+    return raw;
+}
+export function messageId(raw) {
+    assertNonEmpty(raw, "MessageId");
+    return raw;
+}
+export function inviteCode(raw) {
+    assertNonEmpty(raw, "InviteCode");
+    return raw;
+}
+export function fileReceiptId(raw) {
+    assertNonEmpty(raw, "FileReceiptId");
+    return raw;
+}
+export function dmChannelId(raw) {
+    assertNonEmpty(raw, "DmChannelId");
+    return raw;
+}
+export function subscriptionId(raw) {
+    assertNonEmpty(raw, "SubscriptionId");
+    return raw;
+}
+export function reportId(raw) {
+    assertNonEmpty(raw, "ReportId");
+    return raw;
+}
+export function roleId(raw) {
+    assertNonEmpty(raw, "RoleId");
+    return raw;
+}
+export function pluginId(raw) {
+    assertNonEmpty(raw, "PluginId");
+    return raw;
+}
+//# sourceMappingURL=branded.js.map

package/dist/branded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branded.js","sourceRoot":"","sources":["../src/branded.ts"],"names":[],"mappings":"AAgBA,kEAAkE;AAClE,SAAS,cAAc,CAAC,GAAW,EAAE,KAAa;IAChD,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC9B,OAAO,GAAa,CAAC;AACvB,CAAC;AACD,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,cAAc,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAChC,OAAO,GAAe,CAAC;AACzB,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACjC,OAAO,GAAgB,CAAC;AAC1B,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACjC,OAAO,GAAgB,CAAC;AAC1B,CAAC;AACD,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,cAAc,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAClC,OAAO,GAAiB,CAAC;AAC3B,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,cAAc,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IACrC,OAAO,GAAoB,CAAC;AAC9B,CAAC;AACD,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,cAAc,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACnC,OAAO,GAAkB,CAAC;AAC5B,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,cAAc,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IACtC,OAAO,GAAqB,CAAC;AAC/B,CAAC;AACD,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,cAAc,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAChC,OAAO,GAAe,CAAC;AACzB,CAAC;AACD,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC9B,OAAO,GAAa,CAAC;AACvB,CAAC;AACD,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,cAAc,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAChC,OAAO,GAAe,CAAC;AACzB,CAAC"}

package/dist/close-codes.d.ts

@@ -0,0 +1,21 @@
+export declare enum CloseCode {
+    /** Frame was a string, expected binary MessagePack */
+    NOT_BINARY = 4001,
+    /** Failed to decode MessagePack frame */
+    INVALID_FRAME = 4002,
+    /** Client sent IDENTIFY twice */
+    ALREADY_IDENTIFIED = 4003,
+    /** IDENTIFY payload missing token */
+    MISSING_TOKEN = 4004,
+    /** Session token invalid or expired */
+    INVALID_SESSION = 4005,
+    /** Client sent opcode before IDENTIFY */
+    NOT_IDENTIFIED = 4006,
+    /** Client did not receive HEARTBEAT_ACK within timeout */
+    HEARTBEAT_TIMEOUT = 4007,
+    /** Server-side session/context changed — client should reconnect to refresh */
+    SESSION_UPDATED = 4010,
+    /** Account was permanently deleted — client should not reconnect */
+    ACCOUNT_DELETED = 4011
+}
+//# sourceMappingURL=close-codes.d.ts.map

package/dist/close-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-codes.d.ts","sourceRoot":"","sources":["../src/close-codes.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS;IACnB,sDAAsD;IACtD,UAAU,OAAO;IACjB,yCAAyC;IACzC,aAAa,OAAO;IACpB,iCAAiC;IACjC,kBAAkB,OAAO;IACzB,qCAAqC;IACrC,aAAa,OAAO;IACpB,uCAAuC;IACvC,eAAe,OAAO;IACtB,yCAAyC;IACzC,cAAc,OAAO;IACrB,0DAA0D;IAC1D,iBAAiB,OAAO;IACxB,+EAA+E;IAC/E,eAAe,OAAO;IACtB,oEAAoE;IACpE,eAAe,OAAO;CACvB"}

package/dist/close-codes.js

@@ -0,0 +1,22 @@
+export var CloseCode;
+(function (CloseCode) {
+    /** Frame was a string, expected binary MessagePack */
+    CloseCode[CloseCode["NOT_BINARY"] = 4001] = "NOT_BINARY";
+    /** Failed to decode MessagePack frame */
+    CloseCode[CloseCode["INVALID_FRAME"] = 4002] = "INVALID_FRAME";
+    /** Client sent IDENTIFY twice */
+    CloseCode[CloseCode["ALREADY_IDENTIFIED"] = 4003] = "ALREADY_IDENTIFIED";
+    /** IDENTIFY payload missing token */
+    CloseCode[CloseCode["MISSING_TOKEN"] = 4004] = "MISSING_TOKEN";
+    /** Session token invalid or expired */
+    CloseCode[CloseCode["INVALID_SESSION"] = 4005] = "INVALID_SESSION";
+    /** Client sent opcode before IDENTIFY */
+    CloseCode[CloseCode["NOT_IDENTIFIED"] = 4006] = "NOT_IDENTIFIED";
+    /** Client did not receive HEARTBEAT_ACK within timeout */
+    CloseCode[CloseCode["HEARTBEAT_TIMEOUT"] = 4007] = "HEARTBEAT_TIMEOUT";
+    /** Server-side session/context changed — client should reconnect to refresh */
+    CloseCode[CloseCode["SESSION_UPDATED"] = 4010] = "SESSION_UPDATED";
+    /** Account was permanently deleted — client should not reconnect */
+    CloseCode[CloseCode["ACCOUNT_DELETED"] = 4011] = "ACCOUNT_DELETED";
+})(CloseCode || (CloseCode = {}));
+//# sourceMappingURL=close-codes.js.map

package/dist/close-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-codes.js","sourceRoot":"","sources":["../src/close-codes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,SAmBX;AAnBD,WAAY,SAAS;IACnB,sDAAsD;IACtD,wDAAiB,CAAA;IACjB,yCAAyC;IACzC,8DAAoB,CAAA;IACpB,iCAAiC;IACjC,wEAAyB,CAAA;IACzB,qCAAqC;IACrC,8DAAoB,CAAA;IACpB,uCAAuC;IACvC,kEAAsB,CAAA;IACtB,yCAAyC;IACzC,gEAAqB,CAAA;IACrB,0DAA0D;IAC1D,sEAAwB,CAAA;IACxB,+EAA+E;IAC/E,kEAAsB,CAAA;IACtB,oEAAoE;IACpE,kEAAsB,CAAA;AACxB,CAAC,EAnBW,SAAS,KAAT,SAAS,QAmBpB"}

package/dist/codec.d.ts

@@ -0,0 +1,12 @@
+import { type DecoderOptions } from "@msgpack/msgpack";
+import type { Opcode } from "./opcodes.js";
+export interface GatewayFrame {
+    op: Opcode;
+    d: unknown;
+}
+export declare function encode(frame: GatewayFrame): Uint8Array;
+/** Tighter limits for client-side decoding (browser memory is more constrained). */
+export declare const CLIENT_DECODE_OPTIONS: DecoderOptions;
+export declare function decode(data: ArrayLike<number> | BufferSource): GatewayFrame;
+export declare function decodeClient(data: ArrayLike<number> | BufferSource): GatewayFrame;
+//# sourceMappingURL=codec.d.ts.map

package/dist/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAU3C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,OAAO,CAAC;CACZ;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,CAEtD;AAED,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,EAAE,cAKnC,CAAC;AAEF,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,YAAY,GAAG,YAAY,CAY3E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,YAAY,GAAG,YAAY,CAYjF"}

package/dist/codec.js

@@ -0,0 +1,41 @@
+import { encode as msgpackEncode, decode as msgpackDecode, } from "@msgpack/msgpack";
+/** Prevent OOM DoS — reject payloads with oversized strings/arrays/maps. */
+const DECODE_OPTIONS = {
+    maxStrLength: 65_536,
+    maxBinLength: 65_536,
+    maxArrayLength: 10_000, // READY sends all channels across all servers; 100×50=5000, 2× headroom
+    maxMapLength: 500, // largest map is READY d object with nested server/channel/friend objects
+};
+export function encode(frame) {
+    return msgpackEncode(frame);
+}
+/** Tighter limits for client-side decoding (browser memory is more constrained). */
+export const CLIENT_DECODE_OPTIONS = {
+    maxStrLength: 16_384,
+    maxBinLength: 16_384,
+    maxArrayLength: 2_000,
+    maxMapLength: 200,
+};
+export function decode(data) {
+    const result = msgpackDecode(data, DECODE_OPTIONS);
+    if (typeof result !== "object" ||
+        result === null ||
+        !("op" in result) ||
+        typeof result.op !== "number" ||
+        !("d" in result)) {
+        throw new Error("Invalid GatewayFrame: missing op or d");
+    }
+    return result;
+}
+export function decodeClient(data) {
+    const result = msgpackDecode(data, CLIENT_DECODE_OPTIONS);
+    if (typeof result !== "object" ||
+        result === null ||
+        !("op" in result) ||
+        typeof result.op !== "number" ||
+        !("d" in result)) {
+        throw new Error("Invalid GatewayFrame: missing op or d");
+    }
+    return result;
+}
+//# sourceMappingURL=codec.js.map

package/dist/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,IAAI,aAAa,EACvB,MAAM,IAAI,aAAa,GAExB,MAAM,kBAAkB,CAAC;AAG1B,4EAA4E;AAC5E,MAAM,cAAc,GAAmB;IACrC,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,MAAM;IACpB,cAAc,EAAE,MAAM,EAAE,wEAAwE;IAChG,YAAY,EAAE,GAAG,EAAE,0EAA0E;CAC9F,CAAC;AAOF,MAAM,UAAU,MAAM,CAAC,KAAmB;IACxC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,MAAM;IACpB,cAAc,EAAE,KAAK;IACrB,YAAY,EAAE,GAAG;CAClB,CAAC;AAEF,MAAM,UAAU,MAAM,CAAC,IAAsC;IAC3D,MAAM,MAAM,GAAG,aAAa,CAAC,IAAkB,EAAE,cAAc,CAAC,CAAC;IACjE,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC;QACjB,OAAQ,MAAkC,CAAC,EAAE,KAAK,QAAQ;QAC1D,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,EAChB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAsB,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAsC;IACjE,MAAM,MAAM,GAAG,aAAa,CAAC,IAAkB,EAAE,qBAAqB,CAAC,CAAC;IACxE,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC;QACjB,OAAQ,MAAkC,CAAC,EAAE,KAAK,QAAQ;QAC1D,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,EAChB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAsB,CAAC;AAChC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { Opcode } from "./opcodes.js";
+export { CloseCode } from "./close-codes.js";
+export { encode, decode, decodeClient, CLIENT_DECODE_OPTIONS } from "./codec.js";
+export type { GatewayFrame } from "./codec.js";
+export * from "./branded.js";
+export type { WebRtcSignalPayload, FileShareRequest, FileShareBroadcast, FileAvailabilityPayload, FileSessionCreatePayload, FileSessionInvitePayload, FileSessionJoinPayload, FileSessionJoinAcceptPayload, FileSessionJoinedPayload, FileSessionProgressPayload, FileSessionCompletePayload, FileSessionClosePayload, FileSessionLeavePayload, } from "./signaling.js";
+export * from "./schemas.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACjF,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,cAAc,cAAc,CAAC;AAC7B,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { Opcode } from "./opcodes.js";
+export { CloseCode } from "./close-codes.js";
+export { encode, decode, decodeClient, CLIENT_DECODE_OPTIONS } from "./codec.js";
+export * from "./branded.js";
+export * from "./schemas.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEjF,cAAc,cAAc,CAAC;AAgB7B,cAAc,cAAc,CAAC"}

package/dist/opcodes.d.ts

@@ -0,0 +1,81 @@
+export declare enum Opcode {
+    /** Server -> Client: heartbeat interval */
+    HELLO = 0,
+    /** Client -> Server: heartbeat acknowledgement */
+    HEARTBEAT = 1,
+    /** Client -> Server: session token */
+    IDENTIFY = 2,
+    /** Server -> Client: user, servers, channels */
+    READY = 3,
+    /** Server -> Client: heartbeat acknowledged */
+    HEARTBEAT_ACK = 4,
+    /** Both: new message */
+    MESSAGE_CREATE = 10,
+    /** Both: edited message */
+    MESSAGE_UPDATE = 11,
+    /** Both: deleted message */
+    MESSAGE_DELETE = 12,
+    /** Both: user started typing */
+    TYPING_START = 13,
+    /** Both: presence change */
+    PRESENCE_UPDATE = 20,
+    /** Client -> Server: WebRTC SDP offer for P2P connection */
+    WEBRTC_OFFER = 30,
+    /** Client -> Server: WebRTC SDP answer in response to offer */
+    WEBRTC_ANSWER = 31,
+    /** Client -> Server: WebRTC ICE candidate for NAT traversal */
+    WEBRTC_ICE_CANDIDATE = 32,
+    /** Client -> Server: file shared via P2P (stores receipt, broadcasts to channel) */
+    FILE_SHARE = 33,
+    /** Client -> Server: seeder availability changed for a file */
+    FILE_AVAILABILITY_UPDATE = 34,
+    /** Server -> Client: channel created */
+    CHANNEL_CREATE = 40,
+    /** Server -> Client: channel updated */
+    CHANNEL_UPDATE = 41,
+    /** Server -> Client: channel deleted */
+    CHANNEL_DELETE = 42,
+    /** Server -> Client: member added */
+    MEMBER_ADD = 50,
+    /** Server -> Client: member removed */
+    MEMBER_REMOVE = 51,
+    /** Server -> Client: server created */
+    SERVER_CREATE = 60,
+    /** Server -> Client: server deleted */
+    SERVER_DELETE = 61,
+    /** Server -> Client: server updated (name, icon, owner) */
+    SERVER_UPDATE = 62,
+    /** Server -> Client: friend request received */
+    FRIEND_REQUEST = 70,
+    /** Server -> Client: friend request accepted */
+    FRIEND_ACCEPT = 71,
+    /** Server -> Client: friend removed */
+    FRIEND_REMOVE = 72,
+    /** Server -> Client: DM channel created */
+    DM_CHANNEL_CREATE = 80,
+    /** Server -> Client: subscription tier was gifted */
+    SUBSCRIPTION_GIFT = 85,
+    /** Server -> Client: account deletion countdown started */
+    ACCOUNT_DELETION_PENDING = 90,
+    /** Server -> Client: account deletion was cancelled */
+    ACCOUNT_DELETION_CANCELLED = 91,
+    /** Server -> Client: error notification (e.g., tier restriction) */
+    ERROR = 99,
+    /** Sender -> Server: create a share session */
+    FILE_SESSION_CREATE = 100,
+    /** Server -> Recipients: you've been invited to a share session */
+    FILE_SESSION_INVITE = 101,
+    /** Recipient -> Server: joining the share session */
+    FILE_SESSION_JOIN = 102,
+    /** Server -> Sender: a user joined the session */
+    FILE_SESSION_JOINED = 103,
+    /** Recipient -> Server -> Sender: download progress update */
+    FILE_SESSION_PROGRESS = 104,
+    /** Recipient -> Server -> Sender: download complete */
+    FILE_SESSION_COMPLETE = 105,
+    /** Sender -> Server -> All: session ended */
+    FILE_SESSION_CLOSE = 106,
+    /** Recipient -> Server -> Sender: user left the session */
+    FILE_SESSION_LEAVE = 107
+}
+//# sourceMappingURL=opcodes.d.ts.map

package/dist/opcodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opcodes.d.ts","sourceRoot":"","sources":["../src/opcodes.ts"],"names":[],"mappings":"AAAA,oBAAY,MAAM;IAChB,2CAA2C;IAC3C,KAAK,IAAI;IACT,kDAAkD;IAClD,SAAS,IAAI;IACb,sCAAsC;IACtC,QAAQ,IAAI;IACZ,gDAAgD;IAChD,KAAK,IAAI;IACT,+CAA+C;IAC/C,aAAa,IAAI;IAEjB,wBAAwB;IACxB,cAAc,KAAK;IACnB,2BAA2B;IAC3B,cAAc,KAAK;IACnB,4BAA4B;IAC5B,cAAc,KAAK;IACnB,gCAAgC;IAChC,YAAY,KAAK;IAEjB,4BAA4B;IAC5B,eAAe,KAAK;IAEpB,4DAA4D;IAC5D,YAAY,KAAK;IACjB,+DAA+D;IAC/D,aAAa,KAAK;IAClB,+DAA+D;IAC/D,oBAAoB,KAAK;IACzB,oFAAoF;IACpF,UAAU,KAAK;IACf,+DAA+D;IAC/D,wBAAwB,KAAK;IAE7B,wCAAwC;IACxC,cAAc,KAAK;IACnB,wCAAwC;IACxC,cAAc,KAAK;IACnB,wCAAwC;IACxC,cAAc,KAAK;IAEnB,qCAAqC;IACrC,UAAU,KAAK;IACf,uCAAuC;IACvC,aAAa,KAAK;IAElB,uCAAuC;IACvC,aAAa,KAAK;IAClB,uCAAuC;IACvC,aAAa,KAAK;IAClB,2DAA2D;IAC3D,aAAa,KAAK;IAElB,gDAAgD;IAChD,cAAc,KAAK;IACnB,gDAAgD;IAChD,aAAa,KAAK;IAClB,uCAAuC;IACvC,aAAa,KAAK;IAElB,2CAA2C;IAC3C,iBAAiB,KAAK;IAEtB,qDAAqD;IACrD,iBAAiB,KAAK;IAEtB,2DAA2D;IAC3D,wBAAwB,KAAK;IAC7B,uDAAuD;IACvD,0BAA0B,KAAK;IAE/B,oEAAoE;IACpE,KAAK,KAAK;IAIV,+CAA+C;IAC/C,mBAAmB,MAAM;IACzB,mEAAmE;IACnE,mBAAmB,MAAM;IACzB,qDAAqD;IACrD,iBAAiB,MAAM;IACvB,kDAAkD;IAClD,mBAAmB,MAAM;IACzB,8DAA8D;IAC9D,qBAAqB,MAAM;IAC3B,uDAAuD;IACvD,qBAAqB,MAAM;IAC3B,6CAA6C;IAC7C,kBAAkB,MAAM;IACxB,2DAA2D;IAC3D,kBAAkB,MAAM;CACzB"}

package/dist/opcodes.js

@@ -0,0 +1,83 @@
+export var Opcode;
+(function (Opcode) {
+    /** Server -> Client: heartbeat interval */
+    Opcode[Opcode["HELLO"] = 0] = "HELLO";
+    /** Client -> Server: heartbeat acknowledgement */
+    Opcode[Opcode["HEARTBEAT"] = 1] = "HEARTBEAT";
+    /** Client -> Server: session token */
+    Opcode[Opcode["IDENTIFY"] = 2] = "IDENTIFY";
+    /** Server -> Client: user, servers, channels */
+    Opcode[Opcode["READY"] = 3] = "READY";
+    /** Server -> Client: heartbeat acknowledged */
+    Opcode[Opcode["HEARTBEAT_ACK"] = 4] = "HEARTBEAT_ACK";
+    /** Both: new message */
+    Opcode[Opcode["MESSAGE_CREATE"] = 10] = "MESSAGE_CREATE";
+    /** Both: edited message */
+    Opcode[Opcode["MESSAGE_UPDATE"] = 11] = "MESSAGE_UPDATE";
+    /** Both: deleted message */
+    Opcode[Opcode["MESSAGE_DELETE"] = 12] = "MESSAGE_DELETE";
+    /** Both: user started typing */
+    Opcode[Opcode["TYPING_START"] = 13] = "TYPING_START";
+    /** Both: presence change */
+    Opcode[Opcode["PRESENCE_UPDATE"] = 20] = "PRESENCE_UPDATE";
+    /** Client -> Server: WebRTC SDP offer for P2P connection */
+    Opcode[Opcode["WEBRTC_OFFER"] = 30] = "WEBRTC_OFFER";
+    /** Client -> Server: WebRTC SDP answer in response to offer */
+    Opcode[Opcode["WEBRTC_ANSWER"] = 31] = "WEBRTC_ANSWER";
+    /** Client -> Server: WebRTC ICE candidate for NAT traversal */
+    Opcode[Opcode["WEBRTC_ICE_CANDIDATE"] = 32] = "WEBRTC_ICE_CANDIDATE";
+    /** Client -> Server: file shared via P2P (stores receipt, broadcasts to channel) */
+    Opcode[Opcode["FILE_SHARE"] = 33] = "FILE_SHARE";
+    /** Client -> Server: seeder availability changed for a file */
+    Opcode[Opcode["FILE_AVAILABILITY_UPDATE"] = 34] = "FILE_AVAILABILITY_UPDATE";
+    /** Server -> Client: channel created */
+    Opcode[Opcode["CHANNEL_CREATE"] = 40] = "CHANNEL_CREATE";
+    /** Server -> Client: channel updated */
+    Opcode[Opcode["CHANNEL_UPDATE"] = 41] = "CHANNEL_UPDATE";
+    /** Server -> Client: channel deleted */
+    Opcode[Opcode["CHANNEL_DELETE"] = 42] = "CHANNEL_DELETE";
+    /** Server -> Client: member added */
+    Opcode[Opcode["MEMBER_ADD"] = 50] = "MEMBER_ADD";
+    /** Server -> Client: member removed */
+    Opcode[Opcode["MEMBER_REMOVE"] = 51] = "MEMBER_REMOVE";
+    /** Server -> Client: server created */
+    Opcode[Opcode["SERVER_CREATE"] = 60] = "SERVER_CREATE";
+    /** Server -> Client: server deleted */
+    Opcode[Opcode["SERVER_DELETE"] = 61] = "SERVER_DELETE";
+    /** Server -> Client: server updated (name, icon, owner) */
+    Opcode[Opcode["SERVER_UPDATE"] = 62] = "SERVER_UPDATE";
+    /** Server -> Client: friend request received */
+    Opcode[Opcode["FRIEND_REQUEST"] = 70] = "FRIEND_REQUEST";
+    /** Server -> Client: friend request accepted */
+    Opcode[Opcode["FRIEND_ACCEPT"] = 71] = "FRIEND_ACCEPT";
+    /** Server -> Client: friend removed */
+    Opcode[Opcode["FRIEND_REMOVE"] = 72] = "FRIEND_REMOVE";
+    /** Server -> Client: DM channel created */
+    Opcode[Opcode["DM_CHANNEL_CREATE"] = 80] = "DM_CHANNEL_CREATE";
+    /** Server -> Client: subscription tier was gifted */
+    Opcode[Opcode["SUBSCRIPTION_GIFT"] = 85] = "SUBSCRIPTION_GIFT";
+    /** Server -> Client: account deletion countdown started */
+    Opcode[Opcode["ACCOUNT_DELETION_PENDING"] = 90] = "ACCOUNT_DELETION_PENDING";
+    /** Server -> Client: account deletion was cancelled */
+    Opcode[Opcode["ACCOUNT_DELETION_CANCELLED"] = 91] = "ACCOUNT_DELETION_CANCELLED";
+    /** Server -> Client: error notification (e.g., tier restriction) */
+    Opcode[Opcode["ERROR"] = 99] = "ERROR";
+    // ── File Share Sessions (DM P2P) ──────────────────────────────────────────
+    /** Sender -> Server: create a share session */
+    Opcode[Opcode["FILE_SESSION_CREATE"] = 100] = "FILE_SESSION_CREATE";
+    /** Server -> Recipients: you've been invited to a share session */
+    Opcode[Opcode["FILE_SESSION_INVITE"] = 101] = "FILE_SESSION_INVITE";
+    /** Recipient -> Server: joining the share session */
+    Opcode[Opcode["FILE_SESSION_JOIN"] = 102] = "FILE_SESSION_JOIN";
+    /** Server -> Sender: a user joined the session */
+    Opcode[Opcode["FILE_SESSION_JOINED"] = 103] = "FILE_SESSION_JOINED";
+    /** Recipient -> Server -> Sender: download progress update */
+    Opcode[Opcode["FILE_SESSION_PROGRESS"] = 104] = "FILE_SESSION_PROGRESS";
+    /** Recipient -> Server -> Sender: download complete */
+    Opcode[Opcode["FILE_SESSION_COMPLETE"] = 105] = "FILE_SESSION_COMPLETE";
+    /** Sender -> Server -> All: session ended */
+    Opcode[Opcode["FILE_SESSION_CLOSE"] = 106] = "FILE_SESSION_CLOSE";
+    /** Recipient -> Server -> Sender: user left the session */
+    Opcode[Opcode["FILE_SESSION_LEAVE"] = 107] = "FILE_SESSION_LEAVE";
+})(Opcode || (Opcode = {}));
+//# sourceMappingURL=opcodes.js.map

package/dist/opcodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opcodes.js","sourceRoot":"","sources":["../src/opcodes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,MA6FX;AA7FD,WAAY,MAAM;IAChB,2CAA2C;IAC3C,qCAAS,CAAA;IACT,kDAAkD;IAClD,6CAAa,CAAA;IACb,sCAAsC;IACtC,2CAAY,CAAA;IACZ,gDAAgD;IAChD,qCAAS,CAAA;IACT,+CAA+C;IAC/C,qDAAiB,CAAA;IAEjB,wBAAwB;IACxB,wDAAmB,CAAA;IACnB,2BAA2B;IAC3B,wDAAmB,CAAA;IACnB,4BAA4B;IAC5B,wDAAmB,CAAA;IACnB,gCAAgC;IAChC,oDAAiB,CAAA;IAEjB,4BAA4B;IAC5B,0DAAoB,CAAA;IAEpB,4DAA4D;IAC5D,oDAAiB,CAAA;IACjB,+DAA+D;IAC/D,sDAAkB,CAAA;IAClB,+DAA+D;IAC/D,oEAAyB,CAAA;IACzB,oFAAoF;IACpF,gDAAe,CAAA;IACf,+DAA+D;IAC/D,4EAA6B,CAAA;IAE7B,wCAAwC;IACxC,wDAAmB,CAAA;IACnB,wCAAwC;IACxC,wDAAmB,CAAA;IACnB,wCAAwC;IACxC,wDAAmB,CAAA;IAEnB,qCAAqC;IACrC,gDAAe,CAAA;IACf,uCAAuC;IACvC,sDAAkB,CAAA;IAElB,uCAAuC;IACvC,sDAAkB,CAAA;IAClB,uCAAuC;IACvC,sDAAkB,CAAA;IAClB,2DAA2D;IAC3D,sDAAkB,CAAA;IAElB,gDAAgD;IAChD,wDAAmB,CAAA;IACnB,gDAAgD;IAChD,sDAAkB,CAAA;IAClB,uCAAuC;IACvC,sDAAkB,CAAA;IAElB,2CAA2C;IAC3C,8DAAsB,CAAA;IAEtB,qDAAqD;IACrD,8DAAsB,CAAA;IAEtB,2DAA2D;IAC3D,4EAA6B,CAAA;IAC7B,uDAAuD;IACvD,gFAA+B,CAAA;IAE/B,oEAAoE;IACpE,sCAAU,CAAA;IAEV,6EAA6E;IAE7E,+CAA+C;IAC/C,mEAAyB,CAAA;IACzB,mEAAmE;IACnE,mEAAyB,CAAA;IACzB,qDAAqD;IACrD,+DAAuB,CAAA;IACvB,kDAAkD;IAClD,mEAAyB,CAAA;IACzB,8DAA8D;IAC9D,uEAA2B,CAAA;IAC3B,uDAAuD;IACvD,uEAA2B,CAAA;IAC3B,6CAA6C;IAC7C,iEAAwB,CAAA;IACxB,2DAA2D;IAC3D,iEAAwB,CAAA;AAC1B,CAAC,EA7FW,MAAM,KAAN,MAAM,QA6FjB"}