@plutocms/supabase 0.9.1 → 0.11.0

package/i18n/locales/pt-BR.json

@@ -0,0 +1,193 @@
+{
+  "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",
+        "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"
+      },
+      "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"
+      },
+      "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."
+      }
+    },
+    "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.11.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.16.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

package/server/utils/capability-guard.ts

@@ -5,8 +5,10 @@ import { serverSupabaseClient, serverSupabaseUser } from '#supabase/server'
 export const ALL_CAPABILITIES = '*'
 
 interface RequireCapabilityOptions {
-  /** Overrides the 403 message. */
+  /** Overrides the 403 message. English text. */
   message?: string
+  /** Translation key of the `message` override, for the admin UI. */
+  messageKey?: string
 }
 
 /**
@@ -34,17 +36,29 @@ export async function requireCapability(
   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)
   const { data, error } = await client.rpc('has_capability', { cap: capability })
 
   if (error || data !== true) {
-    throw createError({
+    // A custom `message` without a `messageKey` has no translation, so it
+    // keeps the plain English error.
+    if (options?.message && !options.messageKey) {
+      throw createError({ statusCode: 403, statusMessage: options.message })
+    }
+
+    throw createPlutoError({
       statusCode: 403,
-      statusMessage:
+      message:
         options?.message ?? `Your account is missing the "${capability}" permission.`,
+      key: options?.messageKey ?? 'supabase.errors.missingPermission',
+      params: { capability },
     })
   }
 

package/server/utils/content-adapter.ts

@@ -82,17 +82,19 @@ export function toContentError(error: PostgrestError) {
 
   // 23505: unique_violation.
   if (error.code === '23505') {
-    return createError({
+    return createPlutoError({
       statusCode: 409,
-      statusMessage: 'A record with this value already exists.',
+      message: 'A record with this value already exists.',
+      key: 'supabase.errors.duplicateRecord',
     })
   }
 
   // 23503: foreign_key_violation.
   if (error.code === '23503') {
-    return createError({
+    return createPlutoError({
       statusCode: 400,
-      statusMessage: 'This references a record that does not exist.',
+      message: 'This references a record that does not exist.',
+      key: 'supabase.errors.missingReference',
     })
   }
 

package/server/utils/validate.ts

@@ -37,7 +37,12 @@ export async function parseBody<T>(event: H3Event, schema: ZodSchema<T>): Promis
       message: issue.message,
     }))
 
-    throw createError({ statusCode: 400, statusMessage: 'Validation failed.', data: { errors } })
+    throw createPlutoError({
+      statusCode: 400,
+      message: 'Validation failed.',
+      key: 'pluto.errors.validationFailed',
+      data: { errors },
+    })
   }
 
   return result.data

package/shared/types/supabase.ts

@@ -232,6 +232,7 @@ export type Database = {
           email: string | null
           id: string
           is_admin: boolean
+          locale: string | null
           updated_at: string | null
           username: string | null
         }
@@ -240,6 +241,7 @@ export type Database = {
           email?: string | null
           id: string
           is_admin?: boolean
+          locale?: string | null
           updated_at?: string | null
           username?: string | null
         }
@@ -248,6 +250,7 @@ export type Database = {
           email?: string | null
           id?: string
           is_admin?: boolean
+          locale?: string | null
           updated_at?: string | null
           username?: string | null
         }
@@ -364,6 +367,10 @@ export type Database = {
         Args: Record<PropertyKey, never>
         Returns: boolean
       }
+      set_my_locale: {
+        Args: { new_locale: string }
+        Returns: undefined
+      }
     }
     Enums: {
       thealthcheck: "first_setup"