@aephia/atlas-kit 0.0.0

package/dist/internal/fleet.d.ts

@@ -0,0 +1,165 @@
+import type { SageContext } from '../client/contracts.js';
+import { entityRef } from '../client/refs.js';
+import type { CargoDefinitionSummary, ShipDefinitionSummary } from '../registry/index.js';
+import type { FleetAccountData, FleetStateData } from './c4/fleet.js';
+import type { WorldCoordinates } from './c4/world.js';
+/** Used/total Fleet capacity in the units of its on-chain capacity axis.
+ * @example
+ * ```ts
+ * declare const capacity: CapacitySummary;
+ * const remaining = capacity.remaining;
+ * ```
+ */
+export interface CapacitySummary {
+    readonly used: bigint;
+    readonly total: bigint;
+    readonly remaining: bigint;
+    readonly overCapacity: bigint;
+}
+/** Summarizes capacity without reporting negative remaining space. */
+export declare function capacitySummary(used: bigint, total: bigint): CapacitySummary;
+interface ResolvedCargoAmount extends CargoDefinitionSummary {
+    readonly amount: bigint;
+}
+interface ResolvedShipAmount extends ShipDefinitionSummary {
+    readonly quantity: bigint;
+}
+type ResolvedFleetState = Exclude<FleetStateData, {
+    readonly kind: 'idle' | 'docked' | 'mining' | 'claimStakeTransfer';
+}> | {
+    readonly kind: 'idle';
+    readonly coordinates: WorldCoordinates;
+} | (Omit<Extract<FleetStateData, {
+    readonly kind: 'docked';
+}>, 'system'> & {
+    readonly system: ReturnType<typeof entityRef<'starSystem'>>;
+}) | (Omit<Extract<FleetStateData, {
+    readonly kind: 'mining';
+}>, 'asteroid' | 'resourceIds'> & {
+    readonly asteroid: ReturnType<typeof entityRef<'celestialBody'>>;
+    readonly resources: readonly CargoDefinitionSummary[];
+}) | (Omit<Extract<FleetStateData, {
+    readonly kind: 'claimStakeTransfer';
+}>, 'planet' | 'claimStake' | 'load' | 'unload'> & {
+    readonly planet: ReturnType<typeof entityRef<'celestialBody'>>;
+    readonly claimStake: ReturnType<typeof entityRef<'claimStakeInstance'>>;
+    readonly load: readonly ResolvedCargoAmount[];
+    readonly unload: readonly ResolvedCargoAmount[];
+});
+/** Fleet data after joining account ids against the lazy definitions registry.
+ * @example
+ * ```ts
+ * declare const fleet: ResolvedFleetAccountData;
+ * const shipName = fleet.ships[0]?.name;
+ * ```
+ */
+export interface ResolvedFleetAccountData extends Omit<FleetAccountData, 'fleetShips' | 'fuelTank' | 'ammoBank' | 'cargoHold' | 'components' | 'respawningCargo' | 'state' | 'subProfile' | 'subProfileInvalidator'> {
+    readonly subProfile?: FleetAccountData['subProfile'];
+    readonly subProfileInvalidator?: FleetAccountData['subProfileInvalidator'];
+    readonly ships: readonly ResolvedShipAmount[];
+    readonly fuel: ResolvedCargoAmount;
+    readonly ammo: ResolvedCargoAmount;
+    readonly cargoHold: {
+        readonly seqId: number;
+        readonly storageCost: bigint;
+        readonly items: readonly ResolvedCargoAmount[];
+    };
+    readonly components: {
+        readonly seqId: number;
+        readonly storageCost: bigint;
+        readonly items: readonly ResolvedCargoAmount[];
+    };
+    readonly respawningCargo: {
+        readonly seqId: number;
+        readonly storageCost: bigint;
+        readonly items: readonly ResolvedCargoAmount[];
+    };
+    readonly capacities: {
+        readonly cargo: CapacitySummary;
+        readonly fuel: CapacitySummary;
+        readonly ammo: CapacitySummary;
+    };
+    readonly state: ResolvedFleetState;
+}
+/** Resolves every ship/cargo id and computes Fleet storage capacities. */
+export declare function resolveFleetAccount(context: SageContext, fleet: FleetAccountData): Promise<ResolvedFleetAccountData>;
+/** Date-valued timers derived from Fleet account sentinels and lifecycle state.
+ *
+ * Fleet snapshots retain their exact bigint unix-second fields; these values
+ * are an ergonomic projection for UI scheduling and display.
+ *
+ * @example
+ * ```ts
+ * declare const timers: FleetTimers;
+ * console.log(
+ *   timers.arrivesAt?.toISOString(),
+ *   timers.transferEndsAt?.toISOString(),
+ * );
+ * ```
+ */
+export interface FleetTimers {
+    readonly warpCooldownEndsAt?: Date;
+    readonly scanCooldownEndsAt?: Date;
+    readonly abilityPowerReloadsAt?: Date;
+    readonly shieldRegenerationResumesAt?: Date;
+    readonly arrivesAt?: Date;
+    readonly recoversAt?: Date;
+    readonly transferEndsAt?: Date;
+}
+type FleetTimerState = {
+    readonly kind: 'warp' | 'subwarp';
+    readonly arrivesAtUnixSeconds: bigint;
+} | {
+    readonly kind: 'respawn';
+    readonly recoversAtUnixSeconds: bigint;
+} | {
+    readonly kind: 'claimStakeTransfer';
+    readonly endAtUnixSeconds: bigint;
+} | {
+    readonly kind: Exclude<FleetStateData['kind'], 'warp' | 'subwarp' | 'respawn' | 'claimStakeTransfer'>;
+};
+/** Derives only active Fleet timers; non-positive sentinels and values outside
+ * JavaScript's supported Date range stay absent.
+ *
+ * @example
+ * ```ts
+ * declare const fleet: FleetSnapshot;
+ * const timers = deriveFleetTimers(fleet);
+ * console.log(
+ *   timers.warpCooldownEndsAt?.toISOString(),
+ *   timers.transferEndsAt?.toISOString(),
+ * );
+ * ```
+ */
+export declare function deriveFleetTimers<TState extends FleetTimerState>(fleet: Pick<FleetAccountData, 'warpCooldownExpiresAt' | 'scanCooldownExpiresAt' | 'apReloadExpiresAt' | 'shieldBreakDelayExpiresAt'> & {
+    readonly state: TState;
+}): FleetTimers;
+/** Display-only interpolation matching incremental on-chain subwarp settlement.
+ *
+ * @example
+ * ```ts
+ * declare const subwarp: SubwarpPosition;
+ * if (subwarp.displayOnly) console.log(subwarp.position, subwarp.progress);
+ * ```
+ */
+export interface SubwarpPosition {
+    readonly displayOnly: true;
+    readonly position: WorldCoordinates;
+    readonly progress: number;
+}
+/** Interpolates a display-only subwarp position, clamped to both endpoints.
+ *
+ * The result must not be used as authoritative on-chain position state.
+ *
+ * @example
+ * ```ts
+ * declare const state: Extract<FleetStateData, { readonly kind: 'subwarp' }>;
+ * const position = interpolateSubwarpPosition(state, 1_700_000_000n);
+ * console.log(position.position, position.progress);
+ * ```
+ */
+export declare function interpolateSubwarpPosition(state: Extract<FleetStateData, {
+    readonly kind: 'subwarp';
+}>, atUnixSeconds: bigint): SubwarpPosition;
+export {};
+//# sourceMappingURL=fleet.d.ts.map

package/dist/internal/fleet.d.ts.map

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

package/dist/internal/fleet.js

@@ -0,0 +1,179 @@
+import { entityRef } from '../client/refs.js';
+import { resolveCargo, resolveShip } from '../registry/index.js';
+import { isAbsentFleetAddress } from './c4/fleet.js';
+/** Summarizes capacity without reporting negative remaining space. */
+export function capacitySummary(used, total) {
+    return {
+        overCapacity: used > total ? used - total : 0n,
+        remaining: used < total ? total - used : 0n,
+        total,
+        used,
+    };
+}
+async function resolveCargoAmounts(context, amounts) {
+    return Promise.all(amounts.map(async ({ amount, cargoId }) => ({
+        ...(await resolveCargo(context, cargoId)),
+        amount,
+    })));
+}
+async function resolveState(context, state, location) {
+    switch (state.kind) {
+        case 'idle':
+            return { coordinates: location, kind: 'idle' };
+        case 'docked':
+            return {
+                ...state,
+                system: entityRef('starSystem', state.system),
+            };
+        case 'mining': {
+            const { asteroid, resourceIds, ...rest } = state;
+            return {
+                ...rest,
+                asteroid: entityRef('celestialBody', asteroid),
+                resources: await Promise.all(resourceIds.map((resourceId) => resolveCargo(context, resourceId))),
+            };
+        }
+        case 'claimStakeTransfer': {
+            const { claimStake, load, planet, unload, ...rest } = state;
+            return {
+                ...rest,
+                claimStake: entityRef('claimStakeInstance', claimStake),
+                load: await resolveCargoAmounts(context, load),
+                planet: entityRef('celestialBody', planet),
+                unload: await resolveCargoAmounts(context, unload),
+            };
+        }
+        case 'destroyed':
+        case 'warp':
+        case 'subwarp':
+        case 'respawn':
+            return state;
+        /* v8 ignore next -- assigning a new FleetStateData variant fails compilation here. */
+        default: {
+            const exhaustive = state;
+            throw new RangeError(`Unsupported resolved Fleet state variant ${String(exhaustive)}.`);
+        }
+    }
+}
+/** Resolves every ship/cargo id and computes Fleet storage capacities. */
+export async function resolveFleetAccount(context, fleet) {
+    const [ships, fuelDefinition, ammoDefinition, cargoItems, components, respawningCargo, state,] = await Promise.all([
+        Promise.all(fleet.fleetShips.map(async ({ quantity, shipId }) => ({
+            ...(await resolveShip(context, shipId, {
+                expectedSequenceId: fleet.shipDefinitionsSeqId,
+            })),
+            quantity,
+        }))),
+        resolveCargo(context, fleet.fuelTank.cargoId),
+        resolveCargo(context, fleet.ammoBank.cargoId),
+        resolveCargoAmounts(context, fleet.cargoHold.amounts),
+        resolveCargoAmounts(context, fleet.components.amounts),
+        resolveCargoAmounts(context, fleet.respawningCargo.amounts),
+        resolveState(context, fleet.state, fleet.location),
+    ]);
+    const { ammoBank: _ammoBank, fleetShips: _fleetShips, fuelTank: _fuelTank, subProfile, subProfileInvalidator, ...account } = fleet;
+    return {
+        ...account,
+        ammo: { ...ammoDefinition, amount: fleet.ammoBank.amount },
+        capacities: {
+            ammo: capacitySummary(fleet.ammoBank.amount, fleet.stats.cargo.ammoCapacity),
+            cargo: capacitySummary(fleet.cargoHold.storageCost, fleet.stats.cargo.cargoCapacity),
+            fuel: capacitySummary(fleet.fuelTank.amount, fleet.stats.cargo.fuelCapacity),
+        },
+        cargoHold: {
+            items: cargoItems,
+            seqId: fleet.cargoHold.seqId,
+            storageCost: fleet.cargoHold.storageCost,
+        },
+        components: {
+            items: components,
+            seqId: fleet.components.seqId,
+            storageCost: fleet.components.storageCost,
+        },
+        fuel: { ...fuelDefinition, amount: fleet.fuelTank.amount },
+        respawningCargo: {
+            items: respawningCargo,
+            seqId: fleet.respawningCargo.seqId,
+            storageCost: fleet.respawningCargo.storageCost,
+        },
+        ships,
+        state,
+        ...(isAbsentFleetAddress(subProfile) ? {} : { subProfile }),
+        ...(isAbsentFleetAddress(subProfileInvalidator)
+            ? {}
+            : { subProfileInvalidator }),
+    };
+}
+const MAXIMUM_DATE_UNIX_SECONDS = 8640000000000n;
+function dateFromUnixSeconds(value) {
+    return value > 0n && value <= MAXIMUM_DATE_UNIX_SECONDS
+        ? new Date(Number(value) * 1_000)
+        : undefined;
+}
+/** Derives only active Fleet timers; non-positive sentinels and values outside
+ * JavaScript's supported Date range stay absent.
+ *
+ * @example
+ * ```ts
+ * declare const fleet: FleetSnapshot;
+ * const timers = deriveFleetTimers(fleet);
+ * console.log(
+ *   timers.warpCooldownEndsAt?.toISOString(),
+ *   timers.transferEndsAt?.toISOString(),
+ * );
+ * ```
+ */
+export function deriveFleetTimers(fleet) {
+    const warpCooldownEndsAt = dateFromUnixSeconds(fleet.warpCooldownExpiresAt);
+    const scanCooldownEndsAt = dateFromUnixSeconds(fleet.scanCooldownExpiresAt);
+    const abilityPowerReloadsAt = dateFromUnixSeconds(fleet.apReloadExpiresAt);
+    const shieldRegenerationResumesAt = dateFromUnixSeconds(fleet.shieldBreakDelayExpiresAt);
+    const arrivesAt = fleet.state.kind === 'warp' || fleet.state.kind === 'subwarp'
+        ? dateFromUnixSeconds(fleet.state.arrivesAtUnixSeconds)
+        : undefined;
+    const recoversAt = fleet.state.kind === 'respawn'
+        ? dateFromUnixSeconds(fleet.state.recoversAtUnixSeconds)
+        : undefined;
+    const transferEndsAt = fleet.state.kind === 'claimStakeTransfer'
+        ? dateFromUnixSeconds(fleet.state.endAtUnixSeconds)
+        : undefined;
+    return {
+        ...(abilityPowerReloadsAt === undefined ? {} : { abilityPowerReloadsAt }),
+        ...(arrivesAt === undefined ? {} : { arrivesAt }),
+        ...(recoversAt === undefined ? {} : { recoversAt }),
+        ...(scanCooldownEndsAt === undefined ? {} : { scanCooldownEndsAt }),
+        ...(shieldRegenerationResumesAt === undefined
+            ? {}
+            : { shieldRegenerationResumesAt }),
+        ...(transferEndsAt === undefined ? {} : { transferEndsAt }),
+        ...(warpCooldownEndsAt === undefined ? {} : { warpCooldownEndsAt }),
+    };
+}
+/** Interpolates a display-only subwarp position, clamped to both endpoints.
+ *
+ * The result must not be used as authoritative on-chain position state.
+ *
+ * @example
+ * ```ts
+ * declare const state: Extract<FleetStateData, { readonly kind: 'subwarp' }>;
+ * const position = interpolateSubwarpPosition(state, 1_700_000_000n);
+ * console.log(position.position, position.progress);
+ * ```
+ */
+export function interpolateSubwarpPosition(state, atUnixSeconds) {
+    const duration = state.durationSeconds;
+    const progress = duration <= 0
+        ? atUnixSeconds < state.departsAtUnixSeconds
+            ? 0
+            : 1
+        : Math.min(1, Math.max(0, Number(atUnixSeconds - state.departsAtUnixSeconds) / duration));
+    return {
+        displayOnly: true,
+        position: {
+            x: state.from.x + (state.to.x - state.from.x) * progress,
+            y: state.from.y + (state.to.y - state.from.y) * progress,
+        },
+        progress,
+    };
+}
+//# sourceMappingURL=fleet.js.map

package/dist/internal/fleet.js.map

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

package/dist/internal/game-context.d.ts

@@ -0,0 +1,4 @@
+import type { Address, SageContext } from '../client/contracts.js';
+/** Returns the configured Game address before a Game-dependent operation starts I/O. */
+export declare function requireGameAddress(ctx: SageContext): Address;
+//# sourceMappingURL=game-context.d.ts.map

package/dist/internal/game-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-context.d.ts","sourceRoot":"","sources":["../../src/internal/game-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEnE,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAK5D"}

package/dist/internal/game-context.js

@@ -0,0 +1,9 @@
+import { MissingGameContextError } from '../client/errors.js';
+/** Returns the configured Game address before a Game-dependent operation starts I/O. */
+export function requireGameAddress(ctx) {
+    if (ctx.game === undefined) {
+        throw new MissingGameContextError();
+    }
+    return ctx.game;
+}
+//# sourceMappingURL=game-context.js.map

package/dist/internal/game-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-context.js","sourceRoot":"","sources":["../../src/internal/game-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,GAAgB;IACjD,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,uBAAuB,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC"}

package/dist/internal/immutable-tree.d.ts

@@ -0,0 +1,5 @@
+/** Validates that a value is an acyclic JSON-safe tree of plain data. */
+export declare function validateImmutableTree(value: unknown): void;
+/** Validates and recursively freezes an immutable plain-data tree. */
+export declare function deepFreeze<T>(value: T): Readonly<T>;
+//# sourceMappingURL=immutable-tree.d.ts.map

package/dist/internal/immutable-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"immutable-tree.d.ts","sourceRoot":"","sources":["../../src/internal/immutable-tree.ts"],"names":[],"mappings":"AA4DA,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE1D;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAUnD"}

package/dist/internal/immutable-tree.js

@@ -0,0 +1,47 @@
+function collectImmutableTree(value, ancestors, validated, valuesToFreeze) {
+    if (value === undefined ||
+        typeof value === 'function' ||
+        typeof value === 'symbol') {
+        throw new TypeError('Decoded snapshots must be JSON-safe and may contain only serializable primitives, arrays, and plain objects. Convert undefined, symbols, and functions to explicit immutable domain values before returning them.');
+    }
+    if (value === null || typeof value !== 'object')
+        return;
+    if (ancestors.has(value)) {
+        throw new TypeError('Decoded snapshots must be JSON-safe and cannot contain cyclic object references. Return an acyclic immutable value tree.');
+    }
+    if (validated.has(value))
+        return;
+    const prototype = Object.getPrototypeOf(value);
+    if (!Array.isArray(value) &&
+        prototype !== Object.prototype &&
+        prototype !== null) {
+        throw new TypeError('Decoded snapshots may contain only primitives, arrays, and plain objects. Convert mutable built-in values to immutable domain values before returning them.');
+    }
+    ancestors.add(value);
+    for (const key of Reflect.ownKeys(value)) {
+        if (typeof key === 'symbol') {
+            throw new TypeError('Decoded snapshots must be JSON-safe and cannot contain symbol-keyed properties. Convert them to string-keyed immutable domain values.');
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (!('value' in descriptor)) {
+            throw new TypeError('Decoded snapshots may contain only data properties. Convert accessor properties to plain immutable domain values before returning them.');
+        }
+        collectImmutableTree(descriptor.value, ancestors, validated, valuesToFreeze);
+    }
+    ancestors.delete(value);
+    validated.add(value);
+    valuesToFreeze.push(value);
+}
+/** Validates that a value is an acyclic JSON-safe tree of plain data. */
+export function validateImmutableTree(value) {
+    collectImmutableTree(value, new WeakSet(), new WeakSet(), []);
+}
+/** Validates and recursively freezes an immutable plain-data tree. */
+export function deepFreeze(value) {
+    const valuesToFreeze = [];
+    collectImmutableTree(value, new WeakSet(), new WeakSet(), valuesToFreeze);
+    for (const accepted of valuesToFreeze)
+        Object.freeze(accepted);
+    return value;
+}
+//# sourceMappingURL=immutable-tree.js.map

package/dist/internal/immutable-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"immutable-tree.js","sourceRoot":"","sources":["../../src/internal/immutable-tree.ts"],"names":[],"mappings":"AAAA,SAAS,oBAAoB,CAC3B,KAAc,EACd,SAA0B,EAC1B,SAA0B,EAC1B,cAAwB;IAExB,IACE,KAAK,KAAK,SAAS;QACnB,OAAO,KAAK,KAAK,UAAU;QAC3B,OAAO,KAAK,KAAK,QAAQ,EACzB,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,mNAAmN,CACpN,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO;IACxD,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,SAAS,CACjB,0HAA0H,CAC3H,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO;IAEjC,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAkB,CAAC;IAChE,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,SAAS,KAAK,MAAM,CAAC,SAAS;QAC9B,SAAS,KAAK,IAAI,EAClB,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,6JAA6J,CAC9J,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,CACjB,uIAAuI,CACxI,CAAC;QACJ,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAE,CAAC;QAChE,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,SAAS,CACjB,yIAAyI,CAC1I,CAAC;QACJ,CAAC;QACD,oBAAoB,CAClB,UAAU,CAAC,KAAK,EAChB,SAAS,EACT,SAAS,EACT,cAAc,CACf,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,oBAAoB,CAAC,KAAK,EAAE,IAAI,OAAO,EAAU,EAAE,IAAI,OAAO,EAAU,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,UAAU,CAAI,KAAQ;IACpC,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,oBAAoB,CAClB,KAAK,EACL,IAAI,OAAO,EAAU,EACrB,IAAI,OAAO,EAAU,EACrB,cAAc,CACf,CAAC;IACF,KAAK,MAAM,QAAQ,IAAI,cAAc;QAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/internal/json.d.ts

@@ -0,0 +1,7 @@
+interface JsonSerializable {
+    toJSON(): unknown;
+}
+export declare function toJsonSafeValue(value: unknown, ancestors?: WeakSet<object>): unknown;
+export declare function attachJsonSerialization<T extends object>(value: T): T & JsonSerializable;
+export {};
+//# sourceMappingURL=json.d.ts.map

package/dist/internal/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/internal/json.ts"],"names":[],"mappings":"AAAA,UAAU,gBAAgB;IACxB,MAAM,IAAI,OAAO,CAAC;CACnB;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,SAAS,kBAAwB,GAChC,OAAO,CA2BT;AAED,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,EACtD,KAAK,EAAE,CAAC,GACP,CAAC,GAAG,gBAAgB,CAQtB"}

package/dist/internal/json.js

@@ -0,0 +1,33 @@
+export function toJsonSafeValue(value, ancestors = new WeakSet()) {
+    if (typeof value === 'bigint') {
+        return value.toString();
+    }
+    if (value instanceof Uint8Array) {
+        return [...value];
+    }
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (ancestors.has(value)) {
+        throw new TypeError('JSON-safe values cannot contain cyclic object references.');
+    }
+    ancestors.add(value);
+    const serialized = Array.isArray(value)
+        ? value.map((item) => toJsonSafeValue(item, ancestors))
+        : Object.fromEntries(Object.entries(value).map(([key, item]) => [
+            key,
+            toJsonSafeValue(item, ancestors),
+        ]));
+    ancestors.delete(value);
+    return serialized;
+}
+export function attachJsonSerialization(value) {
+    Object.defineProperty(value, 'toJSON', {
+        configurable: false,
+        enumerable: false,
+        value: () => toJsonSafeValue(value),
+        writable: false,
+    });
+    return value;
+}
+//# sourceMappingURL=json.js.map

package/dist/internal/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/internal/json.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,eAAe,CAC7B,KAAc,EACd,YAAY,IAAI,OAAO,EAAU;IAEjC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,SAAS,CACjB,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACvD,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;YACzC,GAAG;YACH,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC;SACjC,CAAC,CACH,CAAC;IACN,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAAQ;IAER,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE;QACrC,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC;QACnC,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,OAAO,KAA6B,CAAC;AACvC,CAAC"}

package/dist/internal/planning/authorization-adapter.d.ts

@@ -0,0 +1,63 @@
+import { type AccountMeta, type Address, type Instruction, type InstructionWithAccounts, type InstructionWithData, type ReadonlyUint8Array } from '@solana/kit';
+import { sage } from '../c4/bindings.js';
+/** Address-only authorization retained by planning before execution binds signers.
+ *
+ * @example
+ * ```ts
+ * declare const profile: Address;
+ * declare const authority: Address;
+ * const authorization: PlanAuthorization = {
+ *   profile,
+ *   authority,
+ *   keyIndex: 0,
+ * };
+ * ```
+ */
+export interface PlanAuthorization {
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly keyIndex: number;
+    readonly certificate?: Address;
+}
+type GeneratedAuthorizationFields = 'keyIndex' | 'profileValidationCertificate' | 'profileValidationProfile' | 'profileValidationSigner';
+type AddressOnlyInput<T> = Omit<T, GeneratedAuthorizationFields> & {
+    readonly authorization: PlanAuthorization;
+};
+export type AddressOnlyDockedToIdleInput = AddressOnlyInput<sage.DockedToIdleInput>;
+export type AddressOnlyIdleToDockedInput = AddressOnlyInput<sage.IdleToDockedInput>;
+export type AddressOnlyStartSubwarpInput = AddressOnlyInput<sage.StartSubwarpInput>;
+export type AddressOnlyStopSubwarpInput = AddressOnlyInput<sage.StopSubwarpInput>;
+export type AddressOnlyWarpToCoordinateInput = AddressOnlyInput<sage.WarpToCoordinateInput>;
+export type AddressOnlyWarpLaneInput = AddressOnlyInput<sage.WarpLaneInput>;
+export type AddressOnlyTransferCargoToFleetInput = AddressOnlyInput<sage.TransferCargoToFleetInput>;
+export type AddressOnlyTransferCargoWithinFleetInput = AddressOnlyInput<sage.TransferCargoWithinFleetInput>;
+export type AddressOnlyRegisterStarbasePlayerInput = Omit<sage.RegisterStarbasePlayerInput, 'funder'> & {
+    readonly funder: Address;
+};
+export type AddressOnlyFleetSettleArrivalInput = Omit<sage.TheOneFleetStateHandlerInput, 'asteroid' | 'character' | 'funder' | 'system'> & {
+    readonly character: Address;
+    readonly funder: Address;
+};
+export interface AddressOnlyInstructionConfig {
+    readonly programAddress?: Address;
+}
+/** A Kit instruction whose signer roles carry addresses but no signer implementations. */
+export type AddressOnlyInstruction = Instruction & InstructionWithAccounts<readonly AccountMeta[]> & InstructionWithData<ReadonlyUint8Array>;
+/** Validates planning authorization before any instruction encoding or I/O. */
+export declare function validatePlanAuthorization(authorization: PlanAuthorization): void;
+export declare function adaptDockedToIdleInstruction(input: AddressOnlyDockedToIdleInput, config?: AddressOnlyInstructionConfig): AddressOnlyInstruction;
+export declare function adaptIdleToDockedInstruction(input: AddressOnlyIdleToDockedInput, config?: AddressOnlyInstructionConfig): AddressOnlyInstruction;
+/** Adapts the generated bidirectional Fleet/Starbase cargo instruction without retaining a signer. */
+export declare function adaptTransferCargoToFleetInstruction(input: AddressOnlyTransferCargoToFleetInput, config?: AddressOnlyInstructionConfig): AddressOnlyInstruction;
+/** Adapts the generated within-Fleet cargo instruction without retaining a signer. */
+export declare function adaptTransferCargoWithinFleetInstruction(input: AddressOnlyTransferCargoWithinFleetInput, config?: AddressOnlyInstructionConfig): AddressOnlyInstruction;
+/** Adapts StarbasePlayer registration with an address-only rent funder. */
+export declare function adaptRegisterStarbasePlayerInstruction(input: AddressOnlyRegisterStarbasePlayerInput, config?: AddressOnlyInstructionConfig): AddressOnlyInstruction;
+/** Adapts movement arrival settlement with an address-only rent funder. */
+export declare function adaptFleetSettleArrivalInstruction(input: AddressOnlyFleetSettleArrivalInput, config?: AddressOnlyInstructionConfig): AddressOnlyInstruction;
+export declare function adaptStartSubwarpInstruction(input: AddressOnlyStartSubwarpInput, config?: AddressOnlyInstructionConfig): AddressOnlyInstruction;
+export declare function adaptStopSubwarpInstruction(input: AddressOnlyStopSubwarpInput, config?: AddressOnlyInstructionConfig): AddressOnlyInstruction;
+export declare function adaptWarpToCoordinateInstruction(input: AddressOnlyWarpToCoordinateInput, config?: AddressOnlyInstructionConfig): AddressOnlyInstruction;
+export declare function adaptWarpLaneInstruction(input: AddressOnlyWarpLaneInput, config?: AddressOnlyInstructionConfig): AddressOnlyInstruction;
+export {};
+//# sourceMappingURL=authorization-adapter.d.ts.map

package/dist/internal/planning/authorization-adapter.d.ts.map

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