@plutocms/supabase 0.9.1 → 0.10.0

package/i18n/locales/en.json

@@ -0,0 +1,209 @@
+{
+  "supabase": {
+    "profile": {
+      "migrationPending": "Apply the pending database migrations to save your language."
+    },
+    "errors": {
+      "notLoggedIn": "You must be logged in.",
+      "notAdmin": "Your account is not an admin.",
+      "missingPermission": "Your account is missing the \"{capability}\" permission.",
+      "setupCompleted": "Setup has already been completed.",
+      "coreSchemaMissing": "Core schema not found. Reinstall @plutocms/supabase and restart the dev server.",
+      "fetchUsers": "Error fetching users: {message}",
+      "fetchUser": "Error fetching user: {message}",
+      "localeUnsupported": "This language is not supported.",
+      "duplicateRecord": "A record with this value already exists.",
+      "missingReference": "This references a record that does not exist.",
+      "migrationStatus": "Error reading migration status: {message}"
+    },
+    "auth": {
+      "backToLogin": "Back to Login",
+      "passwordMismatch": "Passwords do not match.",
+      "fields": {
+        "email": "Email",
+        "password": "Password",
+        "username": "Username",
+        "displayName": "Display Name",
+        "confirmPassword": "Confirm Password"
+      },
+      "toasts": {
+        "loginFailed": "Could not log in",
+        "loggedOut": "Logged out successfully",
+        "resetFailed": "Could not send reset email",
+        "updateFailed": "Could not update password",
+        "passwordUpdated": "Password updated successfully",
+        "notLoggedIn": "You are not logged in",
+        "notLoggedInDescription": "Please log in to continue."
+      },
+      "errors": {
+        "unknown": "An unknown error occurred.",
+        "invalid_credentials": "Invalid email or password.",
+        "email_not_confirmed": "Your email is not confirmed yet. Check your inbox for the verification link.",
+        "over_request_rate_limit": "Too many attempts. Wait a moment and try again.",
+        "over_email_send_rate_limit": "Too many emails sent. Wait a moment and try again.",
+        "weak_password": "This password is too weak. Choose a stronger one.",
+        "same_password": "The new password must be different from the current one.",
+        "user_not_found": "No account was found for this email.",
+        "email_exists": "An account with this email already exists.",
+        "user_already_exists": "An account with this email already exists.",
+        "signup_disabled": "Sign up is turned off for this site.",
+        "email_address_invalid": "This email address is not valid."
+      },
+      "confirm": {
+        "pageTitle": "Account Verification",
+        "title": "Account verified!",
+        "description": "Your account has been successfully verified. You can now start using the Dashboard.",
+        "goToDashboard": "Go to Dashboard"
+      },
+      "forgot": {
+        "pageTitle": "Forgot Password",
+        "title": "Forgot Password",
+        "description": "Enter your email and we'll send you a reset link.",
+        "submit": "Send Reset Link",
+        "sentTitle": "Check your inbox",
+        "sentDescription": "If an account exists for {email}, a password reset link has been sent. Check your email and follow the link."
+      },
+      "login": {
+        "title": "Login",
+        "submit": "Login",
+        "createAccount": "Create Account",
+        "backToHome": "Back to Home",
+        "forgotPassword": "Forgot password?"
+      },
+      "update": {
+        "title": "Update Password",
+        "description": "Enter your new password below.",
+        "newPassword": "New Password",
+        "confirmNewPassword": "Confirm New Password",
+        "submit": "Update Password",
+        "doneTitle": "Password Updated!",
+        "doneDescription": "Your password has been changed. You can now log in with your new password.",
+        "goToLogin": "Go to Login"
+      },
+      "signup": {
+        "pageTitle": "Sign Up",
+        "title": "Create Account",
+        "submit": "Create account",
+        "usernamePlaceholder": "e.g: johndoe",
+        "displayNamePlaceholder": "e.g: John Doe",
+        "created": "Account created successfully",
+        "createdDescription": "You still need to verify your email before you can log in.",
+        "failed": "Could not create account",
+        "almostThere": "Almost there!",
+        "verificationSent": "A verification link has been sent to your email. Please check your inbox and follow the instructions to verify your account.",
+        "closePage": "You can close this page. You will be logged in automatically once you verify your email.",
+        "checkSpam": "If you don't see the email, please check your spam folder."
+      }
+    },
+    "navbar": {
+      "defaultUserName": "User",
+      "github": "Pluto on GitHub",
+      "logout": "Logout",
+      "openNavigation": "Open navigation",
+      "goHome": "Go to dashboard home",
+      "visitSite": "Visit {domain}",
+      "viewSite": "View site",
+      "openUserMenu": "Open user menu"
+    },
+    "settings": {
+      "general": {
+        "title": "General",
+        "websiteTitle": "Website Title",
+        "websiteTitlePlaceholder": "e.g. My Website",
+        "websiteDescription": "Website Description",
+        "websiteDescriptionPlaceholder": "e.g. My Website Description",
+        "websiteUrl": "Website URL",
+        "websiteUrlPlaceholder": "e.g. https://example.com"
+      }
+    },
+    "capabilities": {
+      "settingsManage": "Manage site settings",
+      "usersRead": "View all user accounts"
+    },
+    "envWarning": {
+      "title": "Connection string not saved automatically",
+      "intro": "The database change already succeeded. Pluto could not write {variable} to your project's {file} file, so it will ask again next time unless you add it by hand:",
+      "step1": "Open (or create) {file} in your project's root folder.",
+      "step2": "Add this line. Replace any existing {variable} line with it.",
+      "step3": "Restart the server.",
+      "copyLine": "Copy the DATABASE_URL line",
+      "copied": "Copied",
+      "copiedDescription": "The DATABASE_URL line is on your clipboard.",
+      "copyFailed": "Could not copy",
+      "copyFailedDescription": "Select and copy the line by hand instead."
+    },
+    "connection": {
+      "connectionString": "Supabase connection string",
+      "connectionStringHelp": "You can find your connection string {link}.",
+      "connectionStringHelpLink": "clicking here",
+      "password": "Database password",
+      "passwordInfo": "Your password is created when you create your Supabase project. You can change it in the {link}.",
+      "passwordInfoLink": "Supabase Database Settings",
+      "whyTitle": "Why do I need to provide a database password?",
+      "restartTitle": "This restarts the dev server",
+      "restarting": "Dev server restarting",
+      "reconnected": "Reconnected",
+      "stillReconnecting": "Still reconnecting",
+      "stillReconnectingDescription": "The dev server is taking longer than expected. Reload this page in a moment.",
+      "checkConsole": "Please check the console for more details."
+    },
+    "setup": {
+      "title": "Setup Wizard",
+      "steps": {
+        "database": "Database Setup",
+        "complete": "Complete Setup"
+      },
+      "submit": "Set up database",
+      "next": "Submit",
+      "why": "It will be used to create your database structure. It won't be stored anywhere. That's a {promise}! 😉",
+      "promise": "promise",
+      "promiseTooltip": "Click on the 'Technical details' button for more info",
+      "technicalDetails": "Technical details",
+      "technicalDetailsRequest": "When you click \"Next\", a request to {route} will be made with the database password you provided. This API will then use this password to make a direct PostgreSQL connection to your Supabase database and run the SQL queries from this {files}.",
+      "technicalDetailsRoute": "a server route",
+      "technicalDetailsFiles": "SQL files",
+      "technicalDetailsStored": "After the setup is complete, the password will NOT be stored or used for any other purpose.",
+      "restartDescription": "Saving your connection string writes it to .env. In development, that restarts the server automatically. The page will briefly show a reconnecting message — this is expected, not an error.",
+      "restartingDescription": "Setup is finishing. Reconnecting…",
+      "reconnectedDescription": "The server is back. Your database has been set up.",
+      "failed": "Database setup failed",
+      "failedDescription": "Please check your password and try again.",
+      "complete": "Database setup complete",
+      "completeDescription": "Your database has been set up successfully.",
+      "error": "Error setting up the database",
+      "doneTitle": "Setup Complete",
+      "doneDescription": "Your database is ready. Create your admin account by signing up.",
+      "goToSignup": "Go to sign up"
+    },
+    "migrations": {
+      "title": "Migrations",
+      "banner": "{count} layer needs a database migration | {count} layers need a database migration",
+      "goTo": "Go to Migrations",
+      "loading": "Loading migration status…",
+      "upToDate": "Everything is up to date",
+      "upToDateDescription": "No layer needs a database migration.",
+      "pendingLayers": "Pending layers ({count})",
+      "appliedLayers": "Applied layers ({count})",
+      "why": "It is used once to open a direct PostgreSQL connection and run the pending layer schemas. It is then written to .env on the server, so future migrations need no prompt. It is never stored anywhere else, and never sent back to your browser.",
+      "restartDescription": "Saving a new connection string writes it to .env. In development, that restarts the server automatically. The page will briefly show a reconnecting message — this is expected, not an error.",
+      "restartingDescription": "Saving a new connection string restarts the dev server. Reconnecting…",
+      "reconnectingBanner": "Saving a new connection string restarts the dev server. Reconnecting — this page will update on its own once it's back.",
+      "reconnectedAllApplied": "The server is back. All migrations were applied.",
+      "reconnectedPending": "The server is back. {count} layer(s) still pending — check above.",
+      "apply": "Apply pending migrations",
+      "applied": "Migrations applied",
+      "applyFailed": "Could not apply migrations",
+      "connectionRequired": "A database connection string is required.",
+      "error": "Error applying migrations",
+      "lastRun": "Last run",
+      "status": {
+        "applied": "applied",
+        "skipped": "skipped",
+        "failed": "failed"
+      },
+      "loadFailed": "Could not load migration status",
+      "loadFailedDescription": "This isn't the dev-server-restart case above — something else went wrong reading migration status. Check the server console, then try again.",
+      "retry": "Retry"
+    }
+  }
+}

package/i18n/locales/pt-BR.json

@@ -0,0 +1,209 @@
+{
+  "supabase": {
+    "profile": {
+      "migrationPending": "Aplique as migrações pendentes do banco de dados para salvar seu idioma."
+    },
+    "errors": {
+      "notLoggedIn": "Entre na sua conta para continuar.",
+      "notAdmin": "Sua conta não é de administrador.",
+      "missingPermission": "Sua conta não tem a permissão \"{capability}\".",
+      "setupCompleted": "A configuração já foi concluída.",
+      "coreSchemaMissing": "Esquema principal não encontrado. Reinstale @plutocms/supabase e reinicie o servidor de desenvolvimento.",
+      "fetchUsers": "Erro ao buscar os usuários: {message}",
+      "fetchUser": "Erro ao buscar o usuário: {message}",
+      "localeUnsupported": "Este idioma não está disponível.",
+      "duplicateRecord": "Já existe um registro com este valor.",
+      "missingReference": "Isto aponta para um registro que não existe.",
+      "migrationStatus": "Erro ao ler o status das migrações: {message}"
+    },
+    "auth": {
+      "backToLogin": "Voltar para o login",
+      "passwordMismatch": "As senhas não coincidem.",
+      "fields": {
+        "email": "E-mail",
+        "password": "Senha",
+        "username": "Nome de usuário",
+        "displayName": "Nome de exibição",
+        "confirmPassword": "Confirmar senha"
+      },
+      "toasts": {
+        "loginFailed": "Não foi possível entrar",
+        "loggedOut": "Sessão encerrada com sucesso",
+        "resetFailed": "Não foi possível enviar o e-mail de redefinição",
+        "updateFailed": "Não foi possível atualizar a senha",
+        "passwordUpdated": "Senha atualizada com sucesso",
+        "notLoggedIn": "Você não está conectado",
+        "notLoggedInDescription": "Entre na sua conta para continuar."
+      },
+      "errors": {
+        "unknown": "Ocorreu um erro desconhecido.",
+        "invalid_credentials": "E-mail ou senha inválidos.",
+        "email_not_confirmed": "Seu e-mail ainda não foi confirmado. Verifique sua caixa de entrada para encontrar o link de verificação.",
+        "over_request_rate_limit": "Muitas tentativas. Aguarde um momento e tente novamente.",
+        "over_email_send_rate_limit": "Muitos e-mails enviados. Aguarde um momento e tente novamente.",
+        "weak_password": "Esta senha é muito fraca. Escolha uma senha mais forte.",
+        "same_password": "A nova senha deve ser diferente da senha atual.",
+        "user_not_found": "Nenhuma conta foi encontrada para este e-mail.",
+        "email_exists": "Já existe uma conta com este e-mail.",
+        "user_already_exists": "Já existe uma conta com este e-mail.",
+        "signup_disabled": "O cadastro está desativado neste site.",
+        "email_address_invalid": "Este endereço de e-mail não é válido."
+      },
+      "confirm": {
+        "pageTitle": "Verificação da conta",
+        "title": "Conta verificada!",
+        "description": "Sua conta foi verificada com sucesso. Agora você já pode usar o painel.",
+        "goToDashboard": "Ir para o painel"
+      },
+      "forgot": {
+        "pageTitle": "Esqueceu a senha?",
+        "title": "Esqueceu a senha?",
+        "description": "Informe seu e-mail e enviaremos um link de redefinição.",
+        "submit": "Enviar link de redefinição",
+        "sentTitle": "Verifique sua caixa de entrada",
+        "sentDescription": "Se existir uma conta para {email}, enviamos um link de redefinição de senha. Verifique seu e-mail e siga o link."
+      },
+      "login": {
+        "title": "Entrar",
+        "submit": "Entrar",
+        "createAccount": "Criar conta",
+        "backToHome": "Voltar para o início",
+        "forgotPassword": "Esqueceu a senha?"
+      },
+      "update": {
+        "title": "Atualizar senha",
+        "description": "Informe sua nova senha abaixo.",
+        "newPassword": "Nova senha",
+        "confirmNewPassword": "Confirmar nova senha",
+        "submit": "Atualizar senha",
+        "doneTitle": "Senha atualizada!",
+        "doneDescription": "Sua senha foi alterada. Agora você já pode entrar com a nova senha.",
+        "goToLogin": "Ir para o login"
+      },
+      "signup": {
+        "pageTitle": "Cadastro",
+        "title": "Criar conta",
+        "submit": "Criar conta",
+        "usernamePlaceholder": "ex.: joaosilva",
+        "displayNamePlaceholder": "ex.: João Silva",
+        "created": "Conta criada com sucesso",
+        "createdDescription": "Ainda é preciso verificar seu e-mail para poder entrar.",
+        "failed": "Não foi possível criar a conta",
+        "almostThere": "Quase lá!",
+        "verificationSent": "Enviamos um link de verificação para o seu e-mail. Verifique sua caixa de entrada e siga as instruções para verificar sua conta.",
+        "closePage": "Você pode fechar esta página. Você entrará automaticamente assim que verificar seu e-mail.",
+        "checkSpam": "Se você não encontrar o e-mail, verifique sua pasta de spam."
+      }
+    },
+    "navbar": {
+      "defaultUserName": "Usuário",
+      "github": "Pluto no GitHub",
+      "logout": "Sair",
+      "openNavigation": "Abrir navegação",
+      "goHome": "Ir para o início do painel",
+      "visitSite": "Visitar {domain}",
+      "viewSite": "Ver site",
+      "openUserMenu": "Abrir menu do usuário"
+    },
+    "settings": {
+      "general": {
+        "title": "Geral",
+        "websiteTitle": "Título do site",
+        "websiteTitlePlaceholder": "ex.: Meu site",
+        "websiteDescription": "Descrição do site",
+        "websiteDescriptionPlaceholder": "ex.: Descrição do meu site",
+        "websiteUrl": "URL do site",
+        "websiteUrlPlaceholder": "ex.: https://exemplo.com"
+      }
+    },
+    "capabilities": {
+      "settingsManage": "Gerenciar as configurações do site",
+      "usersRead": "Ver todas as contas de usuário"
+    },
+    "envWarning": {
+      "title": "A string de conexão não foi salva automaticamente",
+      "intro": "A alteração no banco de dados já foi concluída. O Pluto não conseguiu gravar {variable} no arquivo {file} do seu projeto. Por isso, ele vai pedir de novo na próxima vez, a menos que você adicione a linha manualmente:",
+      "step1": "Abra (ou crie) o arquivo {file} na pasta raiz do seu projeto.",
+      "step2": "Adicione esta linha. Substitua qualquer linha {variable} existente por ela.",
+      "step3": "Reinicie o servidor.",
+      "copyLine": "Copiar a linha DATABASE_URL",
+      "copied": "Copiado",
+      "copiedDescription": "A linha DATABASE_URL está na sua área de transferência.",
+      "copyFailed": "Não foi possível copiar",
+      "copyFailedDescription": "Selecione e copie a linha manualmente."
+    },
+    "connection": {
+      "connectionString": "String de conexão do Supabase",
+      "connectionStringHelp": "Você encontra sua string de conexão {link}.",
+      "connectionStringHelpLink": "clicando aqui",
+      "password": "Senha do banco de dados",
+      "passwordInfo": "Sua senha é criada quando você cria seu projeto no Supabase. Você pode alterá-la em {link}.",
+      "passwordInfoLink": "Configurações do banco de dados do Supabase",
+      "whyTitle": "Por que preciso informar a senha do banco de dados?",
+      "restartTitle": "Isto reinicia o servidor de desenvolvimento",
+      "restarting": "Servidor de desenvolvimento reiniciando",
+      "reconnected": "Reconectado",
+      "stillReconnecting": "Ainda reconectando",
+      "stillReconnectingDescription": "O servidor de desenvolvimento está demorando mais que o esperado. Recarregue esta página em instantes.",
+      "checkConsole": "Verifique o console para ver mais detalhes."
+    },
+    "setup": {
+      "title": "Assistente de configuração",
+      "steps": {
+        "database": "Configuração do banco de dados",
+        "complete": "Concluir configuração"
+      },
+      "submit": "Configurar banco de dados",
+      "next": "Enviar",
+      "why": "Ela será usada para criar a estrutura do seu banco de dados. Ela não será armazenada em nenhum lugar. Isso é uma {promise}! 😉",
+      "promise": "promessa",
+      "promiseTooltip": "Clique no botão 'Detalhes técnicos' para saber mais",
+      "technicalDetails": "Detalhes técnicos",
+      "technicalDetailsRequest": "Ao clicar em \"Próximo\", será feita uma requisição para {route} com a senha do banco de dados que você informou. Essa API usará a senha para abrir uma conexão direta do PostgreSQL com seu banco de dados do Supabase e executar as consultas SQL destes {files}.",
+      "technicalDetailsRoute": "uma rota do servidor",
+      "technicalDetailsFiles": "arquivos SQL",
+      "technicalDetailsStored": "Depois que a configuração terminar, a senha NÃO será armazenada nem usada para nenhum outro fim.",
+      "restartDescription": "Salvar sua string de conexão a grava no arquivo .env. Em desenvolvimento, isso reinicia o servidor automaticamente. A página vai exibir brevemente uma mensagem de reconexão. Isso é esperado e não é um erro.",
+      "restartingDescription": "A configuração está terminando. Reconectando…",
+      "reconnectedDescription": "O servidor voltou. Seu banco de dados foi configurado.",
+      "failed": "Falha ao configurar o banco de dados",
+      "failedDescription": "Verifique sua senha e tente novamente.",
+      "complete": "Banco de dados configurado",
+      "completeDescription": "Seu banco de dados foi configurado com sucesso.",
+      "error": "Erro ao configurar o banco de dados",
+      "doneTitle": "Configuração concluída",
+      "doneDescription": "Seu banco de dados está pronto. Crie sua conta de administrador fazendo o cadastro.",
+      "goToSignup": "Ir para o cadastro"
+    },
+    "migrations": {
+      "title": "Migrações",
+      "banner": "{count} camada precisa de uma migração do banco de dados | {count} camadas precisam de uma migração do banco de dados",
+      "goTo": "Ir para as migrações",
+      "loading": "Carregando o status das migrações…",
+      "upToDate": "Tudo está atualizado",
+      "upToDateDescription": "Nenhuma camada precisa de migração do banco de dados.",
+      "pendingLayers": "Camadas pendentes ({count})",
+      "appliedLayers": "Camadas aplicadas ({count})",
+      "why": "Ela é usada uma única vez para abrir uma conexão direta do PostgreSQL e executar os esquemas pendentes das camadas. Depois, é gravada no arquivo .env do servidor, e as próximas migrações não precisam pedir a senha. Ela nunca é armazenada em outro lugar e nunca é enviada de volta ao seu navegador.",
+      "restartDescription": "Salvar uma nova string de conexão a grava no arquivo .env. Em desenvolvimento, isso reinicia o servidor automaticamente. A página vai exibir brevemente uma mensagem de reconexão. Isso é esperado e não é um erro.",
+      "restartingDescription": "Salvar uma nova string de conexão reinicia o servidor de desenvolvimento. Reconectando…",
+      "reconnectingBanner": "Salvar uma nova string de conexão reinicia o servidor de desenvolvimento. Reconectando — esta página será atualizada sozinha quando o servidor voltar.",
+      "reconnectedAllApplied": "O servidor voltou. Todas as migrações foram aplicadas.",
+      "reconnectedPending": "O servidor voltou. {count} camada(s) ainda pendente(s) — verifique acima.",
+      "apply": "Aplicar migrações pendentes",
+      "applied": "Migrações aplicadas",
+      "applyFailed": "Não foi possível aplicar as migrações",
+      "connectionRequired": "É necessária uma string de conexão do banco de dados.",
+      "error": "Erro ao aplicar as migrações",
+      "lastRun": "Última execução",
+      "status": {
+        "applied": "aplicada",
+        "skipped": "ignorada",
+        "failed": "falhou"
+      },
+      "loadFailed": "Não foi possível carregar o status das migrações",
+      "loadFailedDescription": "Este não é o caso de reinício do servidor de desenvolvimento descrito acima. Algo diferente deu errado ao ler o status das migrações. Verifique o console do servidor e tente novamente.",
+      "retry": "Tentar novamente"
+    }
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@plutocms/supabase",
   "type": "module",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "trustedDependencies": [
     "@parcel/watcher",
     "@plutocms/pluto",
@@ -30,7 +30,7 @@
     "postinstall": "nuxt prepare",
     "prettier": "prettier --write .",
     "lint": "eslint .",
-    "lint:fix": "eslint . --fix && prettier --write .",
+    "lint:fix": "eslint . --fix",
     "typecheck": "nuxi typecheck",
     "test": "vitest run",
     "supabase-types": "bun ./scripts/supabase-typegen.ts"
@@ -39,7 +39,7 @@
     "@nuxt/eslint": "^1.17.0",
     "@nuxt/ui": "^4.12.0",
     "@nuxtjs/supabase": "^2.1.0",
-    "@plutocms/pluto": "^0.13.0",
+    "@plutocms/pluto": "^0.14.0",
     "@plutocms/utils": "^0.2.1",
     "postgres": "^3.4.9",
     "supabase": "^2.121.0",

package/server/api/profile/locale.get.ts

@@ -0,0 +1,39 @@
+import { serverSupabaseClient, serverSupabaseUser } from '#supabase/server'
+
+/**
+ * The calling user's own admin language. `null` means Automatic: the user
+ * has not chosen one. No admin gate: every signed-in user reads their own
+ * row. A signed-out caller gets `null`, not a 401, so the client never has
+ * to special-case this route's error path.
+ *
+ * Read `user.sub`, not `user.id`. See server/utils/admin-guard.ts.
+ */
+export default defineEventHandler(async (event) => {
+  const user = await serverSupabaseUser(event)
+
+  if (!user) {
+    return { locale: null as string | null }
+  }
+
+  const client = await serverSupabaseClient<Database>(event)
+  const { data, error } = await client
+    .from('profiles')
+    .select('locale')
+    .eq('id', user.sub)
+    .maybeSingle()
+
+  if (error) {
+    // profiles.locale is added by 005_profile_locale.sql. A site that has
+    // upgraded this package but not yet applied that migration has no such
+    // column. That state is expected and temporary, so degrade to
+    // "Automatic" instead of a 500. The same choice is made in
+    // server/api/permissions/me.get.ts.
+    console.error(
+      'profiles.locale read failed, returning no locale:',
+      error.message
+    )
+    return { locale: null as string | null }
+  }
+
+  return { locale: data?.locale ?? null }
+})

package/server/api/profile/locale.post.ts

@@ -0,0 +1,71 @@
+import { z } from 'zod'
+import { serverSupabaseClient, serverSupabaseUser } from '#supabase/server'
+import { parseBody } from '../../utils/validate'
+
+const localeSchema = z.object({
+  locale: z.string().nullable(),
+})
+
+/**
+ * True when PostgREST says the function does not exist. PGRST202 is
+ * PostgREST's own "function not found" code. 42883 is the Postgres code.
+ */
+function isMissingFunction(error: {
+  code?: string
+  message?: string
+}): boolean {
+  return (
+    error.code === 'PGRST202' ||
+    error.code === '42883' ||
+    /could not find the function/i.test(error.message ?? '')
+  )
+}
+
+/**
+ * Stores the calling user's admin language. Pass `null` for Automatic.
+ *
+ * The write goes through `public.set_my_locale()`, a SECURITY DEFINER
+ * function from 005_profile_locale.sql. `profiles` has no UPDATE policy on
+ * purpose, so a user can never write `is_admin`.
+ */
+export default defineEventHandler(async (event) => {
+  const user = await serverSupabaseUser(event)
+
+  if (!user) {
+    throw createPlutoError({
+      statusCode: 401,
+      message: 'You must be logged in.',
+      key: 'supabase.errors.notLoggedIn',
+    })
+  }
+
+  const { locale } = await parseBody(event, localeSchema)
+  const { adminLocales } = useRuntimeConfig().public.plutoI18n
+
+  if (locale !== null && !adminLocales.includes(locale)) {
+    throw createPlutoError({
+      statusCode: 400,
+      message: 'This language is not supported.',
+      key: 'supabase.errors.localeUnsupported',
+    })
+  }
+
+  const client = await serverSupabaseClient<Database>(event)
+  const { error } = await client.rpc('set_my_locale', {
+    new_locale: locale as string,
+  })
+
+  if (error) {
+    if (isMissingFunction(error)) {
+      throw createPlutoError({
+        statusCode: 409,
+        message: 'Apply the pending database migrations to save your language.',
+        key: 'supabase.profile.migrationPending',
+      })
+    }
+
+    throw createError({ statusCode: 500, statusMessage: error.message })
+  }
+
+  return { locale }
+})

package/server/api/setup/create.post.ts

@@ -23,9 +23,10 @@ export default defineEventHandler(async (event) => {
   // server/api/migrations/run.post.ts, which calls it "the whole security
   // model for this endpoint."
   if (process.env.DATABASE_URL) {
-    throw createError({
+    throw createPlutoError({
       statusCode: 403,
-      statusMessage: 'Setup has already been completed.',
+      message: 'Setup has already been completed.',
+      key: 'supabase.errors.setupCompleted',
     })
   }
 
@@ -47,10 +48,11 @@ export default defineEventHandler(async (event) => {
   // it over HTTP means this route needs no `baseUrl` from the caller, and
   // can no longer be made to fetch or execute SQL from an arbitrary origin.
   if (!layers.core?.length) {
-    throw createError({
+    throw createPlutoError({
       statusCode: 500,
-      statusMessage:
+      message:
         'Core schema not found. Reinstall @plutocms/supabase and restart the dev server.',
+      key: 'supabase.errors.coreSchemaMissing',
     })
   }
 

package/server/api/users/[id].get.ts

@@ -14,9 +14,11 @@ export default defineEventHandler(async (event) => {
     .eq('id', id)
 
   if (error) {
-    throw createError({
+    throw createPlutoError({
       statusCode: 500,
-      statusMessage: `Error fetching user: ${error.message}`,
+      message: `Error fetching user: ${error.message}`,
+      key: 'supabase.errors.fetchUser',
+      params: { message: error.message },
     })
   }
 

package/server/api/users/index.get.ts

@@ -9,9 +9,11 @@ export default defineEventHandler(async (event) => {
   const { data: users, error } = await client.from('profiles').select('*')
 
   if (error) {
-    throw createError({
+    throw createPlutoError({
       statusCode: 500,
-      statusMessage: `Error fetching users: ${error.message}`,
+      message: `Error fetching users: ${error.message}`,
+      key: 'supabase.errors.fetchUsers',
+      params: { message: error.message },
     })
   }
 

package/server/utils/admin-guard.ts

@@ -45,7 +45,11 @@ export async function requireAdmin(event: H3Event) {
   const user = await serverSupabaseUser(event)
 
   if (!user) {
-    throw createError({ statusCode: 401, statusMessage: 'You must be logged in.' })
+    throw createPlutoError({
+      statusCode: 401,
+      message: 'You must be logged in.',
+      key: 'supabase.errors.notLoggedIn',
+    })
   }
 
   const client = await serverSupabaseClient<Database>(event)
@@ -64,7 +68,11 @@ export async function requireAdmin(event: H3Event) {
   }
 
   if (error || !profile?.is_admin) {
-    throw createError({ statusCode: 403, statusMessage: 'Your account is not an admin.' })
+    throw createPlutoError({
+      statusCode: 403,
+      message: 'Your account is not an admin.',
+      key: 'supabase.errors.notAdmin',
+    })
   }
 
   return user