tthr 0.3.5 → 0.3.7

package/dist/chunk-CPBP6GSK.js

@@ -0,0 +1,684 @@
+// 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");
+var isDev = process.env.NODE_ENV === "development" || process.env.TETHER_DEV === "true";
+var API_URL = isDev ? "http://localhost:3001/api/v1" : "https://tether-api.strands.gg/api/v1";
+var REFRESH_THRESHOLD_DAYS = 7;
+async function getCredentials() {
+  try {
+    if (await fs.pathExists(CREDENTIALS_FILE)) {
+      return await fs.readJSON(CREDENTIALS_FILE);
+    }
+  } catch {
+  }
+  return null;
+}
+async function refreshSession(credentials) {
+  try {
+    const response = await fetch(`${API_URL}/auth/session/refresh`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${credentials.accessToken}`
+      }
+    });
+    if (!response.ok) {
+      return null;
+    }
+    const data = await response.json();
+    const updated = {
+      ...credentials,
+      expiresAt: data.expiresAt
+    };
+    await saveCredentials(updated);
+    return updated;
+  } 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);
+    const now = /* @__PURE__ */ new Date();
+    if (now > expiresAt) {
+      await clearCredentials();
+      console.error(chalk.red("\n\u2717 Session expired \u2014 you have been signed out\n"));
+      console.log(chalk.dim("Run `tthr login` to authenticate\n"));
+      process.exit(1);
+    }
+    const daysUntilExpiry = (expiresAt.getTime() - now.getTime()) / (1e3 * 60 * 60 * 24);
+    if (daysUntilExpiry <= REFRESH_THRESHOLD_DAYS) {
+      const refreshed = await refreshSession(credentials);
+      if (refreshed) {
+        return refreshed;
+      }
+    }
+  }
+  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
+var isDev2 = process.env.NODE_ENV === "development" || process.env.TETHER_DEV === "true";
+var API_URL2 = isDev2 ? "http://localhost:3001/api/v1" : "https://tether-api.strands.gg/api/v1";
+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 genericType = match[3];
+    const modifiers = match[4] || "";
+    const nullable = !modifiers.includes(".notNull()");
+    const oneOfMatch = modifiers.match(/\.oneOf\s*\(\s*\[(.*?)\]\s*\)/);
+    let oneOf;
+    if (oneOfMatch) {
+      oneOf = [...oneOfMatch[1].matchAll(/['"]([^'"]+)['"]/g)].map((m) => m[1]);
+    }
+    columns.push({
+      name,
+      type: schemaTypeToTS(schemaType),
+      nullable,
+      jsonType: genericType,
+      // Store the generic type for json columns
+      oneOf
+    });
+  }
+  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";
+    case "asset":
+      return "TetherAsset";
+    // Asset object returned by API
+    default:
+      return "unknown";
+  }
+}
+function extractSingleType(source, typeName) {
+  const interfaceStart = new RegExp(`(?:export\\s+)?interface\\s+${typeName}\\s*\\{`);
+  const interfaceMatch = interfaceStart.exec(source);
+  if (interfaceMatch) {
+    const braceStart = interfaceMatch.index + interfaceMatch[0].length;
+    let braceCount = 1;
+    let endIdx = braceStart;
+    for (let i = braceStart; i < source.length && braceCount > 0; i++) {
+      if (source[i] === "{") braceCount++;
+      else if (source[i] === "}") braceCount--;
+      endIdx = i;
+    }
+    return source.slice(interfaceMatch.index, endIdx + 1).replace(/^export\s+/, "");
+  }
+  const typeStart = new RegExp(`(?:export\\s+)?type\\s+${typeName}\\s*=`);
+  const typeMatch = typeStart.exec(source);
+  if (typeMatch) {
+    const semiIdx = source.indexOf(";", typeMatch.index);
+    if (semiIdx !== -1) {
+      return source.slice(typeMatch.index, semiIdx + 1).replace(/^export\s+/, "");
+    }
+  }
+  return null;
+}
+function extractTypeDefinitions(source, typeNames) {
+  if (typeNames.size === 0) return [];
+  const allDefinedTypes = /* @__PURE__ */ new Set();
+  const typeDefRegex = /(?:export\s+)?(?:interface|type)\s+(\w+)/g;
+  let m;
+  while ((m = typeDefRegex.exec(source)) !== null) {
+    allDefinedTypes.add(m[1]);
+  }
+  const resolved = /* @__PURE__ */ new Map();
+  const queue = [...typeNames];
+  while (queue.length > 0) {
+    const name = queue.shift();
+    if (resolved.has(name)) continue;
+    const block = extractSingleType(source, name);
+    if (!block) continue;
+    resolved.set(name, block);
+    for (const definedType of allDefinedTypes) {
+      if (!resolved.has(definedType) && !queue.includes(definedType)) {
+        const refRegex = new RegExp(`\\b${definedType}\\b`);
+        if (refRegex.test(block)) {
+          queue.push(definedType);
+        }
+      }
+    }
+  }
+  const ordered = [];
+  const visited = /* @__PURE__ */ new Set();
+  function visit(name) {
+    if (visited.has(name)) return;
+    visited.add(name);
+    const block = resolved.get(name);
+    if (!block) return;
+    for (const dep of resolved.keys()) {
+      if (dep !== name && new RegExp(`\\b${dep}\\b`).test(block)) {
+        visit(dep);
+      }
+    }
+    ordered.push(name);
+  }
+  for (const name of resolved.keys()) {
+    visit(name);
+  }
+  return ordered.map((name) => resolved.get(name));
+}
+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, schemaSource) {
+  const TS_PRIMITIVES = /* @__PURE__ */ new Set(["number", "string", "boolean", "unknown", "any", "void", "never", "undefined", "null", "object"]);
+  const jsonTypes = /* @__PURE__ */ new Set();
+  for (const table of tables) {
+    for (const col of table.columns) {
+      if (col.jsonType) {
+        const baseType = col.jsonType.replace(/\s*\|\s*null/g, "").replace(/\[\]/g, "").trim();
+        if (!TS_PRIMITIVES.has(baseType)) {
+          jsonTypes.add(baseType);
+        }
+      }
+    }
+  }
+  const lines = [
+    "// Auto-generated by Tether CLI - do not edit manually",
+    `// Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    "",
+    "import { createDatabaseProxy, type TetherDatabase } from '@tthr/client';",
+    "import {",
+    "  type QueryDefinition,",
+    "  type MutationDefinition,",
+    "  z,",
+    "} from '@tthr/server';",
+    "import type { TetherEnv } from './env';"
+  ];
+  if (jsonTypes.size > 0) {
+    const typeBlocks = extractTypeDefinitions(schemaSource, jsonTypes);
+    if (typeBlocks.length > 0) {
+      lines.push("");
+      lines.push("// Schema types (inlined from schema.ts)");
+      for (const block of typeBlocks) {
+        lines.push(block);
+        lines.push("");
+      }
+    }
+  }
+  lines.push("");
+  lines.push("// Asset type returned by the API for asset columns");
+  lines.push("export interface TetherAsset {");
+  lines.push("  id: string;");
+  lines.push("  filename: string;");
+  lines.push("  contentType: string;");
+  lines.push("  size: number;");
+  lines.push("  url: string;");
+  lines.push("  createdAt: string;");
+  lines.push("}");
+  lines.push("");
+  for (const table of tables) {
+    const interfaceName = tableNameToInterface(table.name);
+    lines.push(`export interface ${interfaceName} {`);
+    lines.push("  _id: string;");
+    for (const col of table.columns) {
+      let colType;
+      if (col.oneOf && col.oneOf.length > 0) {
+        colType = col.oneOf.map((v) => `'${v}'`).join(" | ");
+      } else {
+        colType = col.jsonType || col.type;
+      }
+      const typeStr = col.nullable ? `${colType} | null` : colType;
+      const optional = col.nullable ? "?" : "";
+      lines.push(`  ${col.name}${optional}: ${typeStr};`);
+    }
+    lines.push("  _createdAt: string;");
+    lines.push("  _updatedAt?: string | null;");
+    lines.push("  _deletedAt?: string | null;");
+    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("");
+  lines.push("// ============================================================================");
+  lines.push("// Typed function wrappers - use these instead of importing from @tthr/server");
+  lines.push("// This ensures the `db` and `env` parameters in handlers are properly typed");
+  lines.push("// ============================================================================");
+  lines.push("");
+  lines.push("/**");
+  lines.push(" * Define a query function with typed database and environment variable access.");
+  lines.push(" * The `db` and `env` parameters in the handler will have full type safety.");
+  lines.push(" */");
+  lines.push("export function query<TArgs = void, TResult = unknown>(");
+  lines.push("  definition: QueryDefinition<TArgs, TResult, Schema, TetherEnv>");
+  lines.push("): QueryDefinition<TArgs, TResult, Schema, TetherEnv> {");
+  lines.push("  return definition;");
+  lines.push("}");
+  lines.push("");
+  lines.push("/**");
+  lines.push(" * Define a mutation function with typed database and environment variable access.");
+  lines.push(" * The `db` and `env` parameters in the handler will have full type safety.");
+  lines.push(" */");
+  lines.push("export function mutation<TArgs = void, TResult = unknown>(");
+  lines.push("  definition: MutationDefinition<TArgs, TResult, Schema, TetherEnv>");
+  lines.push("): MutationDefinition<TArgs, TResult, Schema, TetherEnv> {");
+  lines.push("  return definition;");
+  lines.push("}");
+  lines.push("");
+  lines.push("// Re-export z for convenience");
+  lines.push("export { z };");
+  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)\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 fetchEnvVarKeys(projectId, environment) {
+  const credentials = await getCredentials();
+  if (!credentials) return [];
+  const envPath = environment !== "production" ? `/projects/${projectId}/env/${environment}/env-vars` : `/projects/${projectId}/env-vars`;
+  try {
+    const response = await fetch(`${API_URL2}${envPath}`, {
+      headers: {
+        "Authorization": `Bearer ${credentials.accessToken}`
+      }
+    });
+    if (!response.ok) return [];
+    const data = await response.json();
+    return (data.envVars || []).map((v) => v.key).sort();
+  } catch {
+    return [];
+  }
+}
+function generateEnvFile(keys) {
+  const lines = [
+    "// Auto-generated by Tether CLI - do not edit manually",
+    `// Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    "",
+    "/**",
+    " * Typed environment variables for this project.",
+    " * Keys are fetched from the Tether API \u2014 values are never exposed.",
+    ' * Use `env.get("KEY")` in your functions to access them.',
+    " */",
+    ""
+  ];
+  if (keys.length > 0) {
+    lines.push("export type EnvVarKey =");
+    for (let i = 0; i < keys.length; i++) {
+      const sep = i === keys.length - 1 ? ";" : "";
+      lines.push(`  | '${keys[i]}'${sep}`);
+    }
+    lines.push("");
+    lines.push("export interface TetherEnv {");
+    for (const key of keys) {
+      lines.push(`  ${key}: string;`);
+    }
+    lines.push("}");
+  } else {
+    lines.push("export type EnvVarKey = string;");
+    lines.push("");
+    lines.push("export interface TetherEnv {");
+    lines.push("  [key: string]: string;");
+    lines.push("}");
+  }
+  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);
+  const environment = config.environment || "development";
+  let projectId;
+  const envFilePath = path3.resolve(process.cwd(), ".env");
+  if (await fs3.pathExists(envFilePath)) {
+    const envContent = await fs3.readFile(envFilePath, "utf-8");
+    const match = envContent.match(/TETHER_PROJECT_ID=(.+)/);
+    projectId = match?.[1]?.trim();
+  }
+  const envVarKeys = projectId ? await fetchEnvVarKeys(projectId, environment) : [];
+  await fs3.ensureDir(outputDir);
+  await fs3.writeFile(
+    path3.join(outputDir, "db.ts"),
+    generateDbFile(tables, schemaSource)
+  );
+  await fs3.writeFile(
+    path3.join(outputDir, "api.ts"),
+    await generateApiFile(functionsDir)
+  );
+  await fs3.writeFile(
+    path3.join(outputDir, "env.ts"),
+    generateEnvFile(envVarKeys)
+  );
+  await fs3.writeFile(
+    path3.join(outputDir, "index.ts"),
+    `// Auto-generated by Tether CLI - do not edit manually
+export * from './db';
+export * from './api';
+export * from './env';
+`
+  );
+  return { tables, envVarKeys, 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, envVarKeys, 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)`));
+    }
+    if (envVarKeys.length > 0) {
+      console.log("\n" + chalk2.green("\u2713") + ` Environment variables: ${envVarKeys.length} key(s)`);
+      for (const key of envVarKeys) {
+        console.log(chalk2.dim(`  - ${key}`));
+      }
+    }
+    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}/env.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 {
+  API_URL,
+  getCredentials,
+  requireAuth,
+  saveCredentials,
+  clearCredentials,
+  loadConfig,
+  resolvePath,
+  detectFramework,
+  getFrameworkDevCommand,
+  generateTypes,
+  generateCommand
+};

package/dist/generate-FTLMBVLH.js

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

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   requireAuth,
   resolvePath,
   saveCredentials
-} from "./chunk-VBD4DOWS.js";
+} from "./chunk-CPBP6GSK.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -1224,8 +1224,8 @@ PUBLIC_TETHER_PROJECT_ID=\${TETHER_PROJECT_ID}
     }
   }
 }
-function getInstallCommand(pm, isDev6 = false) {
-  const devFlag = isDev6 ? pm === "npm" ? "-D" : pm === "yarn" ? "-D" : pm === "pnpm" ? "-D" : "-d" : "";
+function getInstallCommand(pm, isDev7 = false) {
+  const devFlag = isDev7 ? pm === "npm" ? "-D" : pm === "yarn" ? "-D" : pm === "pnpm" ? "-D" : "-d" : "";
   return `${pm} ${pm === "npm" ? "install" : "add"} ${devFlag}`.trim();
 }
 async function installTetherPackages(projectPath, template, packageManager) {
@@ -1670,9 +1670,12 @@ import fs3 from "fs-extra";
 import path3 from "path";
 import { spawn } from "child_process";
 import { watch } from "chokidar";
+var isDev3 = process.env.NODE_ENV === "development" || process.env.TETHER_DEV === "true";
+var API_BASE = isDev3 ? "http://localhost:3001" : "https://tether-api.strands.gg";
 var frameworkProcess = null;
 var schemaWatcher = null;
 var functionsWatcher = null;
+var envWs = null;
 var isGenerating = false;
 var pendingGenerate = false;
 var isDeploying = false;
@@ -1684,7 +1687,7 @@ async function runGenerate(spinner) {
   }
   isGenerating = true;
   try {
-    const { generateTypes: generateTypes2 } = await import("./generate-LVU4IEMB.js");
+    const { generateTypes: generateTypes2 } = await import("./generate-FTLMBVLH.js");
     spinner.text = "Regenerating types...";
     await generateTypes2({ silent: true });
     spinner.succeed("Types regenerated");
@@ -1791,6 +1794,44 @@ async function validateFunctions(functionsDir) {
   }
   return { valid: errors.length === 0, errors };
 }
+function connectToEnvironment(projectId, environment, token, spinner) {
+  const wsBase = API_BASE.replace("https://", "wss://").replace("http://", "ws://");
+  const wsUrl = environment && environment !== "production" ? `${wsBase}/ws/${projectId}/${environment}?token=${encodeURIComponent(token)}` : `${wsBase}/ws/${projectId}?token=${encodeURIComponent(token)}`;
+  let reconnectAttempts = 0;
+  const maxReconnectAttempts = 10;
+  function connect() {
+    try {
+      envWs = new WebSocket(wsUrl);
+    } catch {
+      return;
+    }
+    envWs.onopen = () => {
+      reconnectAttempts = 0;
+    };
+    envWs.onmessage = async (event) => {
+      try {
+        const data = JSON.parse(typeof event.data === "string" ? event.data : event.data.toString());
+        if (data.type === "env_change") {
+          console.log(chalk3.cyan(`
+  Environment variable ${data.action}: ${data.key}`));
+          await runGenerate(spinner);
+        }
+      } catch {
+      }
+    };
+    envWs.onclose = () => {
+      envWs = null;
+      if (reconnectAttempts < maxReconnectAttempts) {
+        reconnectAttempts++;
+        const delay = Math.min(1e3 * Math.pow(2, reconnectAttempts - 1), 3e4);
+        setTimeout(connect, delay);
+      }
+    };
+    envWs.onerror = () => {
+    };
+  }
+  connect();
+}
 function startFrameworkDev(command, port, spinner, extraArgs = []) {
   const [cmd, ...args] = command.split(" ");
   const portArgs = ["--port", port];
@@ -1845,6 +1886,10 @@ function cleanup() {
     functionsWatcher.close();
     functionsWatcher = null;
   }
+  if (envWs) {
+    envWs.close();
+    envWs = null;
+  }
 }
 async function devCommand(options) {
   const credentials = await requireAuth();
@@ -1904,7 +1949,7 @@ async function devCommand(options) {
       }
     }
     spinner.text = "Generating types...";
-    const { generateTypes: generateTypes2 } = await import("./generate-LVU4IEMB.js");
+    const { generateTypes: generateTypes2 } = await import("./generate-FTLMBVLH.js");
     await generateTypes2({ silent: true });
     spinner.succeed("Types generated");
     if (config.projectId) {
@@ -1960,6 +2005,9 @@ async function devCommand(options) {
       });
     }
     spinner.succeed("File watchers ready");
+    if (config.projectId) {
+      connectToEnvironment(config.projectId, environment, credentials.accessToken, spinner);
+    }
     if (devCmd && !options.skipFramework) {
       spinner.start(`Starting ${framework} dev server...`);
       frameworkProcess = startFrameworkDev(devCmd, port, spinner, options.extraArgs || []);
@@ -1986,9 +2034,9 @@ import ora4 from "ora";
 import os from "os";
 import { exec } from "child_process";
 import readline from "readline";
-var isDev3 = process.env.NODE_ENV === "development" || process.env.TETHER_DEV === "true";
-var API_URL4 = isDev3 ? "http://localhost:3001/api/v1" : "https://tether-api.strands.gg/api/v1";
-var AUTH_URL = isDev3 ? "http://localhost:3000/cli" : "https://tthr.io/cli";
+var isDev4 = process.env.NODE_ENV === "development" || process.env.TETHER_DEV === "true";
+var API_URL4 = isDev4 ? "http://localhost:3001/api/v1" : "https://tether-api.strands.gg/api/v1";
+var AUTH_URL = isDev4 ? "http://localhost:3000/cli" : "https://tthr.io/cli";
 async function loginCommand() {
   console.log(chalk4.bold("\u26A1 Login to Tether\n"));
   const existing = await getCredentials();
@@ -2203,18 +2251,18 @@ function detectPackageManager() {
   }
   return "npm";
 }
-function getInstallCommand2(pm, packages, isDev6) {
+function getInstallCommand2(pm, packages, isDev7) {
   const packagesStr = packages.join(" ");
   switch (pm) {
     case "bun":
-      return isDev6 ? `bun add -d ${packagesStr}` : `bun add ${packagesStr}`;
+      return isDev7 ? `bun add -d ${packagesStr}` : `bun add ${packagesStr}`;
     case "pnpm":
-      return isDev6 ? `pnpm add -D ${packagesStr}` : `pnpm add ${packagesStr}`;
+      return isDev7 ? `pnpm add -D ${packagesStr}` : `pnpm add ${packagesStr}`;
     case "yarn":
-      return isDev6 ? `yarn add -D ${packagesStr}` : `yarn add ${packagesStr}`;
+      return isDev7 ? `yarn add -D ${packagesStr}` : `yarn add ${packagesStr}`;
     case "npm":
     default:
-      return isDev6 ? `npm install -D ${packagesStr}` : `npm install ${packagesStr}`;
+      return isDev7 ? `npm install -D ${packagesStr}` : `npm install ${packagesStr}`;
   }
 }
 async function getLatestVersion2(packageName) {
@@ -2323,8 +2371,8 @@ import chalk6 from "chalk";
 import ora6 from "ora";
 import fs5 from "fs-extra";
 import path5 from "path";
-var isDev4 = process.env.NODE_ENV === "development" || process.env.TETHER_DEV === "true";
-var API_URL5 = isDev4 ? "http://localhost:3001/api/v1" : "https://tether-api.strands.gg/api/v1";
+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 execCommand(sql) {
   if (!sql || sql.trim() === "") {
     console.log(chalk6.red("\nError: SQL query required"));
@@ -2396,8 +2444,8 @@ 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_URL6 = isDev5 ? "http://localhost:3001/api/v1" : "https://tether-api.strands.gg/api/v1";
+var isDev6 = process.env.NODE_ENV === "development" || process.env.TETHER_DEV === "true";
+var API_URL6 = isDev6 ? "http://localhost:3001/api/v1" : "https://tether-api.strands.gg/api/v1";
 async function getProjectId() {
   const envPath = path6.resolve(process.cwd(), ".env");
   let projectId;

package/package.json

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