@neetru/sdk 3.4.1 → 3.4.3

package/dist/react.d.cts

@@ -4,6 +4,101 @@ import { CollectionReference, Query, DocumentReference } from './firestore-compa
 import 'drizzle-orm/node-postgres';
 import './errors.cjs';
 
+/**
+ * Barra de conta / app-switcher padrão da Neetru — subpath `@neetru/sdk/react`.
+ *
+ * Um componente DROP-IN que TODO produto SaaS Neetru coloca no header:
+ *   - **Avatar** (foto ou iniciais) → menu de conta: nome/e-mail + "Minha conta
+ *     Neetru" (minhaconta.neetru.com) + "Configurações da conta" (deste produto)
+ *     + "Sair".
+ *   - **Waffle** (grid 9-pontos) → grid dos OUTROS produtos SaaS Neetru que o
+ *     cliente tem acesso, pra pular de um pro outro. O produto atual é destacado.
+ *
+ * Fonte dos dados: `GET /api/sdk/v1/account/bar` no Neetru Core, autenticado
+ * com o **id_token** do end-user (o SDK já o guarda; `client.auth.getIdToken()`).
+ * O componente NÃO faz fetch cru cross-repo — a busca passa por
+ * `fetchNeetruAccountBar`, que é parte do próprio SDK (o conduíte canônico).
+ *
+ * Estilo: BMW (rounded-none, sem sombra/glassmorphism), inline (roda em
+ * qualquer app com ou sem Tailwind). Superfície de CLIENTE → sempre CLARO
+ * (não adere a dark mode; dark é staff-only). Acessível: teclado (setas, Tab
+ * trap, Esc), aria, foco devolvido ao gatilho. i18n PT-BR (override via `labels`).
+ *
+ * Autorado com `React.createElement` (sem JSX) igual ao resto de `react.ts` —
+ * mantém o build `.ts` sem depender de config JSX no consumidor.
+ */
+
+interface AccountBarAccount {
+    displayName: string;
+    email: string;
+    photoUrl?: string | null;
+}
+interface AccountBarProductItem {
+    slug: string;
+    name: string;
+    iconUrl?: string;
+    url: string;
+}
+interface AccountBarData {
+    account: AccountBarAccount;
+    accountUrl: string;
+    products: AccountBarProductItem[];
+}
+/** Textos da UI — default PT-BR, override parcial via prop `labels`. */
+interface AccountBarLabels {
+    /** aria-label do botão de conta. */
+    accountButton: string;
+    /** aria-label do botão waffle. */
+    appsButton: string;
+    /** Título da seção de produtos no popover waffle. */
+    appsTitle: string;
+    /** Item "Minha conta Neetru". */
+    myAccount: string;
+    /** Item "Configurações da conta". */
+    accountSettings: string;
+    /** Item "Sair". */
+    signOut: string;
+    /** Badge no produto atual. */
+    currentBadge: string;
+    /** Estado vazio (sem outros produtos). */
+    emptyProducts: string;
+}
+/**
+ * Busca os dados da barra de conta no Core usando o id_token do end-user.
+ *
+ * Retorna `null` quando não há usuário logado (sem id_token) ou a resposta não
+ * é OK — o componente trata como "não renderizar" / usar identidade local.
+ *
+ * Exportado à parte pra ser reusável fora de React (ex.: pré-carregar no BFF do
+ * produto) e testável isoladamente.
+ */
+declare function fetchNeetruAccountBar(client: NeetruClient): Promise<AccountBarData | null>;
+/** Iniciais (até 2) a partir do nome/e-mail pro fallback do avatar/monograma. */
+declare function initialsFrom(nameOrEmail: string): string;
+interface NeetruAccountBarProps {
+    /** Cliente SDK Neetru — fornece `config.baseUrl` + `auth.getIdToken()`. */
+    client: NeetruClient;
+    /** Slug do produto atual — destacado no grid waffle. */
+    currentProductSlug?: string;
+    /** Link "Configurações da conta" DESTE produto (rota interna do app). Omite o item se ausente. */
+    settingsUrl?: string;
+    /** Chamado após `signOut` concluir (ex.: redirecionar pro login). */
+    onSignOut?: () => void;
+    /** Override do fetcher — default `fetchNeetruAccountBar(client)`. Útil em teste/SSR. */
+    fetchBar?: (client: NeetruClient) => Promise<AccountBarData | null>;
+    /** Override parcial dos textos (default PT-BR). */
+    labels?: Partial<AccountBarLabels>;
+    /** Classe extra no container (o resto do estilo é inline). */
+    className?: string;
+}
+/**
+ * `<NeetruAccountBar client={client} currentProductSlug="pdv-agiliza" settingsUrl="/config" />`
+ *
+ * Renderiza waffle + avatar. Identidade aparece instantânea (do id_token via
+ * `client.auth.getUser()`); produtos chegam do Core em seguida.
+ */
+declare function NeetruAccountBar({ client, currentProductSlug, settingsUrl, onSignOut, fetchBar, labels, className, }: NeetruAccountBarProps): React.ReactElement | null;
+
 /**
  * SDK React helpers (v1.1) — subpath import `@neetru/sdk/react`.
  *
@@ -286,4 +381,4 @@ declare function useUser(input: UseUserInput, options?: {
     timeoutMs?: number;
 }): UseUserResult;
 
-export { CheckoutLink, type CheckoutLinkProps, EntitlementGate, type EntitlementGateMode, type EntitlementGateProps, type FirestoreCompatCollectionResult, NeetruLoginButton, type NeetruLoginButtonProps, type UseCollectionResult, type UseDataOptions, type UseDocResult, type UseUserInput, type UseUserResult, useCollection, useDoc, useEntitlementContext, useUser };
+export { type AccountBarAccount, type AccountBarData, type AccountBarLabels, type AccountBarProductItem, CheckoutLink, type CheckoutLinkProps, EntitlementGate, type EntitlementGateMode, type EntitlementGateProps, type FirestoreCompatCollectionResult, NeetruAccountBar, type NeetruAccountBarProps, NeetruLoginButton, type NeetruLoginButtonProps, type UseCollectionResult, type UseDataOptions, type UseDocResult, type UseUserInput, type UseUserResult, fetchNeetruAccountBar, initialsFrom, useCollection, useDoc, useEntitlementContext, useUser };

package/dist/react.d.ts

@@ -4,6 +4,101 @@ import { CollectionReference, Query, DocumentReference } from './firestore-compa
 import 'drizzle-orm/node-postgres';
 import './errors.js';
 
+/**
+ * Barra de conta / app-switcher padrão da Neetru — subpath `@neetru/sdk/react`.
+ *
+ * Um componente DROP-IN que TODO produto SaaS Neetru coloca no header:
+ *   - **Avatar** (foto ou iniciais) → menu de conta: nome/e-mail + "Minha conta
+ *     Neetru" (minhaconta.neetru.com) + "Configurações da conta" (deste produto)
+ *     + "Sair".
+ *   - **Waffle** (grid 9-pontos) → grid dos OUTROS produtos SaaS Neetru que o
+ *     cliente tem acesso, pra pular de um pro outro. O produto atual é destacado.
+ *
+ * Fonte dos dados: `GET /api/sdk/v1/account/bar` no Neetru Core, autenticado
+ * com o **id_token** do end-user (o SDK já o guarda; `client.auth.getIdToken()`).
+ * O componente NÃO faz fetch cru cross-repo — a busca passa por
+ * `fetchNeetruAccountBar`, que é parte do próprio SDK (o conduíte canônico).
+ *
+ * Estilo: BMW (rounded-none, sem sombra/glassmorphism), inline (roda em
+ * qualquer app com ou sem Tailwind). Superfície de CLIENTE → sempre CLARO
+ * (não adere a dark mode; dark é staff-only). Acessível: teclado (setas, Tab
+ * trap, Esc), aria, foco devolvido ao gatilho. i18n PT-BR (override via `labels`).
+ *
+ * Autorado com `React.createElement` (sem JSX) igual ao resto de `react.ts` —
+ * mantém o build `.ts` sem depender de config JSX no consumidor.
+ */
+
+interface AccountBarAccount {
+    displayName: string;
+    email: string;
+    photoUrl?: string | null;
+}
+interface AccountBarProductItem {
+    slug: string;
+    name: string;
+    iconUrl?: string;
+    url: string;
+}
+interface AccountBarData {
+    account: AccountBarAccount;
+    accountUrl: string;
+    products: AccountBarProductItem[];
+}
+/** Textos da UI — default PT-BR, override parcial via prop `labels`. */
+interface AccountBarLabels {
+    /** aria-label do botão de conta. */
+    accountButton: string;
+    /** aria-label do botão waffle. */
+    appsButton: string;
+    /** Título da seção de produtos no popover waffle. */
+    appsTitle: string;
+    /** Item "Minha conta Neetru". */
+    myAccount: string;
+    /** Item "Configurações da conta". */
+    accountSettings: string;
+    /** Item "Sair". */
+    signOut: string;
+    /** Badge no produto atual. */
+    currentBadge: string;
+    /** Estado vazio (sem outros produtos). */
+    emptyProducts: string;
+}
+/**
+ * Busca os dados da barra de conta no Core usando o id_token do end-user.
+ *
+ * Retorna `null` quando não há usuário logado (sem id_token) ou a resposta não
+ * é OK — o componente trata como "não renderizar" / usar identidade local.
+ *
+ * Exportado à parte pra ser reusável fora de React (ex.: pré-carregar no BFF do
+ * produto) e testável isoladamente.
+ */
+declare function fetchNeetruAccountBar(client: NeetruClient): Promise<AccountBarData | null>;
+/** Iniciais (até 2) a partir do nome/e-mail pro fallback do avatar/monograma. */
+declare function initialsFrom(nameOrEmail: string): string;
+interface NeetruAccountBarProps {
+    /** Cliente SDK Neetru — fornece `config.baseUrl` + `auth.getIdToken()`. */
+    client: NeetruClient;
+    /** Slug do produto atual — destacado no grid waffle. */
+    currentProductSlug?: string;
+    /** Link "Configurações da conta" DESTE produto (rota interna do app). Omite o item se ausente. */
+    settingsUrl?: string;
+    /** Chamado após `signOut` concluir (ex.: redirecionar pro login). */
+    onSignOut?: () => void;
+    /** Override do fetcher — default `fetchNeetruAccountBar(client)`. Útil em teste/SSR. */
+    fetchBar?: (client: NeetruClient) => Promise<AccountBarData | null>;
+    /** Override parcial dos textos (default PT-BR). */
+    labels?: Partial<AccountBarLabels>;
+    /** Classe extra no container (o resto do estilo é inline). */
+    className?: string;
+}
+/**
+ * `<NeetruAccountBar client={client} currentProductSlug="pdv-agiliza" settingsUrl="/config" />`
+ *
+ * Renderiza waffle + avatar. Identidade aparece instantânea (do id_token via
+ * `client.auth.getUser()`); produtos chegam do Core em seguida.
+ */
+declare function NeetruAccountBar({ client, currentProductSlug, settingsUrl, onSignOut, fetchBar, labels, className, }: NeetruAccountBarProps): React.ReactElement | null;
+
 /**
  * SDK React helpers (v1.1) — subpath import `@neetru/sdk/react`.
  *
@@ -286,4 +381,4 @@ declare function useUser(input: UseUserInput, options?: {
     timeoutMs?: number;
 }): UseUserResult;
 
-export { CheckoutLink, type CheckoutLinkProps, EntitlementGate, type EntitlementGateMode, type EntitlementGateProps, type FirestoreCompatCollectionResult, NeetruLoginButton, type NeetruLoginButtonProps, type UseCollectionResult, type UseDataOptions, type UseDocResult, type UseUserInput, type UseUserResult, useCollection, useDoc, useEntitlementContext, useUser };
+export { type AccountBarAccount, type AccountBarData, type AccountBarLabels, type AccountBarProductItem, CheckoutLink, type CheckoutLinkProps, EntitlementGate, type EntitlementGateMode, type EntitlementGateProps, type FirestoreCompatCollectionResult, NeetruAccountBar, type NeetruAccountBarProps, NeetruLoginButton, type NeetruLoginButtonProps, type UseCollectionResult, type UseDataOptions, type UseDocResult, type UseUserInput, type UseUserResult, fetchNeetruAccountBar, initialsFrom, useCollection, useDoc, useEntitlementContext, useUser };