Package Groups

Labkit packages are intentionally small. Install only the groups your app uses.

Shared Packages

Package	Runtime	Owns
@omgjs/labkit-auth-contract	Server and browser	Auth shapes, refresh transport names, bearer helpers, websocket auth params, auth-required error codes.
@omgjs/labkit-runtime-config	Server and browser	Primitive parsing for booleans, numbers, finite numbers, and comma-separated lists.

Shared packages publish CommonJS and ESM entry points. Import from the package root, never from dist.

Server Packages

Package	Runtime	Owns
@omgjs/labkit-server-observability	Node/Nest	Structured event logs, safe error serialization, verbose runtime log flags.
@omgjs/labkit-server-config	Node/Nest	Config readers, env file paths, CORS, cookie SameSite, server host/port/GraphQL path.
@omgjs/labkit-server-database	Node/TypeORM	PostgreSQL options, SSL options, migration safety, database manifest composition.
@omgjs/labkit-server-graphql	Nest GraphQL	Apollo/Nest module factory, GraphQL HTTP/WS context, subscription logging, scalar/directive/plugin helpers.
@omgjs/labkit-server-auth	Nest GraphQL	Auth providers, guards, refresh sessions, access-token helpers, transport, lifecycle events.
@omgjs/labkit-server-auth-typeorm	Nest TypeORM	Auth entities, migration, repository adapters, transaction runner, Nest provider module.

Server packages publish CommonJS output. They are meant for Node/Nest applications, not direct browser imports.

Browser Packages

Package	Runtime	Owns
@omgjs/labkit-webapp-external-store	Browser/shared UI runtime	Tiny subscription store primitive.
@omgjs/labkit-webapp-auth	Browser	Memory auth session, session hint storage, refresh/logout GraphQL API, auth error parsing.
@omgjs/labkit-webapp-realtime	Browser	GraphQL WS reconnect policy, heartbeat/watchdog handling, connection state store.
@omgjs/labkit-webapp-graphql-relay	Browser/Relay	Relay environment, auth-aware fetch, subscription integration, route query preloading.
@omgjs/labkit-webapp-ui	Browser UI	Class name helper, typed theme definitions, persisted theme controller.
@omgjs/labkit-webapp-build-config	Vite config	Production env validation and package chunk-group helpers.

Browser and tooling packages publish CommonJS and ESM entry points. Vite should choose the ESM import entry automatically.

Install Sets

Minimal shared install:

npm install @omgjs/labkit-auth-contract @omgjs/labkit-runtime-config

Typical server install:

npm install \
  @omgjs/labkit-server-config \
  @omgjs/labkit-server-database \
  @omgjs/labkit-server-graphql \
  @omgjs/labkit-server-observability \
  @omgjs/labkit-server-auth \
  @omgjs/labkit-server-auth-typeorm

Typical browser install:

npm install \
  @omgjs/labkit-webapp-auth \
  @omgjs/labkit-webapp-realtime \
  @omgjs/labkit-webapp-graphql-relay \
  @omgjs/labkit-webapp-external-store \
  @omgjs/labkit-webapp-ui \
  @omgjs/labkit-webapp-build-config

Labkit does not pin your Nest, React, Relay, TypeORM, Vite, or GraphQL stack. Those framework packages remain application dependencies.