@mereb/app-messaging

Messaging experience primitives for Mereb applications.

This package exposes a small set of surfaces for shared messaging logic, GraphQL documents, in-memory test helpers, and React Native UI screens.

Package Surfaces

• @mereb/app-messaging - root export with the headless API and GraphQL aliases
• @mereb/app-messaging/headless - GraphQL documents, pure helpers, and shared messaging types
• @mereb/app-messaging/store - in-memory messaging store for local development and tests
• @mereb/app-messaging/native - React Native messaging screens and native-only types
• @mereb/app-messaging/gql - uppercase GraphQL document aliases

Installation

pnpm add @mereb/app-messaging

The native screens expect these peer dependencies to be present in the consuming app:

• react
• react-native
• react-native-safe-area-context
• expo-router
• @apollo/client
• graphql

Usage

Headless helpers

import {
  ConversationsDocument,
  deriveConversationTitle,
  formatMessagingTimestamp,
  summarizeMessagingBody
} from '@mereb/app-messaging/headless'

GraphQL aliases

import {CONVERSATIONS, SEND_MESSAGE} from '@mereb/app-messaging/gql'

In-memory store

import {createInMemoryMessagingStore} from '@mereb/app-messaging/store'

const store = createInMemoryMessagingStore()

React Native screens

import {MessagesScreen} from '@mereb/app-messaging/native'

Scripts

Run these from packages/app-messaging/:

• pnpm run typecheck - TypeScript check
• pnpm run test - Vitest unit tests
• pnpm run coverage - Vitest coverage check
• pnpm run build - clean and emit the published package
• pnpm run smoke:dist - verify built package imports
• pnpm run version:bump - bump package version using the script default
• pnpm run version:bump:major - bump major version
• pnpm run version:bump:minor - bump minor version
• pnpm run version:bump:patch - bump patch version

To change the version bump used by the pre-commit hook, set VERSION_BUMP before committing, for example VERSION_BUMP=major git commit.

Project Layout

• src/headless.ts - GraphQL documents and pure helpers
• src/store.ts - in-memory store
• src/native/ - React Native UI and native helpers
• src/gql.ts - uppercase GraphQL aliases
• src/index.tsx - root package export
• docs/testing-plan.md - test coverage plan
• docs/testing-implementation-dag.md - phased implementation DAG

Testing

The package uses Vitest with Node as the default environment. Coverage is configured in vitest.config.ts and is enforced through pnpm run coverage.

Build Output

The published package is emitted to dist/ and should be treated as generated code. Package export paths are validated by the smoke:dist script after build.