tthr 0.0.34 → 0.0.35

package/dist/chunk-LXODXQ5V.js

@@ -0,0 +1,418 @@
+// src/commands/generate.ts
+import chalk2 from "chalk";
+import ora from "ora";
+import fs3 from "fs-extra";
+import path3 from "path";
+
+// src/utils/auth.ts
+import chalk from "chalk";
+import fs from "fs-extra";
+import path from "path";
+var CONFIG_DIR = path.join(process.env.HOME || process.env.USERPROFILE || "", ".tether");
+var CREDENTIALS_FILE = path.join(CONFIG_DIR, "credentials.json");
+async function getCredentials() {
+  try {
+    if (await fs.pathExists(CREDENTIALS_FILE)) {
+      return await fs.readJSON(CREDENTIALS_FILE);
+    }
+  } catch {
+  }
+  return null;
+}
+async function requireAuth() {
+  const credentials = await getCredentials();
+  if (!credentials) {
+    console.error(chalk.red("\n\u2717 Not logged in\n"));
+    console.log(chalk.dim("Run `tthr login` to authenticate\n"));
+    process.exit(1);
+  }
+  if (credentials.expiresAt) {
+    const expiresAt = new Date(credentials.expiresAt);
+    if (/* @__PURE__ */ new Date() > expiresAt) {
+      console.error(chalk.red("\n\u2717 Session expired\n"));
+      console.log(chalk.dim("Run `tthr login` to authenticate\n"));
+      process.exit(1);
+    }
+  }
+  return credentials;
+}
+async function saveCredentials(credentials) {
+  await fs.ensureDir(CONFIG_DIR);
+  await fs.writeJSON(CREDENTIALS_FILE, credentials, { spaces: 2, mode: 384 });
+}
+async function clearCredentials() {
+  try {
+    await fs.remove(CREDENTIALS_FILE);
+  } catch {
+  }
+}
+
+// src/utils/config.ts
+import fs2 from "fs-extra";
+import path2 from "path";
+var DEFAULT_CONFIG = {
+  schema: "./tether/schema.ts",
+  functions: "./tether/functions",
+  output: "./tether/_generated",
+  dev: {
+    port: 3001,
+    host: "localhost"
+  },
+  database: {
+    walMode: true
+  }
+};
+async function loadConfig(cwd = process.cwd()) {
+  const configPath = path2.resolve(cwd, "tether.config.ts");
+  if (!await fs2.pathExists(configPath)) {
+    return DEFAULT_CONFIG;
+  }
+  const configSource = await fs2.readFile(configPath, "utf-8");
+  const config = {};
+  const schemaMatch = configSource.match(/schema\s*:\s*['"]([^'"]+)['"]/);
+  if (schemaMatch) {
+    config.schema = schemaMatch[1];
+  }
+  const functionsMatch = configSource.match(/functions\s*:\s*['"]([^'"]+)['"]/);
+  if (functionsMatch) {
+    config.functions = functionsMatch[1];
+  }
+  const outputMatch = configSource.match(/output\s*:\s*['"]([^'"]+)['"]/);
+  if (outputMatch) {
+    config.output = outputMatch[1];
+  }
+  const envMatch = configSource.match(/environment\s*:\s*['"]([^'"]+)['"]/);
+  if (envMatch) {
+    config.environment = envMatch[1];
+  }
+  const portMatch = configSource.match(/port\s*:\s*(\d+)/);
+  if (portMatch) {
+    config.dev = { ...config.dev, port: parseInt(portMatch[1], 10) };
+  }
+  const hostMatch = configSource.match(/host\s*:\s*['"]([^'"]+)['"]/);
+  if (hostMatch) {
+    config.dev = { ...config.dev, host: hostMatch[1] };
+  }
+  return {
+    ...DEFAULT_CONFIG,
+    ...config,
+    dev: { ...DEFAULT_CONFIG.dev, ...config.dev },
+    database: { ...DEFAULT_CONFIG.database, ...config.database }
+  };
+}
+function resolvePath(configPath, cwd = process.cwd()) {
+  const normalised = configPath.replace(/^\.\//, "");
+  return path2.resolve(cwd, normalised);
+}
+async function detectFramework(cwd = process.cwd()) {
+  const packageJsonPath = path2.resolve(cwd, "package.json");
+  if (!await fs2.pathExists(packageJsonPath)) {
+    return "unknown";
+  }
+  try {
+    const packageJson = await fs2.readJson(packageJsonPath);
+    const deps = {
+      ...packageJson.dependencies,
+      ...packageJson.devDependencies
+    };
+    if (deps.nuxt || deps["@nuxt/kit"]) {
+      return "nuxt";
+    }
+    if (deps.next) {
+      return "next";
+    }
+    if (deps["@sveltejs/kit"]) {
+      return "sveltekit";
+    }
+    if (deps.vite && !deps.nuxt && !deps.next && !deps["@sveltejs/kit"]) {
+      return "vite";
+    }
+    return "vanilla";
+  } catch {
+    return "unknown";
+  }
+}
+function getFrameworkDevCommand(framework) {
+  switch (framework) {
+    case "nuxt":
+      return "nuxt dev";
+    case "next":
+      return "next dev";
+    case "sveltekit":
+      return "vite dev";
+    case "vite":
+      return "vite dev";
+    case "vanilla":
+      return null;
+    // No default dev server for vanilla
+    default:
+      return null;
+  }
+}
+
+// src/commands/generate.ts
+function parseSchemaFile(source) {
+  const tables = [];
+  const schemaMatch = source.match(/defineSchema\s*\(\s*\{([\s\S]*)\}\s*\)/);
+  if (!schemaMatch) return tables;
+  const schemaContent = schemaMatch[1];
+  const tableStartRegex = /(\w+)\s*:\s*\{/g;
+  let match;
+  while ((match = tableStartRegex.exec(schemaContent)) !== null) {
+    const tableName = match[1];
+    const startOffset = match.index + match[0].length;
+    let braceCount = 1;
+    let endOffset = startOffset;
+    for (let i = startOffset; i < schemaContent.length && braceCount > 0; i++) {
+      const char = schemaContent[i];
+      if (char === "{") braceCount++;
+      else if (char === "}") braceCount--;
+      endOffset = i;
+    }
+    const columnsContent = schemaContent.slice(startOffset, endOffset);
+    const columns = parseColumns(columnsContent);
+    tables.push({ name: tableName, columns });
+  }
+  return tables;
+}
+function parseColumns(content) {
+  const columns = [];
+  const columnRegex = /(\w+)\s*:\s*(\w+)\s*\(\s*\)([^,\n}]*)/g;
+  let match;
+  while ((match = columnRegex.exec(content)) !== null) {
+    const name = match[1];
+    const schemaType = match[2];
+    const modifiers = match[3] || "";
+    const nullable = !modifiers.includes(".notNull()") && !modifiers.includes(".primaryKey()");
+    const primaryKey = modifiers.includes(".primaryKey()");
+    columns.push({
+      name,
+      type: schemaTypeToTS(schemaType),
+      nullable,
+      primaryKey
+    });
+  }
+  return columns;
+}
+function schemaTypeToTS(schemaType) {
+  switch (schemaType) {
+    case "text":
+      return "string";
+    case "integer":
+      return "number";
+    case "real":
+      return "number";
+    case "boolean":
+      return "boolean";
+    case "timestamp":
+      return "string";
+    case "json":
+      return "unknown";
+    case "blob":
+      return "Uint8Array";
+    default:
+      return "unknown";
+  }
+}
+function tableNameToInterface(tableName) {
+  let name = tableName;
+  if (name.endsWith("ies")) {
+    name = name.slice(0, -3) + "y";
+  } else if (name.endsWith("s") && !name.endsWith("ss")) {
+    name = name.slice(0, -1);
+  }
+  return name.charAt(0).toUpperCase() + name.slice(1);
+}
+function generateDbFile(tables) {
+  const lines = [
+    "// Auto-generated by Tether CLI - do not edit manually",
+    `// Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    "",
+    "import { createDatabaseProxy, type TetherDatabase } from '@tthr/client';",
+    ""
+  ];
+  for (const table of tables) {
+    const interfaceName = tableNameToInterface(table.name);
+    lines.push(`export interface ${interfaceName} {`);
+    for (const col of table.columns) {
+      const typeStr = col.nullable ? `${col.type} | null` : col.type;
+      lines.push(`  ${col.name}: ${typeStr};`);
+    }
+    lines.push("}");
+    lines.push("");
+  }
+  lines.push("export interface Schema {");
+  for (const table of tables) {
+    const interfaceName = tableNameToInterface(table.name);
+    lines.push(`  ${table.name}: ${interfaceName};`);
+  }
+  lines.push("}");
+  lines.push("");
+  lines.push("// Database client with typed tables");
+  lines.push("// This is a proxy that will be populated by the Tether runtime");
+  lines.push("export const db: TetherDatabase<Schema> = createDatabaseProxy<Schema>();");
+  lines.push("");
+  return lines.join("\n");
+}
+async function parseFunctionsDir(functionsDir) {
+  const functions = [];
+  if (!await fs3.pathExists(functionsDir)) {
+    return functions;
+  }
+  const files = await fs3.readdir(functionsDir);
+  for (const file of files) {
+    if (!file.endsWith(".ts") && !file.endsWith(".js")) continue;
+    const filePath = path3.join(functionsDir, file);
+    const stat = await fs3.stat(filePath);
+    if (!stat.isFile()) continue;
+    const moduleName = file.replace(/\.(ts|js)$/, "");
+    const source = await fs3.readFile(filePath, "utf-8");
+    const exportRegex = /export\s+const\s+(\w+)\s*=\s*(query|mutation|action)\s*\(/g;
+    let match;
+    while ((match = exportRegex.exec(source)) !== null) {
+      functions.push({
+        name: match[1],
+        moduleName
+      });
+    }
+  }
+  return functions;
+}
+async function generateApiFile(functionsDir) {
+  const functions = await parseFunctionsDir(functionsDir);
+  const moduleMap = /* @__PURE__ */ new Map();
+  for (const fn of functions) {
+    if (!moduleMap.has(fn.moduleName)) {
+      moduleMap.set(fn.moduleName, []);
+    }
+    moduleMap.get(fn.moduleName).push(fn.name);
+  }
+  const lines = [
+    "// Auto-generated by Tether CLI - do not edit manually",
+    `// Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    "",
+    "import { createApiProxy } from '@tthr/client';",
+    "",
+    "/**",
+    " * API function reference type for useQuery/useMutation.",
+    ' * The _name property contains the function path (e.g., "users.list").',
+    " */",
+    "export interface ApiFunction<TArgs = unknown, TResult = unknown> {",
+    "  _name: string;",
+    "  _args?: TArgs;",
+    "  _result?: TResult;",
+    "}",
+    ""
+  ];
+  if (moduleMap.size > 0) {
+    for (const [moduleName, fnNames] of moduleMap) {
+      const interfaceName = moduleName.charAt(0).toUpperCase() + moduleName.slice(1) + "Api";
+      lines.push(`export interface ${interfaceName} {`);
+      for (const fnName of fnNames) {
+        lines.push(`  ${fnName}: ApiFunction;`);
+      }
+      lines.push("}");
+      lines.push("");
+    }
+    lines.push("export interface Api {");
+    for (const moduleName of moduleMap.keys()) {
+      const interfaceName = moduleName.charAt(0).toUpperCase() + moduleName.slice(1) + "Api";
+      lines.push(`  ${moduleName}: ${interfaceName};`);
+    }
+    lines.push("}");
+  } else {
+    lines.push("/**");
+    lines.push(" * Flexible API type that allows access to any function path.");
+    lines.push(" * Functions are accessed as api.moduleName.functionName");
+    lines.push(" * The actual types depend on your function definitions.");
+    lines.push(" */");
+    lines.push("export type Api = {");
+    lines.push("  [module: string]: {");
+    lines.push("    [fn: string]: ApiFunction;");
+    lines.push("  };");
+    lines.push("};");
+  }
+  lines.push("");
+  lines.push("// API client proxy - provides typed access to your functions");
+  lines.push("// On the client: returns { _name } references for useQuery/useMutation");
+  lines.push("// In Tether functions: calls the actual function implementation");
+  lines.push("export const api = createApiProxy<Api>();");
+  lines.push("");
+  return lines.join("\n");
+}
+async function generateTypes(options = {}) {
+  const config = await loadConfig();
+  const schemaPath = resolvePath(config.schema);
+  const outputDir = resolvePath(config.output);
+  const functionsDir = resolvePath(config.functions);
+  if (!await fs3.pathExists(schemaPath)) {
+    throw new Error(`Schema file not found: ${schemaPath}`);
+  }
+  const schemaSource = await fs3.readFile(schemaPath, "utf-8");
+  const tables = parseSchemaFile(schemaSource);
+  await fs3.ensureDir(outputDir);
+  await fs3.writeFile(
+    path3.join(outputDir, "db.ts"),
+    generateDbFile(tables)
+  );
+  await fs3.writeFile(
+    path3.join(outputDir, "api.ts"),
+    await generateApiFile(functionsDir)
+  );
+  await fs3.writeFile(
+    path3.join(outputDir, "index.ts"),
+    `// Auto-generated by Tether CLI - do not edit manually
+export * from './db';
+export * from './api';
+`
+  );
+  return { tables, outputDir };
+}
+async function generateCommand() {
+  await requireAuth();
+  const configPath = path3.resolve(process.cwd(), "tether.config.ts");
+  if (!await fs3.pathExists(configPath)) {
+    console.log(chalk2.red("\nError: Not a Tether project"));
+    console.log(chalk2.dim("Run `tthr init` to create a new project\n"));
+    process.exit(1);
+  }
+  console.log(chalk2.bold("\n\u26A1 Generating types from schema\n"));
+  const spinner = ora("Reading schema...").start();
+  try {
+    spinner.text = "Generating types...";
+    const { tables, outputDir } = await generateTypes();
+    if (tables.length === 0) {
+      spinner.warn("No tables found in schema");
+      console.log(chalk2.dim("  Make sure your schema uses defineSchema({ ... })\n"));
+      return;
+    }
+    spinner.succeed(`Types generated for ${tables.length} table(s)`);
+    console.log("\n" + chalk2.green("\u2713") + " Tables:");
+    for (const table of tables) {
+      console.log(chalk2.dim(`  - ${table.name} (${table.columns.length} columns)`));
+    }
+    const relativeOutput = path3.relative(process.cwd(), outputDir);
+    console.log("\n" + chalk2.green("\u2713") + " Generated files:");
+    console.log(chalk2.dim(`  ${relativeOutput}/db.ts`));
+    console.log(chalk2.dim(`  ${relativeOutput}/api.ts`));
+    console.log(chalk2.dim(`  ${relativeOutput}/index.ts
+`));
+  } catch (error) {
+    spinner.fail("Failed to generate types");
+    console.error(chalk2.red(error instanceof Error ? error.message : "Unknown error"));
+    process.exit(1);
+  }
+}
+
+export {
+  getCredentials,
+  requireAuth,
+  saveCredentials,
+  clearCredentials,
+  loadConfig,
+  resolvePath,
+  detectFramework,
+  getFrameworkDevCommand,
+  generateTypes,
+  generateCommand
+};

package/dist/generate-YQ4QRPXF.js

@@ -0,0 +1,8 @@
+import {
+  generateCommand,
+  generateTypes
+} from "./chunk-LXODXQ5V.js";
+export {
+  generateCommand,
+  generateTypes
+};

package/dist/index.js

@@ -9,7 +9,7 @@ import {
   requireAuth,
   resolvePath,
   saveCredentials
-} from "./chunk-ZWLVHKNL.js";
+} from "./chunk-LXODXQ5V.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -49,8 +49,10 @@ async function deployCommand(options) {
     console.log(chalk.dim("Make sure TETHER_PROJECT_ID is set in your .env file\n"));
     process.exit(1);
   }
+  const environment = options.env || "development";
   console.log(chalk.bold("\n\u26A1 Deploying to Tether\n"));
   console.log(chalk.dim(`  Project: ${projectId}`));
+  console.log(chalk.dim(`  Environment: ${environment}`));
   console.log(chalk.dim(`  API: ${API_URL}
 `));
   const config = await loadConfig();
@@ -58,15 +60,15 @@ async function deployCommand(options) {
   const deployFunctions = options.functions || !options.schema && !options.functions;
   if (deploySchema) {
     const schemaPath = resolvePath(config.schema);
-    await deploySchemaToServer(projectId, credentials.accessToken, schemaPath, options.dryRun);
+    await deploySchemaToServer(projectId, credentials.accessToken, schemaPath, environment, options.dryRun);
   }
   if (deployFunctions) {
     const functionsDir = resolvePath(config.functions);
-    await deployFunctionsToServer(projectId, credentials.accessToken, functionsDir, options.dryRun);
+    await deployFunctionsToServer(projectId, credentials.accessToken, functionsDir, environment, options.dryRun);
   }
   console.log(chalk.green("\n\u2713 Deployment complete\n"));
 }
-async function deploySchemaToServer(projectId, token, schemaPath, dryRun) {
+async function deploySchemaToServer(projectId, token, schemaPath, environment, dryRun) {
   const spinner = ora("Reading schema...").start();
   try {
     if (!await fs.pathExists(schemaPath)) {
@@ -90,7 +92,8 @@ async function deploySchemaToServer(projectId, token, schemaPath, dryRun) {
       return;
     }
     spinner.text = "Deploying schema...";
-    const response = await fetch(`${API_URL}/projects/${projectId}/deploy/schema`, {
+    const envPath = environment !== "production" ? `/env/${environment}` : "";
+    const response = await fetch(`${API_URL}/projects/${projectId}${envPath}/deploy/schema`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -115,7 +118,7 @@ async function deploySchemaToServer(projectId, token, schemaPath, dryRun) {
     console.error(chalk.red(error instanceof Error ? error.message : "Unknown error"));
   }
 }
-async function deployFunctionsToServer(projectId, token, functionsDir, dryRun) {
+async function deployFunctionsToServer(projectId, token, functionsDir, environment, dryRun) {
   const spinner = ora("Reading functions...").start();
   try {
     if (!await fs.pathExists(functionsDir)) {
@@ -149,7 +152,8 @@ async function deployFunctionsToServer(projectId, token, functionsDir, dryRun) {
       return;
     }
     spinner.text = "Deploying functions...";
-    const response = await fetch(`${API_URL}/projects/${projectId}/deploy/functions`, {
+    const envPath = environment !== "production" ? `/env/${environment}` : "";
+    const response = await fetch(`${API_URL}/projects/${projectId}${envPath}/deploy/functions`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -235,15 +239,42 @@ function parseSchema(source) {
       const colName = colMatch[1];
       const colType = colMatch[2];
       const modifiers = colMatch[3];
+      if (colName === "_id" || colName === "_createdAt") {
+        console.warn(`Warning: Column '${colName}' is a reserved system column and will be ignored.`);
+        continue;
+      }
+      const userWantsPrimaryKey = modifiers.includes(".primaryKey()");
+      if (userWantsPrimaryKey) {
+        console.warn(`Warning: Column '${colName}' has .primaryKey() which will be ignored. Tether uses '_id' as the primary key.`);
+      }
       columns[colName] = {
         type: colType,
-        primaryKey: modifiers.includes(".primaryKey()"),
+        primaryKey: false,
+        // _id is always the primary key, ignore user-defined primary keys
         notNull: modifiers.includes(".notNull()"),
-        unique: modifiers.includes(".unique()"),
+        unique: modifiers.includes(".unique()") || userWantsPrimaryKey,
+        // Make it unique if they wanted PK
         hasDefault: modifiers.includes(".default("),
         references: modifiers.match(/\.references\s*\(\s*['"]([^'"]+)['"]\s*\)/)?.[1]
       };
     }
+    columns["_id"] = {
+      type: "text",
+      primaryKey: true,
+      notNull: true,
+      unique: true,
+      // Also set unique so ALTER TABLE adds UNIQUE constraint
+      hasDefault: false,
+      isSystemColumn: true
+    };
+    columns["_createdAt"] = {
+      type: "timestamp",
+      primaryKey: false,
+      notNull: true,
+      unique: false,
+      hasDefault: true,
+      isSystemColumn: true
+    };
     tables.push({ name: tableName, columns, source: tableSource });
   }
   return tables;
@@ -271,9 +302,10 @@ function getColumnSqlType(type) {
 function buildColumnSql(colName, def, forAlterTable = false) {
   const sqlType = getColumnSqlType(def.type);
   let colSql = `${colName} ${sqlType}`;
-  if (def.primaryKey) colSql += " PRIMARY KEY";
+  const addingPrimaryKey = def.primaryKey && !forAlterTable;
+  if (addingPrimaryKey) colSql += " PRIMARY KEY";
   if (def.notNull && !forAlterTable) colSql += " NOT NULL";
-  if (def.unique) colSql += " UNIQUE";
+  if (def.unique && !addingPrimaryKey) colSql += " UNIQUE";
   if (def.hasDefault && def.type === "timestamp") {
     colSql += " DEFAULT (datetime('now'))";
   }
@@ -298,7 +330,6 @@ function generateSchemaSQL(tables) {
     );
     for (const [colName, colDef] of Object.entries(table.columns)) {
       const def = colDef;
-      if (def.primaryKey) continue;
       const alterColSql = buildColumnSql(colName, def, true);
       statements.push(
         `-- Add column if missing (will error if exists, which is OK)
@@ -1020,8 +1051,8 @@ PUBLIC_TETHER_PROJECT_ID=\${TETHER_PROJECT_ID}
     }
   }
 }
-function getInstallCommand(pm, isDev5 = false) {
-  const devFlag = isDev5 ? pm === "npm" ? "-D" : pm === "yarn" ? "-D" : pm === "pnpm" ? "-D" : "-d" : "";
+function getInstallCommand(pm, isDev6 = false) {
+  const devFlag = isDev6 ? pm === "npm" ? "-D" : pm === "yarn" ? "-D" : pm === "pnpm" ? "-D" : "-d" : "";
   return `${pm} ${pm === "npm" ? "install" : "add"} ${devFlag}`.trim();
 }
 async function installTetherPackages(projectPath, template, packageManager) {
@@ -1478,7 +1509,7 @@ async function runGenerate(spinner) {
   }
   isGenerating = true;
   try {
-    const { generateTypes } = await import("./generate-26HERX3T.js");
+    const { generateTypes } = await import("./generate-YQ4QRPXF.js");
     spinner.text = "Regenerating types...";
     await generateTypes({ silent: true });
     spinner.succeed("Types regenerated");
@@ -1618,14 +1649,17 @@ async function devCommand(options) {
   const functionsDir = resolvePath(config.functions);
   const outputDir = resolvePath(config.output);
   const framework = config.framework || await detectFramework();
-  const devCommand2 = config.dev?.command || getFrameworkDevCommand(framework);
+  const devCmd = config.dev?.command || getFrameworkDevCommand(framework);
+  const environment = options.env || config.environment || "development";
+  const isLocal = options.local ?? false;
   console.log(chalk3.bold("\n\u26A1 Starting Tether development server\n"));
   if (framework !== "unknown") {
     console.log(chalk3.dim(`  Framework: ${framework}`));
   }
-  if (devCommand2) {
-    console.log(chalk3.dim(`  Dev command: ${devCommand2}`));
+  if (devCmd) {
+    console.log(chalk3.dim(`  Dev command: ${devCmd}`));
   }
+  console.log(chalk3.dim(`  Environment: ${environment}${isLocal ? " (local)" : " (cloud)"}`));
   console.log(chalk3.dim(`  Schema: ${path3.relative(process.cwd(), schemaPath)}`));
   console.log(chalk3.dim(`  Functions: ${path3.relative(process.cwd(), functionsDir)}`));
   console.log(chalk3.dim(`  Output: ${path3.relative(process.cwd(), outputDir)}`));
@@ -1656,7 +1690,7 @@ async function devCommand(options) {
       }
     }
     spinner.text = "Generating types...";
-    const { generateTypes } = await import("./generate-26HERX3T.js");
+    const { generateTypes } = await import("./generate-YQ4QRPXF.js");
     await generateTypes({ silent: true });
     spinner.succeed("Types generated");
     spinner.start("Setting up file watchers...");
@@ -1700,9 +1734,9 @@ async function devCommand(options) {
       });
     }
     spinner.succeed("File watchers ready");
-    if (devCommand2 && !options.skipFramework) {
+    if (devCmd && !options.skipFramework) {
       spinner.start(`Starting ${framework} dev server...`);
-      frameworkProcess = startFrameworkDev(devCommand2, port, spinner);
+      frameworkProcess = startFrameworkDev(devCmd, port, spinner);
     } else {
       spinner.start("Watching for changes...");
       console.log("\n" + chalk3.cyan(`  Tether dev ready`));
@@ -1904,18 +1938,18 @@ function detectPackageManager() {
   }
   return "npm";
 }
-function getInstallCommand2(pm, packages, isDev5) {
+function getInstallCommand2(pm, packages, isDev6) {
   const packagesStr = packages.join(" ");
   switch (pm) {
     case "bun":
-      return isDev5 ? `bun add -d ${packagesStr}` : `bun add ${packagesStr}`;
+      return isDev6 ? `bun add -d ${packagesStr}` : `bun add ${packagesStr}`;
     case "pnpm":
-      return isDev5 ? `pnpm add -D ${packagesStr}` : `pnpm add ${packagesStr}`;
+      return isDev6 ? `pnpm add -D ${packagesStr}` : `pnpm add ${packagesStr}`;
     case "yarn":
-      return isDev5 ? `yarn add -D ${packagesStr}` : `yarn add ${packagesStr}`;
+      return isDev6 ? `yarn add -D ${packagesStr}` : `yarn add ${packagesStr}`;
     case "npm":
     default:
-      return isDev5 ? `npm install -D ${packagesStr}` : `npm install ${packagesStr}`;
+      return isDev6 ? `npm install -D ${packagesStr}` : `npm install ${packagesStr}`;
   }
 }
 async function getLatestVersion2(packageName) {
@@ -2088,16 +2122,182 @@ async function execCommand(sql) {
   }
 }
 
+// src/commands/env.ts
+import chalk7 from "chalk";
+import ora7 from "ora";
+import fs6 from "fs-extra";
+import path6 from "path";
+var isDev5 = process.env.NODE_ENV === "development" || process.env.TETHER_DEV === "true";
+var API_URL5 = isDev5 ? "http://localhost:3001/api/v1" : "https://tether-api.strands.gg/api/v1";
+async function getProjectId() {
+  const envPath = path6.resolve(process.cwd(), ".env");
+  let projectId;
+  if (await fs6.pathExists(envPath)) {
+    const envContent = await fs6.readFile(envPath, "utf-8");
+    const match = envContent.match(/TETHER_PROJECT_ID=(.+)/);
+    projectId = match?.[1]?.trim();
+  }
+  if (!projectId) {
+    console.log(chalk7.red("\nError: Project ID not found"));
+    console.log(chalk7.dim("Make sure TETHER_PROJECT_ID is set in your .env file\n"));
+    process.exit(1);
+  }
+  return projectId;
+}
+async function envListCommand() {
+  const credentials = await requireAuth();
+  const projectId = await getProjectId();
+  const spinner = ora7("Fetching environments...").start();
+  try {
+    const response = await fetch(`${API_URL5}/projects/${projectId}/environments`, {
+      headers: {
+        "Authorization": `Bearer ${credentials.accessToken}`
+      }
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Unknown error" }));
+      throw new Error(error.error || `HTTP ${response.status}`);
+    }
+    const data = await response.json();
+    spinner.succeed(`Found ${data.environments.length} environment(s)`);
+    console.log();
+    for (const env2 of data.environments) {
+      const isDefault = env2.name === data.defaultEnvironment;
+      const colour = getEnvColour(env2.name);
+      const defaultBadge = isDefault ? chalk7.yellow(" \u2605 default") : "";
+      console.log(`  ${chalk7.hex(colour)("\u25CF")} ${chalk7.bold(env2.name)}${defaultBadge}`);
+      console.log(chalk7.dim(`    API Key: ${maskApiKey(env2.apiKey)}`));
+      console.log(chalk7.dim(`    Created: ${new Date(env2.createdAt).toLocaleDateString()}`));
+      console.log();
+    }
+  } catch (error) {
+    spinner.fail("Failed to fetch environments");
+    console.error(chalk7.red(error instanceof Error ? error.message : "Unknown error"));
+    process.exit(1);
+  }
+}
+async function envCreateCommand(name, options) {
+  const credentials = await requireAuth();
+  const projectId = await getProjectId();
+  const normalizedName = name.toLowerCase();
+  if (!/^[a-z][a-z0-9-_]*$/.test(normalizedName)) {
+    console.log(chalk7.red("\nError: Invalid environment name"));
+    console.log(chalk7.dim("Name must start with a letter and contain only letters, numbers, hyphens, and underscores\n"));
+    process.exit(1);
+  }
+  const spinner = ora7(`Creating environment '${normalizedName}'...`).start();
+  try {
+    const body = { name: normalizedName };
+    if (options.from) {
+      body.cloneFrom = options.from;
+      spinner.text = `Creating environment '${normalizedName}' from '${options.from}'...`;
+    }
+    const response = await fetch(`${API_URL5}/projects/${projectId}/environments`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${credentials.accessToken}`
+      },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Unknown error" }));
+      throw new Error(error.error || `HTTP ${response.status}`);
+    }
+    const env2 = await response.json();
+    spinner.succeed(`Environment '${normalizedName}' created`);
+    console.log();
+    console.log(chalk7.dim(`  API Key: ${env2.apiKey}`));
+    console.log();
+    console.log(chalk7.dim("Deploy to this environment with:"));
+    console.log(chalk7.cyan(`  tthr deploy --env ${normalizedName}`));
+    console.log();
+  } catch (error) {
+    spinner.fail("Failed to create environment");
+    console.error(chalk7.red(error instanceof Error ? error.message : "Unknown error"));
+    process.exit(1);
+  }
+}
+async function envDeleteCommand(name) {
+  const credentials = await requireAuth();
+  const projectId = await getProjectId();
+  const spinner = ora7(`Deleting environment '${name}'...`).start();
+  try {
+    const response = await fetch(`${API_URL5}/projects/${projectId}/environments/${name}`, {
+      method: "DELETE",
+      headers: {
+        "Authorization": `Bearer ${credentials.accessToken}`
+      }
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Unknown error" }));
+      throw new Error(error.error || `HTTP ${response.status}`);
+    }
+    spinner.succeed(`Environment '${name}' deleted`);
+  } catch (error) {
+    spinner.fail("Failed to delete environment");
+    console.error(chalk7.red(error instanceof Error ? error.message : "Unknown error"));
+    process.exit(1);
+  }
+}
+async function envDefaultCommand(name) {
+  const credentials = await requireAuth();
+  const projectId = await getProjectId();
+  const spinner = ora7(`Setting '${name}' as default environment...`).start();
+  try {
+    const response = await fetch(`${API_URL5}/projects/${projectId}/environments/default`, {
+      method: "PATCH",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${credentials.accessToken}`
+      },
+      body: JSON.stringify({ name })
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Unknown error" }));
+      throw new Error(error.error || `HTTP ${response.status}`);
+    }
+    spinner.succeed(`'${name}' is now the default environment`);
+  } catch (error) {
+    spinner.fail("Failed to set default environment");
+    console.error(chalk7.red(error instanceof Error ? error.message : "Unknown error"));
+    process.exit(1);
+  }
+}
+function getEnvColour(envName) {
+  switch (envName) {
+    case "production":
+      return "#10b981";
+    // green
+    case "development":
+      return "#f59e0b";
+    // amber
+    default:
+      return "#3b82f6";
+  }
+}
+function maskApiKey(key) {
+  if (!key || key.length < 15) return key;
+  const visibleStart = key.substring(0, 10);
+  const visibleEnd = key.substring(key.length - 4);
+  return `${visibleStart}...${visibleEnd}`;
+}
+
 // src/index.ts
 var program = new Command();
 program.name("tthr").description("Tether CLI - Realtime SQLite for modern applications").version("0.0.1");
 program.command("init [name]").description("Create a new Tether project").option("-t, --template <template>", "Project template (vue, svelte, react, vanilla)", "vue").action(initCommand);
-program.command("dev").description("Start local development server with hot reload").option("-p, --port <port>", "Port to run on").option("--skip-framework", "Only run Tether watchers, skip framework dev server").action(devCommand);
+program.command("dev").description("Start local development server with hot reload").option("-p, --port <port>", "Port to run on").option("-e, --env <environment>", "Target environment (default: development)").option("--local", "Run fully local (do not connect to cloud)").option("--skip-framework", "Only run Tether watchers, skip framework dev server").action(devCommand);
 program.command("generate").alias("gen").description("Generate types from schema").action(generateCommand);
-program.command("deploy").description("Deploy schema and functions to Tether").option("-s, --schema", "Deploy schema only").option("-f, --functions", "Deploy functions only").option("--dry-run", "Show what would be deployed without deploying").action(deployCommand);
+program.command("deploy").description("Deploy schema and functions to Tether").option("-s, --schema", "Deploy schema only").option("-f, --functions", "Deploy functions only").option("-e, --env <environment>", "Target environment (default: development)").option("--dry-run", "Show what would be deployed without deploying").action(deployCommand);
 program.command("login").description("Authenticate with Tether").action(loginCommand);
 program.command("logout").description("Sign out of Tether").action(logoutCommand);
 program.command("whoami").description("Show current authenticated user").action(whoamiCommand);
 program.command("update").description("Update all Tether packages to the latest version").option("--dry-run", "Show what would be updated without updating").action(updateCommand);
 program.command("exec <sql>").description("Execute a SQL query against the project database").action(execCommand);
+var env = program.command("env").description("Manage project environments");
+env.command("list").description("List all environments").action(envListCommand);
+env.command("create <name>").description("Create a new environment").option("--from <env>", "Clone schema and functions from an existing environment").action(envCreateCommand);
+env.command("delete <name>").description("Delete an environment").action(envDeleteCommand);
+env.command("default <name>").description("Set the default environment").action(envDefaultCommand);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tthr",
-  "version": "0.0.34",
+  "version": "0.0.35",
   "description": "Tether CLI - project scaffolding and deployment",
   "type": "module",
   "bin": {