@neta-art/cohub 12.5.0 → 13.0.0

package/dist/protocol/dist/core/media.js

@@ -5,12 +5,23 @@ const MEDIA_HOSTS = /* @__PURE__ */ new Map([
 		metaHeaders: true
 	}],
 	["oss.talesofai.com", { transform: "oss" }],
-	["public.cohub.live", { transform: "oss" }],
+	["public.cohub.live", {
+		transform: "oss",
+		metaHeaders: true
+	}],
 	["public.cohub.run", { transform: "oss" }],
-	["sessions.cohub.live", { transform: "oss" }],
-	["works.cohub.live", { transform: "oss" }],
+	["sessions.cohub.live", {
+		transform: "oss",
+		metaHeaders: true
+	}],
+	["works.cohub.live", {
+		transform: "oss",
+		metaHeaders: true
+	}],
 	["works.cohub.run", { transform: "oss" }],
-	["cca.neta.art", { transform: "cloudflare" }]
+	["cca.neta.art", { transform: "cloudflare" }],
+	["static.neta.art", { transform: "cloudflare" }],
+	["pages-r2.neta.art", { transform: "cloudflare" }]
 ]);
 const parseHttpsUrl = (url) => {
 	if (!/^https:\/\//i.test(url)) return null;
@@ -24,6 +35,36 @@ function mediaHost(url) {
 	const parsed = parseHttpsUrl(url);
 	return parsed ? MEDIA_HOSTS.get(parsed.hostname) : void 0;
 }
+/** Fixed variant edges keep CDN cache hits high; pick one with `mediaVariantSize`. */
+const MEDIA_VARIANT_SIZES = [
+	192,
+	384,
+	768,
+	1536
+];
+const MEDIA_VARIANT_MAX = 1536;
+/** Smallest variant covering `pixels` device pixels, capped at the largest. */
+function mediaVariantSize(pixels) {
+	return MEDIA_VARIANT_SIZES.find((size) => size >= pixels) ?? 1536;
+}
+const VARIANT_QUALITY = 82;
+const FRAME_GUESS_MAX = 768;
+function fitted(natural, edge, fit) {
+	const bound = fit === "cover" ? Math.min(natural.width, natural.height) : fit === "width" ? natural.width : Math.max(natural.width, natural.height);
+	const scale = Math.min(1, edge / bound);
+	return {
+		width: Math.max(1, Math.round(natural.width * scale)),
+		height: Math.max(1, Math.round(natural.height * scale))
+	};
+}
+const guessedBox = (edge, fit) => fit === "cover" ? edge * 2 : edge;
+const aspectSize = (aspect, edge) => aspect >= 1 ? {
+	width: edge,
+	height: edge / aspect
+} : {
+	width: edge * aspect,
+	height: edge
+};
 const OSS_PROCESS_PATTERN = /[?&]x-oss-process=/;
 /** Append an OSS process to `url`, keeping its query and hash. */
 function ossProcessUrl(url, process) {
@@ -33,13 +74,107 @@ function ossProcessUrl(url, process) {
 	const hash = hashIndex >= 0 ? url.slice(hashIndex) : "";
 	return `${base}${base.includes("?") ? "&" : "?"}x-oss-process=${process}${hash}`;
 }
-const MODEL_IMAGE = {
-	maxEdge: 1280,
-	quality: 75
+const ossProcess = (url, process) => OSS_PROCESS_PATTERN.test(url) ? null : ossProcessUrl(url, process);
+const OSS_RESIZE = {
+	cover: (edge) => `m_mfit,w_${edge},h_${edge}`,
+	contain: (edge) => `m_lfit,w_${edge},h_${edge}`,
+	width: (edge) => `w_${edge}`
+};
+const oss = {
+	fitsFrames: false,
+	image: (url, edge, fit, quality) => ossProcess(url, `image/resize,${OSS_RESIZE[fit](edge)}/quality,q_${quality}/format,webp`),
+	frame: (url, { edge, fit, natural, aspect }) => {
+		const shape = natural ?? (aspect ? aspectSize(aspect, FRAME_GUESS_MAX) : null);
+		const width = shape ? fitted(shape, edge, fit).width : Math.min(guessedBox(edge, fit), FRAME_GUESS_MAX);
+		return ossProcess(url, `video/snapshot,t_0,f_jpg,w_${width},m_fast`);
+	},
+	sizeFrame: (url) => ossProcess(url, "video/snapshot,t_0,f_jpg,w_0,h_0,m_fast"),
+	frameLimit: Number.POSITIVE_INFINITY,
+	imageInfoUrl: (url) => ossProcess(url, "image/info"),
+	readImageInfo: (body) => {
+		const fields = body;
+		return {
+			width: positive(fields.ImageWidth?.value),
+			height: positive(fields.ImageHeight?.value),
+			bytes: positive(fields.FileSize?.value)
+		};
+	},
+	source: (url) => {
+		const match = /([?&])x-oss-process=([^&#]*)/.exec(url);
+		if (!match) return null;
+		const [segment, separator, process = ""] = match;
+		const head = url.slice(0, match.index);
+		const tail = url.slice(match.index + segment.length);
+		return {
+			url: separator === "?" && tail.startsWith("&") ? `${head}?${tail.slice(1)}` : head + tail,
+			type: process.startsWith("video/") ? "video" : "image"
+		};
+	}
+};
+const CLOUDFLARE_DERIVED = /^\/cdn-cgi\/(image|media)\/[^/]+(\/.*)$/;
+function cdnCgi(url, kind, options) {
+	const { origin, pathname, search } = new URL(url);
+	return pathname.startsWith("/cdn-cgi/") ? null : `${origin}/cdn-cgi/${kind}/${options}${pathname}${search}`;
+}
+function cloudflareBox(edge, fit, natural, limit = Number.POSITIVE_INFINITY) {
+	if (natural) return `width=${Math.min(fitted(natural, edge, fit).width, limit)}`;
+	if (fit === "width") return `width=${Math.min(edge, limit)}`;
+	const box = Math.min(guessedBox(edge, fit), limit);
+	return `width=${box},height=${box}`;
+}
+const CLOUDFLARE_FRAME_MAX = 2e3;
+const ADAPTERS = {
+	oss,
+	cloudflare: {
+		fitsFrames: true,
+		image: (url, edge, fit, quality, format) => cdnCgi(url, "image", `${cloudflareBox(edge, fit)},fit=scale-down,quality=${quality},format=${format},onerror=redirect`),
+		frame: (url, { edge, fit, natural }) => cdnCgi(url, "media", `mode=frame,time=0s,${cloudflareBox(edge, fit, natural, CLOUDFLARE_FRAME_MAX)},fit=scale-down,format=jpg`),
+		sizeFrame: (url) => cdnCgi(url, "media", `mode=frame,time=0s,width=${CLOUDFLARE_FRAME_MAX},height=${CLOUDFLARE_FRAME_MAX},fit=scale-down,format=jpg`),
+		frameLimit: CLOUDFLARE_FRAME_MAX,
+		imageInfoUrl: (url) => cdnCgi(url, "image", "format=json"),
+		readImageInfo: (body) => {
+			const original = body.original;
+			return {
+				width: positive(original?.width),
+				height: positive(original?.height),
+				bytes: positive(original?.file_size)
+			};
+		},
+		source: (url) => {
+			const parsed = new URL(url);
+			const match = CLOUDFLARE_DERIVED.exec(parsed.pathname);
+			return match ? {
+				url: `${parsed.origin}${match[2]}${parsed.search}${parsed.hash}`,
+				type: match[1] === "media" ? "video" : "image"
+			} : null;
+		}
+	}
 };
-const { maxEdge, quality } = MODEL_IMAGE;
-`${maxEdge}${maxEdge}${quality}`;
-`${maxEdge}${maxEdge}${quality}`;
+function adapterFor(url) {
+	const host = mediaHost(url);
+	return host ? ADAPTERS[host.transform] : null;
+}
+const isGif = (url) => /\.gif$/i.test(new URL(url).pathname);
+function resizedImageUrl(url, edge, fit, quality, format) {
+	const adapter = adapterFor(url);
+	return adapter && !isGif(url) ? adapter.image(url, edge, fit, quality, format) : null;
+}
+function imageVariantUrl(url, size, fit = "contain") {
+	return resizedImageUrl(url, size, fit, VARIANT_QUALITY, "auto");
+}
+function videoFrameUrl(url, size, options = {}) {
+	return adapterFor(url)?.frame(url, {
+		...options,
+		edge: size,
+		fit: options.fit ?? "contain"
+	}) ?? null;
+}
+function fitsVideoFrames(url) {
+	return adapterFor(url)?.fitsFrames ?? false;
+}
+function variantSource(url) {
+	return adapterFor(url)?.source(url) ?? null;
+}
 function positive(value) {
 	const number = typeof value === "string" ? Number(value) : value;
 	return typeof number === "number" && Number.isFinite(number) && number > 0 ? number : void 0;
@@ -56,6 +191,20 @@ function sameOriginUrl(value, origin) {
 function compact(info) {
 	return Object.fromEntries(Object.entries(info).filter(([, value]) => value !== void 0));
 }
+const MEDIA_FACTS_LIMITS = {
+	edge: 65535,
+	durationMs: 6048e5
+};
+const within = (value, max) => Number.isInteger(value) && value > 0 && value <= max;
+function mediaFacts(facts) {
+	const { width, height, durationMs } = facts ?? {};
+	if (!within(width, MEDIA_FACTS_LIMITS.edge) || !within(height, MEDIA_FACTS_LIMITS.edge)) return null;
+	return {
+		width,
+		height,
+		...within(durationMs, MEDIA_FACTS_LIMITS.durationMs) ? { durationMs } : {}
+	};
+}
 /** Media facts from response headers; `x-oss-meta-*` need CORS exposure in browsers. */
 function mediaInfoFromHeaders(headers, url) {
 	const origin = new URL(url).origin;
@@ -90,19 +239,15 @@ async function probeHeaders(url, options) {
 	return response.ok ? mediaInfoFromHeaders(response.headers, url) : {};
 }
 async function probeImageInfo(url, options) {
-	if (OSS_PROCESS_PATTERN.test(url)) return {};
-	const response = await (options.fetch ?? globalThis.fetch)(ossProcessUrl(url, "image/info"), { signal: options.signal });
-	if (!response.ok) return {};
-	const body = await response.json();
-	return compact({
-		width: positive(body.ImageWidth?.value),
-		height: positive(body.ImageHeight?.value),
-		bytes: positive(body.FileSize?.value)
-	});
+	const adapter = adapterFor(url);
+	const infoUrl = adapter?.imageInfoUrl(url);
+	if (!adapter || !infoUrl) return {};
+	const response = await (options.fetch ?? globalThis.fetch)(infoUrl, { signal: options.signal });
+	return response.ok ? compact(adapter.readImageInfo(await response.json())) : {};
 }
 async function probeMediaInfo(url, options) {
 	const host = mediaHost(url);
-	if (host?.transform !== "oss") return {};
+	if (!host) return {};
 	let info = {};
 	const attempt = async (strategy) => {
 		try {
@@ -113,43 +258,53 @@ async function probeMediaInfo(url, options) {
 	if (options.type === "image" && !hasDimensions(info)) await attempt(() => probeImageInfo(url, options));
 	return info;
 }
-const PNG_SIGNATURE = [
-	137,
-	80,
-	78,
-	71,
-	13,
-	10,
-	26,
-	10
-];
-/**
-* A video's dimensions, read from the header of its first frame rendered as a
-* full-size PNG by OSS; only the first 24 bytes are read. Throws on failure.
-*/
+function jpegSize(bytes, length) {
+	if (length >= 2 && (bytes[0] !== 255 || bytes[1] !== 216)) return null;
+	let index = 2;
+	while (index + 9 <= length) {
+		if (bytes[index] !== 255) return null;
+		const marker = bytes[index + 1];
+		if (marker === 255) {
+			index += 1;
+			continue;
+		}
+		if (marker >= 192 && marker <= 207 && marker !== 196 && marker !== 200 && marker !== 204) {
+			const height = bytes[index + 5] << 8 | bytes[index + 6];
+			const width = bytes[index + 7] << 8 | bytes[index + 8];
+			return width && height ? {
+				width,
+				height
+			} : null;
+		}
+		index += 2 + (bytes[index + 2] << 8 | bytes[index + 3]);
+	}
+	return length >= bytes.length ? null : void 0;
+}
+const FRAME_HEADER_BYTES = 65536;
 async function probeVideoFrameSize(url, options = {}) {
-	if (mediaHost(url)?.transform !== "oss" || OSS_PROCESS_PATTERN.test(url)) return {};
-	const response = await (options.fetch ?? globalThis.fetch)(ossProcessUrl(url, "video/snapshot,t_0,f_png,w_0,h_0,m_fast"), {
-		headers: { Range: "bytes=0-23" },
+	const adapter = adapterFor(url);
+	const frame = adapter?.sizeFrame(url);
+	if (!adapter || !frame) return {};
+	const response = await (options.fetch ?? globalThis.fetch)(frame, {
+		headers: { Range: `bytes=0-65535` },
 		signal: options.signal
 	});
 	if (!response.ok) throw new Error(`HTTP ${response.status}`);
-	const header = /* @__PURE__ */ new Uint8Array(24);
+	const header = new Uint8Array(FRAME_HEADER_BYTES);
 	let length = 0;
+	let size;
 	const reader = response.body?.getReader();
-	while (reader && length < header.length) {
+	while (reader && size === void 0) {
 		const { done, value } = await reader.read();
 		if (done) break;
-		header.set(value.subarray(0, header.length - length), length);
-		length += Math.min(value.length, header.length - length);
+		const take = Math.min(value.length, header.length - length);
+		header.set(value.subarray(0, take), length);
+		length += take;
+		size = jpegSize(header, length);
 	}
 	await reader?.cancel().catch(() => void 0);
-	if (length < header.length || PNG_SIGNATURE.some((byte, index) => header[index] !== byte)) return {};
-	const view = new DataView(header.buffer);
-	return compact({
-		width: positive(view.getUint32(16)),
-		height: positive(view.getUint32(20))
-	});
+	if (!size || Math.max(size.width, size.height) >= adapter.frameLimit) return {};
+	return size;
 }
 async function probeMediaSize(url, type, options = {}) {
 	const info = await probeMediaInfo(url, {
@@ -163,4 +318,4 @@ async function probeMediaSize(url, type, options = {}) {
 	} : null;
 }
 //#endregion
-export { MODEL_IMAGE, OSS_PROCESS_PATTERN, mediaHost, mediaInfoFromHeaders, mergeMediaInfo, ossProcessUrl, probeMediaInfo, probeMediaSize, probeVideoFrameSize };
+export { MEDIA_FACTS_LIMITS, MEDIA_VARIANT_MAX, MEDIA_VARIANT_SIZES, fitsVideoFrames, imageVariantUrl, mediaFacts, mediaHost, mediaInfoFromHeaders, mediaVariantSize, mergeMediaInfo, ossProcessUrl, probeMediaInfo, probeMediaSize, probeVideoFrameSize, variantSource, videoFrameUrl };

package/dist/protocol/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrameItem, BoardFrameItemSchema, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemPreview, BoardItemPreviewSchema, BoardItemType, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardMarker, BoardMarkerSchema, BoardMediaOrigin, BoardMediaOriginSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardPatch, BoardPatchSchema, BoardPlayMode, BoardScript, BoardScriptSchema, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTrack, BoardTrackSchema, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, boardItemPreview, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource } from "./board-model.js";
+import { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_BACKGROUND_FITS, BOARD_BACKGROUND_PATTERNS, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackground, BoardBackgroundFit, BoardBackgroundPattern, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrameItem, BoardFrameItemSchema, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemPreview, BoardItemPreviewSchema, BoardItemType, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardMarker, BoardMarkerSchema, BoardMediaOrigin, BoardMediaOriginSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardPatch, BoardPatchSchema, BoardPlayMode, BoardScript, BoardScriptSchema, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTrack, BoardTrackSchema, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, boardItemPreview, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource } from "./board-model.js";
 import { BoardFrame, BoardItemLookup, BoardLayout, BoardMatrix, BoardRect, BoardTextFont, BoardTextLayout, BoardTextLayouter, BoardTextLines, IDENTITY_MATRIX, adoptBoardNaturalSize, anchorPoint, applyMatrix, arrowBindings, autoAnchorSide, bendControl, clampBoardFontSize, createBoardLayout, createDocumentLayout, drawPointsBounds, drawSampleRadius, estimateTextWidth, fitBoardMediaSize, framePoint, invertMatrix, isArrowBinding, layoutBoardText, multiplyMatrix, pointsRect, rotateAround, scaleVector, setBoardTextLayouter, sideAnchor } from "./board-layout.js";
 import { BoardApplyOptions, BoardPatchResult, BoardPropertySpec, BoardState, BoardValueKind, applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, boardPatchTouches, createDocumentState, diffBoardDocuments, diffMergePatch, isEmptyBoardPatch, listBoardProperties, mergePatch, parseBoardDocument, pruneBoardTrack, resolveBoardProperty, trackReferences } from "./board-patch.js";
 import "./app-authorization.js";
 import { RequestSource, RequestSourceVia } from "./provenance.js";
-import { BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BoardApplyResult, BoardChangeSummary, BoardHistoryPage, BoardManifest, BoardManifestSchema, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardReadResult, BoardTransactionRecord, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
+import { BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BoardApplyResult, BoardChangeSummary, BoardHistoryPage, BoardManifest, BoardManifestSchema, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardReadInput, BoardReadInputSchema, BoardReadResult, BoardTransactionRecord, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
 import { BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, clampBoardStrokeSize } from "./board-constants.js";
 import "./board-content.js";
 import "./board-assets.js";
@@ -24,4 +24,4 @@ import "./app.js";
 import "./realtime/types.js";
 import "./app-catalog.js";
 import "./host-bridge.js";
-export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SCHEMA_TARGETS, BOARD_SHAPE_GEOMETRIES, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TASK_SOURCE_PREFIX, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardApplyOptions, BoardApplyResult, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardChangeSummary, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardHistoryPage, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemLookup, BoardItemPreview, BoardItemPreviewSchema, BoardItemType, BoardJsonSchemaResult, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardLayout, BoardManifest, BoardManifestSchema, BoardMarker, BoardMarkerSchema, BoardMatrix, BoardMediaOrigin, BoardMediaOriginSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardPatch, BoardPatchResult, BoardPatchSchema, BoardPlayMode, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardPropertySpec, BoardReadResult, BoardRect, BoardScript, BoardScriptSchema, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardState, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskRunSource, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextFont, BoardTextItem, BoardTextItemSchema, BoardTextLayout, BoardTextLayouter, BoardTextLines, BoardTrack, BoardTrackSchema, BoardTransactionRecord, BoardValueKind, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, GenerationRunPayload, IDENTITY_MATRIX, ModelFormat, RequestSource, RequestSourceVia, TaskRunStatus, adoptBoardNaturalSize, anchorPoint, applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, autoAnchorSide, bendControl, boardItemPreview, boardItemSchema, boardJsonSchema, boardPatchTouches, boardSchemaOverview, boardTaskSource, clampBoardFontSize, clampBoardStrokeSize, createBoardLayout, createDocumentLayout, createDocumentState, diffBoardDocuments, diffMergePatch, drawPointsBounds, drawSampleRadius, emptyBoardDocument, estimateTextWidth, featuredTaskArtifact, fitBoardMediaSize, framePoint, hasAuthoredSize, invertMatrix, isArrowBinding, isBoardColorString, isBoardEase, isBoardPath, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isEmptyBoardPatch, isFileBackedItem, isMediaItem, isPublicBoardRemoteAddress, isSafeBoardSourcePath, layoutBoardText, listBoardProperties, mergePatch, multiplyMatrix, normalizeBoardRemoteUrl, parseBoardDocument, parseBoardItem, parseBoardManifest, parseBoardMediaSource, pointsRect, pruneBoardTrack, rankedTaskArtifacts, resolveBoardProperty, rotateAround, scaleVector, serializeBoardManifest, setBoardTextLayouter, sideAnchor, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, trackReferences, withObservedArtifactFacts };
+export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_BACKGROUND_FITS, BOARD_BACKGROUND_PATTERNS, BOARD_CAMERA_TARGET, BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SCHEMA_TARGETS, BOARD_SHAPE_GEOMETRIES, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TASK_SOURCE_PREFIX, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardApplyOptions, BoardApplyResult, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackground, BoardBackgroundFit, BoardBackgroundPattern, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardChangeSummary, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardHistoryPage, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemLookup, BoardItemPreview, BoardItemPreviewSchema, BoardItemType, BoardJsonSchemaResult, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardLayout, BoardManifest, BoardManifestSchema, BoardMarker, BoardMarkerSchema, BoardMatrix, BoardMediaOrigin, BoardMediaOriginSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardPatch, BoardPatchResult, BoardPatchSchema, BoardPlayMode, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardPropertySpec, BoardReadInput, BoardReadInputSchema, BoardReadResult, BoardRect, BoardScript, BoardScriptSchema, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardState, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskRunSource, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextFont, BoardTextItem, BoardTextItemSchema, BoardTextLayout, BoardTextLayouter, BoardTextLines, BoardTrack, BoardTrackSchema, BoardTransactionRecord, BoardValueKind, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, GenerationRunPayload, IDENTITY_MATRIX, ModelFormat, RequestSource, RequestSourceVia, TaskRunStatus, adoptBoardNaturalSize, anchorPoint, applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, autoAnchorSide, bendControl, boardItemPreview, boardItemSchema, boardJsonSchema, boardPatchTouches, boardSchemaOverview, boardTaskSource, clampBoardFontSize, clampBoardStrokeSize, createBoardLayout, createDocumentLayout, createDocumentState, diffBoardDocuments, diffMergePatch, drawPointsBounds, drawSampleRadius, emptyBoardDocument, estimateTextWidth, featuredTaskArtifact, fitBoardMediaSize, framePoint, hasAuthoredSize, invertMatrix, isArrowBinding, isBoardColorString, isBoardEase, isBoardPath, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isEmptyBoardPatch, isFileBackedItem, isMediaItem, isPublicBoardRemoteAddress, isSafeBoardSourcePath, layoutBoardText, listBoardProperties, mergePatch, multiplyMatrix, normalizeBoardRemoteUrl, parseBoardDocument, parseBoardItem, parseBoardManifest, parseBoardMediaSource, pointsRect, pruneBoardTrack, rankedTaskArtifacts, resolveBoardProperty, rotateAround, scaleVector, serializeBoardManifest, setBoardTextLayouter, sideAnchor, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, trackReferences, withObservedArtifactFacts };

package/dist/voice-input.js

@@ -1,4 +1,4 @@
-import { u as resolveVoiceInputWebsocketUrl } from "./chunks/environment.js";
+import { d as resolveVoiceInputWebsocketUrl } from "./chunks/environment.js";
 //#region src/voice-input.ts
 const TARGET_SAMPLE_RATE = 16e3;
 const CHUNK_SAMPLES = TARGET_SAMPLE_RATE * 200 / 1e3;

package/dist/websocket.js

@@ -1,5 +1,5 @@
 import { C as getSessionTurnPatchStreamKey, S as getRealtimeSpaceRoom, T as normalizeRealtimeRooms, _ as WS_REALTIME_ROOM_CAPABILITY, b as WS_ROOM_SUBSCRIPTION_CAPABILITY, g as WS_COMPACT_STREAM_CAPABILITY, h as WS_BOARD_AWARENESS_CAPABILITY, r as extractBillingPayload, v as WS_REALTIME_ROOM_HISTORY_CAPABILITY, w as isRealtimeDomain } from "./chunks/http-error.js";
-import { f as resolveWebsocketUrl } from "./chunks/environment.js";
+import { p as resolveWebsocketUrl } from "./chunks/environment.js";
 //#region src/websocket.ts
 const createEventMap = () => ({
 	connecting: /* @__PURE__ */ new Set(),
@@ -109,12 +109,15 @@ var WebsocketClient = class {
 	pongTimeoutMs;
 	debug;
 	getAccessToken;
+	anonymous;
 	WebSocketImpl;
 	ws = null;
 	pingTimer = null;
 	reconnectTimer = null;
 	reconnectTimerResolver = null;
 	reconnectAttempt = 0;
+	resubscribeTimer = null;
+	resubscribeAttempt = 0;
 	authReconnectAttempted = false;
 	forceRefreshOnNextAuth = false;
 	retryAuthClose = false;
@@ -146,6 +149,7 @@ var WebsocketClient = class {
 		this.pongTimeoutMs = normalized.pongTimeoutMs;
 		this.debug = normalized.debug;
 		this.getAccessToken = options.getAccessToken;
+		this.anonymous = options.anonymous === true;
 		this.WebSocketImpl = options.WebSocketImpl ?? WebSocket;
 	}
 	on(type, handler) {
@@ -481,6 +485,9 @@ var WebsocketClient = class {
 			});
 		};
 	}
+	isRoomLive(room) {
+		return this.state === "open" && this.roomSubscriptions.get(room)?.subscribed === true;
+	}
 	subscribeRooms(rooms) {
 		return this.retainRooms(rooms);
 	}
@@ -518,11 +525,11 @@ var WebsocketClient = class {
 		const forceRefresh = this.forceRefreshOnNextAuth;
 		this.forceRefreshOnNextAuth = false;
 		const token = this.getAccessToken ? await this.getAccessToken(forceRefresh ? { forceRefresh: true } : void 0) : null;
-		if (!token) throw new WebsocketAuthError("missing access token");
+		if (!token && !this.anonymous) throw new WebsocketAuthError("missing access token");
 		const waiter = this.createAuthWaiter();
 		this.send({
 			type: "auth",
-			payload: {
+			payload: token ? {
 				token,
 				capabilities: [
 					WS_COMPACT_STREAM_CAPABILITY,
@@ -531,6 +538,9 @@ var WebsocketClient = class {
 					WS_REALTIME_ROOM_CAPABILITY,
 					WS_REALTIME_ROOM_HISTORY_CAPABILITY
 				]
+			} : {
+				anonymous: true,
+				capabilities: [WS_ROOM_SUBSCRIPTION_CAPABILITY]
 			}
 		});
 		await waiter.promise;
@@ -554,6 +564,8 @@ var WebsocketClient = class {
 		this.flushRoomSubscriptions();
 	}
 	resetRoomSubscriptions() {
+		if (this.resubscribeTimer) clearTimeout(this.resubscribeTimer);
+		this.resubscribeTimer = null;
 		for (const state of this.roomSubscriptions.values()) {
 			state.subscribed = false;
 			state.pending = false;
@@ -633,6 +645,7 @@ var WebsocketClient = class {
 					this.emit("auth", {
 						connectionId,
 						user,
+						anonymous: envelope.payload.anonymous === true,
 						capabilities
 					});
 				}
@@ -703,6 +716,7 @@ var WebsocketClient = class {
 						state.pending = false;
 					}
 				}
+				if (rooms.length > 0) this.resubscribeAttempt = 0;
 				this.emit("subscribed", {
 					rooms,
 					requestId: envelope.requestId ?? null
@@ -717,11 +731,18 @@ var WebsocketClient = class {
 					code: typeof entry.code === "string" ? entry.code : "UNKNOWN",
 					message: typeof entry.message === "string" ? entry.message : "Subscription failed"
 				})).filter((entry) => entry.room) : [];
+				let retry = false;
 				for (const item of rejected) {
 					const room = normalizeRealtimeRooms([item.room])[0];
 					if (!room) continue;
-					this.roomSubscriptions.delete(room);
+					const state = this.roomSubscriptions.get(room);
+					if (state && item.code === "UNAVAILABLE") {
+						state.subscribed = false;
+						state.pending = false;
+						retry = true;
+					} else this.roomSubscriptions.delete(room);
 				}
+				if (retry) this.scheduleResubscribe();
 				this.emit("subscribeError", {
 					rejected,
 					requestId: envelope.requestId ?? null
@@ -900,10 +921,21 @@ var WebsocketClient = class {
 			resolve();
 		}
 	}
+	backoff(attempt) {
+		return Math.min(this.reconnectBaseDelayMs * 2 ** attempt, this.reconnectMaxDelayMs);
+	}
+	scheduleResubscribe() {
+		if (this.resubscribeTimer) return;
+		this.resubscribeTimer = setTimeout(() => {
+			this.resubscribeTimer = null;
+			this.flushRoomSubscriptions();
+		}, this.backoff(this.resubscribeAttempt));
+		this.resubscribeAttempt += 1;
+	}
 	async scheduleReconnect(code, reason) {
 		this.clearReconnectTimer();
 		const attempt = this.reconnectAttempt + 1;
-		const delay = Math.min(this.reconnectBaseDelayMs * 2 ** this.reconnectAttempt, this.reconnectMaxDelayMs);
+		const delay = this.backoff(this.reconnectAttempt);
 		this.reconnectAttempt = attempt;
 		this.state = "reconnecting";
 		this.log("schedule reconnect", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub",
-  "version": "12.5.0",
+  "version": "13.0.0",
   "description": "Cohub SDK for spaces, sessions, boards, and realtime agent collaboration.",
   "license": "Apache-2.0",
   "private": false,

package/dist/board/render/board-background.d.ts

@@ -1,18 +0,0 @@
-import { BoardSettings } from "../../protocol/dist/board-model.js";
-import "../../protocol/dist/index.js";
-import { BoardViewport } from "../model/geometry.js";
-import { BoardRenderPalette } from "./renderers/board-renderer-registry.js";
-import { Application, Container } from "pixi.js";
-//#region src/board/render/board-background.d.ts
-type BoardBackgroundContext = {
-  app: Application;
-  settings: BoardSettings;
-  viewport: BoardViewport;
-  colorScheme: "dark" | "light";
-  palette: BoardRenderPalette;
-  hasImageBackground?: boolean;
-};
-declare function createBoardBackground(context: BoardBackgroundContext): Container;
-declare function updateBoardBackground(container: Container, context: BoardBackgroundContext): void;
-//#endregion
-export { BoardBackgroundContext, createBoardBackground, updateBoardBackground };

package/dist/board/render/board-background.js

@@ -1,104 +0,0 @@
-import { parseBoardCssColor } from "./css-color.js";
-import { Container, Graphics, RenderTexture, TilingSprite } from "pixi.js";
-//#region src/board/render/board-background.ts
-const partsByContainer = /* @__PURE__ */ new WeakMap();
-function wrap(value, period) {
-	return (value % period + period) % period;
-}
-function buildGridTexture(context, size, color, opacity, kind) {
-	const graphics = new Graphics();
-	if (kind === "grid") graphics.moveTo(0, .5).lineTo(size, .5).moveTo(.5, 0).lineTo(.5, size).stroke({
-		color,
-		width: 1,
-		alpha: opacity
-	});
-	else graphics.circle(size / 2, size / 2, 1.1).fill({
-		color,
-		alpha: opacity
-	});
-	const target = RenderTexture.create({
-		width: size,
-		height: size
-	});
-	context.app.renderer.render({
-		container: graphics,
-		target
-	});
-	graphics.destroy();
-	return target;
-}
-function sync(parts, context) {
-	const { app, settings, viewport, palette } = context;
-	const width = app.screen.width;
-	const height = app.screen.height;
-	const declared = settings.background.color;
-	const cssColor = typeof declared === "object" ? declared[context.colorScheme] : declared;
-	const bgColor = cssColor ? parseBoardCssColor(cssColor) ?? palette.bg : palette.bg;
-	const bgAlpha = context.hasImageBackground ? 0 : 1;
-	if (parts.lastWidth !== width || parts.lastHeight !== height || parts.lastBg !== bgColor || parts.lastBgAlpha !== bgAlpha) {
-		parts.fill.clear();
-		parts.fill.rect(0, 0, width, height).fill({
-			color: bgColor,
-			alpha: bgAlpha
-		});
-		parts.lastWidth = width;
-		parts.lastHeight = height;
-		parts.lastBg = bgColor;
-		parts.lastBgAlpha = bgAlpha;
-	}
-	const kind = settings.background.kind === "grid" ? "grid" : "dots";
-	const visible = settings.grid?.visible === true;
-	const size = Math.max(4, settings.grid?.size ?? 24);
-	const color = kind === "grid" ? palette.border : palette.muted;
-	const opacity = kind === "grid" ? .9 : .4;
-	const key = `${kind}|${size}|${color}|${opacity}`;
-	if (!visible) {
-		if (parts.sprite) parts.sprite.visible = false;
-		return;
-	}
-	if (parts.textureKey !== key || !parts.sprite) {
-		if (parts.sprite) {
-			const previousTexture = parts.sprite.texture;
-			parts.sprite.destroy();
-			previousTexture.destroy(true);
-		}
-		const texture = buildGridTexture(context, size, color, opacity, kind);
-		parts.sprite = new TilingSprite({
-			texture,
-			width,
-			height
-		});
-		parts.textureKey = key;
-		parts.fill.parent?.addChild(parts.sprite);
-	}
-	const sprite = parts.sprite;
-	if (!sprite) return;
-	sprite.visible = true;
-	sprite.width = width;
-	sprite.height = height;
-	const step = size * viewport.zoom;
-	sprite.tileScale.set(viewport.zoom);
-	sprite.tilePosition.set(wrap(viewport.x, step), wrap(viewport.y, step));
-}
-function createBoardBackground(context) {
-	const container = new Container({ label: "board-background" });
-	const fill = new Graphics();
-	container.addChild(fill);
-	partsByContainer.set(container, {
-		fill,
-		sprite: null,
-		textureKey: "",
-		lastWidth: -1,
-		lastHeight: -1,
-		lastBg: NaN,
-		lastBgAlpha: NaN
-	});
-	sync(partsByContainer.get(container), context);
-	return container;
-}
-function updateBoardBackground(container, context) {
-	const parts = partsByContainer.get(container);
-	if (parts) sync(parts, context);
-}
-//#endregion
-export { createBoardBackground, updateBoardBackground };