@aephia/atlas-kit 0.6.0-next.6 → 0.6.0-next.61

package/dist/scanning/signals.js

@@ -0,0 +1,171 @@
+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, 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),
+            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":"AAAA,OAAO,EACL,SAAS,EAOT,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,2BAA2B,EAC3B,kCAAkC,EAClC,gCAAgC,EAChC,0BAA0B,GAK3B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EACL,YAAY,GAEb,MAAM,sBAAsB,CAAC;AAyF9B,SAAS,MAAM,CACb,QAAmC,EACnC,KAAQ;IAER,OAAO,sBAAsB,CAC3B,cAAc,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE;QAC7C,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,QAAQ,EAAE,SAAS;KACpB,CAAC,CACH,CAAC;AACJ,CAAC;AACD,KAAK,UAAU,IAAI,CACjB,OAAoB,EACpB,UAAgC,EAChC,GAAqB,EACrB,QAAiB,EACjB,OAAqB;IAErB,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,MAAM,0BAA0B,CACtD,UAAU,CAAC,IAA8D,EACzE,IAAI,EACJ,GAAG,CACJ,CAAC;IACF,MAAM,QAAQ,GAAG,QAAQ;QACvB,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,MAAM,SAAS,GACb,OAAO,IAAI,IAAI;QACb,CAAC,CAAC,IAAI,CAAC,KAAK;QACZ,CAAC,CAAC,WAAW,IAAI,IAAI;YACnB,CAAC,CAAC,IAAI,CAAC,SAAS;YAChB,CAAC,CAAE,IAAuC,CAAC,QAAQ,CAAC;IAC1D,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,SAAS,KAAK,GAAG;QAC/D,MAAM,IAAI,kBAAkB,CAC1B,UAAU,CAAC,IAAI,EACf,OAAO,EACP,IAAI,UAAU,CACZ,0DAA0D,CAC3D,EACD,GAAG,UAAU,CAAC,IAAI,IAAI,OAAO,+HAA+H,CAC7J,CAAC;IACJ,OAAO,QAAQ,CAAC;AAClB,CAAC;AACD,MAAM,OAAO,GAAG,IAAI,OAAO,EAGxB,CAAC;AACJ,MAAM,QAAQ,GAAG,IAAI,OAAO,EAGzB,CAAC;AACJ,MAAM,YAAY,GAAG,IAAI,OAAO,EAG7B,CAAC;AACJ,KAAK,UAAU,KAAK,CAClB,OAAoB,EACpB,GAAM;IAEN,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC;IACjC,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;AAClE,CAAC;AACD,SAAS,cAAc,CACrB,OAAoB,EACpB,QAA0C;IAE1C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;QAC1B,MAAM,EACJ,IAAI,EACJ,IAAI,EAAE,KAAK,EACX,KAAK,EACL,YAAY,EACZ,cAAc,EACd,OAAO,EACP,OAAO,EACP,OAAO,EACP,SAAS,EACT,KAAK,EACL,GAAG,IAAI,EACR,GAAG,QAAQ,CAAC,IAAI,CAAC;QAClB,OAAO,MAAM,CAAC,QAAQ,EAAE;YACtB,GAAG,IAAI;YACP,OAAO,EAAE,OAAO,IAAI,SAAS;YAC7B,SAAS,EAAE,SAAS,IAAI,SAAS;YACjC,KAAK,EAAE,KAAK,IAAI,SAAS;YACzB,IAAI,EAAE,YAAqB;YAC3B,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC;YAC7B,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC;YAChC,YAAY,EAAE,SAAS,CAAC,SAAS,EAAE,YAAY,CAAC;YAChD,cAAc,EAAE,SAAS,CAAC,WAAW,EAAE,cAAc,CAAC;YACtD,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5D,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;SAC7D,CAAC,CAAC;IACL,CAAC,CAAC,EAAE,CAAC;IACL,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,SAAS,cAAc,CACrB,QAAiD;IAEjD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;IACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,EAAE;QAChC,GAAG,IAAI;QACP,IAAI,EAAE,mBAA4B;QAClC,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC;KAC9B,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC;AAClB,CAAC;AACD,SAAS,YAAY,CACnB,OAAoB,EACpB,QAA+C;IAE/C,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;QAC1B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC3D,OAAO,MAAM,CAAC,QAAQ,EAAE;YACtB,GAAG,IAAI;YACP,IAAI,EAAE,iBAA0B;YAChC,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC;YAC7B,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;SAChE,CAAC,CAAC;IACL,CAAC,CAAC,EAAE,CAAC;IACL,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAoB,EACpB,KAAc,EACd,OAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,IAAI,CACzB,OAAO,EACP,2BAA2B,EAC3B,KAAK,EACL,KAAK,EACL,OAAO,CACR,CAAC;IACF,OAAO,eAAe,CACpB,OAAO,EACP,cAAc,CAAC,OAAO,EAAE,QAAS,CAAC,EAClC,OAAO,EAAE,MAAM,CAChB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAoB,EACpB,KAAc,EACd,OAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,IAAI,CACzB,OAAO,EACP,2BAA2B,EAC3B,KAAK,EACL,IAAI,EACJ,OAAO,CACR,CAAC;IACF,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,eAAe,CACpB,OAAO,EACP,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,EACjC,OAAO,EAAE,MAAM,CAChB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAoB,EACpB,SAAiB,EACjB,OAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,IAAI,CACzB,OAAO,EACP,kCAAkC,EAClC,SAAS,EACT,KAAK,EACL,OAAO,CACR,CAAC;IACF,OAAO,cAAc,CAAC,QAAS,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAoB,EACpB,SAAiB,EACjB,OAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,IAAI,CACzB,OAAO,EACP,kCAAkC,EAClC,SAAS,EACT,IAAI,EACJ,OAAO,CACR,CAAC;IACF,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAoB,EACpB,QAAgB,EAChB,OAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,IAAI,CACzB,OAAO,EACP,gCAAgC,EAChC,QAAQ,EACR,KAAK,EACL,OAAO,CACR,CAAC;IACF,OAAO,eAAe,CACpB,OAAO,EACP,YAAY,CAAC,OAAO,EAAE,QAAS,CAAC,EAChC,OAAO,EAAE,MAAM,CAChB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAoB,EACpB,QAAgB,EAChB,OAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,IAAI,CACzB,OAAO,EACP,gCAAgC,EAChC,QAAQ,EACR,IAAI,EACJ,OAAO,CACR,CAAC;IACF,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,eAAe,CACpB,OAAO,EACP,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC/B,OAAO,EAAE,MAAM,CAChB,CAAC;AACJ,CAAC"}

package/package.json

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