cajonzero 0.1.2 → 0.2.0

package/dist/catalog-BRO-mQoP.d.ts

@@ -0,0 +1,67 @@
+/**
+ * cajonzero — the map catalog (`cajonzero/maps.json`).
+ *
+ * A map root is either:
+ *
+ *   - a same-origin path (`/maps/<slug>/`) that lives in the deployment's static
+ *     assets — `cj0 add` writes it there and the worker reads it through
+ *     `env.ASSETS`; or
+ *   - an absolute `http(s)://…/` URL for maps hosted on an external OSS/CDN
+ *     (the manual/split-CDN escape hatch).
+ *
+ * Expected layout under `entry.root` (exactly the archive layout):
+ *
+ * ```text
+ * <root>/bundle.json
+ * <root>/worlds/<worldId>/manifest.json
+ * <root>/worlds/<worldId>/data/project-state.json
+ * <root>/worlds/<worldId>/data/blobs/<cid>
+ * ```
+ *
+ * Worker path: URL handling + validation only, no Node globals.
+ */
+/** The only catalog version this build understands. */
+declare const MAP_CATALOG_VERSION = 1;
+/** One map in the catalog. */
+interface MapEntry {
+    /** Stable room/catalog id (`omega`, `drift`, …). */
+    readonly slug: string;
+    /** Same-origin path (`/maps/<slug>/`) or absolute `http(s)://…/` map root. */
+    readonly root: string;
+    /** `worlds/<worldId>` directory name; derived from `bundle.json` when absent. */
+    readonly worldId?: string;
+    /** Display name (falls back to the map's own manifest). */
+    readonly name?: string;
+    readonly author?: string;
+    readonly version?: string;
+    /** Optional content revision (e.g. `v1.0.4`); invalidates precomputed seeds. */
+    readonly etag?: string;
+    /** Cover image URL for the lobby. */
+    readonly cover?: string;
+    /** Optional CDN root for browser assets; defaults to {@link root}. */
+    readonly assetRoot?: string;
+    /**
+     * Project-relative private script pack (`cajonzero/private/<slug>.json.gz`).
+     * Written by `cj0 add/update`; `cj0 deploy` uploads it to KV and it is never
+     * served from `public/`.
+     */
+    readonly scriptsFile?: string;
+}
+/** The `maps.json` document. */
+interface MapCatalog {
+    readonly version: typeof MAP_CATALOG_VERSION;
+    readonly maps: readonly MapEntry[];
+}
+/** No maps configured (the scaffold default). */
+declare const EMPTY_MAP_CATALOG: MapCatalog;
+/**
+ * Validate a parsed `maps.json`.
+ *
+ * @throws {MapCatalogError} for a malformed document, entry, or duplicate slug.
+ */
+declare function parseMapCatalog(input: unknown): MapCatalog;
+/** Look up a map by slug. */
+declare function findMap(catalog: MapCatalog, slug: string): MapEntry | undefined;
+
+export { EMPTY_MAP_CATALOG as E, findMap as f, parseMapCatalog as p };
+export type { MapEntry as M, MapCatalog as a };

package/dist/{config-BOzAyP7m.d.ts → config-glwUbUbx.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, I as NetSecret } from './providers-Bu0-iMVs.js';
 
 /**
  * cajonzero — mudb protocol envelope (message-id tables + `raw` channel).

package/dist/core.d.ts

@@ -1,6 +1,8 @@
-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 { W as WorldSeed } from './providers-Bu0-iMVs.js';
+export { E as EnvProvider, c as Repos, R as Room, d as RoomOptions, e as RuntimeProviders, f as SETTINGS, g as SETTING_KEYS, a as SettingDefaults, h as SettingDefinition, i as Settings, j as SettingsError, k as SettingsErrorCode, l as SettingsService, m as StorageFactory, S as StorageSource, n as Store, o as WorldSeedReader, p as configureDefaultKV, q as createMemoryStore, r as createRepos, s as createSettingsService, t as createStore, u as getRuntimeProviders, v as isSettingKey, w as memoryDriver, x as resolveAdminToken, y as resolveEnvironment, z as resolveRooms, A as resolveSessionSecret, B as resolveSettingDefaults, C as resolveStore, F as setRuntimeProviders, G as setStorageFactory } from './providers-Bu0-iMVs.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-glwUbUbx.js';
+import { M as MapEntry } from './catalog-BRO-mQoP.js';
+export { E as EMPTY_MAP_CATALOG, a as MapCatalog, f as findMap, p as parseMapCatalog } from './catalog-BRO-mQoP.js';
 import 'unstorage';
 import 'gl-matrix';
 import 'zod';
@@ -14,8 +16,11 @@ import 'zod';
  * voxel chunk blobs. Meshes/audio are never downloaded by the server — the
  * 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.
+ * The seed is resolved on demand from the map root: map bytes stay on the CDN
+ * or in static assets, never in the deployment KV. When a precomputed
+ * `seed.json[.gz]` pack is present (`cj0 add` writes one), 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 +46,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 +76,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>;