@plasius/game-audio

Engine-agnostic in-game audio contracts for Plasius runtime packages.

Apache-2.0. ESM + CJS builds. TypeScript types included.

Installation

npm install @plasius/game-audio

Scope

This repository is part of the Plasius in-game audio package suite.

It owns:

• typed audio commands for TTS, dialogue, diegetic SFX, music, ambience, and System/UI sounds
• stable bus and category taxonomy
• engine-agnostic asset references and playback policy contracts
• privacy-safe telemetry and rollout flag constants

It does not own game-world authority, speech provider credentials, raw TTS generation, or product-specific feature-flag evaluation.

Feature Flag

• game.audio.foundation.enabled

Usage

import {
  packageDescriptor,
  GAME_AUDIO_PACKAGE,
  GAME_AUDIO_FEATURE_FLAG_ID,
} from "@plasius/game-audio";

console.log(packageDescriptor.packageName === GAME_AUDIO_PACKAGE);
console.log(packageDescriptor.featureFlagId === GAME_AUDIO_FEATURE_FLAG_ID);

Development

npm install
npm run build
npm test
npm run test:coverage
npm run pack:check

Governance

• Architecture decisions: docs/adrs
• Security policy: SECURITY.md
• Code of conduct: CODE_OF_CONDUCT.md
• CLA and legal docs: legal

License

Apache-2.0

Release integrity

Production package publication runs only from .github/workflows/cd.yml on protected main. The job verifies that the prepared commit is still the current main commit and has an exact successful ci.yml push result before it mutates release state. Public package CI runs on GitHub-hosted capacity so it cannot execute on company-managed runners. npm publication runs on GitHub-hosted Node.js 24 with npm 11.5.1 or newer, uses the protected production environment and short-lived npm OIDC with provenance, and has no long-lived npm write-token fallback. Rollback disables CD; it never rewrites published package history.