playcademy 0.12.9 → 0.13.0

package/dist/index.js

@@ -2118,15 +2118,19 @@ var init_http_server = __esm({
 });
 
 // src/constants/paths.ts
-var CLI_DIRECTORIES, CLI_USER_DIRECTORIES, CLI_DEFAULT_OUTPUTS, CLI_FILES;
+import { join as join2 } from "path";
+var WORKSPACE_NAME, CLI_DIRECTORIES, CLI_USER_DIRECTORIES, CLI_DEFAULT_OUTPUTS, CLI_FILES;
 var init_paths = __esm({
   "src/constants/paths.ts"() {
     "use strict";
+    WORKSPACE_NAME = ".playcademy";
     CLI_DIRECTORIES = {
       /** Root directory for CLI artifacts in workspace */
-      WORKSPACE: ".playcademy",
+      WORKSPACE: WORKSPACE_NAME,
       /** Database directory within workspace */
-      DATABASE: ".playcademy/db"
+      DATABASE: join2(WORKSPACE_NAME, "db"),
+      /** KV storage directory within workspace */
+      KV: join2(WORKSPACE_NAME, "kv")
     };
     CLI_USER_DIRECTORIES = {
       /** User config directory for auth, games store, etc. */
@@ -2423,12 +2427,12 @@ var init_config = __esm({
 // src/lib/auth/storage.ts
 import { access, mkdir, readFile as readFile2, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
-import { join as join2 } from "node:path";
+import { join as join3 } from "node:path";
 function getAuthPath() {
-  return join2(homedir(), CLI_USER_DIRECTORIES.CONFIG, CLI_FILES.AUTH_STORE);
+  return join3(homedir(), CLI_USER_DIRECTORIES.CONFIG, CLI_FILES.AUTH_STORE);
 }
 async function ensureAuthDir() {
-  const authDir = join2(homedir(), CLI_USER_DIRECTORIES.CONFIG);
+  const authDir = join3(homedir(), CLI_USER_DIRECTORIES.CONFIG);
   await mkdir(authDir, { recursive: true });
 }
 function createEmptyEnvironmentProfiles() {
@@ -2584,7 +2588,7 @@ async function findConfigPath(configPath) {
     throw new ConfigError(
       "No Playcademy config file found in this directory or any parent directory",
       void 0,
-      `Create one of: ${CONFIG_FILE_NAMES.join(", ")} or set PLAYCADEMY_CONFIG_PATH environment variable`
+      `Run 'playcademy init' to create a config file, or manually create one of: ${CONFIG_FILE_NAMES.join(", ")}`
     );
   }
   return result.path;
@@ -3137,7 +3141,7 @@ function loadTemplate(filename) {
   return loadTemplateString(`config/${filename}`);
 }
 function generateJsConfig(options) {
-  const { name, description, emoji, customRoutesDirectory, databaseDirectory, timeback } = options;
+  const { name, description, emoji, customRoutesDirectory, databaseDirectory, kv, timeback } = options;
   let template = loadTemplate("playcademy.config.js.template");
   template = template.replace("{{GAME_NAME}}", name);
   const descriptionLine = description ? `
@@ -3153,6 +3157,9 @@ function generateJsConfig(options) {
   if (databaseDirectory) {
     integrationsParts.push(`        database: { directory: '${databaseDirectory}' }`);
   }
+  if (kv) {
+    integrationsParts.push(`        kv: true`);
+  }
   if (timeback) {
     let timebackTemplate = loadTemplate("timeback-config.js.template");
     timebackTemplate = timebackTemplate.replace(
@@ -3179,7 +3186,7 @@ function generateJsConfig(options) {
   return template;
 }
 function generateJsonConfig(options) {
-  const { name, description, emoji, customRoutesDirectory, databaseDirectory, timeback } = options;
+  const { name, description, emoji, customRoutesDirectory, databaseDirectory, kv, timeback } = options;
   let template = loadTemplate("playcademy.config.json.template");
   template = template.replace("{{GAME_NAME}}", name);
   const descriptionLine = description ? `,
@@ -3195,6 +3202,9 @@ function generateJsonConfig(options) {
   if (databaseDirectory) {
     integrationsConfig.database = { directory: databaseDirectory };
   }
+  if (kv) {
+    integrationsConfig.kv = true;
+  }
   if (timeback) {
     const courseConfig = {
       subjects: timeback.subjects,
@@ -3613,12 +3623,12 @@ var init_errors = __esm({
 // src/lib/core/import.ts
 import { mkdtempSync, rmSync } from "fs";
 import { tmpdir } from "os";
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 import { pathToFileURL } from "url";
 import * as esbuild from "esbuild";
 async function importTypescriptFile(filePath, bundleOptions) {
-  const tempDir = mkdtempSync(join3(tmpdir(), "playcademy-import-"));
-  const outFile = join3(tempDir, "bundle.mjs");
+  const tempDir = mkdtempSync(join4(tmpdir(), "playcademy-import-"));
+  const outFile = join4(tempDir, "bundle.mjs");
   try {
     await esbuild.build({
       entryPoints: [filePath],
@@ -4519,7 +4529,7 @@ init_core();
 // src/lib/db/path.ts
 init_constants2();
 import { copyFileSync, existsSync as existsSync5, mkdirSync, readdirSync as readdirSync2, unlinkSync } from "fs";
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 import Database from "better-sqlite3";
 var DB_DIRECTORY = CLI_DIRECTORIES.DATABASE;
 var INITIAL_DB_NAME = CLI_FILES.INITIAL_DATABASE;
@@ -4533,11 +4543,11 @@ var createEmptyDatabase = (path2) => {
   db.close();
 };
 var findMiniflareDatabase = (dbDir) => {
-  const miniflareDir = join4(dbDir, "miniflare-D1DatabaseObject");
+  const miniflareDir = join5(dbDir, "miniflare-D1DatabaseObject");
   if (!existsSync5(miniflareDir)) return null;
   const sqliteFiles = readdirSync2(miniflareDir).filter((file) => file.endsWith(".sqlite"));
   if (sqliteFiles.length === 0) return null;
-  return join4(miniflareDir, sqliteFiles[0]);
+  return join5(miniflareDir, sqliteFiles[0]);
 };
 var migrateInitialDbToTarget = (initialPath, targetPath) => {
   if (!existsSync5(initialPath)) return;
@@ -4545,7 +4555,7 @@ var migrateInitialDbToTarget = (initialPath, targetPath) => {
   unlinkSync(initialPath);
 };
 function getDevDbPath() {
-  const initialDbPath = join4(DB_DIRECTORY, INITIAL_DB_NAME);
+  const initialDbPath = join5(DB_DIRECTORY, INITIAL_DB_NAME);
   ensureDirectoryExists(DB_DIRECTORY);
   const miniflareDbPath = findMiniflareDatabase(DB_DIRECTORY);
   if (miniflareDbPath) {
@@ -4605,17 +4615,16 @@ init_src();
 init_constants2();
 init_core();
 import { existsSync as existsSync10 } from "node:fs";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 
 // src/lib/init/database.ts
 init_log();
 init_slug();
-init_constants2();
 init_core();
 init_logger();
 init_loader2();
 import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 var drizzleConfigTemplate = loadTemplateString("database/drizzle-config.ts");
 var dbSchemaUsersTemplate = loadTemplateString("database/db-schema-users.ts");
 var dbSchemaScoresTemplate = loadTemplateString("database/db-schema-scores.ts");
@@ -4623,13 +4632,12 @@ var dbSchemaIndexTemplate = loadTemplateString("database/db-schema-index.ts");
 var dbIndexTemplate = loadTemplateString("database/db-index.ts");
 var dbTypesTemplate = loadTemplateString("database/db-types.ts");
 var packageTemplate = loadTemplateString("database/package.json");
-var playcademyGitignoreTemplate = loadTemplateString("playcademy-gitignore");
 var rootGitignoreTemplate = loadTemplateString("gitignore");
 function normalizeGitignoreEntry(entry) {
   return entry.replace(/^\/+/, "").replace(/\/+$/, "");
 }
 function ensureGitignoreEntries(workspace) {
-  const gitignorePath = join5(workspace, ".gitignore");
+  const gitignorePath = join6(workspace, ".gitignore");
   if (!existsSync6(gitignorePath)) {
     writeFileSync2(gitignorePath, rootGitignoreTemplate);
     return;
@@ -4659,32 +4667,26 @@ async function scaffoldDatabaseSetup(options) {
   await runStep(
     "Configuring database...",
     async () => {
-      const dbDir = join5(workspace, "db");
-      const schemaDir = join5(dbDir, "schema");
+      const dbDir = join6(workspace, "db");
+      const schemaDir = join6(dbDir, "schema");
       if (!existsSync6(dbDir)) {
         mkdirSync2(dbDir, { recursive: true });
       }
       if (!existsSync6(schemaDir)) {
         mkdirSync2(schemaDir, { recursive: true });
       }
-      const usersSchemaPath = join5(schemaDir, "users.ts");
+      const usersSchemaPath = join6(schemaDir, "users.ts");
       writeFileSync2(usersSchemaPath, dbSchemaUsersTemplate);
-      const scoresSchemaPath = join5(schemaDir, "scores.ts");
+      const scoresSchemaPath = join6(schemaDir, "scores.ts");
       writeFileSync2(scoresSchemaPath, dbSchemaScoresTemplate);
-      const schemaIndexPath = join5(schemaDir, "index.ts");
+      const schemaIndexPath = join6(schemaDir, "index.ts");
       writeFileSync2(schemaIndexPath, dbSchemaIndexTemplate);
-      const dbIndexPath = join5(dbDir, "index.ts");
+      const dbIndexPath = join6(dbDir, "index.ts");
       writeFileSync2(dbIndexPath, dbIndexTemplate);
-      const dbTypesPath = join5(dbDir, "types.ts");
+      const dbTypesPath = join6(dbDir, "types.ts");
       writeFileSync2(dbTypesPath, dbTypesTemplate);
-      const drizzleConfigPath = join5(workspace, "drizzle.config.ts");
+      const drizzleConfigPath = join6(workspace, "drizzle.config.ts");
       writeFileSync2(drizzleConfigPath, drizzleConfigTemplate);
-      const playcademyDir = join5(workspace, CLI_DIRECTORIES.WORKSPACE);
-      if (!existsSync6(playcademyDir)) {
-        mkdirSync2(playcademyDir, { recursive: true });
-      }
-      const playcademyGitignorePath = join5(playcademyDir, ".gitignore");
-      writeFileSync2(playcademyGitignorePath, playcademyGitignoreTemplate);
       ensureGitignoreEntries(workspace);
       packagesUpdated = await setupPackageJson(workspace, options.gameName);
     },
@@ -4693,7 +4695,7 @@ async function scaffoldDatabaseSetup(options) {
   return packagesUpdated;
 }
 async function setupPackageJson(workspace, gameName) {
-  const pkgPath = join5(workspace, "package.json");
+  const pkgPath = join6(workspace, "package.json");
   const dbDeps = {
     "drizzle-orm": "^0.42.0",
     "better-sqlite3": "^12.0.0"
@@ -4733,11 +4735,16 @@ async function setupPackageJson(workspace, gameName) {
 }
 function hasDatabaseSetup() {
   const workspace = getWorkspace();
-  const drizzleConfigPath = join5(workspace, "drizzle.config.ts");
-  const drizzleConfigJsPath = join5(workspace, "drizzle.config.js");
+  const drizzleConfigPath = join6(workspace, "drizzle.config.ts");
+  const drizzleConfigJsPath = join6(workspace, "drizzle.config.js");
   return existsSync6(drizzleConfigPath) || existsSync6(drizzleConfigJsPath);
 }
 
+// src/lib/init/kv.ts
+function hasKVSetup(config) {
+  return !!config.integrations?.kv;
+}
+
 // src/lib/integrations/timeback.ts
 init_src();
 init_core();
@@ -4868,7 +4875,7 @@ var integrationChangeDetectors = {
 
 // src/lib/deploy/bundle.ts
 import { existsSync as existsSync7 } from "fs";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 
 // ../edge-play/src/entry.ts
 var entry_default = "/**\n * Game Backend Entry Point\n *\n * This file is the main entry point for deployed game backends.\n * It creates a Hono app and registers all enabled integration routes.\n *\n * Bundled with esbuild and deployed to Cloudflare Workers (or AWS Lambda).\n * Config is injected at build time via esbuild's `define` option.\n */\n\nimport { Hono } from 'hono'\nimport { cors } from 'hono/cors'\n\nimport { PlaycademyClient } from '@playcademy/sdk/server'\n\nimport { ENV_VARS } from './constants'\nimport { registerBuiltinRoutes } from './register-routes'\n\nimport type { PlaycademyConfig } from '@playcademy/sdk/server'\nimport type { HonoEnv } from './types'\n\n/**\n * Config injected at build time by esbuild\n *\n * The `declare const` tells TypeScript \"this exists at runtime, trust me.\"\n * During bundling, esbuild's `define` option does literal text replacement:\n *\n * Example bundling:\n *   Source:  if (PLAYCADEMY_CONFIG.integrations.timeback) { ... }\n *   Define:  { 'PLAYCADEMY_CONFIG': JSON.stringify({ integrations: { timeback: {...} } }) }\n *   Output:  if ({\"integrations\":{\"timeback\":{...}}}.integrations.timeback) { ... }\n *\n * This enables tree-shaking: if timeback is not configured, those code paths are removed.\n * The bundled Worker only includes the routes that are actually enabled.\n */\ndeclare const PLAYCADEMY_CONFIG: PlaycademyConfig & {\n    customRoutes?: Array<{ path: string; file: string }>\n}\n\n// XXX: Polyfill process global for SDK compatibility\n// SDK code may reference process.env without importing it\n// @ts-expect-error - Adding global for Worker environment\nglobalThis.process = {\n    env: {}, // Populated per-request from Worker env bindings\n    cwd: () => '/',\n}\n\nconst app = new Hono<HonoEnv>()\n\n// TODO: Harden CORS in production - restrict to trusted origins:\n// - Game's assetBundleBase (for hosted games)\n// - Game's externalUrl (for external games)\n// - Platform frontend domains (hub.playcademy.com, hub.dev.playcademy.net)\n// This would require passing game metadata through env bindings during deployment\napp.use(\n    '*',\n    cors({\n        origin: '*', // Permissive for now\n        allowMethods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],\n        allowHeaders: ['Content-Type', 'Authorization'],\n    }),\n)\n\nlet sdkPromise: Promise<PlaycademyClient> | null = null\n\napp.use('*', async (c, next) => {\n    // Populate process.env from Worker bindings for SDK compatibility\n    globalThis.process.env = {\n        [ENV_VARS.PLAYCADEMY_API_KEY]: c.env.PLAYCADEMY_API_KEY,\n        [ENV_VARS.GAME_ID]: c.env.GAME_ID,\n        [ENV_VARS.PLAYCADEMY_BASE_URL]: c.env.PLAYCADEMY_BASE_URL,\n    }\n\n    // Set config for all routes\n    c.set('config', PLAYCADEMY_CONFIG)\n    c.set('customRoutes', PLAYCADEMY_CONFIG.customRoutes || [])\n\n    await next()\n})\n\n// Initialize SDK lazily on first request\napp.use('*', async (c, next) => {\n    if (!sdkPromise) {\n        sdkPromise = PlaycademyClient.init({\n            apiKey: c.env[ENV_VARS.PLAYCADEMY_API_KEY],\n            gameId: c.env[ENV_VARS.GAME_ID],\n            baseUrl: c.env[ENV_VARS.PLAYCADEMY_BASE_URL],\n            config: PLAYCADEMY_CONFIG,\n        })\n    }\n\n    c.set('sdk', await sdkPromise)\n    await next()\n})\n\n/**\n * Register built-in integration routes based on enabled integrations\n *\n * This function conditionally imports and registers routes like:\n * - POST /api/integrations/timeback/end-activity (if timeback enabled)\n * - GET /api/health (always included)\n *\n * Uses dynamic imports for tree-shaking: if an integration is not enabled,\n * its route code is completely removed from the bundle.\n */\nawait registerBuiltinRoutes(app, PLAYCADEMY_CONFIG.integrations)\n\nexport default app\n";
@@ -5131,7 +5138,7 @@ init_file_loader();
 init_core();
 import { mkdir as mkdir2, writeFile as writeFile2 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
-import { join as join6, relative } from "path";
+import { join as join7, relative } from "path";
 
 // src/lib/deploy/hash.ts
 init_file_loader();
@@ -5179,7 +5186,7 @@ async function discoverRoutes(apiDir) {
   const routes = await Promise.all(
     files.map(async (file) => {
       const routePath = filePathToRoutePath(file);
-      const absolutePath = join6(apiDir, file);
+      const absolutePath = join7(apiDir, file);
       const relativePath = relative(getWorkspace(), absolutePath);
       const methods = await detectExportedMethods(absolutePath);
       return {
@@ -5239,10 +5246,10 @@ async function transpileRoute(filePath) {
   if (!result.outputFiles?.[0]) {
     throw new Error("Transpilation failed: no output");
   }
-  const tempDir = join6(tmpdir2(), "playcademy-dev");
+  const tempDir = join7(tmpdir2(), "playcademy-dev");
   await mkdir2(tempDir, { recursive: true });
   const hash = hashContent(filePath).slice(0, 12);
-  const jsPath = join6(tempDir, `${hash}.mjs`);
+  const jsPath = join7(tempDir, `${hash}.mjs`);
   await writeFile2(jsPath, result.outputFiles[0].text);
   return jsPath;
 }
@@ -5270,7 +5277,7 @@ async function discoverCustomRoutes(config) {
   const workspace = getWorkspace();
   const customRoutesConfig = config.integrations?.customRoutes;
   const customRoutesDir = typeof customRoutesConfig === "object" && customRoutesConfig.directory || DEFAULT_API_ROUTES_DIRECTORY;
-  const customRoutes = await discoverRoutes(join7(workspace, customRoutesDir));
+  const customRoutes = await discoverRoutes(join8(workspace, customRoutesDir));
   const customRouteData = customRoutes.map((r) => ({
     path: r.path,
     file: r.file,
@@ -5282,15 +5289,15 @@ async function discoverCustomRoutes(config) {
 function resolveEmbeddedSourcePaths() {
   const workspace = getWorkspace();
   const distDir = new URL(".", import.meta.url).pathname;
-  const embeddedEdgeSrc = join7(distDir, "edge-play", "src");
+  const embeddedEdgeSrc = join8(distDir, "edge-play", "src");
   const isBuiltPackage = existsSync7(embeddedEdgeSrc);
   const monorepoRoot = getMonorepoRoot();
-  const monorepoEdgeSrc = join7(monorepoRoot, "packages/edge-play/src");
+  const monorepoEdgeSrc = join8(monorepoRoot, "packages/edge-play/src");
   const edgePlaySrc = isBuiltPackage ? embeddedEdgeSrc : monorepoEdgeSrc;
-  const cliPackageRoot = isBuiltPackage ? join7(distDir, "../../..") : join7(monorepoRoot, "packages/cli");
-  const cliNodeModules = isBuiltPackage ? join7(cliPackageRoot, "node_modules") : monorepoRoot;
-  const workspaceNodeModules = join7(workspace, "node_modules");
-  const constantsEntry = isBuiltPackage ? join7(embeddedEdgeSrc, "..", "..", "constants", "src", "index.ts") : join7(monorepoRoot, "packages", "constants", "src", "index.ts");
+  const cliPackageRoot = isBuiltPackage ? join8(distDir, "../../..") : join8(monorepoRoot, "packages/cli");
+  const cliNodeModules = isBuiltPackage ? join8(cliPackageRoot, "node_modules") : monorepoRoot;
+  const workspaceNodeModules = join8(workspace, "node_modules");
+  const constantsEntry = isBuiltPackage ? join8(embeddedEdgeSrc, "..", "..", "constants", "src", "index.ts") : join8(monorepoRoot, "packages", "constants", "src", "index.ts");
   return {
     isBuiltPackage,
     edgePlaySrc,
@@ -5350,16 +5357,16 @@ function createEsbuildConfig(entryCode, paths, bundleConfig, customRoutesDir, op
       // │ Example: import * as route from '@game-api/hello.ts'            │
       // │ Resolves to: /user-project/server/api/hello.ts                  │
       // └─────────────────────────────────────────────────────────────────┘
-      "@game-api": join7(workspace, customRoutesDir),
+      "@game-api": join8(workspace, customRoutesDir),
       // ┌─ Node.js polyfills for Cloudflare Workers ──────────────────────┐
       // │ Workers don't have fs, path, os, etc. Redirect to polyfills     │
       // │ that throw helpful errors if user code tries to use them.       │
       // └─────────────────────────────────────────────────────────────────┘
-      fs: join7(edgePlaySrc, "polyfills.js"),
-      "fs/promises": join7(edgePlaySrc, "polyfills.js"),
-      path: join7(edgePlaySrc, "polyfills.js"),
-      os: join7(edgePlaySrc, "polyfills.js"),
-      process: join7(edgePlaySrc, "polyfills.js")
+      fs: join8(edgePlaySrc, "polyfills.js"),
+      "fs/promises": join8(edgePlaySrc, "polyfills.js"),
+      path: join8(edgePlaySrc, "polyfills.js"),
+      os: join8(edgePlaySrc, "polyfills.js"),
+      process: join8(edgePlaySrc, "polyfills.js")
     },
     // ──── Build Plugins ────
     plugins: [textLoaderPlugin()],
@@ -5425,7 +5432,7 @@ function generateEntryCode(customRoutes, customRoutesDir) {
 init_core();
 import { existsSync as existsSync9 } from "fs";
 import { createRequire } from "module";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 
 // src/lib/init/prompts.ts
 init_constants3();
@@ -5435,20 +5442,29 @@ import { bold as bold3, cyan as cyan2 } from "colorette";
 
 // src/lib/init/scaffold.ts
 init_src();
+init_constants2();
 init_core();
 init_loader2();
 import { existsSync as existsSync8, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
-import { join as join8, resolve as resolve6 } from "path";
-var sampleRouteTemplate = loadTemplateString("api/sample-route.ts");
-var sampleRouteWithDbTemplate = loadTemplateString("api/sample-route-with-db.ts");
-async function scaffoldApiDirectory(apiDirectory, sampleRouteTemplate2) {
+import { join as join9, resolve as resolve6 } from "path";
+var sampleCustomRouteTemplate = loadTemplateString("api/sample-custom.ts");
+var sampleDatabaseRouteTemplate = loadTemplateString("api/sample-database.ts");
+var sampleKvRouteTemplate = loadTemplateString("api/sample-kv.ts");
+var playcademyGitignoreTemplate = loadTemplateString("playcademy-gitignore");
+async function scaffoldApiDirectory(apiDirectory, sampleRoutes) {
   const apiPath = resolve6(getWorkspace(), apiDirectory);
+  const samplePath = join9(apiPath, "sample");
   await runStep(
     "Scaffolding API directory",
     async () => {
       if (!existsSync8(apiPath)) {
         mkdirSync3(apiPath, { recursive: true });
-        writeFileSync3(join8(apiPath, "hello.ts"), sampleRouteTemplate2, "utf-8");
+      }
+      if (!existsSync8(samplePath)) {
+        mkdirSync3(samplePath, { recursive: true });
+      }
+      for (const route of sampleRoutes) {
+        writeFileSync3(join9(samplePath, route.filename), route.template, "utf-8");
       }
     },
     "API directory scaffolded"
@@ -5461,10 +5477,29 @@ function validateApiDirectoryDoesNotExist(value) {
   }
   return true;
 }
-async function scaffoldIntegrations(customRoutes, database, gameName) {
+function ensurePlaycademyGitignore() {
+  const workspace = getWorkspace();
+  const playcademyDir = join9(workspace, CLI_DIRECTORIES.WORKSPACE);
+  if (!existsSync8(playcademyDir)) {
+    mkdirSync3(playcademyDir, { recursive: true });
+  }
+  const gitignorePath = join9(playcademyDir, ".gitignore");
+  writeFileSync3(gitignorePath, playcademyGitignoreTemplate);
+}
+async function scaffoldIntegrations(customRoutes, database, kv, gameName) {
+  ensurePlaycademyGitignore();
   if (customRoutes) {
-    const template = database ? sampleRouteWithDbTemplate : sampleRouteTemplate;
-    await scaffoldApiDirectory(customRoutes.directory, template);
+    const sampleRoutes = [
+      // Always include basic custom route example
+      { filename: "custom.ts", template: sampleCustomRouteTemplate }
+    ];
+    if (database) {
+      sampleRoutes.push({ filename: "database.ts", template: sampleDatabaseRouteTemplate });
+    }
+    if (kv) {
+      sampleRoutes.push({ filename: "kv.ts", template: sampleKvRouteTemplate });
+    }
+    await scaffoldApiDirectory(customRoutes.directory, sampleRoutes);
   }
   if (database) {
     return await scaffoldDatabaseSetup({ gameName });
@@ -5568,6 +5603,13 @@ async function promptForDatabase() {
   });
   return { directory };
 }
+async function promptForKV() {
+  const wantsKV = await confirm({
+    message: "KV storage?",
+    default: false
+  });
+  return wantsKV;
+}
 async function promptForCustomRoutes(requiresRoutes = false) {
   let wantsCustomRoutes = requiresRoutes;
   if (!requiresRoutes) {
@@ -5594,10 +5636,12 @@ async function promptForCustomRoutes(requiresRoutes = false) {
 async function promptForIntegrations() {
   const timeback = await promptForTimeBackIntegration();
   const database = await promptForDatabase();
-  const customRoutes = await promptForCustomRoutes(!!database);
+  const kv = await promptForKV();
+  const customRoutes = await promptForCustomRoutes(!!database || kv);
   return {
     timeback,
     database,
+    kv,
     customRoutes
   };
 }
@@ -5675,19 +5719,26 @@ function displaySuccessMessage(context2) {
 }
 
 // src/lib/deploy/schema.ts
+function getDrizzleKitApiExports() {
+  const require2 = createRequire(import.meta.url);
+  const drizzleKitApi = require2("drizzle-kit/api");
+  const { generateSQLiteDrizzleJson, generateSQLiteMigration } = drizzleKitApi;
+  return {
+    generateSQLiteDrizzleJson,
+    generateSQLiteMigration
+  };
+}
 async function getSchemaInfo(previousSchemaSnapshot) {
   const workspace = getWorkspace();
   if (!hasDatabaseSetup()) {
     return null;
   }
-  const schemaPath = join9(workspace, "db/schema/index.ts");
+  const schemaPath = join10(workspace, "db/schema/index.ts");
   if (!existsSync9(schemaPath)) {
     return null;
   }
   try {
-    const require2 = createRequire(import.meta.url);
-    const drizzleKitApi = require2("drizzle-kit/api");
-    const { generateSQLiteDrizzleJson, generateSQLiteMigration } = drizzleKitApi;
+    const { generateSQLiteDrizzleJson, generateSQLiteMigration } = getDrizzleKitApiExports();
     const currentSchema = await importTypescriptDefault(schemaPath);
     const nextJson = await generateSQLiteDrizzleJson(currentSchema);
     const prevJson = previousSchemaSnapshot ? previousSchemaSnapshot : await generateSQLiteDrizzleJson({});
@@ -5730,7 +5781,7 @@ var CUSTOM_ROUTES_EXTENSIONS_WITH_DOT = [".ts", ".js", ".mjs", ".cjs"];
 function getCustomRoutesDirectory(projectPath, config) {
   const customRoutes = config?.integrations?.customRoutes;
   const customRoutesDir = typeof customRoutes === "object" && customRoutes.directory || DEFAULT_API_ROUTES_DIRECTORY;
-  return join10(projectPath, customRoutesDir);
+  return join11(projectPath, customRoutesDir);
 }
 function hasLocalCustomRoutes(projectPath, config) {
   const customRoutesDir = getCustomRoutesDirectory(projectPath, config);
@@ -5742,7 +5793,7 @@ async function getCustomRoutesHash(projectPath, config) {
 }
 async function getCustomRoutesSize(projectPath, config) {
   const { stat: stat3, readdir } = await import("node:fs/promises");
-  const { join: join20 } = await import("node:path");
+  const { join: join29 } = await import("node:path");
   const customRoutesDir = getCustomRoutesDirectory(projectPath, config);
   if (!existsSync10(customRoutesDir)) {
     return null;
@@ -5751,7 +5802,7 @@ async function getCustomRoutesSize(projectPath, config) {
   async function calculateDirSize(dir) {
     const entries = await readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = join20(dir, entry.name);
+      const fullPath = join29(dir, entry.name);
       if (entry.isDirectory()) {
         await calculateDirSize(fullPath);
       } else if (entry.isFile()) {
@@ -5787,16 +5838,22 @@ async function getBackendSize(config) {
     return null;
   }
 }
-function getBackendBindings(slug) {
+function getBackendBindings(config, slug) {
   const deploymentId = getDeploymentId(slug);
   const bindings = {};
   if (hasDatabaseSetup()) {
     bindings.database = [deploymentId];
   }
+  if (hasKVSetup(config)) {
+    bindings.keyValue = [deploymentId];
+  }
   return Object.keys(bindings).length > 0 ? bindings : void 0;
 }
 async function deployGameBackend(client, slug, config, projectPath, previousCustomRoutesHash, fullConfig, forceBackend, previousIntegrationKeys, previousSchemaSnapshot, debug) {
   try {
+    if (fullConfig === void 0 || fullConfig === null) {
+      return null;
+    }
     const hasCustomRoutes2 = hasLocalCustomRoutes(projectPath, fullConfig);
     const currentIntegrationKeys = getIntegrationKeys(fullConfig?.integrations);
     const hasIntegrations = currentIntegrationKeys.length > 0;
@@ -5819,10 +5876,10 @@ async function deployGameBackend(client, slug, config, projectPath, previousCust
     }
     const bundle = await runStep(
       "Bundling backend",
-      async () => bundleBackend(fullConfig || config),
+      async () => bundleBackend(fullConfig),
       "Backend bundled"
     );
-    const bindings = getBackendBindings(slug);
+    const bindings = getBackendBindings(fullConfig, slug);
     const schemaInfo = await getSchemaInfo(previousSchemaSnapshot);
     if (debug && schemaInfo) {
       logger.newLine();
@@ -6121,10 +6178,10 @@ import { dim as dim4 } from "colorette";
 init_file_loader();
 init_constants2();
 init_core();
-import { join as join11, relative as relative2 } from "path";
+import { join as join12, relative as relative2 } from "path";
 function findSingleBuildZip() {
   const workspace = getWorkspace();
-  const playcademyDir = join11(workspace, CLI_DIRECTORIES.WORKSPACE);
+  const playcademyDir = join12(workspace, CLI_DIRECTORIES.WORKSPACE);
   const zipFiles = findFilesByExtension(playcademyDir, "zip");
   if (zipFiles.length === 1) {
     return zipFiles[0] ? relative2(workspace, zipFiles[0]) : null;
@@ -6303,6 +6360,18 @@ async function promptForMissingConfig(context2) {
       if (hasDatabase) {
         parts.push("Database");
       }
+      if (context2.fullConfig?.integrations?.kv) {
+        parts.push("KV Storage");
+      }
+      if (hasIntegrations && context2.fullConfig?.integrations) {
+        const integrationNames = getUserFacingIntegrationNames(
+          context2.fullConfig.integrations
+        );
+        const otherIntegrations = integrationNames.filter(
+          (name) => name.toLowerCase() !== "kv"
+        );
+        parts.push(...otherIntegrations);
+      }
       if (hasCustomRoutes2) {
         const customRoutesDir = getCustomRoutesDirectory(
           context2.projectPath,
@@ -6310,17 +6379,11 @@ async function promptForMissingConfig(context2) {
         );
         const routes = await discoverRoutes(customRoutesDir);
         if (routes.length > 0) {
-          parts.push(`${routes.length} custom ${pluralize(routes.length, "route")}`);
+          parts.push(`Custom Routes (${routes.length})`);
         }
       }
-      if (hasIntegrations && context2.fullConfig?.integrations) {
-        const integrationNames = getUserFacingIntegrationNames(
-          context2.fullConfig.integrations
-        );
-        parts.push(...integrationNames);
-      }
       if (parts.length > 0) {
-        logger.success(`Integrations: ${parts.join(" + ")}`);
+        logger.success(`Integrations: ${parts.join(", ")}`);
       }
     }
   } else if (config.gameType === "external" && context2.deployBackend !== false) {
@@ -6960,12 +7023,12 @@ init_constants2();
 import { existsSync as existsSync12 } from "node:fs";
 import { mkdir as mkdir3, readFile as readFile3, writeFile as writeFile3 } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 function getGamesStorePath() {
-  return join12(homedir2(), CLI_USER_DIRECTORIES.CONFIG, CLI_FILES.GAMES_STORE);
+  return join13(homedir2(), CLI_USER_DIRECTORIES.CONFIG, CLI_FILES.GAMES_STORE);
 }
 async function ensureConfigDir() {
-  const configDir = join12(homedir2(), CLI_USER_DIRECTORIES.CONFIG);
+  const configDir = join13(homedir2(), CLI_USER_DIRECTORIES.CONFIG);
   await mkdir3(configDir, { recursive: true });
 }
 async function loadGameStore() {
@@ -7456,12 +7519,12 @@ async function saveDeploymentState(game, backendDeployment, context2) {
 init_constants2();
 init_core();
 import { existsSync as existsSync14 } from "fs";
-import { join as join13 } from "path";
+import { join as join14 } from "path";
 function hasCustomRoutes(config) {
   const workspace = getWorkspace();
   const customRoutesConfig = config?.integrations?.customRoutes;
   const customRoutesDir = typeof customRoutesConfig === "object" && customRoutesConfig.directory || DEFAULT_API_ROUTES_DIRECTORY;
-  return existsSync14(join13(workspace, customRoutesDir));
+  return existsSync14(join14(workspace, customRoutesDir));
 }
 function needsBackend(config) {
   return !!config?.integrations || hasCustomRoutes(config);
@@ -7512,13 +7575,13 @@ init_constants2();
 init_core();
 import { existsSync as existsSync15, readFileSync as readFileSync4, unlinkSync as unlinkSync2 } from "fs";
 import { mkdir as mkdir4, unlink, writeFile as writeFile4 } from "fs/promises";
-import { join as join14 } from "path";
+import { join as join15 } from "path";
 function getDevServerPidPath() {
-  return join14(getWorkspace(), CLI_DIRECTORIES.WORKSPACE, CLI_FILES.DEV_SERVER_PID);
+  return join15(getWorkspace(), CLI_DIRECTORIES.WORKSPACE, CLI_FILES.DEV_SERVER_PID);
 }
 async function createDevServerPidFile() {
   const pidPath = getDevServerPidFile();
-  const pidDir = join14(getWorkspace(), CLI_DIRECTORIES.WORKSPACE);
+  const pidDir = join15(getWorkspace(), CLI_DIRECTORIES.WORKSPACE);
   await mkdir4(pidDir, { recursive: true });
   await writeFile4(pidPath, process.pid.toString());
 }
@@ -7558,7 +7621,7 @@ function getDevServerPidFile() {
 // src/lib/dev/reload.ts
 init_constants2();
 init_core();
-import { join as join15, relative as relative3 } from "path";
+import { join as join16, relative as relative3 } from "path";
 import chokidar from "chokidar";
 import { bold as bold4, cyan as cyan3, dim as dim6, green as green3 } from "colorette";
 function formatTime() {
@@ -7575,9 +7638,9 @@ function startHotReload(onReload, options = {}) {
   const customRoutesConfig = options.config?.integrations?.customRoutes;
   const customRoutesDir = typeof customRoutesConfig === "object" && customRoutesConfig.directory || DEFAULT_API_ROUTES_DIRECTORY;
   const watchPaths = [
-    join15(workspace, customRoutesDir),
-    join15(workspace, "playcademy.config.js"),
-    join15(workspace, "playcademy.config.json")
+    join16(workspace, customRoutesDir),
+    join16(workspace, "playcademy.config.js"),
+    join16(workspace, "playcademy.config.json")
   ];
   const watcher = chokidar.watch(watchPaths, {
     persistent: true,
@@ -7619,28 +7682,28 @@ function startHotReload(onReload, options = {}) {
 // src/lib/dev/server.ts
 init_src2();
 init_constants2();
+init_loader();
 init_core();
 import { mkdir as mkdir5 } from "fs/promises";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 import { Miniflare } from "miniflare";
 async function startDevServer(options) {
   const {
     port,
-    config,
+    config: providedConfig,
     platformUrl = process.env.PLAYCADEMY_BASE_URL || "http://localhost:5174"
   } = options;
+  const config = providedConfig ?? await loadConfig();
   const hasSandboxTimebackCreds = !!process.env.TIMEBACK_API_CLIENT_ID;
-  const devConfig = config?.integrations?.timeback && !hasSandboxTimebackCreds ? { ...config, integrations: { ...config.integrations, timeback: void 0 } } : config;
+  const devConfig = config.integrations?.timeback && !hasSandboxTimebackCreds ? { ...config, integrations: { ...config.integrations, timeback: void 0 } } : config;
   const bundle = await bundleBackend(devConfig, {
     sourcemap: false,
     minify: false
   });
-  const dbDir = join16(getWorkspace(), CLI_DIRECTORIES.DATABASE);
-  try {
-    await mkdir5(dbDir, { recursive: true });
-  } catch (error) {
-    throw new Error(`Failed to create database directory: ${getErrorMessage(error)}`);
-  }
+  const hasDatabase = hasDatabaseSetup();
+  const dbDir = hasDatabase ? await ensureDatabaseDirectory() : void 0;
+  const hasKV = hasKVSetup(config);
+  const kvDir = hasKV ? await ensureKvDirectory() : void 0;
   const mf = new Miniflare({
     port,
     modules: [
@@ -7655,14 +7718,39 @@ async function startDevServer(options) {
       GAME_ID: CORE_GAME_UUIDS.PLAYGROUND,
       PLAYCADEMY_BASE_URL: platformUrl
     },
-    d1Databases: ["DB"],
+    d1Databases: hasDatabase ? ["DB"] : [],
     d1Persist: dbDir,
+    kvNamespaces: hasKV ? ["KV"] : [],
+    kvPersist: kvDir,
     compatibilityDate: CLOUDFLARE_COMPATIBILITY_DATE
   });
+  if (hasDatabase) {
+    await initializeDatabase(mf);
+  }
+  return mf;
+}
+async function ensureDatabaseDirectory() {
+  const dbDir = join17(getWorkspace(), CLI_DIRECTORIES.DATABASE);
+  try {
+    await mkdir5(dbDir, { recursive: true });
+  } catch (error) {
+    throw new Error(`Failed to create database directory: ${getErrorMessage(error)}`);
+  }
+  return dbDir;
+}
+async function ensureKvDirectory() {
+  const kvDir = join17(getWorkspace(), CLI_DIRECTORIES.KV);
+  try {
+    await mkdir5(kvDir, { recursive: true });
+  } catch (error) {
+    throw new Error(`Failed to create KV directory: ${getErrorMessage(error)}`);
+  }
+  return kvDir;
+}
+async function initializeDatabase(mf) {
   const d1 = await mf.getD1Database("DB");
   await d1.exec("SELECT 1");
   await createDevServerPidFile();
-  return mf;
 }
 
 // src/lib/timeback/cleanup.ts
@@ -7843,6 +7931,7 @@ var initCommand = new Command2("init").description("Initialize a playcademy.conf
     const {
       timeback: timebackConfig,
       database,
+      kv,
       customRoutes
     } = await promptForIntegrations();
     let depsAdded = false;
@@ -7857,6 +7946,7 @@ var initCommand = new Command2("init").description("Initialize a playcademy.conf
       const scaffoldDepsAdded = await scaffoldIntegrations(
         customRoutes,
         database,
+        kv,
         gameInfo.name
       );
       if (scaffoldDepsAdded) depsAdded = true;
@@ -7872,6 +7962,7 @@ var initCommand = new Command2("init").description("Initialize a playcademy.conf
       emoji: gameInfo.emoji,
       customRoutesDirectory: customRoutes?.directory ?? void 0,
       databaseDirectory: database?.directory ?? void 0,
+      kv: kv ?? void 0,
       timeback: timebackConfig ?? void 0
     }) : generateJsonConfig({
       name: gameInfo.name,
@@ -7879,6 +7970,7 @@ var initCommand = new Command2("init").description("Initialize a playcademy.conf
       emoji: gameInfo.emoji,
       customRoutesDirectory: customRoutes?.directory ?? void 0,
       databaseDirectory: database?.directory ?? void 0,
+      kv: kv ?? void 0,
       timeback: timebackConfig ?? void 0
     });
     writeFileSync5(resolve10(getWorkspace(), configFileName), configContent, "utf-8");
@@ -7904,7 +7996,6 @@ async function addPlaycademySdk() {
   if (!pkg.dependencies) pkg.dependencies = {};
   pkg.dependencies["@playcademy/sdk"] = "latest";
   writeFileSync5(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
-  logger.success("Added @playcademy/sdk to dependencies");
   return true;
 }
 async function installDependencies() {
@@ -8579,27 +8670,14 @@ devCommand.addCommand(getStatusCommand);
 import { Command as Command13 } from "commander";
 
 // src/commands/api/init.ts
-init_file_loader();
 init_constants2();
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "fs";
 import { input as input5 } from "@inquirer/prompts";
+init_writer();
 init_loader2();
 async function runApiInit() {
   try {
     logger.newLine();
-    const configFile = await findFile(CONFIG_FILE_NAMES, {
-      searchUp: false,
-      maxLevels: 0
-    });
-    if (!configFile) {
-      logger.error("No playcademy.config file found");
-      logger.newLine();
-      logger.admonition("tip", "Getting Started", [
-        "Run `playcademy init` to create a config file first"
-      ]);
-      logger.newLine();
-      process.exit(1);
-    }
+    const config = await loadConfig();
     logger.highlight("Add Custom API Routes");
     logger.newLine();
     const apiDir = await input5({
@@ -8612,48 +8690,39 @@ async function runApiInit() {
         return validateApiDirectoryDoesNotExist(value);
       }
     });
-    const hasDb = hasDatabaseSetup();
-    const sampleRouteTemplate2 = hasDb ? loadTemplateString("api/sample-route-with-db.ts") : loadTemplateString("api/sample-route.ts");
-    await scaffoldApiDirectory(apiDir, sampleRouteTemplate2);
-    const configPath = configFile.path;
-    const config = await loadConfig(configPath);
+    const sampleRoutes = [
+      // Always include basic custom route example
+      { filename: "custom.ts", template: loadTemplateString("api/sample-custom.ts") }
+    ];
+    if (hasDatabaseSetup()) {
+      sampleRoutes.push({
+        filename: "database.ts",
+        template: loadTemplateString("api/sample-database.ts")
+      });
+    }
+    if (hasKVSetup(config)) {
+      sampleRoutes.push({
+        filename: "kv.ts",
+        template: loadTemplateString("api/sample-kv.ts")
+      });
+    }
+    await scaffoldApiDirectory(apiDir, sampleRoutes);
     if (!config.integrations?.customRoutes) {
-      const configContent = readFileSync6(configPath, "utf-8");
-      const isJson = configPath.endsWith(".json");
-      let updatedContent;
-      if (isJson) {
-        const parsed = JSON.parse(configContent);
-        if (!parsed.integrations) parsed.integrations = {};
-        parsed.integrations.customRoutes = { directory: apiDir };
-        updatedContent = JSON.stringify(parsed, null, 4);
-      } else {
-        if (configContent.includes("integrations:")) {
-          const customRoutesConfig = `
-        customRoutes: { directory: '${apiDir}' },`;
-          updatedContent = configContent.replace(
-            /(integrations:\s*{)/,
-            `$1${customRoutesConfig}`
-          );
-        } else {
-          const integrationsConfig = `
-    integrations: {
-        customRoutes: { directory: '${apiDir}' },
-    },`;
-          updatedContent = configContent.replace(
-            /(\n\s*})(\s*)$/,
-            `${integrationsConfig}$1$2`
-          );
+      const configPath = await findConfigPath();
+      await updateConfigFile(configPath, {
+        integrations: {
+          ...config.integrations,
+          customRoutes: { directory: apiDir }
         }
-      }
-      writeFileSync6(configPath, updatedContent, "utf-8");
-      logger.success(`Updated ${configFile.path.split("/").pop()}`);
+      });
+      logger.success(`Updated ${configPath.split("/").pop()}`);
     }
     logger.newLine();
     logger.success("Custom API routes added!");
     logger.newLine();
     logger.admonition("tip", "Next Steps", [
-      `1. Review the sample route in ${apiDir}/hello.ts`,
-      `2. Create your custom routes in ${apiDir}/`,
+      `1. Review sample routes in ${apiDir}/sample/`,
+      `2. Create custom routes in ${apiDir}/`,
       "3. Run `playcademy dev` to test locally",
       "4. Run `playcademy deploy --backend` to deploy"
     ]);
@@ -8702,7 +8771,7 @@ async function runDbDiff() {
 // src/commands/db/init.ts
 init_file_loader();
 init_constants2();
-import { readFileSync as readFileSync7, writeFileSync as writeFileSync7 } from "fs";
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "fs";
 import { input as input6 } from "@inquirer/prompts";
 async function runDbInit() {
   try {
@@ -8733,9 +8802,10 @@ async function runDbInit() {
         return true;
       }
     });
+    ensurePlaycademyGitignore();
     await scaffoldDatabaseSetup({ gameName: config.name });
     if (!config.integrations?.database) {
-      const configContent = readFileSync7(configFile.path, "utf-8");
+      const configContent = readFileSync6(configFile.path, "utf-8");
       const isJson = configFile.path.endsWith(".json");
       let updatedContent;
       if (isJson) {
@@ -8758,7 +8828,7 @@ async function runDbInit() {
           );
         }
       }
-      writeFileSync7(configFile.path, updatedContent, "utf-8");
+      writeFileSync6(configFile.path, updatedContent, "utf-8");
       logger.success(`Updated ${configFile.path.split("/").pop()}`);
     }
     logger.newLine();
@@ -8783,13 +8853,13 @@ init_src();
 init_constants2();
 import { spawn } from "child_process";
 import { existsSync as existsSync16, rmSync as rmSync2 } from "fs";
-import { join as join17 } from "path";
+import { join as join18 } from "path";
 import { confirm as confirm6 } from "@inquirer/prompts";
 import { Miniflare as Miniflare2 } from "miniflare";
 async function runDbReset() {
   try {
     const workspace = getWorkspace();
-    const dbDir = join17(workspace, CLI_DIRECTORIES.DATABASE);
+    const dbDir = join18(workspace, CLI_DIRECTORIES.DATABASE);
     if (!existsSync16(dbDir)) {
       logger.warn("No database found to reset");
       logger.newLine();
@@ -8894,7 +8964,7 @@ async function runDbReset() {
 init_package_manager();
 import { execSync as execSync4 } from "child_process";
 import { existsSync as existsSync17 } from "fs";
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 async function runDbSeed(options) {
   const workspace = getWorkspace();
   try {
@@ -8903,7 +8973,7 @@ async function runDbSeed(options) {
       logger.newLine();
     }
     if (options.file) {
-      const seedPath = join18(workspace, options.file);
+      const seedPath = join19(workspace, options.file);
       if (!existsSync17(seedPath)) {
         logger.error(`Seed file not found: ${options.file}`);
         logger.newLine();
@@ -8929,102 +8999,1143 @@ dbCommand.command("reset").description("Reset local development database (delete
 dbCommand.command("seed [file]").description("Seed local database with initial data").option("-r, --reset", "Reset database before seeding").action((file, options) => runDbSeed({ file, reset: options.reset }));
 dbCommand.command("diff").description("Show schema changes since last deployment").action(runDbDiff);
 
-// src/commands/profiles/index.ts
-import { Command as Command18 } from "commander";
+// src/commands/kv/index.ts
+import { Command as Command15 } from "commander";
 
-// src/commands/profiles/list.ts
+// src/commands/kv/clear.ts
 init_string();
-import { Command as Command15 } from "commander";
-async function listProfilesAction() {
+init_constants2();
+import { join as join20 } from "path";
+import { confirm as confirm7 } from "@inquirer/prompts";
+import { Miniflare as Miniflare3 } from "miniflare";
+async function runKVClear(options = {}) {
   try {
-    const profilesMap = await listProfiles();
-    logger.newLine();
-    let hasAnyProfiles = false;
-    for (const [, profiles] of profilesMap.entries()) {
-      if (profiles.length > 0) {
-        hasAnyProfiles = true;
-        break;
+    if (!options.raw && !options.json) {
+      logger.newLine();
+    }
+    if (options.remote) {
+      if (!options.raw && !options.json) {
+        logger.newLine();
+        logger.warn("Remote KV operations are not yet implemented");
+        logger.newLine();
+        logger.admonition("info", "Coming Soon", [
+          "Remote KV support is on the roadmap and will be available soon.",
+          "For now, KV commands only work with local development storage."
+        ]);
+        logger.newLine();
       }
+      process.exit(1);
     }
-    if (!hasAnyProfiles) {
-      logger.warn("No authentication profiles found");
-      logger.newLine();
-      logger.admonition("tip", "Getting Started", [
-        "Run `playcademy login` to create your first profile"
-      ]);
-      logger.newLine();
-      return;
+    const config = await loadConfig();
+    if (!hasKVSetup(config)) {
+      if (!options.raw && !options.json) {
+        logger.error("KV storage is not configured");
+        logger.newLine();
+        logger.admonition("tip", "Getting Started", [
+          "Run `playcademy kv init` to enable KV storage"
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
     }
-    for (const [environment, profiles] of profilesMap.entries()) {
-      if (profiles.length === 0) continue;
-      const tableData = [];
-      for (const profileName of profiles) {
-        const profile = await getProfile(environment, profileName);
-        tableData.push({
-          Profile: profileName,
-          Email: profile?.email ?? ""
+    const bundle = await bundleBackend(config, {
+      sourcemap: false,
+      minify: false
+    });
+    const kvDir = join20(getWorkspace(), CLI_DIRECTORIES.KV);
+    const mf = new Miniflare3({
+      modules: [
+        {
+          type: "ESModule",
+          path: "index.mjs",
+          contents: bundle.code
+        }
+      ],
+      kvNamespaces: ["KV"],
+      kvPersist: kvDir,
+      compatibilityDate: CLOUDFLARE_COMPATIBILITY_DATE
+    });
+    try {
+      const kv = await mf.getKVNamespace("KV");
+      const listResult = await kv.list();
+      const keyCount = listResult.keys?.length || 0;
+      if (keyCount === 0) {
+        if (options.json) {
+          logger.json({
+            success: true,
+            deleted: 0,
+            message: "No keys to clear"
+          });
+        } else if (options.raw) {
+          logger.raw("0");
+        } else {
+          logger.info("No keys found in KV namespace");
+          logger.newLine();
+        }
+        return;
+      }
+      if (!options.force && !options.raw && !options.json) {
+        logger.warn(`This will delete ${keyCount} ${pluralize(keyCount, "key")}`);
+        logger.newLine();
+        const confirmed = await confirm7({
+          message: "Are you sure you want to clear all keys?",
+          default: false
         });
+        if (!confirmed) {
+          logger.info("Cancelled");
+          logger.newLine();
+          return;
+        }
+        logger.newLine();
       }
-      if (tableData.length > 0) {
-        const envTitle = capitalize(environment);
-        logger.table(tableData, envTitle);
+      const keys = listResult.keys || [];
+      for (const key of keys) {
+        await kv.delete(key.name);
+      }
+      if (options.json) {
+        logger.json({
+          success: true,
+          deleted: keyCount
+        });
+      } else if (options.raw) {
+        logger.raw(keyCount.toString());
+      } else {
+        logger.success(`Deleted ${keyCount} ${pluralize(keyCount, "key")}`);
         logger.newLine();
       }
+    } finally {
+      await mf.dispose();
     }
   } catch (error) {
-    logger.error(`Failed to list profiles: ${getErrorMessage(error)}`);
+    if (!options.raw && !options.json) {
+      logger.error(
+        `Failed to clear KV: ${error instanceof Error ? error.message : String(error)}`
+      );
+      logger.newLine();
+    }
     process.exit(1);
   }
 }
-var listCommand2 = new Command15("list").alias("ls").description("List all stored authentication profiles").action(listProfilesAction);
 
-// src/commands/profiles/remove.ts
-import { bold as bold6 } from "colorette";
-import { Command as Command16 } from "commander";
-var removeCommand = new Command16("remove").alias("rm").description('Remove an authentication profile (defaults to "default")').argument("[name]", "Profile name to remove", "default").option("--env <environment>", "Environment to remove profile from (staging or production)").action(async (name, options) => {
-  const { env } = options;
-  const environment = ensureEnvironment(env, logger);
+// src/commands/kv/delete.ts
+init_constants2();
+import { join as join21 } from "path";
+import { Miniflare as Miniflare4 } from "miniflare";
+async function runKVDelete(key, options = {}) {
   try {
-    logger.newLine();
-    const profilesMap = await listProfiles();
-    const envProfiles = profilesMap.get(environment) || [];
-    if (!envProfiles.includes(name)) {
-      logger.error(`Profile "${name}" not found in ${environment}`);
+    if (!options.raw && !options.json) {
       logger.newLine();
+    }
+    if (options.remote) {
+      if (!options.raw && !options.json) {
+        logger.newLine();
+        logger.warn("Remote KV operations are not yet implemented");
+        logger.newLine();
+        logger.admonition("info", "Coming Soon", [
+          "Remote KV support is on the roadmap and will be available soon.",
+          "For now, KV commands only work with local development storage."
+        ]);
+        logger.newLine();
+      }
       process.exit(1);
     }
-    await removeProfile(environment, name);
-    logger.admonition("note", "Removed!", [
-      `Profile ${bold6(name)} removed from ${environment}`,
-      environment === "production" ? `To re-authenticate run \`playcademy login --env ${environment}\`` : "To re-authenticate run `playcademy login`"
-    ]);
-    logger.newLine();
+    if (!key) {
+      if (!options.raw && !options.json) {
+        logger.error("Key is required");
+        logger.newLine();
+        logger.admonition("tip", "Usage", ["`playcademy kv delete <key>`"]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const config = await loadConfig();
+    if (!hasKVSetup(config)) {
+      if (!options.raw && !options.json) {
+        logger.error("KV storage is not configured");
+        logger.newLine();
+        logger.admonition("tip", "Getting Started", [
+          "Run `playcademy kv init` to enable KV storage"
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const bundle = await bundleBackend(config, {
+      sourcemap: false,
+      minify: false
+    });
+    const kvDir = join21(getWorkspace(), CLI_DIRECTORIES.KV);
+    const mf = new Miniflare4({
+      modules: [
+        {
+          type: "ESModule",
+          path: "index.mjs",
+          contents: bundle.code
+        }
+      ],
+      kvNamespaces: ["KV"],
+      kvPersist: kvDir,
+      compatibilityDate: CLOUDFLARE_COMPATIBILITY_DATE
+    });
+    try {
+      const kv = await mf.getKVNamespace("KV");
+      await kv.delete(key);
+      if (options.json) {
+        logger.json({
+          key,
+          success: true
+        });
+      } else if (options.raw) {
+        logger.raw("ok");
+      } else {
+        logger.success(`Deleted key: ${key}`);
+        logger.newLine();
+      }
+    } finally {
+      await mf.dispose();
+    }
   } catch (error) {
-    logAndExit(error, logger, { prefix: "Failed to remove profile" });
+    if (!options.raw && !options.json) {
+      logger.error(
+        `Failed to delete key: ${error instanceof Error ? error.message : String(error)}`
+      );
+      logger.newLine();
+    }
+    process.exit(1);
   }
-});
+}
 
-// src/commands/profiles/reset.ts
-init_string();
-import { confirm as confirm7 } from "@inquirer/prompts";
-import { Command as Command17 } from "commander";
-var resetCommand = new Command17("reset").description(
-  "Remove all authentication profiles across all environments (requires confirmation)"
-).alias("clear").action(async () => {
+// src/commands/kv/get.ts
+init_constants2();
+import { join as join22 } from "path";
+import { Miniflare as Miniflare5 } from "miniflare";
+async function runKVGet(key, options = {}) {
   try {
-    const profilesMap = await listProfiles();
-    let totalProfiles = 0;
-    for (const profiles of profilesMap.values()) {
-      totalProfiles += profiles.length;
-    }
-    if (totalProfiles === 0) {
-      logger.newLine();
-      logger.warn("No authentication profiles found");
+    if (!options.raw && !options.json) {
       logger.newLine();
-      return;
     }
-    logger.newLine();
-    logger.warn(
+    if (options.remote) {
+      if (!options.raw && !options.json) {
+        logger.newLine();
+        logger.warn("Remote KV operations are not yet implemented");
+        logger.newLine();
+        logger.admonition("info", "Coming Soon", [
+          "Remote KV support is on the roadmap and will be available soon.",
+          "For now, KV commands only work with local development storage."
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    if (!key) {
+      if (!options.raw && !options.json) {
+        logger.error("Key is required");
+        logger.newLine();
+        logger.admonition("tip", "Usage", ["`playcademy kv get <key>`"]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const config = await loadConfig();
+    if (!hasKVSetup(config)) {
+      if (!options.raw && !options.json) {
+        logger.error("KV storage is not configured");
+        logger.newLine();
+        logger.admonition("tip", "Getting Started", [
+          "Run `playcademy kv init` to enable KV storage"
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const bundle = await bundleBackend(config, {
+      sourcemap: false,
+      minify: false
+    });
+    const kvDir = join22(getWorkspace(), CLI_DIRECTORIES.KV);
+    const mf = new Miniflare5({
+      modules: [
+        {
+          type: "ESModule",
+          path: "index.mjs",
+          contents: bundle.code
+        }
+      ],
+      kvNamespaces: ["KV"],
+      kvPersist: kvDir,
+      compatibilityDate: CLOUDFLARE_COMPATIBILITY_DATE
+    });
+    try {
+      const kv = await mf.getKVNamespace("KV");
+      const value = await kv.get(key);
+      if (value === null) {
+        if (!options.raw && !options.json) {
+          logger.warn(`Key '${key}' not found`);
+          logger.newLine();
+          logger.admonition("tip", "Hint", [
+            "Use `playcademy kv list` to see all available keys"
+          ]);
+          logger.newLine();
+        }
+        process.exit(1);
+      }
+      let parsedValue;
+      let isJson = false;
+      try {
+        parsedValue = JSON.parse(value);
+        isJson = true;
+      } catch {
+        parsedValue = value;
+      }
+      if (options.json) {
+        if (isJson) {
+          logger.json(parsedValue);
+        } else {
+          logger.json(value);
+        }
+        return;
+      }
+      if (options.raw) {
+        logger.raw(value);
+        return;
+      }
+      logger.success(`Key: ${key}`);
+      logger.newLine();
+      if (isJson) {
+        logger.json(parsedValue, 1);
+      } else {
+        logger.data("Value", value, 1);
+      }
+      logger.newLine();
+    } finally {
+      await mf.dispose();
+    }
+  } catch (error) {
+    if (!options.raw && !options.json) {
+      logger.error(
+        `Failed to get key: ${error instanceof Error ? error.message : String(error)}`
+      );
+      logger.newLine();
+    }
+    process.exit(1);
+  }
+}
+
+// src/commands/kv/init.ts
+init_writer();
+async function runKVInit() {
+  try {
+    logger.newLine();
+    const config = await loadConfig();
+    if (hasKVSetup(config)) {
+      logger.success("KV storage is already configured");
+      logger.newLine();
+      logger.admonition("tip", "Already Set Up", [
+        "Your playcademy.config file already has KV integration enabled",
+        "You can start using `c.env.KV` in your API routes"
+      ]);
+      logger.newLine();
+      return;
+    }
+    ensurePlaycademyGitignore();
+    logger.highlight("Add KV Storage Integration");
+    logger.newLine();
+    const configPath = await findConfigPath();
+    await updateConfigFile(configPath, {
+      integrations: {
+        ...config.integrations,
+        kv: true
+      }
+    });
+    logger.success("Added KV integration to config");
+    logger.newLine();
+    logger.admonition("tip", "Usage Example", [
+      "Access KV in your API routes:",
+      "",
+      "```typescript",
+      "export async function GET(c: Context) {",
+      "    // Read from KV",
+      `    const data = await c.env.KV.get('user:123')`,
+      "",
+      "    // Write to KV",
+      `    await c.env.KV.put('user:123', JSON.stringify({ score: 100 }))`,
+      "",
+      "    // Delete from KV",
+      `    await c.env.KV.delete('user:123')`,
+      "",
+      "    return c.json({ success: true })",
+      "}",
+      "```"
+    ]);
+    logger.newLine();
+    logger.remark("Run `playcademy dev` to start using KV in local development");
+    logger.newLine();
+  } catch (error) {
+    logger.error(
+      `Failed to add KV integration: ${error instanceof Error ? error.message : String(error)}`
+    );
+    logger.newLine();
+    process.exit(1);
+  }
+}
+
+// src/commands/kv/inspect.ts
+init_constants2();
+import { join as join23 } from "path";
+import { Miniflare as Miniflare6 } from "miniflare";
+async function runKVInspect(key, options = {}) {
+  try {
+    if (!options.raw && !options.json) {
+      logger.newLine();
+    }
+    if (options.remote) {
+      if (!options.raw && !options.json) {
+        logger.newLine();
+        logger.warn("Remote KV operations are not yet implemented");
+        logger.newLine();
+        logger.admonition("info", "Coming Soon", [
+          "Remote KV support is on the roadmap and will be available soon.",
+          "For now, KV commands only work with local development storage."
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    if (!key) {
+      if (!options.raw && !options.json) {
+        logger.error("Key is required");
+        logger.newLine();
+        logger.admonition("tip", "Usage", ["`playcademy kv inspect <key>`"]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const config = await loadConfig();
+    if (!hasKVSetup(config)) {
+      if (!options.raw && !options.json) {
+        logger.error("KV storage is not configured");
+        logger.newLine();
+        logger.admonition("tip", "Getting Started", [
+          "Run `playcademy kv init` to enable KV storage"
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const bundle = await bundleBackend(config, {
+      sourcemap: false,
+      minify: false
+    });
+    const kvDir = join23(getWorkspace(), CLI_DIRECTORIES.KV);
+    const mf = new Miniflare6({
+      modules: [
+        {
+          type: "ESModule",
+          path: "index.mjs",
+          contents: bundle.code
+        }
+      ],
+      kvNamespaces: ["KV"],
+      kvPersist: kvDir,
+      compatibilityDate: CLOUDFLARE_COMPATIBILITY_DATE
+    });
+    try {
+      const kv = await mf.getKVNamespace("KV");
+      const value = await kv.get(key);
+      if (value === null) {
+        const metadata2 = {
+          key,
+          exists: false
+        };
+        if (options.json) {
+          logger.json(metadata2);
+        } else if (!options.raw) {
+          logger.warn(`Key '${key}' not found`);
+          logger.newLine();
+          logger.admonition("tip", "Hint", [
+            "Use `playcademy kv list` to see all available keys"
+          ]);
+          logger.newLine();
+        }
+        process.exit(1);
+      }
+      const size = new Blob([value]).size;
+      let parsedValue;
+      let valueType = "string";
+      try {
+        parsedValue = JSON.parse(value);
+        valueType = "json";
+      } catch {
+        parsedValue = value;
+      }
+      const metadata = {
+        key,
+        exists: true,
+        size,
+        value: parsedValue,
+        valueType
+      };
+      if (options.json) {
+        logger.json(metadata);
+      } else if (options.raw) {
+        logger.raw(size.toString());
+      } else {
+        logger.success(`Key: ${key}`);
+        logger.newLine();
+        const sizeKB = (size / 1024).toFixed(2);
+        const sizeDisplay = size >= 1024 ? `${sizeKB} KB` : `${size} bytes`;
+        logger.data("Size", sizeDisplay, 1);
+        logger.data("Type", valueType === "json" ? "JSON" : "String", 1);
+        logger.newLine();
+        logger.data("Value", "", 1);
+        if (valueType === "json") {
+          logger.json(parsedValue, 2);
+        } else {
+          const lines = value.split("\n");
+          const maxLines = 5;
+          const preview = lines.slice(0, maxLines);
+          for (const line of preview) {
+            logger.dim(line, 2);
+          }
+          if (lines.length > maxLines) {
+            logger.dim(`... (${lines.length - maxLines} more lines)`, 2);
+          }
+        }
+        logger.newLine();
+      }
+    } finally {
+      await mf.dispose();
+    }
+  } catch (error) {
+    if (!options.raw && !options.json) {
+      logger.error(
+        `Failed to inspect key: ${error instanceof Error ? error.message : String(error)}`
+      );
+      logger.newLine();
+    }
+    process.exit(1);
+  }
+}
+
+// src/commands/kv/list.ts
+init_string();
+init_constants2();
+import { join as join24 } from "path";
+import { Miniflare as Miniflare7 } from "miniflare";
+async function runKVList(options = {}) {
+  try {
+    if (!options.raw && !options.json) {
+      logger.newLine();
+    }
+    if (options.remote) {
+      if (!options.raw && !options.json) {
+        logger.newLine();
+        logger.warn("Remote KV operations are not yet implemented");
+        logger.newLine();
+        logger.admonition("info", "Coming Soon", [
+          "Remote KV support is on the roadmap and will be available soon.",
+          "For now, KV commands only work with local development storage."
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const config = await loadConfig();
+    if (!hasKVSetup(config)) {
+      if (!options.raw && !options.json) {
+        logger.error("KV storage is not configured");
+        logger.newLine();
+        logger.admonition("tip", "Getting Started", [
+          "Run `playcademy kv init` to enable KV storage"
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const bundle = await bundleBackend(config, {
+      sourcemap: false,
+      minify: false
+    });
+    const kvDir = join24(getWorkspace(), CLI_DIRECTORIES.KV);
+    const mf = new Miniflare7({
+      modules: [
+        {
+          type: "ESModule",
+          path: "index.mjs",
+          contents: bundle.code
+        }
+      ],
+      kvNamespaces: ["KV"],
+      kvPersist: kvDir,
+      compatibilityDate: CLOUDFLARE_COMPATIBILITY_DATE
+    });
+    try {
+      const kv = await mf.getKVNamespace("KV");
+      const listResult = await kv.list();
+      const keyNames = listResult.keys?.map((k) => k.name) || [];
+      if (options.json) {
+        logger.json(keyNames);
+        return;
+      }
+      if (options.raw) {
+        for (const keyName of keyNames) {
+          logger.raw(keyName);
+        }
+        return;
+      }
+      if (keyNames.length === 0) {
+        logger.info("No keys found in KV namespace");
+      } else {
+        logger.success(`Found ${keyNames.length} ${pluralize(keyNames.length, "key")}`);
+        logger.newLine();
+        for (const keyName of keyNames) {
+          logger.bold(keyName, 1);
+        }
+      }
+      logger.newLine();
+    } finally {
+      await mf.dispose();
+    }
+  } catch (error) {
+    if (!options.raw && !options.json) {
+      logger.error(
+        `Failed to list KV keys: ${error instanceof Error ? error.message : String(error)}`
+      );
+      logger.newLine();
+    }
+    process.exit(1);
+  }
+}
+
+// src/commands/kv/seed.ts
+init_file_loader();
+init_string();
+init_constants2();
+import { join as join25 } from "path";
+import { confirm as confirm8 } from "@inquirer/prompts";
+import { Miniflare as Miniflare8 } from "miniflare";
+async function runKVSeed(seedFile, options = {}) {
+  try {
+    if (!options.raw && !options.json) {
+      logger.newLine();
+    }
+    if (options.remote) {
+      if (!options.raw && !options.json) {
+        logger.newLine();
+        logger.warn("Remote KV operations are not yet implemented");
+        logger.newLine();
+        logger.admonition("info", "Coming Soon", [
+          "Remote KV support is on the roadmap and will be available soon.",
+          "For now, KV commands only work with local development storage."
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    if (!seedFile) {
+      if (!options.raw && !options.json) {
+        logger.error("Seed file is required");
+        logger.newLine();
+        logger.admonition("tip", "Usage", [
+          "`playcademy kv seed <file>`",
+          "",
+          "Example:",
+          "`playcademy kv seed seeds/kv.json`"
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const config = await loadConfig();
+    if (!hasKVSetup(config)) {
+      if (!options.raw && !options.json) {
+        logger.error("KV storage is not configured");
+        logger.newLine();
+        logger.admonition("tip", "Getting Started", [
+          "Run `playcademy kv init` to enable KV storage"
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const workspace = getWorkspace();
+    const seedData = await loadFile(seedFile, {
+      cwd: workspace,
+      parseJson: true
+    });
+    if (!seedData) {
+      if (!options.raw && !options.json) {
+        logger.error(`Seed file not found: ${seedFile}`);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    if (typeof seedData !== "object" || seedData === null || Array.isArray(seedData)) {
+      if (!options.raw && !options.json) {
+        logger.error("Seed file must contain a JSON object");
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const bundle = await bundleBackend(config, {
+      sourcemap: false,
+      minify: false
+    });
+    const kvDir = join25(workspace, CLI_DIRECTORIES.KV);
+    const mf = new Miniflare8({
+      modules: [
+        {
+          type: "ESModule",
+          path: "index.mjs",
+          contents: bundle.code
+        }
+      ],
+      kvNamespaces: ["KV"],
+      kvPersist: kvDir,
+      compatibilityDate: CLOUDFLARE_COMPATIBILITY_DATE
+    });
+    try {
+      const kv = await mf.getKVNamespace("KV");
+      const keysToSeed = Object.keys(seedData);
+      if (!options.force && !options.replace && !options.raw && !options.json) {
+        const existingKeys = [];
+        for (const key of keysToSeed) {
+          const existingValue = await kv.get(key);
+          if (existingValue !== null) {
+            existingKeys.push(key);
+          }
+        }
+        if (existingKeys.length > 0) {
+          logger.warn(
+            `${existingKeys.length} ${pluralize(existingKeys.length, "key")} will be overwritten`
+          );
+          logger.newLine();
+          const confirmed = await confirm8({
+            message: "Continue seeding?",
+            default: false
+          });
+          if (!confirmed) {
+            logger.info("Cancelled");
+            logger.newLine();
+            return;
+          }
+          logger.newLine();
+        }
+      }
+      if (options.replace) {
+        const listResult = await kv.list();
+        const existingKeys = listResult.keys || [];
+        for (const key of existingKeys) {
+          await kv.delete(key.name);
+        }
+      }
+      let seededCount = 0;
+      for (const key of keysToSeed) {
+        const value = seedData[key];
+        const valueString = typeof value === "string" ? value : JSON.stringify(value);
+        await kv.put(key, valueString);
+        seededCount++;
+      }
+      if (options.json) {
+        logger.json({
+          success: true,
+          seeded: seededCount,
+          ...options.replace && { cleared: true }
+        });
+      } else if (options.raw) {
+        logger.raw(seededCount.toString());
+      } else {
+        if (options.replace) {
+          logger.success("Cleared existing keys");
+        }
+        logger.success(`Seeded ${seededCount} ${pluralize(seededCount, "key")}`);
+        logger.newLine();
+      }
+    } finally {
+      await mf.dispose();
+    }
+  } catch (error) {
+    if (!options.raw && !options.json) {
+      logger.error(
+        `Failed to seed KV: ${error instanceof Error ? error.message : String(error)}`
+      );
+      logger.newLine();
+    }
+    process.exit(1);
+  }
+}
+
+// src/commands/kv/set.ts
+init_file_loader();
+init_constants2();
+import { join as join26 } from "path";
+import { Miniflare as Miniflare9 } from "miniflare";
+async function runKVSet(key, value, options = {}) {
+  try {
+    if (!options.raw && !options.json) {
+      logger.newLine();
+    }
+    if (options.remote) {
+      if (!options.raw && !options.json) {
+        logger.newLine();
+        logger.warn("Remote KV operations are not yet implemented");
+        logger.newLine();
+        logger.admonition("info", "Coming Soon", [
+          "Remote KV support is on the roadmap and will be available soon.",
+          "For now, KV commands only work with local development storage."
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    if (!key) {
+      if (!options.raw && !options.json) {
+        logger.error("Key is required");
+        logger.newLine();
+        logger.admonition("tip", "Usage", [
+          "`playcademy kv set <key> <value>`",
+          "`playcademy kv set <key> --file <path>`"
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const config = await loadConfig();
+    if (!hasKVSetup(config)) {
+      if (!options.raw && !options.json) {
+        logger.error("KV storage is not configured");
+        logger.newLine();
+        logger.admonition("tip", "Getting Started", [
+          "Run `playcademy kv init` to enable KV storage"
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    let valueToSet;
+    if (options.file) {
+      const workspace = getWorkspace();
+      const fileContent = await loadFile(options.file, { cwd: workspace });
+      if (!fileContent) {
+        if (!options.raw && !options.json) {
+          logger.error(`File not found: ${options.file}`);
+          logger.newLine();
+        }
+        process.exit(1);
+      }
+      valueToSet = fileContent;
+    } else if (value !== void 0) {
+      valueToSet = value;
+    } else {
+      if (!options.raw && !options.json) {
+        logger.error("Value is required (either as argument or via --file)");
+        logger.newLine();
+        logger.admonition("tip", "Usage", [
+          "`playcademy kv set <key> <value>`",
+          "`playcademy kv set <key> --file <path>`"
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const bundle = await bundleBackend(config, {
+      sourcemap: false,
+      minify: false
+    });
+    const kvDir = join26(getWorkspace(), CLI_DIRECTORIES.KV);
+    const mf = new Miniflare9({
+      modules: [
+        {
+          type: "ESModule",
+          path: "index.mjs",
+          contents: bundle.code
+        }
+      ],
+      kvNamespaces: ["KV"],
+      kvPersist: kvDir,
+      compatibilityDate: CLOUDFLARE_COMPATIBILITY_DATE
+    });
+    try {
+      const kv = await mf.getKVNamespace("KV");
+      await kv.put(key, valueToSet);
+      if (options.json) {
+        logger.json({
+          key,
+          success: true
+        });
+      } else if (options.raw) {
+        logger.raw("ok");
+      } else {
+        logger.success(`Set key: ${key}`);
+        logger.newLine();
+      }
+    } finally {
+      await mf.dispose();
+    }
+  } catch (error) {
+    if (!options.raw && !options.json) {
+      logger.error(
+        `Failed to set key: ${error instanceof Error ? error.message : String(error)}`
+      );
+      logger.newLine();
+    }
+    process.exit(1);
+  }
+}
+
+// src/commands/kv/stats.ts
+init_string();
+init_constants2();
+import { join as join27 } from "path";
+import { Miniflare as Miniflare10 } from "miniflare";
+async function runKVStats(options = {}) {
+  try {
+    if (!options.raw && !options.json) {
+      logger.newLine();
+    }
+    if (options.remote) {
+      if (!options.raw && !options.json) {
+        logger.newLine();
+        logger.warn("Remote KV operations are not yet implemented");
+        logger.newLine();
+        logger.admonition("info", "Coming Soon", [
+          "Remote KV support is on the roadmap and will be available soon.",
+          "For now, KV commands only work with local development storage."
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const config = await loadConfig();
+    if (!hasKVSetup(config)) {
+      if (!options.raw && !options.json) {
+        logger.error("KV storage is not configured");
+        logger.newLine();
+        logger.admonition("tip", "Getting Started", [
+          "Run `playcademy kv init` to enable KV storage"
+        ]);
+        logger.newLine();
+      }
+      process.exit(1);
+    }
+    const bundle = await bundleBackend(config, {
+      sourcemap: false,
+      minify: false
+    });
+    const kvDir = join27(getWorkspace(), CLI_DIRECTORIES.KV);
+    const mf = new Miniflare10({
+      modules: [
+        {
+          type: "ESModule",
+          path: "index.mjs",
+          contents: bundle.code
+        }
+      ],
+      kvNamespaces: ["KV"],
+      kvPersist: kvDir,
+      compatibilityDate: CLOUDFLARE_COMPATIBILITY_DATE
+    });
+    try {
+      const kv = await mf.getKVNamespace("KV");
+      const listResult = await kv.list();
+      const keys = listResult.keys || [];
+      let totalSize = 0;
+      let largestKey;
+      const prefixes = {};
+      for (const key of keys) {
+        const value = await kv.get(key.name);
+        const size = value ? new Blob([value]).size : 0;
+        totalSize += size;
+        if (!largestKey || size > largestKey.size) {
+          largestKey = { name: key.name, size };
+        }
+        const prefixMatch = key.name.match(/^([^:]+):/);
+        const prefix = prefixMatch ? `${prefixMatch[1]}:*` : "(no prefix)";
+        prefixes[prefix] = (prefixes[prefix] || 0) + 1;
+      }
+      const stats = {
+        totalKeys: keys.length,
+        totalSize,
+        largestKey,
+        prefixes
+      };
+      if (options.json) {
+        logger.json(stats);
+      } else if (options.raw) {
+        logger.raw(stats.totalKeys.toString());
+      } else {
+        if (stats.totalKeys === 0) {
+          logger.info("No keys found in KV namespace");
+          logger.newLine();
+          return;
+        }
+        logger.data("Total Keys", stats.totalKeys.toString(), 1);
+        const sizeKB = (stats.totalSize / 1024).toFixed(2);
+        const sizeMB = (stats.totalSize / 1024 / 1024).toFixed(2);
+        const sizeDisplay = stats.totalSize >= 1024 * 1024 ? `${sizeMB} MB` : `${sizeKB} KB`;
+        logger.data("Total Size", sizeDisplay, 1);
+        if (stats.largestKey) {
+          const largestKB = (stats.largestKey.size / 1024).toFixed(2);
+          logger.data("Largest Key", `${stats.largestKey.name} (${largestKB} KB)`, 1);
+        }
+        const sortedPrefixes = Object.entries(stats.prefixes).sort((a, b) => b[1] - a[1]);
+        if (sortedPrefixes.length > 0) {
+          logger.newLine();
+          logger.data("Keys by Prefix:", "", 1);
+          for (const [prefix, count] of sortedPrefixes) {
+            logger.dim(`${prefix.padEnd(20)} ${count} ${pluralize(count, "key")}`, 2);
+          }
+        }
+        logger.newLine();
+      }
+    } finally {
+      await mf.dispose();
+    }
+  } catch (error) {
+    if (!options.raw && !options.json) {
+      logger.error(
+        `Failed to get KV stats: ${error instanceof Error ? error.message : String(error)}`
+      );
+      logger.newLine();
+    }
+    process.exit(1);
+  }
+}
+
+// src/commands/kv/index.ts
+var kvCommand = new Command15("kv").description("Manage KV storage integration").action(() => {
+  kvCommand.help();
+});
+kvCommand.command("init").description("Add KV storage integration to your project").action(runKVInit);
+kvCommand.command("list").alias("ls").description("List keys in local KV namespace (dev mode)").option("--raw", "Output key names one per line, no formatting").option("--json", "Output as JSON array").option("--remote", "Use remote KV storage (not yet implemented)").option(
+  "--env <environment>",
+  "Environment to use with --remote: staging (default) or production"
+).action(runKVList);
+kvCommand.command("stats").description("Show statistics about local KV namespace (dev mode)").option("--raw", "Output total key count only").option("--json", "Output statistics as JSON").option("--remote", "Use remote KV storage (not yet implemented)").option(
+  "--env <environment>",
+  "Environment to use with --remote: staging (default) or production"
+).action(runKVStats);
+kvCommand.command("get <key>").description("Get value for a specific key in local KV namespace (dev mode)").option("--raw", "Output raw value without formatting").option("--json", "Force JSON pretty-printing (default for valid JSON)").option("--remote", "Use remote KV storage (not yet implemented)").option(
+  "--env <environment>",
+  "Environment to use with --remote: staging (default) or production"
+).action(runKVGet);
+kvCommand.command("inspect <key>").description("Inspect metadata and value for a specific key in local KV namespace (dev mode)").option("--raw", "Output size in bytes only").option("--json", "Output metadata as JSON").option("--remote", "Use remote KV storage (not yet implemented)").option(
+  "--env <environment>",
+  "Environment to use with --remote: staging (default) or production"
+).action(runKVInspect);
+kvCommand.command("set <key> [value]").description("Set a key-value pair in local KV namespace (dev mode)").option("--raw", "Output minimal confirmation").option("--json", "Output result as JSON").option("--file <path>", "Read value from file").option("--remote", "Use remote KV storage (not yet implemented)").option(
+  "--env <environment>",
+  "Environment to use with --remote: staging (default) or production"
+).action(runKVSet);
+kvCommand.command("delete <key>").alias("del").alias("rm").description("Delete a specific key from local KV namespace (dev mode)").option("--raw", "Output minimal confirmation").option("--json", "Output result as JSON").option("--remote", "Use remote KV storage (not yet implemented)").option(
+  "--env <environment>",
+  "Environment to use with --remote: staging (default) or production"
+).action(runKVDelete);
+kvCommand.command("clear").description("Clear all keys from local KV namespace (dev mode)").option("--raw", "Output count of deleted keys").option("--json", "Output result as JSON").option("-f, --force", "Skip confirmation prompt").option("--remote", "Use remote KV storage (not yet implemented)").option(
+  "--env <environment>",
+  "Environment to use with --remote: staging (default) or production"
+).action(runKVClear);
+kvCommand.command("seed <file>").description("Seed KV namespace with key-value pairs from JSON file (dev mode)").option("--raw", "Output count of seeded keys").option("--json", "Output result as JSON").option("--replace", "Clear existing keys before seeding").option("-f, --force", "Skip confirmation prompt").option("--remote", "Use remote KV storage (not yet implemented)").option(
+  "--env <environment>",
+  "Environment to use with --remote: staging (default) or production"
+).action(runKVSeed);
+
+// src/commands/profiles/index.ts
+import { Command as Command19 } from "commander";
+
+// src/commands/profiles/list.ts
+init_string();
+import { Command as Command16 } from "commander";
+async function listProfilesAction() {
+  try {
+    const profilesMap = await listProfiles();
+    logger.newLine();
+    let hasAnyProfiles = false;
+    for (const [, profiles] of profilesMap.entries()) {
+      if (profiles.length > 0) {
+        hasAnyProfiles = true;
+        break;
+      }
+    }
+    if (!hasAnyProfiles) {
+      logger.warn("No authentication profiles found");
+      logger.newLine();
+      logger.admonition("tip", "Getting Started", [
+        "Run `playcademy login` to create your first profile"
+      ]);
+      logger.newLine();
+      return;
+    }
+    for (const [environment, profiles] of profilesMap.entries()) {
+      if (profiles.length === 0) continue;
+      const tableData = [];
+      for (const profileName of profiles) {
+        const profile = await getProfile(environment, profileName);
+        tableData.push({
+          Profile: profileName,
+          Email: profile?.email ?? ""
+        });
+      }
+      if (tableData.length > 0) {
+        const envTitle = capitalize(environment);
+        logger.table(tableData, envTitle);
+        logger.newLine();
+      }
+    }
+  } catch (error) {
+    logger.error(`Failed to list profiles: ${getErrorMessage(error)}`);
+    process.exit(1);
+  }
+}
+var listCommand2 = new Command16("list").alias("ls").description("List all stored authentication profiles").action(listProfilesAction);
+
+// src/commands/profiles/remove.ts
+import { bold as bold6 } from "colorette";
+import { Command as Command17 } from "commander";
+var removeCommand = new Command17("remove").alias("rm").description('Remove an authentication profile (defaults to "default")').argument("[name]", "Profile name to remove", "default").option("--env <environment>", "Environment to remove profile from (staging or production)").action(async (name, options) => {
+  const { env } = options;
+  const environment = ensureEnvironment(env, logger);
+  try {
+    logger.newLine();
+    const profilesMap = await listProfiles();
+    const envProfiles = profilesMap.get(environment) || [];
+    if (!envProfiles.includes(name)) {
+      logger.error(`Profile "${name}" not found in ${environment}`);
+      logger.newLine();
+      process.exit(1);
+    }
+    await removeProfile(environment, name);
+    logger.admonition("note", "Removed!", [
+      `Profile ${bold6(name)} removed from ${environment}`,
+      environment === "production" ? `To re-authenticate run \`playcademy login --env ${environment}\`` : "To re-authenticate run `playcademy login`"
+    ]);
+    logger.newLine();
+  } catch (error) {
+    logAndExit(error, logger, { prefix: "Failed to remove profile" });
+  }
+});
+
+// src/commands/profiles/reset.ts
+init_string();
+import { confirm as confirm9 } from "@inquirer/prompts";
+import { Command as Command18 } from "commander";
+var resetCommand = new Command18("reset").description(
+  "Remove all authentication profiles across all environments (requires confirmation)"
+).alias("clear").action(async () => {
+  try {
+    const profilesMap = await listProfiles();
+    let totalProfiles = 0;
+    for (const profiles of profilesMap.values()) {
+      totalProfiles += profiles.length;
+    }
+    if (totalProfiles === 0) {
+      logger.newLine();
+      logger.warn("No authentication profiles found");
+      logger.newLine();
+      return;
+    }
+    logger.newLine();
+    logger.warn(
       `This will remove ${totalProfiles} authentication ${pluralize(totalProfiles, "profile")} across all environments:`
     );
     logger.newLine();
@@ -9044,7 +10155,7 @@ var resetCommand = new Command17("reset").description(
         logger.newLine();
       }
     }
-    const confirmed = await confirm7({
+    const confirmed = await confirm9({
       message: "Are you sure you want to remove all profiles?",
       default: false
     });
@@ -9082,19 +10193,19 @@ var resetCommand = new Command17("reset").description(
 });
 
 // src/commands/profiles/index.ts
-var profilesCommand = new Command18("profiles").description("Manage authentication profiles").action(listProfilesAction);
+var profilesCommand = new Command19("profiles").description("Manage authentication profiles").action(listProfilesAction);
 profilesCommand.addCommand(listCommand2);
 profilesCommand.addCommand(removeCommand);
 profilesCommand.addCommand(resetCommand);
 
 // src/commands/timeback/index.ts
-import { Command as Command24 } from "commander";
+import { Command as Command25 } from "commander";
 
 // src/commands/timeback/cleanup.ts
 init_src();
-import { confirm as confirm8 } from "@inquirer/prompts";
-import { Command as Command19 } from "commander";
-var cleanupCommand = new Command19("cleanup").description("Remove TimeBack integration for your game").option(
+import { confirm as confirm10 } from "@inquirer/prompts";
+import { Command as Command20 } from "commander";
+var cleanupCommand = new Command20("cleanup").description("Remove TimeBack integration for your game").option(
   "--env <environment>",
   "Environment to remove TimeBack integration from (staging or production)"
 ).action(async (options) => {
@@ -9116,7 +10227,7 @@ var cleanupCommand = new Command19("cleanup").description("Remove TimeBack integ
       return;
     }
     displayCleanupWarning(integration, game.displayName, logger);
-    const confirmed = await confirm8({
+    const confirmed = await confirm10({
       message: "Are you sure you want to remove TimeBack integration?",
       default: false
     });
@@ -9145,8 +10256,8 @@ var cleanupCommand = new Command19("cleanup").description("Remove TimeBack integ
 });
 
 // src/commands/timeback/init.ts
-import { Command as Command20 } from "commander";
-var initCommand2 = new Command20("init").description("Add TimeBack integration to your project").action(async () => {
+import { Command as Command21 } from "commander";
+var initCommand2 = new Command21("init").description("Add TimeBack integration to your project").action(async () => {
   try {
     logger.newLine();
     const configPath = await findConfigPath().catch(() => {
@@ -9199,8 +10310,8 @@ var initCommand2 = new Command20("init").description("Add TimeBack integration t
 
 // src/commands/timeback/setup.ts
 init_src();
-import { Command as Command21 } from "commander";
-var setupCommand = new Command21("setup").description("Set up TimeBack integration for your game").option("--dry-run", "Validate configuration without creating resources").option("--verbose, -v", "Output detailed information").option(
+import { Command as Command22 } from "commander";
+var setupCommand = new Command22("setup").description("Set up TimeBack integration for your game").option("--dry-run", "Validate configuration without creating resources").option("--verbose, -v", "Output detailed information").option(
   "--env <environment>",
   "Environment to set up TimeBack integration in (staging or production)"
 ).action(async (options) => {
@@ -9292,10 +10403,10 @@ var setupCommand = new Command21("setup").description("Set up TimeBack integrati
 // src/commands/timeback/update.ts
 init_src();
 init_string();
-import { confirm as confirm9 } from "@inquirer/prompts";
+import { confirm as confirm11 } from "@inquirer/prompts";
 import { green as green4, red as red3 } from "colorette";
-import { Command as Command22 } from "commander";
-var updateCommand = new Command22("update").description("Update TimeBack integration configuration for your game").option("--verbose, -v", "Output detailed information").option(
+import { Command as Command23 } from "commander";
+var updateCommand = new Command23("update").description("Update TimeBack integration configuration for your game").option("--verbose, -v", "Output detailed information").option(
   "--env <environment>",
   "Environment to update TimeBack integration in (staging or production)"
 ).action(async (options) => {
@@ -9373,7 +10484,7 @@ var updateCommand = new Command22("update").description("Update TimeBack integra
       logger.data(change.label, `${red3(change.current)} \u2192 ${green4(change.next)}`, 1);
     }
     logger.newLine();
-    const confirmed = await confirm9({
+    const confirmed = await confirm11({
       message: `Update ${changeDetails.length} ${pluralize(changeDetails.length, "field")} in TimeBack?`,
       default: false
     });
@@ -9413,8 +10524,8 @@ var updateCommand = new Command22("update").description("Update TimeBack integra
 
 // src/commands/timeback/verify.ts
 init_src();
-import { Command as Command23 } from "commander";
-var verifyCommand = new Command23("verify").description("Verify TimeBack integration for your game").option("--verbose, -v", "Output detailed resource information").option(
+import { Command as Command24 } from "commander";
+var verifyCommand = new Command24("verify").description("Verify TimeBack integration for your game").option("--verbose, -v", "Output detailed resource information").option(
   "--env <environment>",
   "Environment to verify TimeBack integration in (staging or production)"
 ).action(async (options) => {
@@ -9464,7 +10575,7 @@ var verifyCommand = new Command23("verify").description("Verify TimeBack integra
 });
 
 // src/commands/timeback/index.ts
-var timebackCommand = new Command24("timeback").description(
+var timebackCommand = new Command25("timeback").description(
   "TimeBack integration management"
 );
 timebackCommand.addCommand(initCommand2);
@@ -9474,15 +10585,15 @@ timebackCommand.addCommand(verifyCommand);
 timebackCommand.addCommand(cleanupCommand);
 
 // src/commands/debug/index.ts
-import { Command as Command26 } from "commander";
+import { Command as Command27 } from "commander";
 
 // src/commands/debug/bundle.ts
 init_src();
 init_constants2();
-import { writeFileSync as writeFileSync8 } from "fs";
-import { join as join19 } from "path";
-import { Command as Command25 } from "commander";
-var bundleCommand = new Command25("bundle").description("Bundle and inspect the game backend worker code (for debugging)").option("-o, --output <path>", "Output file path", CLI_DEFAULT_OUTPUTS.WORKER_BUNDLE).option("--minify", "Minify the output").option("--sourcemap", "Include source maps").action(async (options) => {
+import { writeFileSync as writeFileSync7 } from "fs";
+import { join as join28 } from "path";
+import { Command as Command26 } from "commander";
+var bundleCommand = new Command26("bundle").description("Bundle and inspect the game backend worker code (for debugging)").option("-o, --output <path>", "Output file path", CLI_DEFAULT_OUTPUTS.WORKER_BUNDLE).option("--minify", "Minify the output").option("--sourcemap", "Include source maps").action(async (options) => {
   try {
     const workspace = getWorkspace();
     logger.newLine();
@@ -9510,8 +10621,8 @@ var bundleCommand = new Command25("bundle").description("Bundle and inspect the
       }),
       (result) => `Bundled ${formatSize(result.code.length)}`
     );
-    const outputPath = join19(workspace, options.output);
-    writeFileSync8(outputPath, bundle.code, "utf-8");
+    const outputPath = join28(workspace, options.output);
+    writeFileSync7(outputPath, bundle.code, "utf-8");
     logger.success(`Bundle saved to ${options.output}`);
     logger.newLine();
     logger.highlight("Bundle Analysis");
@@ -9551,7 +10662,7 @@ var bundleCommand = new Command25("bundle").description("Bundle and inspect the
 });
 
 // src/commands/debug/index.ts
-var debugCommand = new Command26("debug").description("Debug and inspect game builds").addCommand(bundleCommand);
+var debugCommand = new Command27("debug").description("Debug and inspect game builds").addCommand(bundleCommand);
 
 // src/index.ts
 var __dirname = dirname4(fileURLToPath2(import.meta.url));
@@ -9568,6 +10679,7 @@ program.addCommand(meCommand);
 program.addCommand(devCommand);
 program.addCommand(apiCommand);
 program.addCommand(dbCommand);
+program.addCommand(kvCommand);
 program.addCommand(gamesCommand);
 program.addCommand(deployCommand);
 program.addCommand(timebackCommand);
@@ -9607,6 +10719,7 @@ export {
   displaySuccessMessage,
   ensureEnvironment,
   ensureGameExists,
+  ensurePlaycademyGitignore,
   findConfigPath,
   formatSize,
   generateEntryCode,
@@ -9627,6 +10740,7 @@ export {
   getDeployedGame,
   getDeploymentId,
   getDevServerPidPath,
+  getDrizzleKitApiExports,
   getEnvironment,
   getErrorMessage,
   getGameFromConfig,
@@ -9647,6 +10761,7 @@ export {
   hasCustomRoutes,
   hasCustomRoutesChanged,
   hasDatabaseSetup,
+  hasKVSetup,
   hasLocalCustomRoutes,
   hasMandatoryFieldsMissing,
   hasOptionalFieldsMissing,