@jolly-pixel/asset-server 1.0.0

package/dist/kinds/AssetKindRegistry.d.ts

@@ -0,0 +1,14 @@
+import type { AssetKindHandler } from "./AssetKindHandler.ts";
+/**
+ * Resolves handlers in registration order, then falls back to `binary`.
+ */
+export declare class AssetKindRegistry {
+    #private;
+    constructor(handlers?: Iterable<AssetKindHandler>);
+    register(handler: AssetKindHandler): this;
+    has(kind: string): boolean;
+    get(kind: string): AssetKindHandler;
+    resolve(path: string): AssetKindHandler;
+    kinds(): IterableIterator<string>;
+}
+//# sourceMappingURL=AssetKindRegistry.d.ts.map

package/dist/kinds/AssetKindRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetKindRegistry.d.ts","sourceRoot":"","sources":["../../src/kinds/AssetKindRegistry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAY9D;;GAEG;AACH,qBAAa,iBAAiB;;gBAI1B,QAAQ,GAAE,QAAQ,CAAC,gBAAgB,CAAM;IAO3C,QAAQ,CACN,OAAO,EAAE,gBAAgB,GACxB,IAAI;IAuBP,GAAG,CACD,IAAI,EAAE,MAAM,GACX,OAAO;IAIV,GAAG,CACD,IAAI,EAAE,MAAM,GACX,gBAAgB;IAanB,OAAO,CACL,IAAI,EAAE,MAAM,GACX,gBAAgB;IAUnB,KAAK,IAAI,gBAAgB,CAAC,MAAM,CAAC;CAGlC"}

package/dist/kinds/AssetKindRegistry.js

@@ -0,0 +1,52 @@
+// Import Third-party Dependencies
+import picomatch from "picomatch";
+import { binaryAssetHandler, BINARY_KIND } from "./handlers/binary.js";
+import { UnknownAssetKindError } from "./errors/UnknownAssetKindError.js";
+/**
+ * Resolves handlers in registration order, then falls back to `binary`.
+ */
+export class AssetKindRegistry {
+    #kinds = new Map();
+    constructor(handlers = []) {
+        for (const handler of handlers) {
+            this.register(handler);
+        }
+    }
+    register(handler) {
+        if (handler.kind === BINARY_KIND) {
+            throw new TypeError(`"${BINARY_KIND}" is the built-in fallback kind and cannot be replaced.`);
+        }
+        if (this.#kinds.has(handler.kind)) {
+            throw new TypeError(`Asset kind "${handler.kind}" is already registered.`);
+        }
+        this.#kinds.set(handler.kind, {
+            handler,
+            isMatch: picomatch([...handler.match], { dot: true })
+        });
+        return this;
+    }
+    has(kind) {
+        return kind === BINARY_KIND || this.#kinds.has(kind);
+    }
+    get(kind) {
+        if (kind === BINARY_KIND) {
+            return binaryAssetHandler;
+        }
+        const registered = this.#kinds.get(kind);
+        if (registered === undefined) {
+            throw new UnknownAssetKindError(kind);
+        }
+        return registered.handler;
+    }
+    resolve(path) {
+        for (const { handler, isMatch } of this.#kinds.values()) {
+            if (isMatch(path)) {
+                return handler;
+            }
+        }
+        return binaryAssetHandler;
+    }
+    kinds() {
+        return this.#kinds.keys();
+    }
+}

package/dist/kinds/errors/UnknownAssetKindError.d.ts

@@ -0,0 +1,5 @@
+export declare class UnknownAssetKindError extends Error {
+    readonly kind: string;
+    constructor(kind: string);
+}
+//# sourceMappingURL=UnknownAssetKindError.d.ts.map

package/dist/kinds/errors/UnknownAssetKindError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnknownAssetKindError.d.ts","sourceRoot":"","sources":["../../../src/kinds/errors/UnknownAssetKindError.ts"],"names":[],"mappings":"AAAA,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGpB,IAAI,EAAE,MAAM;CAMf"}

package/dist/kinds/errors/UnknownAssetKindError.js

@@ -0,0 +1,8 @@
+export class UnknownAssetKindError extends Error {
+    kind;
+    constructor(kind) {
+        super(`No handler is registered for asset kind "${kind}".`);
+        this.name = "UnknownAssetKindError";
+        this.kind = kind;
+    }
+}

package/dist/kinds/errors/index.d.ts

@@ -0,0 +1,2 @@
+export { UnknownAssetKindError } from "./UnknownAssetKindError.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/kinds/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kinds/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/kinds/errors/index.js

@@ -0,0 +1 @@
+export { UnknownAssetKindError } from "./UnknownAssetKindError.js";

package/dist/kinds/handlers/binary.d.ts

@@ -0,0 +1,10 @@
+import type { AssetKindHandler } from "../AssetKindHandler.ts";
+export declare const BINARY_KIND = "binary";
+export interface BinaryAssetState {
+    bytes: Uint8Array;
+}
+/**
+ * Fallback handler that treats an asset's bytes as its state.
+ */
+export declare const binaryAssetHandler: AssetKindHandler<BinaryAssetState>;
+//# sourceMappingURL=binary.d.ts.map

package/dist/kinds/handlers/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../../src/kinds/handlers/binary.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAS/D,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBAAgB,CAAC,gBAAgB,CAwCjE,CAAC"}

package/dist/kinds/handlers/binary.js

@@ -0,0 +1,31 @@
+import { ASSET_CREATED, ASSET_DELETED, ASSET_UPDATED, decodeContent, parseAssetEvent } from "../../events/AssetEvents.js";
+export const BINARY_KIND = "binary";
+/**
+ * Fallback handler that treats an asset's bytes as its state.
+ */
+export const binaryAssetHandler = {
+    kind: BINARY_KIND,
+    match: ["**/*"],
+    create() {
+        return {
+            bytes: new Uint8Array()
+        };
+    },
+    apply(state, event) {
+        const parsed = parseAssetEvent(event);
+        if (!parsed.ok) {
+            return;
+        }
+        const assetEvent = parsed.val;
+        if (assetEvent.eventType === ASSET_CREATED ||
+            assetEvent.eventType === ASSET_UPDATED) {
+            state.bytes = decodeContent(assetEvent.eventData.content);
+        }
+        else if (assetEvent.eventType === ASSET_DELETED) {
+            state.bytes = new Uint8Array();
+        }
+    },
+    serialize(state) {
+        return Promise.resolve(state.bytes);
+    }
+};

package/dist/kinds/handlers/index.d.ts

@@ -0,0 +1,5 @@
+export { binaryAssetHandler, BINARY_KIND } from "./binary.ts";
+export type { BinaryAssetState } from "./binary.ts";
+export { textureAssetHandler, TEXTURE_KIND } from "./texture.ts";
+export type { TextureAssetHandlerOptions } from "./texture.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/kinds/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kinds/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,mBAAmB,EACnB,YAAY,EACb,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC"}

package/dist/kinds/handlers/index.js

@@ -0,0 +1,2 @@
+export { binaryAssetHandler, BINARY_KIND } from "./binary.js";
+export { textureAssetHandler, TEXTURE_KIND } from "./texture.js";

package/dist/kinds/handlers/texture.d.ts

@@ -0,0 +1,12 @@
+import type { AssetKindHandler } from "../AssetKindHandler.ts";
+import { type BinaryAssetState } from "./binary.ts";
+export declare const TEXTURE_KIND = "texture";
+export interface TextureAssetHandlerOptions {
+    /**
+     * Globs claiming texture paths.
+     * @default png, jpg, jpeg, webp, gif and bmp anywhere under the root
+     */
+    match?: readonly string[];
+}
+export declare function textureAssetHandler(options?: TextureAssetHandlerOptions): AssetKindHandler<BinaryAssetState>;
+//# sourceMappingURL=texture.d.ts.map

package/dist/kinds/handlers/texture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture.d.ts","sourceRoot":"","sources":["../../../src/kinds/handlers/texture.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,YAAY,YAAY,CAAC;AAqBtC,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,gBAAgB,CAAC,gBAAgB,CAAC,CAOpC"}

package/dist/kinds/handlers/texture.js

@@ -0,0 +1,27 @@
+import { binaryAssetHandler } from "./binary.js";
+export const TEXTURE_KIND = "texture";
+// CONSTANTS
+const kDefaultMatch = [
+    "**/*.png",
+    "**/*.jpg",
+    "**/*.jpeg",
+    "**/*.webp",
+    "**/*.gif",
+    "**/*.bmp"
+];
+const kDefaultContentTypes = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+    ".bmp": "image/bmp"
+};
+export function textureAssetHandler(options = {}) {
+    return {
+        ...binaryAssetHandler,
+        kind: TEXTURE_KIND,
+        match: options.match ?? kDefaultMatch,
+        contentTypes: kDefaultContentTypes
+    };
+}

package/dist/kinds/index.d.ts

@@ -0,0 +1,5 @@
+export type { AssetKindHandler, AssetRoomBinding, SnapshotPolicy } from "./AssetKindHandler.ts";
+export { AssetKindRegistry } from "./AssetKindRegistry.ts";
+export { UnknownAssetKindError } from "./errors/index.ts";
+export * from "./handlers/index.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/kinds/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kinds/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,cAAc,qBAAqB,CAAC"}

package/dist/kinds/index.js

@@ -0,0 +1,3 @@
+export { AssetKindRegistry } from "./AssetKindRegistry.js";
+export { UnknownAssetKindError } from "./errors/index.js";
+export * from "./handlers/index.js";

package/dist/logger.d.ts

@@ -0,0 +1,4 @@
+import { type ILogLayer } from "loglayer";
+export type Logger = ILogLayer;
+export declare function silentLogger(): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,MAAM,GAAG,SAAS,CAAC;AAE/B,wBAAgB,YAAY,IAAI,MAAM,CAMrC"}

package/dist/logger.js

@@ -0,0 +1,9 @@
+// Import Third-party Dependencies
+import { BlankTransport, LogLayer } from "loglayer";
+export function silentLogger() {
+    return new LogLayer({
+        transport: new BlankTransport({
+            shipToLogger: () => []
+        })
+    });
+}

package/dist/plugins/vite.d.ts

@@ -0,0 +1,36 @@
+import type { Plugin } from "vite";
+import type { CatalogProjection } from "../catalog/CatalogProjection.ts";
+import { type AssetStaticHandlerOptions } from "../static/httpHandler.ts";
+import { type AssetWorkspace, type AssetWorkspaceOptions } from "../workspace/createAssetWorkspace.ts";
+export interface AssetCatalogPluginOptions {
+    projection: CatalogProjection;
+    /**
+     * @default DEFAULT_CATALOG_PATH
+     */
+    path?: string;
+}
+export declare function createAssetCatalogPlugin(options: AssetCatalogPluginOptions): Plugin;
+export type AssetStaticPluginOptions = AssetStaticHandlerOptions;
+export declare function createAssetStaticPlugin(options: AssetStaticPluginOptions): Plugin;
+export interface AssetWorkspacePluginOptions extends AssetWorkspaceOptions {
+    /**
+     * @default DEFAULT_CATALOG_PATH
+     */
+    catalogPath?: string;
+    /**
+     * URL prefix the workspace is served under.
+     * @default DEFAULT_ASSET_PREFIX
+     */
+    prefix?: string;
+    /**
+     * WebSocket upgrade path, kept separate from Vite HMR.
+     * @default DEFAULT_WEBSOCKET_PATH
+     */
+    socketPath?: string;
+    /**
+     * Called once the back-end is up, for a host needing its handles.
+     */
+    onReady?: (workspace: AssetWorkspace) => void | Promise<void>;
+}
+export declare function createAssetWorkspacePlugin(options: AssetWorkspacePluginOptions): Plugin;
+//# sourceMappingURL=vite.d.ts.map

package/dist/plugins/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../src/plugins/vite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AASnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC3B,MAAM,sCAAsC,CAAC;AAE9C,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,iBAAiB,CAAC;IAC9B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,MAAM,CAkBR;AAED,MAAM,MAAM,wBAAwB,GAAG,yBAAyB,CAAC;AAEjE,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,MAAM,CAUR;AAED,MAAM,WAAW,2BAA4B,SAAQ,qBAAqB;IACxE;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,CACR,SAAS,EAAE,cAAc,KACtB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,MAAM,CA8CR"}

package/dist/plugins/vite.js

@@ -0,0 +1,60 @@
+import { WebsocketTransport } from "@jolly-pixel/network/transport/websocket.ts";
+import { DEFAULT_WEBSOCKET_PATH } from "@jolly-pixel/network/transport/constants.ts";
+// Import Internal Dependencies
+import { createCatalogHandler, DEFAULT_CATALOG_PATH } from "../catalog/httpHandler.js";
+import { createAssetStaticHandler } from "../static/httpHandler.js";
+import { createAssetWorkspace } from "../workspace/createAssetWorkspace.js";
+export function createAssetCatalogPlugin(options) {
+    const { projection, path = DEFAULT_CATALOG_PATH } = options;
+    return {
+        name: "asset-server-catalog",
+        apply: "serve",
+        configureServer(server) {
+            server.middlewares.use(createCatalogHandler({
+                projection,
+                path
+            }));
+        }
+    };
+}
+export function createAssetStaticPlugin(options) {
+    return {
+        name: "asset-server-static",
+        apply: "serve",
+        configureServer(server) {
+            server.middlewares.use(createAssetStaticHandler(options));
+        }
+    };
+}
+export function createAssetWorkspacePlugin(options) {
+    const { catalogPath = DEFAULT_CATALOG_PATH, prefix, socketPath = DEFAULT_WEBSOCKET_PATH, onReady, ...workspaceOptions } = options;
+    let workspace = null;
+    return {
+        name: "asset-server-workspace",
+        apply: "serve",
+        async configureServer(devServer) {
+            workspace = await createAssetWorkspace(workspaceOptions);
+            devServer.middlewares.use(createCatalogHandler({
+                projection: workspace.backend.catalog,
+                path: catalogPath
+            }));
+            devServer.middlewares.use(createAssetStaticHandler({
+                source: workspace.source,
+                kinds: workspace.backend.kinds,
+                prefix
+            }));
+            if (devServer.httpServer) {
+                new WebsocketTransport({
+                    path: socketPath,
+                    httpServer: devServer.httpServer,
+                    server: workspace.server
+                });
+            }
+            await onReady?.(workspace);
+        },
+        async closeBundle() {
+            await workspace?.close();
+            workspace = null;
+        }
+    };
+}

package/dist/rooms/AssetRoomExtension.d.ts

@@ -0,0 +1,29 @@
+import * as network from "@jolly-pixel/network";
+import type { AssetRoomBinding } from "../kinds/AssetKindHandler.ts";
+export interface AssetRoomMessage {
+    readonly type: string;
+    readonly data: unknown;
+}
+export interface AssetArbitration<TCommand = unknown> {
+    readonly command: TCommand;
+    commit?(): void;
+}
+export interface AssetLiveProtocol<TCommand = unknown> {
+    readonly commandEventType: string;
+    readonly protocols: network.MessageProtocols;
+    parse(payload: unknown): TCommand | null;
+    snapshot(): unknown;
+    arbitrate(command: TCommand, clientId: string): AssetArbitration<TCommand> | null;
+    broadcast?(command: TCommand): AssetRoomMessage;
+}
+export declare class AssetRoomExtension<TCommand = unknown> extends network.Extension {
+    #private;
+    readonly id: string;
+    readonly name: string;
+    readonly protocols: network.MessageProtocols;
+    constructor(binding: AssetRoomBinding, protocol: AssetLiveProtocol<TCommand>);
+    onClientConnect(client: network.ClientHandle): void;
+    onClientDisconnect(): void;
+    onMessage(clientId: string, payload: unknown, context: network.RoomContext): Promise<void>;
+}
+//# sourceMappingURL=AssetRoomExtension.d.ts.map

package/dist/rooms/AssetRoomExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetRoomExtension.d.ts","sourceRoot":"","sources":["../../src/rooms/AssetRoomExtension.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAGhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB,CAAC,QAAQ,GAAG,OAAO;IAClD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,MAAM,CAAC,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,OAAO;IACnD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAE7C,KAAK,CACH,OAAO,EAAE,OAAO,GACf,QAAQ,GAAG,IAAI,CAAC;IAEnB,QAAQ,IAAI,OAAO,CAAC;IAEpB,SAAS,CACP,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAErC,SAAS,CAAC,CACR,OAAO,EAAE,QAAQ,GAChB,gBAAgB,CAAC;CACrB;AAED,qBAAa,kBAAkB,CAC7B,QAAQ,GAAG,OAAO,CAClB,SAAQ,OAAO,CAAC,SAAS;;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,gBAAgB,CAAC;gBAM3C,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC;IAWvC,eAAe,CACb,MAAM,EAAE,OAAO,CAAC,YAAY,GAC3B,IAAI;IAOP,kBAAkB,IAAI,IAAI;IAIpB,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,CAAC,WAAW,GAC3B,OAAO,CAAC,IAAI,CAAC;CA6BjB"}

package/dist/rooms/AssetRoomExtension.js

@@ -0,0 +1,50 @@
+// Import Third-party Dependencies
+import * as network from "@jolly-pixel/network";
+export class AssetRoomExtension extends network.Extension {
+    id;
+    name;
+    protocols;
+    #assetId;
+    #protocol;
+    constructor(binding, protocol) {
+        super();
+        this.id = binding.roomId;
+        this.name = binding.kind;
+        this.protocols = protocol.protocols;
+        this.#assetId = binding.assetId;
+        this.#protocol = protocol;
+    }
+    onClientConnect(client) {
+        client.send({
+            type: "snapshot",
+            data: this.#protocol.snapshot()
+        });
+    }
+    onClientDisconnect() {
+        return void 0;
+    }
+    async onMessage(clientId, payload, context) {
+        const command = this.#protocol.parse(payload);
+        if (command === null) {
+            return;
+        }
+        const arbitration = this.#protocol.arbitrate(command, clientId);
+        if (arbitration === null) {
+            return;
+        }
+        const appended = await context.eventStore.append({
+            assetType: this.name,
+            assetId: this.#assetId,
+            eventType: this.#protocol.commandEventType,
+            eventData: arbitration.command
+        });
+        if (!appended) {
+            return;
+        }
+        arbitration.commit?.();
+        context.room.broadcast(this.#protocol.broadcast?.(arbitration.command) ?? {
+            type: "command",
+            data: arbitration.command
+        });
+    }
+}

package/dist/rooms/index.d.ts

@@ -0,0 +1,5 @@
+export { AssetRoomExtension } from "./AssetRoomExtension.ts";
+export type { AssetArbitration, AssetLiveProtocol, AssetRoomMessage } from "./AssetRoomExtension.ts";
+export { assetRoomName, parseAssetRoomName, registerAssetRooms } from "./registerAssetRooms.ts";
+export type { AssetRoomName, AssetRoomsOptions } from "./registerAssetRooms.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/rooms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rooms/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,aAAa,EACb,iBAAiB,EAClB,MAAM,yBAAyB,CAAC"}

package/dist/rooms/index.js

@@ -0,0 +1,2 @@
+export { AssetRoomExtension } from "./AssetRoomExtension.js";
+export { assetRoomName, parseAssetRoomName, registerAssetRooms } from "./registerAssetRooms.js";

package/dist/rooms/registerAssetRooms.d.ts

@@ -0,0 +1,21 @@
+import type { Server } from "@jolly-pixel/network";
+import { assetRoomName, parseAssetRoomName, type AssetRoomName } from "@jolly-pixel/asset";
+import type { AssetKindRegistry } from "../kinds/AssetKindRegistry.ts";
+import type { CatalogProjection } from "../catalog/CatalogProjection.ts";
+import type { AssetStateStore } from "../sync/AssetStateStore.ts";
+import type { AssetProjector } from "../sync/AssetProjector.ts";
+import type { SnapshotScheduler } from "../sync/SnapshotScheduler.ts";
+import { type Logger } from "../logger.ts";
+export { assetRoomName, parseAssetRoomName, type AssetRoomName };
+export interface AssetRoomsOptions {
+    server: Server;
+    kinds: AssetKindRegistry;
+    catalog: CatalogProjection;
+    states: AssetStateStore;
+    projector: AssetProjector;
+    scheduler: SnapshotScheduler;
+    graceMs?: number;
+    logger?: Logger;
+}
+export declare function registerAssetRooms(options: AssetRoomsOptions): () => void;
+//# sourceMappingURL=registerAssetRooms.d.ts.map

package/dist/rooms/registerAssetRooms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerAssetRooms.d.ts","sourceRoot":"","sources":["../../src/rooms/registerAssetRooms.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,MAAM,EACP,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,aAAa,EACb,kBAAkB,EAClB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAKvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAEL,KAAK,MAAM,EACZ,MAAM,cAAc,CAAC;AAKtB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,aAAa,EACnB,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoBD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,iBAAiB,GACzB,MAAM,IAAI,CA+EZ"}

package/dist/rooms/registerAssetRooms.js

@@ -0,0 +1,71 @@
+import { AssetId, assetRoomName, parseAssetRoomName } from "@jolly-pixel/asset";
+// Import Internal Dependencies
+import { AssetRoomExtension } from "./AssetRoomExtension.js";
+import { silentLogger } from "../logger.js";
+// Re-exported so a host wiring rooms needs one import, not two. The
+// definitions live in `@jolly-pixel/asset` because the browser needs them
+// to build the same room name.
+export { assetRoomName, parseAssetRoomName };
+function extensionFactory(handler) {
+    const { createExtension, live } = handler;
+    if (createExtension !== undefined) {
+        return createExtension;
+    }
+    if (live === undefined) {
+        return null;
+    }
+    return (binding) => new AssetRoomExtension(binding, live(binding));
+}
+export function registerAssetRooms(options) {
+    const { server, kinds, catalog, states, projector, scheduler, graceMs, logger = silentLogger() } = options;
+    server.setRoomResolver(async (roomName) => {
+        function refuse(reason, metadata = {}) {
+            logger
+                .withMetadata({
+                room: roomName,
+                reason, ...metadata
+            })
+                .warn("asset room refused");
+            return null;
+        }
+        const parsed = parseAssetRoomName(roomName);
+        if (parsed === null) {
+            return null;
+        }
+        const { kind, assetId } = parsed;
+        if (!kinds.has(kind)) {
+            return refuse("unknown kind");
+        }
+        const createRoomExtension = extensionFactory(kinds.get(kind));
+        if (createRoomExtension === null) {
+            return refuse("kind has no extension");
+        }
+        const id = new AssetId(assetId);
+        if (!catalog.catalog.has(id) ||
+            catalog.catalog.get(id).kind !== kind) {
+            return refuse("unknown asset");
+        }
+        const entry = await states.acquire(assetId, kind);
+        const binding = {
+            assetId,
+            kind,
+            roomId: roomName,
+            state: entry.state
+        };
+        const extension = createRoomExtension(binding);
+        if (extension.id !== roomName) {
+            states.release(assetId);
+            return refuse("extension id must match the room name", { extensionId: extension.id });
+        }
+        return {
+            extension,
+            graceMs,
+            onEvict: async () => {
+                await scheduler.flush(assetId);
+                await projector.flush(assetId);
+                states.release(assetId);
+            }
+        };
+    });
+    return () => server.setRoomResolver(null);
+}

package/dist/static/contentTypes.d.ts

@@ -0,0 +1,6 @@
+import type { AssetKindRegistry } from "../kinds/AssetKindRegistry.ts";
+export declare const DEFAULT_CONTENT_TYPE = "application/octet-stream";
+export declare const DEFAULT_CONTENT_TYPES: Readonly<Record<string, string>>;
+export declare function contentTypesFromKinds(kinds: AssetKindRegistry): Record<string, string>;
+export declare function resolveContentType(assetPath: string, table?: Readonly<Record<string, string>>): string;
+//# sourceMappingURL=contentTypes.d.ts.map

package/dist/static/contentTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentTypes.d.ts","sourceRoot":"","sources":["../../src/static/contentTypes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,eAAO,MAAM,oBAAoB,6BAA6B,CAAC;AAC/D,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUlE,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAyB,GAC9D,MAAM,CAMR"}

package/dist/static/contentTypes.js

@@ -0,0 +1,27 @@
+// Import Node.js Dependencies
+import path from "node:path";
+export const DEFAULT_CONTENT_TYPE = "application/octet-stream";
+export const DEFAULT_CONTENT_TYPES = {
+    ".json": "application/json; charset=utf-8",
+    ".txt": "text/plain; charset=utf-8",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+    ".bmp": "image/bmp",
+    ".svg": "image/svg+xml"
+};
+export function contentTypesFromKinds(kinds) {
+    const table = {
+        ...DEFAULT_CONTENT_TYPES
+    };
+    for (const kind of kinds.kinds()) {
+        Object.assign(table, kinds.get(kind).contentTypes);
+    }
+    return table;
+}
+export function resolveContentType(assetPath, table = DEFAULT_CONTENT_TYPES) {
+    const extension = path.posix.extname(assetPath).toLowerCase();
+    return table[extension] ?? DEFAULT_CONTENT_TYPE;
+}

package/dist/static/httpHandler.d.ts

@@ -0,0 +1,24 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import { type AssetSource } from "@jolly-pixel/asset-source";
+import type { AssetKindRegistry } from "../kinds/AssetKindRegistry.ts";
+export declare const DEFAULT_ASSET_PREFIX = "/assets/";
+export type AssetStaticHandler = (request: IncomingMessage, response: ServerResponse, next: () => void) => void;
+export interface AssetStaticHandlerOptions {
+    source: AssetSource;
+    /**
+     * URL prefix the workspace is mounted under. A missing trailing slash is
+     * added, so `/assets` and `/assets/` behave the same.
+     * @default DEFAULT_ASSET_PREFIX
+     */
+    prefix?: string;
+    /**
+     * Kinds contributing content types for the extensions they claim.
+     */
+    kinds?: AssetKindRegistry;
+    /**
+     * Extension-to-content-type entries taking precedence over the kinds.
+     */
+    contentTypes?: Readonly<Record<string, string>>;
+}
+export declare function createAssetStaticHandler(options: AssetStaticHandlerOptions): AssetStaticHandler;
+//# sourceMappingURL=httpHandler.d.ts.map

package/dist/static/httpHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpHandler.d.ts","sourceRoot":"","sources":["../../src/static/httpHandler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACf,MAAM,WAAW,CAAC;AAInB,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAiBvE,eAAO,MAAM,oBAAoB,aAAmB,CAAC;AAErD,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,MAAM,IAAI,KACb,IAAI,CAAC;AAEV,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,WAAW,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;OAEG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,kBAAkB,CAqEpB"}