@velajs/cloudflare 1.28.0 → 1.30.0

package/dist/storage/storage.service.js

@@ -0,0 +1,64 @@
+import { STORAGE_OPTIONS } from "./storage.tokens.js";
+import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorateParam from "../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateParam.js";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import { StorageManagerService } from "./storage-manager.service.js";
+import { Inject, Injectable } from "@velajs/vela";
+import { joinStoragePath } from "@velajs/vela/storage";
+//#region src/storage/storage.service.ts
+const DEFAULT_PRESIGN = {
+	defaultExpiry: 3600,
+	maxExpiry: 86400
+};
+let StorageService = class StorageService {
+	options;
+	manager;
+	constructor(options, manager) {
+		this.options = options;
+		this.manager = manager;
+	}
+	put(relativePath, body, options = {}, disk) {
+		const name = this.resolveDisk(disk);
+		return this.manager.getDriver(name).upload(body, this.fullPath(relativePath, name), options);
+	}
+	get(relativePath, disk) {
+		const name = this.resolveDisk(disk);
+		return this.manager.getDriver(name).download(this.fullPath(relativePath, name));
+	}
+	delete(relativePath, disk) {
+		const name = this.resolveDisk(disk);
+		return this.manager.getDriver(name).delete(this.fullPath(relativePath, name));
+	}
+	exists(relativePath, disk) {
+		const name = this.resolveDisk(disk);
+		return this.manager.getDriver(name).exists(this.fullPath(relativePath, name));
+	}
+	url(relativePath, method = "GET", expiresIn, disk) {
+		const name = this.resolveDisk(disk);
+		return this.manager.getDriver(name).getPresignedUrl(this.fullPath(relativePath, name), method, this.validateExpiry(expiresIn));
+	}
+	resolveDisk(disk) {
+		const name = disk ?? this.options.defaultDisk;
+		if (!this.manager.hasDisk(name)) throw new Error(`Storage disk "${name}" is not configured.`);
+		return name;
+	}
+	fullPath(relativePath, disk) {
+		return joinStoragePath(this.manager.getDiskConfig(disk).root, relativePath);
+	}
+	validateExpiry(expiresIn) {
+		const cfg = this.options.presignedUrl ?? DEFAULT_PRESIGN;
+		const value = expiresIn ?? cfg.defaultExpiry;
+		if (!Number.isSafeInteger(value) || value < 1 || value > cfg.maxExpiry) throw new Error(`Presigned URL expiry ${value}s is out of range (1–${cfg.maxExpiry}s).`);
+		return value;
+	}
+};
+StorageService = __decorate([
+	Injectable(),
+	__decorateParam(0, Inject(STORAGE_OPTIONS)),
+	__decorateParam(1, Inject(StorageManagerService)),
+	__decorateMetadata("design:paramtypes", [Object, typeof StorageManagerService === "undefined" ? Object : StorageManagerService])
+], StorageService);
+//#endregion
+export { StorageService };
+
+//# sourceMappingURL=storage.service.js.map

package/dist/storage/storage.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.service.js","names":[],"sources":["../../src/storage/storage.service.ts"],"sourcesContent":["import { Inject, Injectable } from '@velajs/vela';\nimport {\n  joinStoragePath,\n  type DownloadResult,\n  type PresignedUrlResult,\n  type PresignMethod,\n  type StorageBody,\n  type UploadOptions,\n  type UploadResult,\n} from '@velajs/vela/storage';\nimport { StorageManagerService } from './storage-manager.service';\nimport { STORAGE_OPTIONS } from './storage.tokens';\nimport type { StorageModuleOptions } from './storage.types';\n\nconst DEFAULT_PRESIGN = { defaultExpiry: 3600, maxExpiry: 86400 };\n\n/**\n * Multi-disk storage facade. Applies each disk's (templated) root, resolves the\n * driver, and validates presign expiry. Injectable anywhere via `StorageService`.\n */\n@Injectable()\nexport class StorageService {\n  constructor(\n    @Inject(STORAGE_OPTIONS) private readonly options: StorageModuleOptions,\n    @Inject(StorageManagerService) private readonly manager: StorageManagerService,\n  ) {}\n\n  put(\n    relativePath: string,\n    body: StorageBody,\n    options: UploadOptions = {},\n    disk?: string,\n  ): Promise<UploadResult> {\n    const name = this.resolveDisk(disk);\n    return this.manager.getDriver(name).upload(body, this.fullPath(relativePath, name), options);\n  }\n\n  get(relativePath: string, disk?: string): Promise<DownloadResult> {\n    const name = this.resolveDisk(disk);\n    return this.manager.getDriver(name).download(this.fullPath(relativePath, name));\n  }\n\n  delete(relativePath: string, disk?: string): Promise<void> {\n    const name = this.resolveDisk(disk);\n    return this.manager.getDriver(name).delete(this.fullPath(relativePath, name));\n  }\n\n  exists(relativePath: string, disk?: string): Promise<boolean> {\n    const name = this.resolveDisk(disk);\n    return this.manager.getDriver(name).exists(this.fullPath(relativePath, name));\n  }\n\n  url(\n    relativePath: string,\n    method: PresignMethod = 'GET',\n    expiresIn?: number,\n    disk?: string,\n  ): Promise<PresignedUrlResult> {\n    const name = this.resolveDisk(disk);\n    return this.manager\n      .getDriver(name)\n      .getPresignedUrl(this.fullPath(relativePath, name), method, this.validateExpiry(expiresIn));\n  }\n\n  private resolveDisk(disk?: string): string {\n    const name = disk ?? this.options.defaultDisk;\n    if (!this.manager.hasDisk(name)) throw new Error(`Storage disk \"${name}\" is not configured.`);\n    return name;\n  }\n\n  private fullPath(relativePath: string, disk: string): string {\n    return joinStoragePath(this.manager.getDiskConfig(disk).root, relativePath);\n  }\n\n  private validateExpiry(expiresIn?: number): number {\n    const cfg = this.options.presignedUrl ?? DEFAULT_PRESIGN;\n    const value = expiresIn ?? cfg.defaultExpiry;\n    // `Number.isSafeInteger` rejects NaN/fractional/infinite values — otherwise\n    // `NaN < 1 || NaN > max` is false,\n    // NaN slips through, signUrl omits `expires`, and the URL never expires.\n    if (!Number.isSafeInteger(value) || value < 1 || value > cfg.maxExpiry) {\n      throw new Error(`Presigned URL expiry ${value}s is out of range (1–${cfg.maxExpiry}s).`);\n    }\n    return value;\n  }\n}\n"],"mappings":";;;;;;;;AAcA,MAAM,kBAAkB;CAAE,eAAe;CAAM,WAAW;AAAM;AAOzD,IAAM,iBAAN,MAAM,eAAe;CAEkB;CACM;CAFlD,YACE,SACA,SACA;EAF0C,KAAA,UAAA;EACM,KAAA,UAAA;CAC/C;CAEH,IACE,cACA,MACA,UAAyB,CAAC,GAC1B,MACuB;EACvB,MAAM,OAAO,KAAK,YAAY,IAAI;EAClC,OAAO,KAAK,QAAQ,UAAU,IAAI,CAAC,CAAC,OAAO,MAAM,KAAK,SAAS,cAAc,IAAI,GAAG,OAAO;CAC7F;CAEA,IAAI,cAAsB,MAAwC;EAChE,MAAM,OAAO,KAAK,YAAY,IAAI;EAClC,OAAO,KAAK,QAAQ,UAAU,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,cAAc,IAAI,CAAC;CAChF;CAEA,OAAO,cAAsB,MAA8B;EACzD,MAAM,OAAO,KAAK,YAAY,IAAI;EAClC,OAAO,KAAK,QAAQ,UAAU,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,cAAc,IAAI,CAAC;CAC9E;CAEA,OAAO,cAAsB,MAAiC;EAC5D,MAAM,OAAO,KAAK,YAAY,IAAI;EAClC,OAAO,KAAK,QAAQ,UAAU,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,cAAc,IAAI,CAAC;CAC9E;CAEA,IACE,cACA,SAAwB,OACxB,WACA,MAC6B;EAC7B,MAAM,OAAO,KAAK,YAAY,IAAI;EAClC,OAAO,KAAK,QACT,UAAU,IAAI,CAAC,CACf,gBAAgB,KAAK,SAAS,cAAc,IAAI,GAAG,QAAQ,KAAK,eAAe,SAAS,CAAC;CAC9F;CAEA,YAAoB,MAAuB;EACzC,MAAM,OAAO,QAAQ,KAAK,QAAQ;EAClC,IAAI,CAAC,KAAK,QAAQ,QAAQ,IAAI,GAAG,MAAM,IAAI,MAAM,iBAAiB,KAAK,qBAAqB;EAC5F,OAAO;CACT;CAEA,SAAiB,cAAsB,MAAsB;EAC3D,OAAO,gBAAgB,KAAK,QAAQ,cAAc,IAAI,CAAC,CAAC,MAAM,YAAY;CAC5E;CAEA,eAAuB,WAA4B;EACjD,MAAM,MAAM,KAAK,QAAQ,gBAAgB;EACzC,MAAM,QAAQ,aAAa,IAAI;EAI/B,IAAI,CAAC,OAAO,cAAc,KAAK,KAAK,QAAQ,KAAK,QAAQ,IAAI,WAC3D,MAAM,IAAI,MAAM,wBAAwB,MAAM,uBAAuB,IAAI,UAAU,IAAI;EAEzF,OAAO;CACT;AACF;;CAjEC,WAAW;CAGP,gBAAA,GAAA,OAAO,eAAe,CAAA;CACtB,gBAAA,GAAA,OAAO,qBAAqB,CAAA"}

package/dist/storage/storage.tokens.js

@@ -0,0 +1,7 @@
+import { InjectionToken } from "@velajs/vela";
+//#region src/storage/storage.tokens.ts
+const STORAGE_OPTIONS = new InjectionToken("STORAGE_OPTIONS");
+//#endregion
+export { STORAGE_OPTIONS };
+
+//# sourceMappingURL=storage.tokens.js.map

package/dist/storage/storage.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.tokens.js","names":[],"sources":["../../src/storage/storage.tokens.ts"],"sourcesContent":["import { InjectionToken } from '@velajs/vela';\nimport type { StorageModuleOptions } from './storage.types';\n\nexport const STORAGE_OPTIONS = new InjectionToken<StorageModuleOptions>('STORAGE_OPTIONS');\n"],"mappings":";;AAGA,MAAa,kBAAkB,IAAI,eAAqC,iBAAiB"}

package/dist/vela-env-DFvyoNT3.d.ts

@@ -0,0 +1,9 @@
+//#region src/vela-env.d.ts
+declare module '@velajs/vela' {
+  /**
+   * On Workers the framework ENV is the native environment: the bindings,
+   * variables and secrets `wrangler types` declares on `Cloudflare.Env`.
+   */
+  interface VelaEnv extends Cloudflare.Env {}
+}
+export {};

package/dist/websocket/broadcast.js

@@ -0,0 +1,32 @@
+import { roomToDurableId } from "./room-id.js";
+import { DEFAULT_WS_MAX_FRAME_BYTES, assertBroadcastCommandFits, resolveMaxFrameBytes } from "@velajs/vela/websocket";
+//#region src/websocket/broadcast.ts
+/**
+* Push to a room from a Worker HTTP handler / cron / queue consumer (server-
+* initiated emit). Resolves the room's Durable Object and calls its `broadcast`
+* RPC method — the same canonical room→DO mapping the upgrade route uses, so it
+* always reaches the DO holding those sockets.
+*
+* @example
+* ```ts
+* // In a controller — ns from the typed Worker environment
+* await broadcastToRoom(ns, '/orgs/:orgId/ws', `org:${id}`, 'order.created', order);
+* ```
+*/
+async function broadcastToRoom(ns, gatewayPath, room, event, data, options) {
+	const cmd = {
+		rooms: [room],
+		exceptIds: options?.exceptIds,
+		frame: JSON.stringify({
+			event,
+			data
+		})
+	};
+	const maxFrameBytes = resolveMaxFrameBytes({ maxFrameBytes: options?.maxFrameBytes ?? DEFAULT_WS_MAX_FRAME_BYTES });
+	assertBroadcastCommandFits(cmd, maxFrameBytes);
+	await ns.get(roomToDurableId(ns, gatewayPath, room)).broadcast(cmd);
+}
+//#endregion
+export { broadcastToRoom };
+
+//# sourceMappingURL=broadcast.js.map

package/dist/websocket/broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.js","names":[],"sources":["../../src/websocket/broadcast.ts"],"sourcesContent":["import {\n  assertBroadcastCommandFits,\n  DEFAULT_WS_MAX_FRAME_BYTES,\n  resolveMaxFrameBytes,\n} from '@velajs/vela/websocket';\nimport type { BroadcastCommand } from '@velajs/vela/websocket';\nimport { roomToDurableId } from './room-id';\n\nexport interface WsBroadcastStub {\n  broadcast(cmd: BroadcastCommand): Promise<void>;\n}\n\nexport interface BroadcastNamespace {\n  idFromName(name: string): DurableObjectId;\n  get(id: DurableObjectId): WsBroadcastStub;\n}\n\n/**\n * Push to a room from a Worker HTTP handler / cron / queue consumer (server-\n * initiated emit). Resolves the room's Durable Object and calls its `broadcast`\n * RPC method — the same canonical room→DO mapping the upgrade route uses, so it\n * always reaches the DO holding those sockets.\n *\n * @example\n * ```ts\n * // In a controller — ns from the typed Worker environment\n * await broadcastToRoom(ns, '/orgs/:orgId/ws', `org:${id}`, 'order.created', order);\n * ```\n */\nexport async function broadcastToRoom(\n  ns: BroadcastNamespace,\n  gatewayPath: string,\n  room: string,\n  event: string,\n  data?: unknown,\n  options?: { exceptIds?: string[]; maxFrameBytes?: number },\n): Promise<void> {\n  const cmd: BroadcastCommand = {\n    rooms: [room],\n    exceptIds: options?.exceptIds,\n    frame: JSON.stringify({ event, data }),\n  };\n  const maxFrameBytes = resolveMaxFrameBytes({\n    maxFrameBytes: options?.maxFrameBytes ?? DEFAULT_WS_MAX_FRAME_BYTES,\n  });\n  assertBroadcastCommandFits(cmd, maxFrameBytes);\n  const stub = ns.get(roomToDurableId(ns, gatewayPath, room));\n  await stub.broadcast(cmd);\n}\n"],"mappings":";;;;;;;;;;;;;;;AA6BA,eAAsB,gBACpB,IACA,aACA,MACA,OACA,MACA,SACe;CACf,MAAM,MAAwB;EAC5B,OAAO,CAAC,IAAI;EACZ,WAAW,SAAS;EACpB,OAAO,KAAK,UAAU;GAAE;GAAO;EAAK,CAAC;CACvC;CACA,MAAM,gBAAgB,qBAAqB,EACzC,eAAe,SAAS,iBAAiB,2BAC3C,CAAC;CACD,2BAA2B,KAAK,aAAa;CAE7C,MADa,GAAG,IAAI,gBAAgB,IAAI,aAAa,IAAI,CAChD,CAAC,CAAC,UAAU,GAAG;AAC1B"}

package/dist/websocket/cf-room-registry.js

@@ -0,0 +1,137 @@
+import { rejectedAttachment, socketAttachment } from "./ws-attachment.js";
+import { CfWsClient } from "./cf-ws-client.js";
+import { WebSocketSendGate } from "@velajs/vela/websocket";
+//#region src/websocket/cf-room-registry.ts
+/**
+* Core `RoomRegistry` backed by a Durable Object's hibernatable sockets. Room
+* membership lives in tags (hub room, set at accept) + the attachment (dynamic
+* `join()`), never in DO instance fields — so it survives hibernation with zero
+* rehydration.
+*/
+var CfRoomRegistry = class {
+	ctx;
+	#sendGates = /* @__PURE__ */ new WeakMap();
+	#admitting = /* @__PURE__ */ new WeakSet();
+	#sendPolicyForPath;
+	setSendPolicyResolver(resolve) {
+		this.#sendPolicyForPath = resolve;
+	}
+	deliveryAuthorizer;
+	frameLimitForPath;
+	constructor(ctx) {
+		this.ctx = ctx;
+	}
+	setDeliveryAuthorizer(authorizer) {
+		this.deliveryAuthorizer = authorizer;
+	}
+	/** Reconcile pre-migration/woken attachments with authoritative gateway metadata. */
+	setFrameLimitResolver(resolver) {
+		this.frameLimitForPath = resolver;
+	}
+	/**
+	* Run `admit` (the connection hook) with `ws` marked as being admitted, so a
+	* broadcast issued meanwhile (for example `server.emit()` announcing the new
+	* connection) skips the still-pending socket instead of rejecting it.
+	*/
+	async admitting(ws, admit) {
+		this.#admitting.add(ws);
+		try {
+			return await admit();
+		} finally {
+			this.#admitting.delete(ws);
+		}
+	}
+	register(_client) {}
+	leaveAll(_client) {}
+	join(client, room) {
+		return client.join(room);
+	}
+	leave(client, room) {
+		return client.leave(room);
+	}
+	localIdsInRoom(room) {
+		return this.socketsForRoom(room).map((ws) => this.attachmentOf(ws).connId);
+	}
+	deliverLocal(cmd) {
+		const excludeIds = new Set(cmd.exceptIds ?? []);
+		const excludeRooms = cmd.exceptRooms ?? [];
+		const targets = cmd.rooms.length === 0 ? this.ctx.getWebSockets() : this.collectRooms(cmd.rooms);
+		const seen = /* @__PURE__ */ new Set();
+		const selected = [];
+		for (const ws of targets) {
+			const att = this.reconcileFrameLimit(ws, this.attachmentOf(ws));
+			if (att.state === "pending" && this.#admitting.has(ws)) continue;
+			if (att.state !== "active" || att.expiresAtMs !== void 0 && (!Number.isSafeInteger(att.expiresAtMs) || att.expiresAtMs <= Date.now())) {
+				try {
+					att.state = "rejected";
+					ws.serializeAttachment(att);
+					ws.close(1008, "identity expired or connection rejected");
+				} catch {}
+				continue;
+			}
+			if (seen.has(att.connId)) continue;
+			seen.add(att.connId);
+			if (excludeIds.has(att.connId)) continue;
+			if (excludeRooms.some((r) => att.rooms.includes(r))) continue;
+			selected.push({
+				ws,
+				client: this.clientFor(ws)
+			});
+		}
+		if (!this.deliveryAuthorizer) {
+			for (const { client } of selected) client.sendRaw(cmd.frame);
+			return;
+		}
+		return Promise.all(selected.map(async ({ ws, client }) => {
+			let allowed = false;
+			try {
+				allowed = await this.deliveryAuthorizer(client) === true;
+			} catch {
+				allowed = false;
+			}
+			if (allowed) client.sendRaw(cmd.frame);
+			else this.reject(ws, "delivery authorization revoked");
+		})).then(() => void 0);
+	}
+	collectRooms(rooms) {
+		const set = /* @__PURE__ */ new Set();
+		for (const room of rooms) for (const ws of this.socketsForRoom(room)) set.add(ws);
+		return [...set];
+	}
+	socketsForRoom(room) {
+		return this.ctx.getWebSockets().filter((ws) => this.attachmentOf(ws).rooms.includes(room));
+	}
+	attachmentOf(ws) {
+		return socketAttachment(ws) ?? rejectedAttachment();
+	}
+	/** Reconstruct a `WsClient` for a raw socket (e.g. inside gateway lifecycle scans). */
+	clientFor(ws) {
+		this.reconcileFrameLimit(ws, this.attachmentOf(ws));
+		let gate = this.#sendGates.get(ws);
+		if (!gate) {
+			gate = new WebSocketSendGate(this.#sendPolicyForPath?.(this.attachmentOf(ws).path));
+			this.#sendGates.set(ws, gate);
+		}
+		return new CfWsClient(this.ctx, ws, gate);
+	}
+	reconcileFrameLimit(ws, attachment) {
+		const expected = this.frameLimitForPath?.(attachment.path);
+		if (expected !== void 0 && attachment.maxFrameBytes !== expected) {
+			attachment.maxFrameBytes = expected;
+			ws.serializeAttachment(attachment);
+		}
+		return attachment;
+	}
+	reject(ws, reason) {
+		try {
+			const attachment = this.attachmentOf(ws);
+			attachment.state = "rejected";
+			ws.serializeAttachment(attachment);
+			ws.close(1008, reason);
+		} catch {}
+	}
+};
+//#endregion
+export { CfRoomRegistry };
+
+//# sourceMappingURL=cf-room-registry.js.map

package/dist/websocket/cf-room-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cf-room-registry.js","names":[],"sources":["../../src/websocket/cf-room-registry.ts"],"sourcesContent":["import { WebSocketSendGate, type WebSocketSendPolicy } from '@velajs/vela/websocket';\nimport { socketAttachment, rejectedAttachment } from './ws-attachment';\nimport type { BroadcastCommand, RoomRegistry, WsClient } from '@velajs/vela/websocket';\nimport type { DoStateLike, WsAttachment, WsLike } from './do-state';\nimport { CfWsClient } from './cf-ws-client';\n\n/**\n * Core `RoomRegistry` backed by a Durable Object's hibernatable sockets. Room\n * membership lives in tags (hub room, set at accept) + the attachment (dynamic\n * `join()`), never in DO instance fields — so it survives hibernation with zero\n * rehydration.\n */\nexport class CfRoomRegistry implements RoomRegistry {\n  readonly #sendGates = new WeakMap<WsLike, WebSocketSendGate>();\n  // Sockets whose OnGatewayConnection hook is running in this instance. They\n  // are still `pending`, so broadcasts skip them; any other pending socket\n  // never finished admission and is closed when a broadcast reaches it.\n  readonly #admitting = new WeakSet<WsLike>();\n  #sendPolicyForPath?: (path: string) => WebSocketSendPolicy | undefined;\n\n  setSendPolicyResolver(resolve: (path: string) => WebSocketSendPolicy | undefined): void {\n    this.#sendPolicyForPath = resolve;\n  }\n\n  private deliveryAuthorizer?: (client: WsClient) => boolean | Promise<boolean>;\n  private frameLimitForPath?: (path: string) => number | undefined;\n\n  constructor(private readonly ctx: DoStateLike) {}\n\n  setDeliveryAuthorizer(authorizer: (client: WsClient) => boolean | Promise<boolean>): void {\n    this.deliveryAuthorizer = authorizer;\n  }\n\n  /** Reconcile pre-migration/woken attachments with authoritative gateway metadata. */\n  setFrameLimitResolver(resolver: (path: string) => number | undefined): void {\n    this.frameLimitForPath = resolver;\n  }\n\n  /**\n   * Run `admit` (the connection hook) with `ws` marked as being admitted, so a\n   * broadcast issued meanwhile (for example `server.emit()` announcing the new\n   * connection) skips the still-pending socket instead of rejecting it.\n   */\n  async admitting<T>(ws: WsLike, admit: () => Promise<T>): Promise<T> {\n    this.#admitting.add(ws);\n    try {\n      return await admit();\n    } finally {\n      this.#admitting.delete(ws);\n    }\n  }\n\n  // CF sockets are registered with the DO by `acceptWebSocket`; nothing to track.\n  register(_client: WsClient): void {}\n  leaveAll(_client: WsClient): void {}\n\n  join(client: WsClient, room: string): void | Promise<void> {\n    return client.join(room);\n  }\n\n  leave(client: WsClient, room: string): void | Promise<void> {\n    return client.leave(room);\n  }\n\n  localIdsInRoom(room: string): string[] {\n    return this.socketsForRoom(room).map((ws) => this.attachmentOf(ws).connId);\n  }\n\n  deliverLocal(cmd: BroadcastCommand): void | Promise<void> {\n    const excludeIds = new Set(cmd.exceptIds ?? []);\n    const excludeRooms = cmd.exceptRooms ?? [];\n\n    // Empty `rooms` => GLOBAL (every socket in this DO). Otherwise the union of\n    // targeted rooms, deduped per connection.\n    const targets =\n      cmd.rooms.length === 0 ? this.ctx.getWebSockets() : this.collectRooms(cmd.rooms);\n\n    const seen = new Set<string>();\n    const selected: Array<{ ws: WsLike; client: WsClient }> = [];\n    for (const ws of targets) {\n      const att = this.reconcileFrameLimit(ws, this.attachmentOf(ws));\n      // A socket still in its connection hook is not admitted yet: it receives no\n      // room frames, and its own accept() settles it. Rejecting it here would\n      // close every client whose handleConnection broadcasts to the room. Other\n      // pending sockets fall through and are rejected below.\n      if (att.state === 'pending' && this.#admitting.has(ws)) continue;\n      if (\n        att.state !== 'active' ||\n        (att.expiresAtMs !== undefined &&\n          (!Number.isSafeInteger(att.expiresAtMs) || att.expiresAtMs <= Date.now()))\n      ) {\n        try {\n          att.state = 'rejected';\n          ws.serializeAttachment(att);\n          ws.close(1008, 'identity expired or connection rejected');\n        } catch {\n          // already closed or malformed attachment\n        }\n        continue;\n      }\n      if (seen.has(att.connId)) continue;\n      seen.add(att.connId);\n      if (excludeIds.has(att.connId)) continue;\n      if (excludeRooms.some((r) => att.rooms.includes(r))) continue;\n      selected.push({ ws, client: this.clientFor(ws) });\n    }\n\n    if (!this.deliveryAuthorizer) {\n      for (const { client } of selected) client.sendRaw(cmd.frame);\n      return;\n    }\n    return Promise.all(\n      selected.map(async ({ ws, client }) => {\n        let allowed = false;\n        try {\n          allowed = (await this.deliveryAuthorizer!(client)) === true;\n        } catch {\n          allowed = false;\n        }\n        if (allowed) client.sendRaw(cmd.frame);\n        else this.reject(ws, 'delivery authorization revoked');\n      }),\n    ).then(() => undefined);\n  }\n\n  private collectRooms(rooms: string[]): WsLike[] {\n    const set = new Set<WsLike>();\n    for (const room of rooms) for (const ws of this.socketsForRoom(room)) set.add(ws);\n    return [...set];\n  }\n\n  private socketsForRoom(room: string): WsLike[] {\n    // Membership is the attachment's `rooms`, NOT the hibernation tag: tags are\n    // immutable after acceptWebSocket, so a socket that left its hub room still\n    // carries the tag. Since one DO ≈ one room, scanning all sockets in the DO\n    // and filtering by attachment is both correct and cheap.\n    return this.ctx.getWebSockets().filter((ws) => this.attachmentOf(ws).rooms.includes(room));\n  }\n\n  private attachmentOf(ws: WsLike): WsAttachment {\n    return socketAttachment(ws) ?? rejectedAttachment();\n  }\n\n  /** Reconstruct a `WsClient` for a raw socket (e.g. inside gateway lifecycle scans). */\n  clientFor(ws: WsLike): CfWsClient {\n    this.reconcileFrameLimit(ws, this.attachmentOf(ws));\n    let gate = this.#sendGates.get(ws);\n    if (!gate) {\n      gate = new WebSocketSendGate(this.#sendPolicyForPath?.(this.attachmentOf(ws).path));\n      this.#sendGates.set(ws, gate);\n    }\n    return new CfWsClient(this.ctx, ws, gate);\n  }\n\n  private reconcileFrameLimit(ws: WsLike, attachment: WsAttachment): WsAttachment {\n    const expected = this.frameLimitForPath?.(attachment.path);\n    if (expected !== undefined && attachment.maxFrameBytes !== expected) {\n      attachment.maxFrameBytes = expected;\n      ws.serializeAttachment(attachment);\n    }\n    return attachment;\n  }\n\n  private reject(ws: WsLike, reason: string): void {\n    try {\n      const attachment = this.attachmentOf(ws);\n      attachment.state = 'rejected';\n      ws.serializeAttachment(attachment);\n      ws.close(1008, reason);\n    } catch {\n      // already closed or malformed attachment\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/websocket/cf-ws-client.js

@@ -0,0 +1,94 @@
+import { rejectedAttachment, socketAttachment } from "./ws-attachment.js";
+import { MAX_WS_ATTACHMENT_BYTES } from "./do-state.js";
+import { DEFAULT_WS_MAX_FRAME_BYTES, DEFAULT_WS_MAX_JOINED_ROOMS, WebSocketSendGate, assertWebSocketRoomId } from "@velajs/vela/websocket";
+//#region src/websocket/cf-ws-client.ts
+const encoder = new TextEncoder();
+/**
+* Core `WsClient` over a native Cloudflare `WebSocket` inside a Durable Object.
+* Per-connection state lives in the hibernation attachment (survives eviction),
+* so a fresh `CfWsClient` is reconstructed per message with no in-memory state.
+*/
+var CfWsClient = class {
+	ctx;
+	ws;
+	sendGate;
+	#attachment;
+	constructor(ctx, ws, sendGate = new WebSocketSendGate()) {
+		this.ctx = ctx;
+		this.ws = ws;
+		this.sendGate = sendGate;
+		this.#attachment = socketAttachment(ws) ?? rejectedAttachment();
+	}
+	get id() {
+		return this.#attachment.connId;
+	}
+	/** The gateway route path this socket connected on (used to route messages). */
+	get path() {
+		return this.#attachment.path;
+	}
+	get rooms() {
+		return new Set(this.#attachment.rooms);
+	}
+	get data() {
+		return this.#attachment.data;
+	}
+	set data(value) {
+		this.#attachment.data = value;
+	}
+	get raw() {
+		return this.ws;
+	}
+	get maxFrameBytes() {
+		const value = this.#attachment.maxFrameBytes;
+		return typeof value === "number" && Number.isSafeInteger(value) && value > 0 ? value : DEFAULT_WS_MAX_FRAME_BYTES;
+	}
+	send(event, data, id) {
+		this.sendRaw(JSON.stringify(id !== void 0 ? {
+			id,
+			event,
+			data
+		} : {
+			event,
+			data
+		}));
+	}
+	sendRaw(payload) {
+		this.trySendRaw(payload);
+	}
+	trySendRaw(payload) {
+		if (this.#attachment.state === "rejected") return "closed";
+		return this.sendGate.trySend(this.ws, payload, this.maxFrameBytes);
+	}
+	join(room) {
+		assertWebSocketRoomId(room);
+		if (!this.#attachment.rooms.includes(room)) {
+			if (this.#attachment.rooms.length >= DEFAULT_WS_MAX_JOINED_ROOMS) throw new Error(`A WebSocket may join at most ${DEFAULT_WS_MAX_JOINED_ROOMS} rooms`);
+			this.#attachment.rooms.push(room);
+			this.persist();
+		}
+	}
+	leave(room) {
+		const next = this.#attachment.rooms.filter((r) => r !== room);
+		if (next.length !== this.#attachment.rooms.length) {
+			this.#attachment.rooms = next;
+			this.persist();
+		}
+	}
+	/** Persist `data`/room mutations to the hibernation attachment. */
+	commit() {
+		this.persist();
+	}
+	close(code, reason) {
+		this.ws.close(code, reason);
+	}
+	persist() {
+		if (this.#attachment.state === "rejected") throw new Error("Invalid WebSocket attachment");
+		const serialized = JSON.stringify(this.#attachment);
+		if (encoder.encode(serialized).length > MAX_WS_ATTACHMENT_BYTES) throw new Error("WebSocket attachment exceeds the 16 KiB Cloudflare limit. Store large per-connection state in Durable Object storage keyed by connId instead.");
+		this.ws.serializeAttachment(this.#attachment);
+	}
+};
+//#endregion
+export { CfWsClient };
+
+//# sourceMappingURL=cf-ws-client.js.map

package/dist/websocket/cf-ws-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cf-ws-client.js","names":[],"sources":["../../src/websocket/cf-ws-client.ts"],"sourcesContent":["import { socketAttachment, rejectedAttachment } from './ws-attachment';\nimport type { WebSocketSendResult, WsClient } from '@velajs/vela/websocket';\nimport {\n  assertWebSocketRoomId,\n  DEFAULT_WS_MAX_FRAME_BYTES,\n  DEFAULT_WS_MAX_JOINED_ROOMS,\n  WebSocketSendGate,\n} from '@velajs/vela/websocket';\nimport {\n  MAX_WS_ATTACHMENT_BYTES,\n  type DoStateLike,\n  type WsAttachment,\n  type WsLike,\n} from './do-state';\nconst encoder = new TextEncoder();\n\n/**\n * Core `WsClient` over a native Cloudflare `WebSocket` inside a Durable Object.\n * Per-connection state lives in the hibernation attachment (survives eviction),\n * so a fresh `CfWsClient` is reconstructed per message with no in-memory state.\n */\nexport class CfWsClient<\n  TData extends Record<string, unknown> = Record<string, unknown>,\n> implements WsClient<TData> {\n  readonly #attachment: WsAttachment;\n\n  constructor(\n    private readonly ctx: DoStateLike,\n    private readonly ws: WsLike,\n    private readonly sendGate = new WebSocketSendGate(),\n  ) {\n    this.#attachment = socketAttachment(ws) ?? rejectedAttachment();\n  }\n\n  get id(): string {\n    return this.#attachment.connId;\n  }\n\n  /** The gateway route path this socket connected on (used to route messages). */\n  get path(): string {\n    return this.#attachment.path;\n  }\n\n  get rooms(): ReadonlySet<string> {\n    return new Set(this.#attachment.rooms);\n  }\n\n  get data(): TData {\n    return this.#attachment.data as TData;\n  }\n\n  set data(value: TData) {\n    this.#attachment.data = value;\n  }\n\n  get raw(): unknown {\n    return this.ws;\n  }\n\n  get maxFrameBytes(): number {\n    const value = this.#attachment.maxFrameBytes;\n    return typeof value === 'number' && Number.isSafeInteger(value) && value > 0\n      ? value\n      : DEFAULT_WS_MAX_FRAME_BYTES;\n  }\n\n  send(event: string, data?: unknown, id?: string): void {\n    this.sendRaw(JSON.stringify(id !== undefined ? { id, event, data } : { event, data }));\n  }\n\n  sendRaw(payload: string): void {\n    this.trySendRaw(payload);\n  }\n\n  trySendRaw(payload: string): WebSocketSendResult {\n    if (this.#attachment.state === 'rejected') return 'closed';\n    return this.sendGate.trySend(this.ws, payload, this.maxFrameBytes);\n  }\n\n  join(room: string): void {\n    assertWebSocketRoomId(room);\n    if (!this.#attachment.rooms.includes(room)) {\n      if (this.#attachment.rooms.length >= DEFAULT_WS_MAX_JOINED_ROOMS) {\n        throw new Error(`A WebSocket may join at most ${DEFAULT_WS_MAX_JOINED_ROOMS} rooms`);\n      }\n      this.#attachment.rooms.push(room);\n      this.persist();\n    }\n  }\n\n  leave(room: string): void {\n    const next = this.#attachment.rooms.filter((r) => r !== room);\n    if (next.length !== this.#attachment.rooms.length) {\n      this.#attachment.rooms = next;\n      this.persist();\n    }\n  }\n\n  /** Persist `data`/room mutations to the hibernation attachment. */\n  commit(): void {\n    this.persist();\n  }\n\n  close(code?: number, reason?: string): void {\n    this.ws.close(code, reason);\n  }\n\n  private persist(): void {\n    if (this.#attachment.state === 'rejected') throw new Error('Invalid WebSocket attachment');\n    const serialized = JSON.stringify(this.#attachment);\n    if (encoder.encode(serialized).length > MAX_WS_ATTACHMENT_BYTES) {\n      throw new Error(\n        `WebSocket attachment exceeds the 16 KiB Cloudflare limit. Store large ` +\n          `per-connection state in Durable Object storage keyed by connId instead.`,\n      );\n    }\n    this.ws.serializeAttachment(this.#attachment);\n  }\n}\n"],"mappings":";;;;AAcA,MAAM,UAAU,IAAI,YAAY;;;;;;AAOhC,IAAa,aAAb,MAE6B;CAIR;CACA;CACA;CALnB;CAEA,YACE,KACA,IACA,WAA4B,IAAI,kBAAkB,GAClD;EAHiB,KAAA,MAAA;EACA,KAAA,KAAA;EACA,KAAA,WAAA;EAEjB,KAAK,cAAc,iBAAiB,EAAE,KAAK,mBAAmB;CAChE;CAEA,IAAI,KAAa;EACf,OAAO,KAAK,YAAY;CAC1B;;CAGA,IAAI,OAAe;EACjB,OAAO,KAAK,YAAY;CAC1B;CAEA,IAAI,QAA6B;EAC/B,OAAO,IAAI,IAAI,KAAK,YAAY,KAAK;CACvC;CAEA,IAAI,OAAc;EAChB,OAAO,KAAK,YAAY;CAC1B;CAEA,IAAI,KAAK,OAAc;EACrB,KAAK,YAAY,OAAO;CAC1B;CAEA,IAAI,MAAe;EACjB,OAAO,KAAK;CACd;CAEA,IAAI,gBAAwB;EAC1B,MAAM,QAAQ,KAAK,YAAY;EAC/B,OAAO,OAAO,UAAU,YAAY,OAAO,cAAc,KAAK,KAAK,QAAQ,IACvE,QACA;CACN;CAEA,KAAK,OAAe,MAAgB,IAAmB;EACrD,KAAK,QAAQ,KAAK,UAAU,OAAO,KAAA,IAAY;GAAE;GAAI;GAAO;EAAK,IAAI;GAAE;GAAO;EAAK,CAAC,CAAC;CACvF;CAEA,QAAQ,SAAuB;EAC7B,KAAK,WAAW,OAAO;CACzB;CAEA,WAAW,SAAsC;EAC/C,IAAI,KAAK,YAAY,UAAU,YAAY,OAAO;EAClD,OAAO,KAAK,SAAS,QAAQ,KAAK,IAAI,SAAS,KAAK,aAAa;CACnE;CAEA,KAAK,MAAoB;EACvB,sBAAsB,IAAI;EAC1B,IAAI,CAAC,KAAK,YAAY,MAAM,SAAS,IAAI,GAAG;GAC1C,IAAI,KAAK,YAAY,MAAM,UAAU,6BACnC,MAAM,IAAI,MAAM,gCAAgC,4BAA4B,OAAO;GAErF,KAAK,YAAY,MAAM,KAAK,IAAI;GAChC,KAAK,QAAQ;EACf;CACF;CAEA,MAAM,MAAoB;EACxB,MAAM,OAAO,KAAK,YAAY,MAAM,QAAQ,MAAM,MAAM,IAAI;EAC5D,IAAI,KAAK,WAAW,KAAK,YAAY,MAAM,QAAQ;GACjD,KAAK,YAAY,QAAQ;GACzB,KAAK,QAAQ;EACf;CACF;;CAGA,SAAe;EACb,KAAK,QAAQ;CACf;CAEA,MAAM,MAAe,QAAuB;EAC1C,KAAK,GAAG,MAAM,MAAM,MAAM;CAC5B;CAEA,UAAwB;EACtB,IAAI,KAAK,YAAY,UAAU,YAAY,MAAM,IAAI,MAAM,8BAA8B;EACzF,MAAM,aAAa,KAAK,UAAU,KAAK,WAAW;EAClD,IAAI,QAAQ,OAAO,UAAU,CAAC,CAAC,SAAS,yBACtC,MAAM,IAAI,MACR,+IAEF;EAEF,KAAK,GAAG,oBAAoB,KAAK,WAAW;CAC9C;AACF"}

package/dist/websocket/cloudflare-websocket.module.js

@@ -0,0 +1,25 @@
+import { WsServerHolder } from "./ws-server-holder.js";
+import { defineProvider } from "@velajs/vela";
+import { WS_SERVER, WsDispatcher } from "@velajs/vela/websocket";
+//#region src/websocket/cloudflare-websocket.module.ts
+/**
+* Cloudflare counterpart to the core `WebSocketModule.forRoot()`. Import this in
+* your `AppModule` instead: it provides the gateway dispatcher plus a late-bound
+* `WS_SERVER` (`WsServerHolder`) that the WebSocket Durable Object wires to a
+* ctx-backed server per instance. `useClass` ensures a fresh holder per DI
+* container so colocated DO instances never share a server.
+*/
+var CloudflareWebSocketModule = class CloudflareWebSocketModule {
+	static forRoot() {
+		const providers = [defineProvider(WS_SERVER, { useClass: WsServerHolder }), WsDispatcher];
+		return {
+			module: CloudflareWebSocketModule,
+			providers,
+			exports: [WS_SERVER, WsDispatcher]
+		};
+	}
+};
+//#endregion
+export { CloudflareWebSocketModule };
+
+//# sourceMappingURL=cloudflare-websocket.module.js.map

package/dist/websocket/cloudflare-websocket.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-websocket.module.js","names":[],"sources":["../../src/websocket/cloudflare-websocket.module.ts"],"sourcesContent":["import { defineProvider, type DynamicModule } from '@velajs/vela';\nimport { WsDispatcher, WS_SERVER } from '@velajs/vela/websocket';\nimport { WsServerHolder } from './ws-server-holder';\n\n/**\n * Cloudflare counterpart to the core `WebSocketModule.forRoot()`. Import this in\n * your `AppModule` instead: it provides the gateway dispatcher plus a late-bound\n * `WS_SERVER` (`WsServerHolder`) that the WebSocket Durable Object wires to a\n * ctx-backed server per instance. `useClass` ensures a fresh holder per DI\n * container so colocated DO instances never share a server.\n */\nexport class CloudflareWebSocketModule {\n  static forRoot(): DynamicModule {\n    const providers = [defineProvider(WS_SERVER, { useClass: WsServerHolder }), WsDispatcher];\n\n    return {\n      module: CloudflareWebSocketModule,\n      providers,\n      exports: [WS_SERVER, WsDispatcher],\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;AAWA,IAAa,4BAAb,MAAa,0BAA0B;CACrC,OAAO,UAAyB;EAC9B,MAAM,YAAY,CAAC,eAAe,WAAW,EAAE,UAAU,eAAe,CAAC,GAAG,YAAY;EAExF,OAAO;GACL,QAAQ;GACR;GACA,SAAS,CAAC,WAAW,YAAY;EACnC;CACF;AACF"}

package/dist/websocket/do-bootstrap.js

@@ -0,0 +1,56 @@
+import { registerCloudflareEnvironment } from "../environment.js";
+import { CfWsClient } from "./cf-ws-client.js";
+import { initDoLive, initializeDoLiveResources } from "./do-live.js";
+import { WsServerHolder } from "./ws-server-holder.js";
+import { CfRoomRegistry } from "./cf-room-registry.js";
+import { VelaApplication } from "@velajs/vela";
+import { WS_SERVER, WsDispatcher, WsServerImpl, local, readWsEntrypointMeta } from "@velajs/vela/websocket";
+import { bootstrap } from "@velajs/vela/internal";
+//#region src/websocket/do-bootstrap.ts
+/**
+* Slim DI bootstrap for the Durable Object isolate: wires the container and runs
+* `OnModuleInit`/`OnApplicationBootstrap` (so `WsDispatcher` discovers gateways)
+* WITHOUT building the Hono app/routes the DO never serves. The DO's `env` is
+* seeded as the global ENV before providers construct, and the ctx-backed server
+* is bound before bootstrap lifecycle so gateway `afterInit`/handlers see it.
+*/
+async function buildDoRuntime(rootModule, ctx, options) {
+	const { container, routeManager, loader } = await bootstrap(rootModule, { configureContainer: (container) => {
+		registerCloudflareEnvironment(container, options.env);
+	} });
+	const registry = new CfRoomRegistry(ctx);
+	const driver = local();
+	driver.bind(registry);
+	const server = new WsServerImpl(driver);
+	if (container.has(WS_SERVER)) {
+		const holder = await container.resolveAsync(WS_SERVER);
+		if (!(holder instanceof WsServerHolder)) throw new Error("[vela] The WebSocket Durable Object found a WS_SERVER from the core WebSocketModule, which cannot reach Durable Object sockets. On Cloudflare, import CloudflareWebSocketModule.forRoot() instead of WebSocketModule.forRoot().");
+		holder.setTarget(server);
+	}
+	const app = new VelaApplication(container, routeManager);
+	app.setInstances(await loader.resolveAllInstances());
+	initializeDoLiveResources(container, ctx);
+	await app.callOnModuleInit();
+	await app.callOnApplicationBootstrap();
+	const wsEntrypoints = app.entrypoints.ofKind("websocket", readWsEntrypointMeta);
+	const dispatcher = wsEntrypoints[0]?.meta.dispatcher ?? app.get(WsDispatcher);
+	registry.setSendPolicyResolver((path) => wsEntrypoints.find((entry) => entry.meta.path === path)?.meta.options.sendPolicy);
+	registry.setFrameLimitResolver((path) => dispatcher.getGatewayMaxFrameBytes(path));
+	registry.setDeliveryAuthorizer((client) => {
+		const path = client instanceof CfWsClient ? client.path : "";
+		return dispatcher.authorizeDelivery(path, client);
+	});
+	const live = initDoLive(app, ctx, registry);
+	return {
+		dispatcher,
+		registry,
+		server,
+		gatewayPaths: wsEntrypoints.map((ep) => ep.meta.path),
+		live,
+		close: (signal) => app.close(signal)
+	};
+}
+//#endregion
+export { buildDoRuntime };
+
+//# sourceMappingURL=do-bootstrap.js.map

package/dist/websocket/do-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"do-bootstrap.js","names":[],"sources":["../../src/websocket/do-bootstrap.ts"],"sourcesContent":["import { VelaApplication } from '@velajs/vela';\nimport { bootstrap } from '@velajs/vela/internal';\nimport type { DynamicModule, Type, VelaEnv } from '@velajs/vela';\nimport {\n  local,\n  readWsEntrypointMeta,\n  WsDispatcher,\n  WsServerImpl,\n  WS_SERVER,\n} from '@velajs/vela/websocket';\nimport type { WsServer } from '@velajs/vela/websocket';\nimport type { LiveEngine } from '@velajs/vela/live';\nimport { registerCloudflareEnvironment } from '../environment';\nimport { CfWsClient } from './cf-ws-client';\nimport { CfRoomRegistry } from './cf-room-registry';\nimport { initDoLive, initializeDoLiveResources } from './do-live';\nimport type { DoStateLike } from './do-state';\nimport { WsServerHolder } from './ws-server-holder';\n\nexport interface DoRuntime {\n  dispatcher: WsDispatcher;\n  registry: CfRoomRegistry;\n  server: WsServer;\n  /** Gateway paths from `app.entrypoints.ofKind('websocket')` (discovery order). */\n  gatewayPaths: string[];\n  /** The live-query engine (undefined when the app doesn't import LiveModule). */\n  live?: LiveEngine;\n  close(signal?: string): Promise<void>;\n}\n\n/**\n * Slim DI bootstrap for the Durable Object isolate: wires the container and runs\n * `OnModuleInit`/`OnApplicationBootstrap` (so `WsDispatcher` discovers gateways)\n * WITHOUT building the Hono app/routes the DO never serves. The DO's `env` is\n * seeded as the global ENV before providers construct, and the ctx-backed server\n * is bound before bootstrap lifecycle so gateway `afterInit`/handlers see it.\n */\nexport async function buildDoRuntime(\n  rootModule: Type | DynamicModule,\n  ctx: DoStateLike,\n  options: { env: VelaEnv },\n): Promise<DoRuntime> {\n  const { container, routeManager, loader } = await bootstrap(rootModule, {\n    configureContainer: (container) => {\n      registerCloudflareEnvironment(container, options.env);\n    },\n  });\n\n  const registry = new CfRoomRegistry(ctx);\n  const driver = local();\n  driver.bind(registry);\n  const server = new WsServerImpl(driver);\n\n  if (container.has(WS_SERVER)) {\n    const holder = await container.resolveAsync(WS_SERVER);\n    // The core WebSocketModule's server broadcasts through its own sync driver,\n    // which never reaches this Durable Object's hibernatable sockets.\n    if (!(holder instanceof WsServerHolder)) {\n      throw new Error(\n        '[vela] The WebSocket Durable Object found a WS_SERVER from the core WebSocketModule, ' +\n          'which cannot reach Durable Object sockets. On Cloudflare, import ' +\n          'CloudflareWebSocketModule.forRoot() instead of WebSocketModule.forRoot().',\n      );\n    }\n    holder.setTarget(server);\n  }\n\n  const app = new VelaApplication(container, routeManager);\n  app.setInstances(await loader.resolveAllInstances());\n  initializeDoLiveResources(container, ctx);\n  await app.callOnModuleInit();\n  await app.callOnApplicationBootstrap();\n\n  // The entrypoint registry is the transport contract: one 'websocket' entry\n  // per discovered gateway ({ meta: { path, dispatcher } }). Built by\n  // callOnApplicationBootstrap(), so this slim no-routes path has it too.\n  const wsEntrypoints = app.entrypoints.ofKind('websocket', readWsEntrypointMeta);\n  const dispatcher = wsEntrypoints[0]?.meta.dispatcher ?? app.get(WsDispatcher);\n  registry.setSendPolicyResolver(\n    (path) => wsEntrypoints.find((entry) => entry.meta.path === path)?.meta.options.sendPolicy,\n  );\n  registry.setFrameLimitResolver((path) => dispatcher.getGatewayMaxFrameBytes(path));\n  registry.setDeliveryAuthorizer((client) => {\n    const path = client instanceof CfWsClient ? client.path : '';\n    return dispatcher.authorizeDelivery(path, client);\n  });\n\n  // Live queries: wire the SQLite cursor log + local driver mode and replay\n  // hibernation-persisted subscriptions into the fresh engine.\n  const live = initDoLive(app, ctx, registry);\n\n  return {\n    // Zero gateways still yields a live dispatcher (module imported, nothing\n    // decorated) — fall back to resolving it directly.\n    dispatcher,\n    registry,\n    server,\n    gatewayPaths: wsEntrypoints.map((ep) => ep.meta.path),\n    live,\n    close: (signal?: string) => app.close(signal),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAqCA,eAAsB,eACpB,YACA,KACA,SACoB;CACpB,MAAM,EAAE,WAAW,cAAc,WAAW,MAAM,UAAU,YAAY,EACtE,qBAAqB,cAAc;EACjC,8BAA8B,WAAW,QAAQ,GAAG;CACtD,EACF,CAAC;CAED,MAAM,WAAW,IAAI,eAAe,GAAG;CACvC,MAAM,SAAS,MAAM;CACrB,OAAO,KAAK,QAAQ;CACpB,MAAM,SAAS,IAAI,aAAa,MAAM;CAEtC,IAAI,UAAU,IAAI,SAAS,GAAG;EAC5B,MAAM,SAAS,MAAM,UAAU,aAAa,SAAS;EAGrD,IAAI,EAAE,kBAAkB,iBACtB,MAAM,IAAI,MACR,iOAGF;EAEF,OAAO,UAAU,MAAM;CACzB;CAEA,MAAM,MAAM,IAAI,gBAAgB,WAAW,YAAY;CACvD,IAAI,aAAa,MAAM,OAAO,oBAAoB,CAAC;CACnD,0BAA0B,WAAW,GAAG;CACxC,MAAM,IAAI,iBAAiB;CAC3B,MAAM,IAAI,2BAA2B;CAKrC,MAAM,gBAAgB,IAAI,YAAY,OAAO,aAAa,oBAAoB;CAC9E,MAAM,aAAa,cAAc,EAAE,EAAE,KAAK,cAAc,IAAI,IAAI,YAAY;CAC5E,SAAS,uBACN,SAAS,cAAc,MAAM,UAAU,MAAM,KAAK,SAAS,IAAI,CAAC,EAAE,KAAK,QAAQ,UAClF;CACA,SAAS,uBAAuB,SAAS,WAAW,wBAAwB,IAAI,CAAC;CACjF,SAAS,uBAAuB,WAAW;EACzC,MAAM,OAAO,kBAAkB,aAAa,OAAO,OAAO;EAC1D,OAAO,WAAW,kBAAkB,MAAM,MAAM;CAClD,CAAC;CAID,MAAM,OAAO,WAAW,KAAK,KAAK,QAAQ;CAE1C,OAAO;EAGL;EACA;EACA;EACA,cAAc,cAAc,KAAK,OAAO,GAAG,KAAK,IAAI;EACpD;EACA,QAAQ,WAAoB,IAAI,MAAM,MAAM;CAC9C;AACF"}