@aephia/atlas-kit 0.6.0-next.16 → 0.6.0-next.160

package/dist/scanning/odds.js

@@ -0,0 +1,294 @@
+import { InvalidDerivationInputError } from '../client/errors.js';
+import { attachJsonSerialization } from '../internal/json.js';
+import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
+const categories = [
+    'any',
+    'industrial',
+    'technology',
+    'tactical',
+    'exotic',
+];
+const rarities = [
+    'common',
+    'uncommon',
+    'rare',
+    'epic',
+    'legendary',
+    'anomalous',
+];
+function finish(value) {
+    return freezeResolvedSnapshot(attachJsonSerialization(value));
+}
+function invalid(field, value) {
+    throw new InvalidDerivationInputError(field, typeof value === 'number' || typeof value === 'bigint' ? value : NaN, 'Supply valid current scanning snapshots and explicit research, exhaustion and clock inputs before estimating scan loot.');
+}
+function integer(field, value, maximum = 65535) {
+    if (!Number.isSafeInteger(value) || value < 0 || value > maximum)
+        invalid(field, value);
+}
+function exact(field, value, nonnegative = true) {
+    if (typeof value !== 'bigint' || (nonnegative && value < 0n))
+        invalid(field, value);
+}
+function tags(field, values) {
+    if (!Array.isArray(values))
+        invalid(field, values);
+    values.forEach((value) => integer(field, value));
+}
+function fingerprint(field, value) {
+    if (typeof value !== 'string' || !/^[0-9a-f]{64}$/.test(value))
+        invalid(field, value);
+}
+function configurations(policy, profile) {
+    const reasons = [];
+    if (!policy)
+        reasons.push('missing-policy');
+    if (!profile)
+        reasons.push('missing-loot-profile');
+    if (!policy || !profile)
+        return reasons;
+    if (policy.version !== 0 || profile.version !== 0)
+        reasons.push('unsupported-version');
+    if (!Number.isInteger(policy.patternId) ||
+        policy.patternId < 0 ||
+        policy.patternId > 4)
+        reasons.push('unsupported-pattern');
+    if (profile.loot.length > 64)
+        reasons.push('unsupported-loot-layout');
+    if (policy.game.address !== profile.game.address)
+        reasons.push('game-mismatch');
+    fingerprint('policy.contentFingerprint', policy.contentFingerprint);
+    fingerprint('lootProfile.contentFingerprint', profile.contentFingerprint);
+    integer('policy.revision', policy.revision, 0xffffffff);
+    integer('lootProfile.revision', profile.revision, 0xffffffff);
+    integer('lootProfile.regionId', profile.regionId);
+    for (const row of profile.loot) {
+        integer('loot.rollWeight', row.rollWeight, 0xffffffff);
+        integer('loot.cargo.id', row.cargo.id);
+    }
+    return reasons;
+}
+function provenance(policy, profile, signal) {
+    return {
+        policy: policy && {
+            address: policy.address,
+            game: { ...policy.game },
+            patternId: policy.patternId,
+            revision: policy.revision,
+            contentFingerprint: policy.contentFingerprint,
+        },
+        lootProfile: profile && {
+            address: profile.address,
+            game: { ...profile.game },
+            regionId: profile.regionId,
+            revision: profile.revision,
+            contentFingerprint: profile.contentFingerprint,
+        },
+        signal: signal && { address: signal.address, sequence: signal.sequence },
+    };
+}
+function result(basis, sources, reasons, profile, selected, excludedRows, chance) {
+    const base = {
+        kind: 'client-derived-estimate',
+        basis,
+        provenance: sources,
+    };
+    if (reasons.length)
+        return finish({ ...base, status: 'unavailable', reasons });
+    const totalWeight = selected.reduce((sum, index) => sum + BigInt(profile.loot[index].rollWeight), 0n);
+    if (totalWeight === 0n)
+        return finish({
+            ...base,
+            status: 'unavailable',
+            reasons: ['empty-weighted-pool'],
+        });
+    const shares = (cargo, weight) => ({
+        cargo: { ...cargo },
+        weight,
+        conditionalProbability: Number(weight) / Number(totalWeight),
+        perScanProbability: Number(weight * BigInt(chance)) / Number(totalWeight * 10000n),
+    });
+    const resourceWeights = new Map();
+    const eligibleRows = selected.map((rowIndex) => {
+        const row = profile.loot[rowIndex];
+        const weight = BigInt(row.rollWeight);
+        const previous = resourceWeights.get(row.cargo.id);
+        resourceWeights.set(row.cargo.id, {
+            cargo: row.cargo,
+            weight: (previous?.weight ?? 0n) + weight,
+        });
+        return { rowIndex, ...shares(row.cargo, weight) };
+    });
+    return finish({
+        ...base,
+        status: 'available',
+        totalWeight,
+        contactChanceBasisPoints: chance,
+        contactProbability: chance / 10000,
+        noContactProbability: (10000 - chance) / 10000,
+        eligibleRows,
+        excludedRows,
+        resources: [...resourceWeights.values()].map(({ cargo, weight }) => shares(cargo, weight)),
+    });
+}
+/** Estimates prospective contact and cargo-selection odds using the fingerprinted client's eligibility rules.
+ * Requires explicit research and exhaustion knowledge. This is not full scan-launch readiness:
+ * permissions, costs, Fleet state, cooldown, target and recovery capacity are outside this calculation.
+ * @example
+ * ```ts
+ * declare const policy: ScanPatternPolicySnapshot, loot: ScanLootProfileSnapshot;
+ * const odds = deriveScanLootOdds(policy, loot, { unlockedResearchTagIds: [], requiredRegionResearchTagIds: [], exhaustionBasisPoints: 0 });
+ * ```
+ */
+export function deriveScanLootOdds(policy, profile, options) {
+    integer('exhaustionBasisPoints', options.exhaustionBasisPoints, 10000);
+    tags('unlockedResearchTagIds', options.unlockedResearchTagIds);
+    tags('requiredRegionResearchTagIds', options.requiredRegionResearchTagIds);
+    const focus = options.focus ?? 'any';
+    if (!categories.includes(focus))
+        invalid('focus', focus);
+    const reasons = configurations(policy, profile);
+    const sources = provenance(policy, profile);
+    if (reasons.length)
+        return result('prospective', sources, reasons, profile, [], [], 0);
+    const p = policy, l = profile;
+    integer('policy.contactChanceBasisPoints', p.contactChanceBasisPoints, 10000);
+    exact('policy.valueBudgetRaw', p.valueBudgetRaw);
+    integer('lootProfile.riskValueMultiplierBasisPoints', l.riskValueMultiplierBasisPoints, 65535);
+    tags('policy.requiredResearchTagIds', p.requiredResearchTagIds);
+    if (!rarities.includes(p.maximumRarity))
+        invalid('policy.maximumRarity', p.maximumRarity);
+    if (!Array.isArray(p.allowedFocusCategories) ||
+        p.allowedFocusCategories.some((category) => !categories.includes(category)))
+        invalid('policy.allowedFocusCategories', p.allowedFocusCategories);
+    if (p.status !== 'active')
+        reasons.push('inactive-policy');
+    if (l.status !== 'active')
+        reasons.push('inactive-loot-profile');
+    const unlocked = new Set(options.unlockedResearchTagIds);
+    if (!p.requiredResearchTagIds.every((tag) => unlocked.has(tag)))
+        reasons.push('pattern-research-locked');
+    if (!options.requiredRegionResearchTagIds.every((tag) => unlocked.has(tag)))
+        reasons.push('region-research-locked');
+    if (focus !== 'any' && !p.allowedFocusCategories.includes(focus))
+        reasons.push('focus-not-allowed');
+    const budget = (p.valueBudgetRaw * BigInt(l.riskValueMultiplierBasisPoints)) / 10000n;
+    const selected = [], excluded = [];
+    l.loot.forEach((row, rowIndex) => {
+        integer('loot.valueUnits', row.valueUnits);
+        tags('loot.supportedPatternIds', row.supportedPatternIds);
+        tags('loot.requiredResearchTagIds', row.requiredResearchTagIds);
+        if (!rarities.includes(row.rarity))
+            invalid('loot.rarity', row.rarity);
+        if (!categories.includes(row.category))
+            invalid('loot.category', row.category);
+        const exclusions = [];
+        if (!row.supportedPatternIds.includes(p.patternId))
+            exclusions.push('pattern');
+        if (rarities.indexOf(row.rarity) > rarities.indexOf(p.maximumRarity))
+            exclusions.push('rarity');
+        if (BigInt(row.valueUnits) > budget)
+            exclusions.push('value-budget');
+        if (focus !== 'any' && row.category !== 'any' && row.category !== focus)
+            exclusions.push('focus');
+        if (!row.requiredResearchTagIds.every((tag) => unlocked.has(tag)))
+            exclusions.push('research');
+        if (exclusions.length)
+            excluded.push({ rowIndex, reasons: exclusions });
+        else
+            selected.push(rowIndex);
+    });
+    const chance = Math.floor((p.contactChanceBasisPoints * (10000 - options.exhaustionBasisPoints)) /
+        10000);
+    return result('prospective', sources, reasons, l, selected, excluded, chance);
+}
+/** Estimates a pending signal's recorded draw using its committed rows and contact chance.
+ * Revisions AND full fingerprints must match. Current activity, focus and research do not
+ * replace committed eligibility; terminal signals are not random forecasts.
+ * @example
+ * ```ts
+ * declare const signal: ScanSignalSnapshot, policy: ScanPatternPolicySnapshot, loot: ScanLootProfileSnapshot;
+ * const odds = deriveCommittedScanLootOdds(signal, policy, loot);
+ * ```
+ */
+export function deriveCommittedScanLootOdds(signal, policy, profile) {
+    const reasons = configurations(policy, profile), sources = provenance(policy, profile, signal);
+    if (signal?.status !== 'pending-entropy')
+        reasons.push('signal-not-pending');
+    if (signal !== undefined &&
+        signal.version !== 0 &&
+        !reasons.includes('unsupported-version'))
+        reasons.push('unsupported-version');
+    if (reasons.length)
+        return result('committed', sources, reasons, profile, [], [], 0);
+    const attempt = signal.attempt;
+    if (!attempt)
+        invalid('signal.attempt', attempt);
+    fingerprint('attempt.policyContentFingerprint', attempt.policyContentFingerprint);
+    fingerprint('attempt.lootProfileContentFingerprint', attempt.lootProfileContentFingerprint);
+    if (signal.game.address !== policy.game.address ||
+        attempt.patternId !== policy.patternId ||
+        attempt.regionId !== profile.regionId ||
+        attempt.policyRevision !== policy.revision ||
+        attempt.lootProfileRevision !== profile.revision ||
+        attempt.policyContentFingerprint !== policy.contentFingerprint ||
+        attempt.lootProfileContentFingerprint !== profile.contentFingerprint)
+        return result('committed', sources, ['committed-configuration-mismatch'], profile, [], [], 0);
+    integer('attempt.contactChanceBasisPoints', attempt.contactChanceBasisPoints, 10000);
+    if (!Array.isArray(attempt.eligibleLootRowIndexes))
+        invalid('attempt.eligibleLootRowIndexes', attempt.eligibleLootRowIndexes);
+    const selected = new Set();
+    for (const index of attempt.eligibleLootRowIndexes) {
+        integer('attempt.eligibleLootRowIndexes', index, profile.loot.length - 1);
+        if (selected.has(index))
+            invalid('attempt.eligibleLootRowIndexes', index);
+        selected.add(index);
+    }
+    const excluded = profile.loot.flatMap((_, rowIndex) => selected.has(rowIndex)
+        ? []
+        : [{ rowIndex, reasons: ['not-committed'] }]);
+    return result('committed', sources, reasons, profile, [...selected], excluded, attempt.contactChanceBasisPoints);
+}
+/** Applies the client exhaustion decay rule with explicit region and Unix seconds, without clock reads.
+ * An absent signal means known absence of recovery history, not an unknown/unread signal.
+ * Another region, disabled decay or a clock before the last recovery produce zero exhaustion.
+ * @example
+ * ```ts
+ * declare const policy: ScanPatternPolicySnapshot, signal: ScanSignalSnapshot | undefined;
+ * const exhaustion = deriveScanExhaustion(policy, signal, { regionId: 3, unixSeconds: 1_790_000_000n });
+ * ```
+ */
+export function deriveScanExhaustion(policy, signal, options) {
+    integer('regionId', options.regionId);
+    exact('unixSeconds', options.unixSeconds, false);
+    integer('policy.exhaustionPerRecoveryBasisPoints', policy.exhaustionPerRecoveryBasisPoints, 10000);
+    integer('policy.maximumExhaustionBasisPoints', policy.maximumExhaustionBasisPoints, 10000);
+    integer('policy.exhaustionDecaySeconds', policy.exhaustionDecaySeconds, 0xffffffff);
+    if (policy.version !== 0 ||
+        (signal !== undefined &&
+            (signal.version !== 0 || signal.game.address !== policy.game.address)))
+        invalid('scanning.versionOrGame', policy.version);
+    let effectiveRecoveries = 0;
+    if (signal !== undefined) {
+        const history = signal.recoveryHistory;
+        if (!history)
+            invalid('signal.recoveryHistory', history);
+        integer('recoveryHistory.lastRegionId', history.lastRegionId);
+        integer('recoveryHistory.consecutiveRecoveries', history.consecutiveRecoveries, 65535);
+        exact('recoveryHistory.lastRecoveryAtUnixSeconds', history.lastRecoveryAtUnixSeconds, false);
+        if (history.lastRegionId === options.regionId &&
+            policy.exhaustionDecaySeconds > 0 &&
+            options.unixSeconds >= history.lastRecoveryAtUnixSeconds) {
+            const decay = (options.unixSeconds - history.lastRecoveryAtUnixSeconds) /
+                BigInt(policy.exhaustionDecaySeconds);
+            const remaining = BigInt(history.consecutiveRecoveries) - decay;
+            effectiveRecoveries = remaining > 0n ? Number(remaining) : 0;
+        }
+    }
+    return finish({
+        kind: 'client-derived-estimate',
+        effectiveRecoveries,
+        exhaustionBasisPoints: Math.min(effectiveRecoveries * policy.exhaustionPerRecoveryBasisPoints, policy.maximumExhaustionBasisPoints),
+    });
+}
+//# sourceMappingURL=odds.js.map

package/dist/scanning/odds.js.map

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

package/dist/scanning/signals.d.ts

@@ -0,0 +1,126 @@
+import { type Address, type EntityRef, type ReadOptions, type SageContext } from '../client/index.js';
+import { type ScanSignalData, type ScanPatternPolicyData, type ScanLootProfileData, type ScanPointData } from '../internal/c4/scan-lifecycle.js';
+import { type CargoDefinitionSummary } from '../registry/index.js';
+type Immutable<T> = T extends (...args: never[]) => unknown ? T : T extends object ? {
+    readonly [K in keyof T]: Immutable<T[K]>;
+} : T;
+type Base<T> = Omit<T, 'game' | 'bump'> & {
+    readonly address: Address;
+    readonly game: EntityRef<'game'>;
+    toJSON(): unknown;
+};
+type CargoRow<T> = Omit<T, 'cargoId'> & {
+    readonly cargo: CargoDefinitionSummary;
+};
+/** Coordinates in map units, with exact signed I8F56 storage retained per axis.
+ * @example
+ * ```ts
+ * declare const point: ScanCoordinates;
+ * console.log(point.x.value, point.x.raw);
+ * ```
+ */
+export type ScanCoordinates = Immutable<ScanPointData>;
+/** Observed signal lifecycle state; it does not predict transition eligibility.
+ * @example
+ * ```ts
+ * const status: ScanSignalStatus = 'pending-entropy';
+ * ```
+ */
+export type ScanSignalStatus = ScanSignalData['status'];
+/** Fleet signal snapshot. Empty signals have no attempt, contact or receipt.
+ * Contact/recovered cargo is resolved only for that state; no-contact has its own XP receipt.
+ * @example
+ * ```ts
+ * declare const signal: ScanSignalSnapshot;
+ * console.log(signal.status, signal.contact?.cargo.name);
+ * ```
+ */
+export type ScanSignalSnapshot = Immutable<Base<Omit<ScanSignalData, 'fleet' | 'ownerProfile' | 'ownerCharacter' | 'controllerProfile' | 'controllerCharacter' | 'contact' | 'receipt' | 'attempt' | 'noContact' | 'ended'>> & {
+    attempt: NonNullable<ScanSignalData['attempt']> | undefined;
+    ended: NonNullable<ScanSignalData['ended']> | undefined;
+    noContact: NonNullable<ScanSignalData['noContact']> | undefined;
+    kind: 'scanSignal';
+    fleet: EntityRef<'fleet'>;
+    ownerProfile: EntityRef<'profile'>;
+    ownerCharacter: EntityRef<'character'>;
+    /** The Profile controlling the Fleet when the signal was recorded: its
+     * owner, or the renter of a rented Fleet. */
+    controllerProfile: EntityRef<'profile'>;
+    /** The controlling Profile's Character, which earns the scan XP. */
+    controllerCharacter: EntityRef<'character'>;
+    contact: CargoRow<NonNullable<ScanSignalData['contact']>> | undefined;
+    receipt: CargoRow<NonNullable<ScanSignalData['receipt']>> | undefined;
+}>;
+/** Current scan policy parameters. Basis points use 10,000 = 100%; XP stays exact raw units.
+ * Value budgets and permitted focus categories support client-derived estimates.
+ * @example
+ * ```ts
+ * declare const policy: ScanPatternPolicySnapshot;
+ * console.log(policy.strategy, policy.signalLifetimeSeconds);
+ * ```
+ */
+export type ScanPatternPolicySnapshot = Immutable<Base<ScanPatternPolicyData> & {
+    kind: 'scanPatternPolicy';
+}>;
+/** Regional loot configuration, not a reward forecast. Weights are relative integers.
+ * Pattern eligibility is translated to IDs; opaque quantity modes remain unprojected.
+ * @example
+ * ```ts
+ * declare const profile: ScanLootProfileSnapshot;
+ * console.log(profile.regionId, profile.loot[0]?.cargo.name);
+ * ```
+ */
+export type ScanLootProfileSnapshot = Immutable<Base<Omit<ScanLootProfileData, 'loot'>> & {
+    kind: 'scanLootProfile';
+    loot: readonly CargoRow<ScanLootProfileData['loot'][number]>[];
+}>;
+/** Derives and reads a required ScanSignal for the configured Game. Absence throws AccountNotFoundError.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address;
+ * const snapshot = await getScanSignalForFleet(ctx, fleet, { refresh: true });
+ * ```
+ */
+export declare function getScanSignalForFleet(context: SageContext, fleet: Address, options?: ReadOptions): Promise<ScanSignalSnapshot>;
+/** Derives and reads an optional ScanSignal for the configured Game. Absence returns undefined; malformed accounts still throw.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address;
+ * const snapshot = await maybeGetScanSignalForFleet(ctx, fleet, { refresh: true });
+ * ```
+ */
+export declare function maybeGetScanSignalForFleet(context: SageContext, fleet: Address, options?: ReadOptions): Promise<ScanSignalSnapshot | undefined>;
+/** Derives and reads a required ScanPatternPolicy for the configured Game. Absence throws AccountNotFoundError.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, patternId: number;
+ * const snapshot = await getScanPatternPolicy(ctx, patternId, { refresh: true });
+ * ```
+ */
+export declare function getScanPatternPolicy(context: SageContext, patternId: number, options?: ReadOptions): Promise<ScanPatternPolicySnapshot>;
+/** Derives and reads an optional ScanPatternPolicy for the configured Game. Absence returns undefined; malformed accounts still throw.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, patternId: number;
+ * const snapshot = await maybeGetScanPatternPolicy(ctx, patternId, { refresh: true });
+ * ```
+ */
+export declare function maybeGetScanPatternPolicy(context: SageContext, patternId: number, options?: ReadOptions): Promise<ScanPatternPolicySnapshot | undefined>;
+/** Derives and reads a required ScanLootProfile for the configured Game. Absence throws AccountNotFoundError.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, regionId: number;
+ * const snapshot = await getScanLootProfile(ctx, regionId, { refresh: true });
+ * ```
+ */
+export declare function getScanLootProfile(context: SageContext, regionId: number, options?: ReadOptions): Promise<ScanLootProfileSnapshot>;
+/** Derives and reads an optional ScanLootProfile for the configured Game. Absence returns undefined; malformed accounts still throw.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, regionId: number;
+ * const snapshot = await maybeGetScanLootProfile(ctx, regionId, { refresh: true });
+ * ```
+ */
+export declare function maybeGetScanLootProfile(context: SageContext, regionId: number, options?: ReadOptions): Promise<ScanLootProfileSnapshot | undefined>;
+export {};
+//# sourceMappingURL=signals.d.ts.map

package/dist/scanning/signals.d.ts.map

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

package/dist/scanning/signals.js

@@ -0,0 +1,173 @@
+import { entityRef, AccountDecodeError, } from '../client/index.js';
+import { scanSignalAccountDefinition, scanPatternPolicyAccountDefinition, scanLootProfileAccountDefinition, deriveScanLifecycleAddress, } from '../internal/c4/scan-lifecycle.js';
+import { waitForRegistry } from '../client/lifecycle.js';
+import { requireGameAddress } from '../internal/game-context.js';
+import { attachJsonSerialization } from '../internal/json.js';
+import { attachReadMeta } from '../internal/read-meta.js';
+import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
+import { resolveCargo, } from '../registry/index.js';
+function finish(envelope, value) {
+    return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization(value), {
+        commitment: envelope.commitment,
+        slot: envelope.slot,
+        source: envelope.source,
+        strategy: 'derived',
+    }));
+}
+async function read(context, definition, key, optional, options) {
+    const game = requireGameAddress(context);
+    const [address, bump] = await deriveScanLifecycleAddress(definition.type, game, key);
+    const envelope = optional
+        ? (await context.data.readMany(definition, [address], options))[0]
+        : await context.data.read(definition, address, options);
+    if (envelope === undefined)
+        return undefined;
+    const data = envelope.data;
+    const storedKey = 'fleet' in data
+        ? data.fleet
+        : 'patternId' in data
+            ? data.patternId
+            : data.regionId;
+    if (data.game !== game || data.bump !== bump || storedKey !== key)
+        throw new AccountDecodeError(definition.type, address, new RangeError('Stored Game, seed or bump contradicts the canonical PDA.'), `${definition.type} ${address} does not match the configured Game and requested identity. Verify the Fleet or ID and cluster, then refresh before retrying.`);
+    return envelope;
+}
+const signals = new WeakMap();
+const policies = new WeakMap();
+const lootProfiles = new WeakMap();
+async function cargo(context, row) {
+    const { cargoId, ...rest } = row;
+    return { ...rest, cargo: await resolveCargo(context, cargoId) };
+}
+function signalSnapshot(context, envelope) {
+    const existing = signals.get(envelope);
+    if (existing)
+        return existing;
+    const pending = (async () => {
+        const { game, bump: _bump, fleet, ownerProfile, ownerCharacter, controllerProfile, controllerCharacter, contact, receipt, attempt, noContact, ended, ...data } = envelope.data;
+        return finish(envelope, {
+            ...data,
+            attempt: attempt ?? undefined,
+            noContact: noContact ?? undefined,
+            ended: ended ?? undefined,
+            kind: 'scanSignal',
+            address: envelope.address,
+            game: entityRef('game', game),
+            fleet: entityRef('fleet', fleet),
+            ownerProfile: entityRef('profile', ownerProfile),
+            ownerCharacter: entityRef('character', ownerCharacter),
+            controllerProfile: entityRef('profile', controllerProfile),
+            controllerCharacter: entityRef('character', controllerCharacter),
+            contact: contact ? await cargo(context, contact) : undefined,
+            receipt: receipt ? await cargo(context, receipt) : undefined,
+        });
+    })();
+    signals.set(envelope, pending);
+    void pending.catch(() => signals.delete(envelope));
+    return pending;
+}
+function policySnapshot(envelope) {
+    const existing = policies.get(envelope);
+    if (existing)
+        return existing;
+    const { game, bump: _bump, ...data } = envelope.data;
+    const snapshot = finish(envelope, {
+        ...data,
+        kind: 'scanPatternPolicy',
+        address: envelope.address,
+        game: entityRef('game', game),
+    });
+    policies.set(envelope, snapshot);
+    return snapshot;
+}
+function lootSnapshot(context, envelope) {
+    const existing = lootProfiles.get(envelope);
+    if (existing)
+        return existing;
+    const pending = (async () => {
+        const { game, bump: _bump, loot, ...data } = envelope.data;
+        return finish(envelope, {
+            ...data,
+            kind: 'scanLootProfile',
+            address: envelope.address,
+            game: entityRef('game', game),
+            loot: await Promise.all(loot.map((row) => cargo(context, row))),
+        });
+    })();
+    lootProfiles.set(envelope, pending);
+    void pending.catch(() => lootProfiles.delete(envelope));
+    return pending;
+}
+/** Derives and reads a required ScanSignal for the configured Game. Absence throws AccountNotFoundError.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address;
+ * const snapshot = await getScanSignalForFleet(ctx, fleet, { refresh: true });
+ * ```
+ */
+export async function getScanSignalForFleet(context, fleet, options) {
+    const envelope = await read(context, scanSignalAccountDefinition, fleet, false, options);
+    return waitForRegistry(context, signalSnapshot(context, envelope), options?.signal);
+}
+/** Derives and reads an optional ScanSignal for the configured Game. Absence returns undefined; malformed accounts still throw.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address;
+ * const snapshot = await maybeGetScanSignalForFleet(ctx, fleet, { refresh: true });
+ * ```
+ */
+export async function maybeGetScanSignalForFleet(context, fleet, options) {
+    const envelope = await read(context, scanSignalAccountDefinition, fleet, true, options);
+    if (envelope === undefined)
+        return undefined;
+    return waitForRegistry(context, signalSnapshot(context, envelope), options?.signal);
+}
+/** Derives and reads a required ScanPatternPolicy for the configured Game. Absence throws AccountNotFoundError.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, patternId: number;
+ * const snapshot = await getScanPatternPolicy(ctx, patternId, { refresh: true });
+ * ```
+ */
+export async function getScanPatternPolicy(context, patternId, options) {
+    const envelope = await read(context, scanPatternPolicyAccountDefinition, patternId, false, options);
+    return policySnapshot(envelope);
+}
+/** Derives and reads an optional ScanPatternPolicy for the configured Game. Absence returns undefined; malformed accounts still throw.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, patternId: number;
+ * const snapshot = await maybeGetScanPatternPolicy(ctx, patternId, { refresh: true });
+ * ```
+ */
+export async function maybeGetScanPatternPolicy(context, patternId, options) {
+    const envelope = await read(context, scanPatternPolicyAccountDefinition, patternId, true, options);
+    if (envelope === undefined)
+        return undefined;
+    return policySnapshot(envelope);
+}
+/** Derives and reads a required ScanLootProfile for the configured Game. Absence throws AccountNotFoundError.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, regionId: number;
+ * const snapshot = await getScanLootProfile(ctx, regionId, { refresh: true });
+ * ```
+ */
+export async function getScanLootProfile(context, regionId, options) {
+    const envelope = await read(context, scanLootProfileAccountDefinition, regionId, false, options);
+    return waitForRegistry(context, lootSnapshot(context, envelope), options?.signal);
+}
+/** Derives and reads an optional ScanLootProfile for the configured Game. Absence returns undefined; malformed accounts still throw.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, regionId: number;
+ * const snapshot = await maybeGetScanLootProfile(ctx, regionId, { refresh: true });
+ * ```
+ */
+export async function maybeGetScanLootProfile(context, regionId, options) {
+    const envelope = await read(context, scanLootProfileAccountDefinition, regionId, true, options);
+    if (envelope === undefined)
+        return undefined;
+    return waitForRegistry(context, lootSnapshot(context, envelope), options?.signal);
+}
+//# sourceMappingURL=signals.js.map

package/dist/scanning/signals.js.map

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