phibelle-kit 1.0.31 → 1.0.32

package/dist/commands/clone-scene.js

@@ -4,11 +4,10 @@ import * as fs from "node:fs/promises";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { WebSocketServer } from "ws";
+import { WS_PORT, CLONE_REQUEST_TYPE, CLONE_RESPONSE_TYPE, SCENE_FILE_NAME, } from "../lib/constants.js";
+import { getExecErrorText } from "../lib/utils.js";
 import { parseSceneJson, unpackageScene } from "../lib/scene/scene-packaging.js";
 import { setupSceneDirectory } from "../scene-setup/setup.js";
-const WS_PORT = 31113;
-const CLONE_REQUEST_TYPE = "phibelle-kit-clone-request";
-const CLONE_RESPONSE_TYPE = "phibelle-kit-clone-response";
 const CLONE_TIMEOUT_MS = 30_000;
 const INITIAL_COMMIT_MESSAGE = "Initial scene clone from Phibelle";
 const execFileAsync = promisify(execFile);
@@ -26,7 +25,7 @@ export async function cloneSceneCommand() {
     await ensureDirectoryDoesNotExist(sceneDir);
     await fs.mkdir(sceneDir, { recursive: false });
     setupSceneDirectory(sceneDir);
-    await fs.writeFile(path.join(sceneDir, "scene.phibelle"), payload.sceneData, "utf8");
+    await fs.writeFile(path.join(sceneDir, SCENE_FILE_NAME), payload.sceneData, "utf8");
     await unpackageScene(payload.sceneData, sceneDir, payload.sceneId);
     await initializeGitRepository(sceneDir);
     console.log(chalk.green("  ✓ Scene cloned successfully"));
@@ -148,7 +147,7 @@ async function initializeGitRepository(sceneDir) {
     }
     catch (error) {
         console.log(chalk.yellow("  ! Git initialization or first commit was skipped"));
-        const details = getErrorText(error);
+        const details = getExecErrorText(error);
         if (details) {
             console.log(chalk.gray(`    ${details}`));
         }
@@ -158,12 +157,3 @@ async function initializeGitRepository(sceneDir) {
 async function runGit(args, cwd) {
     await execFileAsync("git", args, { cwd });
 }
-function getErrorText(error) {
-    if (!error || typeof error !== "object")
-        return "";
-    const err = error;
-    const stderr = err.stderr?.trim();
-    if (stderr)
-        return stderr.split("\n").pop() ?? stderr;
-    return err.message?.trim() ?? "";
-}

package/dist/commands/watch-scene.js

@@ -1,16 +1,14 @@
 import chalk from "chalk";
-import * as path from "path";
-import * as fs from "fs";
+import * as path from "node:path";
+import * as fs from "node:fs";
+import readline from "node:readline";
 import { WebSocketServer } from "ws";
+import { WS_PORT, SCENE_SYNC_TYPE, SCENE_FILE_NAME } from "../lib/constants.js";
+import { getRequiredManifestSceneId } from "../lib/manifest.js";
 import { unpackageScene, parseSceneJson, packageSceneFromFilesystem } from "../lib/scene/scene-packaging.js";
 import { createScriptWatcher } from "../lib/scene/script-watcher.js";
 import { toErrorMessage } from "../lib/utils.js";
-import readline from "readline";
 const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-const WS_PORT = 31113;
-const SCENE_SYNC_TYPE = "phibelle-kit-scene-sync";
-const SCENE_FILE_NAME = "scene.phibelle";
-const MANIFEST_FILE_NAME = "manifest.json";
 export const BASE_URL = process.env.NODE_ENV === "development" ? "http://localhost:3131" : "https://phibelle.studio";
 export async function watchSceneCommand() {
     const sceneDir = process.cwd();
@@ -186,27 +184,3 @@ function askQuestion(prompt) {
         rl.question(prompt, resolve);
     });
 }
-function getRequiredManifestSceneId(sceneDir) {
-    const manifestPath = path.join(sceneDir, MANIFEST_FILE_NAME);
-    if (!fs.existsSync(manifestPath)) {
-        throw new Error(`Missing ${MANIFEST_FILE_NAME} in ${sceneDir}. Run "phibelle-kit clone" first or watch from a cloned scene folder.`);
-    }
-    let manifestRaw;
-    try {
-        manifestRaw = fs.readFileSync(manifestPath, "utf8");
-    }
-    catch {
-        throw new Error(`Failed to read ${MANIFEST_FILE_NAME} in ${sceneDir}.`);
-    }
-    let manifest;
-    try {
-        manifest = JSON.parse(manifestRaw);
-    }
-    catch {
-        throw new Error(`Invalid ${MANIFEST_FILE_NAME}: expected valid JSON.`);
-    }
-    if (typeof manifest.sceneId !== "string" || !manifest.sceneId.trim()) {
-        throw new Error(`Invalid ${MANIFEST_FILE_NAME}: missing required "sceneId".`);
-    }
-    return manifest.sceneId.trim();
-}

package/dist/lib/constants.d.ts

@@ -0,0 +1,12 @@
+/** WebSocket port for phibelle-kit CLI ↔ web app communication. Must match app's use-cli-websocket.ts */
+export declare const WS_PORT = 31113;
+/** Scene JSON file in cloned scene directory */
+export declare const SCENE_FILE_NAME = "scene.phibelle";
+/** Manifest file mapping entity IDs to filesystem paths */
+export declare const MANIFEST_FILE_NAME = "manifest.json";
+/** Message type for scene sync over WebSocket */
+export declare const SCENE_SYNC_TYPE = "phibelle-kit-scene-sync";
+/** Message type for clone request from kit to app */
+export declare const CLONE_REQUEST_TYPE = "phibelle-kit-clone-request";
+/** Message type for clone response from app to kit */
+export declare const CLONE_RESPONSE_TYPE = "phibelle-kit-clone-response";

package/dist/lib/constants.js

@@ -0,0 +1,12 @@
+/** WebSocket port for phibelle-kit CLI ↔ web app communication. Must match app's use-cli-websocket.ts */
+export const WS_PORT = 31113;
+/** Scene JSON file in cloned scene directory */
+export const SCENE_FILE_NAME = "scene.phibelle";
+/** Manifest file mapping entity IDs to filesystem paths */
+export const MANIFEST_FILE_NAME = "manifest.json";
+/** Message type for scene sync over WebSocket */
+export const SCENE_SYNC_TYPE = "phibelle-kit-scene-sync";
+/** Message type for clone request from kit to app */
+export const CLONE_REQUEST_TYPE = "phibelle-kit-clone-request";
+/** Message type for clone response from app to kit */
+export const CLONE_RESPONSE_TYPE = "phibelle-kit-clone-response";

package/dist/lib/manifest.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Read manifest.json from sceneDir and return the required sceneId.
+ * Throws with user-facing errors if manifest is missing, unreadable, invalid JSON, or missing sceneId.
+ */
+export declare function getRequiredManifestSceneId(sceneDir: string): string;

package/dist/lib/manifest.js

@@ -0,0 +1,31 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { MANIFEST_FILE_NAME } from "./constants.js";
+/**
+ * Read manifest.json from sceneDir and return the required sceneId.
+ * Throws with user-facing errors if manifest is missing, unreadable, invalid JSON, or missing sceneId.
+ */
+export function getRequiredManifestSceneId(sceneDir) {
+    const manifestPath = path.join(sceneDir, MANIFEST_FILE_NAME);
+    if (!fs.existsSync(manifestPath)) {
+        throw new Error(`Missing ${MANIFEST_FILE_NAME} in ${sceneDir}. Run "phibelle-kit clone" first or watch from a cloned scene folder.`);
+    }
+    let manifestRaw;
+    try {
+        manifestRaw = fs.readFileSync(manifestPath, "utf8");
+    }
+    catch {
+        throw new Error(`Failed to read ${MANIFEST_FILE_NAME} in ${sceneDir}.`);
+    }
+    let manifest;
+    try {
+        manifest = JSON.parse(manifestRaw);
+    }
+    catch {
+        throw new Error(`Invalid ${MANIFEST_FILE_NAME}: expected valid JSON.`);
+    }
+    if (typeof manifest.sceneId !== "string" || !manifest.sceneId.trim()) {
+        throw new Error(`Invalid ${MANIFEST_FILE_NAME}: missing required "sceneId".`);
+    }
+    return manifest.sceneId.trim();
+}

package/dist/lib/scene/file-system.d.ts

@@ -1,5 +1,6 @@
+import { SCENE_FILE_NAME } from "../constants.js";
 export declare const SCENE_APP_DIR = "app";
-export declare const SCENE_FILE_NAME = "scene.phibelle";
+export { SCENE_FILE_NAME };
 export declare function getSceneAppDir(sceneDir: string): string;
 export declare function folderExists(folderPath: string): boolean;
 export declare function createFolder(folderPath: string): void;

package/dist/lib/scene/file-system.js

@@ -1,7 +1,8 @@
 import * as path from "node:path";
-import * as fs from "fs";
+import * as fs from "node:fs";
+import { SCENE_FILE_NAME } from "../constants.js";
 export const SCENE_APP_DIR = "app";
-export const SCENE_FILE_NAME = "scene.phibelle";
+export { SCENE_FILE_NAME };
 export function getSceneAppDir(sceneDir) {
     return path.join(sceneDir, SCENE_APP_DIR);
 }

package/dist/lib/scene/scene-packaging.js

@@ -1,7 +1,7 @@
-import * as fs from "fs/promises";
-import * as path from "path";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
 import { getSceneAppDir } from "./file-system.js";
-const MANIFEST_FILE_NAME = "manifest.json";
+import { MANIFEST_FILE_NAME } from "../constants.js";
 const LEGACY_SCENE_FILE = "scene.tsx";
 const CHILDREN_DIR_NAME = "children";
 /** Scene-level file names in app/. */

package/dist/lib/scene/script-watcher.js

@@ -1,5 +1,6 @@
-import * as path from "path";
+import * as path from "node:path";
 import chokidar from "chokidar";
+import { MANIFEST_FILE_NAME } from "../constants.js";
 import { getSceneAppDir } from "./file-system.js";
 import { packageSceneFromFilesystem, ENTITY_SCRIPT_FILE, ENTITY_PROPERTIES_FILE, ENTITY_TRANSFORMS_FILE, SCENE_SCRIPT_FILE, SCENE_PROPERTIES_FILE, } from "./scene-packaging.js";
 const DEBOUNCE_MS = 100;
@@ -48,7 +49,7 @@ export function createScriptWatcher(sceneDir, getLatestSceneJson, onSceneUpdated
     const watcher = chokidar.watch(appDir, { ignoreInitial: true });
     function handlePathEvent(filePath) {
         const relativePath = toRelativePath(filePath);
-        if (relativePath === "manifest.json")
+        if (relativePath === MANIFEST_FILE_NAME)
             return;
         if (isRelevantPath(relativePath))
             schedule(relativePath);

package/dist/lib/utils.d.ts

@@ -1 +1,3 @@
 export declare function toErrorMessage(err: unknown): string;
+/** For exec/child_process errors: prefer stderr (last line), otherwise message. */
+export declare function getExecErrorText(error: unknown): string;

package/dist/lib/utils.js

@@ -1,3 +1,13 @@
 export function toErrorMessage(err) {
     return err instanceof Error ? err.message : String(err);
 }
+/** For exec/child_process errors: prefer stderr (last line), otherwise message. */
+export function getExecErrorText(error) {
+    if (!error || typeof error !== "object")
+        return "";
+    const err = error;
+    const stderr = err.stderr?.trim();
+    if (stderr)
+        return stderr.split("\n").pop() ?? stderr;
+    return err.message?.trim() ?? "";
+}

package/dist/scene-setup/setup.d.ts

@@ -1,4 +1,3 @@
 export declare function setupSceneDirectory(sceneDir: string): {
     shouldPromptInstall: boolean;
 };
-export declare function getInstallHint(sceneDir: string): string;

package/dist/scene-setup/setup.js

@@ -39,18 +39,3 @@ export function setupSceneDirectory(sceneDir) {
     }
     return { shouldPromptInstall };
 }
-export function getInstallHint(sceneDir) {
-    const hasPnpm = fs.existsSync(path.join(sceneDir, "pnpm-lock.yaml"));
-    const hasYarn = fs.existsSync(path.join(sceneDir, "yarn.lock"));
-    const hasBun = fs.existsSync(path.join(sceneDir, "bun.lockb"));
-    const hasNpm = fs.existsSync(path.join(sceneDir, "package-lock.json"));
-    if (hasPnpm)
-        return "pnpm install";
-    if (hasBun)
-        return "bun install";
-    if (hasYarn)
-        return "yarn install";
-    if (hasNpm)
-        return "npm install";
-    return "npm install (or pnpm / bun / yarn install)";
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phibelle-kit",
-  "version": "1.0.31",
+  "version": "1.0.32",
   "description": "CLI tool for interacting with the Phibelle engine",
   "type": "module",
   "bin": {