@graphorin/protocol 0.5.0

package/dist/client-message.js

@@ -0,0 +1,128 @@
+import { z } from "zod";
+
+//#region src/client-message.ts
+/**
+* `ClientMessage` — discriminated union of every frame a Graphorin
+* WebSocket client may send to the server. The wire is hybrid: the
+* control plane uses JSON-RPC-shaped requests / notifications; the
+* data plane uses typed push events emitted exclusively by the server
+* (see `./server-message.ts`).
+*
+* Every frame carries the `v: '1'` literal so future revisions can
+* negotiate forward-compatible additions without a subprotocol bump.
+* The matching subprotocol identifier is `graphorin.protocol.v1`
+* (see `./subprotocol.ts`).
+*
+* @packageDocumentation
+*/
+const RpcId = z.union([z.string().min(1), z.number().int()]);
+const InitializeParams = z.object({
+	clientInfo: z.object({
+		name: z.string().min(1),
+		version: z.string().min(1)
+	}).strict(),
+	capabilities: z.record(z.string(), z.unknown()).optional()
+}).strict();
+const SubscribeParams = z.object({
+	subject: z.string().min(1),
+	sinceEventId: z.string().min(1).optional()
+}).strict();
+const UnsubscribeParams = z.object({ subscriptionId: z.string().min(1) }).strict();
+const RunCancelParams = z.object({
+	runId: z.string().min(1),
+	reason: z.string().min(1).optional(),
+	drain: z.boolean().optional(),
+	onPendingApprovals: z.enum(["deny", "preserve"]).optional()
+}).strict();
+const PingParams = z.object({ nonce: z.string().min(1).optional() }).strict().optional();
+const InitializeRequest = z.object({
+	v: z.literal("1"),
+	jsonrpc: z.literal("2.0"),
+	id: RpcId,
+	method: z.literal("initialize"),
+	params: InitializeParams
+}).strict();
+const SubscribeRequest = z.object({
+	v: z.literal("1"),
+	jsonrpc: z.literal("2.0"),
+	id: RpcId,
+	method: z.literal("subscription.subscribe"),
+	params: SubscribeParams
+}).strict();
+const UnsubscribeRequest = z.object({
+	v: z.literal("1"),
+	jsonrpc: z.literal("2.0"),
+	id: RpcId,
+	method: z.literal("subscription.unsubscribe"),
+	params: UnsubscribeParams
+}).strict();
+const RunCancelRequest = z.object({
+	v: z.literal("1"),
+	jsonrpc: z.literal("2.0"),
+	id: RpcId,
+	method: z.literal("run.cancel"),
+	params: RunCancelParams
+}).strict();
+const PingRequest = z.object({
+	v: z.literal("1"),
+	jsonrpc: z.literal("2.0"),
+	id: RpcId,
+	method: z.literal("ping"),
+	params: PingParams
+}).strict();
+const CancelledNotification = z.object({
+	v: z.literal("1"),
+	jsonrpc: z.literal("2.0"),
+	method: z.literal("notifications/cancelled"),
+	params: z.object({ requestId: z.string().min(1) }).strict()
+}).strict();
+/**
+* Zod schema for every legal client → server frame. Use
+* {@link ClientMessageSchema}.safeParse() inside the server upgrade
+* handler before dispatching to the corresponding subscription /
+* cancel / ping handler.
+*
+* @stable
+*/
+const ClientMessageSchema = z.discriminatedUnion("method", [
+	InitializeRequest,
+	SubscribeRequest,
+	UnsubscribeRequest,
+	RunCancelRequest,
+	PingRequest,
+	CancelledNotification
+]);
+/**
+* Type guard helpers — one per `method` literal — so consumers can
+* narrow the `ClientMessage` union without re-stringifying the
+* discriminator.
+*
+* @stable
+*/
+function isInitializeRequest(message) {
+	return message.method === "initialize";
+}
+/** @stable */
+function isSubscribeRequest(message) {
+	return message.method === "subscription.subscribe";
+}
+/** @stable */
+function isUnsubscribeRequest(message) {
+	return message.method === "subscription.unsubscribe";
+}
+/** @stable */
+function isRunCancelRequest(message) {
+	return message.method === "run.cancel";
+}
+/** @stable */
+function isPingRequest(message) {
+	return message.method === "ping";
+}
+/** @stable */
+function isCancelledNotification(message) {
+	return message.method === "notifications/cancelled";
+}
+
+//#endregion
+export { ClientMessageSchema, isCancelledNotification, isInitializeRequest, isPingRequest, isRunCancelRequest, isSubscribeRequest, isUnsubscribeRequest };
+//# sourceMappingURL=client-message.js.map

package/dist/client-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-message.js","names":[],"sources":["../src/client-message.ts"],"sourcesContent":["/**\n * `ClientMessage` — discriminated union of every frame a Graphorin\n * WebSocket client may send to the server. The wire is hybrid: the\n * control plane uses JSON-RPC-shaped requests / notifications; the\n * data plane uses typed push events emitted exclusively by the server\n * (see `./server-message.ts`).\n *\n * Every frame carries the `v: '1'` literal so future revisions can\n * negotiate forward-compatible additions without a subprotocol bump.\n * The matching subprotocol identifier is `graphorin.protocol.v1`\n * (see `./subprotocol.ts`).\n *\n * @packageDocumentation\n */\n\nimport { z } from 'zod';\n\nconst RpcId = z.union([z.string().min(1), z.number().int()]);\n\nconst InitializeParams = z\n  .object({\n    clientInfo: z\n      .object({\n        name: z.string().min(1),\n        version: z.string().min(1),\n      })\n      .strict(),\n    capabilities: z.record(z.string(), z.unknown()).optional(),\n  })\n  .strict();\n\nconst SubscribeParams = z\n  .object({\n    subject: z.string().min(1),\n    // IP-21: `sinceEventId` is the resumption cursor. `lastSequenceId` was a\n    // dead wire field — the client never set it and the server never read it.\n    sinceEventId: z.string().min(1).optional(),\n  })\n  .strict();\n\nconst UnsubscribeParams = z\n  .object({\n    subscriptionId: z.string().min(1),\n  })\n  .strict();\n\nconst RunCancelParams = z\n  .object({\n    runId: z.string().min(1),\n    reason: z.string().min(1).optional(),\n    drain: z.boolean().optional(),\n    onPendingApprovals: z.enum(['deny', 'preserve']).optional(),\n  })\n  .strict();\n\nconst PingParams = z\n  .object({\n    nonce: z.string().min(1).optional(),\n  })\n  .strict()\n  .optional();\n\nconst InitializeRequest = z\n  .object({\n    v: z.literal('1'),\n    jsonrpc: z.literal('2.0'),\n    id: RpcId,\n    method: z.literal('initialize'),\n    params: InitializeParams,\n  })\n  .strict();\n\nconst SubscribeRequest = z\n  .object({\n    v: z.literal('1'),\n    jsonrpc: z.literal('2.0'),\n    id: RpcId,\n    method: z.literal('subscription.subscribe'),\n    params: SubscribeParams,\n  })\n  .strict();\n\nconst UnsubscribeRequest = z\n  .object({\n    v: z.literal('1'),\n    jsonrpc: z.literal('2.0'),\n    id: RpcId,\n    method: z.literal('subscription.unsubscribe'),\n    params: UnsubscribeParams,\n  })\n  .strict();\n\nconst RunCancelRequest = z\n  .object({\n    v: z.literal('1'),\n    jsonrpc: z.literal('2.0'),\n    id: RpcId,\n    method: z.literal('run.cancel'),\n    params: RunCancelParams,\n  })\n  .strict();\n\nconst PingRequest = z\n  .object({\n    v: z.literal('1'),\n    jsonrpc: z.literal('2.0'),\n    id: RpcId,\n    method: z.literal('ping'),\n    params: PingParams,\n  })\n  .strict();\n\nconst CancelledNotification = z\n  .object({\n    v: z.literal('1'),\n    jsonrpc: z.literal('2.0'),\n    method: z.literal('notifications/cancelled'),\n    params: z.object({ requestId: z.string().min(1) }).strict(),\n  })\n  .strict();\n\n/**\n * Zod schema for every legal client → server frame. Use\n * {@link ClientMessageSchema}.safeParse() inside the server upgrade\n * handler before dispatching to the corresponding subscription /\n * cancel / ping handler.\n *\n * @stable\n */\nexport const ClientMessageSchema = z.discriminatedUnion('method', [\n  InitializeRequest,\n  SubscribeRequest,\n  UnsubscribeRequest,\n  RunCancelRequest,\n  PingRequest,\n  CancelledNotification,\n]);\n\n/**\n * Inferred TypeScript union for the `ClientMessage` discriminator. A\n * value satisfying this type round-trips through\n * {@link ClientMessageSchema} without throwing.\n *\n * @stable\n */\nexport type ClientMessage = z.infer<typeof ClientMessageSchema>;\n\n/**\n * Convenience type for the JSON-RPC `id` slot. Matches the Graphorin\n * subset (string + integer; no `null`, no float).\n *\n * @stable\n */\nexport type ClientMessageId = z.infer<typeof RpcId>;\n\n/**\n * Type guard helpers — one per `method` literal — so consumers can\n * narrow the `ClientMessage` union without re-stringifying the\n * discriminator.\n *\n * @stable\n */\nexport function isInitializeRequest(\n  message: ClientMessage,\n): message is z.infer<typeof InitializeRequest> {\n  return message.method === 'initialize';\n}\n\n/** @stable */\nexport function isSubscribeRequest(\n  message: ClientMessage,\n): message is z.infer<typeof SubscribeRequest> {\n  return message.method === 'subscription.subscribe';\n}\n\n/** @stable */\nexport function isUnsubscribeRequest(\n  message: ClientMessage,\n): message is z.infer<typeof UnsubscribeRequest> {\n  return message.method === 'subscription.unsubscribe';\n}\n\n/** @stable */\nexport function isRunCancelRequest(\n  message: ClientMessage,\n): message is z.infer<typeof RunCancelRequest> {\n  return message.method === 'run.cancel';\n}\n\n/** @stable */\nexport function isPingRequest(message: ClientMessage): message is z.infer<typeof PingRequest> {\n  return message.method === 'ping';\n}\n\n/** @stable */\nexport function isCancelledNotification(\n  message: ClientMessage,\n): message is z.infer<typeof CancelledNotification> {\n  return message.method === 'notifications/cancelled';\n}\n"],"mappings":"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"}

package/dist/close-codes.d.ts

@@ -0,0 +1,49 @@
+//#region src/close-codes.d.ts
+/**
+ * Custom WebSocket close-code taxonomy used by `@graphorin/server`
+ * and `@graphorin/client`. The numeric values live in the 4xxx
+ * application-private range per RFC 6455 § 7.4.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Discriminator for every Graphorin-defined close code. The
+ * matching numeric value is exposed via {@link CLOSE_CODE_VALUES}.
+ *
+ * @stable
+ */
+type GraphorinCloseReason = 'auth.required' | 'auth.invalid' | 'auth.revoked' | 'auth.scope_denied' | 'rate.limited' | 'flow.throttled' | 'server.shutdown' | 'protocol.violation';
+/**
+ * Numeric close-code constants. The pair `(value, reason)` round-trips
+ * via {@link closeCodeReason} / {@link closeCodeFor}.
+ *
+ * @stable
+ */
+declare const CLOSE_CODE_VALUES: Readonly<{
+  readonly 'auth.required': 4001;
+  readonly 'auth.invalid': 4002;
+  readonly 'auth.revoked': 4003;
+  readonly 'auth.scope_denied': 4004;
+  readonly 'rate.limited': 4005;
+  readonly 'flow.throttled': 4006;
+  readonly 'server.shutdown': 4007;
+  readonly 'protocol.violation': 4008;
+}>;
+/**
+ * Return the numeric close code for a Graphorin reason discriminator.
+ *
+ * @stable
+ */
+declare function closeCodeFor(reason: GraphorinCloseReason): number;
+/**
+ * Resolve a numeric close code back to its Graphorin reason
+ * discriminator. Returns `undefined` for codes outside the
+ * Graphorin range so callers can still surface the raw RFC 6455
+ * reason for unrelated codes.
+ *
+ * @stable
+ */
+declare function closeCodeReason(code: number): GraphorinCloseReason | undefined;
+//#endregion
+export { CLOSE_CODE_VALUES, GraphorinCloseReason, closeCodeFor, closeCodeReason };
+//# sourceMappingURL=close-codes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"close-codes.d.ts","names":[],"sources":["../src/close-codes.ts"],"sourcesContent":[],"mappings":";;AAcA;AAgBA;AAgBA;AAkBA;;;;;;;;;KAlDY,oBAAA;;;;;;;cAgBC,mBAAiB;;;;;;;;;;;;;;;iBAgBd,YAAA,SAAqB;;;;;;;;;iBAkBrB,eAAA,gBAA+B"}

package/dist/close-codes.js

@@ -0,0 +1,41 @@
+//#region src/close-codes.ts
+/**
+* Numeric close-code constants. The pair `(value, reason)` round-trips
+* via {@link closeCodeReason} / {@link closeCodeFor}.
+*
+* @stable
+*/
+const CLOSE_CODE_VALUES = Object.freeze({
+	"auth.required": 4001,
+	"auth.invalid": 4002,
+	"auth.revoked": 4003,
+	"auth.scope_denied": 4004,
+	"rate.limited": 4005,
+	"flow.throttled": 4006,
+	"server.shutdown": 4007,
+	"protocol.violation": 4008
+});
+/**
+* Return the numeric close code for a Graphorin reason discriminator.
+*
+* @stable
+*/
+function closeCodeFor(reason) {
+	return CLOSE_CODE_VALUES[reason];
+}
+const REVERSE_LOOKUP = new Map(Object.entries(CLOSE_CODE_VALUES).map(([reason, code]) => [code, reason]));
+/**
+* Resolve a numeric close code back to its Graphorin reason
+* discriminator. Returns `undefined` for codes outside the
+* Graphorin range so callers can still surface the raw RFC 6455
+* reason for unrelated codes.
+*
+* @stable
+*/
+function closeCodeReason(code) {
+	return REVERSE_LOOKUP.get(code);
+}
+
+//#endregion
+export { CLOSE_CODE_VALUES, closeCodeFor, closeCodeReason };
+//# sourceMappingURL=close-codes.js.map

package/dist/close-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-codes.js","names":["REVERSE_LOOKUP: ReadonlyMap<number, GraphorinCloseReason>"],"sources":["../src/close-codes.ts"],"sourcesContent":["/**\n * Custom WebSocket close-code taxonomy used by `@graphorin/server`\n * and `@graphorin/client`. The numeric values live in the 4xxx\n * application-private range per RFC 6455 § 7.4.\n *\n * @packageDocumentation\n */\n\n/**\n * Discriminator for every Graphorin-defined close code. The\n * matching numeric value is exposed via {@link CLOSE_CODE_VALUES}.\n *\n * @stable\n */\nexport type GraphorinCloseReason =\n  | 'auth.required'\n  | 'auth.invalid'\n  | 'auth.revoked'\n  | 'auth.scope_denied'\n  | 'rate.limited'\n  | 'flow.throttled'\n  | 'server.shutdown'\n  | 'protocol.violation';\n\n/**\n * Numeric close-code constants. The pair `(value, reason)` round-trips\n * via {@link closeCodeReason} / {@link closeCodeFor}.\n *\n * @stable\n */\nexport const CLOSE_CODE_VALUES = Object.freeze({\n  'auth.required': 4001,\n  'auth.invalid': 4002,\n  'auth.revoked': 4003,\n  'auth.scope_denied': 4004,\n  'rate.limited': 4005,\n  'flow.throttled': 4006,\n  'server.shutdown': 4007,\n  'protocol.violation': 4008,\n} as const satisfies Record<GraphorinCloseReason, number>);\n\n/**\n * Return the numeric close code for a Graphorin reason discriminator.\n *\n * @stable\n */\nexport function closeCodeFor(reason: GraphorinCloseReason): number {\n  return CLOSE_CODE_VALUES[reason];\n}\n\nconst REVERSE_LOOKUP: ReadonlyMap<number, GraphorinCloseReason> = new Map(\n  (Object.entries(CLOSE_CODE_VALUES) as ReadonlyArray<[GraphorinCloseReason, number]>).map(\n    ([reason, code]) => [code, reason],\n  ),\n);\n\n/**\n * Resolve a numeric close code back to its Graphorin reason\n * discriminator. Returns `undefined` for codes outside the\n * Graphorin range so callers can still surface the raw RFC 6455\n * reason for unrelated codes.\n *\n * @stable\n */\nexport function closeCodeReason(code: number): GraphorinCloseReason | undefined {\n  return REVERSE_LOOKUP.get(code);\n}\n"],"mappings":";;;;;;;AA8BA,MAAa,oBAAoB,OAAO,OAAO;CAC7C,iBAAiB;CACjB,gBAAgB;CAChB,gBAAgB;CAChB,qBAAqB;CACrB,gBAAgB;CAChB,kBAAkB;CAClB,mBAAmB;CACnB,sBAAsB;CACvB,CAAyD;;;;;;AAO1D,SAAgB,aAAa,QAAsC;AACjE,QAAO,kBAAkB;;AAG3B,MAAMA,iBAA4D,IAAI,IACnE,OAAO,QAAQ,kBAAkB,CAAmD,KAClF,CAAC,QAAQ,UAAU,CAAC,MAAM,OAAO,CACnC,CACF;;;;;;;;;AAUD,SAAgB,gBAAgB,MAAgD;AAC9E,QAAO,eAAe,IAAI,KAAK"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { ClientMessage, ClientMessageId, ClientMessageSchema, isCancelledNotification, isInitializeRequest, isPingRequest, isRunCancelRequest, isSubscribeRequest, isUnsubscribeRequest } from "./client-message.js";
+import { CLOSE_CODE_VALUES, GraphorinCloseReason, closeCodeFor, closeCodeReason } from "./close-codes.js";
+import { RPC_ERROR_CODES, ServerErrorFrame, ServerEventFrame, ServerLifecycleFrame, ServerMessage, ServerMessageSchema, ServerPongFrame, ServerReplayMarkerFrame, ServerRpcFailure, ServerRpcSuccess, ServerSubscribedFrame, ServerUnsubscribedFrame, isErrorFrame, isEventFrame, isLifecycleFrame, isPongFrame, isReplayMarkerFrame, isRpcFailure, isRpcSuccess, isSubscribedFrame, isUnsubscribedFrame } from "./server-message.js";
+import { PROTOCOL_VERSION, SUBPROTOCOL_NAME, TICKET_SUBPROTOCOL_PREFIX, formatTicketSubprotocol, negotiateSubprotocol, parseTicketSubprotocol } from "./subprotocol.js";
+
+//#region src/index.d.ts
+
+/**
+ * `@graphorin/protocol` — wire-format contract for the Graphorin
+ * WebSocket subprotocol.
+ *
+ * The package is the **single source of truth** for the shape of
+ * every frame exchanged over `wss://.../v1/ws`. Both
+ * `@graphorin/server` and `@graphorin/client` import their schemas
+ * from here so the two implementations cannot drift.
+ *
+ * Browser-friendly: the only runtime dependency is
+ * [`zod`](https://zod.dev). No Node-only imports, no DOM-only
+ * imports.
+ *
+ * @packageDocumentation
+ */
+/** Canonical version constant. Mirrors the `package.json` version. */
+declare const VERSION = "0.5.0";
+//#endregion
+export { CLOSE_CODE_VALUES, ClientMessage, ClientMessageId, ClientMessageSchema, GraphorinCloseReason, PROTOCOL_VERSION, RPC_ERROR_CODES, SUBPROTOCOL_NAME, ServerErrorFrame, ServerEventFrame, ServerLifecycleFrame, ServerMessage, ServerMessageSchema, ServerPongFrame, ServerReplayMarkerFrame, ServerRpcFailure, ServerRpcSuccess, ServerSubscribedFrame, ServerUnsubscribedFrame, TICKET_SUBPROTOCOL_PREFIX, VERSION, closeCodeFor, closeCodeReason, formatTicketSubprotocol, isCancelledNotification, isErrorFrame, isEventFrame, isInitializeRequest, isLifecycleFrame, isPingRequest, isPongFrame, isReplayMarkerFrame, isRpcFailure, isRpcSuccess, isRunCancelRequest, isSubscribeRequest, isSubscribedFrame, isUnsubscribeRequest, isUnsubscribedFrame, negotiateSubprotocol, parseTicketSubprotocol };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;AAiBA;;;;;;;;;;cAAa,OAAA"}

package/dist/index.js

@@ -0,0 +1,27 @@
+import { ClientMessageSchema, isCancelledNotification, isInitializeRequest, isPingRequest, isRunCancelRequest, isSubscribeRequest, isUnsubscribeRequest } from "./client-message.js";
+import { CLOSE_CODE_VALUES, closeCodeFor, closeCodeReason } from "./close-codes.js";
+import { RPC_ERROR_CODES, ServerMessageSchema, isErrorFrame, isEventFrame, isLifecycleFrame, isPongFrame, isReplayMarkerFrame, isRpcFailure, isRpcSuccess, isSubscribedFrame, isUnsubscribedFrame } from "./server-message.js";
+import { PROTOCOL_VERSION, SUBPROTOCOL_NAME, TICKET_SUBPROTOCOL_PREFIX, formatTicketSubprotocol, negotiateSubprotocol, parseTicketSubprotocol } from "./subprotocol.js";
+
+//#region src/index.ts
+/**
+* `@graphorin/protocol` — wire-format contract for the Graphorin
+* WebSocket subprotocol.
+*
+* The package is the **single source of truth** for the shape of
+* every frame exchanged over `wss://.../v1/ws`. Both
+* `@graphorin/server` and `@graphorin/client` import their schemas
+* from here so the two implementations cannot drift.
+*
+* Browser-friendly: the only runtime dependency is
+* [`zod`](https://zod.dev). No Node-only imports, no DOM-only
+* imports.
+*
+* @packageDocumentation
+*/
+/** Canonical version constant. Mirrors the `package.json` version. */
+const VERSION = "0.5.0";
+
+//#endregion
+export { CLOSE_CODE_VALUES, ClientMessageSchema, PROTOCOL_VERSION, RPC_ERROR_CODES, SUBPROTOCOL_NAME, ServerMessageSchema, TICKET_SUBPROTOCOL_PREFIX, VERSION, closeCodeFor, closeCodeReason, formatTicketSubprotocol, isCancelledNotification, isErrorFrame, isEventFrame, isInitializeRequest, isLifecycleFrame, isPingRequest, isPongFrame, isReplayMarkerFrame, isRpcFailure, isRpcSuccess, isRunCancelRequest, isSubscribeRequest, isSubscribedFrame, isUnsubscribeRequest, isUnsubscribedFrame, negotiateSubprotocol, parseTicketSubprotocol };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * `@graphorin/protocol` — wire-format contract for the Graphorin\n * WebSocket subprotocol.\n *\n * The package is the **single source of truth** for the shape of\n * every frame exchanged over `wss://.../v1/ws`. Both\n * `@graphorin/server` and `@graphorin/client` import their schemas\n * from here so the two implementations cannot drift.\n *\n * Browser-friendly: the only runtime dependency is\n * [`zod`](https://zod.dev). No Node-only imports, no DOM-only\n * imports.\n *\n * @packageDocumentation\n */\n\n/** Canonical version constant. Mirrors the `package.json` version. */\nexport const VERSION = '0.5.0';\n\nexport * from './client-message.js';\nexport * from './close-codes.js';\nexport * from './server-message.js';\nexport * from './subprotocol.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAiBA,MAAa,UAAU"}