@playcademy/sandbox 0.1.1 → 0.1.2

package/dist/cli.js

@@ -83909,7 +83909,7 @@ var logger = (fn = console.log) => {
 // package.json
 var package_default = {
   name: "@playcademy/sandbox",
-  version: "0.1.0",
+  version: "0.1.1",
   description: "Local development server for Playcademy game development",
   type: "module",
   exports: {
@@ -117798,7 +117798,10 @@ class CloudflareProvider {
         namespace: this.config.dispatchNamespace
       });
       if (deleteBindings) {
-        await this.deleteD1DatabaseIfExists(deploymentId);
+        await Promise.all([
+          this.deleteD1DatabaseIfExists(deploymentId),
+          this.deleteKVNamespaceIfExists(deploymentId)
+        ]);
       }
     } catch (error2) {
       log2.error("[CloudflareProvider] Deletion from dispatch namespace failed", {
@@ -117849,7 +117852,12 @@ class CloudflareProvider {
       }
     }
     for (const kvName of resourceBindings.kv) {
-      log2.warn("[CloudflareProvider] KV namespace binding not yet implemented", { kvName });
+      const namespaceId = await this.ensureKVNamespace(kvName);
+      bindings.push({
+        type: "kv_namespace",
+        name: "KV",
+        namespace_id: namespaceId
+      });
     }
     for (const r2Name of resourceBindings.r2) {
       log2.warn("[CloudflareProvider] R2 bucket binding not yet implemented", { r2Name });
@@ -117961,6 +117969,73 @@ class CloudflareProvider {
       throw new Error(`Failed to execute schema: ${error2 instanceof Error ? error2.message : String(error2)}`);
     }
   }
+  async ensureKVNamespace(namespaceName) {
+    log2.debug("[CloudflareProvider] Ensuring KV namespace exists", { namespaceName });
+    try {
+      const namespaces = await this.client.kv.namespaces.list({
+        account_id: this.config.accountId
+      });
+      for await (const ns of namespaces) {
+        if (ns.title === namespaceName && ns.id) {
+          log2.info("[CloudflareProvider] KV namespace already exists", {
+            namespaceName,
+            namespaceId: ns.id
+          });
+          return ns.id;
+        }
+      }
+      log2.debug("[CloudflareProvider] Creating new KV namespace", { namespaceName });
+      const createResult = await this.client.kv.namespaces.create({
+        account_id: this.config.accountId,
+        title: namespaceName
+      });
+      if (!createResult.id) {
+        throw new Error("KV namespace creation succeeded but no ID returned");
+      }
+      log2.info("[CloudflareProvider] KV namespace created successfully", {
+        namespaceName,
+        namespaceId: createResult.id
+      });
+      return createResult.id;
+    } catch (error2) {
+      log2.error("[CloudflareProvider] Failed to ensure KV namespace", {
+        namespaceName,
+        error: error2
+      });
+      throw new Error(`Failed to ensure KV namespace: ${error2 instanceof Error ? error2.message : String(error2)}`);
+    }
+  }
+  async deleteKVNamespaceIfExists(namespaceName) {
+    try {
+      const namespaces = await this.client.kv.namespaces.list({
+        account_id: this.config.accountId
+      });
+      for await (const ns of namespaces) {
+        if (ns.title === namespaceName && ns.id) {
+          log2.debug("[CloudflareProvider] Deleting KV namespace", {
+            namespaceName,
+            namespaceId: ns.id
+          });
+          await this.client.kv.namespaces.delete(ns.id, {
+            account_id: this.config.accountId
+          });
+          log2.info("[CloudflareProvider] KV namespace deleted successfully", {
+            namespaceName,
+            namespaceId: ns.id
+          });
+          return;
+        }
+      }
+      log2.debug("[CloudflareProvider] KV namespace not found, nothing to delete", {
+        namespaceName
+      });
+    } catch (error2) {
+      log2.warn("[CloudflareProvider] Failed to delete KV namespace", {
+        namespaceName,
+        error: error2
+      });
+    }
+  }
 }
 // ../cloudflare/src/utils/hostname.ts
 var RESERVED_SUBDOMAINS = new Set([
@@ -129396,27 +129471,6 @@ async function startServer(port, project, options = {}) {
 }
 var version3 = package_default.version;
 
-// src/utils/port.ts
-import { createServer } from "node:net";
-async function findAvailablePort(startPort = 4321) {
-  return new Promise((resolve2, reject) => {
-    const server2 = createServer();
-    server2.listen(startPort, () => {
-      const address = server2.address();
-      const port = address && typeof address === "object" ? address.port : startPort;
-      server2.close(() => resolve2(port));
-    });
-    server2.on("error", () => {
-      findAvailablePort(startPort + 1).then(resolve2).catch(reject);
-    });
-  });
-}
-async function allocateSandboxPorts(preferred = 4321) {
-  const apiPort = await findAvailablePort(preferred);
-  const realtimePort = await findAvailablePort(apiPort + 1);
-  return { apiPort, realtimePort };
-}
-
 // node_modules/commander/esm.mjs
 var import__4 = __toESM(require_commander(), 1);
 var {
@@ -129435,6 +129489,92 @@ var {
 
 // src/cli.ts
 var import_picocolors = __toESM(require_picocolors(), 1);
+
+// ../utils/src/port.ts
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, writeFileSync } from "node:fs";
+import { createServer } from "node:net";
+import { homedir } from "node:os";
+import { join as join3 } from "node:path";
+async function isPortAvailableOnHost(port, host) {
+  return new Promise((resolve2) => {
+    const server2 = createServer();
+    server2.once("error", () => {
+      resolve2(false);
+    });
+    server2.once("listening", () => {
+      server2.close();
+      resolve2(true);
+    });
+    server2.listen(port, host);
+  });
+}
+async function findAvailablePort(startPort = 4321) {
+  const ipv4Available = await isPortAvailableOnHost(startPort, "127.0.0.1");
+  const ipv6Available = await isPortAvailableOnHost(startPort, "::1");
+  if (ipv4Available && ipv6Available) {
+    return startPort;
+  }
+  return findAvailablePort(startPort + 1);
+}
+function getRegistryPath() {
+  const home = homedir();
+  const dir = join3(home, ".playcademy");
+  if (!existsSync2(dir)) {
+    mkdirSync2(dir, { recursive: true });
+  }
+  return join3(dir, ".proc");
+}
+function readRegistry() {
+  const registryPath = getRegistryPath();
+  if (!existsSync2(registryPath)) {
+    return {};
+  }
+  try {
+    const content = readFileSync(registryPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return {};
+  }
+}
+function writeRegistry(registry2) {
+  const registryPath = getRegistryPath();
+  writeFileSync(registryPath, JSON.stringify(registry2, null, 2), "utf-8");
+}
+function getServerKey(type, port) {
+  return `${type}-${port}`;
+}
+function writeServerInfo(type, info2) {
+  const registry2 = readRegistry();
+  const key = getServerKey(type, info2.port);
+  registry2[key] = info2;
+  writeRegistry(registry2);
+}
+function cleanupServerInfo(type, projectRoot, pid) {
+  const registry2 = readRegistry();
+  const keysToRemove = [];
+  for (const [key, info2] of Object.entries(registry2)) {
+    if (key.startsWith(`${type}-`)) {
+      let matches = true;
+      if (projectRoot && info2.projectRoot !== projectRoot) {
+        matches = false;
+      }
+      if (pid !== undefined && info2.pid !== pid) {
+        matches = false;
+      }
+      if (matches) {
+        keysToRemove.push(key);
+      }
+    }
+  }
+  for (const key of keysToRemove) {
+    delete registry2[key];
+  }
+  if (keysToRemove.length > 0) {
+    writeRegistry(registry2);
+  }
+}
+
+// src/cli.ts
 var program2 = new Command;
 program2.name("playcademy-sandbox").description("Local development server for Playcademy game development").version("0.1.0").option("-p, --port <number>", "Port to run the server on", "4321").option("-v, --verbose", "Enable verbose logging", false).option("--project-name <name>", "Name of the current project").option("--project-slug <slug>", "Slug of the current project").option("--realtime", "Enable the realtime server", false).option("--realtime-port <number>", "Port for the realtime server (defaults to main port + 1)").option("--no-seed", "Do not seed the database with demo data").option("--timeback-local", "Use local TimeBack instance").option("--timeback-oneroster-url <url>", "TimeBack OneRoster API URL").option("--timeback-caliper-url <url>", "TimeBack Caliper API URL").option("--timeback-course-id <id>", "TimeBack course ID for seeding").option("--timeback-student-id <id>", "TimeBack student ID for demo user").action(async (options) => {
   try {
@@ -129468,6 +129608,13 @@ program2.name("playcademy-sandbox").description("Local development server for Pl
       },
       timeback: timebackOptions
     });
+    writeServerInfo("sandbox", {
+      pid: process.pid,
+      port: availablePort,
+      url: `http://localhost:${availablePort}/api`,
+      startedAt: Date.now(),
+      projectRoot: process.cwd()
+    });
     console.log("");
     console.log(`  ${import_picocolors.default.green(import_picocolors.default.bold("PLAYCADEMY"))} ${import_picocolors.default.green(`v${version3}`)}`);
     console.log("");
@@ -129483,10 +129630,13 @@ program2.name("playcademy-sandbox").description("Local development server for Pl
     console.log("");
     console.log(`  ${import_picocolors.default.dim("Press")} ${import_picocolors.default.bold("Ctrl+C")} ${import_picocolors.default.dim("to stop the server")}`);
     console.log("");
-    process.on("SIGINT", () => {
+    const cleanup = () => {
+      cleanupServerInfo("sandbox", process.cwd(), process.pid);
       servers.stop();
       process.exit(0);
-    });
+    };
+    process.on("SIGINT", cleanup);
+    process.on("SIGTERM", cleanup);
   } catch (error2) {
     console.error(import_picocolors.default.red(`❌ Failed to start sandbox: ${error2}`));
     process.exit(1);

package/dist/server.js

@@ -81999,7 +81999,7 @@ var logger = (fn = console.log) => {
 // package.json
 var package_default = {
   name: "@playcademy/sandbox",
-  version: "0.1.0",
+  version: "0.1.1",
   description: "Local development server for Playcademy game development",
   type: "module",
   exports: {
@@ -115888,7 +115888,10 @@ class CloudflareProvider {
         namespace: this.config.dispatchNamespace
       });
       if (deleteBindings) {
-        await this.deleteD1DatabaseIfExists(deploymentId);
+        await Promise.all([
+          this.deleteD1DatabaseIfExists(deploymentId),
+          this.deleteKVNamespaceIfExists(deploymentId)
+        ]);
       }
     } catch (error2) {
       log2.error("[CloudflareProvider] Deletion from dispatch namespace failed", {
@@ -115939,7 +115942,12 @@ class CloudflareProvider {
       }
     }
     for (const kvName of resourceBindings.kv) {
-      log2.warn("[CloudflareProvider] KV namespace binding not yet implemented", { kvName });
+      const namespaceId = await this.ensureKVNamespace(kvName);
+      bindings.push({
+        type: "kv_namespace",
+        name: "KV",
+        namespace_id: namespaceId
+      });
     }
     for (const r2Name of resourceBindings.r2) {
       log2.warn("[CloudflareProvider] R2 bucket binding not yet implemented", { r2Name });
@@ -116051,6 +116059,73 @@ class CloudflareProvider {
       throw new Error(`Failed to execute schema: ${error2 instanceof Error ? error2.message : String(error2)}`);
     }
   }
+  async ensureKVNamespace(namespaceName) {
+    log2.debug("[CloudflareProvider] Ensuring KV namespace exists", { namespaceName });
+    try {
+      const namespaces = await this.client.kv.namespaces.list({
+        account_id: this.config.accountId
+      });
+      for await (const ns of namespaces) {
+        if (ns.title === namespaceName && ns.id) {
+          log2.info("[CloudflareProvider] KV namespace already exists", {
+            namespaceName,
+            namespaceId: ns.id
+          });
+          return ns.id;
+        }
+      }
+      log2.debug("[CloudflareProvider] Creating new KV namespace", { namespaceName });
+      const createResult = await this.client.kv.namespaces.create({
+        account_id: this.config.accountId,
+        title: namespaceName
+      });
+      if (!createResult.id) {
+        throw new Error("KV namespace creation succeeded but no ID returned");
+      }
+      log2.info("[CloudflareProvider] KV namespace created successfully", {
+        namespaceName,
+        namespaceId: createResult.id
+      });
+      return createResult.id;
+    } catch (error2) {
+      log2.error("[CloudflareProvider] Failed to ensure KV namespace", {
+        namespaceName,
+        error: error2
+      });
+      throw new Error(`Failed to ensure KV namespace: ${error2 instanceof Error ? error2.message : String(error2)}`);
+    }
+  }
+  async deleteKVNamespaceIfExists(namespaceName) {
+    try {
+      const namespaces = await this.client.kv.namespaces.list({
+        account_id: this.config.accountId
+      });
+      for await (const ns of namespaces) {
+        if (ns.title === namespaceName && ns.id) {
+          log2.debug("[CloudflareProvider] Deleting KV namespace", {
+            namespaceName,
+            namespaceId: ns.id
+          });
+          await this.client.kv.namespaces.delete(ns.id, {
+            account_id: this.config.accountId
+          });
+          log2.info("[CloudflareProvider] KV namespace deleted successfully", {
+            namespaceName,
+            namespaceId: ns.id
+          });
+          return;
+        }
+      }
+      log2.debug("[CloudflareProvider] KV namespace not found, nothing to delete", {
+        namespaceName
+      });
+    } catch (error2) {
+      log2.warn("[CloudflareProvider] Failed to delete KV namespace", {
+        namespaceName,
+        error: error2
+      });
+    }
+  }
 }
 // ../cloudflare/src/utils/hostname.ts
 var RESERVED_SUBDOMAINS = new Set([

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sandbox",
-    "version": "0.1.1",
+    "version": "0.1.2",
     "description": "Local development server for Playcademy game development",
     "type": "module",
     "exports": {

package/dist/utils/port.d.ts

@@ -1,18 +0,0 @@
-export declare function findAvailablePort(startPort?: number): Promise<number>;
-/**
- * Allocate a pair of ports for the sandbox: one for the main HTTP API server
- * and one for the realtime WebSocket server.
- *
- * • We first look for an available port starting from `preferred` (defaults to
- *   4321). That becomes the API port.
- * • We then look for the next available port **after** the chosen API port for
- *   the realtime server. This guarantees the two ports are distinct and
- *   stable for the lifetime of the sandbox.
- *
- * The helper centralises the port-allocation logic so that the sandbox CLI,
- * integration-test harness and Vite plugin all follow the exact same rules.
- */
-export declare function allocateSandboxPorts(preferred?: number): Promise<{
-    apiPort: number;
-    realtimePort: number;
-}>;

package/dist/utils/port.js

@@ -1,54 +0,0 @@
-import { createRequire } from "node:module";
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
-var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
-// src/utils/port.ts
-import { createServer } from "node:net";
-async function findAvailablePort(startPort = 4321) {
-  return new Promise((resolve, reject) => {
-    const server = createServer();
-    server.listen(startPort, () => {
-      const address = server.address();
-      const port = address && typeof address === "object" ? address.port : startPort;
-      server.close(() => resolve(port));
-    });
-    server.on("error", () => {
-      findAvailablePort(startPort + 1).then(resolve).catch(reject);
-    });
-  });
-}
-async function allocateSandboxPorts(preferred = 4321) {
-  const apiPort = await findAvailablePort(preferred);
-  const realtimePort = await findAvailablePort(apiPort + 1);
-  return { apiPort, realtimePort };
-}
-export {
-  findAvailablePort,
-  allocateSandboxPorts
-};