@owlmeans/server-config

Server-specific configuration utilities: sservice() helper and config-file reader.

Overview

• sservice() adds a named service route to a server config (analogous to service() from @owlmeans/config, but for BasicServerConfig)
• readConfigValue() reads a config value from a JSON file or falls back to an environment variable
• Re-exported via @owlmeans/server-app as sservice

Installation

bun add @owlmeans/server-config

Usage

Add a service endpoint to a backend config (via @owlmeans/server-app):

import { config, sservice, AppType } from '@owlmeans/server-app'

const appConfig = config(
  AppType.Backend,
  'manager-api',
  sservice({ service: 'auth', host: 'auth-service', port: 3001 })
)

Read a secret from file or environment:

import { readConfigValue } from '@owlmeans/server-config'

const dbPassword = await readConfigValue('DB_PASSWORD', '/run/secrets/db_password')

API

sservice<C>(route, cfg?): Partial<C>

Adds a service route to a BasicServerConfig. The service field of route becomes the service alias.

readConfigValue(envVar, filePath?): Promise<string>

Returns the value of envVar from the environment. If filePath is provided and the file exists, reads from there instead (useful for Docker secrets).

BasicServerConfig

Extends CommonConfig with:

• port?: number
• security?: { unsecure?: boolean }

Related Packages

• @owlmeans/config — service() for client-accessible services; makeConfig base factory
• @owlmeans/server-app — re-exports sservice

Agent guidance

This package ships embedded Claude Code skills and GitHub Copilot instructions under agent-meta/. After installing your @owlmeans/* packages, run the OwlMeans agent-skills installer to place them into your project's native locations (.claude/skills/ and .github/instructions/):

npx @owlmeans/agent-skills

The embedded files are version-matched to this package release. Do not edit them directly — they are regenerated on each publish. To contribute guidance edits, open a PR against the source monorepo.