@aephia/atlas-kit 0.6.0-next.71 → 0.6.0-next.73

package/dist/world/starbase-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starbase-status.d.ts","sourceRoot":"","sources":["../../src/world/starbase-status.ts"],"names":[],"mappings":"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"}

package/dist/world/starbase-status.js

@@ -0,0 +1,153 @@
+import { InvalidDerivationInputError, entityRef, } from '../client/index.js';
+import { attachJsonSerialization } from '../internal/json.js';
+import { attachReadMeta, readMeta } from '../internal/read-meta.js';
+import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
+import { resolveCargo, } from '../registry/index.js';
+const STARBASE_LEVEL_INDEX = Object.freeze({
+    'level-0': 0,
+    'level-1': 1,
+    'level-2': 2,
+    'level-3': 3,
+    'level-4': 4,
+    'level-5': 5,
+    css: 6,
+});
+/** Returns the zero-based ordinal of a Starbase level label.
+ *
+ * Levels `level-0` through `level-5` map to 0 through 5 and the Central Space
+ * Station (`css`) ranks above them as 6. This is the row index used by Planet
+ * Claim Stake plot tables and Starbase Crafting Hab plot tables, and the order
+ * used to compare a Starbase level with a service enable level.
+ *
+ * @example
+ * ```ts
+ * const unlocked = starbaseLevelIndex('level-3') >= starbaseLevelIndex('level-2');
+ * ```
+ */
+export function starbaseLevelIndex(level) {
+    return STARBASE_LEVEL_INDEX[level];
+}
+function copyFixed(value) {
+    return { raw: value.raw, value: value.value };
+}
+function copyLevelInfo(info) {
+    return {
+        damagePerRound: info.damagePerRound,
+        hp: info.hp,
+        repairAbility: copyFixed(info.repairAbility),
+        repairCost: copyFixed(info.repairCost),
+        repairEfficiency: copyFixed(info.repairEfficiency),
+        repairFeeAtlas: info.repairFeeAtlas,
+        repairFeeRaw: info.repairFeeRaw,
+        repairRate: copyFixed(info.repairRate),
+        shieldBreakDelaySeconds: info.shieldBreakDelaySeconds,
+        shieldRechargeRate: copyFixed(info.shieldRechargeRate),
+        sp: info.sp,
+        xp: copyFixed(info.xp),
+    };
+}
+function serviceAvailability(levelIndex, enabledFromLevel) {
+    return {
+        available: levelIndex >= starbaseLevelIndex(enabledFromLevel),
+        enabledFromLevel,
+    };
+}
+function upgradeProgress(toLevel, upgrades) {
+    const materials = upgrades.map((upgrade) => {
+        const remaining = upgrade.needed > upgrade.deposited
+            ? upgrade.needed - upgrade.deposited
+            : 0n;
+        return {
+            cargoId: upgrade.cargoId,
+            complete: remaining === 0n,
+            crew: upgrade.crew,
+            deposited: upgrade.deposited,
+            durationSeconds: upgrade.durationSeconds,
+            needed: upgrade.needed,
+            remaining,
+        };
+    });
+    return {
+        complete: materials.every((material) => material.complete),
+        materials,
+        toLevel,
+    };
+}
+/** Derives the status of a shared Starbase from already-loaded StarSystem data.
+ *
+ * This is pure and network-free: it needs neither the context nor the Game
+ * definitions registry, so galaxy-map readers can call it on every System they
+ * already hold. The result is a new deeply frozen value; the input is left
+ * untouched. Materials carry numeric cargo ids; use `getStarbaseStatus` when
+ * you want them resolved to cargo definitions.
+ *
+ * @example
+ * ```ts
+ * declare const system: StarSystemSnapshot;
+ * if (system.starbase !== undefined) {
+ *   const status = deriveStarbaseStatus(system.starbase);
+ *   console.log(status.level, status.upgrade?.toLevel);
+ * }
+ * ```
+ */
+export function deriveStarbaseStatus(starbase) {
+    const levels = starbase.maxLevel.levels;
+    const position = levels.findIndex((entry) => entry.level === starbase.level);
+    if (position === -1) {
+        throw new InvalidDerivationInputError('Starbase level', starbase.level, `The nested Starbase reports level ${starbase.level}, but its ${starbase.maxLevel.kind} level table only describes ${levels.map((entry) => entry.level).join(', ')}. Refresh the StarSystem and verify the pinned binding version before deriving its status.`);
+    }
+    const current = levels[position];
+    const next = levels[position + 1];
+    const levelIndex = starbaseLevelIndex(starbase.level);
+    const upgrade = next === undefined
+        ? undefined
+        : upgradeProgress(next.level, current.upgrades);
+    return freezeResolvedSnapshot(attachJsonSerialization({
+        atMaxLevel: next === undefined,
+        current: {
+            hullPoints: starbase.hp,
+            maxHullPoints: current.info.hp,
+            maxShieldPoints: current.info.sp,
+            pendingHullPoints: starbase.pendingHp,
+            shieldPoints: starbase.sp,
+        },
+        kind: 'starbaseStatus',
+        level: starbase.level,
+        levelIndex,
+        levelInfo: copyLevelInfo(current.info),
+        maxLevel: starbase.maxLevel.kind,
+        owner: starbase.owner,
+        services: {
+            localMarket: serviceAvailability(levelIndex, starbase.localMarketEnableLevel),
+            repair: serviceAvailability(levelIndex, starbase.repairEnableLevel),
+        },
+        timing: {
+            builtOrDestroyedAtUnixSeconds: starbase.builtDestroyedAtUnixSeconds,
+            lastCombatUpdateAtUnixSeconds: starbase.lastCombatUpdateUnixSeconds,
+            shieldBreakDelayEndsAtUnixSeconds: starbase.shieldBreakDelayExpiresAtUnixSeconds,
+        },
+        ...(upgrade === undefined ? {} : { upgrade }),
+    }));
+}
+/** Builds the resolved status snapshot for a loaded StarSystem's Starbase. */
+export async function createStarbaseStatusSnapshot(context, system, starbase) {
+    const { upgrade, ...status } = deriveStarbaseStatus(starbase);
+    const resolvedUpgrade = upgrade === undefined
+        ? undefined
+        : {
+            complete: upgrade.complete,
+            materials: await Promise.all(upgrade.materials.map(async (material) => ({
+                ...material,
+                cargo: await resolveCargo(context, material.cargoId),
+            }))),
+            toLevel: upgrade.toLevel,
+        };
+    return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization({
+        ...status,
+        address: system.address,
+        system: entityRef('starSystem', system.address),
+        systemName: system.name,
+        ...(resolvedUpgrade === undefined ? {} : { upgrade: resolvedUpgrade }),
+    }), readMeta(system)));
+}
+//# sourceMappingURL=starbase-status.js.map

package/dist/world/starbase-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starbase-status.js","sourceRoot":"","sources":["../../src/world/starbase-status.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aephia/atlas-kit",
-  "version": "0.6.0-next.71",
+  "version": "0.6.0-next.73",
   "description": "Community-maintained non-custodial TypeScript SDK for Star Atlas SAGE C4.",
   "license": "Apache-2.0",
   "author": "Aephia contributors",