@tmf/mailbox-front (0.1.0)

Published 2026-06-26 13:05:04 -03:00 by tarcisio

Setup this registry in your project .npmrc file:

@tmf:registry=

To install the package using npm, run the following command:

npm install @tmf/mailbox-front@0.1.0

or add it to the package.json file:

"@tmf/mailbox-front": "0.1.0"

For more information on the npm registry, see the documentation.

@tmf/mailbox-front

Módulo Mailbox plug-and-play da plataforma TMF — caixa de entrada unificada de mensagens inbound (WhatsApp / E-mail / SMS).

Extraído do antigo SDInboxTable do @tmf/service-desk-front. Inbound multicanal é domínio de mensageria, não de tickets — por isso virou módulo próprio, com contrato (MailboxApiClient) e backend próprios.

Instalação

npm install @tmf/mailbox-front

Peer deps: react, react-dom. Deps: @tanstack/react-query, lucide-react.

Uso (plug-and-play)

import { MailboxApp } from '@tmf/mailbox-front'

<MailboxApp baseUrl="/api/mailbox" getToken={() => auth.token} />

O Provider monta sozinho o MailboxApiClient (fetch sobre baseUrl) e um QueryClient interno — o host não precisa prover <QueryClientProvider>.

Uso (modo avançado — client próprio)

import { MailboxApp, type MailboxApiClient } from '@tmf/mailbox-front'

const client: MailboxApiClient = {
  listMessages: (params) => http.get('/mailbox/messages', params),
}

<MailboxApp client={client} onReply={(msg) => openComposer(msg)} />

Contrato de backend

O front é agnóstico de transporte. O backend próprio do módulo (packages/mailbox/back / service — a criar) implementa:

Método	Endpoint sugerido	Retorno
`listMessages(params)`	`GET /messages`	`MailboxListResponse` (cursor-based)

Exports

MailboxApp — componente top-level (Provider + header + caixa de entrada)
MailboxInbox — só a tabela da caixa de entrada (uso avulso)
MailboxProvider, useMailboxContext, useMailboxUI
mailboxQueryKeys, tipos (MailboxMessage, MailboxApiClient, …)

Dependencies

ID	Version
@tanstack/react-query	^5.0.0
lucide-react	^0.400.0

Development dependencies

ID	Version
@types/react	^18.2.47
@types/react-dom	^18.2.18
tsup	^8.5.1
typescript	^5.3.3

Peer dependencies

ID	Version
react	>=18.0.0
react-dom	>=18.0.0

tmf mailbox inbox messaging react components plug-and-play

Details

npm

2026-06-26 13:05:04 -03:00

Trade Marketing Force LTDA

UNLICENSED

25 KiB

Assets (1)

mailbox-front-0.1.0.tgz 25 KiB

Versions (7) View all

6.1.0

2026-07-30

6.0.0

2026-07-27

5.0.0

2026-07-16

4.0.3

2026-07-10

4.0.0

2026-07-07

@tmf/mailbox-front (0.1.0)

Installation

About this package