@fayz-ai/core 0.8.0 → 0.8.2

package/src/data/count.ts

@@ -0,0 +1,131 @@
+import { getSupabaseClientOptional } from './supabase'
+import { getActiveTenantId } from '../tenant'
+
+/**
+ * Tenant-scoped row counter — the single cheap `count(*)` helper the access
+ * engine uses to resolve quantity limits. Uses Supabase's `head:true` count so
+ * no rows are transferred. Results are cached briefly per tenant+table+filter to
+ * survive the burst of reads a page does (nav badge + gate + list), and can be
+ * force-invalidated by creates via {@link invalidateCount}.
+ *
+ * MOCK MODE NEVER BLOCKS: with no global Supabase client the count is `0`, so
+ * limits always read as "well under cap" — offline/demo apps stay fully usable.
+ */
+
+export interface CountByTenantOptions {
+  /** Optional `kind` column filter for multi-kind tables. */
+  kind?: string
+  /** `'month'` counts rows created since the 1st of the current month; `'total'` (default) counts all. */
+  period?: 'month' | 'total'
+  /** Tenant override; defaults to the active tenant (getActiveTenantId). */
+  tenantId?: string
+  /** Skip the short-lived cache and hit the DB (used by fresh guard checks). */
+  fresh?: boolean
+}
+
+const TTL_MS = 15_000
+
+interface CacheEntry {
+  value: number
+  expires: number
+}
+
+const cache = new Map<string, CacheEntry>()
+
+function cacheKey(table: string, tenantId: string, kind: string | undefined, period: string): string {
+  return `${tenantId}::${table}::${kind ?? ''}::${period}`
+}
+
+function startOfMonthISO(): string {
+  const now = new Date()
+  return new Date(now.getFullYear(), now.getMonth(), 1).toISOString()
+}
+
+/**
+ * How long a usage count may take before we give up on it. Failing OPEN on an
+ * error was always the policy (see below); a request that never settles is the
+ * same failure with worse symptoms — a caller awaiting this (the create guards)
+ * hangs forever, which reads to the user as a dead button. Observed on a cold
+ * boot, where the query can be issued before the auth session is ready.
+ */
+const COUNT_TIMEOUT_MS = 5_000
+
+/**
+ * Count rows in `table` for the given (or active) tenant.
+ * Returns 0 when no Supabase client is registered (mock mode).
+ */
+export async function countByTenant(table: string, options: CountByTenantOptions = {}): Promise<number> {
+  const tenantId = options.tenantId ?? getActiveTenantId()
+  if (!tenantId) return 0
+
+  const period = options.period ?? 'total'
+  const key = cacheKey(table, tenantId, options.kind, period)
+
+  if (!options.fresh) {
+    const hit = cache.get(key)
+    if (hit && hit.expires > Date.now()) return hit.value
+  }
+
+  const client = getSupabaseClientOptional() as {
+    from: (t: string) => {
+      select: (columns: string, opts: { count: 'exact'; head: true }) => {
+        eq: (col: string, val: unknown) => unknown
+      }
+    }
+  } | null
+
+  // No client → mock/offline mode: never block.
+  if (!client) return 0
+
+  let query = client.from(table).select('*', { count: 'exact', head: true }).eq('tenant_id', tenantId) as {
+    eq: (col: string, val: unknown) => unknown
+    gte: (col: string, val: unknown) => unknown
+  }
+
+  if (options.kind) {
+    query = query.eq('kind', options.kind) as typeof query
+  }
+  if (period === 'month') {
+    query = query.gte('created_at', startOfMonthISO()) as typeof query
+  }
+
+  // On error OR timeout, fail OPEN (return 0) — a counting failure must never
+  // wall a tenant out of their own product, and must never hang the UI awaiting
+  // it. Enforcement's source of truth is the DB anyway.
+  let timer: ReturnType<typeof setTimeout> | undefined
+  const timeout = new Promise<{ count: null; error: unknown; timedOut: true }>((resolve) => {
+    timer = setTimeout(() => resolve({ count: null, error: 'timeout', timedOut: true }), COUNT_TIMEOUT_MS)
+  })
+  const settled = await Promise.race([
+    query as unknown as Promise<{ count: number | null; error: unknown }>,
+    timeout,
+  ])
+  if (timer) clearTimeout(timer)
+
+  const { count, error } = settled
+  const value = error ? 0 : count ?? 0
+
+  // A timed-out count is not a fact about the tenant — caching it would make one
+  // slow request suppress the guard for the whole TTL.
+  if (!(settled as { timedOut?: true }).timedOut) {
+    cache.set(key, { value, expires: Date.now() + TTL_MS })
+  }
+  return value
+}
+
+/**
+ * Drop cached counts. Called by create handlers (via invalidateLimit) so the
+ * next read reflects the row they just added.
+ *
+ * @param tenantOrKey Substring matched against cache keys (a tenant id, a table
+ *   name, or any fragment). Omit to clear the entire cache.
+ */
+export function invalidateCount(tenantOrKey?: string): void {
+  if (!tenantOrKey) {
+    cache.clear()
+    return
+  }
+  for (const key of cache.keys()) {
+    if (key.includes(tenantOrKey)) cache.delete(key)
+  }
+}

package/src/data/index.ts

@@ -1,4 +1,6 @@
 export { createSupabaseProvider, setGlobalSupabaseClient, getSupabaseClientOptional } from './supabase'
+export { countByTenant, invalidateCount } from './count'
+export type { CountByTenantOptions } from './count'
 export { getFayzCloudClient, FAYZ_CLOUD_URL, FAYZ_CLOUD_PUBLISHABLE_KEY } from './cloud'
 export { createFayzApiProvider } from './platform-api'
 export { createMockProvider } from './mock'

package/src/data/resolve.ts

@@ -66,8 +66,14 @@ export function resolveDataProvider<T extends { id: string }>(
 
   if (client && entityDef.data?.table) {
     const tenantId = () => getActiveTenantId()
+    // Archetype entities share a physical table (e.g. people) across kinds
+    // (student/teacher/staff…). The cache key must carry the kind or the first
+    // kind's resultset is served to every sibling entity (teachers page
+    // listing students).
     const cacheOptions = {
-      table: entityDef.data.table,
+      table: entityDef.data.archetypeKind
+        ? `${entityDef.data.table}#${entityDef.data.archetypeKind}`
+        : entityDef.data.table,
       tenantId,
       ttl: entityDef.data.cacheTTL,
     }

package/src/entity/registry.ts

@@ -8,6 +8,13 @@ export interface RegisteredEntity {
   icon?: string
   fields: EntityDef['fields']
   source: 'app' | 'plugin'
+  /**
+   * The definition itself, so consumers that need to *read* the entity — the AI
+   * tool executor resolving a data provider — are not limited to the display
+   * metadata. Optional: registrations made before this existed omit it.
+   */
+  entityDef?: EntityDef
+  mockData?: Array<{ id: string }>
   archetype?: EntityArchetype
   pluginId?: string
   pluginName?: string

package/src/i18n/shell-translations.ts

@@ -137,6 +137,7 @@ export const shellTranslations: Record<string, Record<string, string>> = {
   "crud.import.rowNumber": "Row {{row}}:",
   "crud.import.toastSuccess": "{{count}} records imported",
   "crud.import.noConnection": "Not connected to the database. Import requires an active connection.",
+  "crud.import.limitExceeded": "This import exceeds your plan limit. Upgrade or import fewer rows.",
   "crud.export.action": "Export",
   "crud.export.noData": "No data to export.",
   "crud.export.toastSuccess": "{{count}} records exported",
@@ -199,6 +200,17 @@ export const shellTranslations: Record<string, Record<string, string>> = {
   "billing.title": "Billing",
   "billing.subtitle": "Manage your subscription and billing.",
   "billing.currentPlan": "Current Plan",
+  "billing.subscription.title": "Subscription",
+  "billing.subscription.subtitle": "Manage your plan and unlock more features.",
+  "billing.changeToPlan": "Switch to this plan",
+  "billing.featureMatrix": "Feature comparison",
+  "billing.changePlanConfirmTitle": "Change plan?",
+  "billing.changePlanConfirmBody": "You're switching to the {{plan}} plan.",
+  "billing.changePlanConfirm": "Switch plan",
+  "billing.planChanged": "You're now on the {{plan}} plan.",
+  "billing.planChangeFailed": "Couldn't change your plan. Please try again.",
+  "billing.noPlans": "No plans are configured.",
+  "billing.pro": "Pro",
   "billing.upgrade": "Upgrade",
   "billing.downgrade": "Downgrade",
   "billing.monthly": "Monthly",
@@ -259,11 +271,68 @@ export const shellTranslations: Record<string, Record<string, string>> = {
   "organization.onboarding.failedCreate": "Failed to create workspace",
   "settings.title": "Settings",
   "settings.subtitle": "Manage your account and organization preferences.",
+  "settings.backToHome": "Back to home",
+  "settings.navLinks": "Settings links",
   "settings.general": "General",
   "settings.properties": "Properties",
   "settings.profile": "Profile",
   "settings.branding": "Branding",
   "settings.security": "Security",
+  "settings.subscription": "Subscription",
+  "upgrade.title": 'Premium feature',
+  "upgrade.description": 'This feature is available on a higher plan. Upgrade to unlock it.',
+  "upgrade.descriptionFeature": 'The {feature} feature is available on a higher plan. Upgrade to unlock it.',
+  // ContactPicker — shared "find the person, or create them" flow.
+  "contactPicker.search": 'Search contact...',
+  "contactPicker.newContact": 'New contact',
+  "contactPicker.name": 'Name',
+  "contactPicker.phone": 'Phone',
+  "contactPicker.emailOptional": 'Email (optional)',
+  "contactPicker.create": 'Create',
+  "contactPicker.creating": 'Creating...',
+  "contactPicker.cancel": 'Cancel',
+  "contactPicker.clear": 'Clear contact',
+  "contactPicker.createFailed": 'Could not create the contact',
+  "contactPicker.addField": 'Add {label}',
+
+  "upgrade.includes": 'Includes {feature}',
+  "upgrade.cta": 'View plans',
+  "upgrade.badgeTooltip": 'Available on a higher plan',
+  "upgrade.unlock": 'Unlock {feature}',
+  "upgrade.currentPlan": 'Your plan: {plan}',
+  "upgrade.recommended": 'Recommended',
+  "upgrade.ctaUpgrade": 'Upgrade',
+  "upgrade.ctaUpgradeTo": 'Upgrade to {plan}',
+  "upgrade.compareAll": 'Compare all plans',
+  "upgrade.valueGeneric": 'Get everything you need to grow — included in the plans below.',
+  "upgrade.value.marketing": 'Campaigns, funnel and content to grow your client base.',
+  "upgrade.value.reports": 'Advanced reports and insights to make sharper decisions.',
+  "upgrade.value.fin_reconciliation": 'Reconcile payments and keep your cash flow under control.',
+  "billing.unlimited": 'Unlimited',
+  "billing.upTo": 'Up to {count}',
+  "limit.label.clients": 'clients',
+  "limit.label.users": 'team members',
+  "limit.label.locations": 'locations',
+  "limit.label.bookings_month": 'monthly bookings',
+  "limit.label.products": 'products',
+  "limit.label.students": 'students',
+  "limit.label.courses": 'courses',
+  "limit.label.contacts": 'contacts',
+  "limit.label.deals": 'deals',
+  "limit.label.menu_items": 'menu items',
+  "limit.label.orders_month": 'monthly orders',
+  "limit.label.connected_banks": 'connected banks',
+  "limit.label.movements_month": 'monthly movements',
+  "limit.label.leads": 'leads',
+  "limit.label.quotes": 'quotes',
+  "limit.label.conversations_month": 'monthly conversations',
+  "limit.label.recipes": 'recipes',
+  "limit.label.form_templates": 'form templates',
+  "limit.label.documents_month": 'monthly documents',
+  "limit.label.content_posts_month": 'monthly content posts',
+  "limit.label.blog_posts": 'blog posts',
+  "limit.reached": 'Você atingiu o limite de {label} do plano {plan}.',
+  "banner.overLimit": 'Você excedeu o limite de {label} do seu plano — faça upgrade para continuar crescendo.',
   "settings.team": "Team",
   "settings.permissions": "Permissions",
   "settings.locations": "Locations",
@@ -303,6 +372,10 @@ export const shellTranslations: Record<string, Record<string, string>> = {
   "app.notFound.goToDashboard": "Go to Dashboard",
   "app.accessDenied.heading": "Access Denied",
   "app.accessDenied.message": "You don't have permission to view this page.",
+  "shell.accessDenied.title": "Access restricted",
+  "shell.accessDenied.message": "You don't have permission to view this page.",
+  "organization.workspaces": "Workspaces",
+  "organization.onlyWorkspace": "This is your only workspace.",
   "auth.login.enterCredentials": "Enter your credentials to access your account",
   "auth.login.failedDefault": "Failed to sign in. Please try again.",
   "auth.login.failedWithProvider": "Failed to sign in with {{provider}}.",
@@ -343,6 +416,17 @@ export const shellTranslations: Record<string, Record<string, string>> = {
   "chat.tryAsking": "Try asking",
   "chat.fab.tryIt": "Try it",
   "chat.messagePlaceholder": "Message...",
+  "chat.notConfigured": "Assistant not configured — set chat.apiEndpoint to enable conversations.",
+  "chat.confirmAction.title": "Confirm this action?",
+  "chat.confirmAction.confirm": "Confirm",
+  "chat.confirmAction.cancel": "Cancel",
+  "chat.confirmAction.blocked": "Respond to the confirmation above first",
+  "chat.signingIn": "One moment — still confirming your session.",
+  "chat.history": "Previous conversations",
+  "chat.newConversation": "New conversation",
+  "chat.untitledConversation": "Untitled conversation",
+  "chat.renameConversation": "Rename",
+  "chat.saveTitle": "Save title",
   "chat.toolsAvailable": "{{count}} tools available",
   "chat.suggestion.dashboard.kpi-summary.0": "How is my business doing today?",
   "chat.suggestion.dashboard.kpi-summary.1": "What's my revenue today?",
@@ -586,6 +670,38 @@ export const shellTranslations: Record<string, Record<string, string>> = {
   "crud.archetype.activity.description": "View a chronological log of all actions, changes, and events related to this person.",
   "crud.archetype.documents.title": "Documents",
   "crud.archetype.documents.description": "Attach and manage files, contracts, certifications, and other documents for this person.",
+  "crud.archetype.addresses.add": "Add address",
+  "crud.archetype.addresses.addTitle": "New address",
+  "crud.archetype.addresses.editTitle": "Edit address",
+  "crud.archetype.addresses.formDescription": "Postal code, street and city are required; everything else is optional.",
+  "crud.archetype.addresses.emptyTitle": "No address on file",
+  "crud.archetype.addresses.emptyDescription": "Add where this person is delivered to, collected from, or billed at.",
+  "crud.archetype.addresses.fallbackLabel": "Address",
+  "crud.archetype.addresses.labelPlaceholder": "Home, Work…",
+  "crud.archetype.addresses.default": "Default",
+  "crud.archetype.addresses.setDefault": "Use as the default address",
+  "crud.archetype.addresses.kind.both": "Shipping and billing",
+  "crud.archetype.addresses.kind.shipping": "Shipping",
+  "crud.archetype.addresses.kind.billing": "Billing",
+  "crud.archetype.addresses.field.label": "Label",
+  "crud.archetype.addresses.field.kind": "Use",
+  "crud.archetype.addresses.field.postalCode": "Postal code",
+  "crud.archetype.addresses.field.street": "Street",
+  "crud.archetype.addresses.field.number": "Number",
+  "crud.archetype.addresses.field.complement": "Complement",
+  "crud.archetype.addresses.field.district": "District",
+  "crud.archetype.addresses.field.city": "City",
+  "crud.archetype.addresses.field.state": "State",
+  "crud.archetype.addresses.field.recipient": "Recipient",
+  "crud.archetype.addresses.field.phone": "Phone",
+  "crud.archetype.addresses.created": "Address added",
+  "crud.archetype.addresses.updated": "Address updated",
+  "crud.archetype.addresses.deleted": "Address removed",
+  "crud.archetype.addresses.deleteTitle": "Remove this address?",
+  "crud.archetype.addresses.loadFailed": "Could not load the addresses.",
+  "crud.archetype.addresses.saveFailed": "Could not save the address.",
+  "crud.archetype.addresses.deleteFailed": "Could not remove the address.",
+  "crud.archetype.addresses.noTenant": "No active organization — reload the page and try again.",
   "crud.archetype.schedule.title": "Schedule",
   "crud.archetype.schedule.description": "View and manage appointments, shifts, and availability for this person.",
   "crud.archetype.inventory.title": "Inventory & Stock",
@@ -858,6 +974,17 @@ export const shellTranslations: Record<string, Record<string, string>> = {
   "billing.title": "Faturamento",
   "billing.subtitle": "Gerencie sua assinatura e faturamento.",
   "billing.currentPlan": "Plano Atual",
+  "billing.subscription.title": "Assinatura",
+  "billing.subscription.subtitle": "Gerencie seu plano e desbloqueie mais recursos.",
+  "billing.changeToPlan": "Mudar para este plano",
+  "billing.featureMatrix": "Comparativo de recursos",
+  "billing.changePlanConfirmTitle": "Mudar de plano?",
+  "billing.changePlanConfirmBody": "Você está mudando para o plano {{plan}}.",
+  "billing.changePlanConfirm": "Mudar de plano",
+  "billing.planChanged": "Agora você está no plano {{plan}}.",
+  "billing.planChangeFailed": "Não foi possível mudar seu plano. Tente novamente.",
+  "billing.noPlans": "Nenhum plano configurado.",
+  "billing.pro": "Pro",
   "billing.upgrade": "Fazer Upgrade",
   "billing.downgrade": "Fazer Downgrade",
   "billing.monthly": "Mensal",
@@ -915,11 +1042,66 @@ export const shellTranslations: Record<string, Record<string, string>> = {
   "organization.onboarding.createWorkspace": "Criar Espaço de Trabalho",
   "settings.title": "Configurações",
   "settings.subtitle": "Gerencie sua conta e preferências da organização.",
+  "settings.backToHome": "Voltar para o início",
+  "settings.navLinks": "Links de configuração",
   "settings.general": "Geral",
   "settings.properties": "Propriedades",
   "settings.profile": "Perfil",
   "settings.branding": "Marca",
   "settings.security": "Segurança",
+  "settings.subscription": "Assinatura",
+    "upgrade.title": 'Recurso premium',
+    "upgrade.description": 'Este recurso está disponível em um plano superior. Faça upgrade para liberá-lo.',
+    "upgrade.descriptionFeature": 'O recurso {feature} está disponível em um plano superior. Faça upgrade para liberá-lo.',
+    // ContactPicker — busca-ou-cadastra compartilhado.
+    "contactPicker.search": 'Buscar contato...',
+    "contactPicker.newContact": 'Novo contato',
+    "contactPicker.name": 'Nome',
+    "contactPicker.phone": 'Telefone',
+    "contactPicker.emailOptional": 'E-mail (opcional)',
+    "contactPicker.create": 'Cadastrar',
+    "contactPicker.creating": 'Cadastrando...',
+    "contactPicker.cancel": 'Cancelar',
+    "contactPicker.clear": 'Remover contato',
+    "contactPicker.createFailed": 'Não foi possível cadastrar o contato',
+    "contactPicker.addField": 'Adicionar {label}',
+
+    "upgrade.includes": 'Inclui {feature}',
+    "upgrade.cta": 'Ver planos',
+    "upgrade.badgeTooltip": 'Disponível em um plano superior',
+    "upgrade.unlock": 'Desbloqueie {feature}',
+    "upgrade.currentPlan": 'Seu plano: {plan}',
+    "upgrade.recommended": 'Recomendado',
+    "upgrade.ctaUpgrade": 'Fazer upgrade',
+    "upgrade.ctaUpgradeTo": 'Fazer upgrade para {plan}',
+    "upgrade.compareAll": 'Comparar todos os planos',
+    "upgrade.valueGeneric": 'Tudo o que você precisa para crescer — incluso nos planos abaixo.',
+    "upgrade.value.marketing": 'Campanhas, funil e conteúdo para crescer sua base de clientes.',
+    "upgrade.value.reports": 'Relatórios avançados e insights para decidir com mais precisão.',
+    "upgrade.value.fin_reconciliation": 'Concilie pagamentos e mantenha seu fluxo de caixa sob controle.',
+    "billing.unlimited": 'Ilimitado',
+    "billing.upTo": 'Até {count}',
+    "limit.label.clients": 'clientes',
+    "limit.label.users": 'membros da equipe',
+    "limit.label.locations": 'locais',
+    "limit.label.bookings_month": 'agendamentos mensais',
+    "limit.label.leads": 'leads',
+    "limit.label.quotes": 'orçamentos',
+    "limit.label.conversations_month": 'conversas mensais',
+    "limit.label.recipes": 'receitas',
+    "limit.label.form_templates": 'modelos de formulário',
+    "limit.label.documents_month": 'documentos mensais',
+    "limit.label.content_posts_month": 'posts de conteúdo mensais',
+    "limit.label.blog_posts": 'posts de blog',
+    "limit.label.products": 'produtos',
+    "limit.label.students": 'alunos',
+    "limit.label.courses": 'cursos',
+    "limit.label.contacts": 'contatos',
+    "limit.label.deals": 'negócios',
+    "limit.label.menu_items": 'itens do cardápio',
+    "limit.label.orders_month": 'pedidos mensais',
+    "limit.label.connected_banks": 'bancos conectados',
+    "limit.label.movements_month": 'movimentações mensais',
   "settings.team": "Equipe",
   "settings.permissions": "Permissões",
   "settings.locations": "Locais",
@@ -952,6 +1134,10 @@ export const shellTranslations: Record<string, Record<string, string>> = {
   "app.notFound.goToDashboard": "Ir para o Painel",
   "app.accessDenied.heading": "Acesso Negado",
   "app.accessDenied.message": "Você não tem permissão para acessar esta página.",
+  "shell.accessDenied.title": "Acesso restrito",
+  "shell.accessDenied.message": "Você não tem permissão para acessar esta página.",
+  "organization.workspaces": "Áreas de trabalho",
+  "organization.onlyWorkspace": "Esta é a sua única área de trabalho.",
   "crud.form.requiredIndicator": "*",
   "crud.form.createDescription": "Criar um(a) novo(a) {{entity}}.",
   "crud.form.editDescription": "Atualizar detalhes de {{entity}}.",
@@ -993,6 +1179,7 @@ export const shellTranslations: Record<string, Record<string, string>> = {
   "crud.import.rowNumber": "Linha {{row}}:",
   "crud.import.toastSuccess": "{{count}} registros importados",
   "crud.import.noConnection": "Sem conexão com o banco de dados. A importação requer uma conexão ativa.",
+  "crud.import.limitExceeded": "Esta importação excede o limite do seu plano. Faça upgrade ou importe menos linhas.",
   "crud.export.action": "Exportar",
   "crud.export.noData": "Sem dados para exportar.",
   "crud.export.toastSuccess": "{{count}} registros exportados",
@@ -1087,6 +1274,17 @@ export const shellTranslations: Record<string, Record<string, string>> = {
   "chat.tryAsking": "Experimente perguntar",
   "chat.fab.tryIt": "Experimente",
   "chat.messagePlaceholder": "Mensagem...",
+  "chat.notConfigured": "Assistente não configurado — defina chat.apiEndpoint para habilitar conversas.",
+  "chat.confirmAction.title": "Confirmar esta ação?",
+  "chat.confirmAction.confirm": "Confirmar",
+  "chat.confirmAction.cancel": "Cancelar",
+  "chat.confirmAction.blocked": "Responda a confirmação acima primeiro",
+  "chat.signingIn": "Um instante — ainda estou confirmando sua sessão.",
+  "chat.history": "Conversas anteriores",
+  "chat.newConversation": "Nova conversa",
+  "chat.untitledConversation": "Conversa sem título",
+  "chat.renameConversation": "Renomear",
+  "chat.saveTitle": "Salvar título",
   "chat.toolsAvailable": "{{count}} ferramentas disponíveis",
   "chat.suggestion.dashboard.kpi-summary.0": "Como está meu negócio hoje?",
   "chat.suggestion.dashboard.kpi-summary.1": "Qual o faturamento de hoje?",
@@ -1286,6 +1484,38 @@ export const shellTranslations: Record<string, Record<string, string>> = {
   "crud.archetype.activity.description": "Veja um registro cronológico de todas as ações, alterações e eventos relacionados a esta pessoa.",
   "crud.archetype.documents.title": "Documentos",
   "crud.archetype.documents.description": "Anexe e gerencie arquivos, contratos, certificações e outros documentos desta pessoa.",
+  "crud.archetype.addresses.add": "Adicionar endereço",
+  "crud.archetype.addresses.addTitle": "Novo endereço",
+  "crud.archetype.addresses.editTitle": "Editar endereço",
+  "crud.archetype.addresses.formDescription": "CEP, rua e cidade são obrigatórios; o resto é opcional.",
+  "crud.archetype.addresses.emptyTitle": "Nenhum endereço cadastrado",
+  "crud.archetype.addresses.emptyDescription": "Cadastre onde esta pessoa recebe entregas, é coletada ou é cobrada.",
+  "crud.archetype.addresses.fallbackLabel": "Endereço",
+  "crud.archetype.addresses.labelPlaceholder": "Casa, Trabalho…",
+  "crud.archetype.addresses.default": "Padrão",
+  "crud.archetype.addresses.setDefault": "Usar como endereço padrão",
+  "crud.archetype.addresses.kind.both": "Entrega e cobrança",
+  "crud.archetype.addresses.kind.shipping": "Entrega",
+  "crud.archetype.addresses.kind.billing": "Cobrança",
+  "crud.archetype.addresses.field.label": "Identificação",
+  "crud.archetype.addresses.field.kind": "Uso",
+  "crud.archetype.addresses.field.postalCode": "CEP",
+  "crud.archetype.addresses.field.street": "Rua",
+  "crud.archetype.addresses.field.number": "Número",
+  "crud.archetype.addresses.field.complement": "Complemento",
+  "crud.archetype.addresses.field.district": "Bairro",
+  "crud.archetype.addresses.field.city": "Cidade",
+  "crud.archetype.addresses.field.state": "UF",
+  "crud.archetype.addresses.field.recipient": "Quem recebe",
+  "crud.archetype.addresses.field.phone": "Telefone",
+  "crud.archetype.addresses.created": "Endereço adicionado",
+  "crud.archetype.addresses.updated": "Endereço atualizado",
+  "crud.archetype.addresses.deleted": "Endereço removido",
+  "crud.archetype.addresses.deleteTitle": "Remover este endereço?",
+  "crud.archetype.addresses.loadFailed": "Não foi possível carregar os endereços.",
+  "crud.archetype.addresses.saveFailed": "Não foi possível salvar o endereço.",
+  "crud.archetype.addresses.deleteFailed": "Não foi possível remover o endereço.",
+  "crud.archetype.addresses.noTenant": "Nenhuma organização ativa — recarregue a página e tente de novo.",
   "crud.archetype.schedule.title": "Agenda",
   "crud.archetype.schedule.description": "Visualize e gerencie compromissos, turnos e disponibilidade desta pessoa.",
   "crud.archetype.inventory.title": "Estoque",

package/src/index.ts

@@ -1,17 +1,20 @@
 // Types
 export type { EntityArchetype, BaseEntity, PersonEntity, ProductEntity, ServiceEntity, OrderEntity, TransactionEntity, LocationEntity, ScheduleEntity, CategoryEntity } from './types/entities'
-export type { EntityDef, FieldDef, FieldType, FieldRelation, FieldGroup, DetailTab, FormLayout, ComputedFieldValue } from './types/crud'
-export type { PluginManifest, PluginScope, PluginStatus, ResolvedPluginManifest, PluginRuntime, PluginRuntimeContext, PluginWidgetZone, PluginWidgetDefinition, PluginNavigationEntry, PluginSettingsTab, PluginRouteDefinition, PluginAITool, PluginRegistryDef, PluginMigration, PluginDiagnostic, VerticalId, ScaffoldType, TenantPluginBinding, DashboardWidgetDef, DashboardWidgetKind, DashboardSurface, DashboardLayoutConfig, ResolvedDashboardWidget } from './types/plugins'
+export type { EntityDef, EntityImageConfig, FieldDef, FieldType, FieldRelation, FieldGroup, DetailTab, FormLayout, ComputedFieldValue } from './types/crud'
+export type { PluginManifest, PluginScope, PluginStatus, ResolvedPluginManifest, PluginRuntime, PluginRuntimeContext, PluginWidgetZone, PluginWidgetDefinition, PluginNavigationEntry, PluginSettingsTab, PluginRouteDefinition, PluginAITool, AIToolMode, AIToolExecution, AgentRpcDeclaration, AIToolParameterProperty, AIToolParameters, AIToolSuggestion, PluginRegistryDef, PluginMigration, PluginDiagnostic, VerticalId, ScaffoldType, TenantPluginBinding, DashboardWidgetDef, DashboardWidgetKind, DashboardSurface, DashboardLayoutConfig, ResolvedDashboardWidget } from './types/plugins'
 export { WidgetZone } from './types/plugins'
 export type { AuthAdapter, AuthUser, AuthSession, AuthProvider } from './types/auth'
 export type { OrgAdapter, Organization, OrgMember, OrgMembership, Location, Invite, CreateOrgOptions } from './types/org'
 export type { PermissionsConfig, FeatureDeclaration, PermissionAction, PermissionProfile, SystemPermission } from './types/permissions'
-export type { Plan, BillingConfig } from './types/billing'
+export type { Plan, BillingConfig, BillingCheckoutFn } from './types/billing'
+export type { PlanEntitlements, LimitDeclaration } from './types/entitlements'
 export type { ThemeBrand, ThemeRadius, ThemeMode } from './types/theme'
 export type { LocaleConfig } from './types/i18n'
 
 // Data providers
 export { createSupabaseProvider, setGlobalSupabaseClient, getSupabaseClientOptional } from './data/supabase'
+export { countByTenant, invalidateCount } from './data/count'
+export type { CountByTenantOptions } from './data/count'
 export { getFayzCloudClient, FAYZ_CLOUD_URL, FAYZ_CLOUD_PUBLISHABLE_KEY } from './data/cloud'
 export { createFayzApiProvider } from './data/platform-api'
 export { createMockProvider } from './data/mock'
@@ -23,6 +26,12 @@ export {
   COUNTRIES, DEFAULT_COUNTRY, getCountry, unmaskPhone, maskPhone, maskDigitCount,
 } from './phone'
 export type { CountryDef } from './phone'
+export {
+  normalizePostalCode, formatPostalCode, isValidPostalCode,
+  createViaCepProvider, setPostalLookupProvider, getPostalLookupProvider,
+  lookupPostalCode, clearPostalCache,
+} from './address'
+export type { PostalAddress, PostalLookupProvider } from './address'
 export type {
   PaymentProvider, PaymentMethod, ChargeStatus, CreateChargeInput, PixCharge,
 } from './types/payment'
@@ -148,7 +157,13 @@ export type {
   PageManifest,
   PluginRef,
   ManifestMigration,
+  AgentContract,
+  AgentDomainKnowledge,
+  EntityContract,
+  AIToolContract,
+  RpcContract,
 } from './manifest'
+export { serializeManifest, computeContractHash, serializeManifestWithHash } from './manifest/serialize'
 export { default as appManifestSchema } from './manifest/app-manifest.schema.json'
 
 // App entry points (manifest → running app)