first commit

libs/api-interfaces/src/index.ts

@@ -0,0 +1,5 @@
+export * from './lib/survivor';
+export * from './lib/mission';
+export * from './lib/perk';
+export * from './lib/encounter';
+export * from './lib/channel-config';

libs/api-interfaces/src/lib/channel-config.ts

@@ -0,0 +1,8 @@
+import { MissionDifficulty } from './mission';
+
+export interface ChannelConfig {
+  channelId: string;
+  difficultyPreset: MissionDifficulty;
+  maxPartySize: number;
+  featureFlags: Record<string, boolean>;
+}

libs/api-interfaces/src/lib/encounter.ts

@@ -0,0 +1,19 @@
+import { MissionDifficulty, MissionState } from './mission';
+import { SurvivorStats } from './survivor';
+
+export interface EncounterResult {
+  outcome: 'success' | 'injury' | 'sacrifice';
+  text: string;
+  successChance: number;
+  roll: number;
+  nextState: MissionState;
+  nextStats: SurvivorStats;
+}
+
+export interface ResolveEncounterInput {
+  stats: SurvivorStats;
+  difficulty: MissionDifficulty;
+  perkIds: string[];
+  tickIndex: number;
+  seed?: number;
+}

libs/api-interfaces/src/lib/mission.ts

@@ -0,0 +1,35 @@
+import { SurvivorStats } from './survivor';
+
+export enum MissionState {
+  Lobby = 'Lobby',
+  InProgress = 'InProgress',
+  Completed = 'Completed',
+  Failed = 'Failed'
+}
+
+export enum MissionDifficulty {
+  Easy = 'Easy',
+  Normal = 'Normal',
+  Hard = 'Hard',
+  Nightmare = 'Nightmare'
+}
+
+export interface EncounterLogLine {
+  sequence: number;
+  event: string;
+  text: string;
+  successChance: number;
+  roll: number;
+}
+
+export interface MissionSnapshot {
+  id: string;
+  channelId: string;
+  survivorId: string;
+  state: MissionState;
+  difficulty: MissionDifficulty;
+  tickIndex: number;
+  recentLog: EncounterLogLine[];
+  stats: SurvivorStats;
+  perkIds: string[];
+}

libs/api-interfaces/src/lib/perk.ts

@@ -0,0 +1,19 @@
+export enum ModifierKind {
+  Additive = 'additive',
+  Multiplicative = 'multiplicative',
+  FlatReroll = 'flat_reroll'
+}
+
+export interface PerkModifier {
+  id: string;
+  kind: ModifierKind;
+  value: number;
+  teamPerk?: boolean;
+}
+
+export interface Perk {
+  id: string;
+  name: string;
+  description: string;
+  modifiers: PerkModifier[];
+}

libs/api-interfaces/src/lib/survivor.ts

@@ -0,0 +1,18 @@
+export enum SurvivorState {
+  Active = 'Active',
+  Injured = 'Injured',
+  Sacrificed = 'Sacrificed'
+}
+
+export interface SurvivorStats {
+  health: number;
+  stealth: number;
+  teamwork: number;
+  luck: number;
+}
+
+export interface Survivor {
+  id: string;
+  state: SurvivorState;
+  stats: SurvivorStats;
+}