@aephia/atlas-kit 0.6.0-next.17 → 0.6.0-next.171

package/dist/client/index.d.ts

@@ -1,8 +1,64 @@
-export type { AccountDefinition, AccountDiscoveryStrategy, AccountProvider, AccountSubscriptionEvent, AccountSubscriptionProvider, AccountSubscriptionRegistration, AccountSubscriptionRequest, Address, CacheKey, CacheRecord, ClusterIdentity, Commitment, CustomClusterIdentity, DataSourceIdentity, DiagnosticEvent, DiscoveryRequest, DiscoveryStrategy, EntityType, KnownCluster, IndexerDiscoveryRequest, IndexerProvider, ProgramAccountFilter, ProgramAccountRequest, RawAccount, ReadAccountOptions, ReadOptions, SageContext, SageContextOptions, SageDataPort, SageRpc, SageWriteRpc, SageSubscription, SnapshotEnvelope, SubscriptionObserver, SubscriptionDiagnosticEvent, SubscriptionOptions, WalletProfileDiscoveryProvider, WalletProfileDiscoveryRequest, } from './contracts.js';
+export type { AccountDefinition, AccountDiscoveryStrategy, AccountProvider, AccountSubscriptionEvent, AccountSubscriptionProvider, AccountSubscriptionRegistration, AccountSubscriptionRequest, Address, CacheKey, CacheRecord, ClusterIdentity, Commitment, CustomClusterIdentity, DataSourceIdentity, DiagnosticEvent, DiscoveryRequest, DiscoveryStrategy, DiscoverySubscriptionRequest, EntityType, KnownCluster, IndexerDiscoveryRequest, IndexerProvider, ProgramAccountFilter, ProgramAccountRequest, ProgramSubscriptionRequest, RawAccount, ReadAccountOptions, ReadOptions, SageContext, SageContextOptions, SageDataPort, SageRpc, SageWriteRpc, SageSubscription, SnapshotEnvelope, SubscriptionObserver, SubscriptionDiagnosticEvent, SubscriptionOptions, WalletProfileDiscoveryProvider, WalletProfileDiscoveryRequest, } from './contracts.js';
 export { createSageContext } from './context.js';
+/**
+ * Release-pinned canonical `Game` address for the z.ink PTR deployment.
+ *
+ * `createSageContext({ cluster: 'zink-ptr' })` uses this address only when the
+ * context does not receive an explicit `game`. Read `context.game` when a
+ * context may use an override.
+ *
+ * @example
+ * ```ts
+ * import { address } from '@solana/kit';
+ * import {
+ *   ZINK_PTR_GAME_ADDRESS,
+ *   createSageContext,
+ *   type AccountProvider,
+ * } from '@aephia/atlas-kit/client';
+ *
+ * declare const provider: AccountProvider;
+ *
+ * const defaultContext = createSageContext({
+ *   cluster: 'zink-ptr',
+ *   provider,
+ * });
+ * const explicitGame = address('11111111111111111111111111111111');
+ * const overriddenContext = createSageContext({
+ *   cluster: 'zink-ptr',
+ *   game: explicitGame,
+ *   provider,
+ * });
+ *
+ * console.log(defaultContext.game === ZINK_PTR_GAME_ADDRESS); // true
+ * console.log(overriddenContext.game === explicitGame); // true
+ * ```
+ */
+export { ZINK_PTR_GAME_ADDRESS } from './deployments.js';
+/** Mints of the Game's token resources on z.ink PTR: Ammunition, Food, Fuel
+ * and Repair Kit. They never change on PTR; another deployment uses its own
+ * mints. Find the matching cargo definition by `mint`, since cargo ids are Game
+ * definition rows.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   ZINK_PTR_RESOURCE_MINTS,
+ *   type SageContext,
+ * } from '@aephia/atlas-kit/client';
+ * import { listCargoDefinitions } from '@aephia/atlas-kit/cargo';
+ *
+ * declare const ctx: SageContext;
+ * const food = (await listCargoDefinitions(ctx)).find(
+ *   (cargo) => cargo.mint === ZINK_PTR_RESOURCE_MINTS.food,
+ * );
+ * console.log(food?.id);
+ * ```
+ */
+export { ZINK_PTR_RESOURCE_MINTS } from './deployments.js';
 export { AccountDecodeError, AccountNotFoundError, ContextDisposedError, InvalidAccountOwnerError, InvalidDiscriminatorError, InvalidDerivationInputError, InvalidEntityIdError, MissingGameContextError, ProviderError, ResourceLimitExceededError, RelationshipNotDiscoverableError, RegistryOutOfSyncError, SageSdkError, type SageSdkErrorCode, type SageSdkErrorDetails, } from './errors.js';
 export { readMeta, type DefinitionPreloadMeta, type PreloadedDefinitions, type IndexerValidationMeta, type ReadMeta, type ReadMetaFilter, type WalletProfileValidationMeta, } from '../internal/read-meta.js';
 export { entityRef, type EntityRef } from './refs.js';
 export type { CargoDefinitionSummary, DefinitionLookupOptions, DefinitionSection, DefinitionSectionSnapshot, RegistrySnapshotStore, ShipDefinitionSummary, } from '../registry/index.js';
 export { InvalidDefinitionSectionError } from './errors.js';
+export { createRpcSubscriptionProvider, type RpcSubscriptionProviderOptions, } from './rpc-subscription-provider.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,+BAA+B,EAC/B,0BAA0B,EAC1B,OAAO,EACP,QAAQ,EACR,WAAW,EACX,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,0BAA0B,EAC1B,gCAAgC,EAChC,sBAAsB,EACtB,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,QAAQ,EACR,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,2BAA2B,GACjC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACtD,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,+BAA+B,EAC/B,0BAA0B,EAC1B,OAAO,EACP,QAAQ,EACR,WAAW,EACX,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,4BAA4B,EAC5B,UAAU,EACV,YAAY,EACZ,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,0BAA0B,EAC1B,gCAAgC,EAChC,sBAAsB,EACtB,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,QAAQ,EACR,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,2BAA2B,GACjC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACtD,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,6BAA6B,EAC7B,KAAK,8BAA8B,GACpC,MAAM,gCAAgC,CAAC"}

package/dist/client/index.js

@@ -1,6 +1,62 @@
 export { createSageContext } from './context.js';
+/**
+ * Release-pinned canonical `Game` address for the z.ink PTR deployment.
+ *
+ * `createSageContext({ cluster: 'zink-ptr' })` uses this address only when the
+ * context does not receive an explicit `game`. Read `context.game` when a
+ * context may use an override.
+ *
+ * @example
+ * ```ts
+ * import { address } from '@solana/kit';
+ * import {
+ *   ZINK_PTR_GAME_ADDRESS,
+ *   createSageContext,
+ *   type AccountProvider,
+ * } from '@aephia/atlas-kit/client';
+ *
+ * declare const provider: AccountProvider;
+ *
+ * const defaultContext = createSageContext({
+ *   cluster: 'zink-ptr',
+ *   provider,
+ * });
+ * const explicitGame = address('11111111111111111111111111111111');
+ * const overriddenContext = createSageContext({
+ *   cluster: 'zink-ptr',
+ *   game: explicitGame,
+ *   provider,
+ * });
+ *
+ * console.log(defaultContext.game === ZINK_PTR_GAME_ADDRESS); // true
+ * console.log(overriddenContext.game === explicitGame); // true
+ * ```
+ */
+export { ZINK_PTR_GAME_ADDRESS } from './deployments.js';
+/** Mints of the Game's token resources on z.ink PTR: Ammunition, Food, Fuel
+ * and Repair Kit. They never change on PTR; another deployment uses its own
+ * mints. Find the matching cargo definition by `mint`, since cargo ids are Game
+ * definition rows.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   ZINK_PTR_RESOURCE_MINTS,
+ *   type SageContext,
+ * } from '@aephia/atlas-kit/client';
+ * import { listCargoDefinitions } from '@aephia/atlas-kit/cargo';
+ *
+ * declare const ctx: SageContext;
+ * const food = (await listCargoDefinitions(ctx)).find(
+ *   (cargo) => cargo.mint === ZINK_PTR_RESOURCE_MINTS.food,
+ * );
+ * console.log(food?.id);
+ * ```
+ */
+export { ZINK_PTR_RESOURCE_MINTS } from './deployments.js';
 export { AccountDecodeError, AccountNotFoundError, ContextDisposedError, InvalidAccountOwnerError, InvalidDiscriminatorError, InvalidDerivationInputError, InvalidEntityIdError, MissingGameContextError, ProviderError, ResourceLimitExceededError, RelationshipNotDiscoverableError, RegistryOutOfSyncError, SageSdkError, } from './errors.js';
 export { readMeta, } from '../internal/read-meta.js';
 export { entityRef } from './refs.js';
 export { InvalidDefinitionSectionError } from './errors.js';
+export { createRpcSubscriptionProvider, } from './rpc-subscription-provider.js';
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,0BAA0B,EAC1B,gCAAgC,EAChC,sBAAsB,EACtB,YAAY,GAGb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,QAAQ,GAOT,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAC;AAUtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AA0CA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,0BAA0B,EAC1B,gCAAgC,EAChC,sBAAsB,EACtB,YAAY,GAGb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,QAAQ,GAOT,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAC;AAUtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,6BAA6B,GAE9B,MAAM,gCAAgC,CAAC"}

package/dist/client/rpc-subscription-provider.d.ts

@@ -0,0 +1,37 @@
+import { type AccountNotificationsApi, type RpcSubscriptions } from '@solana/kit';
+import type { AccountSubscriptionProvider, DataSourceIdentity } from './contracts.js';
+/** Options for the injected Kit WebSocket account adapter. No connection is opened by the factory.
+ *
+ * @example
+ * ```ts
+ * import type { AccountNotificationsApi, RpcSubscriptions } from '@solana/kit';
+ * declare const rpcSubscriptions: RpcSubscriptions<AccountNotificationsApi>;
+ * const options: RpcSubscriptionProviderOptions = { rpcSubscriptions };
+ * ```
+ */
+export interface RpcSubscriptionProviderOptions {
+    /** A transport that also exposes `programNotifications`, such as Kit's
+     * `createSolanaRpcSubscriptions`, adds `subscribeProgram` to the provider. */
+    readonly rpcSubscriptions: RpcSubscriptions<AccountNotificationsApi>;
+    /** Non-secret provenance label; never supply an endpoint or credentials. */
+    readonly identity?: DataSourceIdentity;
+    readonly backoff?: {
+        readonly initialMs?: number;
+        readonly maxMs?: number;
+    };
+}
+/** Adapt an application-owned Kit transport to context-owned account subscriptions.
+ * Initial registration failures reject with a sanitized ProviderError. Dropped
+ * streams retry with equal jitter (half to all of the capped exponential delay).
+ * Successful registration resets backoff. Cancellation releases Kit through its
+ * abort signal; iterator cleanup is best-effort and cannot block unsubscribe.
+ *
+ * @example
+ * ```ts
+ * import type { AccountNotificationsApi, RpcSubscriptions } from '@solana/kit';
+ * declare const rpcSubscriptions: RpcSubscriptions<AccountNotificationsApi>;
+ * const subscriptions = createRpcSubscriptionProvider({ rpcSubscriptions });
+ * ```
+ */
+export declare function createRpcSubscriptionProvider(options: RpcSubscriptionProviderOptions): AccountSubscriptionProvider;
+//# sourceMappingURL=rpc-subscription-provider.d.ts.map

package/dist/client/rpc-subscription-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-subscription-provider.d.ts","sourceRoot":"","sources":["../../src/client/rpc-subscription-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,uBAAuB,EAG5B,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAEV,2BAA2B,EAC3B,kBAAkB,EAEnB,MAAM,gBAAgB,CAAC;AAGxB;;;;;;;;GAQG;AACH,MAAM,WAAW,8BAA8B;IAC7C;kFAC8E;IAC9E,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,uBAAuB,CAAC,CAAC;IACrE,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E;AAmDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,2BAA2B,CAwL7B"}

package/dist/client/rpc-subscription-provider.js

@@ -0,0 +1,224 @@
+import { getBase58Decoder, getBase64Encoder, } from '@solana/kit';
+import { ProviderError } from './errors.js';
+function registrationError() {
+    return new ProviderError('The WebSocket provider could not register the account subscription. Check the injected Kit connection and retry.');
+}
+// Cancellation races both Kit registration and iteration; a transport that ignores
+// abort cannot keep the public registration pending or deliver after teardown.
+function cancellable(work, signal) {
+    return new Promise((resolve, reject) => {
+        const abort = () => {
+            signal.removeEventListener('abort', abort);
+            reject(registrationError());
+        };
+        signal.addEventListener('abort', abort, { once: true });
+        void work
+            .then(resolve, reject)
+            .finally(() => signal.removeEventListener('abort', abort));
+        if (signal.aborted)
+            abort();
+    });
+}
+async function pause(delay, signal) {
+    // Browsers/Node clamp oversized timeouts to 1ms. Honour all safe integers.
+    while (delay > 0 && !signal.aborted) {
+        const chunk = Math.min(delay, 2_147_483_647);
+        let timer;
+        try {
+            await cancellable(new Promise((resolve) => {
+                timer = setTimeout(resolve, chunk);
+            }), signal);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        delay -= chunk;
+    }
+}
+function release(iterator) {
+    try {
+        void iterator.return?.().catch(() => undefined);
+    }
+    catch {
+        // Cleanup must not expose transport details or prevent cancellation.
+    }
+}
+/** Adapt an application-owned Kit transport to context-owned account subscriptions.
+ * Initial registration failures reject with a sanitized ProviderError. Dropped
+ * streams retry with equal jitter (half to all of the capped exponential delay).
+ * Successful registration resets backoff. Cancellation releases Kit through its
+ * abort signal; iterator cleanup is best-effort and cannot block unsubscribe.
+ *
+ * @example
+ * ```ts
+ * import type { AccountNotificationsApi, RpcSubscriptions } from '@solana/kit';
+ * declare const rpcSubscriptions: RpcSubscriptions<AccountNotificationsApi>;
+ * const subscriptions = createRpcSubscriptionProvider({ rpcSubscriptions });
+ * ```
+ */
+export function createRpcSubscriptionProvider(options) {
+    const initialMs = options.backoff?.initialMs ?? 250;
+    const maxMs = options.backoff?.maxMs ?? 30_000;
+    if (!Number.isSafeInteger(initialMs) ||
+        initialMs <= 0 ||
+        !Number.isSafeInteger(maxMs) ||
+        maxMs < initialMs) {
+        throw new ProviderError('Subscription backoff values must be positive safe integers with maxMs >= initialMs. Correct the retry configuration.');
+    }
+    const identity = Object.freeze({
+        kind: options.identity?.kind ?? 'websocket',
+        name: options.identity?.name ?? 'rpc-subscriptions',
+    });
+    const rpcSubscriptions = options.rpcSubscriptions;
+    // One registration loop serves account and program streams: Kit-specific
+    // notification shapes stay in `open` and `toAccount`.
+    async function subscribeStream(requestSignal, openNotifications, toAccount, listener) {
+        const controller = new AbortController();
+        const signal = controller.signal;
+        let closeAttempt;
+        const close = () => {
+            const cleanup = closeAttempt;
+            closeAttempt = undefined;
+            cleanup?.();
+        };
+        const stop = () => {
+            controller.abort();
+            requestSignal?.removeEventListener('abort', stop);
+            close();
+        };
+        requestSignal?.addEventListener('abort', stop, { once: true });
+        if (requestSignal?.aborted)
+            stop();
+        async function open() {
+            if (signal.aborted)
+                throw registrationError();
+            const attempt = new AbortController();
+            closeAttempt = () => attempt.abort();
+            try {
+                const pending = openNotifications(attempt.signal).then((stream) => {
+                    const iterator = stream[Symbol.asyncIterator]();
+                    if (signal.aborted) {
+                        release(iterator);
+                        throw registrationError();
+                    }
+                    closeAttempt = () => {
+                        attempt.abort();
+                        release(iterator);
+                    };
+                    return iterator;
+                });
+                return await cancellable(pending, signal);
+            }
+            catch {
+                close();
+                throw registrationError();
+            }
+        }
+        try {
+            const initial = await open();
+            void (async () => {
+                let iterator = initial;
+                while (!signal.aborted) {
+                    // Only transport next()/termination failures enter the retry loop.
+                    try {
+                        while (!signal.aborted) {
+                            const item = await cancellable(iterator.next(), signal);
+                            if (signal.aborted || item.done)
+                                break;
+                            try {
+                                listener({ kind: 'account', account: toAccount(item.value) });
+                            }
+                            catch {
+                                // A malformed payload or listener exception is not a dropped
+                                // transport. No error channel exists on the raw contract.
+                            }
+                        }
+                    }
+                    catch {
+                        // Kit errors are deliberately neither retained nor emitted.
+                    }
+                    close();
+                    let delay = initialMs;
+                    while (!signal.aborted) {
+                        await pause(Math.max(1, Math.floor(delay * (0.5 + Math.random() / 2))), signal);
+                        if (signal.aborted)
+                            break;
+                        try {
+                            iterator = await open();
+                        }
+                        catch {
+                            delay = Math.min(maxMs, delay * 2);
+                            continue;
+                        }
+                        if (!signal.aborted) {
+                            try {
+                                listener({ kind: 'reconnected' });
+                            }
+                            catch {
+                                /* Consumer failure is not transport failure. */
+                            }
+                        }
+                        break;
+                    }
+                }
+            })().catch(stop);
+            return { unsubscribe: async () => stop() };
+        }
+        catch {
+            stop();
+            throw registrationError();
+        }
+    }
+    const base64 = getBase64Encoder();
+    // Kit's transport proxy exposes every method; a narrower injected transport
+    // without programNotifications yields a provider without subscribeProgram.
+    const programSubscriptions = rpcSubscriptions;
+    return {
+        identity,
+        subscribeAccount(request, listener) {
+            const { address } = request;
+            const commitment = request.commitment ?? 'confirmed';
+            return subscribeStream(request.signal, (abortSignal) => rpcSubscriptions
+                .accountNotifications(address, { commitment, encoding: 'base64' })
+                .subscribe({ abortSignal }), (item) => ({
+                address,
+                commitment,
+                slot: item.context.slot,
+                owner: item.value.owner,
+                lamports: item.value.lamports,
+                executable: item.value.executable,
+                data: Uint8Array.from(base64.encode(item.value.data[0])),
+            }), listener);
+        },
+        ...(typeof programSubscriptions.programNotifications !== 'function'
+            ? {}
+            : {
+                subscribeProgram(request, listener) {
+                    const commitment = request.commitment ?? 'confirmed';
+                    const filters = request.filters.map((filter) => ({
+                        memcmp: {
+                            bytes: getBase58Decoder().decode(filter.bytes),
+                            encoding: 'base58',
+                            offset: BigInt(filter.offset),
+                        },
+                    }));
+                    return subscribeStream(request.signal, (abortSignal) => programSubscriptions
+                        .programNotifications(request.programAddress, {
+                        commitment,
+                        encoding: 'base64',
+                        filters,
+                    })
+                        .subscribe({ abortSignal }), (item) => ({
+                        address: item.value.pubkey,
+                        commitment,
+                        slot: item.context.slot,
+                        owner: item.value.account.owner,
+                        lamports: item.value.account.lamports,
+                        executable: item.value.account.executable,
+                        data: Uint8Array.from(base64.encode(item.value.account.data[0])),
+                    }), listener);
+                },
+            }),
+    };
+}
+//# sourceMappingURL=rpc-subscription-provider.js.map

package/dist/client/rpc-subscription-provider.js.map

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

package/dist/combat/actions/index.d.ts

@@ -1,12 +1,12 @@
 import { type Address } from '@solana/kit';
 import type { SageContext } from '../../client/contracts.js';
 import type { EntityRef } from '../../client/refs.js';
-import { type LootAccountData } from '../../internal/c4/combat.js';
+import { type LootRewardData } from '../../internal/c4/loot.js';
 import type { GameStimulantEffectData } from '../../internal/c4/game.js';
 import { type StarSystemAccountData } from '../../internal/c4/world.js';
 import type { ResolvedFleetAccountData } from '../../internal/fleet.js';
 import { type PlanAuthorization } from '../../internal/planning/authorization-adapter.js';
-import { type Plan } from '../../planning/index.js';
+import type { Plan } from '../../planning/index.js';
 import { type CargoDefinitionSummary } from '../../registry/index.js';
 export type { PlanAuthorization };
 interface FleetSnapshot extends Omit<ResolvedFleetAccountData, 'ownerProfile'> {
@@ -26,18 +26,18 @@ interface LootSnapshot {
     readonly version: number;
     readonly game: EntityRef<'game'>;
     readonly profile: EntityRef<'profile'>;
-    readonly reward: LootAccountData['reward'];
+    readonly reward: LootRewardData;
     readonly coordinates: {
         readonly x: number;
         readonly y: number;
     };
     readonly items: readonly {
-        readonly destroyer: EntityRef<'fleet'>;
+        readonly destroyer?: EntityRef<'profile'>;
         readonly exclusivityUnlockAtUnixSeconds: bigint;
         readonly rewardReclaimAtUnixSeconds: bigint;
         readonly inventory: {
             readonly sequenceId: number;
-            readonly storageCostRaw: bigint;
+            readonly usedStorageUnitsRaw: bigint;
             readonly items: readonly {
                 readonly cargo: CargoDefinitionSummary;
                 readonly quantityRaw: bigint;
@@ -143,9 +143,11 @@ export interface PlanFleetRetrieveLootOptions {
 /** Plans application of one configured combat stimulant without predicting its effects.
  *
  * The planner validates Fleet ownership and Game membership, current catalog
- * membership, known cargo balance, crewed non-destroyed state, and fresh
- * whole-account Fleet state. Permission, stacking, charge application, and
- * combat arithmetic remain chain-authoritative.
+ * membership, known cargo balance, a crewed Fleet that is neither destroyed
+ * nor respawning, and fresh whole-account Fleet state. Only stimulants whose
+ * effects use the `refresh` stack rule are planned, as the game applies no
+ * other rule yet. Permission, charge application, and combat arithmetic remain
+ * chain-authoritative.
  *
  * @example
  * ```ts
@@ -165,6 +167,8 @@ export interface PlanFleetRetrieveLootOptions {
 export declare function planFleetApplyCombatStimulant(ctx: SageContext, fleet: FleetSnapshot, stimulant: CombatStimulantDefinition, input: PlanFleetApplyCombatStimulantOptions): Promise<Plan>;
 /** Plans one singleton Fleet-on-Fleet attack without predicting its outcome.
  *
+ * At chain time the attacker must be Idle or subwarping (a finished warp
+ * counts as Idle), carry its required crew, and have finished reloading AP.
  * Range, randomness, recent slot hashes, final combat arithmetic, and chain
  * races remain authoritative. This Plan cannot be combined with another
  * gameplay instruction because the generated program contract requires a
@@ -189,12 +193,24 @@ export declare function planFleetApplyCombatStimulant(ctx: SageContext, fleet: F
 export declare function planFleetAttackFleet(ctx: SageContext, attacker: FleetSnapshot, defender: FleetSnapshot, inputStance: FleetAttackStance, inputOptions: PlanFleetAttackFleetOptions): Promise<Plan>;
 /** Plans one singleton Fleet-on-Starbase attack without predicting its outcome.
  *
+ * At chain time the attacker must be Idle or subwarping (a finished warp
+ * counts as Idle), carry its required crew, and have finished reloading AP.
  * The planner validates the owned attacking Fleet, canonical target System and
  * nested shared Starbase, configured faction ownership mode, reward
  * configuration, and the optional dynamic-NPC capture economy. Range,
  * capture-cost debit outcome, randomness, damage, rewards, and final
  * admissibility remain chain-authoritative.
  *
+ * Requires Disabled rent: the Game's rent catalog and the target System's
+ * Starbase-level rent history must not exist, and both stay guarded absent until
+ * signing.
+ *
+ * From the RegionTracker, the attack reads only the target System's Region, so
+ * the Plan guards only that Region's owner, safety status and risk zone and a
+ * Starbase capture or upgrade in another Region leaves it valid. If the
+ * System's stored Region disagrees with the Region map, the whole tracker stays
+ * guarded.
+ *
  * @example
  * ```ts
  * declare const ctx: SageContext;
@@ -214,10 +230,12 @@ export declare function planFleetAttackFleet(ctx: SageContext, attacker: FleetSn
 export declare function planFleetAttackStarbase(ctx: SageContext, attacker: FleetSnapshot, target: StarSystemSnapshot, inputStance: FleetAttackStance, inputOptions: PlanFleetAttackStarbaseOptions): Promise<Plan>;
 /** Plans one transaction-exclusive retrieval from a loaded Loot snapshot.
  *
- * The planner validates the owned idle Fleet, Loot identity, destroyer
- * exclusivity, and every requested known quantity. Range, recent-slot inputs,
- * destination capacity, intervening races, and final acquired quantities
- * remain chain-authoritative.
+ * The planner validates the owned idle Fleet, its normalized crew and usable
+ * ability power at `atUnixSeconds`, Loot identity, destroyer exclusivity and
+ * reward locks against the authorization Profile, and every requested known
+ * quantity. Retrieval spends the Fleet's whole ability power pool. Range,
+ * recent-slot inputs, destination capacity, intervening races, and final
+ * acquired quantities remain chain-authoritative.
  *
  * @example
  * ```ts

package/dist/combat/actions/index.d.ts.map

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