durable-actors 0.2.4

package/dist/actor/socket.d.ts

@@ -0,0 +1,88 @@
+import type { JsonValue } from "../json.js";
+import type { SocketConnection, SocketEffect, SocketMessage } from "./socketProtocol.js";
+import type { ActorSchemas, ActorStateMessage, ActorStateUpdate } from "./socketValidation.js";
+type ActorSocketState = "connecting" | "open" | "closed";
+type ActorSocketMessage = JsonValue;
+interface ActorSocket<Metadata = JsonValue, Outgoing = JsonValue, Tag extends string = string> {
+    readonly id: string;
+    metadata: Metadata;
+    readonly tags: readonly Tag[];
+    readonly state: ActorSocketState;
+    send(message: Outgoing): void;
+    close(code?: number, reason?: string): void;
+    reject(code?: number, reason?: string): void;
+    setTags(...tags: Tag[]): void;
+}
+interface ActorBroadcastOptions<Tag extends string = string> {
+    readonly except?: Pick<ActorSocket, "id"> | readonly Pick<ActorSocket, "id">[];
+    readonly tags?: readonly Tag[];
+    readonly tagMatch?: "all" | "any";
+}
+interface ActorConnection<Send = JsonValue, Receive = Send, State = JsonValue> {
+    readonly readyState: number;
+    send(data: Send): void;
+    close(code?: number, reason?: string): void;
+    addEventListener<Type extends keyof ActorConnectionEventMap<Receive, State>>(type: Type, listener: (event: ActorConnectionEventMap<Receive, State>[Type]) => void): void;
+    removeEventListener<Type extends keyof ActorConnectionEventMap<Receive, State>>(type: Type, listener: (event: ActorConnectionEventMap<Receive, State>[Type]) => void): void;
+}
+interface ActorConnectionEventMap<Receive = JsonValue, State = JsonValue> {
+    readonly open: {
+        readonly type: "open";
+    };
+    readonly message: {
+        readonly type: "message";
+        readonly data: Receive | ActorStateMessage<State> | ActorStateUpdate<State>;
+    };
+    readonly close: {
+        readonly type: "close";
+        readonly code: number;
+        readonly reason: string;
+        readonly wasClean: boolean;
+    };
+    readonly error: {
+        readonly type: "error";
+    };
+}
+declare function actorConnections<Metadata, Outgoing, Tag extends string>(instance: object): Promise<readonly ActorSocket<Metadata, Outgoing, Tag>[]>;
+declare function broadcastActor(instance: object, message: unknown, options?: ActorBroadcastOptions): void;
+declare function runWithActorSockets<T>(instance: object, connections: readonly SocketConnection[] | (() => Promise<readonly SocketConnection[]>), operation: (scope: ActorSocketScope) => Promise<T>, publish?: (effects: readonly SocketEffect[]) => Promise<void>, schemas?: ActorSchemas): Promise<{
+    readonly value: T;
+    readonly effects: readonly SocketEffect[];
+}>;
+declare class ActorSocketScope {
+    private readonly connections;
+    readonly effects: Pick<SocketEffect[], "push">;
+    private readonly schemas;
+    private readonly byId;
+    private loading;
+    constructor(connections: readonly SocketConnection[] | (() => Promise<readonly SocketConnection[]>), effects: Pick<SocketEffect[], "push">, schemas: ActorSchemas);
+    getConnections(): Promise<readonly RuntimeActorSocket[]>;
+    settle(): Promise<void>;
+    eventSocket(connection: SocketConnection, state: ActorSocketState): RuntimeActorSocket;
+    connection(connectionId: string): RuntimeActorSocket;
+    broadcast(message: unknown, options?: ActorBroadcastOptions): void;
+    private wrap;
+}
+declare class RuntimeActorSocket<Metadata = JsonValue> implements ActorSocket<Metadata> {
+    private readonly effects;
+    private readonly schemas;
+    private stateValue;
+    private metadataValue;
+    private tagsValue;
+    constructor(connection: SocketConnection, effects: Pick<SocketEffect[], "push">, schemas: ActorSchemas, stateValue?: ActorSocketState);
+    readonly id: string;
+    get state(): ActorSocketState;
+    get metadata(): Metadata;
+    set metadata(value: Metadata);
+    get tags(): readonly string[];
+    send(message: ActorSocketMessage): void;
+    close(code?: number, reason?: string): void;
+    reject(code?: number, reason?: string): void;
+    setTags(...tags: string[]): void;
+    setState(state: ActorSocketState): void;
+}
+declare function socketMessage(message: unknown, schemas?: ActorSchemas): SocketMessage;
+declare function decodeSocketMessage(message: SocketMessage, schemas?: ActorSchemas): ActorSocketMessage;
+export { actorConnections, broadcastActor, decodeSocketMessage, runWithActorSockets, socketMessage };
+export type { ActorSocketScope, ActorBroadcastOptions, ActorConnection, ActorConnectionEventMap, ActorSocket, ActorSocketMessage, ActorSocketState };
+//# sourceMappingURL=socket.d.ts.map

package/dist/actor/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/actor/socket.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExF,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE9F,KAAK,gBAAgB,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAA;AACxD,KAAK,kBAAkB,GAAG,SAAS,CAAA;AAEnC,UAAU,WAAW,CAAC,QAAQ,GAAG,SAAS,EAAE,QAAQ,GAAG,SAAS,EAAE,GAAG,SAAS,MAAM,GAAG,MAAM;IACzF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;IAChC,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5C,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;CAChC;AAED,UAAU,qBAAqB,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,SAAS,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAA;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,EAAE,CAAA;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;CACpC;AAED,UAAU,eAAe,CAAC,IAAI,GAAG,SAAS,EAAE,OAAO,GAAG,IAAI,EAAE,KAAK,GAAG,SAAS;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IACtB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,gBAAgB,CAAC,IAAI,SAAS,MAAM,uBAAuB,CAAC,OAAO,EAAE,KAAK,CAAC,EACvE,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,CAAC,KAAK,EAAE,uBAAuB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,GACzE,IAAI,CAAA;IACP,mBAAmB,CAAC,IAAI,SAAS,MAAM,uBAAuB,CAAC,OAAO,EAAE,KAAK,CAAC,EAC1E,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,CAAC,KAAK,EAAE,uBAAuB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,GACzE,IAAI,CAAA;CACV;AAED,UAAU,uBAAuB,CAAC,OAAO,GAAG,SAAS,EAAE,KAAK,GAAG,SAAS;IACpE,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;QACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;KAC9E,CAAA;IACD,QAAQ,CAAC,KAAK,EAAE;QACZ,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;KAC7B,CAAA;IACD,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAA;CAC7C;AAID,iBAAe,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,SAAS,MAAM,EAClE,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,CAE1D;AAED,iBAAS,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAEjG;AAED,iBAAe,mBAAmB,CAAC,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAAC,EACvF,SAAS,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,EAClD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,EAC7D,OAAO,GAAE,YAAiB,GAC3B,OAAO,CAAC;IAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;CAAE,CAAC,CAc3E;AAED,cAAM,gBAAgB;IAKd,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,MAAM,CAAC;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwC;IAC7D,OAAO,CAAC,OAAO,CAAoD;gBAG9C,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAAC,EAC/F,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,MAAM,CAAC,EAC7B,OAAO,EAAE,YAAY;IAK1C,cAAc,IAAI,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;IAQlD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,WAAW,CAAC,UAAU,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,GAAG,kBAAkB;IAStF,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB;IAOpD,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,qBAA0B,GAAG,IAAI;IAYtE,OAAO,CAAC,IAAI;CAKf;AAED,cAAM,kBAAkB,CAAC,QAAQ,GAAG,SAAS,CAAE,YAAW,WAAW,CAAC,QAAQ,CAAC;IAMvE,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,UAAU;IAPtB,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,SAAS,CAAmB;gBAGhC,UAAU,EAAE,gBAAgB,EACX,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,MAAM,CAAC,EACrC,OAAO,EAAE,YAAY,EAC9B,UAAU,GAAE,gBAAyB;IAOjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB,IAAI,KAAK,IAAI,gBAAgB,CAE5B;IAED,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAI3B;IAED,IAAI,IAAI,IAAI,SAAS,MAAM,EAAE,CAE5B;IAED,IAAI,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKvC,KAAK,CAAC,IAAI,SAAO,EAAE,MAAM,SAAK,GAAG,IAAI;IAOrC,MAAM,CAAC,IAAI,SAAO,EAAE,MAAM,SAAwB,GAAG,IAAI;IAQzD,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAMhC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;CAG1C;AAmDD,iBAAS,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,aAAa,CAIlF;AAED,iBAAS,mBAAmB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,YAAiB,GAAG,kBAAkB,CAOnG;AAcD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,aAAa,EAAE,CAAA;AACpG,YAAY,EACR,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EACnB,CAAA"}

package/dist/actor/socket.js

@@ -0,0 +1,216 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { ActorProtocolError } from "../errors.js";
+import { incomingMessage, outgoingMessage, socketMetadata, socketTags } from "./socketValidation.js";
+const scopes = new AsyncLocalStorage();
+async function actorConnections(instance) {
+    return (await socketScope(instance).getConnections());
+}
+function broadcastActor(instance, message, options) {
+    socketScope(instance).broadcast(message, options);
+}
+async function runWithActorSockets(instance, connections, operation, publish, schemas = {}) {
+    const effects = [];
+    const output = publish === undefined ? undefined : new SocketOutput(publish);
+    const scope = new ActorSocketScope(connections, output ?? effects, schemas);
+    const context = { instance, scope, active: true };
+    return scopes.run(context, async () => {
+        try {
+            return { value: await operation(scope), effects };
+        }
+        finally {
+            context.active = false;
+            await scope.settle();
+            await output?.flush();
+        }
+    });
+}
+class ActorSocketScope {
+    connections;
+    effects;
+    schemas;
+    byId = new Map();
+    loading;
+    constructor(connections, effects, schemas) {
+        this.connections = connections;
+        this.effects = effects;
+        this.schemas = schemas;
+        if (typeof connections !== "function")
+            this.loading = Promise.resolve(this.wrap(connections));
+    }
+    getConnections() {
+        this.loading ??= Promise.resolve().then(async () => {
+            const connections = typeof this.connections === "function" ? await this.connections() : this.connections;
+            return this.wrap(connections);
+        });
+        return this.loading;
+    }
+    async settle() {
+        await this.loading?.catch(() => undefined);
+    }
+    eventSocket(connection, state) {
+        const socket = this.byId.get(connection.id);
+        if (socket !== undefined) {
+            socket.setState(state);
+            return socket;
+        }
+        return new RuntimeActorSocket(connection, this.effects, this.schemas, state);
+    }
+    connection(connectionId) {
+        const socket = this.byId.get(connectionId);
+        if (socket === undefined)
+            throw new ActorProtocolError(`socket connection ${connectionId} is not attached to the actor`);
+        return socket;
+    }
+    broadcast(message, options = {}) {
+        if (options.tagMatch !== undefined && options.tagMatch !== "all" && options.tagMatch !== "any")
+            throw new ActorProtocolError('broadcast tagMatch must be "all" or "any"');
+        this.effects.push({
+            type: "broadcast",
+            message: socketMessage(message, this.schemas),
+            except_connection_ids: excludedSocketIds(options.except),
+            tags: socketTags(options.tags ?? [], this.schemas),
+            ...(options.tagMatch === undefined ? {} : { tag_match: options.tagMatch })
+        });
+    }
+    wrap(connections) {
+        const sockets = connections.map(connection => new RuntimeActorSocket(connection, this.effects, this.schemas));
+        for (const socket of sockets)
+            this.byId.set(socket.id, socket);
+        return sockets;
+    }
+}
+class RuntimeActorSocket {
+    effects;
+    schemas;
+    stateValue;
+    metadataValue;
+    tagsValue;
+    constructor(connection, effects, schemas, stateValue = "open") {
+        this.effects = effects;
+        this.schemas = schemas;
+        this.stateValue = stateValue;
+        this.id = connection.id;
+        this.metadataValue = socketMetadata(connection.metadata, schemas);
+        this.tagsValue = socketTags(connection.tags, schemas);
+    }
+    id;
+    get state() {
+        return this.stateValue;
+    }
+    get metadata() {
+        return this.metadataValue;
+    }
+    set metadata(value) {
+        const metadata = socketMetadata(value, this.schemas);
+        this.metadataValue = metadata;
+        this.effects.push({ type: "set_metadata", connection_id: this.id, metadata });
+    }
+    get tags() {
+        return this.tagsValue;
+    }
+    send(message) {
+        if (this.stateValue === "closed")
+            throw new ActorProtocolError("cannot send on a closed actor socket");
+        this.effects.push({ type: "send", connection_id: this.id, message: socketMessage(message, this.schemas) });
+    }
+    close(code = 1000, reason = "") {
+        validateClose(code, reason);
+        if (this.stateValue === "closed")
+            return;
+        this.stateValue = "closed";
+        this.effects.push({ type: "close", connection_id: this.id, code, reason });
+    }
+    reject(code = 1008, reason = "connection rejected") {
+        if (this.stateValue !== "connecting")
+            throw new ActorProtocolError("only a connecting actor socket can be rejected");
+        validateClose(code, reason);
+        this.stateValue = "closed";
+        this.effects.push({ type: "reject", connection_id: this.id, code, reason });
+    }
+    setTags(...tags) {
+        const unique = socketTags(tags, this.schemas);
+        this.tagsValue = unique;
+        this.effects.push({ type: "set_tags", connection_id: this.id, tags: unique });
+    }
+    setState(state) {
+        this.stateValue = state;
+    }
+}
+class SocketOutput {
+    publish;
+    pending;
+    queued = [];
+    queuedBytes = 0;
+    failure;
+    constructor(publish) {
+        this.publish = publish;
+    }
+    push(...effects) {
+        if (this.failure !== undefined)
+            throw this.failure;
+        const bytes = Buffer.byteLength(JSON.stringify(effects));
+        if (this.queued.length + effects.length > 512 || this.queuedBytes + bytes > 24 * 1024 * 1024)
+            throw new ActorProtocolError("actor socket output queue is full");
+        this.queued.push(...effects);
+        this.queuedBytes += bytes;
+        this.pending ??= this.drain();
+        void this.pending.catch(() => undefined);
+        return this.queued.length;
+    }
+    async flush() {
+        await this.pending;
+        if (this.failure !== undefined)
+            throw this.failure;
+    }
+    async drain() {
+        try {
+            while (this.queued.length > 0) {
+                const batch = this.queued;
+                this.queued = [];
+                this.queuedBytes = 0;
+                await this.publish(batch);
+            }
+        }
+        catch (error) {
+            this.failure = error;
+            throw error;
+        }
+        finally {
+            this.pending = undefined;
+        }
+    }
+}
+function socketScope(instance) {
+    const context = scopes.getStore();
+    if (context === undefined || context.instance !== instance || !context.active)
+        throw new ActorProtocolError("actor connections are available only during an actor invocation");
+    return context.scope;
+}
+function socketMessage(message, schemas = {}) {
+    if (ArrayBuffer.isView(message) || message instanceof ArrayBuffer)
+        throw new ActorProtocolError("socket messages must be JSON values, not bytes");
+    return { type: "text", data: JSON.stringify(outgoingMessage(message, schemas)) };
+}
+function decodeSocketMessage(message, schemas = {}) {
+    if (message.type !== "text")
+        throw new ActorProtocolError("socket messages must be JSON text frames");
+    try {
+        return incomingMessage(JSON.parse(message.data), schemas);
+    }
+    catch (error) {
+        throw new ActorProtocolError("socket message is not valid JSON", { cause: error });
+    }
+}
+function validateClose(code, reason) {
+    if (!Number.isInteger(code) || (code !== 1000 && (code < 3000 || code > 4999)))
+        throw new ActorProtocolError("socket close codes must be 1000 or between 3000 and 4999");
+    if (Buffer.byteLength(reason) > 123)
+        throw new ActorProtocolError("socket close reasons must not exceed 123 UTF-8 bytes");
+}
+function excludedSocketIds(except) {
+    if (except === undefined)
+        return [];
+    return Array.isArray(except) ? except.map(socket => socket.id) : [except.id];
+}
+export { actorConnections, broadcastActor, decodeSocketMessage, runWithActorSockets, socketMessage };
+//# sourceMappingURL=socket.js.map

package/dist/actor/socket.js.map

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

package/dist/actor/socketProtocol.d.ts

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import type { JsonObject, JsonValue } from "../json.js";
+declare function parseSocketEffects(value: unknown): readonly SocketEffect[];
+declare const socketTagsSchema: z.ZodArray<z.ZodString>;
+declare const socketConnectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    metadata: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    tags: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+declare const socketMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    data: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"binary">;
+    data: z.ZodString;
+}, z.core.$strip>], "type">;
+declare const socketEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"connect">;
+    connection: z.ZodObject<{
+        id: z.ZodString;
+        metadata: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+        tags: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"message">;
+    connection_id: z.ZodString;
+    message: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        data: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"binary">;
+        data: z.ZodString;
+    }, z.core.$strip>], "type">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"disconnect">;
+    connection: z.ZodObject<{
+        id: z.ZodString;
+        metadata: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+        tags: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    code: z.ZodNumber;
+    reason: z.ZodString;
+    was_clean: z.ZodBoolean;
+}, z.core.$strip>], "type">;
+type SocketConnection = z.infer<typeof socketConnectionSchema>;
+type SocketMessage = z.infer<typeof socketMessageSchema>;
+type SocketEvent = z.infer<typeof socketEventSchema>;
+type SocketEffect = {
+    readonly type: "state_snapshot";
+    readonly connection_id: string;
+    readonly state: JsonObject;
+    readonly version?: number;
+} | {
+    readonly type: "state_update";
+    readonly changes: JsonObject;
+    readonly removed: readonly string[];
+    readonly except_connection_ids?: readonly string[];
+    readonly version?: number;
+} | {
+    readonly type: "send";
+    readonly connection_id: string;
+    readonly message: SocketMessage;
+} | {
+    readonly type: "broadcast";
+    readonly message: SocketMessage;
+    readonly except_connection_ids: readonly string[];
+    readonly tags: readonly string[];
+    readonly tag_match?: "all" | "any";
+} | {
+    readonly type: "close" | "reject";
+    readonly connection_id: string;
+    readonly code: number;
+    readonly reason: string;
+} | {
+    readonly type: "set_metadata";
+    readonly connection_id: string;
+    readonly metadata: JsonValue;
+} | {
+    readonly type: "set_tags";
+    readonly connection_id: string;
+    readonly tags: readonly string[];
+};
+export { parseSocketEffects, socketConnectionSchema, socketEventSchema, socketTagsSchema };
+export type { SocketConnection, SocketEffect, SocketEvent, SocketMessage };
+//# sourceMappingURL=socketProtocol.d.ts.map

package/dist/actor/socketProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socketProtocol.d.ts","sourceRoot":"","sources":["../../src/actor/socketProtocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAIvD,iBAAS,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,YAAY,EAAE,CAInE;AAQD,QAAA,MAAM,gBAAgB,yBAMjB,CAAA;AAmBL,QAAA,MAAM,sBAAsB;;;;iBAI1B,CAAA;AAEF,QAAA,MAAM,mBAAmB;;;;;;2BAGvB,CAAA;AA8CF,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAUrB,CAAA;AAEF,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAC9D,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AACxD,KAAK,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AACpD,KAAK,YAAY,GACX;IACI,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC5B,GACD;IACI,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC5B,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAAE,GAC1F;IACI,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAA;IACjD,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;CACrC,GACD;IACI,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAA;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAC1B,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,GAC/F;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAA;AAErG,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAA;AAC1F,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,CAAA"}

package/dist/actor/socketProtocol.js

@@ -0,0 +1,95 @@
+import { z } from "zod";
+import { ActorProtocolError } from "../errors.js";
+import { jsonValueSchema } from "../json.js";
+import { actorComponentSchema } from "./identity.js";
+function parseSocketEffects(value) {
+    const result = socketEffectsSchema.safeParse(value);
+    if (!result.success)
+        throw new ActorProtocolError(`actor socket effects are invalid: ${result.error.message}`);
+    return result.data;
+}
+const socketConnectionIdSchema = actorComponentSchema.max(128);
+const socketMetadataSchema = jsonValueSchema.refine(value => Buffer.byteLength(JSON.stringify(value)) <= 64 * 1024, "socket metadata must not exceed 64 KiB");
+const socketTagSchema = z.string().min(1).max(256);
+const socketTagsSchema = z
+    .array(socketTagSchema)
+    .max(128)
+    .refine(tags => tags.reduce((bytes, tag) => bytes + Buffer.byteLength(tag), 0) <= 8 * 1024, "socket tags must not exceed 8 KiB");
+const socketTextSchema = z
+    .string()
+    .refine(value => Buffer.byteLength(value) <= 16 * 1024 * 1024, "socket message must not exceed 16 MiB");
+const socketBinarySchema = z
+    .string()
+    .regex(/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/u, "socket binary message must be base64")
+    .refine(value => Buffer.byteLength(value, "base64") <= 16 * 1024 * 1024, "socket message must not exceed 16 MiB");
+const socketCloseCodeSchema = z
+    .number()
+    .int()
+    .refine(code => code === 1000 || (code >= 3000 && code <= 4999), "socket close code must be 1000 or between 3000 and 4999");
+const socketCloseReasonSchema = z
+    .string()
+    .refine(reason => Buffer.byteLength(reason) <= 123, "socket close reason must not exceed 123 bytes");
+const socketConnectionSchema = z.object({
+    id: socketConnectionIdSchema,
+    metadata: socketMetadataSchema,
+    tags: socketTagsSchema
+});
+const socketMessageSchema = z.discriminatedUnion("type", [
+    z.object({ type: z.literal("text"), data: socketTextSchema }),
+    z.object({ type: z.literal("binary"), data: socketBinarySchema })
+]);
+const socketEffectSchema = z.discriminatedUnion("type", [
+    z.object({
+        type: z.literal("state_snapshot"),
+        connection_id: socketConnectionIdSchema,
+        state: z.record(z.string(), jsonValueSchema),
+        version: z.number().int().nonnegative().safe().optional()
+    }),
+    z.object({
+        type: z.literal("state_update"),
+        changes: z.record(z.string(), jsonValueSchema),
+        removed: z.array(z.string()),
+        except_connection_ids: z.array(socketConnectionIdSchema).optional(),
+        version: z.number().int().nonnegative().safe().optional()
+    }),
+    z.object({ type: z.literal("send"), connection_id: socketConnectionIdSchema, message: socketMessageSchema }),
+    z.object({
+        type: z.literal("broadcast"),
+        message: socketMessageSchema,
+        except_connection_ids: z.array(socketConnectionIdSchema).max(128),
+        tags: socketTagsSchema,
+        tag_match: z.enum(["all", "any"]).optional()
+    }),
+    z.object({
+        type: z.literal("close"),
+        connection_id: socketConnectionIdSchema,
+        code: socketCloseCodeSchema,
+        reason: socketCloseReasonSchema
+    }),
+    z.object({
+        type: z.literal("reject"),
+        connection_id: socketConnectionIdSchema,
+        code: socketCloseCodeSchema,
+        reason: socketCloseReasonSchema
+    }),
+    z.object({
+        type: z.literal("set_metadata"),
+        connection_id: socketConnectionIdSchema,
+        metadata: socketMetadataSchema
+    }),
+    z.object({ type: z.literal("set_tags"), connection_id: socketConnectionIdSchema, tags: socketTagsSchema })
+]);
+const socketEffectsSchema = z.array(socketEffectSchema);
+const socketEventSchema = z.discriminatedUnion("type", [
+    z.object({ type: z.literal("connect"), connection: socketConnectionSchema }),
+    z.object({ type: z.literal("message"), connection_id: actorComponentSchema, message: socketMessageSchema }),
+    z.object({
+        type: z.literal("disconnect"),
+        connection: socketConnectionSchema,
+        code: z.number().int().min(0).max(65535),
+        reason: z.string(),
+        was_clean: z.boolean()
+    })
+]);
+export { parseSocketEffects, socketConnectionSchema, socketEventSchema, socketTagsSchema };
+//# sourceMappingURL=socketProtocol.js.map

package/dist/actor/socketProtocol.js.map

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

package/dist/actor/socketValidation.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import type { JsonObject, JsonValue } from "../json.js";
+import type { SocketContract } from "../wire/contract.js";
+interface ActorSchemas<Metadata = unknown, Incoming = unknown, Outgoing = Incoming, Tag extends string = string> {
+    readonly contract?: SocketContract;
+    readonly metadata?: z.ZodType<Metadata, Metadata>;
+    readonly incoming?: z.ZodType<Incoming, Incoming>;
+    readonly outgoing?: z.ZodType<Outgoing, Outgoing>;
+    readonly tag?: z.ZodType<Tag, Tag>;
+}
+interface ActorStateMessage<State = JsonObject> {
+    readonly type: "state";
+    readonly state: State;
+    readonly version?: number;
+}
+interface ActorStateUpdate<State = JsonObject> {
+    readonly type: "state_update";
+    readonly changes: Partial<State>;
+    readonly removed: readonly string[];
+    readonly version: number;
+}
+declare function socketMetadata(value: unknown, schemas?: ActorSchemas): JsonValue;
+declare function incomingMessage(value: unknown, schemas?: ActorSchemas): JsonValue;
+declare function outgoingMessage(value: unknown, schemas?: ActorSchemas): JsonValue;
+declare function receivedMessage(value: unknown, schemas?: ActorSchemas): JsonValue;
+declare function socketTags(tags: readonly string[], schemas?: ActorSchemas): string[];
+export { socketMetadata, incomingMessage, outgoingMessage, receivedMessage, socketTags };
+export type { ActorSchemas, ActorStateMessage, ActorStateUpdate };
+//# sourceMappingURL=socketValidation.d.ts.map

package/dist/actor/socketValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socketValidation.d.ts","sourceRoot":"","sources":["../../src/actor/socketValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAIzD,UAAU,YAAY,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,SAAS,MAAM,GAAG,MAAM;IAC3G,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACjD,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CACrC;AAED,UAAU,iBAAiB,CAAC,KAAK,GAAG,UAAU;IAC1C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,UAAU,gBAAgB,CAAC,KAAK,GAAG,UAAU;IACzC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAC3B;AAgBD,iBAAS,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,SAAS,CAE7E;AAED,iBAAS,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,SAAS,CAE9E;AAED,iBAAS,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,SAAS,CAK9E;AAED,iBAAS,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,SAAS,CAK9E;AAED,iBAAS,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,EAAE,CASjF;AA0BD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,CAAA;AACxF,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/actor/socketValidation.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { ActorProtocolError, ActorSerializationError, ActorValidationError } from "../errors.js";
+import { jsonValueSchema } from "../json.js";
+import { socketTagsSchema } from "./socketProtocol.js";
+const stateMessageSchema = z.discriminatedUnion("type", [
+    z.object({
+        type: z.literal("state"),
+        state: z.record(z.string(), jsonValueSchema),
+        version: z.number().int().nonnegative().safe().optional()
+    }),
+    z.object({
+        type: z.literal("state_update"),
+        changes: z.record(z.string(), jsonValueSchema),
+        removed: z.array(z.string()),
+        version: z.number().int().nonnegative().safe()
+    })
+]);
+function socketMetadata(value, schemas = {}) {
+    return validateValue(value, "socket metadata", schemas.metadata, 64 * 1024);
+}
+function incomingMessage(value, schemas = {}) {
+    return validateValue(value, "incoming socket message", schemas.incoming);
+}
+function outgoingMessage(value, schemas = {}) {
+    const message = validateValue(value, "outgoing socket message", schemas.outgoing);
+    if (isStateMessage(message))
+        throw new ActorProtocolError('socket message types "state" and "state_update" are reserved for actor state');
+    return message;
+}
+function receivedMessage(value, schemas = {}) {
+    if (!isStateMessage(value))
+        return outgoingMessage(value, schemas);
+    const result = stateMessageSchema.safeParse(value);
+    if (!result.success)
+        throw new ActorProtocolError(`invalid actor state message: ${result.error.message}`);
+    return result.data;
+}
+function socketTags(tags, schemas = {}) {
+    const result = socketTagsSchema.safeParse([...new Set(tags)]);
+    if (!result.success)
+        throw new ActorProtocolError(`invalid socket tags: ${result.error.message}`);
+    for (const tag of result.data) {
+        const validated = schemas.tag?.safeParse(tag);
+        if (validated?.success === false)
+            throw new ActorValidationError(`invalid socket tag: ${validated.error.message}`);
+    }
+    return result.data;
+}
+function validateValue(value, label, schema, maximumBytes = 16 * 1024 * 1024) {
+    let json;
+    let bytes;
+    try {
+        json = jsonValueSchema.parse(value);
+        bytes = Buffer.byteLength(JSON.stringify(json));
+    }
+    catch (error) {
+        throw new ActorSerializationError(`${label} must be a JSON value`, { cause: error });
+    }
+    if (bytes > maximumBytes)
+        throw new ActorValidationError(`${label} exceeds ${maximumBytes} bytes`);
+    const result = schema?.safeParse(json);
+    if (result?.success === false)
+        throw new ActorValidationError(`${label} is invalid: ${result.error.message}`);
+    return json;
+}
+function isStateMessage(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "type" in value &&
+        (value.type === "state" || value.type === "state_update"));
+}
+export { socketMetadata, incomingMessage, outgoingMessage, receivedMessage, socketTags };
+//# sourceMappingURL=socketValidation.js.map

package/dist/actor/socketValidation.js.map

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