tthr 0.0.60 → 0.1.0

package/dist/chunk-NDEYB3IH.js

@@ -0,0 +1,538 @@
+// 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
+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 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 jsonTypes = /* @__PURE__ */ new Set();
+  for (const table of tables) {
+    for (const col of table.columns) {
+      if (col.jsonType) {
+        jsonTypes.add(col.jsonType.replace(/\[\]$/, ""));
+      }
+    }
+  }
+  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 {",
+    "  query as baseQuery,",
+    "  mutation as baseMutation,",
+    "  type QueryDefinition,",
+    "  type MutationDefinition,",
+    "  z,",
+    "} from '@tthr/server';"
+  ];
+  if (jsonTypes.size > 0) {
+    const typeImports = Array.from(jsonTypes).sort().join(", ");
+    lines.push(`import type { ${typeImports} } from '../schema';`);
+  }
+  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` parameter in handlers is properly typed with Schema");
+  lines.push("// ============================================================================");
+  lines.push("");
+  lines.push("/**");
+  lines.push(" * Define a query function with typed database access.");
+  lines.push(" * The `db` parameter in the handler will have full type safety for your schema.");
+  lines.push(" */");
+  lines.push("export function query<TArgs = void, TResult = unknown>(");
+  lines.push("  definition: QueryDefinition<TArgs, TResult, Schema>");
+  lines.push("): QueryDefinition<TArgs, TResult, Schema> {");
+  lines.push("  return baseQuery(definition);");
+  lines.push("}");
+  lines.push("");
+  lines.push("/**");
+  lines.push(" * Define a mutation function with typed database access.");
+  lines.push(" * The `db` parameter in the handler will have full type safety for your schema.");
+  lines.push(" */");
+  lines.push("export function mutation<TArgs = void, TResult = unknown>(");
+  lines.push("  definition: MutationDefinition<TArgs, TResult, Schema>");
+  lines.push("): MutationDefinition<TArgs, TResult, Schema> {");
+  lines.push("  return baseMutation(definition);");
+  lines.push("}");
+  lines.push("");
+  lines.push("// Re-export z for convenience");
+  lines.push("export { z };");
+  if (jsonTypes.size > 0) {
+    lines.push("");
+    lines.push("// Re-export JSON schema types");
+    const typeExports = Array.from(jsonTypes).sort().join(", ");
+    lines.push(`export type { ${typeExports} } from '../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)\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 {
+  API_URL,
+  getCredentials,
+  requireAuth,
+  saveCredentials,
+  clearCredentials,
+  loadConfig,
+  resolvePath,
+  detectFramework,
+  getFrameworkDevCommand,
+  generateTypes,
+  generateCommand
+};

package/dist/generate-Q4MUBHHO.js

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

package/dist/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import {
+  API_URL,
   clearCredentials,
   detectFramework,
   generateCommand,
@@ -10,7 +11,7 @@ import {
   requireAuth,
   resolvePath,
   saveCredentials
-} from "./chunk-GKELUQ44.js";
+} from "./chunk-NDEYB3IH.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -29,7 +30,7 @@ import ora from "ora";
 import fs from "fs-extra";
 import path from "path";
 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 API_URL2 = isDev ? "http://localhost:3001/api/v1" : "https://tether-api.strands.gg/api/v1";
 async function deployCommand(options) {
   const credentials = await requireAuth();
   const configPath = path.resolve(process.cwd(), "tether.config.ts");
@@ -54,7 +55,7 @@ async function deployCommand(options) {
   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}
+  console.log(chalk.dim(`  API: ${API_URL2}
 `));
   console.log(chalk.dim("  Generating types..."));
   try {
@@ -106,7 +107,7 @@ async function deploySchemaToServer(projectId, token, schemaPath, environment, d
       return;
     }
     spinner.text = "Deploying schema...";
-    const schemaUrl = `${API_URL}/projects/${projectId}/env/${environment}/deploy/schema`;
+    const schemaUrl = `${API_URL2}/projects/${projectId}/env/${environment}/deploy/schema`;
     console.log(chalk.dim(`
   URL: ${schemaUrl}`));
     const requestBody = {
@@ -186,7 +187,7 @@ async function deployFunctionsToServer(projectId, token, functionsDir, environme
       return;
     }
     spinner.text = "Deploying functions...";
-    const functionsUrl = `${API_URL}/projects/${projectId}/env/${environment}/deploy/functions`;
+    const functionsUrl = `${API_URL2}/projects/${projectId}/env/${environment}/deploy/functions`;
     console.log(chalk.dim(`
   URL: ${functionsUrl}`));
     const response = await fetch(functionsUrl, {
@@ -435,7 +436,7 @@ function parseFunctions(moduleName, source) {
 
 // src/commands/init.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";
+var API_URL3 = isDev2 ? "http://localhost:3001/api/v1" : "https://tether-api.strands.gg/api/v1";
 async function getLatestVersion(packageName) {
   try {
     const response = await fetch(`https://registry.npmjs.org/${packageName}/latest`);
@@ -537,7 +538,7 @@ ${packageManager} is not installed on your system.`));
       await scaffoldVanillaProject(projectName, projectPath, spinner);
     }
     spinner.text = "Creating project on Tether...";
-    const response = await fetch(`${API_URL2}/projects`, {
+    const response = await fetch(`${API_URL3}/projects`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -1552,7 +1553,7 @@ async function runGenerate(spinner) {
   }
   isGenerating = true;
   try {
-    const { generateTypes: generateTypes2 } = await import("./generate-5AY6JNCG.js");
+    const { generateTypes: generateTypes2 } = await import("./generate-Q4MUBHHO.js");
     spinner.text = "Regenerating types...";
     await generateTypes2({ silent: true });
     spinner.succeed("Types regenerated");
@@ -1737,7 +1738,7 @@ async function devCommand(options) {
       }
     }
     spinner.text = "Generating types...";
-    const { generateTypes: generateTypes2 } = await import("./generate-5AY6JNCG.js");
+    const { generateTypes: generateTypes2 } = await import("./generate-Q4MUBHHO.js");
     await generateTypes2({ silent: true });
     spinner.succeed("Types generated");
     spinner.start("Setting up file watchers...");
@@ -1808,7 +1809,7 @@ 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_URL3 = isDev3 ? "http://localhost:3001/api/v1" : "https://tether-api.strands.gg/api/v1";
+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";
 async function loginCommand() {
   console.log(chalk4.bold("\u26A1 Login to Tether\n"));
@@ -1898,7 +1899,7 @@ async function requestDeviceCode() {
   const userCode = generateUserCode();
   const deviceCode = crypto.randomUUID();
   const deviceName = os.hostname();
-  const response = await fetch(`${API_URL3}/auth/device`, {
+  const response = await fetch(`${API_URL4}/auth/device`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({ userCode, deviceCode, deviceName })
@@ -1932,7 +1933,7 @@ async function pollForApproval(deviceCode, interval, expiresIn) {
     while (Date.now() < expiresAt) {
       await sleep(interval * 1e3);
       spinner.text = `Checking... ${chalk4.dim(`(${Math.ceil((expiresAt - Date.now()) / 1e3)}s remaining)`)}`;
-      const response = await fetch(`${API_URL3}/auth/device/${deviceCode}`, {
+      const response = await fetch(`${API_URL4}/auth/device/${deviceCode}`, {
         method: "GET"
       }).catch(() => null);
       updateCountdown();
@@ -2145,7 +2146,7 @@ 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_URL4 = isDev4 ? "http://localhost:3001/api/v1" : "https://tether-api.strands.gg/api/v1";
+var API_URL5 = isDev4 ? "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"));
@@ -2167,7 +2168,7 @@ async function execCommand(sql) {
   }
   const spinner = ora6("Executing query...").start();
   try {
-    const response = await fetch(`${API_URL4}/projects/${projectId}/exec`, {
+    const response = await fetch(`${API_URL5}/projects/${projectId}/exec`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -2218,7 +2219,7 @@ 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";
+var API_URL6 = 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;
@@ -2239,7 +2240,7 @@ async function envListCommand() {
   const projectId = await getProjectId();
   const spinner = ora7("Fetching environments...").start();
   try {
-    const response = await fetch(`${API_URL5}/projects/${projectId}/environments`, {
+    const response = await fetch(`${API_URL6}/projects/${projectId}/environments`, {
       headers: {
         "Authorization": `Bearer ${credentials.accessToken}`
       }
@@ -2282,7 +2283,7 @@ async function envCreateCommand(name, options) {
       body.cloneFrom = options.from;
       spinner.text = `Creating environment '${normalizedName}' from '${options.from}'...`;
     }
-    const response = await fetch(`${API_URL5}/projects/${projectId}/environments`, {
+    const response = await fetch(`${API_URL6}/projects/${projectId}/environments`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -2313,7 +2314,7 @@ async function envDeleteCommand(name) {
   const projectId = await getProjectId();
   const spinner = ora7(`Deleting environment '${name}'...`).start();
   try {
-    const response = await fetch(`${API_URL5}/projects/${projectId}/environments/${name}`, {
+    const response = await fetch(`${API_URL6}/projects/${projectId}/environments/${name}`, {
       method: "DELETE",
       headers: {
         "Authorization": `Bearer ${credentials.accessToken}`
@@ -2335,7 +2336,7 @@ async function envDefaultCommand(name) {
   const projectId = await getProjectId();
   const spinner = ora7(`Setting '${name}' as default environment...`).start();
   try {
-    const response = await fetch(`${API_URL5}/projects/${projectId}/environments/default`, {
+    const response = await fetch(`${API_URL6}/projects/${projectId}/environments/default`, {
       method: "PATCH",
       headers: {
         "Content-Type": "application/json",
@@ -2373,6 +2374,152 @@ function maskApiKey(key) {
   return `${visibleStart}...${visibleEnd}`;
 }
 
+// src/commands/migrate.ts
+import chalk8 from "chalk";
+import ora8 from "ora";
+import fs7 from "fs-extra";
+import path7 from "path";
+import readline2 from "readline";
+async function migrateSystemColumnsCommand(options) {
+  const credentials = await requireAuth();
+  const envPath = path7.resolve(process.cwd(), ".env");
+  let projectId;
+  if (await fs7.pathExists(envPath)) {
+    const envContent = await fs7.readFile(envPath, "utf-8");
+    const match = envContent.match(/TETHER_PROJECT_ID=(.+)/);
+    projectId = match?.[1]?.trim();
+  }
+  if (!projectId) {
+    console.log(chalk8.red("\nError: Project ID not found"));
+    console.log(chalk8.dim("Make sure TETHER_PROJECT_ID is set in your .env file\n"));
+    process.exit(1);
+  }
+  const environment = options.env || "development";
+  console.log(chalk8.bold("\n\u26A1 Migrate Legacy IDs to System Columns\n"));
+  console.log(chalk8.dim(`  Project: ${projectId}`));
+  console.log(chalk8.dim(`  Environment: ${environment}
+`));
+  const spinner = ora8("Analysing database tables...").start();
+  try {
+    const baseUrl = `${API_URL}/projects/${projectId}/env/${environment}/migrate/system-columns`;
+    const dryRunResponse = await fetch(`${baseUrl}?dry_run=true`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${credentials.accessToken}`
+      }
+    });
+    if (!dryRunResponse.ok) {
+      const text = await dryRunResponse.text();
+      let errorMessage;
+      try {
+        const error = JSON.parse(text);
+        errorMessage = error.error || `HTTP ${dryRunResponse.status}`;
+      } catch {
+        errorMessage = text || `HTTP ${dryRunResponse.status}: ${dryRunResponse.statusText}`;
+      }
+      throw new Error(errorMessage);
+    }
+    const preview = await dryRunResponse.json();
+    spinner.stop();
+    const tablesToMigrate = preview.tables.filter((t) => t.status === "migrated");
+    const tablesSkipped = preview.tables.filter((t) => t.status === "skipped");
+    if (tablesToMigrate.length === 0) {
+      console.log(chalk8.green("\u2713") + " All tables already have system columns \u2014 nothing to migrate\n");
+      if (tablesSkipped.length > 0) {
+        console.log(chalk8.dim(`  ${tablesSkipped.length} table(s) already up to date:`));
+        for (const table of tablesSkipped) {
+          console.log(chalk8.dim(`    - ${table.tableName}`));
+        }
+        console.log();
+      }
+      return;
+    }
+    console.log(chalk8.yellow(`  ${tablesToMigrate.length} table(s) to migrate:
+`));
+    for (const table of tablesToMigrate) {
+      console.log(`  ${chalk8.cyan(table.tableName)} ${chalk8.dim(`(${table.rowsMigrated} rows)`)}`);
+      if (table.columnsAdded.length > 0) {
+        console.log(chalk8.dim(`    Adding columns: ${table.columnsAdded.join(", ")}`));
+      }
+      if (table.columnMappings.length > 0) {
+        for (const mapping of table.columnMappings) {
+          console.log(chalk8.dim(`    Mapping: ${mapping.from} \u2192 ${mapping.to}`));
+        }
+      }
+      console.log();
+    }
+    if (tablesSkipped.length > 0) {
+      console.log(chalk8.dim(`  ${tablesSkipped.length} table(s) already up to date`));
+      console.log();
+    }
+    if (options.dryRun) {
+      console.log(chalk8.dim("  Dry run complete \u2014 no changes were made\n"));
+      return;
+    }
+    console.log(chalk8.yellow("  \u26A0 This will modify your database tables."));
+    console.log(chalk8.yellow("    Existing columns will be kept. Old primary key values"));
+    console.log(chalk8.yellow("    will be copied to the new system columns where possible.\n"));
+    const confirmed = await askConfirmation("  Proceed with migration?");
+    if (!confirmed) {
+      console.log(chalk8.dim("\n  Migration cancelled\n"));
+      return;
+    }
+    console.log();
+    const migrateSpinner = ora8("Migrating tables...").start();
+    const migrateResponse = await fetch(baseUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${credentials.accessToken}`
+      }
+    });
+    if (!migrateResponse.ok) {
+      const text = await migrateResponse.text();
+      let errorMessage;
+      try {
+        const error = JSON.parse(text);
+        errorMessage = error.error || `HTTP ${migrateResponse.status}`;
+      } catch {
+        errorMessage = text || `HTTP ${migrateResponse.status}: ${migrateResponse.statusText}`;
+      }
+      throw new Error(errorMessage);
+    }
+    const result = await migrateResponse.json();
+    migrateSpinner.succeed("Migration complete");
+    console.log();
+    const migrated = result.tables.filter((t) => t.status === "migrated");
+    for (const table of migrated) {
+      console.log(`  ${chalk8.green("\u2713")} ${chalk8.cyan(table.tableName)} \u2014 ${table.rowsMigrated} rows migrated`);
+      for (const mapping of table.columnMappings) {
+        console.log(chalk8.dim(`    ${mapping.from} \u2192 ${mapping.to}`));
+      }
+    }
+    console.log();
+    console.log(chalk8.dim(`  ${result.summary}`));
+    console.log();
+    console.log(chalk8.dim("  Old columns have been preserved. You can remove them manually"));
+    console.log(chalk8.dim("  once you have updated your application code.\n"));
+  } catch (error) {
+    spinner.fail("Migration failed");
+    console.error(chalk8.red(error instanceof Error ? error.message : "Unknown error"));
+    console.log();
+    process.exit(1);
+  }
+}
+function askConfirmation(prompt) {
+  return new Promise((resolve) => {
+    const rl = readline2.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    rl.question(`${prompt} ${chalk8.dim("(y/N)")} `, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+    });
+  });
+}
+
 // src/index.ts
 var program = new Command();
 program.name("tthr").description("Tether CLI - Realtime SQLite for modern applications").version("0.0.1").enablePositionalOptions();
@@ -2388,6 +2535,8 @@ 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 migrate = program.command("migrate").description("Database migration utilities");
+migrate.command("system-columns").description("Migrate legacy tables to use system-managed _id, _createdAt, _updatedAt, _deletedAt columns").option("-e, --env <environment>", "Target environment (default: development)").option("--dry-run", "Show what would be migrated without making changes").action(migrateSystemColumnsCommand);
 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);

package/package.json

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