@aephia/atlas-kit 0.0.0

package/dist/cargo/actions/index.js

@@ -0,0 +1,526 @@
+import { getAddressEncoder } from '@solana/kit';
+import { InvalidActionInputError, SageSdkError } from '../../client/errors.js';
+import { ProviderAccountAddressMismatchError } from '../../client/provider-errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { sage } from '../../internal/c4/bindings.js';
+import { deriveFleetAddress, fleetAccountDefinition, } from '../../internal/c4/fleet.js';
+import { characterAccountDefinition, findCharacterPda, } from '../../internal/c4/identity.js';
+import { deriveStarbasePlayerAddress, starbasePlayerAccountDefinition, } from '../../internal/c4/starbase.js';
+import { requireGameAddress } from '../../internal/game-context.js';
+import { adaptTransferCargoToFleetInstruction, adaptTransferCargoWithinFleetInstruction, validatePlanAuthorization, } from '../../internal/planning/authorization-adapter.js';
+import { createPlan, } from '../../planning/index.js';
+import { resolveCargo } from '../../registry/index.js';
+const I64_MAX = (1n << 63n) - 1n;
+const U64_MAX = (1n << 64n) - 1n;
+const U16_MAX = 65_535;
+function invalid(field, value, acceptedRange, remedy) {
+    throw new InvalidActionInputError(field, value, acceptedRange, remedy);
+}
+function readRecord(value, field) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        return invalid(field, value, 'a plain object', `Provide ${field} as the documented object before retrying.`);
+    }
+    return value;
+}
+function assertKeys(value, field, required, optional = []) {
+    const accepted = new Set([...required, ...optional]);
+    const missing = required.find((key) => !Object.hasOwn(value, key));
+    const unexpected = Object.keys(value).find((key) => !accepted.has(key));
+    if (missing !== undefined || unexpected !== undefined) {
+        invalid(field, missing === undefined ? unexpected : `missing ${missing}`, `exactly the fields ${[...required, ...optional].join(', ')}`, `Remove unknown fields and provide every required ${field} field before retrying.`);
+    }
+}
+function readPositiveBigint(value, field, maximum, wireType) {
+    if (typeof value !== 'bigint' || value <= 0n || value > maximum) {
+        return invalid(field, value, `a positive raw bigint from 1 through ${String(maximum)} (${wireType})`, `Set ${field} to an explicit positive raw-unit bigint within the instruction codec range.`);
+    }
+    return value;
+}
+function readCargoHold(value) {
+    if (!Array.isArray(value) || value.length === 0) {
+        return invalid('amounts.cargoHold', value, 'a non-empty dense array of { cargoId, amount } entries', 'Provide at least one explicit cargo-hold transfer entry before retrying.');
+    }
+    const seen = new Set();
+    const normalized = [];
+    for (let index = 0; index < value.length; index += 1) {
+        const field = `amounts.cargoHold[${String(index)}]`;
+        if (!Object.hasOwn(value, index)) {
+            invalid(field, undefined, 'a present cargo transfer entry', 'Remove sparse entries from amounts.cargoHold before retrying.');
+        }
+        const entry = readRecord(value[index], field);
+        assertKeys(entry, field, ['cargoId', 'amount']);
+        const cargoId = entry.cargoId;
+        if (typeof cargoId !== 'number' ||
+            !Number.isInteger(cargoId) ||
+            cargoId < 0 ||
+            cargoId > U16_MAX) {
+            invalid(`${field}.cargoId`, cargoId, 'an integer cargo id from 0 through 65535 (unsigned u16)', `Set ${field}.cargoId to the cargo definition's exact numeric id before retrying.`);
+        }
+        if (seen.has(cargoId)) {
+            invalid(`${field}.cargoId`, cargoId, 'one unique cargo id per transfer entry', 'Combine duplicate cargo quantities into one entry before retrying.');
+        }
+        seen.add(cargoId);
+        normalized.push({
+            amount: readPositiveBigint(entry.amount, `${field}.amount`, U64_MAX, 'unsigned u64'),
+            cargoId,
+        });
+    }
+    return Object.freeze(normalized);
+}
+function validateOptions(value) {
+    const options = readRecord(value, 'options');
+    assertKeys(options, 'options', ['authorization', 'direction', 'amounts']);
+    if (options.direction !== 'toFleet' && options.direction !== 'toStarbase') {
+        invalid('direction', options.direction, 'either toFleet or toStarbase', 'Choose the transfer direction explicitly before retrying.');
+    }
+    const amounts = readRecord(options.amounts, 'amounts');
+    assertKeys(amounts, 'amounts', [], ['ammo', 'fuel', 'cargoHold']);
+    const normalized = {};
+    if (Object.hasOwn(amounts, 'ammo')) {
+        normalized.ammo = readPositiveBigint(amounts.ammo, 'amounts.ammo', I64_MAX, 'signed i64');
+    }
+    if (Object.hasOwn(amounts, 'fuel')) {
+        normalized.fuel = readPositiveBigint(amounts.fuel, 'amounts.fuel', I64_MAX, 'signed i64');
+    }
+    if (Object.hasOwn(amounts, 'cargoHold')) {
+        normalized.cargoHold = readCargoHold(amounts.cargoHold);
+    }
+    if (Object.keys(normalized).length === 0) {
+        invalid('amounts', amounts, 'at least one of ammo, fuel, or a non-empty cargoHold', 'Provide one or more explicit raw-unit transfer amounts before retrying.');
+    }
+    const authorizationRecord = readRecord(options.authorization, 'authorization');
+    assertKeys(authorizationRecord, 'authorization', ['profile', 'authority', 'keyIndex'], ['certificate']);
+    const authorization = authorizationRecord;
+    validatePlanAuthorization(authorization);
+    return {
+        amounts: Object.freeze(normalized),
+        authorization,
+        direction: options.direction,
+    };
+}
+function readFleetCargoPodName(value, field) {
+    if (value !== 'ammo' && value !== 'fuel' && value !== 'cargoHold') {
+        invalid(field, value, 'one of ammo, fuel, or cargoHold', `Choose ${field} from the Fleet's ammo, fuel, or cargoHold pod before retrying.`);
+    }
+    return value;
+}
+function readCargoId(value) {
+    if (typeof value !== 'number' ||
+        !Number.isInteger(value) ||
+        value < 0 ||
+        value > U16_MAX) {
+        invalid('cargoId', value, 'an integer cargo id from 0 through 65535 (unsigned u16)', "Set cargoId to the cargo definition's exact numeric id before retrying.");
+    }
+    return value;
+}
+function validateWithinFleetOptions(value) {
+    const options = readRecord(value, 'options');
+    assertKeys(options, 'options', [
+        'authorization',
+        'from',
+        'to',
+        'cargoId',
+        'amount',
+    ]);
+    const from = readFleetCargoPodName(options.from, 'from');
+    const to = readFleetCargoPodName(options.to, 'to');
+    if (from === to) {
+        invalid('to', to, 'a destination pod different from the source pod', 'Choose different source and destination Fleet pods before retrying.');
+    }
+    const authorizationRecord = readRecord(options.authorization, 'authorization');
+    assertKeys(authorizationRecord, 'authorization', ['profile', 'authority', 'keyIndex'], ['certificate']);
+    const authorization = authorizationRecord;
+    validatePlanAuthorization(authorization);
+    return {
+        amount: readPositiveBigint(options.amount, 'amount', U64_MAX, 'unsigned u64'),
+        authorization,
+        cargoId: readCargoId(options.cargoId),
+        from,
+        to,
+    };
+}
+function fail(message, address) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+function requireRawAccount(account, message, address) {
+    return account ?? fail(message, address);
+}
+function isProviderAddressMismatch(cause, requestedAddress) {
+    return (cause instanceof ProviderAccountAddressMismatchError &&
+        cause.requestedAddress === requestedAddress);
+}
+async function readCargoTransferAccounts(ctx, fleet, character, starbasePlayer) {
+    try {
+        return await readContextRawAccounts(ctx, [
+            fleet.address,
+            character,
+            starbasePlayer,
+        ]);
+    }
+    catch (cause) {
+        if (isProviderAddressMismatch(cause, character)) {
+            fail(`Fleet ${fleet.name} cannot transfer cargo because the account returned for canonical Character ${character} has a contradictory address. Fix the provider response, refresh or repair the Character registration, and retry.`, character);
+        }
+        if (isProviderAddressMismatch(cause, starbasePlayer)) {
+            fail(`Fleet ${fleet.name} cannot transfer cargo because the account returned for canonical Starbase Player ${starbasePlayer} has a contradictory address. Fix the provider response, refresh or repair the Starbase registration, and retry.`, starbasePlayer);
+        }
+        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 amountFor(amounts, cargoId) {
+    return amounts.find((item) => item.cargoId === cargoId)?.amount ?? 0n;
+}
+function requireBalance(source, label, available, requested, address) {
+    if (requested > available) {
+        fail(`${source} ${label} balance has ${String(available)} raw units available, but this Plan requests ${String(requested)}. Reduce the transfer amount, refresh the ${source}, and retry.`, address);
+    }
+}
+function requireCapacity(label, used, requested, total, address) {
+    if (used + requested > total) {
+        const remaining = used < total ? total - used : 0n;
+        fail(`Fleet ${label} capacity has ${String(remaining)} raw units of space remaining, but this Plan requires ${String(requested)}. Reduce the transfer amount or free Fleet capacity, refresh the Fleet, and retry.`, address);
+    }
+}
+function formatRawUnits(amount) {
+    return `${String(amount)} raw ${amount === 1n ? 'unit' : 'units'}`;
+}
+function describeTransferAmounts(amounts) {
+    const descriptions = [];
+    if (amounts.ammo !== undefined) {
+        descriptions.push(`ammo = ${formatRawUnits(amounts.ammo)}`);
+    }
+    if (amounts.fuel !== undefined) {
+        descriptions.push(`fuel = ${formatRawUnits(amounts.fuel)}`);
+    }
+    for (const item of amounts.cargoHold ?? []) {
+        descriptions.push(`cargo-hold id ${String(item.cargoId)} = ${formatRawUnits(item.amount)}`);
+    }
+    return descriptions.join('; ');
+}
+async function validateFleetAccount(account, fleet, game, profile, system) {
+    const data = fleetAccountDefinition.decode(account);
+    const canonicalAddress = await deriveFleetAddress(data);
+    if (account.address !== fleet.address ||
+        canonicalAddress !== fleet.address ||
+        data.game !== game ||
+        data.ownerProfile !== profile ||
+        data.state.kind !== 'docked' ||
+        data.state.system !== system) {
+        fail(`Fleet ${fleet.name} changed or no longer matches its configured Game, owner, canonical address, or docked Starbase System. Refresh the Fleet and create a new cargo transfer Plan before retrying.`, fleet.address);
+    }
+    return data;
+}
+function validateStarbasePlayer(account, fleet, profile, character, system) {
+    const data = starbasePlayerAccountDefinition.decode(account);
+    if (data.playerProfile !== profile ||
+        data.character !== character ||
+        data.system !== system) {
+        fail(`Fleet ${fleet.name} cannot transfer cargo because its Starbase Player does not match the owning Profile, canonical Character, docked System, or canonical PDA. Refresh or repair the Starbase registration before retrying.`, account.address);
+    }
+    return data;
+}
+/** Plans one bidirectional Fleet/player-Starbase cargo transfer without signing or RPC writes.
+ *
+ * The caller supplies only gameplay direction and positive raw-unit quantities.
+ * Planning directly re-reads the Fleet, canonical Character, and derived
+ * StarbasePlayer; checks known source balances (aggregated by cargo id for the
+ * shared Starbase inventory) and, when loading the Fleet, exact
+ * ammo/fuel/cargo capacity; and returns one inspectable instruction. The chain
+ * remains authoritative for state races, crew normalization, faction
+ * policy, Profile permission bits including `MANAGE_FLEET_CARGO`, and program
+ * arithmetic. Starbase destination capacity is not inferred because the
+ * shipped StarbasePlayer read exposes no total-capacity field.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const fleet: FleetSnapshot;
+ * declare const authorization: PlanAuthorization;
+ * const plan = await planFleetTransferCargoAtStarbase(ctx, fleet, {
+ *   authorization,
+ *   direction: 'toStarbase',
+ *   amounts: { fuel: 10n },
+ * });
+ * console.log(plan.describe());
+ * ```
+ */
+export async function planFleetTransferCargoAtStarbase(ctx, fleet, input) {
+    const options = validateOptions(input);
+    if (fleet.ownerProfile.address !== options.authorization.profile) {
+        fail(`Fleet ${fleet.name} belongs to Profile ${fleet.ownerProfile.address}, not authorized Profile ${options.authorization.profile}. Use the owning Profile in PlanAuthorization, refresh the Fleet, and retry.`, fleet.address);
+    }
+    if (fleet.state.kind !== 'docked') {
+        fail(`Fleet ${fleet.name} is ${fleet.state.kind}, but Starbase cargo transfer requires the Fleet to be docked. Dock the Fleet at its player Starbase, refresh it, and retry.`, fleet.address);
+    }
+    const game = requireGameAddress(ctx);
+    const system = fleet.state.system.address;
+    const character = await findCharacterPda(options.authorization.profile, game);
+    const starbasePlayer = await deriveStarbasePlayerAddress(system, character);
+    const [fleetCandidate, characterCandidate, playerCandidate] = await readCargoTransferAccounts(ctx, fleet, character, starbasePlayer);
+    const fleetAccount = requireRawAccount(fleetCandidate, `Fleet ${fleet.name} is no longer available. Refresh the Fleet and retry planning the cargo transfer.`, fleet.address);
+    const characterAccount = requireRawAccount(characterCandidate, `Fleet ${fleet.name} cannot transfer cargo because Profile ${options.authorization.profile} has no canonical Character ${character}. Create or repair the Character registration, refresh the Fleet, and retry.`, character);
+    const playerAccount = requireRawAccount(playerCandidate, `Fleet ${fleet.name} cannot transfer cargo because Character ${character} has no Starbase Player registration at docked System ${system}. Register the Character at this Starbase, refresh the Fleet, and retry.`, starbasePlayer);
+    const fleetData = await validateFleetAccount(fleetAccount, fleet, game, options.authorization.profile, system);
+    const characterData = characterAccountDefinition.decode(characterAccount);
+    if (characterData.playerProfile !== options.authorization.profile ||
+        characterData.game !== game) {
+        fail(`Fleet ${fleet.name} cannot transfer cargo because canonical Character ${character} does not match the owning Profile and configured Game. Refresh or repair the Character registration before retrying.`, characterAccount.address);
+    }
+    const playerData = validateStarbasePlayer(playerAccount, fleet, options.authorization.profile, character, system);
+    if (options.direction === 'toFleet') {
+        const requestedByCargoId = new Map();
+        const addRequested = (cargoId, amount) => {
+            requestedByCargoId.set(cargoId, (requestedByCargoId.get(cargoId) ?? 0n) + amount);
+        };
+        if (options.amounts.ammo !== undefined) {
+            addRequested(fleetData.ammoBank.cargoId, options.amounts.ammo);
+        }
+        if (options.amounts.fuel !== undefined) {
+            addRequested(fleetData.fuelTank.cargoId, options.amounts.fuel);
+        }
+        for (const item of options.amounts.cargoHold ?? []) {
+            addRequested(item.cargoId, item.amount);
+        }
+        for (const [cargoId, requested] of requestedByCargoId) {
+            requireBalance('Starbase', `cargo id ${String(cargoId)}`, amountFor(playerData.cargo.amounts, cargoId), requested, starbasePlayer);
+        }
+    }
+    if (options.amounts.ammo !== undefined) {
+        if (options.direction === 'toStarbase') {
+            requireBalance('Fleet', 'ammo', fleetData.ammoBank.amount, options.amounts.ammo, fleet.address);
+        }
+        else {
+            requireCapacity('ammo', fleetData.ammoBank.amount, options.amounts.ammo, fleetData.stats.cargo.ammoCapacity, fleet.address);
+        }
+    }
+    if (options.amounts.fuel !== undefined) {
+        if (options.direction === 'toStarbase') {
+            requireBalance('Fleet', 'fuel', fleetData.fuelTank.amount, options.amounts.fuel, fleet.address);
+        }
+        else {
+            requireCapacity('fuel', fleetData.fuelTank.amount, options.amounts.fuel, fleetData.stats.cargo.fuelCapacity, fleet.address);
+        }
+    }
+    if (options.direction === 'toStarbase') {
+        for (const item of options.amounts.cargoHold ?? []) {
+            requireBalance('Fleet', `cargo id ${String(item.cargoId)}`, amountFor(fleetData.cargoHold.amounts, item.cargoId), item.amount, fleet.address);
+        }
+    }
+    if (options.direction === 'toFleet' &&
+        options.amounts.cargoHold !== undefined) {
+        const definitions = await Promise.all(options.amounts.cargoHold.map((item) => resolveCargo(ctx, item.cargoId)));
+        const requestedStorage = options.amounts.cargoHold.reduce((total, item, index) => total + item.amount * BigInt(definitions[index].storageCost), 0n);
+        requireCapacity('cargo storage', fleetData.cargoHold.storageCost, requestedStorage, fleetData.stats.cargo.cargoCapacity, fleet.address);
+    }
+    const sign = options.direction === 'toFleet' ? 1n : -1n;
+    const cargoHold = options.amounts.cargoHold?.map(({ amount, cargoId }) => [cargoId, amount]);
+    const instruction = adaptTransferCargoToFleetInstruction({
+        ammoBank: options.amounts.ammo === undefined ? null : options.amounts.ammo * sign,
+        authorization: options.authorization,
+        cargoHold: cargoHold === undefined
+            ? null
+            : {
+                toLoad: options.direction === 'toFleet' ? [...cargoHold] : [],
+                toUnload: options.direction === 'toStarbase' ? [...cargoHold] : [],
+            },
+        character,
+        fleet: fleet.address,
+        fuelTank: options.amounts.fuel === undefined ? null : options.amounts.fuel * sign,
+        game,
+        systemAndStarbasePlayerStarbasePlayer: starbasePlayer,
+        systemAndStarbasePlayerSystem: system,
+    });
+    const description = options.direction === 'toFleet'
+        ? `Transfer cargo from the player Starbase to fleet ${fleet.name}. Amounts: ${describeTransferAmounts(options.amounts)}.`
+        : `Transfer cargo from fleet ${fleet.name} to the player Starbase. Amounts: ${describeTransferAmounts(options.amounts)}.`;
+    const fleetPreconditionDescription = options.direction === 'toFleet'
+        ? `Fleet ${fleet.name} remains owned by Profile ${options.authorization.profile}, docked at System ${system}, and has the checked destination cargo capacities.`
+        : `Fleet ${fleet.name} remains owned by Profile ${options.authorization.profile}, docked at System ${system}, and has the checked source cargo balances.`;
+    const playerPreconditionDescription = options.direction === 'toFleet'
+        ? `The Starbase Player remains registered for the canonical Character at Fleet ${fleet.name}'s docked System with the checked source cargo balances.`
+        : `The Starbase Player remains registered for the canonical Character at Fleet ${fleet.name}'s docked System.`;
+    return createPlan({
+        kind: 'cargo.fleet-starbase-transfer',
+        preconditions: await Promise.all([
+            precondition(fleetAccount, fleetPreconditionDescription),
+            precondition(characterAccount, `The canonical Character remains assigned to Profile ${options.authorization.profile} in the configured Game.`),
+            precondition(playerAccount, playerPreconditionDescription),
+        ]),
+        steps: [
+            {
+                describes: description,
+                instruction,
+                signers: [options.authorization.authority],
+            },
+        ],
+        summary: description,
+    });
+}
+function requireWithinFleetTransferState(fleet) {
+    switch (fleet.state.kind) {
+        case 'idle':
+        case 'docked':
+        case 'claimStakeTransfer':
+            return;
+        case 'warp':
+            fail(`Fleet ${fleet.name} is warp, but within-Fleet cargo transfer requires idle, docked, or claimStakeTransfer state. Finish the Fleet's warp, refresh it, and retry.`, fleet.address);
+        case 'subwarp':
+            fail(`Fleet ${fleet.name} is subwarp, but within-Fleet cargo transfer requires idle, docked, or claimStakeTransfer state. Finish or stop the Fleet's subwarp, refresh it, and retry.`, fleet.address);
+        case 'mining':
+            fail(`Fleet ${fleet.name} is mining, but within-Fleet cargo transfer requires idle, docked, or claimStakeTransfer state. Stop the Fleet's mining action, refresh it, and retry.`, fleet.address);
+        case 'respawn':
+            fail(`Fleet ${fleet.name} is respawn, but within-Fleet cargo transfer requires idle, docked, or claimStakeTransfer state. Finish the Fleet's respawn, refresh it, and retry.`, fleet.address);
+        case 'destroyed':
+            fail(`Fleet ${fleet.name} is destroyed, but within-Fleet cargo transfer requires idle, docked, or claimStakeTransfer state. Respawn the Fleet, refresh it, and retry.`, fleet.address);
+        /* v8 ignore next -- a new Fleet state fails compilation until its policy is explicit. */
+        default: {
+            const exhaustive = fleet.state;
+            throw new RangeError(`Unsupported within-Fleet cargo transfer state ${String(exhaustive)}.`);
+        }
+    }
+}
+function podCargoId(fleet, pod) {
+    switch (pod) {
+        case 'ammo':
+            return fleet.ammo.id;
+        case 'fuel':
+            return fleet.fuel.id;
+        case 'cargoHold':
+            return undefined;
+    }
+}
+function requireMatchingPodCargoId(fleet, pod, cargoId) {
+    const expected = podCargoId(fleet, pod);
+    if (expected !== undefined && cargoId !== expected) {
+        fail(`Requested cargo id ${String(cargoId)} does not match Fleet ${pod} pod resolved cargo id ${String(expected)}. Use the pod's resolved cargo id, refresh the Fleet, and retry.`, fleet.address);
+    }
+}
+function podBalance(fleet, pod, cargoId) {
+    switch (pod) {
+        case 'ammo':
+            return fleet.ammo.amount;
+        case 'fuel':
+            return fleet.fuel.amount;
+        case 'cargoHold':
+            return (fleet.cargoHold.items.find((item) => item.id === cargoId)?.amount ?? 0n);
+    }
+}
+function requiredDestinationUnits(fleet, options) {
+    switch (options.to) {
+        case 'ammo':
+            return {
+                label: 'ammo',
+                remaining: fleet.capacities.ammo.remaining,
+                required: options.amount,
+            };
+        case 'fuel':
+            return {
+                label: 'fuel',
+                remaining: fleet.capacities.fuel.remaining,
+                required: options.amount,
+            };
+        case 'cargoHold': {
+            const source = options.from === 'ammo' ? fleet.ammo : fleet.fuel;
+            return {
+                label: 'cargoHold storage',
+                remaining: fleet.capacities.cargo.remaining,
+                required: options.amount * BigInt(source.storageCost),
+            };
+        }
+    }
+}
+function generatedFleetCargoPod(pod) {
+    switch (pod) {
+        case 'ammo':
+            return sage.FleetCargoPod.AmmoBank;
+        case 'fuel':
+            return sage.FleetCargoPod.FuelTank;
+        case 'cargoHold':
+            return sage.FleetCargoPod.CargoHold;
+    }
+}
+/** Plans one exact cargo transfer between two nested pods in one Fleet.
+ *
+ * The caller supplies pod names, one unsigned-u16 cargo id, and one positive
+ * raw unsigned-u64 amount. Planning uses only the supplied Fleet snapshot for
+ * pod identities, resolved cargo ids, balances, and ammo/fuel/cargo-hold
+ * capacity. It accepts idle, docked, and Claim Stake transfer states and
+ * returns one signer-free, inspectable instruction. The chain remains
+ * authoritative for state races, Profile permission bits including
+ * `MANAGE_FLEET_CARGO`, and program arithmetic.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const fleet: FleetSnapshot;
+ * declare const authorization: PlanAuthorization;
+ * const plan = await planFleetTransferCargoWithinFleet(ctx, fleet, {
+ *   amount: 5n,
+ *   authorization,
+ *   cargoId: fleet.ammo.id,
+ *   from: 'ammo',
+ *   to: 'cargoHold',
+ * });
+ * console.log(plan.describe());
+ * ```
+ */
+export async function planFleetTransferCargoWithinFleet(ctx, fleet, input) {
+    const options = validateWithinFleetOptions(input);
+    if (fleet.ownerProfile.address !== options.authorization.profile) {
+        fail(`Fleet ${fleet.name} belongs to Profile ${fleet.ownerProfile.address}, not authorized Profile ${options.authorization.profile}. Use the owning Profile in PlanAuthorization, refresh the Fleet, and retry.`, fleet.address);
+    }
+    const game = requireGameAddress(ctx);
+    if (fleet.game !== game) {
+        fail(`Fleet ${fleet.name} belongs to Game ${fleet.game}, not configured Game ${game}. Use a Fleet snapshot loaded from the matching Game context, refresh the Fleet, and retry.`, fleet.address);
+    }
+    requireWithinFleetTransferState(fleet);
+    requireMatchingPodCargoId(fleet, options.from, options.cargoId);
+    requireMatchingPodCargoId(fleet, options.to, options.cargoId);
+    const available = podBalance(fleet, options.from, options.cargoId);
+    if (options.amount > available) {
+        fail(`Fleet ${options.from} source balance has ${String(available)} raw units available for cargo id ${String(options.cargoId)}, but this Plan requests ${String(options.amount)}. Reduce the transfer amount, refresh the Fleet, and retry.`, fleet.address);
+    }
+    const destination = requiredDestinationUnits(fleet, options);
+    if (destination.required > destination.remaining) {
+        fail(`Fleet ${destination.label} destination capacity has ${String(destination.remaining)} raw units of space remaining, but this Plan requires ${String(destination.required)}. Reduce the transfer amount or free Fleet capacity, refresh the Fleet, and retry.`, fleet.address);
+    }
+    const instruction = adaptTransferCargoWithinFleetInstruction({
+        amount: options.amount,
+        authorization: options.authorization,
+        cargoId: options.cargoId,
+        cargoPodFrom: generatedFleetCargoPod(options.from),
+        cargoPodTo: generatedFleetCargoPod(options.to),
+        fleet: fleet.address,
+        game,
+    });
+    const description = `Transfer ${formatRawUnits(options.amount)} of cargo id ${String(options.cargoId)} within fleet ${fleet.name} from ${options.from} to ${options.to}.`;
+    return createPlan({
+        kind: 'cargo.within-fleet-transfer',
+        preconditions: [],
+        steps: [
+            {
+                describes: description,
+                instruction,
+                signers: [options.authorization.authority],
+            },
+        ],
+        summary: description,
+    });
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/cargo/index.d.ts

@@ -0,0 +1,77 @@
+import { type Address, type DiscoveryRequest, type EntityRef, type ReadOptions, type SageContext } from '../client/index.js';
+import { type ResolvedFleetCargoInventory } from '../internal/cargo.js';
+import { type CargoDefinitionSummary, type DefinitionLookupOptions } from '../registry/index.js';
+export type { CargoCapacity, CargoInventoryItem, CargoPodInventory, } from '../internal/cargo.js';
+/** Stable cargo definition resolved lazily from the configured Game registry.
+ * @example
+ * ```ts
+ * declare const definition: CargoDefinition;
+ * console.log(definition.name, definition.storageCost);
+ * ```
+ */
+export type CargoDefinition = CargoDefinitionSummary;
+/** Sequence expectation used when resolving a cargo definition.
+ * @example
+ * ```ts
+ * const options: CargoDefinitionLookupOptions = { expectedSequenceId: 4 };
+ * ```
+ */
+export type CargoDefinitionLookupOptions = DefinitionLookupOptions;
+/** Options supported by targeted Fleet cargo inventory discovery.
+ * @example
+ * ```ts
+ * const options: CargoDiscoveryOptions = { commitment: 'confirmed' };
+ * ```
+ */
+export type CargoDiscoveryOptions = Omit<DiscoveryRequest, 'filters' | 'strategy'>;
+/** Immutable cargo inventory projected from the CargoPods nested in a Fleet.
+ * @example
+ * ```ts
+ * declare const inventory: FleetCargoInventorySnapshot;
+ * console.log(inventory.cargoHold.items);
+ * ```
+ */
+export interface FleetCargoInventorySnapshot extends Omit<ResolvedFleetCargoInventory, 'ownerProfile'> {
+    readonly kind: 'fleetCargoInventory';
+    /** Parent Fleet address; CargoPods are nested values and have no own address. */
+    readonly address: Address;
+    readonly fleet: EntityRef<'fleet'>;
+    readonly ownerProfile: EntityRef<'profile'>;
+    toJSON(): unknown;
+}
+/** Resolves one cargo definition without loading the Game registry eagerly.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * const fuel = await getCargoDefinition(ctx, 1);
+ * ```
+ */
+export declare function getCargoDefinition(context: SageContext, cargoId: number, options?: CargoDefinitionLookupOptions): Promise<CargoDefinition>;
+/** Reads the required CargoPods nested in a Fleet account.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const fleetAddress: Address;
+ * const inventory = await getFleetCargoInventory(ctx, fleetAddress);
+ * ```
+ */
+export declare function getFleetCargoInventory(context: SageContext, fleetAddress: Address, options?: ReadOptions): Promise<FleetCargoInventorySnapshot>;
+/** Reads optional CargoPods nested in a Fleet account.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const fleetAddress: Address;
+ * const inventory = await maybeGetFleetCargoInventory(ctx, fleetAddress);
+ * ```
+ */
+export declare function maybeGetFleetCargoInventory(context: SageContext, fleetAddress: Address, options?: ReadOptions): Promise<FleetCargoInventorySnapshot | undefined>;
+/** Discovers CargoPod inventories for Fleets owned by a Player Profile.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const profileAddress: Address;
+ * const inventories = await getFleetCargoInventoriesByOwner(ctx, profileAddress);
+ * ```
+ */
+export declare function getFleetCargoInventoriesByOwner(context: SageContext, profileAddress: Address, options?: CargoDiscoveryOptions): Promise<readonly FleetCargoInventorySnapshot[]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cargo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,SAAS,EAEd,KAAK,WAAW,EAChB,KAAK,WAAW,EAEjB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,uBAAuB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,gBAAgB,EAChB,SAAS,GAAG,UAAU,CACvB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,2BAA4B,SAAQ,IAAI,CACvD,2BAA2B,EAC3B,cAAc,CACf;IACC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,IAAI,OAAO,CAAC;CACnB;AAwED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,eAAe,CAAC,CAE1B;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,2BAA2B,CAAC,CAUtC;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAWlD;AAED;;;;;;;GAOG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,WAAW,EACpB,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC,CAWjD"}