cajonzero 0.1.3 → 0.2.0

package/dist/{providers-BwJKzGkd.d.ts → providers-Bu0-iMVs.d.ts}

@@ -1,4 +1,5 @@
 import { Storage, StorageValue, Driver } from 'unstorage';
+import { M as MapEntry } from './catalog-BRO-mQoP.js';
 import * as gl_matrix from 'gl-matrix';
 import { vec3, mat3 } from 'gl-matrix';
 import { z } from 'zod';
@@ -144,6 +145,13 @@ interface AssetsBinding {
 interface Env {
     /** KV namespace: map code/asset KV and player data (unstorage KV adapter). */
     readonly CAJONZERO_KV: KVNamespace;
+    /**
+     * Optional private KV namespace for server-only map scripts.
+     *
+     * Public seed packs strip `scripts`; this binding is the non-public half
+     * (`scripts:<slug>` → `cajonzero-scripts` JSON). Never served over HTTP.
+     */
+    readonly CAJONZERO_SCRIPTS?: KVNamespace;
     /** Durable Object namespace for per-room actors (`Room`). */
     readonly ROOMS: DurableObjectNamespace;
     /**
@@ -510,61 +518,6 @@ interface SessionRegistry {
     current(accountId: string): Promise<SessionSlotRecord | undefined>;
 }
 
-/**
- * cajonzero — the map catalog (`cajonzero/maps.json`).
- *
- * Maps are **not** stored by cajonzero. A `.boxplay` is unpacked by the operator
- * and uploaded to object storage (OSS/CDN); `maps.json` only records where each
- * map's unpacked root lives.
- *
- * 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;
-    /** Unpacked map root, absolute `http(s)://…/` URL. */
-    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;
-}
-/** 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;
-
 declare class MuBuffer {
     buffer: ArrayBuffer;
     dataView: DataView;
@@ -2425,6 +2378,8 @@ interface SeedMesh {
         duration: number;
     }[];
     renderBoxOffset?: [number, number, number];
+    /** `voxelModel` | `gltfModel` (client model loader dispatch). */
+    hashType?: string;
 }
 /** A map entity that should render a mesh (static scenery / vehicles). */
 interface SeedRenderEntity {
@@ -2445,6 +2400,36 @@ interface SeedRender {
     entities: SeedRenderEntity[];
     warnings: string[];
 }
+/** One server-side script module resolved from `scriptAssets`. */
+interface SeedScriptModule {
+    /** Content hash (`data/blobs/<hash>`). */
+    hash: string;
+    /** UTF-8 module source. */
+    source: string;
+    /** Editor ordering hint (diagnostics only). */
+    order: number;
+    /** Logical name from `scriptAssets` (usually the file id). */
+    name?: string;
+}
+/** Resolved server-side map scripts (`scriptIndex` + modules). */
+interface SeedScripts {
+    /** Entry module key, e.g. `index.js` (empty when the map has no scripts). */
+    index: string;
+    modules: Record<string, SeedScriptModule>;
+    /** Map catalog version/etag at pack time (private-pack cache key). */
+    revision?: string;
+}
+/** Per-entity seed metadata used by the map-script runtime (name + tags). */
+interface SeedEntitySeedInfo {
+    id: number;
+    name: string;
+    tags: string[];
+}
+/** One audio asset (path → content hash) for `world.sound` / `resources`. */
+interface SeedAudioAsset {
+    path: string;
+    hash: string;
+}
 /** The resolved, pure world seed. */
 interface WorldSeed {
     version: number;
@@ -2463,6 +2448,12 @@ interface WorldSeed {
     voxels: SeedVoxels | null;
     /** Mesh/entity render projection (empty when the map has no models). */
     render?: SeedRender;
+    /** Server-side map scripts. Never include this in a public seed pack. */
+    scripts?: SeedScripts;
+    /** Entity names/tags used to seed the map-script entity table. */
+    seedInfo?: SeedEntitySeedInfo[];
+    /** Audio assets for `resources` / `world.sound`. */
+    audioAssets?: SeedAudioAsset[];
     /** Number of entities present in the map's `entitiesTree`. */
     entityCount: number;
     /** Human-readable record of anything skipped (never silently dropped). */
@@ -2655,6 +2646,32 @@ interface SettingsService {
 /** Construct a {@link SettingsService} over a T4 `SettingsRepo`. */
 declare function createSettingsService(options: CreateSettingsServiceOptions): SettingsService;
 
+type ProtocolMessageHandler = (sessionId: string, data: unknown, unreliable: boolean) => void;
+interface ProtocolBusOptions {
+    /** Send reliable bytes on the player's game socket. */
+    send(sessionId: string, bytes: Uint8Array, unreliable: boolean): void;
+}
+declare class ProtocolBus {
+    private readonly options;
+    private readonly inbound;
+    private readonly outbound;
+    private readonly inboundByBase;
+    private readonly handlers;
+    constructor(options: ProtocolBusOptions);
+    /** Register a handler for one inbound protocol message. */
+    on(protocol: string, message: string, handler: ProtocolMessageHandler): void;
+    /**
+     * Try to decode a post-game-net frame. Returns `true` when the id belongs to
+     * this bus (even if no handler is registered), so `NetCodec` never logs it as
+     * unknown. Returns `false` for game-net frames.
+     */
+    tryDecode(sessionId: string, data: Uint8Array | string, unreliable: boolean): boolean;
+    /** Encode one server→client message for `protocol`. */
+    encode(protocol: string, message: string, payload: unknown): Uint8Array | null;
+    /** Encode and send one server→client message. */
+    send(sessionId: string, protocol: string, message: string, payload: unknown, unreliable?: boolean): boolean;
+}
+
 /**
  * cajonzero — mudb `MuSocketServer`-compatible adapter for Cloudflare workerd (T8).
  *
@@ -4941,6 +4958,8 @@ interface ScriptHost {
     clearEvents(): void;
     suspend(): void;
     resume(): void;
+    /** Optional teardown (QuickJS VM, timers). Called when the room is replaced. */
+    dispose?(): void;
 }
 /** The Durable Object storage surface the room uses (structural). */
 interface RoomStorage {
@@ -4976,6 +4995,14 @@ interface RoomOptions {
      */
     emptyGraceMs?: number;
     heartbeatIntervalMs?: number;
+    /**
+     * Drop a connection that has sent no frame for this long (ms). Defaults to
+     * {@link DEFAULT_PLAYER_IDLE_TIMEOUT_MS}. This is the room's own liveness
+     * check — a client that never sends a close frame must still be removed.
+     */
+    playerIdleTimeoutMs?: number;
+    /** How often to look for silent connections (ms). Defaults to 60 s. */
+    idleSweepIntervalMs?: number;
     maxStepsPerFrame?: number;
     /** Simulation engine. Defaults to the registered factory or a null engine. */
     engine?: RoomEngine;
@@ -5038,6 +5065,12 @@ declare class Room {
     /** Tracks the async settings read that arms the grace timer at drain. */
     private graceOps;
     private readonly heartbeatIntervalMs;
+    private readonly playerIdleTimeoutMs;
+    private readonly idleSweepIntervalMs;
+    /** Wall-clock of the last sweep for silent connections. */
+    private lastIdleSweepAt;
+    /** Last time an inbound frame was seen per session (liveness). */
+    private readonly lastSeenAt;
     private readonly maxStepsPerFrame;
     private readonly manualClock;
     private readonly createPair;
@@ -5045,6 +5078,8 @@ declare class Room {
     private readonly secret;
     /** Worker static-assets binding, used to read seed packs bundled at deploy. */
     private readonly assets;
+    private readonly scriptsKv;
+    private readonly store;
     private engine;
     private script;
     private readonly explicitScriptHost;
@@ -5052,6 +5087,7 @@ declare class Room {
     private readonly sockets;
     /** mudb wire codec: protocol envelope + netcode frames. */
     private readonly codec;
+    private readonly protocolBus;
     private readonly modelCodec;
     private readonly messageHandlers;
     private readonly banChecker;
@@ -5159,6 +5195,14 @@ declare class Room {
     private applyPendingEngineSnapshot;
     private loadWorld;
     private loadSeed;
+    /**
+     * Merge the private scripts pack (`CAJONZERO_SCRIPTS`) into a public seed.
+     *
+     * Public seed packs deliberately strip `scripts`; this binding is the
+     * server-only half and is never served over HTTP. Missing/broken packs keep
+     * the room playable without scripts.
+     */
+    private attachPrivateScripts;
     /**
      * Run the full connect path and return a structured outcome (no `Response`,
      * so tests can drive it without a workerd runtime). Steps: resolve the sid →
@@ -5177,7 +5221,6 @@ declare class Room {
     private admitConnectionOnce;
     private startSockets;
     private registerSocket;
-    /** Build the per-connection codec callback table (allocated once per socket). */
     private createHandlers;
     /**
      * Decode one inbound frame. A protocol violation closes the socket exactly like
@@ -5275,6 +5318,17 @@ declare class Room {
      * secret diff → pings → clear events.
      */
     tickOnce(): void;
+    /**
+     * Drop connections the client never told us about.
+     *
+     * A player is normally removed by `removeClient` when the socket closes, but
+     * a browser cannot be trusted to send that close frame: an SPA that tears the
+     * engine down half-way, a sleeping laptop, a dropped mobile link or a killed
+     * tab all leave the socket open from the room's point of view. Without this
+     * sweep the player stays in the world for everyone else and keeps the
+     * account's session slot.
+     */
+    private sweepIdleConnections;
     private buildContext;
     private buildSecret;
     private startTickLoop;
@@ -5312,6 +5366,8 @@ declare class Room {
     get phase(): RoomPhase;
     /** Current simulation tick. */
     get tick(): number;
+    /** Extra game-socket protocols (dialog/chat/gui/...) after `game-net`. */
+    getProtocolBus(): ProtocolBus;
     /** `true` once the empty-grace window has elapsed (heartbeat released). */
     get isEvictable(): boolean;
     /** `true` while the draining heartbeat is armed (the DO is pinned). */
@@ -5378,5 +5434,5 @@ declare function resolveEnvironment(env: Env): string | undefined;
 declare function resolveRooms(env: Env): DurableObjectNamespace | undefined;
 declare function resolveSettingDefaults(env: Env): SettingDefaults | undefined;
 
-export { parseMapCatalog as A, resolveAdminToken as B, resolveEnvironment as C, resolveRooms as F, resolveSessionSecret as G, resolveSettingDefaults as H, resolveStore as I, setRuntimeProviders as J, setStorageFactory as K, Room as R, EMPTY_MAP_CATALOG as c, SETTINGS as h, SETTING_KEYS as i, SettingsError as l, configureDefaultKV as r, createMemoryStore as s, createRepos as t, createSettingsService as u, createStore as v, findMap as w, getRuntimeProviders as x, isSettingKey as y, memoryDriver as z };
-export type { DurableObjectNamespace as D, EnvProvider as E, SessionsRepo as L, MapEntry as M, NetPublic as N, NetSecret as O, StorageSource as S, TimestampedClientInput as T, WorldSeed as W, SettingDefaults as a, Env as b, MapCatalog as d, Repos as e, RoomOptions as f, RuntimeProviders as g, SettingDefinition as j, Settings as k, SettingsErrorCode as m, SettingsService as n, StorageFactory as o, Store as p, WorldSeedReader as q };
+export { resolveSessionSecret as A, resolveSettingDefaults as B, resolveStore as C, setRuntimeProviders as F, setStorageFactory as G, Room as R, SETTINGS as f, SETTING_KEYS as g, SettingsError as j, configureDefaultKV as p, createMemoryStore as q, createRepos as r, createSettingsService as s, createStore as t, getRuntimeProviders as u, isSettingKey as v, memoryDriver as w, resolveAdminToken as x, resolveEnvironment as y, resolveRooms as z };
+export type { DurableObjectNamespace as D, EnvProvider as E, SessionsRepo as H, NetSecret as I, NetPublic as N, StorageSource as S, TimestampedClientInput as T, WorldSeed as W, SettingDefaults as a, Env as b, Repos as c, RoomOptions as d, RuntimeProviders as e, SettingDefinition as h, Settings as i, SettingsErrorCode as k, SettingsService as l, StorageFactory as m, Store as n, WorldSeedReader as o };

package/dist/scaffold.d.ts

@@ -10,8 +10,8 @@
  * ## Where configuration lives
  *
  * - `cajonzero/config.json` — cajonzero runtime config (room policy, map fetch policy).
- * - `cajonzero/maps.json`   — the map catalog; entries point at unpacked map roots
- *   hosted on OSS/CDN. Maps are never stored in the project.
+ * - `cajonzero/maps.json`   — the map catalog; `cj0 add` writes `/maps/<slug>/` roots
+ *   (static assets) and the operator may switch a root to an external CDN URL.
  * - `wrangler.jsonc`      — Cloudflare bindings (KV, Durable Object, assets).
  *
  * `buildScaffoldFiles()` is imported by BOTH the scaffolder (`createProject`)
@@ -62,7 +62,7 @@ declare const SCAFFOLD_KV_PLACEHOLDER_ID = "PLACEHOLDER_KV_ID";
 declare const SCAFFOLD_ENTRY_CONTENT: string;
 /** `cajonzero/config.json` — runtime policy; secrets stay in `wrangler secret`. */
 declare const SCAFFOLD_CONFIG_CONTENT: string;
-/** `cajonzero/maps.json` — empty by default; see the README for an entry. */
+/** `cajonzero/maps.json` — empty by default; `cj0 add` fills it. */
 declare const SCAFFOLD_MAPS_CONTENT: string;
 /**
  * Render the complete, deterministically ordered set of files for a created
@@ -222,12 +222,14 @@ declare function applySetup(options: SetupOptions): SetupResult;
 /** Marker written inside the target dir; excluded from the copy and the hash. */
 declare const ASSETS_STAMP_FILE = ".cajonzero-assets.json";
 /**
- * Subdirectory of `assets.directory` that holds `cj0 worker build-seed` packs.
- * `worker prepare` preserves it when re-syncing the packaged UI.
+ * Subdirectory of the assets directory that holds `cj0 add` map imports.
+ * {@link syncPublicAssets} preserves it when re-syncing the packaged UI.
  */
-declare const ASSETS_SEED_DIR = "seed";
-/** Options for {@link prepareWorkerAssets}. */
-interface PrepareWorkerAssetsOptions {
+declare const ASSETS_MAPS_DIR = "maps";
+/** Preserved file (keeps an otherwise empty `public/` in git). */
+declare const ASSETS_KEEP_FILE = ".gitkeep";
+/** Options for {@link syncPublicAssets}. */
+interface SyncPublicAssetsOptions {
     /** Project directory (default: `process.cwd()`). */
     readonly cwd?: string;
     /** Wrangler config, relative to `cwd` (default: `wrangler.jsonc`). */
@@ -242,8 +244,8 @@ interface PrepareWorkerAssetsOptions {
     /** Copy even when the fingerprint already matches. */
     readonly force?: boolean;
 }
-/** Result of a successful preparation. */
-interface PrepareWorkerAssetsResult {
+/** Result of a successful sync. */
+interface SyncPublicAssetsResult {
     /** Absolute source directory (the packaged UI). */
     readonly sourceDir: string;
     /** Absolute target directory (the project's `assets.directory`). */
@@ -260,13 +262,14 @@ interface PrepareWorkerAssetsResult {
 /** Throw when `configPath` is missing or has no `assets.directory`. */
 declare function readWranglerAssetsDirectory(configPath: string): string | undefined;
 /**
- * Materialise cajonzero's packaged UI into the project's static-assets
- * directory. Idempotent: a matching fingerprint is a no-op.
+ * Copy cajonzero's packaged UI into the project's static-asset directory.
+ * Idempotent: a matching fingerprint is a no-op. Imported maps under
+ * `<target>/maps/` and a `.gitkeep` are preserved across the wipe.
  *
  * @throws when the packaged UI is missing, the config has no `assets.directory`
  *   and no override was given, or the target would overlap the project/source.
  */
-declare function prepareWorkerAssets(options?: PrepareWorkerAssetsOptions): Promise<PrepareWorkerAssetsResult>;
+declare function syncPublicAssets(options?: SyncPublicAssetsOptions): Promise<SyncPublicAssetsResult>;
 
-export { ASSETS_SEED_DIR, ASSETS_STAMP_FILE, SCAFFOLD_COMPATIBILITY_DATE, SCAFFOLD_CONFIG_CONTENT, SCAFFOLD_ENTRY_CONTENT, SCAFFOLD_ENTRY_PATH, SCAFFOLD_KV_PLACEHOLDER_ID, SCAFFOLD_MAPS_CONTENT, SETUP_FIELDS, ScaffoldError, applySetup, buildScaffoldFiles, createProject, generateAdminToken, generateSecret, parseDevVars, parseJsoncObject, prepareWorkerAssets, readCajonzeroPackage, readSetupValues, readWranglerAssetsDirectory, readWranglerKvNamespaceId, serializeDevVars, setWranglerKvNamespaceId, setWranglerVars, suggestedValue, toPackageName };
-export type { CajonzeroPackageInfo, CreateProjectOptions, PrepareWorkerAssetsOptions, PrepareWorkerAssetsResult, ScaffoldErrorCode, ScaffoldFile, ScaffoldResult, ScaffoldTemplateOptions, SetupField, SetupKind, SetupOptions, SetupResult };
+export { ASSETS_KEEP_FILE, ASSETS_MAPS_DIR, ASSETS_STAMP_FILE, SCAFFOLD_COMPATIBILITY_DATE, SCAFFOLD_CONFIG_CONTENT, SCAFFOLD_ENTRY_CONTENT, SCAFFOLD_ENTRY_PATH, SCAFFOLD_KV_PLACEHOLDER_ID, SCAFFOLD_MAPS_CONTENT, SETUP_FIELDS, ScaffoldError, applySetup, buildScaffoldFiles, createProject, generateAdminToken, generateSecret, parseDevVars, parseJsoncObject, readCajonzeroPackage, readSetupValues, readWranglerAssetsDirectory, readWranglerKvNamespaceId, serializeDevVars, setWranglerKvNamespaceId, setWranglerVars, suggestedValue, syncPublicAssets, toPackageName };
+export type { CajonzeroPackageInfo, CreateProjectOptions, ScaffoldErrorCode, ScaffoldFile, ScaffoldResult, ScaffoldTemplateOptions, SetupField, SetupKind, SetupOptions, SetupResult, SyncPublicAssetsOptions, SyncPublicAssetsResult };

package/dist/scaffold.js

@@ -72,7 +72,7 @@ var SCAFFOLD_CONFIG_CONTENT = `${JSON.stringify(
 `;
 var SCAFFOLD_MAPS_CONTENT = `${JSON.stringify({ version: 1, maps: [] }, null, 2)}
 `;
-var PREPARE_ASSETS = "cj0 worker prepare";
+var SCAFFOLD_PUBLIC_KEEP_PATH = "public/.gitkeep";
 function packageJson(options) {
   const manifest = {
     name: options.packageName,
@@ -80,14 +80,12 @@ function packageJson(options) {
     private: true,
     type: "module",
     scripts: {
-      dev: `${PREPARE_ASSETS} && wrangler dev`,
-      build: `${PREPARE_ASSETS} && cj0 worker build-seed && wrangler deploy --dry-run`,
-      // Deploy always rebuilds: map content can change without `version` being
-      // bumped, and the room prefers the pack over the live CDN graph.
-      deploy: `${PREPARE_ASSETS} && cj0 worker build-seed --force && wrangler deploy`,
-      // `prepare` also runs after `npm install`, so a plain install leaves a
-      // ready-to-deploy project. Seed packs are network work and stay out of it.
-      prepare: PREPARE_ASSETS
+      dev: "wrangler dev",
+      // `cj0 deploy` syncs the packaged UI, uploads the private map-script
+      // packs, then runs `wrangler deploy` — one command, no build chain.
+      deploy: "cj0 deploy",
+      sync: "cj0 sync",
+      maps: "cj0 list"
     },
     dependencies: {
       cajonzero: options.cajonzeroRange,
@@ -112,11 +110,16 @@ function wranglerConfig(options) {
     `  "compatibility_date": ${JSON.stringify(options.compatibilityDate)},`,
     "  // Deliberately NO `nodejs_compat`: cajonzero's worker path is Node-free.",
     '  "compatibility_flags": [],',
-    "  // Static UI (play lobby + owner admin console) served by the worker.",
-    "  // cajonzero ships the built assets into this directory.",
+    "  // QuickJS is a build-time-compiled WASM module; workerd forbids runtime",
+    "  // WebAssembly codegen. Keep this rule when editing the config.",
+    '  "rules": [',
+    '    { "type": "CompiledWasm", "globs": ["**/*.wasm"], "fallthrough": true }',
+    "  ],",
+    "  // Static UI + imported maps (play lobby + owner admin console).",
+    "  // `cj0 sync` writes the packaged UI here; `cj0 add` writes public/maps/.",
     '  "assets": {',
-    '    "directory": "dist/ui",',
-    "    // Binding so the room can read seed packs bundled at deploy time.",
+    '    "directory": "public",',
+    "    // Binding so the room can read imported maps + seed packs at runtime.",
     '    "binding": "ASSETS",',
     "    // History routing: deep links (/play/x, /admin/bans) boot index.html.",
     '    "not_found_handling": "single-page-application",',
@@ -203,24 +206,25 @@ function readme(options) {
     "",
     "## \u5730\u56FE",
     "",
-    "\u5730\u56FE\u4E0D\u968F worker \u4E0A\u4F20\u3002\u628A\u89E3\u5305\u540E\u7684 `.boxplay` \u76EE\u5F55\u4F20\u5230 OSS/S3/CDN\uFF08\u9700\u5141\u8BB8 CORS\uFF09\uFF0C",
-    "\u518D\u5728 `cajonzero/maps.json` \u767B\u8BB0\uFF1A",
+    "\u5730\u56FE\u5728\u672C\u5730\u5BFC\u5165\uFF0C\u968F worker \u4E00\u6B21\u90E8\u7F72\uFF08\u9759\u6001\u8D44\u6E90 `public/`\uFF09\uFF1A",
     "",
-    "```json",
-    "{",
-    '  "version": 1,',
-    '  "maps": [',
-    "    {",
-    '      "slug": "omega",',
-    '      "root": "https://cdn.example.com/cajonzero/omega/",',
-    '      "worldId": "project-omega",',
-    '      "name": "Omega City Reloaded"',
-    "    }",
-    "  ]",
-    "}",
+    "```bash",
+    "npx cj0 add ./race.boxplay                 # \u89E3\u5305\u5230 public/maps/race/ \u5E76\u751F\u6210 seed",
+    "npx cj0 update race ./race-v2.boxplay      # \u8986\u76D6\u5DF2\u6709 slug",
+    "npx cj0 list                               # \u67E5\u770B catalog + \u672C\u5730\u5BFC\u5165\u72B6\u6001",
+    "npx cj0 remove race                        # \u5220\u9664\u5730\u56FE\u3001\u79C1\u6709\u811A\u672C\u4E0E catalog \u6761\u76EE",
     "```",
     "",
-    "`root` \u5FC5\u987B\u4EE5 `/` \u7ED3\u5C3E\uFF1B\u66F4\u65B0\u5730\u56FE\u540E\u5237\u65B0 CDN \u7F13\u5B58\u6216\u6362\u8DEF\u5F84\u3002",
+    "`add/update` \u4F1A\uFF1A",
+    "",
+    "1. \u628A\u516C\u5F00\u5730\u56FE\u8D44\u6E90\u89E3\u5305\u5230 `public/maps/<slug>/`\uFF1B",
+    "2. \u5728\u672C\u5730\u89E3\u6790\u4E16\u754C\u56FE\u5E76\u5199\u5165 `public/maps/<slug>/seed.json.gz`\uFF1B",
+    "3. \u628A**\u670D\u52A1\u7AEF\u811A\u672C**\u5199\u5230 `cajonzero/private/<slug>.json.gz`\uFF0C\u4E0D\u8FDB\u5165 `public/`\uFF1B",
+    '4. \u5728 `cajonzero/maps.json` \u5199\u5165 `"root": "/maps/<slug>/"`\uFF0C\u5E76\u628A\u670D\u52A1\u7AEF\u811A\u672C\u6587\u4EF6\u8BB0\u5F55\u4E3A',
+    '   `"scriptsFile": "cajonzero/private/<slug>.json.gz"`\uFF08\u8BE5\u76EE\u5F55\u4F1A\u63D0\u4EA4\uFF0CCF \u6784\u5EFA\u65F6 `cj0 deploy` \u53EF\u4E0A\u4F20\uFF09\u3002',
+    "",
+    "\u9700\u8981\u72EC\u7ACB CDN \u65F6\uFF0C\u624B\u52A8\u628A\u8BE5\u6761\u76EE\u7684 `root` \u6539\u6210 `https://cdn.example.com/.../` \u5373\u53EF\uFF1B",
+    "`cj0 update` \u9ED8\u8BA4\u4FDD\u7559\u4F60\u6539\u8FC7\u7684 `root`\uFF08`--reset-root` \u53EF\u6062\u590D\uFF09\u3002",
     "",
     "## \u90E8\u7F72",
     "",
@@ -228,6 +232,9 @@ function readme(options) {
     "npm run deploy",
     "```",
     "",
+    "`cj0 deploy` \u4F1A\u540C\u6B65\u6253\u5305\u7684 UI \u5230 `public/`\u3001\u4E0A\u4F20\u79C1\u6709\u811A\u672C\uFF0C\u7136\u540E\u6267\u884C",
+    "`wrangler deploy`\u3002\u9996\u6B21\u90E8\u7F72\u524D\u5148\u8FD0\u884C `npx cj0 setup`\u3002",
+    "",
     "\u5927\u5385\u5728 `/`\uFF0C\u7BA1\u7406\u540E\u53F0\u5728 `/admin`\u3002",
     ""
   ].join("\n");
@@ -242,6 +249,7 @@ function buildScaffoldFiles(options) {
       content: SCAFFOLD_CONFIG_CONTENT.replace("<project-name>", options.packageName)
     },
     { path: "cajonzero/maps.json", content: SCAFFOLD_MAPS_CONTENT },
+    { path: SCAFFOLD_PUBLIC_KEEP_PATH, content: "" },
     { path: ".gitignore", content: gitignore() },
     { path: "README.md", content: readme(options) }
   ];
@@ -683,7 +691,8 @@ function applySetup(options) {
   return { configPath, devVarsPath, vars, secrets, ...kvId !== void 0 ? { kvId } : {} };
 }
 var ASSETS_STAMP_FILE = ".cajonzero-assets.json";
-var ASSETS_SEED_DIR = "seed";
+var ASSETS_MAPS_DIR = "maps";
+var ASSETS_KEEP_FILE = ".gitkeep";
 var DEFAULT_CONFIG = "wrangler.jsonc";
 function resolvePackageRoot() {
   try {
@@ -763,7 +772,7 @@ function assertSafeTarget(targetDir, sourceDir, configDir) {
     throw new Error(`assets \u76EE\u5F55\u4E0D\u80FD\u5305\u542B\u9879\u76EE\u914D\u7F6E/cajonzero \u8D44\u6E90\u76EE\u5F55\uFF1A${targetDir}`);
   }
 }
-async function prepareWorkerAssets(options = {}) {
+async function syncPublicAssets(options = {}) {
   const cwd = options.cwd ?? process.cwd();
   const configPath = path3.resolve(cwd, options.configPath ?? DEFAULT_CONFIG);
   const configDir = path3.dirname(configPath);
@@ -794,17 +803,25 @@ async function prepareWorkerAssets(options = {}) {
       bytes: source.bytes
     };
   }
-  const seedDir = path3.join(targetDir, ASSETS_SEED_DIR);
-  const seedBackup = `${targetDir}.${ASSETS_SEED_DIR}-backup`;
-  if (!existsSync(seedDir) && existsSync(seedBackup)) {
-    mkdirSync(path3.dirname(seedDir), { recursive: true });
-    renameSync(seedBackup, seedDir);
-  }
-  let hasSeed = false;
-  if (existsSync(seedDir)) {
-    rmSync(seedBackup, { recursive: true, force: true });
-    renameSync(seedDir, seedBackup);
-    hasSeed = true;
+  const mapsDir = path3.join(targetDir, ASSETS_MAPS_DIR);
+  const mapsBackup = path3.join(configDir, `.cajonzero-maps-backup-${process.pid}`);
+  const keepFile = path3.join(targetDir, ASSETS_KEEP_FILE);
+  const keepBackup = path3.join(configDir, `.cajonzero-keep-backup-${process.pid}`);
+  if (!existsSync(mapsDir) && existsSync(mapsBackup)) {
+    mkdirSync(path3.dirname(mapsDir), { recursive: true });
+    renameSync(mapsBackup, mapsDir);
+  }
+  let hasMaps = false;
+  if (existsSync(mapsDir)) {
+    rmSync(mapsBackup, { recursive: true, force: true });
+    renameSync(mapsDir, mapsBackup);
+    hasMaps = true;
+  }
+  let hasKeep = false;
+  if (existsSync(keepFile)) {
+    rmSync(keepBackup, { force: true });
+    renameSync(keepFile, keepBackup);
+    hasKeep = true;
   }
   try {
     rmSync(targetDir, { recursive: true, force: true });
@@ -815,10 +832,15 @@ async function prepareWorkerAssets(options = {}) {
       filter: (from) => path3.basename(from) !== ASSETS_STAMP_FILE
     });
   } finally {
-    if (hasSeed && existsSync(seedBackup)) {
+    if (hasMaps && existsSync(mapsBackup)) {
+      mkdirSync(targetDir, { recursive: true });
+      rmSync(mapsDir, { recursive: true, force: true });
+      renameSync(mapsBackup, mapsDir);
+    }
+    if (hasKeep && existsSync(keepBackup)) {
       mkdirSync(targetDir, { recursive: true });
-      rmSync(seedDir, { recursive: true, force: true });
-      renameSync(seedBackup, seedDir);
+      rmSync(keepFile, { force: true });
+      renameSync(keepBackup, keepFile);
     }
   }
   const next = {
@@ -838,6 +860,6 @@ async function prepareWorkerAssets(options = {}) {
   };
 }
 
-export { ASSETS_SEED_DIR, ASSETS_STAMP_FILE, SCAFFOLD_COMPATIBILITY_DATE, SCAFFOLD_CONFIG_CONTENT, SCAFFOLD_ENTRY_CONTENT, SCAFFOLD_ENTRY_PATH, SCAFFOLD_KV_PLACEHOLDER_ID, SCAFFOLD_MAPS_CONTENT, SETUP_FIELDS, ScaffoldError, applySetup, buildScaffoldFiles, createProject, generateAdminToken, generateSecret, parseDevVars, parseJsoncObject, prepareWorkerAssets, readCajonzeroPackage, readSetupValues, readWranglerAssetsDirectory, readWranglerKvNamespaceId, serializeDevVars, setWranglerKvNamespaceId, setWranglerVars, suggestedValue, toPackageName };
+export { ASSETS_KEEP_FILE, ASSETS_MAPS_DIR, ASSETS_STAMP_FILE, SCAFFOLD_COMPATIBILITY_DATE, SCAFFOLD_CONFIG_CONTENT, SCAFFOLD_ENTRY_CONTENT, SCAFFOLD_ENTRY_PATH, SCAFFOLD_KV_PLACEHOLDER_ID, SCAFFOLD_MAPS_CONTENT, SETUP_FIELDS, ScaffoldError, applySetup, buildScaffoldFiles, createProject, generateAdminToken, generateSecret, parseDevVars, parseJsoncObject, readCajonzeroPackage, readSetupValues, readWranglerAssetsDirectory, readWranglerKvNamespaceId, serializeDevVars, setWranglerKvNamespaceId, setWranglerVars, suggestedValue, syncPublicAssets, toPackageName };
 //# sourceMappingURL=scaffold.js.map
 //# sourceMappingURL=scaffold.js.map

package/dist/serve.d.ts

@@ -1,7 +1,8 @@
 import { ExecutionContext } from 'hono';
-import { R as Room, D as DurableObjectNamespace, b as Env } from './providers-BwJKzGkd.js';
+import { R as Room, D as DurableObjectNamespace, b as Env } from './providers-Bu0-iMVs.js';
 import { StorageSource, EnvProvider, SettingDefaults } from './core.js';
 import 'unstorage';
+import './catalog-BRO-mQoP.js';
 import 'gl-matrix';
 import 'zod';