cajonzero 0.1.2 → 0.1.3

package/dist/{config-BOzAyP7m.d.ts → config-B32NDXlr.d.ts}

@@ -1,4 +1,4 @@
-import { T as TimestampedClientInput, N as NetPublic, O as NetSecret } from './providers-BX7e4pNW.js';
+import { T as TimestampedClientInput, N as NetPublic, O as NetSecret } from './providers-BwJKzGkd.js';
 
 /**
  * cajonzero — mudb protocol envelope (message-id tables + `raw` channel).

package/dist/core.d.ts

@@ -1,6 +1,6 @@
-import { M as MapEntry, W as WorldSeed } from './providers-BX7e4pNW.js';
-export { c as EMPTY_MAP_CATALOG, E as EnvProvider, d as MapCatalog, e as Repos, R as Room, f as RoomOptions, g as RuntimeProviders, h as SETTINGS, i as SETTING_KEYS, a as SettingDefaults, j as SettingDefinition, k as Settings, l as SettingsError, m as SettingsErrorCode, n as SettingsService, o as StorageFactory, S as StorageSource, p as Store, q as WorldSeedReader, r as configureDefaultKV, s as createMemoryStore, t as createRepos, u as createSettingsService, v as createStore, w as findMap, x as getRuntimeProviders, y as isSettingKey, z as memoryDriver, A as parseMapCatalog, B as resolveAdminToken, C as resolveEnvironment, F as resolveRooms, G as resolveSessionSecret, H as resolveSettingDefaults, I as resolveStore, J as setRuntimeProviders, K as setStorageFactory } from './providers-BX7e4pNW.js';
-export { C as CajonzeroConfig, D as DEFAULT_CONFIG, G as GAME_NET_INBOUND_BASE, a as GAME_NET_OUTBOUND_BASE, I as INBOUND_LAYOUT, M as MAX_INBOUND_FRAME_BYTES, b as MapsConfig, N as NetCodec, c as NetCodecError, d as NetCodecErrorCode, e as NetCodecHandlers, f as NetCodecOptions, O as OFFICIAL_PREFIX, g as OUTBOUND_LAYOUT, P as ProtocolDirection, h as ProtocolLayout, i as ProtocolSchemaLike, R as RoomConfig, j as chainLayouts, l as layoutMessages, k as layoutProtocol, m as matchesLayout, n as messageIds, o as messageNameAt, r as readNetFrameHeader, p as readNetMessageType, q as resolveConfig } from './config-BOzAyP7m.js';
+import { M as MapEntry, W as WorldSeed } from './providers-BwJKzGkd.js';
+export { c as EMPTY_MAP_CATALOG, E as EnvProvider, d as MapCatalog, e as Repos, R as Room, f as RoomOptions, g as RuntimeProviders, h as SETTINGS, i as SETTING_KEYS, a as SettingDefaults, j as SettingDefinition, k as Settings, l as SettingsError, m as SettingsErrorCode, n as SettingsService, o as StorageFactory, S as StorageSource, p as Store, q as WorldSeedReader, r as configureDefaultKV, s as createMemoryStore, t as createRepos, u as createSettingsService, v as createStore, w as findMap, x as getRuntimeProviders, y as isSettingKey, z as memoryDriver, A as parseMapCatalog, B as resolveAdminToken, C as resolveEnvironment, F as resolveRooms, G as resolveSessionSecret, H as resolveSettingDefaults, I as resolveStore, J as setRuntimeProviders, K as setStorageFactory } from './providers-BwJKzGkd.js';
+export { C as CajonzeroConfig, D as DEFAULT_CONFIG, G as GAME_NET_INBOUND_BASE, a as GAME_NET_OUTBOUND_BASE, I as INBOUND_LAYOUT, M as MAX_INBOUND_FRAME_BYTES, b as MapsConfig, N as NetCodec, c as NetCodecError, d as NetCodecErrorCode, e as NetCodecHandlers, f as NetCodecOptions, O as OFFICIAL_PREFIX, g as OUTBOUND_LAYOUT, P as ProtocolDirection, h as ProtocolLayout, i as ProtocolSchemaLike, R as RoomConfig, j as chainLayouts, l as layoutMessages, k as layoutProtocol, m as matchesLayout, n as messageIds, o as messageNameAt, r as readNetFrameHeader, p as readNetMessageType, q as resolveConfig } from './config-B32NDXlr.js';
 import 'unstorage';
 import 'gl-matrix';
 import 'zod';
@@ -15,7 +15,9 @@ import 'zod';
  * browser loads those straight from the same root.
  *
  * The seed is resolved on demand from object storage: map bytes stay on the
- * CDN, never in the deployment KV.
+ * CDN, never in the deployment KV. When the map owner uploaded a precomputed
+ * `seed.json[.gz]` pack (`cj0 maps pack`), the whole graph is replaced by a
+ * single request — which is what keeps room startup inside Worker quotas.
  *
  * Worker path: `fetch`, `AbortController`, `TextDecoder` only.
  */
@@ -41,6 +43,11 @@ interface HttpMapOptions {
     maxDownloadBytes?: number;
     /** Parallel voxel-chunk reads. Default 8. */
     concurrency?: number;
+    /**
+     * Try the precomputed `<root>seed.json[.gz]` pack before resolving the full
+     * map graph. Default `true`; disable it to force a graph re-read.
+     */
+    preferSeedPack?: boolean;
 }
 /**
  * A {@link WorldSeedReader} over one unpacked map root.
@@ -66,9 +73,10 @@ declare class HttpMapSource {
 /**
  * Load one map entry into a resolved {@link WorldSeed}.
  *
- * Reads `bundle.json`/manifest and the project graph straight from object
- * storage. Nothing is cached server-side: map bytes belong on the CDN, not in
- * the deployment KV.
+ * Prefers the precomputed seed pack (`<root>seed.json[.gz]`) — one request and
+ * no graph traversal, which is what keeps room startup inside Worker quotas.
+ * Falls back to reading `bundle.json`/manifest and the project graph when no
+ * pack is present.
  */
 declare function loadWorldSeedFromHttp(entry: MapEntry, options?: HttpMapOptions): Promise<WorldSeed>;
 

package/dist/core.js

@@ -5132,147 +5132,6 @@ async function consumeSessionProof(proof, secret, consumed, now) {
   return payload;
 }
 
-// src/core/maps/catalog.ts
-var MAP_CATALOG_VERSION = 1;
-var SLUG_RE = /^[a-z0-9][a-z0-9-_]*$/;
-var MAX_SLUG_LENGTH = 63;
-var WORLD_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
-var EMPTY_MAP_CATALOG = { version: MAP_CATALOG_VERSION, maps: [] };
-var MapCatalogError = class extends Error {
-  code;
-  constructor(code, message) {
-    super(message);
-    this.name = "MapCatalogError";
-    this.code = code;
-  }
-};
-function fail(code, message) {
-  throw new MapCatalogError(code, message);
-}
-function isMapSlug(value) {
-  return value.length > 0 && value.length <= MAX_SLUG_LENGTH && SLUG_RE.test(value);
-}
-function assertMapSlug(slug) {
-  if (!isMapSlug(slug)) fail("INVALID_SLUG", `invalid map slug "${slug}"`);
-  return slug;
-}
-function assertWorldId(worldId) {
-  if (!WORLD_ID_RE.test(worldId) || worldId === "." || worldId === "..") {
-    fail("INVALID_PATH", `invalid world id "${worldId}"`);
-  }
-  return worldId;
-}
-function normalizeRootUrl(raw) {
-  if (typeof raw !== "string" || raw.trim().length === 0) {
-    fail("INVALID_ROOT", "map root must be a non-empty URL");
-  }
-  let url;
-  try {
-    url = new URL(raw.trim());
-  } catch {
-    fail("INVALID_ROOT", `map root is not a valid URL: ${raw}`);
-  }
-  if (url.protocol !== "http:" && url.protocol !== "https:") {
-    fail("INVALID_ROOT", `map root must be http(s): ${raw}`);
-  }
-  url.hash = "";
-  if (!url.pathname.endsWith("/")) {
-    const lastSegment = url.pathname.split("/").pop() ?? "";
-    if (/\.[A-Za-z0-9]+$/.test(lastSegment)) {
-      fail(
-        "INVALID_ROOT",
-        `map root must be the unpacked map directory, not a file ("${lastSegment}"); use its parent directory ending in "/"`
-      );
-    }
-    url.pathname += "/";
-  }
-  return url.toString();
-}
-function assertRelativeMapPath(relPath) {
-  if (relPath.length === 0 || relPath.includes("\0") || relPath.includes("\\")) {
-    fail("INVALID_PATH", `invalid map path "${relPath}"`);
-  }
-  if (relPath.startsWith("/")) fail("INVALID_PATH", `absolute map path "${relPath}"`);
-  const parts2 = [];
-  for (const part of relPath.split("/")) {
-    if (part === "" || part === ".") continue;
-    if (part === "..") fail("INVALID_PATH", `map path escapes the root: "${relPath}"`);
-    parts2.push(part);
-  }
-  if (parts2.length === 0) fail("INVALID_PATH", "empty map path");
-  return parts2.join("/");
-}
-function mapFilePath(root, relPath) {
-  const base = new URL(normalizeRootUrl(root));
-  const relative = assertRelativeMapPath(relPath);
-  const url = new URL(relative, base);
-  if (url.origin !== base.origin || !url.pathname.startsWith(base.pathname)) {
-    fail("INVALID_PATH", `map path escapes the root: "${relPath}"`);
-  }
-  if (base.search.length > 0) url.search = base.search;
-  url.hash = "";
-  return url.toString();
-}
-function optionalString(value, label, code = "INVALID_MAP") {
-  if (value === void 0) return void 0;
-  if (typeof value !== "string" || value.trim().length === 0) {
-    fail(code, `${label} must be a non-empty string`);
-  }
-  return value.trim();
-}
-function parseEntry(value, index) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    fail("INVALID_MAP", `maps[${index}] must be an object`);
-  }
-  const record = value;
-  const slug = optionalString(record.slug, `maps[${index}].slug`, "INVALID_SLUG");
-  if (slug === void 0) fail("INVALID_SLUG", `maps[${index}].slug is required`);
-  assertMapSlug(slug);
-  const rootRaw = optionalString(record.root, `maps[${index}].root`, "INVALID_ROOT");
-  if (rootRaw === void 0) fail("INVALID_ROOT", `maps[${slug}].root is required`);
-  const root = normalizeRootUrl(rootRaw);
-  const worldId = optionalString(record.worldId, `maps[${index}].worldId`);
-  const assetRoot = optionalString(record.assetRoot, `maps[${index}].assetRoot`, "INVALID_ROOT");
-  const name = optionalString(record.name, `maps[${index}].name`);
-  const author = optionalString(record.author, `maps[${index}].author`);
-  const version = optionalString(record.version, `maps[${index}].version`);
-  const cover = optionalString(record.cover, `maps[${index}].cover`);
-  return {
-    slug,
-    root,
-    ...worldId !== void 0 ? { worldId: assertWorldId(worldId) } : {},
-    ...name !== void 0 ? { name } : {},
-    ...author !== void 0 ? { author } : {},
-    ...version !== void 0 ? { version } : {},
-    ...cover !== void 0 ? { cover } : {},
-    ...assetRoot !== void 0 ? { assetRoot: normalizeRootUrl(assetRoot) } : {}
-  };
-}
-function parseMapCatalog(input) {
-  if (input === void 0 || input === null) return EMPTY_MAP_CATALOG;
-  if (typeof input !== "object" || Array.isArray(input)) {
-    fail("INVALID_CATALOG", "maps.json must be an object");
-  }
-  const record = input;
-  const version = record.version ?? MAP_CATALOG_VERSION;
-  if (version !== MAP_CATALOG_VERSION) {
-    fail("INVALID_CATALOG", `unsupported maps.json version ${String(version)}`);
-  }
-  if (!Array.isArray(record.maps)) {
-    fail("INVALID_CATALOG", "maps.json `maps` must be an array");
-  }
-  const maps = record.maps.map((entry, index) => parseEntry(entry, index));
-  const seen = /* @__PURE__ */ new Set();
-  for (const map of maps) {
-    if (seen.has(map.slug)) fail("DUPLICATE_SLUG", `duplicate map slug "${map.slug}"`);
-    seen.add(map.slug);
-  }
-  return { version: MAP_CATALOG_VERSION, maps };
-}
-function findMap(catalog, slug) {
-  return catalog.maps.find((entry) => entry.slug === slug);
-}
-
 // src/vendor/mudb/box-schema/backend/database-type.ts
 var DB;
 ((DB2) => {
@@ -13850,16 +13709,268 @@ function decodeBlockInfo(bytes) {
     return null;
   }
 }
-async function loadBlockInfo(reader, worldId, hash = BLOCK_INFO_HASH) {
+async function readBlockInfoBytes(reader, worldId, hash = BLOCK_INFO_HASH) {
   try {
     const bytes = await reader.read(`worlds/${worldId}/data/blobs/${hash}`);
     if (bytes === null || bytes.length === 0) return null;
-    return decodeBlockInfo(bytes);
+    return bytes;
   } catch {
     return null;
   }
 }
 
+// src/core/maps/seed-pack.ts
+var SEED_PACK_VERSION = 1;
+var SEED_PACK_FORMAT = "cajonzero-seed";
+var SEED_PACK_FILES = ["seed.json.gz", "seed.json"];
+function isGzip(bytes) {
+  return bytes.length >= 2 && bytes[0] === 31 && bytes[1] === 139;
+}
+async function gunzipBytes(bytes) {
+  if (typeof DecompressionStream === "undefined") {
+    throw new Error("this runtime does not support gzip seed packs");
+  }
+  const buffer = bytes.buffer.slice(
+    bytes.byteOffset,
+    bytes.byteOffset + bytes.byteLength
+  );
+  const stream = new Blob([buffer]).stream().pipeThrough(new DecompressionStream("gzip"));
+  return new Uint8Array(await new Response(stream).arrayBuffer());
+}
+async function decodeSeedPackAuto(bytes) {
+  return decodeSeedPack(isGzip(bytes) ? await gunzipBytes(bytes) : bytes);
+}
+async function loadSeedPackFromAssets(assets, slug, worldId) {
+  if (assets === void 0) return null;
+  for (const file of SEED_PACK_FILES) {
+    const suffix = file.slice("seed".length);
+    const path = `/seed/${encodeURIComponent(slug)}${suffix}`;
+    try {
+      const response = await assets.fetch(new Request(`https://cajonzero.internal${path}`));
+      if (!response.ok) continue;
+      const bytes = new Uint8Array(await response.arrayBuffer());
+      const seed = await decodeSeedPackAuto(bytes);
+      if (worldId !== void 0 && worldId.length > 0 && seed.mapId !== worldId) continue;
+      return seed;
+    } catch {
+    }
+  }
+  return null;
+}
+function base64ToBytes(text) {
+  const binary = atob(text);
+  const out = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i += 1) out[i] = binary.charCodeAt(i);
+  return out;
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function decodeSeedPack(bytes) {
+  let parsed;
+  try {
+    parsed = JSON.parse(new TextDecoder().decode(bytes));
+  } catch {
+    throw new Error("seed pack is not valid JSON");
+  }
+  if (!isRecord2(parsed) || parsed["format"] !== SEED_PACK_FORMAT) {
+    throw new Error("not a cajonzero seed pack");
+  }
+  if (parsed["version"] !== SEED_PACK_VERSION) {
+    throw new Error(
+      `unsupported seed pack version ${String(parsed["version"])} (expected ${SEED_PACK_VERSION})`
+    );
+  }
+  if (typeof parsed["mapId"] !== "string" || parsed["mapId"].length === 0) {
+    throw new Error("seed pack is missing mapId");
+  }
+  if (!isRecord2(parsed["seed"])) {
+    throw new Error("seed pack is missing the seed payload");
+  }
+  const rawSeed = parsed["seed"];
+  if (rawSeed["version"] !== WORLD_SEED_VERSION) {
+    throw new Error(
+      `seed pack was built for world-seed v${String(rawSeed["version"])} (this runtime expects v${WORLD_SEED_VERSION}); re-run cj0 maps pack`
+    );
+  }
+  const rawVoxels = rawSeed["voxels"];
+  let voxels = null;
+  if (rawVoxels !== null) {
+    if (!isRecord2(rawVoxels)) throw new Error("seed pack voxels are malformed");
+    const blobs = rawVoxels["chunkBlobs"];
+    if (!Array.isArray(blobs)) throw new Error("seed pack voxels are malformed");
+    const rawShape = rawVoxels["shape"];
+    const shape = isRecord2(rawShape) ? {
+      x: Number(rawShape["x"]) || 0,
+      y: Number(rawShape["y"]) || 0,
+      z: Number(rawShape["z"]) || 0
+    } : { x: 0, y: 0, z: 0 };
+    const hashes = rawVoxels["chunkHashes"];
+    voxels = {
+      shape,
+      chunkCount: Number(rawVoxels["chunkCount"]) || blobs.length,
+      chunkBlobs: blobs.map(
+        (blob) => typeof blob === "string" ? base64ToBytes(blob) : new Uint8Array(0)
+      ),
+      chunkHashes: Array.isArray(hashes) ? hashes.map((hash) => typeof hash === "string" ? hash : "") : []
+    };
+  }
+  const { voxels: _ignored, ...rest } = rawSeed;
+  const seed = {
+    ...rest,
+    mapId: parsed["mapId"],
+    voxels
+  };
+  if (typeof parsed["blockInfo"] === "string" && parsed["blockInfo"].length > 0) {
+    const blockInfo = decodeBlockInfo(base64ToBytes(parsed["blockInfo"]));
+    if (blockInfo !== null) seed.blockInfo = blockInfo;
+  }
+  return seed;
+}
+
+// src/core/maps/catalog.ts
+var MAP_CATALOG_VERSION = 1;
+var SLUG_RE = /^[a-z0-9][a-z0-9-_]*$/;
+var MAX_SLUG_LENGTH = 63;
+var WORLD_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+var EMPTY_MAP_CATALOG = { version: MAP_CATALOG_VERSION, maps: [] };
+var MapCatalogError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "MapCatalogError";
+    this.code = code;
+  }
+};
+function fail(code, message) {
+  throw new MapCatalogError(code, message);
+}
+function isMapSlug(value) {
+  return value.length > 0 && value.length <= MAX_SLUG_LENGTH && SLUG_RE.test(value);
+}
+function assertMapSlug(slug) {
+  if (!isMapSlug(slug)) fail("INVALID_SLUG", `invalid map slug "${slug}"`);
+  return slug;
+}
+function assertWorldId(worldId) {
+  if (!WORLD_ID_RE.test(worldId) || worldId === "." || worldId === "..") {
+    fail("INVALID_PATH", `invalid world id "${worldId}"`);
+  }
+  return worldId;
+}
+function normalizeRootUrl(raw) {
+  if (typeof raw !== "string" || raw.trim().length === 0) {
+    fail("INVALID_ROOT", "map root must be a non-empty URL");
+  }
+  let url;
+  try {
+    url = new URL(raw.trim());
+  } catch {
+    fail("INVALID_ROOT", `map root is not a valid URL: ${raw}`);
+  }
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    fail("INVALID_ROOT", `map root must be http(s): ${raw}`);
+  }
+  url.hash = "";
+  if (!url.pathname.endsWith("/")) {
+    const lastSegment = url.pathname.split("/").pop() ?? "";
+    if (/\.[A-Za-z0-9]+$/.test(lastSegment)) {
+      fail(
+        "INVALID_ROOT",
+        `map root must be the unpacked map directory, not a file ("${lastSegment}"); use its parent directory ending in "/"`
+      );
+    }
+    url.pathname += "/";
+  }
+  return url.toString();
+}
+function assertRelativeMapPath(relPath) {
+  if (relPath.length === 0 || relPath.includes("\0") || relPath.includes("\\")) {
+    fail("INVALID_PATH", `invalid map path "${relPath}"`);
+  }
+  if (relPath.startsWith("/")) fail("INVALID_PATH", `absolute map path "${relPath}"`);
+  const parts2 = [];
+  for (const part of relPath.split("/")) {
+    if (part === "" || part === ".") continue;
+    if (part === "..") fail("INVALID_PATH", `map path escapes the root: "${relPath}"`);
+    parts2.push(part);
+  }
+  if (parts2.length === 0) fail("INVALID_PATH", "empty map path");
+  return parts2.join("/");
+}
+function mapFilePath(root, relPath) {
+  const base = new URL(normalizeRootUrl(root));
+  const relative = assertRelativeMapPath(relPath);
+  const url = new URL(relative, base);
+  if (url.origin !== base.origin || !url.pathname.startsWith(base.pathname)) {
+    fail("INVALID_PATH", `map path escapes the root: "${relPath}"`);
+  }
+  if (base.search.length > 0) url.search = base.search;
+  url.hash = "";
+  return url.toString();
+}
+function optionalString(value, label, code = "INVALID_MAP") {
+  if (value === void 0) return void 0;
+  if (typeof value !== "string" || value.trim().length === 0) {
+    fail(code, `${label} must be a non-empty string`);
+  }
+  return value.trim();
+}
+function parseEntry(value, index) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    fail("INVALID_MAP", `maps[${index}] must be an object`);
+  }
+  const record = value;
+  const slug = optionalString(record.slug, `maps[${index}].slug`, "INVALID_SLUG");
+  if (slug === void 0) fail("INVALID_SLUG", `maps[${index}].slug is required`);
+  assertMapSlug(slug);
+  const rootRaw = optionalString(record.root, `maps[${index}].root`, "INVALID_ROOT");
+  if (rootRaw === void 0) fail("INVALID_ROOT", `maps[${slug}].root is required`);
+  const root = normalizeRootUrl(rootRaw);
+  const worldId = optionalString(record.worldId, `maps[${index}].worldId`);
+  const assetRoot = optionalString(record.assetRoot, `maps[${index}].assetRoot`, "INVALID_ROOT");
+  const name = optionalString(record.name, `maps[${index}].name`);
+  const author = optionalString(record.author, `maps[${index}].author`);
+  const version = optionalString(record.version, `maps[${index}].version`);
+  const etag = optionalString(record.etag, `maps[${index}].etag`);
+  const cover = optionalString(record.cover, `maps[${index}].cover`);
+  return {
+    slug,
+    root,
+    ...worldId !== void 0 ? { worldId: assertWorldId(worldId) } : {},
+    ...name !== void 0 ? { name } : {},
+    ...author !== void 0 ? { author } : {},
+    ...version !== void 0 ? { version } : {},
+    ...etag !== void 0 ? { etag } : {},
+    ...cover !== void 0 ? { cover } : {},
+    ...assetRoot !== void 0 ? { assetRoot: normalizeRootUrl(assetRoot) } : {}
+  };
+}
+function parseMapCatalog(input) {
+  if (input === void 0 || input === null) return EMPTY_MAP_CATALOG;
+  if (typeof input !== "object" || Array.isArray(input)) {
+    fail("INVALID_CATALOG", "maps.json must be an object");
+  }
+  const record = input;
+  const version = record.version ?? MAP_CATALOG_VERSION;
+  if (version !== MAP_CATALOG_VERSION) {
+    fail("INVALID_CATALOG", `unsupported maps.json version ${String(version)}`);
+  }
+  if (!Array.isArray(record.maps)) {
+    fail("INVALID_CATALOG", "maps.json `maps` must be an array");
+  }
+  const maps = record.maps.map((entry, index) => parseEntry(entry, index));
+  const seen = /* @__PURE__ */ new Set();
+  for (const map of maps) {
+    if (seen.has(map.slug)) fail("DUPLICATE_SLUG", `duplicate map slug "${map.slug}"`);
+    seen.add(map.slug);
+  }
+  return { version: MAP_CATALOG_VERSION, maps };
+}
+function findMap(catalog, slug) {
+  return catalog.maps.find((entry) => entry.slug === slug);
+}
+
 // src/core/maps/http.ts
 var MapSourceError = class extends Error {
   code;
@@ -13962,14 +14073,14 @@ var HttpMapSource = class {
     return new Uint8Array(buffer);
   }
 };
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 async function resolveWorldId(source) {
   const bundle = await source.readJson("bundle.json");
   if (bundle === null) fail2("MAP_NO_WORLD", "bundle.json is missing or not JSON");
   const members = Array.isArray(bundle.members) ? bundle.members : [];
-  const records = members.filter(isRecord2);
+  const records = members.filter(isRecord3);
   const main = records.find((member) => member.mapRole === "main") ?? records[0];
   const candidate = (main !== void 0 && typeof main.id === "string" ? main.id : void 0) ?? (typeof bundle.mainProjectId === "string" ? bundle.mainProjectId : void 0);
   if (candidate === void 0) {
@@ -13978,6 +14089,13 @@ async function resolveWorldId(source) {
   return assertWorldId(candidate);
 }
 async function loadWorldSeedFromHttp(entry, options = {}) {
+  if (options.preferSeedPack !== false) {
+    const packed = await loadSeedPackFromHttp(entry, options);
+    if (packed !== null) return packed;
+  }
+  return (await loadWorldSeedGraphFromHttp(entry, options)).seed;
+}
+async function loadWorldSeedGraphFromHttp(entry, options = {}) {
   const source = new HttpMapSource(entry.root, options);
   const worldId = entry.worldId ?? await resolveWorldId(source);
   const manifest = await source.readJson(
@@ -13986,13 +14104,35 @@ async function loadWorldSeedFromHttp(entry, options = {}) {
   if (manifest === null) {
     fail2("MAP_NO_WORLD", `worlds/${worldId}/manifest.json is missing or not JSON`);
   }
-  return resolveWorldSeed(
+  const seed = await resolveWorldSeed(
     { worldId, manifest, reader: source },
     { concurrency: options.concurrency ?? DEFAULT_CONCURRENCY }
-  ).then(async (seed) => {
-    const blockInfo = await loadBlockInfo(source, worldId);
-    return blockInfo === null ? seed : { ...seed, blockInfo };
-  });
+  );
+  const blockInfoBytes = await readBlockInfoBytes(source, worldId) ?? void 0;
+  const blockInfo = blockInfoBytes === void 0 ? null : decodeBlockInfo(blockInfoBytes);
+  return {
+    seed: blockInfo === null ? seed : { ...seed, blockInfo },
+    ...blockInfoBytes !== void 0 ? { blockInfoBytes } : {}
+  };
+}
+async function loadSeedPackFromHttp(entry, options) {
+  const source = new HttpMapSource(entry.root, options);
+  for (const file of SEED_PACK_FILES) {
+    let bytes;
+    try {
+      bytes = await source.read(file);
+    } catch {
+      continue;
+    }
+    if (bytes === null) continue;
+    try {
+      const seed = await decodeSeedPackAuto(bytes);
+      if (entry.worldId !== void 0 && seed.mapId !== entry.worldId) continue;
+      return seed;
+    } catch {
+    }
+  }
+  return null;
 }
 var MEBIBYTE = 1024 * 1024;
 var ZERO_PLAYER_TIMEOUT_DEFAULT_MS = 48e4;
@@ -16576,6 +16716,8 @@ var Room = class {
   createPair;
   logger;
   secret;
+  /** Worker static-assets binding, used to read seed packs bundled at deploy. */
+  assets;
   engine;
   script;
   explicitScriptHost;
@@ -16638,6 +16780,10 @@ var Room = class {
   pendingEngineMap;
   /** Identity of the map the current engine was seeded from. */
   seededMap;
+  /** Non-fatal seed warnings (missing blobs, skipped entities, …). */
+  seedWarnings = [];
+  /** Last map-load failure; cleared on a successful seed. */
+  mapLoadError;
   heartbeatBeats = 0;
   ticksRun = 0;
   lastTickError;
@@ -16661,6 +16807,7 @@ var Room = class {
     this.createPair = options.createPair ?? defaultCreatePair;
     this.logger = options.logger ?? defaultLogger;
     this.secret = options.secret ?? resolveSessionSecret(env);
+    this.assets = env.ASSETS;
     this.engine = options.engine ?? getRoomEngineFactory()?.() ?? createNullEngine();
     this.explicitScriptHost = options.scriptHost !== void 0;
     this.script = options.scriptHost ?? this.engine;
@@ -16755,7 +16902,9 @@ var Room = class {
           ok: true,
           slug: this.mapBootstrap?.slug ?? null,
           seeded: this.worldReady,
-          entities: this.engine.getReplica().entities.length
+          entities: this.engine.getReplica().entities.length,
+          mapLoadError: this.mapLoadError ?? null,
+          warnings: this.seedWarnings
         }),
         { headers: { "content-type": "application/json", "cache-control": "no-store" } }
       );
@@ -16786,6 +16935,8 @@ var Room = class {
           secretPackets: this.secretPackets,
           clockPings: this.clockPings,
           inboundIds: Object.fromEntries(this.inboundIds),
+          mapLoadError: this.mapLoadError ?? null,
+          mapWarnings: this.seedWarnings,
           voxel: this.engine.voxelGeometry?.() ?? null,
           sampleEntity: (() => {
             const entity = this.engine.getReplica().entities[0];
@@ -16883,21 +17034,32 @@ var Room = class {
       this.engine = engine;
       if (!this.explicitScriptHost) this.script = engine;
       this.seededMap = { slug: bootstrap.slug, root: bootstrap.root, worldId: seed.mapId };
+      this.seedWarnings = seed.warnings;
+      this.mapLoadError = void 0;
+      for (const warning of seed.warnings) {
+        this.logger.log(`cajonzero: map "${bootstrap.slug}" warning: ${warning}`);
+      }
       this.applyPendingEngineSnapshot();
       this.worldReady = true;
       this.logger.log(`cajonzero: seeded room "${bootstrap.slug}" from "${seed.mapId}"`);
     } catch (error) {
+      this.mapLoadError = describeError2(error);
       this.logger.error(
-        `cajonzero: map load failed for "${bootstrap.slug}": ${describeError2(error)}`
+        `cajonzero: map load failed for "${bootstrap.slug}": ${this.mapLoadError}`
       );
     }
   }
   loadSeed(bootstrap) {
-    return loadWorldSeedFromHttp(bootstrap, {
-      ...bootstrap.maxDownloadBytes !== void 0 ? { maxDownloadBytes: bootstrap.maxDownloadBytes } : {},
-      ...bootstrap.concurrency !== void 0 ? { concurrency: bootstrap.concurrency } : {},
-      ...bootstrap.requestTimeoutMs !== void 0 ? { requestTimeoutMs: bootstrap.requestTimeoutMs } : {}
-    });
+    return loadSeedPackFromAssets(this.assets, bootstrap.slug, bootstrap.worldId).then(
+      (packed) => {
+        if (packed !== null) return packed;
+        return loadWorldSeedFromHttp(bootstrap, {
+          ...bootstrap.maxDownloadBytes !== void 0 ? { maxDownloadBytes: bootstrap.maxDownloadBytes } : {},
+          ...bootstrap.concurrency !== void 0 ? { concurrency: bootstrap.concurrency } : {},
+          ...bootstrap.requestTimeoutMs !== void 0 ? { requestTimeoutMs: bootstrap.requestTimeoutMs } : {}
+        });
+      }
+    );
   }
   /**
    * Run the full connect path and return a structured outcome (no `Response`,

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import { Context, Hono } from 'hono';
 import { ContentfulStatusCode } from 'hono/utils/http-status';
-import { b as Env, d as MapCatalog, e as Repos, L as SessionsRepo, D as DurableObjectNamespace } from './providers-BX7e4pNW.js';
+import { b as Env, d as MapCatalog, e as Repos, L as SessionsRepo, D as DurableObjectNamespace } from './providers-BwJKzGkd.js';
 import { Store, SettingDefaults } from './core.js';
-export { c as EMPTY_MAP_CATALOG, M as MapEntry, R as Room, w as findMap, A as parseMapCatalog } from './providers-BX7e4pNW.js';
-import { C as CajonzeroConfig } from './config-BOzAyP7m.js';
-export { D as DEFAULT_CONFIG, G as GAME_NET_INBOUND_BASE, a as GAME_NET_OUTBOUND_BASE, b as MapsConfig, N as NetCodec, e as NetCodecHandlers, R as RoomConfig, q as resolveConfig } from './config-BOzAyP7m.js';
+export { c as EMPTY_MAP_CATALOG, M as MapEntry, R as Room, w as findMap, A as parseMapCatalog } from './providers-BwJKzGkd.js';
+import { C as CajonzeroConfig } from './config-B32NDXlr.js';
+export { D as DEFAULT_CONFIG, G as GAME_NET_INBOUND_BASE, a as GAME_NET_OUTBOUND_BASE, b as MapsConfig, N as NetCodec, e as NetCodecHandlers, R as RoomConfig, q as resolveConfig } from './config-B32NDXlr.js';
 export { DO_CLASSES, ServeOptions, WorkersEntry, WorkersModule, serve } from './serve.js';
 import 'unstorage';
 import 'gl-matrix';
@@ -18,7 +18,7 @@ import 'zod';
  * can read the version without creating a circular import.
  */
 declare const NAME = "cajonzero";
-declare const VERSION = "0.1.1";
+declare const VERSION = "0.1.3";
 
 /** The authenticated principal carried by a login session (T11 supplies it). */
 interface SessionIdentity {