@aephia/atlas-kit 0.0.0

package/dist/client/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/client/contracts.ts"],"names":[],"mappings":""}

package/dist/client/deployments.d.ts

@@ -0,0 +1,3 @@
+import type { Address } from './contracts.js';
+export declare const ZINK_PTR_GAME_ADDRESS: Address;
+//# sourceMappingURL=deployments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../../src/client/deployments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,eAAO,MAAM,qBAAqB,EACkB,OAAO,CAAC"}

package/dist/client/deployments.js

@@ -0,0 +1,2 @@
+export const ZINK_PTR_GAME_ADDRESS = 'EKEj47SzaCjPM3m4T4vRXrrsVtkEmiNgPMMFye3AkXj4';
+//# sourceMappingURL=deployments.js.map

package/dist/client/deployments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployments.js","sourceRoot":"","sources":["../../src/client/deployments.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,qBAAqB,GAChC,8CAAyD,CAAC"}

package/dist/client/errors.d.ts

@@ -0,0 +1,227 @@
+import type { Address, DataSourceIdentity, DiscoveryStrategy, EntityType } from './contracts.js';
+/** Stable error codes for read behavior and approved write boundaries.
+ *
+ * @example
+ * ```ts
+ * const code: SageSdkErrorCode = 'ACCOUNT_NOT_FOUND';
+ * ```
+ */
+export type SageSdkErrorCode = 'ACCOUNT_NOT_FOUND' | 'INVALID_ACCOUNT_OWNER' | 'INVALID_DISCRIMINATOR' | 'INVALID_ENTITY_ID' | 'INVALID_DERIVATION_INPUT' | 'ACCOUNT_DECODE_FAILED' | 'RELATIONSHIP_NOT_DISCOVERABLE' | 'MISSING_GAME_CONTEXT' | 'REGISTRY_OUT_OF_SYNC' | 'STALE_BINDING_VERSION' | 'PROVIDER_ERROR' | 'RESOURCE_LIMIT_EXCEEDED' | 'CONTEXT_DISPOSED' | 'INVALID_ACTION_INPUT' | 'INCOMPATIBLE_PLAN_COMPOSITION' | 'MISSING_WRITE_TRANSPORT' | 'TRANSACTION_TOO_LARGE' | 'TRANSACTION_EXPIRED' | 'ACTION_PRECONDITION_FAILED' | 'SIMULATION_FAILED' | 'TRANSACTION_SUBMISSION_FAILED' | 'TRANSACTION_OUTCOME_UNKNOWN';
+/** Safe contextual fields carried by SDK errors.
+ *
+ * @example
+ * ```ts
+ * declare const address: Address;
+ * const details: SageSdkErrorDetails = { accountType: 'fleet', address };
+ * ```
+ */
+export interface SageSdkErrorDetails {
+    readonly accountType?: EntityType;
+    readonly address?: Address;
+    readonly cause?: unknown;
+    readonly provider?: DataSourceIdentity;
+    readonly strategy?: DiscoveryStrategy;
+}
+/** Base error for all SDK failures.
+ *
+ * Messages identify the gameplay cause and a corrective next step.
+ *
+ * @example
+ * ```ts
+ * throw new SageSdkError(
+ *   'ACCOUNT_NOT_FOUND',
+ *   'The Fleet account was not found. Verify the Fleet address and cluster.',
+ * );
+ * ```
+ */
+export declare class SageSdkError extends Error {
+    readonly code: SageSdkErrorCode;
+    readonly accountType: EntityType | undefined;
+    readonly address: Address | undefined;
+    readonly provider: DataSourceIdentity | undefined;
+    readonly strategy: DiscoveryStrategy | undefined;
+    constructor(code: SageSdkErrorCode, message: string, details?: SageSdkErrorDetails);
+}
+/** Error thrown when a read API is invoked after its context is disposed.
+ *
+ * @example
+ * ```ts
+ * throw new ContextDisposedError();
+ * ```
+ */
+export declare class ContextDisposedError extends SageSdkError {
+    constructor();
+}
+/** Error thrown when a required account does not exist at the requested address.
+ *
+ * @example
+ * ```ts
+ * declare const fleetAddress: Address;
+ * throw new AccountNotFoundError('fleet', fleetAddress);
+ * ```
+ */
+export declare class AccountNotFoundError extends SageSdkError {
+    constructor(accountType: EntityType, address: Address);
+}
+/** Error thrown when an account belongs to a different program.
+ *
+ * @example
+ * ```ts
+ * declare const fleetAddress: Address;
+ * declare const sageProgram: Address;
+ * declare const actualOwner: Address;
+ * throw new InvalidAccountOwnerError('fleet', fleetAddress, sageProgram, actualOwner);
+ * ```
+ */
+export declare class InvalidAccountOwnerError extends SageSdkError {
+    constructor(accountType: EntityType, address: Address, expectedOwner: Address, actualOwner: Address);
+}
+/** Error thrown when account bytes do not start with the expected discriminator.
+ *
+ * @example
+ * ```ts
+ * declare const fleetAddress: Address;
+ * throw new InvalidDiscriminatorError('fleet', fleetAddress);
+ * ```
+ */
+export declare class InvalidDiscriminatorError extends SageSdkError {
+    constructor(accountType: EntityType, address: Address);
+}
+/** Error thrown when validated account data cannot produce a trustworthy SDK snapshot.
+ *
+ * @example
+ * ```ts
+ * declare const fleetAddress: Address;
+ * declare const cause: unknown;
+ * throw new AccountDecodeError('fleet', fleetAddress, cause);
+ * ```
+ *
+ * @example
+ * ```ts
+ * declare const characterAddress: Address;
+ * declare const cause: unknown;
+ * throw new AccountDecodeError(
+ *   'character',
+ *   characterAddress,
+ *   cause,
+ *   'The Character references a different Profile. Verify the Profile address and retry.',
+ * );
+ * ```
+ *
+ * @param message - Optional cause-and-remedy guidance for validated data that
+ * decoded successfully but contradicts the requested gameplay relationship.
+ */
+export declare class AccountDecodeError extends SageSdkError {
+    constructor(accountType: EntityType, address: Address, cause: unknown, message?: string);
+}
+/** Error thrown when the configured provider cannot satisfy a read.
+ *
+ * @example
+ * ```ts
+ * throw new ProviderError('The z.ink provider is unavailable. Check its endpoint and retry.');
+ * ```
+ */
+export declare class ProviderError extends SageSdkError {
+    constructor(message: string, details?: SageSdkErrorDetails);
+}
+/** Error thrown before an untrusted collection or payload can exceed a context limit.
+ *
+ * @example
+ * ```ts
+ * throw new ResourceLimitExceededError('discovery results', 1001, 1000);
+ * ```
+ */
+export declare class ResourceLimitExceededError extends SageSdkError {
+    readonly resource: string;
+    /** The observed quantity, or a conservative decoded-byte upper bound when an encoded payload is rejected before decoding. */
+    readonly actual: number;
+    readonly limit: number;
+    constructor(resource: string, actual: number, limit: number);
+}
+/** Error thrown when a requested relationship has no configured discovery capability.
+ *
+ * @example
+ * ```ts
+ * throw new RelationshipNotDiscoverableError(
+ *   'Wallet-to-Profile discovery is unavailable. Configure a provider.',
+ * );
+ * ```
+ */
+export declare class RelationshipNotDiscoverableError extends SageSdkError {
+    constructor(message: string, details?: SageSdkErrorDetails);
+}
+/** Error thrown when an operation needs a canonical Game address.
+ *
+ * @example
+ * ```ts
+ * throw new MissingGameContextError();
+ * ```
+ */
+export declare class MissingGameContextError extends SageSdkError {
+    constructor();
+}
+/** Error thrown when a generated account id cannot fit its unsigned 16-bit PDA seed.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidEntityIdError('recipe', 65_536);
+ * ```
+ */
+export declare class InvalidEntityIdError extends SageSdkError {
+    readonly entityType: 'starSystem' | 'celestialBody' | 'recipe' | 'market' | 'scanPattern' | 'faction' | 'region';
+    readonly id: number;
+    constructor(entityType: 'starSystem' | 'celestialBody' | 'recipe' | 'market' | 'scanPattern' | 'faction' | 'region', id: number);
+}
+/** Error thrown when a pure gameplay derivation input cannot be encoded or used safely.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidDerivationInputError('Fleet mining units per second', -1);
+ * ```
+ */
+export declare class InvalidDerivationInputError extends SageSdkError {
+    readonly field: string;
+    readonly value: number | bigint;
+    constructor(field: string, value: number | bigint, remedy?: string);
+}
+/** Error thrown when a write-side input is invalid before planning or RPC work.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidActionInputError(
+ *   'PlanAuthorization.keyIndex',
+ *   65_536,
+ *   'an integer from 0 through 65535',
+ *   'Set PlanAuthorization.keyIndex to the selected Profile key index before planning this action.',
+ * );
+ * ```
+ */
+export declare class InvalidActionInputError extends SageSdkError {
+    readonly field: string;
+    readonly value: unknown;
+    constructor(field: string, value: unknown, acceptedRange: string, remedy: string);
+}
+/** Error thrown when live state and one cached definitions section disagree.
+ *
+ * A cached section behind live state is marked for refresh on its next lookup.
+ * After an authoritative read confirms that mismatch, further refresh attempts
+ * for the section are coalesced for one second.
+ * Sequence-sensitive sections reject callers behind the loaded section. Ship
+ * lookups may reuse newer stable identity summaries; an id removed from the
+ * newer ship rows throws without scheduling an impossible historical refresh.
+ *
+ * @example
+ * ```ts
+ * throw new RegistryOutOfSyncError('ships', 12, 11, 3);
+ * ```
+ */
+export declare class RegistryOutOfSyncError extends SageSdkError {
+    readonly section: 'ships' | 'cargo' | 'craftingHabs' | 'habBuildings' | 'xp' | 'research';
+    readonly expectedSequenceId: number | undefined;
+    readonly actualSequenceId: number;
+    readonly definitionId: number;
+    /** Whether a fresh Game read already confirmed the definition is absent. */
+    readonly definitionMissingAfterRefresh: boolean;
+    constructor(section: 'ships' | 'cargo' | 'craftingHabs' | 'habBuildings' | 'xp' | 'research', expectedSequenceId: number | undefined, actualSequenceId: number, definitionId: number, definitionMissingAfterRefresh?: boolean);
+}
+//# sourceMappingURL=errors.d.ts.map

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

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

package/dist/client/errors.js

@@ -0,0 +1,288 @@
+/** Base error for all SDK failures.
+ *
+ * Messages identify the gameplay cause and a corrective next step.
+ *
+ * @example
+ * ```ts
+ * throw new SageSdkError(
+ *   'ACCOUNT_NOT_FOUND',
+ *   'The Fleet account was not found. Verify the Fleet address and cluster.',
+ * );
+ * ```
+ */
+export class SageSdkError extends Error {
+    code;
+    accountType;
+    address;
+    provider;
+    strategy;
+    constructor(code, message, details = {}) {
+        super(message, { cause: details.cause });
+        this.name = new.target.name;
+        this.code = code;
+        this.accountType = details.accountType;
+        this.address = details.address;
+        this.provider = details.provider;
+        this.strategy = details.strategy;
+    }
+}
+/** Error thrown when a read API is invoked after its context is disposed.
+ *
+ * @example
+ * ```ts
+ * throw new ContextDisposedError();
+ * ```
+ */
+export class ContextDisposedError extends SageSdkError {
+    constructor() {
+        super('CONTEXT_DISPOSED', 'This SAGE context has been disposed. Create a new context before reading game state.');
+    }
+}
+/** Error thrown when a required account does not exist at the requested address.
+ *
+ * @example
+ * ```ts
+ * declare const fleetAddress: Address;
+ * throw new AccountNotFoundError('fleet', fleetAddress);
+ * ```
+ */
+export class AccountNotFoundError extends SageSdkError {
+    constructor(accountType, address) {
+        super('ACCOUNT_NOT_FOUND', `The ${accountType} account was not found. Verify its address and configured cluster, then retry.`, { accountType, address });
+    }
+}
+/** Error thrown when an account belongs to a different program.
+ *
+ * @example
+ * ```ts
+ * declare const fleetAddress: Address;
+ * declare const sageProgram: Address;
+ * declare const actualOwner: Address;
+ * throw new InvalidAccountOwnerError('fleet', fleetAddress, sageProgram, actualOwner);
+ * ```
+ */
+export class InvalidAccountOwnerError extends SageSdkError {
+    constructor(accountType, address, expectedOwner, actualOwner) {
+        super('INVALID_ACCOUNT_OWNER', `The ${accountType} account is owned by ${actualOwner}, not the expected program ${expectedOwner}. Verify the account address and cluster before retrying.`, { accountType, address });
+    }
+}
+/** Error thrown when account bytes do not start with the expected discriminator.
+ *
+ * @example
+ * ```ts
+ * declare const fleetAddress: Address;
+ * throw new InvalidDiscriminatorError('fleet', fleetAddress);
+ * ```
+ */
+export class InvalidDiscriminatorError extends SageSdkError {
+    constructor(accountType, address) {
+        super('INVALID_DISCRIMINATOR', `The account at ${address} is not a valid ${accountType} account. Verify the account type, address, and installed binding version before retrying.`, { accountType, address });
+    }
+}
+/** Error thrown when validated account data cannot produce a trustworthy SDK snapshot.
+ *
+ * @example
+ * ```ts
+ * declare const fleetAddress: Address;
+ * declare const cause: unknown;
+ * throw new AccountDecodeError('fleet', fleetAddress, cause);
+ * ```
+ *
+ * @example
+ * ```ts
+ * declare const characterAddress: Address;
+ * declare const cause: unknown;
+ * throw new AccountDecodeError(
+ *   'character',
+ *   characterAddress,
+ *   cause,
+ *   'The Character references a different Profile. Verify the Profile address and retry.',
+ * );
+ * ```
+ *
+ * @param message - Optional cause-and-remedy guidance for validated data that
+ * decoded successfully but contradicts the requested gameplay relationship.
+ */
+export class AccountDecodeError extends SageSdkError {
+    constructor(accountType, address, cause, message = `The ${accountType} account passed ownership checks but its data could not be decoded. Verify the installed binding version and refresh the account.`) {
+        super('ACCOUNT_DECODE_FAILED', message, { accountType, address, cause });
+    }
+}
+/** Error thrown when the configured provider cannot satisfy a read.
+ *
+ * @example
+ * ```ts
+ * throw new ProviderError('The z.ink provider is unavailable. Check its endpoint and retry.');
+ * ```
+ */
+export class ProviderError extends SageSdkError {
+    constructor(message, details = {}) {
+        super('PROVIDER_ERROR', message, details);
+    }
+}
+/** Error thrown before an untrusted collection or payload can exceed a context limit.
+ *
+ * @example
+ * ```ts
+ * throw new ResourceLimitExceededError('discovery results', 1001, 1000);
+ * ```
+ */
+export class ResourceLimitExceededError extends SageSdkError {
+    resource;
+    /** The observed quantity, or a conservative decoded-byte upper bound when an encoded payload is rejected before decoding. */
+    actual;
+    limit;
+    constructor(resource, actual, limit) {
+        super('RESOURCE_LIMIT_EXCEEDED', `The ${resource} quantity ${String(actual)} exceeds the configured limit ${String(limit)}. Narrow the request or raise the matching context limit before retrying.`);
+        this.resource = resource;
+        this.actual = actual;
+        this.limit = limit;
+    }
+}
+/** Error thrown when a requested relationship has no configured discovery capability.
+ *
+ * @example
+ * ```ts
+ * throw new RelationshipNotDiscoverableError(
+ *   'Wallet-to-Profile discovery is unavailable. Configure a provider.',
+ * );
+ * ```
+ */
+export class RelationshipNotDiscoverableError extends SageSdkError {
+    constructor(message, details = {}) {
+        super('RELATIONSHIP_NOT_DISCOVERABLE', message, details);
+    }
+}
+/** Error thrown when an operation needs a canonical Game address.
+ *
+ * @example
+ * ```ts
+ * throw new MissingGameContextError();
+ * ```
+ */
+export class MissingGameContextError extends SageSdkError {
+    constructor() {
+        super('MISSING_GAME_CONTEXT', 'This SAGE context has no Game address. Pass the SAGE Game address when creating the context.', { accountType: 'game' });
+    }
+}
+/** Error thrown when a generated account id cannot fit its unsigned 16-bit PDA seed.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidEntityIdError('recipe', 65_536);
+ * ```
+ */
+export class InvalidEntityIdError extends SageSdkError {
+    entityType;
+    id;
+    constructor(entityType, id) {
+        const label = entityType === 'starSystem'
+            ? 'StarSystem'
+            : entityType === 'celestialBody'
+                ? 'CelestialBody'
+                : entityType === 'recipe'
+                    ? 'Recipe'
+                    : entityType === 'scanPattern'
+                        ? 'ScanPattern'
+                        : entityType === 'faction'
+                            ? 'Faction'
+                            : entityType === 'region'
+                                ? 'Region'
+                                : 'Local Market cargo';
+        const minimumId = entityType === 'faction' || entityType === 'region' ? 1 : 0;
+        super('INVALID_ENTITY_ID', `The ${label} id ${String(id)} is invalid. Use an integer from ${String(minimumId)} through 65535 before deriving or reading its account.`, {
+            accountType: entityType === 'region' ? 'factionOwnership' : entityType,
+        });
+        this.entityType = entityType;
+        this.id = id;
+    }
+}
+/** Error thrown when a pure gameplay derivation input cannot be encoded or used safely.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidDerivationInputError('Fleet mining units per second', -1);
+ * ```
+ */
+export class InvalidDerivationInputError extends SageSdkError {
+    field;
+    value;
+    constructor(field, value, remedy = 'Supply a finite, nonnegative number before deriving the gameplay value.') {
+        super('INVALID_DERIVATION_INPUT', `${field} is ${String(value)}, which is invalid for this derivation. ${remedy}`);
+        this.field = field;
+        this.value = value;
+    }
+}
+/** Error thrown when a write-side input is invalid before planning or RPC work.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidActionInputError(
+ *   'PlanAuthorization.keyIndex',
+ *   65_536,
+ *   'an integer from 0 through 65535',
+ *   'Set PlanAuthorization.keyIndex to the selected Profile key index before planning this action.',
+ * );
+ * ```
+ */
+export class InvalidActionInputError extends SageSdkError {
+    field;
+    value;
+    constructor(field, value, acceptedRange, remedy) {
+        super('INVALID_ACTION_INPUT', `${field} is ${String(value)}, which is invalid. Use ${acceptedRange}. ${remedy}`);
+        this.field = field;
+        this.value = value;
+    }
+}
+/** Error thrown when live state and one cached definitions section disagree.
+ *
+ * A cached section behind live state is marked for refresh on its next lookup.
+ * After an authoritative read confirms that mismatch, further refresh attempts
+ * for the section are coalesced for one second.
+ * Sequence-sensitive sections reject callers behind the loaded section. Ship
+ * lookups may reuse newer stable identity summaries; an id removed from the
+ * newer ship rows throws without scheduling an impossible historical refresh.
+ *
+ * @example
+ * ```ts
+ * throw new RegistryOutOfSyncError('ships', 12, 11, 3);
+ * ```
+ */
+export class RegistryOutOfSyncError extends SageSdkError {
+    section;
+    expectedSequenceId;
+    actualSequenceId;
+    definitionId;
+    /** Whether a fresh Game read already confirmed the definition is absent. */
+    definitionMissingAfterRefresh;
+    constructor(section, expectedSequenceId, actualSequenceId, definitionId, definitionMissingAfterRefresh = false) {
+        const expectation = expectedSequenceId === undefined
+            ? ''
+            : ` Live state expects sequence ${expectedSequenceId}, but the cached section is sequence ${actualSequenceId}.`;
+        const callerIsStale = expectedSequenceId !== undefined && expectedSequenceId < actualSequenceId;
+        const olderShipDefinitionMissing = section === 'ships' && callerIsStale;
+        const registryIsStale = expectedSequenceId !== undefined && expectedSequenceId > actualSequenceId;
+        const definition = section === 'xp'
+            ? 'XP rules'
+            : section === 'research'
+                ? `research definition id ${definitionId}`
+                : `id ${definitionId}`;
+        const verifyDefinition = section === 'xp' ? 'Verify the XP rules' : 'Verify the definition id';
+        const message = olderShipDefinitionMissing
+            ? `The loaded ships definitions at sequence ${actualSequenceId} do not contain ${definition} referenced by an older live snapshot at sequence ${expectedSequenceId}. The current Game registry may have removed this ship row; inspect its retained mint-to-id association through the raw bindings.`
+            : definitionMissingAfterRefresh
+                ? `The refreshed ${section} definitions at sequence ${actualSequenceId} do not contain ${definition}. ${verifyDefinition} and configured cluster, then wait for the live sequence to change before retrying.`
+                : callerIsStale
+                    ? `The live account snapshot expects ${section} definitions sequence ${expectedSequenceId}, but the registry already loaded newer sequence ${actualSequenceId}. Refresh the live account before retrying this definition lookup.`
+                    : registryIsStale
+                        ? `The cached ${section} definitions cannot resolve ${definition}.${expectation} Retry the lookup to refresh this definitions section from the Game account. After a confirming read, further refresh attempts for this section are coalesced for one second.`
+                        : `The cached ${section} definitions cannot resolve ${definition}.${expectation} Retry the lookup to refresh this definitions section from the Game account.`;
+        super('REGISTRY_OUT_OF_SYNC', message, { accountType: 'game' });
+        this.section = section;
+        this.expectedSequenceId = expectedSequenceId;
+        this.actualSequenceId = actualSequenceId;
+        this.definitionId = definitionId;
+        this.definitionMissingAfterRefresh = definitionMissingAfterRefresh;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/client/errors.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,7 @@
+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 { createSageContext } from './context.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 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';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,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"}

package/dist/client/index.js

@@ -0,0 +1,5 @@
+export { createSageContext } from './context.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';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +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,GAKT,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAC"}

package/dist/client/lifecycle.d.ts

@@ -0,0 +1,4 @@
+import type { SageContext } from './contracts.js';
+export declare function markContextDisposed(context: SageContext): void;
+export declare function assertContextActive(context: SageContext): void;
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/client/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAKlD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAE9D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAE9D"}

package/dist/client/lifecycle.js

@@ -0,0 +1,10 @@
+import { ContextDisposedError } from './errors.js';
+const disposedContexts = new WeakSet();
+export function markContextDisposed(context) {
+    disposedContexts.add(context);
+}
+export function assertContextActive(context) {
+    if (disposedContexts.has(context))
+        throw new ContextDisposedError();
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/client/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/client/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAe,CAAC;AAEpD,MAAM,UAAU,mBAAmB,CAAC,OAAoB;IACtD,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAoB;IACtD,IAAI,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,oBAAoB,EAAE,CAAC;AACtE,CAAC"}

package/dist/client/provider-errors.d.ts

@@ -0,0 +1,9 @@
+import type { Address } from './contracts.js';
+import { ProviderError } from './errors.js';
+/** Internal provider failure for a valid account delivered under the wrong requested address. */
+export declare class ProviderAccountAddressMismatchError extends ProviderError {
+    readonly requestedAddress: Address;
+    readonly actualAddress: Address;
+    constructor(requestedAddress: Address, actualAddress: Address);
+}
+//# sourceMappingURL=provider-errors.d.ts.map

package/dist/client/provider-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-errors.d.ts","sourceRoot":"","sources":["../../src/client/provider-errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,iGAAiG;AACjG,qBAAa,mCAAoC,SAAQ,aAAa;IACpE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;gBAEpB,gBAAgB,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO;CAQ9D"}

package/dist/client/provider-errors.js

@@ -0,0 +1,12 @@
+import { ProviderError } from './errors.js';
+/** Internal provider failure for a valid account delivered under the wrong requested address. */
+export class ProviderAccountAddressMismatchError extends ProviderError {
+    requestedAddress;
+    actualAddress;
+    constructor(requestedAddress, actualAddress) {
+        super(`The configured provider returned account ${actualAddress} for requested address ${requestedAddress}. Fix the provider response before retrying.`, { address: requestedAddress });
+        this.requestedAddress = requestedAddress;
+        this.actualAddress = actualAddress;
+    }
+}
+//# sourceMappingURL=provider-errors.js.map

package/dist/client/provider-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-errors.js","sourceRoot":"","sources":["../../src/client/provider-errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,iGAAiG;AACjG,MAAM,OAAO,mCAAoC,SAAQ,aAAa;IAC3D,gBAAgB,CAAU;IAC1B,aAAa,CAAU;IAEhC,YAAY,gBAAyB,EAAE,aAAsB;QAC3D,KAAK,CACH,4CAA4C,aAAa,0BAA0B,gBAAgB,8CAA8C,EACjJ,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAC9B,CAAC;QACF,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF"}

package/dist/client/reconciliation.d.ts

@@ -0,0 +1,10 @@
+import type { Address, RawAccount, ReadAccountOptions, SageContext, SageDataPort } from './contracts.js';
+export declare const INVALIDATE_CONTEXT_ADDRESSES: unique symbol;
+export declare const READ_CONTEXT_RAW_ACCOUNTS: unique symbol;
+export interface ReconciliableDataPort extends SageDataPort {
+    [INVALIDATE_CONTEXT_ADDRESSES](addresses: readonly Address[]): void;
+    [READ_CONTEXT_RAW_ACCOUNTS](addresses: readonly Address[], options?: ReadAccountOptions): Promise<readonly (RawAccount | undefined)[]>;
+}
+export declare function invalidateContextAddresses(context: SageContext, addresses: readonly Address[]): void;
+export declare function readContextRawAccounts(context: SageContext, addresses: readonly Address[], options?: ReadAccountOptions): Promise<readonly (RawAccount | undefined)[]>;
+//# sourceMappingURL=reconciliation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation.d.ts","sourceRoot":"","sources":["../../src/client/reconciliation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,YAAY,EACb,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,4BAA4B,EAAE,OAAO,MAEjD,CAAC;AACF,eAAO,MAAM,yBAAyB,EAAE,OAAO,MAE9C,CAAC;AAEF,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,CAAC,4BAA4B,CAAC,CAAC,SAAS,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC;IACpE,CAAC,yBAAyB,CAAC,CACzB,SAAS,EAAE,SAAS,OAAO,EAAE,EAC7B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,SAAS,CAAC,UAAU,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;CACjD;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,SAAS,OAAO,EAAE,GAC5B,IAAI,CAIN;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,SAAS,OAAO,EAAE,EAC7B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,SAAS,CAAC,UAAU,GAAG,SAAS,CAAC,EAAE,CAAC,CAK9C"}