@aephia/atlas-kit 0.0.0

package/dist/starbases/actions/index.js

@@ -0,0 +1,245 @@
+import { getAddressEncoder, isAddress } from '@solana/kit';
+import { InvalidActionInputError, SageSdkError } from '../../client/errors.js';
+import { ProviderAccountAddressMismatchError } from '../../client/provider-errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { deriveFactionConfigAddress, deriveFactionOwnershipAddress, deriveFactionRelationTrackerAddress, deriveFactionStandingAddress, factionConfigAccountDefinition, factionOwnershipAccountDefinition, factionRelationTrackerAccountDefinition, factionStandingAccountDefinition, } from '../../internal/c4/factions.js';
+import { characterAccountDefinition, findCharacterPda, } from '../../internal/c4/identity.js';
+import { deriveProfileFactionAddress, profileFactionAccountDefinition, } from '../../internal/c4/profile-faction.js';
+import { deriveStarbasePlayerAddress } from '../../internal/c4/starbase.js';
+import { deriveStarSystemAddress, starSystemAccountDefinition, } from '../../internal/c4/world.js';
+import { requireGameAddress } from '../../internal/game-context.js';
+import { adaptRegisterStarbasePlayerInstruction } from '../../internal/planning/authorization-adapter.js';
+import { createPlan, } from '../../planning/index.js';
+function fail(message, address) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+function validateOptions(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new InvalidActionInputError('options', value, 'an object containing only funder', 'Pass { funder } with one valid z.ink/Solana address before retrying.');
+    }
+    const record = value;
+    if (Object.keys(record).length !== 1 ||
+        !Object.hasOwn(record, 'funder') ||
+        typeof record.funder !== 'string' ||
+        !isAddress(record.funder)) {
+        throw new InvalidActionInputError('options.funder', record.funder, 'one valid z.ink/Solana account address and no other option fields', 'Set options.funder to the address that will pay StarbasePlayer account rent before retrying.');
+    }
+    return { funder: record.funder };
+}
+function requireAccount(account, address, message) {
+    return account ?? fail(message, address);
+}
+function isProviderAddressMismatch(cause, addresses) {
+    return (cause instanceof ProviderAccountAddressMismatchError &&
+        addresses.includes(cause.requestedAddress));
+}
+async function readAccounts(ctx, addresses) {
+    try {
+        return await readContextRawAccounts(ctx, addresses);
+    }
+    catch (cause) {
+        if (isProviderAddressMismatch(cause, addresses)) {
+            fail(`StarbasePlayer registration cannot continue because the provider returned a contradictory account address for ${cause.requestedAddress}. Fix the provider response, refresh the Character and Star System, and retry.`, cause.requestedAddress);
+        }
+        throw cause;
+    }
+}
+async function hashAccountState(account) {
+    const owner = getAddressEncoder().encode(account.owner);
+    const canonical = new Uint8Array(owner.length + account.data.length);
+    canonical.set(owner);
+    canonical.set(account.data, owner.length);
+    const digest = new Uint8Array(await globalThis.crypto.subtle.digest('SHA-256', canonical));
+    return [...digest].map((byte) => byte.toString(16).padStart(2, '0')).join('');
+}
+async function precondition(account, describes) {
+    return Object.freeze({
+        address: account.address,
+        dataHash: await hashAccountState(account),
+        describes,
+        kind: 'account-state',
+    });
+}
+function legacyController(owner) {
+    switch (owner) {
+        case 'unaligned':
+            return 0;
+        case 'mud':
+            return 1;
+        case 'oni':
+            return 2;
+        case 'ustur':
+            return 3;
+    }
+}
+/** Plans one StarbasePlayer registration without signing, assembly, or writes.
+ *
+ * The Character and Star System must already be loaded public snapshots. The
+ * planner derives and directly validates every plumbing account, requires the
+ * current fail-closed Starbase FactionOwnership sidecar, and returns a Plan only
+ * when the canonical StarbasePlayer address is absent. Optional faction
+ * expansion accounts use the generated omitted-account convention.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const character: CharacterSnapshot;
+ * declare const system: StarSystemSnapshot;
+ * declare const funder: Address;
+ * const plan = await planRegisterStarbasePlayer(
+ *   ctx,
+ *   character,
+ *   system,
+ *   { funder },
+ * );
+ * console.log(plan.describe());
+ * ```
+ */
+export async function planRegisterStarbasePlayer(ctx, character, system, input) {
+    const { funder } = validateOptions(input);
+    const game = requireGameAddress(ctx);
+    if (character.game !== game) {
+        fail(`Character ${character.address} does not match the configured Game ${game}. Refresh the Character through this context and retry.`, character.address);
+    }
+    const profile = character.profile.address;
+    const canonicalCharacter = await findCharacterPda(profile, game);
+    if (canonicalCharacter !== character.address) {
+        fail(`Character ${character.address} is not the canonical Character for Profile ${profile} in the configured Game. Refresh the Character for this Profile and retry.`, character.address);
+    }
+    if (system.game !== game) {
+        fail(`Star System ${system.address} does not match the configured Game ${game}. Refresh the Star System through this context and retry.`, system.address);
+    }
+    const canonicalSystem = await deriveStarSystemAddress(game, system.systemId);
+    if (canonicalSystem !== system.address) {
+        fail(`Star System ${system.address} is not the canonical System ${String(system.systemId)} for the configured Game. Refresh the Star System and retry.`, system.address);
+    }
+    if (system.starbase === undefined) {
+        fail(`Star System ${system.name} has no nested Starbase. Choose a Star System with a shared Starbase, refresh it, and retry registration.`, system.address);
+    }
+    const playerFaction = await deriveProfileFactionAddress(profile);
+    const starbasePlayer = await deriveStarbasePlayerAddress(system.address, character.address);
+    const ownership = await deriveFactionOwnershipAddress(game, 'starbase', system.address);
+    const relation = await deriveFactionRelationTrackerAddress(game);
+    const config = await deriveFactionConfigAddress(game);
+    const firstAddresses = [
+        character.address,
+        playerFaction,
+        system.address,
+        starbasePlayer,
+        ownership,
+        relation,
+        config,
+    ];
+    const [characterCandidate, factionCandidate, systemCandidate, playerCandidate, ownershipCandidate, relationCandidate, configCandidate,] = await readAccounts(ctx, firstAddresses);
+    const characterAccount = requireAccount(characterCandidate, character.address, `Canonical Character ${character.address} is missing. Create or repair the Character for Profile ${profile}, refresh it, and retry registration.`);
+    const factionAccount = requireAccount(factionCandidate, playerFaction, `ProfileFaction ${playerFaction} is missing for Profile ${profile}. Choose or repair the Profile faction, refresh it, and retry registration.`);
+    const systemAccount = requireAccount(systemCandidate, system.address, `Star System ${system.address} is missing. Refresh the Star System and retry registration.`);
+    if (playerCandidate !== undefined) {
+        fail(`StarbasePlayer ${starbasePlayer} already exists for this Character and Star System. Use the existing Starbase Player instead of registering it again.`, starbasePlayer);
+    }
+    const ownershipAccount = requireAccount(ownershipCandidate, ownership, `The required FactionOwnership ${ownership} for Starbase ${system.name} is missing. Refresh the Starbase faction state or repair the ownership sidecar, then retry registration.`);
+    const characterData = characterAccountDefinition.decode(characterAccount);
+    if (characterData.playerProfile !== profile ||
+        characterData.game !== game ||
+        (await findCharacterPda(characterData.playerProfile, characterData.game)) !== character.address) {
+        fail(`The canonical Character does not match Profile ${profile} and the configured Game. Refresh or repair the Character relationship before retrying.`, character.address);
+    }
+    const factionData = profileFactionAccountDefinition.decode(factionAccount);
+    if (factionData.profile !== profile) {
+        fail(`ProfileFaction ${playerFaction} does not match Character Profile ${profile}. Refresh or repair the Profile faction before retrying.`, playerFaction);
+    }
+    const systemData = starSystemAccountDefinition.decode(systemAccount);
+    if (systemData.game !== game ||
+        systemData.systemId !== system.systemId ||
+        (await deriveStarSystemAddress(systemData.game, systemData.systemId)) !==
+            system.address ||
+        systemData.starbase === undefined) {
+        fail(`Star System ${system.address} does not match the configured Game, canonical PDA, System id, or required nested Starbase. Refresh the Star System and retry registration.`, system.address);
+    }
+    const ownershipData = factionOwnershipAccountDefinition.decode(ownershipAccount);
+    if (ownershipData.game !== game ||
+        ownershipData.asset.kind !== 'starbase' ||
+        ownershipData.asset.system !== system.address) {
+        fail(`FactionOwnership ${ownership} does not match the configured Game and Star System ${system.address}. Refresh or repair the Starbase ownership sidecar before retrying.`, ownership);
+    }
+    let relationAccount;
+    if (relationCandidate !== undefined) {
+        const relationData = factionRelationTrackerAccountDefinition.decode(relationCandidate);
+        if (relationData.game !== game) {
+            fail(`FactionRelationTracker ${relation} does not match the configured Game. Refresh or repair the faction relation data before retrying.`, relation);
+        }
+        relationAccount = relationCandidate;
+    }
+    if (configCandidate !== undefined) {
+        factionConfigAccountDefinition.decode(configCandidate);
+    }
+    const controller = ownershipData.controllingFactionId ??
+        legacyController(systemData.starbase.owner);
+    let standingAddress;
+    let standingAccount;
+    if (controller !== 0) {
+        standingAddress = await deriveFactionStandingAddress(game, profile, controller);
+        [standingAccount] = await readAccounts(ctx, [standingAddress]);
+        if (standingAccount !== undefined) {
+            const standingData = factionStandingAccountDefinition.decode(standingAccount);
+            if (standingData.game !== game ||
+                standingData.profile !== profile ||
+                standingData.factionId !== controller) {
+                fail(`FactionStanding ${standingAddress} does not match Profile ${profile} and the current Starbase controller. Refresh or repair the standing account before retrying.`, standingAddress);
+            }
+        }
+    }
+    const factionExpansion = relationAccount !== undefined &&
+        standingAddress !== undefined &&
+        standingAccount !== undefined &&
+        configCandidate !== undefined
+        ? {
+            configAccount: configCandidate,
+            relationAccount,
+            standingAccount,
+            standingAddress,
+        }
+        : undefined;
+    const description = `Register Profile ${profile}'s Character at Starbase ${systemData.name} for player-local Starbase services.`;
+    const preconditions = [
+        precondition(characterAccount, `The canonical Character remains assigned to Profile ${profile} in the configured Game.`),
+        precondition(factionAccount, `The Profile faction remains assigned to Profile ${profile}.`),
+        precondition(systemAccount, `Star System ${systemData.name} remains the selected System with its nested Starbase.`),
+        precondition(ownershipAccount, `The Starbase faction ownership remains assigned to System ${system.address}.`),
+        ...(factionExpansion === undefined
+            ? []
+            : [
+                precondition(factionExpansion.relationAccount, 'The faction relation tracker remains assigned to the configured Game.'),
+                precondition(factionExpansion.standingAccount, `The Profile standing remains assigned to current Starbase controller ${String(controller)}.`),
+                precondition(factionExpansion.configAccount, 'The faction configuration remains available with the Profile standing expansion.'),
+            ]),
+    ];
+    return createPlan({
+        kind: 'starbases.register-player',
+        preconditions: await Promise.all(preconditions),
+        steps: [
+            {
+                describes: description,
+                instruction: adaptRegisterStarbasePlayerInstruction({
+                    character: character.address,
+                    factionOwnership: ownership,
+                    funder,
+                    game,
+                    profileFaction: playerFaction,
+                    starbasePlayer,
+                    system: system.address,
+                    ...(factionExpansion === undefined
+                        ? {}
+                        : {
+                            factionConfig: config,
+                            factionRelationTracker: relation,
+                            factionStanding: factionExpansion.standingAddress,
+                        }),
+                }),
+                signers: [funder],
+            },
+        ],
+        summary: `Register Profile ${profile}'s Character at Starbase ${systemData.name}.`,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/starbases/actions/index.js.map

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

package/dist/starbases/index.d.ts

@@ -0,0 +1,165 @@
+import { type Address, type DiscoveryRequest, type EntityRef, type ReadOptions, type SageContext } from '../client/index.js';
+import { type StarbaseEscrowedShipData, type StarbasePlayerAccountData, type StarbaseShipRespawnData, type StarbaseUpgradeProcessAccountData } from '../internal/c4/starbase.js';
+import { type CargoDefinitionSummary, type ShipDefinitionSummary } from '../registry/index.js';
+export type { StarbaseCargoAmountData, StarbaseCargoPodData, StarbaseEscrowedShipData, StarbaseFacilityRespawnData, StarbasePlayerAccountData, StarbasePlayerFaction, StarbaseRespawnQueueData, StarbaseShipRespawnData, StarbaseUpgradeProcessAccountData, } from '../internal/c4/starbase.js';
+/** Options supported by targeted player-local Starbase discovery.
+ * @example
+ * ```ts
+ * const options: StarbaseDiscoveryOptions = { commitment: 'confirmed' };
+ * ```
+ */
+export type StarbaseDiscoveryOptions = Omit<DiscoveryRequest, 'filters' | 'strategy'>;
+/** One resolved cargo quantity stored in a player-local Starbase CargoPod.
+ * @example
+ * ```ts
+ * declare const item: StarbaseCargoItem;
+ * console.log(item.name, item.quantityRaw);
+ * ```
+ */
+export interface StarbaseCargoItem extends CargoDefinitionSummary {
+    readonly quantityRaw: bigint;
+}
+/** One resolved player-local Starbase CargoPod.
+ * @example
+ * ```ts
+ * declare const cargo: StarbaseCargoInventory;
+ * console.log(cargo.items);
+ * ```
+ */
+export interface StarbaseCargoInventory {
+    readonly sequenceId: number;
+    readonly usedStorageUnitsRaw: bigint;
+    readonly items: readonly StarbaseCargoItem[];
+}
+/** One resolved ship respawn queue.
+ * @example
+ * ```ts
+ * declare const ship: StarbaseShipRespawn;
+ * console.log(ship.name, ship.completesAtUnixSeconds);
+ * ```
+ */
+export interface StarbaseShipRespawn extends ShipDefinitionSummary, Omit<StarbaseShipRespawnData, 'shipId'> {
+}
+/** One resolved escrowed ship quantity.
+ * @example
+ * ```ts
+ * declare const ship: StarbaseEscrowedShip;
+ * console.log(ship.name, ship.quantityRaw);
+ * ```
+ */
+export interface StarbaseEscrowedShip extends ShipDefinitionSummary, Omit<StarbaseEscrowedShipData, 'shipId'> {
+}
+/** Immutable, translated player-local Starbase snapshot.
+ * @example
+ * ```ts
+ * declare const starbase: StarbasePlayerSnapshot;
+ * console.log(starbase.availableCrew, starbase.cargo.items);
+ * ```
+ */
+export interface StarbasePlayerSnapshot extends Omit<StarbasePlayerAccountData, 'cargo' | 'character' | 'playerProfile' | 'respawning' | 'shipsInEscrow' | 'system'> {
+    readonly kind: 'starbasePlayer';
+    readonly address: Address;
+    readonly playerProfile: EntityRef<'profile'>;
+    readonly system: EntityRef<'starSystem'>;
+    readonly character: EntityRef<'character'>;
+    readonly availableCrew: number;
+    readonly cargo: StarbaseCargoInventory;
+    readonly respawning: Omit<StarbasePlayerAccountData['respawning'], 'cargo' | 'ships'> & {
+        readonly cargo: StarbaseCargoInventory;
+        readonly ships: readonly StarbaseShipRespawn[];
+    };
+    readonly shipsInEscrow: readonly StarbaseEscrowedShip[];
+    toJSON(): unknown;
+}
+/** Immutable, translated Starbase upgrade-process snapshot.
+ * @example
+ * ```ts
+ * declare const upgrade: StarbaseUpgradeProcessSnapshot;
+ * console.log(upgrade.resource.name, upgrade.endsAtUnixSeconds);
+ * ```
+ */
+export interface StarbaseUpgradeProcessSnapshot extends Omit<StarbaseUpgradeProcessAccountData, 'playerProfile' | 'quantityRaw' | 'resourceId' | 'starbasePlayer' | 'system'> {
+    readonly kind: 'starbaseUpgradeProcess';
+    readonly address: Address;
+    readonly playerProfile: EntityRef<'profile'>;
+    readonly starbasePlayer: EntityRef<'starbasePlayer'>;
+    readonly system: EntityRef<'starSystem'>;
+    readonly resource: CargoDefinitionSummary & {
+        readonly quantityRaw: bigint;
+    };
+    toJSON(): unknown;
+}
+/** Reads one required StarbasePlayer by address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const starbase = await getStarbasePlayer(ctx, address);
+ * ```
+ */
+export declare function getStarbasePlayer(context: SageContext, address: Address, options?: ReadOptions): Promise<StarbasePlayerSnapshot>;
+/** Reads one optional StarbasePlayer by address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const starbase = await maybeGetStarbasePlayer(ctx, address);
+ * ```
+ */
+export declare function maybeGetStarbasePlayer(context: SageContext, address: Address, options?: ReadOptions): Promise<StarbasePlayerSnapshot | undefined>;
+/** Derives and reads StarbasePlayer for one Character at one Star System.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const character: Address;
+ * declare const system: Address;
+ * const starbase = await getStarbasePlayerForCharacterAtSystem(ctx, character, system);
+ * ```
+ */
+export declare function getStarbasePlayerForCharacterAtSystem(context: SageContext, character: Address, system: Address, options?: ReadOptions): Promise<StarbasePlayerSnapshot>;
+/** Discovers player-local Starbases for one Character.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const character: Address;
+ * const starbases = await getStarbasePlayersByCharacter(ctx, character);
+ * ```
+ */
+export declare function getStarbasePlayersByCharacter(context: SageContext, character: Address, options?: StarbaseDiscoveryOptions): Promise<readonly StarbasePlayerSnapshot[]>;
+/** Discovers player-local Starbases in one Star System.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const system: Address;
+ * const starbases = await getStarbasePlayersBySystem(ctx, system);
+ * ```
+ */
+export declare function getStarbasePlayersBySystem(context: SageContext, system: Address, options?: StarbaseDiscoveryOptions): Promise<readonly StarbasePlayerSnapshot[]>;
+/** Reads one required StarbaseUpgradeProcess by its signer-created address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const upgrade = await getStarbaseUpgradeProcess(ctx, address);
+ * ```
+ */
+export declare function getStarbaseUpgradeProcess(context: SageContext, address: Address, options?: ReadOptions): Promise<StarbaseUpgradeProcessSnapshot>;
+/** Reads one optional StarbaseUpgradeProcess by address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const upgrade = await maybeGetStarbaseUpgradeProcess(ctx, address);
+ * ```
+ */
+export declare function maybeGetStarbaseUpgradeProcess(context: SageContext, address: Address, options?: ReadOptions): Promise<StarbaseUpgradeProcessSnapshot | undefined>;
+/** Discovers Starbase upgrade processes stored against one StarbasePlayer.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const player: Address;
+ * const upgrades = await getStarbaseUpgradeProcessesByPlayer(ctx, player);
+ * ```
+ */
+export declare function getStarbaseUpgradeProcessesByPlayer(context: SageContext, player: Address, options?: StarbaseDiscoveryOptions): Promise<readonly StarbaseUpgradeProcessSnapshot[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/starbases/index.d.ts.map

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

package/dist/starbases/index.js

@@ -0,0 +1,213 @@
+import { AccountDecodeError, entityRef, } from '../client/index.js';
+import { deriveStarbasePlayerAddress, discoverStarbasePlayersByCharacter, discoverStarbasePlayersBySystem, discoverStarbaseUpgradeProcessesByPlayer, starbasePlayerAccountDefinition, starbaseUpgradeProcessAccountDefinition, } from '../internal/c4/starbase.js';
+import { requireGameAddress } from '../internal/game-context.js';
+import { attachJsonSerialization } from '../internal/json.js';
+import { attachReadMeta, readMeta } from '../internal/read-meta.js';
+import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
+import { resolveCargo, resolveShip, } from '../registry/index.js';
+const PLAYER_SNAPSHOTS = new WeakMap();
+const UPGRADE_SNAPSHOTS = new WeakMap();
+function directMetadata(envelope) {
+    return {
+        commitment: envelope.commitment,
+        slot: envelope.slot,
+        source: envelope.source,
+        strategy: 'direct',
+    };
+}
+async function cargoInventory(context, pod) {
+    return {
+        items: await Promise.all(pod.amounts.map(async ({ amount, cargoId }) => ({
+            ...(await resolveCargo(context, cargoId)),
+            quantityRaw: amount,
+        }))),
+        sequenceId: pod.sequenceId,
+        usedStorageUnitsRaw: pod.usedStorageUnitsRaw,
+    };
+}
+async function shipRespawn(context, value) {
+    const { shipId, ...queue } = value;
+    return { ...(await resolveShip(context, shipId)), ...queue };
+}
+async function escrowedShip(context, value) {
+    const { shipId, ...quantity } = value;
+    return { ...(await resolveShip(context, shipId)), ...quantity };
+}
+async function createPlayerSnapshot(context, envelope) {
+    requireGameAddress(context);
+    const { cargo, character, playerProfile, respawning, shipsInEscrow, system, ...data } = envelope.data;
+    const [resolvedCargo, respawningCargo, respawningShips, resolvedEscrow] = await Promise.all([
+        cargoInventory(context, cargo),
+        cargoInventory(context, respawning.cargo),
+        Promise.all(respawning.ships.map((value) => shipRespawn(context, value))),
+        Promise.all(shipsInEscrow.map((value) => escrowedShip(context, value))),
+    ]);
+    return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization({
+        ...data,
+        address: envelope.address,
+        availableCrew: Math.max(0, data.totalCrew - data.busyCrew),
+        cargo: resolvedCargo,
+        character: entityRef('character', character),
+        kind: 'starbasePlayer',
+        playerProfile: entityRef('profile', playerProfile),
+        respawning: {
+            ...respawning,
+            cargo: respawningCargo,
+            ships: respawningShips,
+        },
+        shipsInEscrow: resolvedEscrow,
+        system: entityRef('starSystem', system),
+    }), directMetadata(envelope)));
+}
+function toPlayerSnapshot(context, envelope) {
+    const existing = PLAYER_SNAPSHOTS.get(envelope);
+    if (existing !== undefined)
+        return existing;
+    const pending = createPlayerSnapshot(context, envelope);
+    PLAYER_SNAPSHOTS.set(envelope, pending);
+    void pending.catch(() => PLAYER_SNAPSHOTS.delete(envelope));
+    return pending;
+}
+async function createUpgradeSnapshot(context, envelope) {
+    requireGameAddress(context);
+    const { playerProfile, quantityRaw, resourceId, starbasePlayer, system, ...data } = envelope.data;
+    return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization({
+        ...data,
+        address: envelope.address,
+        kind: 'starbaseUpgradeProcess',
+        playerProfile: entityRef('profile', playerProfile),
+        resource: {
+            ...(await resolveCargo(context, resourceId)),
+            quantityRaw,
+        },
+        starbasePlayer: entityRef('starbasePlayer', starbasePlayer),
+        system: entityRef('starSystem', system),
+    }), directMetadata(envelope)));
+}
+function toUpgradeSnapshot(context, envelope) {
+    const existing = UPGRADE_SNAPSHOTS.get(envelope);
+    if (existing !== undefined)
+        return existing;
+    const pending = createUpgradeSnapshot(context, envelope);
+    UPGRADE_SNAPSHOTS.set(envelope, pending);
+    void pending.catch(() => UPGRADE_SNAPSHOTS.delete(envelope));
+    return pending;
+}
+async function playerSnapshotsFromDiscovery(context, envelopes) {
+    const metadata = readMeta(envelopes);
+    const snapshots = await Promise.all(envelopes.map((envelope) => toPlayerSnapshot(context, envelope)));
+    return Object.freeze(attachReadMeta(snapshots, metadata));
+}
+/** Reads one required StarbasePlayer by address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const starbase = await getStarbasePlayer(ctx, address);
+ * ```
+ */
+export async function getStarbasePlayer(context, address, options) {
+    requireGameAddress(context);
+    return toPlayerSnapshot(context, await context.data.read(starbasePlayerAccountDefinition, address, options));
+}
+/** Reads one optional StarbasePlayer by address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const starbase = await maybeGetStarbasePlayer(ctx, address);
+ * ```
+ */
+export async function maybeGetStarbasePlayer(context, address, options) {
+    requireGameAddress(context);
+    const [envelope] = await context.data.readMany(starbasePlayerAccountDefinition, [address], options);
+    return envelope === undefined
+        ? undefined
+        : toPlayerSnapshot(context, envelope);
+}
+/** Derives and reads StarbasePlayer for one Character at one Star System.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const character: Address;
+ * declare const system: Address;
+ * const starbase = await getStarbasePlayerForCharacterAtSystem(ctx, character, system);
+ * ```
+ */
+export async function getStarbasePlayerForCharacterAtSystem(context, character, system, options) {
+    requireGameAddress(context);
+    const address = await deriveStarbasePlayerAddress(system, character);
+    const envelope = await context.data.read(starbasePlayerAccountDefinition, address, options);
+    if (envelope.data.character !== character ||
+        envelope.data.system !== system) {
+        throw new AccountDecodeError('starbasePlayer', address, new RangeError('The decoded StarbasePlayer contradicted its PDA seeds.'), `The Starbase Player at ${address} does not reference the requested Character and Star System. Verify both addresses, the configured cluster, and pinned binding version before retrying.`);
+    }
+    return toPlayerSnapshot(context, envelope);
+}
+/** Discovers player-local Starbases for one Character.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const character: Address;
+ * const starbases = await getStarbasePlayersByCharacter(ctx, character);
+ * ```
+ */
+export async function getStarbasePlayersByCharacter(context, character, options) {
+    requireGameAddress(context);
+    return playerSnapshotsFromDiscovery(context, await discoverStarbasePlayersByCharacter(context, character, options));
+}
+/** Discovers player-local Starbases in one Star System.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const system: Address;
+ * const starbases = await getStarbasePlayersBySystem(ctx, system);
+ * ```
+ */
+export async function getStarbasePlayersBySystem(context, system, options) {
+    requireGameAddress(context);
+    return playerSnapshotsFromDiscovery(context, await discoverStarbasePlayersBySystem(context, system, options));
+}
+/** Reads one required StarbaseUpgradeProcess by its signer-created address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const upgrade = await getStarbaseUpgradeProcess(ctx, address);
+ * ```
+ */
+export async function getStarbaseUpgradeProcess(context, address, options) {
+    requireGameAddress(context);
+    return toUpgradeSnapshot(context, await context.data.read(starbaseUpgradeProcessAccountDefinition, address, options));
+}
+/** Reads one optional StarbaseUpgradeProcess by address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const address: Address;
+ * const upgrade = await maybeGetStarbaseUpgradeProcess(ctx, address);
+ * ```
+ */
+export async function maybeGetStarbaseUpgradeProcess(context, address, options) {
+    requireGameAddress(context);
+    const [envelope] = await context.data.readMany(starbaseUpgradeProcessAccountDefinition, [address], options);
+    return envelope === undefined
+        ? undefined
+        : toUpgradeSnapshot(context, envelope);
+}
+/** Discovers Starbase upgrade processes stored against one StarbasePlayer.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const player: Address;
+ * const upgrades = await getStarbaseUpgradeProcessesByPlayer(ctx, player);
+ * ```
+ */
+export async function getStarbaseUpgradeProcessesByPlayer(context, player, options) {
+    requireGameAddress(context);
+    const envelopes = await discoverStarbaseUpgradeProcessesByPlayer(context, player, options);
+    const metadata = readMeta(envelopes);
+    const snapshots = await Promise.all(envelopes.map((envelope) => toUpgradeSnapshot(context, envelope)));
+    return Object.freeze(attachReadMeta(snapshots, metadata));
+}
+//# sourceMappingURL=index.js.map