db-migration

User Input

$ARGUMENTS

Outline

建立新的 Supabase migration，確保符合 rules/modules/db-schema/supabase/migration.md 的所有規範（該規約帶 paths: gating，三端都投影）。

Step 1: 確認需求

詢問使用者要建立什麼樣的 migration：

• 新增表格？
• 修改欄位？
• 建立函式？
• 新增 RLS 政策？

Step 2: 建立 Migration 檔案

使用 Supabase CLI 建立 migration（禁止手動建立 .sql 檔案）：

supabase migration new <description_in_snake_case>

Step 3: 撰寫 Migration 內容

根據需求撰寫 SQL，必須遵守以下規範：

函式規範（防 search_path injection）

-- ✅ 正確：search_path 必須是空字串
CREATE OR REPLACE FUNCTION schema_name.function_name()
RETURNS return_type
LANGUAGE plpgsql
SECURITY DEFINER
SET search_path = ''  -- 必須是空字串
AS $$
BEGIN
  -- 使用完整路徑：schema_name.table_name
  SELECT * FROM core.users WHERE id = auth.uid();
END;
$$;

-- ❌ 禁止：任何其他 search_path 值
SET search_path = public, pg_temp  -- 禁止
SET search_path = public           -- 禁止

Schema 規範

• 使用正確的 schema 前綴（如 public.、core.，或專案自訂業務 schema）
• 所有表格/函式引用使用完整路徑（避免裸表名觸發 search_path resolution）

Step 4: 本地測試與類型產生（自動）

依序執行以下步驟，任何步驟失敗則停止並顯示錯誤。MUST 透過 package.json 偵測 consumer 是走遠端 wrapper（pnpm db:*，含 existing-server / self-hosted）還是本機 Docker。NEVER 看到遠端 wrapper 就改跑本機 supabase start。

# 從 package.json 讀 types 路徑（若有自訂）；fallback 到 conventional locations
# 避開頂層 return（Node script 不允許）— 用 if/else 與 .find()
TYPES=$(node -e "
  const fs = require('fs');
  const pkg = require('./package.json');
  const custom = pkg.config && pkg.config.dbTypesPath;
  const candidates = [
    'packages/core/app/types/database.types.ts',
    'app/types/database.types.ts',
    'shared/types/database.types.ts',
    'src/types/database.types.ts',
  ];
  const path = custom || candidates.find(function(p) { return fs.existsSync(p); }) || 'app/types/database.types.ts';
  console.log(path);
")

USE_DB_WRAPPER=$(node -e "process.exit(require('./package.json').scripts?.['db:reset'] ? 0 : 1)" 2>/dev/null && echo yes || echo no)

if [ "$USE_DB_WRAPPER" = yes ]; then
  # 遠端 / existing-server：走 pnpm db:*（wrapper 會擋本機 Docker；db:reset 內部跑 db:types 寫到 $TYPES）
  pnpm db:reset
  pnpm db:lint        # 安全檢查（必須零警告）
  pnpm typecheck
else
  # 本機 Docker（this-machine；沒有 pnpm db:reset wrapper）
  supabase db reset
  supabase db lint --level warning
  # 直接重導向到 $TYPES — 不用 tee（pipeline 會吞 supabase gen types 失敗狀態）
  supabase gen types typescript --local > "$TYPES"
  pnpm typecheck
fi