supatool 0.3.7 → 0.4.0

package/dist/sync/sync.js

@@ -7,102 +7,90 @@ const writeSchema_1 = require("./writeSchema");
 const generateMigration_1 = require("./generateMigration");
 const diff_1 = require("diff");
 const utils_1 = require("./utils");
-// グローバル承認状態（writeSchema.tsと共有）
+// Global approval state (shared with writeSchema.ts)
 let globalApproveAll = false;
 /**
- * DDL文字列を正規化（空白・改行・タブを統一）
+ * Normalize DDL string (unify spaces, newlines, tabs)
  */
 function normalizeDDL(ddl) {
     return ddl
-        .replace(/\s+/g, ' ') // 連続する空白文字を1つのスペースに
-        .replace(/;\s+/g, ';\n') // セミコロン後に改行
-        .trim(); // 前後の空白を削除
+        .replace(/\s+/g, ' ') // Replace consecutive whitespace with single space
+        .replace(/;\s+/g, ';\n') // Add newline after semicolon
+        .trim(); // Remove leading/trailing whitespace
 }
 /**
- * SQLを見やすく整形
+ * Format SQL for readability
  */
 function formatSQL(sql) {
     return sql
-        .replace(/,\s*/g, ',\n  ') // カンマ後に改行とインデント
-        .replace(/\(\s*/g, ' (\n  ') // 開き括弧後に改行とインデント
-        .replace(/\s*\)/g, '\n)') // 閉じ括弧前に改行
-        .replace(/\bCREATE\s+TABLE\b/g, '\nCREATE TABLE') // CREATE TABLE前に改行
-        .replace(/\bPRIMARY\s+KEY\b/g, '\n  PRIMARY KEY') // PRIMARY KEY前に改行とインデント
-        .replace(/;\s*/g, ';\n') // セミコロン後に改行
+        .replace(/,\s*/g, ',\n  ') // Add newline and indent after comma
+        .replace(/\(\s*/g, ' (\n  ') // Add newline and indent after opening parenthesis
+        .replace(/\s*\)/g, '\n)') // Add newline before closing parenthesis
+        .replace(/\bCREATE\s+TABLE\b/g, '\nCREATE TABLE') // Add newline before CREATE TABLE
+        .replace(/\bPRIMARY\s+KEY\b/g, '\n  PRIMARY KEY') // Add newline and indent before PRIMARY KEY
+        .replace(/;\s*/g, ';\n') // Add newline after semicolon
         .split('\n')
         .map(line => line.trim())
         .filter(line => line)
         .join('\n');
 }
 /**
- * すべてのテーブルスキーマを同期
+ * Synchronize all table schemas
  */
-async function syncAllTables({ connectionString, schemaDir, tablePattern = '*', force = false }) {
-    // 承認状態をリセット
+async function syncAllTables({ connectionString, schemaDir, tablePattern = '*', force = false, dryRun = false, generateOnly = false, requireConfirmation = false }) {
+    // Reset approval state
     (0, writeSchema_1.resetApprovalState)();
     const localSchemas = await (0, parseLocalSchemas_1.parseLocalSchemas)(schemaDir);
-    const remoteSchemas = await (0, fetchRemoteSchemas_1.fetchRemoteSchemas)(connectionString);
-    const allTables = new Set([...Object.keys(localSchemas), ...Object.keys(remoteSchemas)]);
-    const remoteTables = new Set(Object.keys(remoteSchemas));
-    // 存在しないテーブルのファイルをバックアップ
-    await (0, writeSchema_1.backupOrphanedFiles)(schemaDir, remoteTables, force);
-    for (const tableName of allTables) {
-        if (!(0, utils_1.wildcardMatch)(tableName, tablePattern)) {
-            continue;
-        }
+    // Filter local tables based on pattern first
+    const targetLocalTables = Object.keys(localSchemas).filter(tableName => (0, utils_1.wildcardMatch)(tableName, tablePattern));
+    console.log(`Pattern: ${tablePattern}`);
+    console.log(`Schema directory: ${schemaDir}`);
+    console.log(`Available local tables: ${Object.keys(localSchemas).join(', ') || 'none'}`);
+    console.log(`Matched local tables: ${targetLocalTables.join(', ') || 'none'}`);
+    if (targetLocalTables.length === 0) {
+        console.log('No matching local tables found for the specified pattern.');
+        return;
+    }
+    // Fetch only the remote schemas for target tables
+    const remoteSchemas = await (0, fetchRemoteSchemas_1.fetchRemoteSchemas)(connectionString, targetLocalTables);
+    for (const tableName of targetLocalTables) {
         const local = localSchemas[tableName];
         const remote = remoteSchemas[tableName];
+        // Always use local as the source (never overwrite local files)
         if (local && !remote) {
-            console.log(`[${tableName}] ローカルのみ - リモートに存在しません（バックアップ済み）`);
-        }
-        else if (!local && remote) {
-            console.log(`[${tableName}] リモートのみ - スキーマを取得`);
-            const success = await (0, writeSchema_1.writeSchemaToFile)(remote.ddl, schemaDir, remote.timestamp, `${tableName}.sql`, tableName, force);
-            if (success) {
-                console.log(`[${tableName}] スキーマファイルを作成しました`);
+            // Local only: generate CREATE TABLE migration
+            console.log(`[${tableName}] Local only - will generate CREATE TABLE migration`);
+            if (dryRun) {
+                console.log(`[${tableName}] 🔍 CREATE TABLE migration will be generated`);
+                console.log(`[${tableName}] 📄 Migration file: supabase/migrations/YYYYMMDDHHMMSS_create_${tableName}.sql`);
+            }
+            else if (generateOnly) {
+                console.log(`[${tableName}] 📝 generateOnly mode: skipping migration generation for local-only table`);
+            }
+            else {
+                // Generate CREATE TABLE migration
+                // For now, skip actual migration generation for local-only tables
+                console.log(`[${tableName}] CREATE TABLE migration generation not yet implemented`);
             }
         }
         else if (local && remote) {
-            // 最初にDDLの差分をチェック
+            // Both local and remote exist: generate UPDATE migration (local → remote)
             const normalizedLocal = local.normalizedDdl;
             const normalizedRemote = normalizeDDL(remote.ddl);
             const diff = (0, diff_1.diffLines)(normalizedLocal, normalizedRemote);
             const hasDiff = diff.some(part => part.added || part.removed);
-            // 差分がある場合のみ処理・表示
             if (hasDiff) {
-                // タイムスタンプ比較（ローカルファイルの実際の更新時刻も考慮）
-                const isRemoteNewer = remote.timestamp > local.timestamp;
-                const isLocalFileNewer = local.fileTimestamp > remote.timestamp;
-                const timeDiff = remote.timestamp - local.timestamp;
-                const fileDiff = local.fileTimestamp - remote.timestamp;
-                const timeDiffHours = Math.abs(timeDiff) / 3600;
-                const fileDiffHours = Math.abs(fileDiff) / 3600;
-                // ローカルファイルの方が新しい場合はリモートへマイグレーション提案
-                if (isLocalFileNewer) {
-                    console.log(`[${tableName}] ローカルが ${fileDiffHours.toFixed(1)}時間新しい - マイグレーション生成`);
-                }
-                else if (isRemoteNewer) {
-                    console.log(`[${tableName}] リモートが ${timeDiffHours.toFixed(1)}時間新しい - ローカル更新`);
-                }
-                else {
-                    console.log(`[${tableName}] 差分を検出 - 確認が必要`);
-                }
-                // 整形されたSQLで行単位の差分を表示
+                console.log(`[${tableName}] Differences detected - will generate UPDATE migration`);
+                // Show formatted diff (local → remote)
                 const formattedLocal = formatSQL(normalizedLocal);
                 const formattedRemote = formatSQL(normalizedRemote);
-                // ローカルが新しい場合は、ローカル→リモートの差分（マイグレーション用）
-                // リモートが新しい場合は、リモート→ローカルの差分（ローカル更新用）
-                const lineDiff = isLocalFileNewer
-                    ? (0, diff_1.diffLines)(formattedRemote, formattedLocal) // ローカル→リモート（マイグレーション用）
-                    : (0, diff_1.diffLines)(formattedLocal, formattedRemote); // リモート→ローカル（ローカル更新用）
-                // 前後のコンテキスト行数
+                const lineDiff = (0, diff_1.diffLines)(formattedRemote, formattedLocal);
+                // Display diff for confirmation
                 const contextLines = 1;
-                let lineNumber = 0;
                 let outputLines = [];
                 lineDiff.forEach((part, index) => {
                     const lines = part.value.split('\n').filter(line => line.trim() || index === lineDiff.length - 1);
                     if (part.added) {
-                        // リモートから追加される行
                         lines.forEach(line => {
                             if (line.trim()) {
                                 outputLines.push(`\x1b[32m+ ${line}\x1b[0m`);
@@ -110,99 +98,46 @@ async function syncAllTables({ connectionString, schemaDir, tablePattern = '*',
                         });
                     }
                     else if (part.removed) {
-                        // ローカルから削除される行
                         lines.forEach(line => {
                             if (line.trim()) {
                                 outputLines.push(`\x1b[31m- ${line}\x1b[0m`);
                             }
                         });
                     }
-                    else {
-                        // 変更されていない行（コンテキスト）
-                        const unchangedLines = lines.filter(line => line.trim());
-                        // 差分の前後で適切にコンテキストを表示
-                        const hasChangeBefore = index > 0 && (lineDiff[index - 1].added || lineDiff[index - 1].removed);
-                        const hasChangeAfter = index < lineDiff.length - 1 && (lineDiff[index + 1].added || lineDiff[index + 1].removed);
-                        if (hasChangeBefore && hasChangeAfter) {
-                            // 前後に変更がある場合は全行表示
-                            unchangedLines.forEach(line => {
-                                outputLines.push(`  ${line}`);
-                            });
-                        }
-                        else if (hasChangeBefore) {
-                            // 前に変更がある場合は最初の数行のみ表示
-                            const showLines = Math.min(contextLines, unchangedLines.length);
-                            for (let i = 0; i < showLines; i++) {
-                                outputLines.push(`  ${unchangedLines[i]}`);
-                            }
-                            if (unchangedLines.length > contextLines) {
-                                outputLines.push(`  \x1b[36m...(${unchangedLines.length - contextLines} more lines)...\x1b[0m`);
-                            }
-                        }
-                        else if (hasChangeAfter) {
-                            // 後に変更がある場合は最後の数行のみ表示
-                            const showLines = Math.min(contextLines, unchangedLines.length);
-                            const startIndex = unchangedLines.length - showLines;
-                            // 冒頭のCREATE TABLE行は常に表示
-                            const hasCreateTable = unchangedLines.some(line => line.trim().toUpperCase().startsWith('CREATE TABLE'));
-                            if (hasCreateTable && startIndex > 0) {
-                                // CREATE TABLE行を探して表示
-                                const createTableIndex = unchangedLines.findIndex(line => line.trim().toUpperCase().startsWith('CREATE TABLE'));
-                                if (createTableIndex >= 0) {
-                                    outputLines.push(`  ${unchangedLines[createTableIndex]}`);
-                                    if (createTableIndex < startIndex - 1) {
-                                        outputLines.push(`  \x1b[36m...(${startIndex - createTableIndex - 1} lines)...\x1b[0m`);
-                                    }
-                                }
-                            }
-                            else if (startIndex > 0) {
-                                outputLines.push(`  \x1b[36m...(${startIndex} lines)...\x1b[0m`);
-                            }
-                            for (let i = startIndex; i < unchangedLines.length; i++) {
-                                outputLines.push(`  ${unchangedLines[i]}`);
-                            }
-                        }
-                        else if (unchangedLines.length <= contextLines * 2) {
-                            // 短い場合は全部表示
-                            unchangedLines.forEach(line => {
-                                outputLines.push(`  ${line}`);
-                            });
-                        }
-                        else {
-                            // 長い場合でも冒頭のCREATE TABLE行は表示
-                            const hasCreateTable = unchangedLines.some(line => line.trim().toUpperCase().startsWith('CREATE TABLE'));
-                            if (hasCreateTable) {
-                                const createTableIndex = unchangedLines.findIndex(line => line.trim().toUpperCase().startsWith('CREATE TABLE'));
-                                if (createTableIndex >= 0) {
-                                    outputLines.push(`  ${unchangedLines[createTableIndex]}`);
-                                    if (unchangedLines.length > 1) {
-                                        outputLines.push(`  \x1b[36m...(${unchangedLines.length - 1} unchanged lines)...\x1b[0m`);
-                                    }
-                                }
-                            }
-                            else {
-                                outputLines.push(`  \x1b[36m...(${unchangedLines.length} unchanged lines)...\x1b[0m`);
-                            }
-                        }
-                    }
                 });
-                outputLines.forEach(line => console.log(line));
-                if (isLocalFileNewer) {
-                    // マイグレーションファイルを生成（ローカル→リモートの差分）
-                    const migrationPath = await (0, generateMigration_1.generateMigrationFile)(tableName, normalizedRemote, // from（現在のリモート状態）
-                    normalizedLocal, // to（ローカルの目標状態）
-                    process.cwd());
+                if (outputLines.length > 0) {
+                    console.log(`[${tableName}] Changes to apply:`);
+                    outputLines.forEach(line => console.log(line));
+                }
+                // Generate or preview migration
+                if (dryRun) {
+                    console.log(`[${tableName}] 🔍 UPDATE migration will be generated`);
+                    console.log(`[${tableName}] 📄 File to be generated: supabase/migrations/YYYYMMDDHHMMSS_update_${tableName}.sql`);
+                }
+                else if (generateOnly) {
+                    console.log(`[${tableName}] 📝 generateOnly mode: skipping migration generation`);
                 }
                 else {
-                    // リモートが新しいかタイムスタンプが同じ場合：ローカルを更新
-                    const shouldAutoUpdate = isRemoteNewer && !isLocalFileNewer;
-                    const success = await (0, writeSchema_1.writeSchemaToFile)(remote.ddl, schemaDir, remote.timestamp, `${tableName}.sql`, tableName, shouldAutoUpdate);
-                    if (success) {
-                        console.log(`[${tableName}] ローカルファイルを更新しました`);
+                    // Confirmation check for confirmation mode
+                    if (requireConfirmation && !force) {
+                        const confirmed = await (0, utils_1.askUserConfirmation)(`Generate UPDATE migration for table ${tableName}?`);
+                        if (!confirmed) {
+                            console.log(`[${tableName}] Skipped by user confirmation`);
+                            continue;
+                        }
+                    }
+                    // Generate migration file (local → remote diff)
+                    const migrationPath = await (0, generateMigration_1.generateMigrationFile)(tableName, normalizedRemote, // from (current remote state)
+                    normalizedLocal, // to (local target state)
+                    process.cwd());
+                    if (migrationPath) {
+                        console.log(`[${tableName}] 📝 UPDATE migration generated: ${migrationPath}`);
                     }
                 }
             }
-            // 差分がない場合は何も表示せず、何もしない
+            else {
+                console.log(`[${tableName}] No differences found`);
+            }
         }
     }
 }

package/dist/sync/utils.js

@@ -3,23 +3,35 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.wildcardMatch = wildcardMatch;
 exports.askUserConfirmation = askUserConfirmation;
-// ワイルドカードマッチング関数
+// Wildcard matching function
 function wildcardMatch(str, pattern) {
-    return pattern === '*' || str.includes(pattern);
+    if (pattern === '*') {
+        return true;
+    }
+    // Exact match if pattern contains no wildcards
+    if (!pattern.includes('*') && !pattern.includes('?')) {
+        return str === pattern;
+    }
+    // Simple wildcard pattern matching
+    const regexPattern = pattern
+        .replace(/\*/g, '.*')
+        .replace(/\?/g, '.');
+    const regex = new RegExp(`^${regexPattern}$`);
+    return regex.test(str);
 }
 /**
- * ユーザーに確認を求める（1文字入力で即座に判定）
+ * Ask user for confirmation (immediate single character input)
  */
 function askUserConfirmation(message, options) {
     return new Promise((resolve) => {
         const promptMessage = options?.message || '(y/N): ';
         process.stdout.write(`${message} ${promptMessage}`);
-        // rawモードを有効にして1文字入力を受け取る
+        // Enable raw mode to receive single character input
         process.stdin.setRawMode(true);
         process.stdin.resume();
         process.stdin.setEncoding('utf8');
         const onData = (key) => {
-            // クリーンアップ
+            // Cleanup
             process.stdin.setRawMode(false);
             process.stdin.pause();
             process.stdin.removeListener('data', onData);
@@ -33,7 +45,7 @@ function askUserConfirmation(message, options) {
                 resolve('all');
             }
             else if (lowerKey === 'n' || key === '\r' || key === '\n' || key === '\u0003') {
-                // n、Enter、または Ctrl+C
+                // n, Enter, or Ctrl+C
                 if (key === '\u0003') {
                     console.log('\nOperation cancelled');
                     process.exit(0);
@@ -42,7 +54,7 @@ function askUserConfirmation(message, options) {
                 resolve(false);
             }
             else {
-                // 無効なキー：デフォルトでfalse
+                // Invalid key: default to false
                 console.log(`${key} (invalid input, treating as N)`);
                 resolve(false);
             }

package/dist/sync/writeSchema.js

@@ -40,16 +40,16 @@ exports.moveToBackup = moveToBackup;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const utils_1 = require("./utils");
-// グローバルな「全て承認」状態を管理
+// Manage global "approve all" state
 let globalApproveAll = false;
 /**
- * 全て承認モードをリセット
+ * Reset approve all mode
  */
 function resetApprovalState() {
     globalApproveAll = false;
 }
 /**
- * 既存ファイルをバックアップディレクトリに移動
+ * Move existing file to backup directory
  */
 async function backupExistingFile(filePath, schemaDir, force = false) {
     if (!fs.existsSync(filePath)) {
@@ -57,16 +57,16 @@ async function backupExistingFile(filePath, schemaDir, force = false) {
     }
     if (!force && !globalApproveAll) {
         const fileName = path.basename(filePath);
-        const response = await (0, utils_1.askUserConfirmation)(`↓ 既存ファイル ${fileName} を上書きしますか？`, {
+        const response = await (0, utils_1.askUserConfirmation)(`↓ Overwrite existing file ${fileName}?`, {
             allowAll: true,
             message: '(y/N/a[all]): '
         });
         if (response === 'all') {
             globalApproveAll = true;
-            console.log('✅ すべてのファイルを承認します');
+            console.log('✅ Approving all files');
         }
         else if (response === false) {
-            console.log('スキップしました');
+            console.log('Skipped');
             return false;
         }
     }
@@ -79,11 +79,11 @@ async function backupExistingFile(filePath, schemaDir, force = false) {
     const backupFileName = `${timestamp}_${fileName}`;
     const backupPath = path.join(backupDir, backupFileName);
     fs.renameSync(filePath, backupPath);
-    console.log(`既存ファイルをバックアップしました: ${backupPath}`);
+    console.log(`Existing file backed up: ${backupPath}`);
     return true;
 }
 /**
- * 存在しないテーブルのファイルをバックアップに移動
+ * Move files for non-existent tables to backup
  */
 async function backupOrphanedFiles(schemaDir, existingTables, force = false) {
     if (!fs.existsSync(schemaDir)) {
@@ -103,48 +103,48 @@ async function backupOrphanedFiles(schemaDir, existingTables, force = false) {
         return;
     }
     if (!force) {
-        console.log('\n以下のファイルは存在しないテーブルに対応しています:');
+        console.log('\nThe following files correspond to non-existent tables:');
         orphanedFiles.forEach(file => console.log(`  - ${file}`));
-        const confirmed = await (0, utils_1.askUserConfirmation)('これらのファイルをバックアップフォルダに移動しますか？');
+        const confirmed = await (0, utils_1.askUserConfirmation)('Move these files to backup folder?');
         if (!confirmed) {
-            console.log('孤児ファイルの移動をスキップしました');
+            console.log('Skipped moving orphaned files');
             return;
         }
     }
     for (const file of orphanedFiles) {
         const tableName = path.basename(file, '.sql');
         const filePath = path.join(schemaDir, file);
-        console.log(`[${tableName}] 存在しないテーブルのファイルをバックアップ`);
-        await backupExistingFile(filePath, schemaDir, true); // 確認済みなのでforce=true
+        console.log(`[${tableName}] Backing up file for non-existent table`);
+        await backupExistingFile(filePath, schemaDir, true); // force=true since already confirmed
     }
 }
 /**
- * スキーマをファイルに書き込み
+ * Write schema to file
  */
 async function writeSchemaToFile(ddl, schemaDir, timestamp, fileName, tableName, force = false) {
     if (!fs.existsSync(schemaDir)) {
         fs.mkdirSync(schemaDir, { recursive: true });
     }
     const filePath = path.join(schemaDir, fileName);
-    // 既存ファイルがある場合はバックアップ
+    // Backup existing file if exists
     const canProceed = await backupExistingFile(filePath, schemaDir, force);
     if (!canProceed) {
         return false;
     }
-    // リモートデータベースの最終更新時刻を記録（比較用メタデータ - 編集禁止）
+    // Record remote database last updated time (metadata for comparison - do not edit)
     const remoteTimestamp = `-- Remote last updated: ${new Date(timestamp * 1000).toISOString()}\n`;
-    // 同期実行時刻（参考情報）
+    // Sync execution time (reference info)
     const syncTimestamp = `-- Synced by supatool at: ${new Date().toISOString()}\n`;
-    // 警告コメント
-    const warningComment = `-- ⚠️  このファイルはsupatoolによって自動生成されます。手動編集は同期時に失われる可能性があります。\n`;
+    // Warning comment
+    const warningComment = `-- ⚠️  This file is auto-generated by supatool. Manual edits may be lost during sync.\n`;
     const tableComment = `-- Table: ${tableName}\n\n`;
     const finalContent = remoteTimestamp + syncTimestamp + warningComment + tableComment + ddl;
     fs.writeFileSync(filePath, finalContent, 'utf-8');
-    console.log(`📁 ${tableName}.sql に保存しました`);
+    console.log(`📁 Saved to ${tableName}.sql`);
     return true;
 }
 /**
- * 孤立したファイルをバックアップフォルダに移動
+ * Move orphaned files to backup folder
  */
 function moveToBackup(schemaDir, fileName) {
     const backupDir = path.join(schemaDir, 'backup');
@@ -156,6 +156,6 @@ function moveToBackup(schemaDir, fileName) {
     const backupFile = path.join(backupDir, `${path.basename(fileName, '.sql')}_${timestamp}.sql`);
     if (fs.existsSync(sourceFile)) {
         fs.renameSync(sourceFile, backupFile);
-        console.log(`📦 ${fileName} を ${backupFile} にバックアップしました`);
+        console.log(`📦 Backed up ${fileName} to ${backupFile}`);
     }
 }

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "supatool",
-  "version": "0.3.7",
-  "description": "A CLI tool for Supabase schema extraction and TypeScript CRUD generation with declarative database schema support.",
+  "version": "0.4.0",
+  "description": "CLI for Supabase: extract schema (tables, views, RLS, RPC) to files + llms.txt for LLM, deploy local schema, seed export. CRUD code gen deprecated.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
     "supatool": "dist/bin/supatool.js"
   },
-  "scripts": {
-    "build": "tsc",
-    "postbuild": "npm link",
-    "start": "tsx bin/supatool.ts"
-  },
+"scripts": {
+  "build": "tsc",
+  "start": "tsx src/bin/supatool.ts",
+  "local": "tsx src/bin/supatool.ts"
+},
   "files": [
     "dist",
     "bin"
@@ -43,7 +43,7 @@
   "devDependencies": {
     "@types/diff": "^7.0.2",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^20.17.30",
+    "@types/node": "^20.19.22",
     "@types/pg": "^8.11.0"
   },
   "exports": {