@aephia/atlas-kit 0.6.0-next.11 → 0.6.0-next.110

package/dist/world/planet-claim-stake-plots.js

@@ -0,0 +1,110 @@
+import { 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 { listClaimStakeDefinitions, resolveClaimStakeDefinition, } from '../registry/index.js';
+import { starbaseLevelIndex } from './starbase-status.js';
+const CLAIM_STAKE_TIERS = Object.freeze([
+    'one',
+    'two',
+    'three',
+    'four',
+    'five',
+]);
+/** Returns the zero-based column index of a Claim Stake tier.
+ *
+ * Planet plot, base rent and base placement-fee tables are indexed
+ * `[starbaseLevelIndex][claimStakeTierIndex]`: seven Starbase level rows and
+ * five tier columns.
+ *
+ * @example
+ * ```ts
+ * declare const planet: PlanetSnapshot;
+ * const level1TierTwo = planet.details.claimStakePlots[1]![claimStakeTierIndex('two')];
+ * ```
+ */
+export function claimStakeTierIndex(tier) {
+    return CLAIM_STAKE_TIERS.indexOf(tier);
+}
+function structuresOf(group) {
+    return (group?.structures ?? []).map((structure) => ({
+        active: structure.deactivationTimeUnixSeconds === 0n,
+        address: structure.address,
+        deactivationTimeUnixSeconds: structure.deactivationTimeUnixSeconds,
+    }));
+}
+function olderMetadata(planet, system) {
+    return {
+        commitment: planet.commitment,
+        slot: planet.slot < system.slot ? planet.slot : system.slot,
+        source: planet.source,
+        strategy: 'direct',
+    };
+}
+/** Builds the plot availability snapshot for a loaded Planet and its System. */
+export async function createPlanetClaimStakePlotsSnapshot(context, planet, system) {
+    const details = planet.details;
+    const catalog = await listClaimStakeDefinitions(context);
+    const groups = new Map(details.claimedPlots.map((group) => [group.key, group]));
+    const known = new Set(catalog.map((definition) => definition.id));
+    // A group keyed outside the loaded catalog forces the registry refresh and
+    // out-of-sync rejection that every definition lookup applies.
+    const refreshed = await Promise.all([...groups.keys()]
+        .filter((key) => !known.has(key))
+        .map((key) => resolveClaimStakeDefinition(context, key)));
+    const definitions = [...catalog, ...refreshed];
+    const starbase = system.starbase;
+    const levelIndex = starbase === undefined ? undefined : starbaseLevelIndex(starbase.level);
+    const tiers = CLAIM_STAKE_TIERS.map((tier, tierIndex) => {
+        // The pinned Planet codec fixes seven level rows and five tier columns.
+        const plotLimitByLevel = details.claimStakePlots.map((row) => row[tierIndex]);
+        const plotLimit = levelIndex === undefined ? undefined : plotLimitByLevel[levelIndex];
+        const entries = definitions
+            .filter((definition) => definition.tier === tier)
+            .map((definition) => {
+            const group = groups.get(definition.id);
+            const structures = structuresOf(group);
+            const occupied = structures.length;
+            return {
+                chronology: [...(group?.chronoAddresses ?? [])],
+                definition,
+                occupied,
+                ...(plotLimit === undefined
+                    ? {}
+                    : { available: Math.max(0, plotLimit - occupied) }),
+                requiredTagsProvided: definition.requiredTagIds.every((tag) => details.providedTags.includes(tag)),
+                structures,
+            };
+        });
+        if (levelIndex === undefined || plotLimit === undefined) {
+            return { definitions: entries, plotLimitByLevel, tier, tierIndex };
+        }
+        return {
+            basePlacementFee: {
+                ...details.baseClaimStakePlacementFee[levelIndex][tierIndex],
+            },
+            baseRentRate: {
+                ...details.baseClaimStakeRentRate[levelIndex][tierIndex],
+            },
+            definitions: entries,
+            plotLimit,
+            plotLimitByLevel,
+            tier,
+            tierIndex,
+        };
+    });
+    return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization({
+        address: planet.address,
+        bodyId: planet.id,
+        game: planet.game,
+        kind: 'planetClaimStakePlots',
+        name: planet.name,
+        providedTags: [...details.providedTags],
+        ...(starbase === undefined || levelIndex === undefined
+            ? {}
+            : { starbaseLevel: starbase.level, starbaseLevelIndex: levelIndex }),
+        system: entityRef('starSystem', system.address),
+        tiers,
+    }), olderMetadata(readMeta(planet), readMeta(system))));
+}
+//# sourceMappingURL=planet-claim-stake-plots.js.map

package/dist/world/planet-claim-stake-plots.js.map

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

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

@@ -0,0 +1,176 @@
+import { type Address, type EntityRef, type SageContext } from '../client/index.js';
+import type { WorldFaction, WorldStarbaseData, WorldStarbaseLevel, WorldStarbaseLevelInfoData } from '../internal/c4/world.js';
+import { type CargoDefinitionSummary } from '../registry/index.js';
+import type { StarSystemSnapshot } from './index.js';
+/** 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 declare function starbaseLevelIndex(level: WorldStarbaseLevel): number;
+/** One material a shared Starbase needs before it can reach its next level.
+ *
+ * `needed`, `deposited` and `remaining` are raw cargo units. `complete` is true
+ * once `deposited` has reached `needed`. `crew` and `durationSeconds` describe
+ * one contribution of this material: a Starbase Player installs it through its
+ * own `StarbaseUpgradeProcess`, which the `starbases` entry reads separately.
+ *
+ * @example
+ * ```ts
+ * declare const material: StarbaseUpgradeMaterial;
+ * console.log(material.cargoId, material.remaining);
+ * ```
+ */
+export interface StarbaseUpgradeMaterial {
+    readonly cargoId: number;
+    readonly needed: bigint;
+    readonly deposited: bigint;
+    readonly remaining: bigint;
+    readonly complete: boolean;
+    readonly crew: number;
+    readonly durationSeconds: number;
+}
+/** Shared progress of a Starbase toward its next level.
+ *
+ * `complete` is true when every listed material is fully deposited. The pinned
+ * contract states that the Starbase should then change level and reset the
+ * deposits; the program applies that change, the SDK only reports the stored
+ * state.
+ *
+ * @example
+ * ```ts
+ * declare const upgrade: StarbaseUpgradeProgress;
+ * console.log(upgrade.toLevel, upgrade.complete);
+ * ```
+ */
+export interface StarbaseUpgradeProgress {
+    readonly toLevel: WorldStarbaseLevel;
+    readonly complete: boolean;
+    readonly materials: readonly StarbaseUpgradeMaterial[];
+}
+/** Whether one Starbase service is enabled at the current level.
+ *
+ * @example
+ * ```ts
+ * declare const service: StarbaseServiceAvailability;
+ * if (service.available) console.log('enabled since', service.enabledFromLevel);
+ * ```
+ */
+export interface StarbaseServiceAvailability {
+    readonly enabledFromLevel: WorldStarbaseLevel;
+    readonly available: boolean;
+}
+/** Derived status of the shared Starbase nested in one StarSystem.
+ *
+ * `current` pairs the stored hull and shield points with the maximums the
+ * current level configures. `pendingHullPoints` mirrors the stored
+ * `pendingHp` field as is: the pinned contract only names it, so the SDK makes
+ * no claim about when or how the program settles it into `hullPoints`.
+ * `timing` values are raw Unix seconds, as on the Fleet combat status; shield
+ * and hull settlement rules are likewise unqualified. `upgrade` is absent once
+ * the Starbase has reached its maximum level.
+ *
+ * @example
+ * ```ts
+ * declare const status: StarbaseStatus;
+ * console.log(status.level, status.current.hullPoints, status.current.maxHullPoints);
+ * ```
+ */
+export interface StarbaseStatus {
+    readonly kind: 'starbaseStatus';
+    readonly owner: WorldFaction;
+    readonly level: WorldStarbaseLevel;
+    /** Ordinal from {@link starbaseLevelIndex}; the Central Space Station is 6. */
+    readonly levelIndex: number;
+    readonly maxLevel: WorldStarbaseLevel;
+    readonly atMaxLevel: boolean;
+    /** Configured values for the current level, copied from the level table. */
+    readonly levelInfo: WorldStarbaseLevelInfoData;
+    readonly current: {
+        readonly hullPoints: number;
+        readonly pendingHullPoints: number;
+        readonly maxHullPoints: number;
+        readonly shieldPoints: number;
+        readonly maxShieldPoints: number;
+    };
+    readonly timing: {
+        /** When shield points may resume regenerating after reaching zero. */
+        readonly shieldBreakDelayEndsAtUnixSeconds: bigint;
+        readonly lastCombatUpdateAtUnixSeconds: bigint;
+        /** When the Starbase was last built or destroyed. */
+        readonly builtOrDestroyedAtUnixSeconds: bigint;
+    };
+    readonly services: {
+        readonly localMarket: StarbaseServiceAvailability;
+        readonly repair: StarbaseServiceAvailability;
+    };
+    readonly upgrade?: StarbaseUpgradeProgress;
+    toJSON(): unknown;
+}
+/** One upgrade material with its registry-resolved cargo definition.
+ *
+ * @example
+ * ```ts
+ * declare const material: ResolvedStarbaseUpgradeMaterial;
+ * console.log(material.cargo.name, material.remaining);
+ * ```
+ */
+export interface ResolvedStarbaseUpgradeMaterial extends StarbaseUpgradeMaterial {
+    readonly cargo: CargoDefinitionSummary;
+}
+/** Upgrade progress whose materials carry resolved cargo definitions.
+ *
+ * @example
+ * ```ts
+ * declare const upgrade: ResolvedStarbaseUpgradeProgress;
+ * console.log(upgrade.materials.map((material) => material.cargo.name));
+ * ```
+ */
+export interface ResolvedStarbaseUpgradeProgress extends Omit<StarbaseUpgradeProgress, 'materials'> {
+    readonly materials: readonly ResolvedStarbaseUpgradeMaterial[];
+}
+/** Immutable shared Starbase status read for one StarSystem.
+ *
+ * `address` is the StarSystem address: the nested Starbase has no account of
+ * its own. Read metadata comes from the StarSystem observation.
+ *
+ * @example
+ * ```ts
+ * declare const status: StarbaseStatusSnapshot;
+ * console.log(status.systemName, status.upgrade?.materials[0]?.cargo.name);
+ * ```
+ */
+export interface StarbaseStatusSnapshot extends Omit<StarbaseStatus, 'upgrade'> {
+    readonly address: Address;
+    readonly system: EntityRef<'starSystem'>;
+    readonly systemName: string;
+    readonly upgrade?: ResolvedStarbaseUpgradeProgress;
+}
+/** 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 declare function deriveStarbaseStatus(starbase: WorldStarbaseData): StarbaseStatus;
+/** Builds the resolved status snapshot for a loaded StarSystem's Starbase. */
+export declare function createStarbaseStatusSnapshot(context: SageContext, system: StarSystemSnapshot, starbase: WorldStarbaseData): Promise<StarbaseStatusSnapshot>;
+//# sourceMappingURL=starbase-status.d.ts.map

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.11",
+  "version": "0.6.0-next.110",
   "description": "Community-maintained non-custodial TypeScript SDK for Star Atlas SAGE C4.",
   "license": "Apache-2.0",
   "author": "Aephia contributors",
@@ -120,6 +120,10 @@
       "types": "./dist/mining/index.d.ts",
       "import": "./dist/mining/index.js"
     },
+    "./mining/actions": {
+      "types": "./dist/mining/actions/index.d.ts",
+      "import": "./dist/mining/actions/index.js"
+    },
     "./planning": {
       "types": "./dist/planning/index.d.ts",
       "import": "./dist/planning/index.js"
@@ -143,6 +147,10 @@
     "./world": {
       "types": "./dist/world/index.d.ts",
       "import": "./dist/world/index.js"
+    },
+    "./scanning/actions": {
+      "types": "./dist/scanning/actions/index.d.ts",
+      "import": "./dist/scanning/actions/index.js"
     }
   },
   "files": [
@@ -157,7 +165,7 @@
   "dependencies": {
     "@staratlas/dev-player-profile": "0.45.7",
     "@staratlas/dev-profile-faction": "0.45.7",
-    "@staratlas/dev-sage": "0.52.0"
+    "@staratlas/dev-sage": "0.53.0"
   },
   "peerDependencies": {
     "@solana/kit": "^6.1.0"