@bct-app/game-engine 0.1.6-beta.1 → 0.1.6-beta.3

package/dist/index.js

@@ -24,6 +24,7 @@ __export(index_exports, {
   adjustValueAsNumberArray: () => adjustValueAsNumberArray,
   applyOperationToPlayers: () => applyOperationToPlayers,
   buildPlayerSeatMap: () => buildPlayerSeatMap,
+  canInvokeAbility: () => canInvokeAbility,
   copyPlayers: () => copyPlayers,
   getSourceValue: () => getSourceValue,
   getValueFromPayloads: () => getValueFromPayloads,
@@ -149,8 +150,18 @@ var resolveSourceValue = (source, writableInputs, payloads, effector, snapshotSe
       return player ? resolveFromPlayer(player) : void 0;
     }
     if (input?.type === "CHARACTER") {
-      const characterId = typeof payloadValue === "string" ? payloadValue : void 0;
-      return characterId && resolveFromCharacter ? resolveFromCharacter(characterId) : void 0;
+      if (typeof payloadValue !== "string" && !Array.isArray(payloadValue)) {
+        console.warn("Expected string or string[] for CHARACTER type input in PAYLOAD source, got:", payloadValue);
+        return void 0;
+      }
+      if (Array.isArray(payloadValue) && payloadValue.some((v) => typeof v !== "string")) {
+        console.warn("Expected string[] for CHARACTER type input in PAYLOAD source, got:", payloadValue);
+        return void 0;
+      }
+      const characterIds = typeof payloadValue === "string" ? [payloadValue] : payloadValue;
+      return characterIds.flatMap((id) => {
+        return resolveFromCharacter ? resolveFromCharacter(id) : [];
+      });
     }
     return castOrValidate(payloadValue);
   }
@@ -382,8 +393,6 @@ var applyPerceivedCharacterChange = createEffectHandler("PERCEIVED_CHARACTER_CHA
 var applyReminderAdd = createEffectHandler("REMINDER_ADD", ({
   effect,
   payloads,
-  nowTimelineIndex,
-  operationInTimelineIdx,
   makePlayersEffect
 }) => {
   const maybeReminder = getSourceValue(effect.source, payloads);
@@ -391,10 +400,6 @@ var applyReminderAdd = createEffectHandler("REMINDER_ADD", ({
     console.warn("Invalid reminder data for REMINDER_ADD effect:", maybeReminder);
     return;
   }
-  const timelineDistance = nowTimelineIndex - operationInTimelineIdx;
-  if (typeof maybeReminder.duration === "number" && maybeReminder.duration > 0 && timelineDistance >= maybeReminder.duration) {
-    return;
-  }
   makePlayersEffect.forEach((player) => {
     if (!player.reminders) {
       player.reminders = [];
@@ -664,10 +669,16 @@ var resolveEffectTargets = ({
 };
 
 // src/effects/evaluate-lifetime.ts
-var getLifetime = (effect) => {
-  if ("lifetime" in effect) {
+var getLifetime = (effect, payloads) => {
+  if ("lifetime" in effect && effect.lifetime) {
     return effect.lifetime;
   }
+  if (effect.type === "REMINDER_ADD") {
+    const maybeReminder = getSourceValue(effect.source, payloads);
+    if (isReminder(maybeReminder) && typeof maybeReminder.duration === "number" && maybeReminder.duration > 0) {
+      return { kind: "PHASES", count: maybeReminder.duration };
+    }
+  }
   return void 0;
 };
 var matchesLifetimeCondition = (player, condition, characterMap) => {
@@ -712,9 +723,10 @@ var evaluateLifetime = ({
   effector,
   targets,
   snapshotSeatMap,
-  characterMap
+  characterMap,
+  payloads
 }) => {
-  const lifetime = getLifetime(effect);
+  const lifetime = getLifetime(effect, payloads);
   if (!lifetime || lifetime.kind === "PERMANENT") {
     return targets;
   }
@@ -726,6 +738,10 @@ var evaluateLifetime = ({
     }
     return nowTurn - opTurn < lifetime.count ? targets : [];
   }
+  if (lifetime.kind === "PHASES") {
+    if (operationTimelineIdx < 0) return targets;
+    return nowTimelineIndex - operationTimelineIdx < lifetime.count ? targets : [];
+  }
   if (lifetime.kind === "UNTIL_EVENT") {
     if (operationTimelineIdx < 0) return targets;
     for (let idx = operationTimelineIdx + 1; idx <= nowTimelineIndex; idx += 1) {
@@ -833,7 +849,8 @@ var applyOperationToPlayers = ({
             effector,
             targets: resolvedTargets,
             snapshotSeatMap: lifetimeSnapshotSeatMap,
-            characterMap
+            characterMap,
+            payloads
           });
           const handler = effectHandlers[effect.type];
           if (!handler) {
@@ -911,12 +928,84 @@ var applyOperationToPlayers = ({
   const final = runReplay(groundTruthSeatMap);
   return transformEmptyArray(final);
 };
+
+// src/can-invoke-ability.ts
+var checkTurns = (turns, currentTurn) => {
+  if (turns.only && turns.only.length > 0 && !turns.only.includes(currentTurn)) {
+    return `turn ${currentTurn} not in allowed turns ${JSON.stringify(turns.only)}`;
+  }
+  if (typeof turns.from === "number" && currentTurn < turns.from) {
+    return `turn ${currentTurn} is before allowed start turn ${turns.from}`;
+  }
+  if (typeof turns.to === "number" && currentTurn > turns.to) {
+    return `turn ${currentTurn} is after allowed end turn ${turns.to}`;
+  }
+  return null;
+};
+var countMatchingPriorOps = (priorOperations, abilityId, effectorSeat, operationTimelineMap, matchTurn, matchTime, timelines) => {
+  return priorOperations.filter((op) => {
+    if (op.abilityId !== abilityId) return false;
+    if (typeof effectorSeat === "number" && op.effector !== effectorSeat) return false;
+    if (matchTurn === null && matchTime === null) return true;
+    const idx = operationTimelineMap.get(op);
+    if (typeof idx !== "number") return false;
+    const tl = timelines[idx];
+    if (!tl) return false;
+    if (matchTurn !== null && tl.turn !== matchTurn) return false;
+    if (matchTime !== null && tl.time !== matchTime) return false;
+    return true;
+  }).length;
+};
+var canInvokeAbility = ({
+  ability,
+  effector,
+  currentTimelineIdx,
+  timelines,
+  priorOperations = []
+}) => {
+  const trigger = ability.triggerWindow;
+  if (!trigger) return { allowed: true };
+  const currentTimeline = timelines[currentTimelineIdx];
+  if (!currentTimeline) {
+    return { allowed: false, reason: `no timeline at index ${currentTimelineIdx}` };
+  }
+  if (trigger.turns) {
+    const turnError = checkTurns(trigger.turns, currentTimeline.turn);
+    if (turnError) return { allowed: false, reason: turnError };
+  }
+  if (trigger.phases && trigger.phases.length > 0 && !trigger.phases.includes(currentTimeline.time)) {
+    return { allowed: false, reason: `phase ${currentTimeline.time} not in allowed phases ${JSON.stringify(trigger.phases)}` };
+  }
+  if (trigger.requireEffectorAlive && (!effector || effector.isDead)) {
+    return { allowed: false, reason: "effector is not alive" };
+  }
+  if (trigger.frequency && priorOperations.length > 0) {
+    const operationTimelineMap = /* @__PURE__ */ new Map();
+    timelines.forEach((tl, idx) => tl.operations?.forEach((op) => operationTimelineMap.set(op, idx)));
+    const matchTurn = trigger.frequency === "ONCE_PER_GAME" ? null : currentTimeline.turn;
+    const matchTime = trigger.frequency === "ONCE_PER_GAME" ? null : trigger.frequency === "ONCE_PER_NIGHT" ? "night" : "day";
+    const count = countMatchingPriorOps(
+      priorOperations,
+      ability.id,
+      effector?.seat,
+      operationTimelineMap,
+      matchTurn,
+      matchTime,
+      timelines
+    );
+    if (count > 0) {
+      return { allowed: false, reason: `frequency ${trigger.frequency} already exhausted (${count} prior op${count === 1 ? "" : "s"})` };
+    }
+  }
+  return { allowed: true };
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   adjustValueAsNumber,
   adjustValueAsNumberArray,
   applyOperationToPlayers,
   buildPlayerSeatMap,
+  canInvokeAbility,
   copyPlayers,
   getSourceValue,
   getValueFromPayloads,

package/dist/index.mjs

@@ -112,8 +112,18 @@ var resolveSourceValue = (source, writableInputs, payloads, effector, snapshotSe
       return player ? resolveFromPlayer(player) : void 0;
     }
     if (input?.type === "CHARACTER") {
-      const characterId = typeof payloadValue === "string" ? payloadValue : void 0;
-      return characterId && resolveFromCharacter ? resolveFromCharacter(characterId) : void 0;
+      if (typeof payloadValue !== "string" && !Array.isArray(payloadValue)) {
+        console.warn("Expected string or string[] for CHARACTER type input in PAYLOAD source, got:", payloadValue);
+        return void 0;
+      }
+      if (Array.isArray(payloadValue) && payloadValue.some((v) => typeof v !== "string")) {
+        console.warn("Expected string[] for CHARACTER type input in PAYLOAD source, got:", payloadValue);
+        return void 0;
+      }
+      const characterIds = typeof payloadValue === "string" ? [payloadValue] : payloadValue;
+      return characterIds.flatMap((id) => {
+        return resolveFromCharacter ? resolveFromCharacter(id) : [];
+      });
     }
     return castOrValidate(payloadValue);
   }
@@ -345,8 +355,6 @@ var applyPerceivedCharacterChange = createEffectHandler("PERCEIVED_CHARACTER_CHA
 var applyReminderAdd = createEffectHandler("REMINDER_ADD", ({
   effect,
   payloads,
-  nowTimelineIndex,
-  operationInTimelineIdx,
   makePlayersEffect
 }) => {
   const maybeReminder = getSourceValue(effect.source, payloads);
@@ -354,10 +362,6 @@ var applyReminderAdd = createEffectHandler("REMINDER_ADD", ({
     console.warn("Invalid reminder data for REMINDER_ADD effect:", maybeReminder);
     return;
   }
-  const timelineDistance = nowTimelineIndex - operationInTimelineIdx;
-  if (typeof maybeReminder.duration === "number" && maybeReminder.duration > 0 && timelineDistance >= maybeReminder.duration) {
-    return;
-  }
   makePlayersEffect.forEach((player) => {
     if (!player.reminders) {
       player.reminders = [];
@@ -627,10 +631,16 @@ var resolveEffectTargets = ({
 };
 
 // src/effects/evaluate-lifetime.ts
-var getLifetime = (effect) => {
-  if ("lifetime" in effect) {
+var getLifetime = (effect, payloads) => {
+  if ("lifetime" in effect && effect.lifetime) {
     return effect.lifetime;
   }
+  if (effect.type === "REMINDER_ADD") {
+    const maybeReminder = getSourceValue(effect.source, payloads);
+    if (isReminder(maybeReminder) && typeof maybeReminder.duration === "number" && maybeReminder.duration > 0) {
+      return { kind: "PHASES", count: maybeReminder.duration };
+    }
+  }
   return void 0;
 };
 var matchesLifetimeCondition = (player, condition, characterMap) => {
@@ -675,9 +685,10 @@ var evaluateLifetime = ({
   effector,
   targets,
   snapshotSeatMap,
-  characterMap
+  characterMap,
+  payloads
 }) => {
-  const lifetime = getLifetime(effect);
+  const lifetime = getLifetime(effect, payloads);
   if (!lifetime || lifetime.kind === "PERMANENT") {
     return targets;
   }
@@ -689,6 +700,10 @@ var evaluateLifetime = ({
     }
     return nowTurn - opTurn < lifetime.count ? targets : [];
   }
+  if (lifetime.kind === "PHASES") {
+    if (operationTimelineIdx < 0) return targets;
+    return nowTimelineIndex - operationTimelineIdx < lifetime.count ? targets : [];
+  }
   if (lifetime.kind === "UNTIL_EVENT") {
     if (operationTimelineIdx < 0) return targets;
     for (let idx = operationTimelineIdx + 1; idx <= nowTimelineIndex; idx += 1) {
@@ -796,7 +811,8 @@ var applyOperationToPlayers = ({
             effector,
             targets: resolvedTargets,
             snapshotSeatMap: lifetimeSnapshotSeatMap,
-            characterMap
+            characterMap,
+            payloads
           });
           const handler = effectHandlers[effect.type];
           if (!handler) {
@@ -874,11 +890,83 @@ var applyOperationToPlayers = ({
   const final = runReplay(groundTruthSeatMap);
   return transformEmptyArray(final);
 };
+
+// src/can-invoke-ability.ts
+var checkTurns = (turns, currentTurn) => {
+  if (turns.only && turns.only.length > 0 && !turns.only.includes(currentTurn)) {
+    return `turn ${currentTurn} not in allowed turns ${JSON.stringify(turns.only)}`;
+  }
+  if (typeof turns.from === "number" && currentTurn < turns.from) {
+    return `turn ${currentTurn} is before allowed start turn ${turns.from}`;
+  }
+  if (typeof turns.to === "number" && currentTurn > turns.to) {
+    return `turn ${currentTurn} is after allowed end turn ${turns.to}`;
+  }
+  return null;
+};
+var countMatchingPriorOps = (priorOperations, abilityId, effectorSeat, operationTimelineMap, matchTurn, matchTime, timelines) => {
+  return priorOperations.filter((op) => {
+    if (op.abilityId !== abilityId) return false;
+    if (typeof effectorSeat === "number" && op.effector !== effectorSeat) return false;
+    if (matchTurn === null && matchTime === null) return true;
+    const idx = operationTimelineMap.get(op);
+    if (typeof idx !== "number") return false;
+    const tl = timelines[idx];
+    if (!tl) return false;
+    if (matchTurn !== null && tl.turn !== matchTurn) return false;
+    if (matchTime !== null && tl.time !== matchTime) return false;
+    return true;
+  }).length;
+};
+var canInvokeAbility = ({
+  ability,
+  effector,
+  currentTimelineIdx,
+  timelines,
+  priorOperations = []
+}) => {
+  const trigger = ability.triggerWindow;
+  if (!trigger) return { allowed: true };
+  const currentTimeline = timelines[currentTimelineIdx];
+  if (!currentTimeline) {
+    return { allowed: false, reason: `no timeline at index ${currentTimelineIdx}` };
+  }
+  if (trigger.turns) {
+    const turnError = checkTurns(trigger.turns, currentTimeline.turn);
+    if (turnError) return { allowed: false, reason: turnError };
+  }
+  if (trigger.phases && trigger.phases.length > 0 && !trigger.phases.includes(currentTimeline.time)) {
+    return { allowed: false, reason: `phase ${currentTimeline.time} not in allowed phases ${JSON.stringify(trigger.phases)}` };
+  }
+  if (trigger.requireEffectorAlive && (!effector || effector.isDead)) {
+    return { allowed: false, reason: "effector is not alive" };
+  }
+  if (trigger.frequency && priorOperations.length > 0) {
+    const operationTimelineMap = /* @__PURE__ */ new Map();
+    timelines.forEach((tl, idx) => tl.operations?.forEach((op) => operationTimelineMap.set(op, idx)));
+    const matchTurn = trigger.frequency === "ONCE_PER_GAME" ? null : currentTimeline.turn;
+    const matchTime = trigger.frequency === "ONCE_PER_GAME" ? null : trigger.frequency === "ONCE_PER_NIGHT" ? "night" : "day";
+    const count = countMatchingPriorOps(
+      priorOperations,
+      ability.id,
+      effector?.seat,
+      operationTimelineMap,
+      matchTurn,
+      matchTime,
+      timelines
+    );
+    if (count > 0) {
+      return { allowed: false, reason: `frequency ${trigger.frequency} already exhausted (${count} prior op${count === 1 ? "" : "s"})` };
+    }
+  }
+  return { allowed: true };
+};
 export {
   adjustValueAsNumber,
   adjustValueAsNumberArray,
   applyOperationToPlayers,
   buildPlayerSeatMap,
+  canInvokeAbility,
   copyPlayers,
   getSourceValue,
   getValueFromPayloads,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bct-app/game-engine",
-  "version": "0.1.6-beta.1",
+  "version": "0.1.6-beta.3",
   "description": "Game engine utilities for BCT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",