@towerjs/tower

Meta-package that bundles all Tower modules for convenient access. Import individual modules from subpaths — each access lazily initializes the Tower app on first use.

Installation

pnpm add @towerjs/tower

Usage

Import the modules you need from their subpaths. First use triggers Tower initialization (and tower.config.ts discovery).

import { courier } from '@towerjs/tower/courier'
import { gatehouse } from '@towerjs/tower/gatehouse'
import { vault } from '@towerjs/tower/vault'

// Gatehouse — authentication
const session = await gatehouse.getSession()

// Vault — direct database access
await vault.selectFrom('users').selectAll().execute()

// Courier — communications
await courier.email.send({ to: '[email protected]', subject: 'Hello', text: 'World' })

Access the initialized app itself for configuration, dependency injection, and shutdown:

import { getTowerApp } from '@towerjs/tower/runtime'

const app = await getTowerApp()
await app.container.get('gatehouse').migrate()
await app.shutdown()

Exports

| Export | Description | | ---------------- | -------------------------------------------------- | | initTower | Programmatic initialization (with optional config) | | getTowerApp | Async access to the initialized TowerApp | | createTower | Initialization helper from @towerjs/foundation | | createTowerApp | Low-level app builder from @towerjs/foundation | | defineTower | Configuration helper from @towerjs/blueprint | | TowerApp | Type for the initialized Tower object |

Each subpath import initializes the Tower app (and its tower.config.ts discovery) on first use. For async initialization, await getTowerApp() first.

Subpaths

Import individual modules directly:

| Subpath | Exports | | --------------------------------------- | -------------------------------------------------------------- | | @towerjs/tower/blueprint | defineTower, types | | @towerjs/tower/foundation | createTower, createTowerApp, initTower, getTowerApp | | @towerjs/tower/gatehouse | gatehouse (incl. getSession, user, requireUser) | | @towerjs/tower/gatehouse/actions | Pre-built auth server actions | | @towerjs/tower/gatehouse/next | Next.js integration (action, withGatehouse, GET, POST) | | @towerjs/tower/gatehouse/client | gatehouseClient for the browser | | @towerjs/tower/gatehouse/react-server | Gatehouse for React Server Components | | @towerjs/tower/vault | vault (incl. db, migrate, seed), types | | @towerjs/tower/courier | courier (incl. email, sms) | | @towerjs/tower/runtime | initTower, getTowerApp, getModuleFactory |

What's included

• @towerjs/foundation — Core runtime and DI
• @towerjs/blueprint — Application definition
• @towerjs/vault — Database ORM
• @towerjs/gatehouse — Authentication
• @towerjs/courier — Communications