@polyester/sdk 0.0.0

package/dist/index.d.ts

@@ -0,0 +1,100 @@
+import { AccountSigner, AccountSignerConfig, AccountSignerFactory, HexAddress } from "./account-signer/types.js";
+import { CreatePolyesterEnvironmentParams, POLYESTER_TESTNET_ENVIRONMENT, PolyesterAccountAbstractionEnvironment, PolyesterContractsEnvironment, PolyesterEntryPointConfig, PolyesterEnvironment, PolyesterSafeDeploymentConfig, createPolyesterEnvironment } from "./environment.js";
+import { CreatePolyesterAccountSignerParams } from "./account-signer/create-polyester-account-signer.js";
+import "./account-signer/index.js";
+import { AssetConfig, DepositWithdrawConfig, PairConfig, PairStatus, SpotConfig, ZipperAssetChainVariant, ZipperAssetConfig, ZipperChainConfig, ZipperChainContractConfig } from "./shared/catalog-config.js";
+import { AlreadyExistsError, AuthenticationError, ConfigurationError, InternalServerError, MfaEnrollmentRequiredError, MfaLastFactorRequiredError, MfaRequiredError, MfaVerificationError, MfaVerificationFailureReason, NetworkError, PermissionError, PolicyInUseError, PolicyLockedError, PolicyScopeMismatchError, PolyesterError, PolyesterErrorCode, PolyesterErrorOptions, PreconditionFailedError, RateLimitError, RateLimitErrorOptions, RequestError, ResourceNotFoundError, RevisionConflictError, ServiceUnavailableError, SessionElevationRequiredError, StaleQuoteError, StepUpRequiredError, TimeoutError, TransientError, ValidationError, errorFromHttpStatus, isAbortError, normalizeErrorMessage } from "./shared/errors.js";
+import { ApiKeyEd25519AuthProvider, JwtAuthProvider, Transports } from "./shared/transports.js";
+import { PolyesterMutationOptions, PolyesterRequestOptions } from "./shared/request-options.js";
+import { ResolveAccountInput, ResolvedAccount } from "./services/accounts/accounts.schemas.js";
+import { AccountScope, AccountScopedInput } from "./shared/account-scope.js";
+import { SdkSubscriptionErrorContext } from "./shared/subscription-errors.js";
+import { ConnectChannelParams, PolyesterRealtime, SubscribeHandlers } from "./realtime/types.js";
+import "./realtime/index.js";
+import { ApiKeyPolicy, ApiKeyPolicyApplyInput, ApiKeyPolicyCreateInput, ApiKeyPolicyUpdateInput, ListApiKeyPoliciesResponse } from "./services/policies/api-key-policies/api-key-policies.schemas.js";
+import { ApiKey, ApiKeyIdInput, ApiKeyStatus, ApiKeysCreateInput, ApiKeysListInput, ApiKeysUpdateInput } from "./services/api-keys/api-keys.schemas.js";
+import { AccountIdentity, Profile, UpdateProfileInput, UsernameHistoryEntry } from "./services/auth/profile/profile.schemas.js";
+import { LoginWithWalletInput, LoginWithWalletResponse, Me, Nonce } from "./services/auth/auth.js";
+import { SubaccountPolicy, SubaccountPolicyApplyInput, SubaccountPolicyCreateInput, SubaccountPolicyUpdateInput } from "./services/policies/subaccount-policies/subaccount-policies.schemas.js";
+import { CreateSubaccountInput, CreateSubaccountResult as CreateSubaccountResult$1, InviteSubaccountMemberInput, ListSubaccountInvitesInput, RemoveSubaccountMemberInput, RespondSubaccountInviteInput, SetSubaccountMemberMfaRequirementInput, Subaccount, SubaccountActivityInput, SubaccountEvent, SubaccountIdInput, SubaccountInvite, SubaccountInviteStatus, SubaccountMember, SubaccountRole, SubaccountStatus, UpdateSubaccountInput, UpdateSubaccountMemberRoleInput } from "./services/subaccounts/subaccounts.schemas.js";
+import { Candle, CandleColumnar, CandleColumnarInt, CandleInt, GetCandlesColumnsInput, GetCandlesInput, Timeframe } from "./services/candles/candles.schemas.js";
+import { ChainAnalyticsRange, GetUnifiedAssetBalancesInput, GetZippedAssetSupplyGroupInput, GetZippedAssetSupplyInput, UnifiedAssetBalancesResponse, ZippedAssetSupplyGroupResponse, ZippedAssetSupplyResponse, ZippedAssetSupplySeries } from "./services/chain-analytics/chain-analytics.schemas.js";
+import { GetMarketTradesInput, MarketTrade } from "./services/market-data/market-data.schemas.js";
+import { ListMarketOverviewInput, MarketOverview, MarketOverviewOrderBy, MarketOverviewSort, MarketOverviewSparkline, SparklineIntervalName } from "./services/market-overview/market-overview.schemas.js";
+import { GetOrderbookInput, OrderbookData, OrderbookLevel } from "./services/orderbook/orderbook.schemas.js";
+import { CreateOrderbookSubscriptionInput, OrderbookStreamHandlers, OrderbookSubscription } from "./services/orderbook/orderbook.js";
+import { HeatmapDepthValue, HeatmapIntervalValue, HeatmapQuantityModeValue } from "./services/heatmap/heatmap.codecs.js";
+import { GetOrderbookHeatmapInput, OrderbookHeatmapDeltaBucket, OrderbookHeatmapDeltaChain, OrderbookHeatmapDeltaLevels, OrderbookHeatmapKeyframe, OrderbookHeatmapLevels, OrderbookHeatmapLiveBucket, OrderbookHeatmapResponse } from "./services/heatmap/heatmap.schemas.js";
+import { GetLifecycleFlowInput, GetLifecycleFlowOutput, LifecycleAssetIds, LifecycleFlowDetail, LifecycleFlowState, LifecycleFlowStep, LifecycleFlowStepActivity, LifecycleFlowSummary, LifecycleFlowSummaryProgress, LifecycleFlowTimelineItem, LifecycleFlowTxMatch, LifecycleListOrderBy, LifecycleListScope, LifecycleReason, LifecycleRequestFee, LifecycleRequestFeeStatus, LifecycleSort, LifecycleTxLookupKind, LifecycleZipperReason, ListLifecycleFlowsByTxInput, ListLifecycleFlowsByTxOutput, ListLifecycleFlowsInput, ListLifecycleFlowsOutput } from "./services/lifecycle/lifecycle.schemas.js";
+import { GetUserTradesInput, Trade } from "./services/trades/trades.schemas.js";
+import { CancelAllOrdersInput, CancelAllOrdersResponse, CancelOrderInput, CancelOrderResult, CreateOrderResult, GetOrderDetailsInput, NewOrderInput, OpenOrdersInput, OrderHistoryInput, OrderIntentInput, PreviewOrderResult } from "./services/orders/orders-input.schemas.js";
+import { ModifyOrderInput, ModifyOrderResult } from "./services/orders/orders-modify.schemas.js";
+import { RiskPolicyInput, StopLossInput, TakeProfitInput, TrailingStopInput } from "./services/orders/orders-risk.schemas.js";
+import { BatchCancelOrderInput, BatchCancelOrderResult, BatchCancelOrdersInput, BatchCancelOrdersResult, BatchCreateOrderResult, BatchCreateOrdersInput, BatchCreateOrdersResult, BatchReplaceAdmissionItem, BatchReplaceOrdersInput, BatchReplaceOrdersResult, CancelAllAfterInput, CancelAllAfterResult, GetBatchReplaceStatusInput, GetBatchReplaceStatusResult } from "./services/orders/orders-batch.schemas.js";
+import { OrderErrorCode } from "./services/orders/order-errors.schemas.js";
+import { Order, OrderDetails, OrderTransfer } from "./services/orders/orders-output.schemas.js";
+import { CancelTriggerInput, CreateTriggerInput, GetTriggerInput, ListTriggerEventsInput, ListTriggersInput, ModifyTriggerInput } from "./services/triggers/trigger-input.schemas.js";
+import { CancelTriggerResult, CreateTriggerResult, LadderDetailsOutput, ListTriggerEventsResult, ModifyTriggerResult, StopDetailsOutput, TrailingDetailsOutput, Trigger, TriggerDetailsOutput, TriggerEvent, TwapDetailsOutput } from "./services/triggers/triggers-output.schemas.js";
+import { ListTriggersResult } from "./services/triggers/triggers.js";
+import { AccountCodeValue, TransferCodeValue } from "./shared/ledger-codes.js";
+import { BalanceHistoryInput, BalanceHistoryResponse, BalanceRange, EquityGroupBy, EquityHistoryInput, EquityHistoryResponse, EquitySeries, EquitySeriesGrouping, LedgerBalance } from "./services/balances/balances.schemas.js";
+import { mergeLedgerBalances } from "./services/balances/balances.merge.js";
+import { LedgerTransfer, LedgerTransferSide, ListTransfersInput } from "./services/transfers/transfers.schemas.js";
+import { TransferSideKind } from "./services/transfers/transfers.codecs.js";
+import { CreateInternalTransferInput, CreateInternalTransferResult, InternalTransferDestination, ResolvedInternalTransferDestination } from "./services/internal-transfers/internal-transfers.schemas.js";
+import { CreateTradingWithdrawResult, CreateTradingWithdrawToExternalChainInput, CreateTradingWithdrawToFundingInput } from "./services/trading-withdraws/trading-withdraws.schemas.js";
+import { CreateTradingWithdrawToExternalChainServiceInput, CreateTradingWithdrawToFundingServiceInput, PreparedTradingWithdraw, TradingWithdrawSigningConfig, TradingWithdrawWalletSigner, TradingWithdrawWalletTypedData } from "./services/trading-withdraws/trading-withdraws.js";
+import { CreateDepositAddressInput, DepositAddress, ListDepositAddressesInput } from "./services/deposit/deposit.schemas.js";
+import { AddressBook, AddressBookEntries, AddressBookEntriesView, AddressBookEntry, AddressBookRecentDestinationsView, AddressBookTag, AddressBookTagSummary, AddressBookView, AddressBookViewInvalidated, CopyAddressBookEntryInput, CreateAddressBookEntryInput, CreateAddressBookTagInput, DeleteAddressBookEntryInput, DeleteAddressBookTagInput, GetAddressBookViewInput, InternalTransferWhitelistEntries, InternalTransferWhitelistEntry, ListAddressBookEntriesInput, ListInternalTransferWhitelistEntriesInput, ListTransferCounterpartiesInput, ListTransferDestinationsInput, MirroredWithdrawWhitelistEntry, SubaccountScopedInput, TransferCounterparties, TransferCounterparty, TransferDestination, TransferDestinations, UpdateAddressBookEntryInput, UpdateAddressBookTagInput, WithdrawWhitelistView, validateCreateAddressBookEntryInput } from "./services/address-book/address-book.schemas.js";
+import { BatchGuardApprovals, BatchSignProtectedActionInput, CreateGuardSignerWalletResult, ExportGuardSignerWalletResult, GuardApproval, GuardSignerScopedInput, GuardSignerStatus, RotateGuardSignerWalletResult, SignProtectedActionInput } from "./services/guard-signer/guard-signer.schemas.js";
+import { GetVerificationResponse, SocialProvider, SocialProviderInput, SocialVerification, SocialVerificationMethod, SocialVerificationStatus, StartVerificationInput, StartVerificationResponse, VerificationReadyResponse } from "./services/social-verification/social-verification.schemas.js";
+import { ArchiveWhiteboardBoardInput, ArchiveWhiteboardBoardResult, CreateWhiteboardBoardInput, CreateWhiteboardBoardResult, GetWhiteboardBoardInput, GetWhiteboardBoardResult, ListWhiteboardBoardsInput, ListWhiteboardBoardsResult, MintWhiteboardJoinTokenInput, UpdateWhiteboardBoardAclInput, UpdateWhiteboardBoardAclResult, UpdateWhiteboardBoardInput, UpdateWhiteboardBoardResult, WhiteboardAccess, WhiteboardAclEntry, WhiteboardAclEntryInput, WhiteboardAclSubjectType, WhiteboardAudience, WhiteboardBoard, WhiteboardBoardDetails, WhiteboardBoardListItem, WhiteboardJoinTokenResult, WhiteboardPermissions, WhiteboardPresencePayload, WhiteboardResolvedRole, WhiteboardSnapshot, WhiteboardWritableRole } from "./services/whiteboard/whiteboard.schemas.js";
+import { ZippedAssetSupplyBatch, ZippedAssetSupplyUpdate } from "./services/zipper/zipper.schemas.js";
+import { SubscribeZippedAssetSupplyInput } from "./services/zipper/zipper.js";
+import { BeginMfaChallengeInput, BeginMfaChallengeResult, BeginPasskeyEnrollmentInput, BeginPasskeyEnrollmentResult, BeginTotpEnrollmentInput, BeginTotpEnrollmentResult, ClaimFreshStepUpInput, ClaimFreshStepUpResult, CompleteMfaChallengeResult, ConsumeFreshStepUpInput, DeleteMfaFactorInput, FinishPasskeyChallengeInput, FinishPasskeyEnrollmentInput, FinishPasskeyEnrollmentResult, FinishTotpEnrollmentInput, FinishTotpEnrollmentResult, ListMfaFactorsResult, MfaFactor, MfaSessionInfo, RegenerateRecoveryCodesInput, RegenerateRecoveryCodesResult, ReleaseFreshStepUpInput, UpdateMfaFactorInput, UpdateMfaFactorResult, VerifyRecoveryCodeChallengeInput, VerifyTotpChallengeInput } from "./services/mfa/mfa.schemas.js";
+import { PolyesterClient, PolyesterClientBaseConfig, PolyesterClientConfig, PolyesterRealtimeAuthConfig } from "./core-client.js";
+import { AuthTokenStorage, AuthTokenStorageSetOptions, CookieAuthTokenStorageOptions, createCookieAuthTokenStorage, createMemoryAuthTokenStorage } from "./services/auth/token-storage.js";
+import { ActiveAccountInfo, AuthHydrationData, AuthLoginMethod, AuthState, ServerSessionSnapshot, SessionData } from "./services/auth/session.types.js";
+import { AccountSignerAuthEvents, CreateSubaccountParams, CreateSubaccountResult, LoginOptions, LoginResult } from "./services/auth/account-signer-auth.js";
+import { PolyesterBrowserClient, PolyesterBrowserClientConfig } from "./browser-client.js";
+import { POLYESTER_AUTH_TOKEN_COOKIE_NAME, POLYESTER_SESSION_COOKIE_NAME } from "./services/auth/cookie-constants.js";
+import { CreateServerClientFromCookiesParams, CreateServerClientFromRequestParams, PolyesterServerClient, PolyesterServerClientConfig, createPolyesterServerClientFromCookies, createPolyesterServerClientFromRequest } from "./server-client.js";
+import { connectErrorToPolyesterError, createErrorMappingInterceptor, toPolyesterError } from "./shared/connect-error-mapping.js";
+import { isFreshStepUpRequiredError, isMfaEnrollmentRequiredError, isMfaLastFactorRequiredError, isSessionElevationRequiredError } from "./utils/connect-mfa-errors.js";
+import { isStaleQuoteError } from "./utils/connect-order-errors.js";
+import { formatConnectError, formatUserFacingError, isPolicyInUseError, isPolicyLockedError, isPolicyScopeMismatchError, isResourceNotFoundError, isRetryableError, isRevisionConflictError } from "./utils/errors.js";
+import { ColumnarTimeWindow, columnarTimestampSecAt, expandColumnarTimestampsSec } from "./utils/columnar-time.js";
+import { compareUnsignedIntegerStrings, shouldApplyReconciliationUpdate } from "./shared/reconciliation.js";
+import { tsObjToNsString } from "./utils/time.js";
+import { EvmHex, checksumEvmAddress, evmHexToBytes, evmUtf8ToBytes, evmUtf8ToHex, isEvmAddress, isEvmAddressStrict, keccak256Hex } from "./utils/evm.js";
+import "./services/accounts/accounts.types.js";
+import "./services/address-book/address-book.types.js";
+import "./services/api-keys/api-keys.types.js";
+import "./services/auth/auth.types.js";
+import "./services/auth/profile/profile.types.js";
+import "./services/balances/balances.types.js";
+import "./services/candles/candles.types.js";
+import "./services/chain-analytics/chain-analytics.types.js";
+import "./services/deposit/deposit.types.js";
+import "./services/guard-signer/guard-signer.types.js";
+import "./services/heatmap/heatmap.types.js";
+import "./services/internal-transfers/internal-transfers.types.js";
+import "./services/lifecycle/lifecycle.types.js";
+import "./services/market-data/market-data.types.js";
+import "./services/market-overview/market-overview.types.js";
+import "./services/mfa/mfa.types.js";
+import "./services/orderbook/orderbook.types.js";
+import "./services/orders/orders.types.js";
+import "./services/policies/api-key-policies/api-key-policies.types.js";
+import { PolicyAction, PolicyMarketScope } from "./services/policies/shared.js";
+import "./services/policies/policies.types.js";
+import "./services/policies/subaccount-policies/subaccount-policies.types.js";
+import "./services/social-verification/social-verification.types.js";
+import "./services/subaccounts/subaccounts.types.js";
+import "./services/trades/trades.types.js";
+import "./services/trading-withdraws/trading-withdraws.types.js";
+import "./services/transfers/transfers.types.js";
+import "./services/triggers/triggers.types.js";
+import "./services/whiteboard/whiteboard.types.js";
+import "./services/zipper/zipper.types.js";
+export { type AccountCodeValue, type AccountIdentity, type AccountScope, type AccountScopedInput, type AccountSigner, type AccountSignerAuthEvents, type AccountSignerConfig, type CreateSubaccountResult as AccountSignerCreateSubaccountResult, type AccountSignerFactory, type ActiveAccountInfo, type AddressBook, type AddressBookEntries, type AddressBookEntriesView, type AddressBookEntry, type AddressBookRecentDestinationsView, type AddressBookTag, type AddressBookTagSummary, type AddressBookView, type AddressBookViewInvalidated, AlreadyExistsError, type ApiKey, type ApiKeyEd25519AuthProvider, type ApiKeyIdInput, type ApiKeyPolicy, type ApiKeyPolicyApplyInput, type ApiKeyPolicyCreateInput, type ApiKeyPolicyUpdateInput, type ApiKeyStatus, type ApiKeysCreateInput, type ApiKeysListInput, type ApiKeysUpdateInput, type ArchiveWhiteboardBoardInput, type ArchiveWhiteboardBoardResult, type AssetConfig, type AuthHydrationData, type AuthLoginMethod, type AuthState, type AuthTokenStorage, type AuthTokenStorageSetOptions, AuthenticationError, type BalanceHistoryInput, type BalanceHistoryResponse, type BalanceRange, type BatchCancelOrderInput, type BatchCancelOrderResult, type BatchCancelOrdersInput, type BatchCancelOrdersResult, type BatchCreateOrderResult, type BatchCreateOrdersInput, type BatchCreateOrdersResult, type BatchGuardApprovals, type BatchReplaceAdmissionItem, type BatchReplaceOrdersInput, type BatchReplaceOrdersResult, type BatchSignProtectedActionInput, type BeginMfaChallengeInput, type BeginMfaChallengeResult, type BeginPasskeyEnrollmentInput, type BeginPasskeyEnrollmentResult, type BeginTotpEnrollmentInput, type BeginTotpEnrollmentResult, type CancelAllAfterInput, type CancelAllAfterResult, type CancelAllOrdersInput, type CancelAllOrdersResponse, type CancelOrderInput, type CancelOrderResult, type CancelTriggerInput, type CancelTriggerResult, type Candle, type CandleColumnar, type CandleColumnarInt, type CandleInt, type ChainAnalyticsRange, type ClaimFreshStepUpInput, type ClaimFreshStepUpResult, type ColumnarTimeWindow, type CompleteMfaChallengeResult, ConfigurationError, type ConnectChannelParams, type ConsumeFreshStepUpInput, type CookieAuthTokenStorageOptions, type CopyAddressBookEntryInput, type CreateAddressBookEntryInput, type CreateAddressBookTagInput, type CreateDepositAddressInput, type CreateGuardSignerWalletResult, type CreateInternalTransferInput, type CreateInternalTransferResult, type CreateOrderResult, type CreateOrderbookSubscriptionInput, type CreatePolyesterAccountSignerParams, type CreatePolyesterEnvironmentParams, type CreateServerClientFromCookiesParams, type CreateServerClientFromRequestParams, type CreateSubaccountInput, type CreateSubaccountParams, type CreateSubaccountResult$1 as CreateSubaccountResult, type CreateSubaccountResult$1 as CreateSubaccountServiceResult, type CreateTradingWithdrawResult, type CreateTradingWithdrawToExternalChainInput, type CreateTradingWithdrawToExternalChainServiceInput, type CreateTradingWithdrawToFundingInput, type CreateTradingWithdrawToFundingServiceInput, type CreateTriggerInput, type CreateTriggerResult, type CreateWhiteboardBoardInput, type CreateWhiteboardBoardResult, type DeleteAddressBookEntryInput, type DeleteAddressBookTagInput, type DeleteMfaFactorInput, type DepositAddress, type DepositWithdrawConfig, type EquityGroupBy, type EquityHistoryInput, type EquityHistoryResponse, type EquitySeries, type EquitySeriesGrouping, type EvmHex, type ExportGuardSignerWalletResult, type FinishPasskeyChallengeInput, type FinishPasskeyEnrollmentInput, type FinishPasskeyEnrollmentResult, type FinishTotpEnrollmentInput, type FinishTotpEnrollmentResult, type GetAddressBookViewInput, type GetBatchReplaceStatusInput, type GetBatchReplaceStatusResult, type GetCandlesColumnsInput, type GetCandlesInput, type GetLifecycleFlowInput, type GetLifecycleFlowOutput, type GetMarketTradesInput, type GetOrderDetailsInput, type GetOrderbookHeatmapInput, type GetOrderbookInput, type GetTriggerInput, type GetUnifiedAssetBalancesInput, type GetUserTradesInput, type GetVerificationResponse, type GetWhiteboardBoardInput, type GetWhiteboardBoardResult, type GetZippedAssetSupplyGroupInput, type GetZippedAssetSupplyInput, type GuardApproval, type GuardSignerScopedInput, type GuardSignerStatus, type HeatmapDepthValue, type HeatmapIntervalValue, type HeatmapQuantityModeValue, type HexAddress, InternalServerError, type InternalTransferDestination, type InternalTransferWhitelistEntries, type InternalTransferWhitelistEntry, type InviteSubaccountMemberInput, type JwtAuthProvider, type LadderDetailsOutput, type LedgerBalance, type LedgerTransfer, type LedgerTransferSide, type LifecycleAssetIds, type LifecycleFlowDetail, type LifecycleFlowState, type LifecycleFlowStep, type LifecycleFlowStepActivity, type LifecycleFlowSummary, type LifecycleFlowSummaryProgress, type LifecycleFlowTimelineItem, type LifecycleFlowTxMatch, type LifecycleListOrderBy, type LifecycleListScope, type LifecycleReason, type LifecycleRequestFee, type LifecycleRequestFeeStatus, type LifecycleSort, type LifecycleTxLookupKind, type LifecycleZipperReason, type ListAddressBookEntriesInput, type ListApiKeyPoliciesResponse, type ListDepositAddressesInput, type ListInternalTransferWhitelistEntriesInput, type ListLifecycleFlowsByTxInput, type ListLifecycleFlowsByTxOutput, type ListLifecycleFlowsInput, type ListLifecycleFlowsOutput, type ListMarketOverviewInput, type ListMfaFactorsResult, type ListSubaccountInvitesInput, type ListTransferCounterpartiesInput, type ListTransferDestinationsInput, type ListTransfersInput, type ListTriggerEventsInput, type ListTriggerEventsResult, type ListTriggersInput, type ListTriggersResult, type ListWhiteboardBoardsInput, type ListWhiteboardBoardsResult, type LoginOptions, type LoginResult, type LoginWithWalletInput, type LoginWithWalletResponse, type MarketOverview, type MarketOverviewOrderBy, type MarketOverviewSort, type MarketOverviewSparkline, type MarketTrade, type Me, MfaEnrollmentRequiredError, type MfaFactor, MfaLastFactorRequiredError, MfaRequiredError, type MfaSessionInfo, MfaVerificationError, type MfaVerificationFailureReason, type MintWhiteboardJoinTokenInput, type MirroredWithdrawWhitelistEntry, type ModifyOrderInput, type ModifyOrderResult, type ModifyTriggerInput, type ModifyTriggerResult, NetworkError, type NewOrderInput, type Nonce, type OpenOrdersInput, type Order, type OrderDetails, type OrderErrorCode, type OrderHistoryInput, type OrderIntentInput, type OrderTransfer, type OrderbookData, type OrderbookHeatmapDeltaBucket, type OrderbookHeatmapDeltaChain, type OrderbookHeatmapDeltaLevels, type OrderbookHeatmapKeyframe, type OrderbookHeatmapLevels, type OrderbookHeatmapLiveBucket, type OrderbookHeatmapResponse, type OrderbookLevel, type OrderbookStreamHandlers, type OrderbookSubscription, POLYESTER_AUTH_TOKEN_COOKIE_NAME, POLYESTER_SESSION_COOKIE_NAME, POLYESTER_TESTNET_ENVIRONMENT, type PairConfig, type PairStatus, PermissionError, type PolicyAction, PolicyInUseError, PolicyLockedError, type PolicyMarketScope, PolicyScopeMismatchError, type PolyesterAccountAbstractionEnvironment, PolyesterBrowserClient, type PolyesterBrowserClientConfig, PolyesterClient, type PolyesterClientBaseConfig, type PolyesterClientConfig, type PolyesterContractsEnvironment, type PolyesterEntryPointConfig, type PolyesterEnvironment, PolyesterError, type PolyesterErrorCode, type PolyesterErrorOptions, type PolyesterMutationOptions, type PolyesterRealtime, type PolyesterRealtimeAuthConfig, type PolyesterRequestOptions, type PolyesterSafeDeploymentConfig, PolyesterServerClient, type PolyesterServerClientConfig, PreconditionFailedError, type PreparedTradingWithdraw, type PreviewOrderResult, type Profile, RateLimitError, type RateLimitErrorOptions, type RegenerateRecoveryCodesInput, type RegenerateRecoveryCodesResult, type ReleaseFreshStepUpInput, type RemoveSubaccountMemberInput, RequestError, type ResolveAccountInput, type ResolvedAccount, type ResolvedInternalTransferDestination, ResourceNotFoundError, type RespondSubaccountInviteInput, RevisionConflictError, type RiskPolicyInput, type RotateGuardSignerWalletResult, type SdkSubscriptionErrorContext, type ServerSessionSnapshot, ServiceUnavailableError, type SessionData, SessionElevationRequiredError, type SetSubaccountMemberMfaRequirementInput, type SignProtectedActionInput, type SocialProvider, type SocialProviderInput, type SocialVerification, type SocialVerificationMethod, type SocialVerificationStatus, type SparklineIntervalName, type SpotConfig, StaleQuoteError, type StartVerificationInput, type StartVerificationResponse, StepUpRequiredError, type StopDetailsOutput, type StopLossInput, type Subaccount, type SubaccountActivityInput, type SubaccountEvent, type SubaccountIdInput, type SubaccountInvite, type SubaccountInviteStatus, type SubaccountMember, type SubaccountPolicy, type SubaccountPolicyApplyInput, type SubaccountPolicyCreateInput, type SubaccountPolicyUpdateInput, type SubaccountRole, type SubaccountScopedInput, type SubaccountStatus, type SubscribeHandlers, type SubscribeZippedAssetSupplyInput, type TakeProfitInput, type Timeframe, TimeoutError, type Trade, type TradingWithdrawSigningConfig, type TradingWithdrawWalletSigner, type TradingWithdrawWalletTypedData, type TrailingDetailsOutput, type TrailingStopInput, type TransferCodeValue, type TransferCounterparties, type TransferCounterparty, type TransferDestination, type TransferDestinations, type TransferSideKind, TransientError, type Transports, type Trigger, type TriggerDetailsOutput, type TriggerEvent, type TwapDetailsOutput, type UnifiedAssetBalancesResponse, type UpdateAddressBookEntryInput, type UpdateAddressBookTagInput, type UpdateMfaFactorInput, type UpdateMfaFactorResult, type UpdateProfileInput, type UpdateSubaccountInput, type UpdateSubaccountMemberRoleInput, type UpdateWhiteboardBoardAclInput, type UpdateWhiteboardBoardAclResult, type UpdateWhiteboardBoardInput, type UpdateWhiteboardBoardResult, type UsernameHistoryEntry, ValidationError, type VerificationReadyResponse, type VerifyRecoveryCodeChallengeInput, type VerifyTotpChallengeInput, type WhiteboardAccess, type WhiteboardAclEntry, type WhiteboardAclEntryInput, type WhiteboardAclSubjectType, type WhiteboardAudience, type WhiteboardBoard, type WhiteboardBoardDetails, type WhiteboardBoardListItem, type WhiteboardJoinTokenResult, type WhiteboardPermissions, type WhiteboardPresencePayload, type WhiteboardResolvedRole, type WhiteboardSnapshot, type WhiteboardWritableRole, type WithdrawWhitelistView, type ZippedAssetSupplyBatch, type ZippedAssetSupplyGroupResponse, type ZippedAssetSupplyResponse, type ZippedAssetSupplySeries, type ZippedAssetSupplyUpdate, type ZipperAssetChainVariant, type ZipperAssetConfig, type ZipperChainConfig, type ZipperChainContractConfig, checksumEvmAddress, columnarTimestampSecAt, compareUnsignedIntegerStrings, connectErrorToPolyesterError, createCookieAuthTokenStorage, createErrorMappingInterceptor, createMemoryAuthTokenStorage, createPolyesterEnvironment, createPolyesterServerClientFromCookies, createPolyesterServerClientFromRequest, errorFromHttpStatus, evmHexToBytes, evmUtf8ToBytes, evmUtf8ToHex, expandColumnarTimestampsSec, formatConnectError, formatUserFacingError, isAbortError, isEvmAddress, isEvmAddressStrict, isFreshStepUpRequiredError, isMfaEnrollmentRequiredError, isMfaLastFactorRequiredError, isPolicyInUseError, isPolicyLockedError, isPolicyScopeMismatchError, isResourceNotFoundError, isRetryableError, isRevisionConflictError, isSessionElevationRequiredError, isStaleQuoteError, keccak256Hex, mergeLedgerBalances, normalizeErrorMessage, shouldApplyReconciliationUpdate, tsObjToNsString as timestampToNanoseconds, toPolyesterError, validateCreateAddressBookEntryInput };

package/dist/index.js

@@ -0,0 +1,18 @@
+import { AlreadyExistsError, AuthenticationError, ConfigurationError, InternalServerError, MfaEnrollmentRequiredError, MfaLastFactorRequiredError, MfaRequiredError, MfaVerificationError, NetworkError, PermissionError, PolicyInUseError, PolicyLockedError, PolicyScopeMismatchError, PolyesterError, PreconditionFailedError, RateLimitError, RequestError, ResourceNotFoundError, RevisionConflictError, ServiceUnavailableError, SessionElevationRequiredError, StaleQuoteError, StepUpRequiredError, TimeoutError, TransientError, ValidationError, errorFromHttpStatus, isAbortError, normalizeErrorMessage } from "./shared/errors.js";
+import { connectErrorToPolyesterError, createErrorMappingInterceptor, toPolyesterError } from "./shared/connect-error-mapping.js";
+import { tsObjToNsString } from "./utils/time.js";
+import { formatConnectError, formatUserFacingError, isPolicyInUseError, isPolicyLockedError, isPolicyScopeMismatchError, isResourceNotFoundError, isRetryableError, isRevisionConflictError } from "./utils/errors.js";
+import { compareUnsignedIntegerStrings, shouldApplyReconciliationUpdate } from "./shared/reconciliation.js";
+import { mergeLedgerBalances } from "./services/balances/balances.merge.js";
+import { checksumEvmAddress, evmHexToBytes, evmUtf8ToBytes, evmUtf8ToHex, isEvmAddress, isEvmAddressStrict, keccak256Hex } from "./utils/evm.js";
+import { validateCreateAddressBookEntryInput } from "./services/address-book/address-book.schemas.js";
+import { PolyesterClient } from "./core-client.js";
+import { POLYESTER_AUTH_TOKEN_COOKIE_NAME, POLYESTER_SESSION_COOKIE_NAME } from "./services/auth/cookie-constants.js";
+import { createCookieAuthTokenStorage, createMemoryAuthTokenStorage } from "./services/auth/token-storage.js";
+import { PolyesterBrowserClient } from "./browser-client.js";
+import { PolyesterServerClient, createPolyesterServerClientFromCookies, createPolyesterServerClientFromRequest } from "./server-client.js";
+import { POLYESTER_TESTNET_ENVIRONMENT, createPolyesterEnvironment } from "./environment.js";
+import { isFreshStepUpRequiredError, isMfaEnrollmentRequiredError, isMfaLastFactorRequiredError, isSessionElevationRequiredError } from "./utils/connect-mfa-errors.js";
+import { isStaleQuoteError } from "./utils/connect-order-errors.js";
+import { columnarTimestampSecAt, expandColumnarTimestampsSec } from "./utils/columnar-time.js";
+export { AlreadyExistsError, AuthenticationError, ConfigurationError, InternalServerError, MfaEnrollmentRequiredError, MfaLastFactorRequiredError, MfaRequiredError, MfaVerificationError, NetworkError, POLYESTER_AUTH_TOKEN_COOKIE_NAME, POLYESTER_SESSION_COOKIE_NAME, POLYESTER_TESTNET_ENVIRONMENT, PermissionError, PolicyInUseError, PolicyLockedError, PolicyScopeMismatchError, PolyesterBrowserClient, PolyesterClient, PolyesterError, PolyesterServerClient, PreconditionFailedError, RateLimitError, RequestError, ResourceNotFoundError, RevisionConflictError, ServiceUnavailableError, SessionElevationRequiredError, StaleQuoteError, StepUpRequiredError, TimeoutError, TransientError, ValidationError, checksumEvmAddress, columnarTimestampSecAt, compareUnsignedIntegerStrings, connectErrorToPolyesterError, createCookieAuthTokenStorage, createErrorMappingInterceptor, createMemoryAuthTokenStorage, createPolyesterEnvironment, createPolyesterServerClientFromCookies, createPolyesterServerClientFromRequest, errorFromHttpStatus, evmHexToBytes, evmUtf8ToBytes, evmUtf8ToHex, expandColumnarTimestampsSec, formatConnectError, formatUserFacingError, isAbortError, isEvmAddress, isEvmAddressStrict, isFreshStepUpRequiredError, isMfaEnrollmentRequiredError, isMfaLastFactorRequiredError, isPolicyInUseError, isPolicyLockedError, isPolicyScopeMismatchError, isResourceNotFoundError, isRetryableError, isRevisionConflictError, isSessionElevationRequiredError, isStaleQuoteError, keccak256Hex, mergeLedgerBalances, normalizeErrorMessage, shouldApplyReconciliationUpdate, tsObjToNsString as timestampToNanoseconds, toPolyesterError, validateCreateAddressBookEntryInput };

package/dist/realtime/client.d.ts

@@ -0,0 +1,18 @@
+import { ConnectChannelParams, PolyesterRealtime, SubscribeHandlers } from "./types.js";
+import { DescMessage } from "@bufbuild/protobuf";
+import "centrifuge/build/protobuf";
+//#region src/realtime/client.d.ts
+interface RealtimeAuthRequest {
+  url: string | URL;
+  method: string;
+}
+interface RealtimeConfig {
+  wsUrl: string;
+  tokenEndpoint: string;
+  subscribeEndpoint: string;
+  getAuthHeaders?: (request: RealtimeAuthRequest) => Promise<HeadersInit> | HeadersInit;
+  hasAuth?: () => boolean;
+}
+//#endregion
+export { type ConnectChannelParams, RealtimeAuthRequest, RealtimeConfig, type SubscribeHandlers };
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","names":[],"sources":["../../src/realtime/client.ts"],"mappings":";;;;UA6CiB;EACb,cAAc;EACd;;UAGa;EACb;EACA;EACA;EACA,kBAAkB,SAAS,wBAAwB,QAAQ,eAAe;EAC1E"}

package/dist/realtime/client.js

@@ -0,0 +1,420 @@
+import { AuthenticationError, InternalServerError, errorFromHttpStatus } from "../shared/errors.js";
+import { makeFetch } from "../shared/transports.js";
+import { createSdkSubscriptionErrorContext, fromCentrifugeSubscriptionError } from "../shared/subscription-errors.js";
+import { decodeProtoFrame } from "../utils/streams.js";
+import { fromBinary } from "@bufbuild/protobuf";
+//#region src/realtime/client.ts
+const realtimeFetch = makeFetch();
+let centrifugeCtorPromise = null;
+let loadedCentrifugeCtor = null;
+function loadCentrifuge() {
+	if (import.meta.env?.SSR) return Promise.reject(/* @__PURE__ */ new Error("Realtime subscriptions are browser-only during SSR."));
+	centrifugeCtorPromise ??= import("centrifuge/build/protobuf").then((mod) => {
+		loadedCentrifugeCtor = mod.Centrifuge;
+		return mod.Centrifuge;
+	});
+	return centrifugeCtorPromise;
+}
+/**
+* Shared Centrifuge realtime client that multiplexes public and private protobuf subscriptions across SDK services.
+*/
+var RealtimeClient = class {
+	#publicClient = null;
+	#privateClient = null;
+	#connectionHandlers = /* @__PURE__ */ new Set();
+	#sharedSubs = /* @__PURE__ */ new Map();
+	#pendingTeardowns = /* @__PURE__ */ new Map();
+	#config;
+	constructor(config) {
+		this.#config = {
+			wsUrl: config.wsUrl,
+			tokenEndpoint: config.tokenEndpoint,
+			subscribeEndpoint: config.subscribeEndpoint,
+			getAuthHeaders: config.getAuthHeaders ?? (() => ({})),
+			hasAuth: config.hasAuth ?? (() => false)
+		};
+	}
+	async #getAuthHeaders(request) {
+		return this.#config.getAuthHeaders(request);
+	}
+	#emitSubscriptionError(shared, type, error) {
+		const ctx = createSdkSubscriptionErrorContext(shared.channel, type, error);
+		for (const handler of shared.errorHandlers) handler(ctx);
+	}
+	#emitConnectionTokenError(error) {
+		for (const shared of this.#sharedSubs.values()) if (this.#channelKind(shared.channel) === "private") this.#emitSubscriptionError(shared, "connection_token", error);
+	}
+	#subscriptionOpts(shared, attachmentEpoch) {
+		if (this.#channelKind(shared.channel) !== "private") return void 0;
+		return { getToken: async () => {
+			try {
+				const url = new URL(this.#config.subscribeEndpoint);
+				url.searchParams.set("channel", shared.channel);
+				const headers = await this.#getAuthHeaders({
+					url,
+					method: "GET"
+				});
+				const res = await realtimeFetch(url, { headers });
+				if (!res.ok) throw errorFromHttpStatus(res.status, `Failed to fetch subscription token: ${res.status}`);
+				const json = await res.json();
+				if (!json?.token) throw new InternalServerError("Subscription token response had no token");
+				return json.token;
+			} catch (error) {
+				if (shared.attachmentEpoch === attachmentEpoch) this.#emitSubscriptionError(shared, "subscription_token", error);
+				throw error;
+			}
+		} };
+	}
+	#hasAuth() {
+		return this.#config.hasAuth();
+	}
+	#channelKind(channel) {
+		return channel.startsWith("private:") ? "private" : "public";
+	}
+	#createPublicClient(Centrifuge) {
+		const client = new Centrifuge(this.#config.wsUrl);
+		this.#publicClient = client;
+		client.on("connected", () => {
+			if (this.#publicClient !== client) return;
+			for (const h of this.#connectionHandlers) h.onConnected?.();
+		});
+		client.on("disconnected", () => {
+			if (this.#publicClient !== client) return;
+			for (const h of this.#connectionHandlers) h.onDisconnected?.();
+		});
+		client.connect();
+		return client;
+	}
+	#createPrivateClient(Centrifuge) {
+		let client;
+		client = new Centrifuge(this.#config.wsUrl, { getToken: async () => {
+			try {
+				const headers = await this.#getAuthHeaders({
+					url: this.#config.tokenEndpoint,
+					method: "GET"
+				});
+				const res = await realtimeFetch(this.#config.tokenEndpoint, { headers });
+				if (!res.ok) throw errorFromHttpStatus(res.status, `Failed to fetch connection token: ${res.status}`);
+				const json = await res.json();
+				if (!json?.token) throw new InternalServerError("Connection token response had no token");
+				return json.token;
+			} catch (error) {
+				if (this.#privateClient === client) this.#emitConnectionTokenError(error);
+				throw error;
+			}
+		} });
+		this.#privateClient = client;
+		client.on("connected", () => {
+			if (this.#privateClient !== client) return;
+			for (const h of this.#connectionHandlers) h.onConnected?.();
+		});
+		client.on("disconnected", () => {
+			if (this.#privateClient !== client) return;
+			for (const h of this.#connectionHandlers) h.onDisconnected?.();
+		});
+		client.connect();
+		return client;
+	}
+	#ensurePublicClient(Centrifuge) {
+		return this.#publicClient ?? this.#createPublicClient(Centrifuge);
+	}
+	#ensurePrivateClient(Centrifuge) {
+		if (!this.#hasAuth()) throw new AuthenticationError("Cannot create authenticated realtime client without authentication");
+		return this.#privateClient ?? this.#createPrivateClient(Centrifuge);
+	}
+	#assertChannelAuth(channel) {
+		if (this.#channelKind(channel) === "private" && !this.#hasAuth()) throw new AuthenticationError(`Cannot subscribe to private channel "${channel}" without authentication`);
+	}
+	#ensureClientForChannel(Centrifuge, channel) {
+		this.#assertChannelAuth(channel);
+		if (this.#channelKind(channel) === "private") return this.#ensurePrivateClient(Centrifuge);
+		return this.#ensurePublicClient(Centrifuge);
+	}
+	#attachSubscription(shared) {
+		if (shared.sub) return;
+		this.#assertChannelAuth(shared.channel);
+		const attachmentEpoch = shared.attachmentEpoch + 1;
+		shared.attachmentEpoch = attachmentEpoch;
+		if (loadedCentrifugeCtor) {
+			this.#attachSubscriptionNow(loadedCentrifugeCtor, shared, attachmentEpoch);
+			return;
+		}
+		this.#attachSubscriptionWhenLoaded(shared, attachmentEpoch);
+	}
+	async #attachSubscriptionWhenLoaded(shared, attachmentEpoch) {
+		let Centrifuge;
+		try {
+			Centrifuge = await loadCentrifuge();
+		} catch (error) {
+			if (shared.attachmentEpoch !== attachmentEpoch) return;
+			if (this.#sharedSubs.get(shared.channel) === shared) this.#sharedSubs.delete(shared.channel);
+			this.#emitSubscriptionError(shared, "transport_load", error);
+			return;
+		}
+		if (shared.attachmentEpoch !== attachmentEpoch || shared.sub) return;
+		if (this.#sharedSubs.get(shared.channel) !== shared) return;
+		try {
+			this.#attachSubscriptionNow(Centrifuge, shared, attachmentEpoch);
+		} catch (error) {
+			this.#sharedSubs.delete(shared.channel);
+			this.#emitSubscriptionError(shared, "auth", error);
+		}
+	}
+	#attachSubscriptionNow(Centrifuge, shared, attachmentEpoch) {
+		const client = this.#ensureClientForChannel(Centrifuge, shared.channel);
+		const sub = client.newSubscription(shared.channel, this.#subscriptionOpts(shared, attachmentEpoch));
+		shared.sub = sub;
+		shared.client = client;
+		sub.on("publication", (ctx) => {
+			if (shared.sub !== sub || shared.attachmentEpoch !== attachmentEpoch) return;
+			for (const handler of shared.publicationHandlers) handler(ctx.data);
+		});
+		sub.on("subscribed", () => {
+			if (shared.sub !== sub || shared.attachmentEpoch !== attachmentEpoch) return;
+			const subscriptionEpoch = ++shared.subscriptionEpoch;
+			for (const handler of shared.subscribedHandlers) handler(subscriptionEpoch);
+		});
+		sub.on("unsubscribed", () => {
+			if (shared.sub !== sub || shared.attachmentEpoch !== attachmentEpoch) return;
+			for (const handler of shared.unsubscribedHandlers) handler();
+		});
+		sub.on("error", (ctx) => {
+			if (shared.sub !== sub || shared.attachmentEpoch !== attachmentEpoch) return;
+			const sdkCtx = fromCentrifugeSubscriptionError(ctx);
+			for (const handler of shared.errorHandlers) handler(sdkCtx);
+		});
+		sub.subscribe();
+	}
+	#getOrCreateSubscription(channel) {
+		const existing = this.#sharedSubs.get(channel);
+		if (existing) return existing;
+		const pending = this.#pendingTeardowns.get(channel);
+		if (pending) {
+			this.#pendingTeardowns.delete(channel);
+			this.#sharedSubs.set(channel, pending);
+			if (!pending.sub) this.#attachSubscription(pending);
+			else if (pending.sub.state !== "subscribed") pending.sub.subscribe();
+			return pending;
+		}
+		const shared = {
+			channel,
+			sub: null,
+			client: null,
+			attachmentEpoch: 0,
+			consumers: 0,
+			subscriptionEpoch: 0,
+			publicationHandlers: /* @__PURE__ */ new Set(),
+			subscribedHandlers: /* @__PURE__ */ new Set(),
+			unsubscribedHandlers: /* @__PURE__ */ new Set(),
+			errorHandlers: /* @__PURE__ */ new Set()
+		};
+		this.#sharedSubs.set(channel, shared);
+		try {
+			this.#attachSubscription(shared);
+		} catch (error) {
+			this.#sharedSubs.delete(channel);
+			throw error;
+		}
+		return shared;
+	}
+	#callErrorHandler(handler, ctx) {
+		if (!handler) return;
+		try {
+			handler(ctx);
+		} catch {}
+	}
+	#callConsumerHandler(channel, type, handler, onError) {
+		try {
+			handler();
+		} catch (error) {
+			this.#callErrorHandler(onError, createSdkSubscriptionErrorContext(channel, type, error));
+		}
+	}
+	#teardownSubscription(shared) {
+		const sub = shared.sub;
+		const client = shared.client;
+		const kind = this.#channelKind(shared.channel);
+		shared.sub = null;
+		shared.client = null;
+		shared.attachmentEpoch++;
+		if (!sub) return;
+		try {
+			if (sub.state !== "unsubscribed") sub.unsubscribe();
+		} catch {}
+		try {
+			client?.removeSubscription?.(sub);
+		} catch {}
+		this.#disconnectClientIfIdle(kind);
+	}
+	#hasChannelsForKind(kind) {
+		for (const shared of this.#sharedSubs.values()) if (this.#channelKind(shared.channel) === kind) return true;
+		for (const shared of this.#pendingTeardowns.values()) if (this.#channelKind(shared.channel) === kind) return true;
+		return false;
+	}
+	#disconnectClientIfIdle(kind) {
+		if (this.#hasChannelsForKind(kind)) return;
+		const client = kind === "private" ? this.#privateClient : this.#publicClient;
+		if (kind === "private") this.#privateClient = null;
+		else this.#publicClient = null;
+		try {
+			client?.disconnect();
+		} catch {}
+	}
+	#disconnect() {
+		const publicClient = this.#publicClient;
+		const privateClient = this.#privateClient;
+		this.#pendingTeardowns.clear();
+		this.#sharedSubs.clear();
+		this.#publicClient = null;
+		this.#privateClient = null;
+		try {
+			publicClient?.disconnect();
+		} catch {}
+		try {
+			privateClient?.disconnect();
+		} catch {}
+		this.#connectionHandlers.clear();
+	}
+	#disconnectPrivate() {
+		const privateClient = this.#privateClient;
+		this.#privateClient = null;
+		for (const [channel, shared] of this.#sharedSubs) {
+			if (this.#channelKind(channel) !== "private") continue;
+			this.#sharedSubs.delete(channel);
+			this.#teardownSubscription(shared);
+		}
+		for (const [channel, shared] of this.#pendingTeardowns) {
+			if (this.#channelKind(channel) !== "private") continue;
+			this.#pendingTeardowns.delete(channel);
+			this.#teardownSubscription(shared);
+		}
+		try {
+			privateClient?.disconnect();
+		} catch {}
+	}
+	/**
+	* Subscribes to a realtime channel and returns an unsubscribe function.
+	*/
+	subscribe(channel, handlers) {
+		const shared = this.#getOrCreateSubscription(channel);
+		shared.consumers++;
+		const publicationHandler = handlers.onPublication;
+		const errorHandler = handlers.onError;
+		const subscribedHandler = handlers.onSubscribed;
+		const unsubscribedHandler = handlers.onUnsubscribed;
+		const onError = errorHandler ? (ctx) => this.#callErrorHandler(errorHandler, ctx) : void 0;
+		const onPub = (data) => {
+			this.#callConsumerHandler(channel, "publication_handler", () => publicationHandler(data), onError);
+		};
+		let lastSubscribedEpoch = -1;
+		const onSubscribed = subscribedHandler ? (subscriptionEpoch) => {
+			if (subscriptionEpoch <= lastSubscribedEpoch) return;
+			lastSubscribedEpoch = subscriptionEpoch;
+			this.#callConsumerHandler(channel, "subscribed_handler", subscribedHandler, onError);
+		} : void 0;
+		const onUnsubscribed = unsubscribedHandler ? () => this.#callConsumerHandler(channel, "unsubscribed_handler", unsubscribedHandler, onError) : void 0;
+		shared.publicationHandlers.add(onPub);
+		if (onSubscribed) shared.subscribedHandlers.add(onSubscribed);
+		if (onUnsubscribed) shared.unsubscribedHandlers.add(onUnsubscribed);
+		if (onError) shared.errorHandlers.add(onError);
+		let closed = false;
+		if (onSubscribed && shared.sub?.state === "subscribed") {
+			const subscriptionEpoch = shared.subscriptionEpoch;
+			queueMicrotask(() => {
+				if (closed || shared.sub?.state !== "subscribed") return;
+				onSubscribed(subscriptionEpoch);
+			});
+		}
+		return () => {
+			if (closed) return;
+			closed = true;
+			shared.publicationHandlers.delete(onPub);
+			if (onSubscribed) shared.subscribedHandlers.delete(onSubscribed);
+			if (onUnsubscribed) shared.unsubscribedHandlers.delete(onUnsubscribed);
+			if (onError) shared.errorHandlers.delete(onError);
+			shared.consumers--;
+			if (shared.consumers <= 0) {
+				if (this.#sharedSubs.get(channel) !== shared) return;
+				this.#sharedSubs.delete(channel);
+				this.#pendingTeardowns.set(channel, shared);
+				queueMicrotask(() => {
+					if (this.#pendingTeardowns.get(channel) !== shared) return;
+					this.#pendingTeardowns.delete(channel);
+					this.#teardownSubscription(shared);
+					if (this.#sharedSubs.size === 0 && this.#pendingTeardowns.size === 0) this.#disconnect();
+				});
+			}
+		};
+	}
+	/**
+	* Connects to a realtime channel with a custom message decoder.
+	*/
+	connectChannel(params) {
+		return this.subscribe(params.channel, {
+			onPublication: (data) => {
+				let decoded;
+				try {
+					decoded = fromBinary(params.schema, data);
+				} catch (error) {
+					this.#callErrorHandler(params.onError, createSdkSubscriptionErrorContext(params.channel, "decode", error));
+					return;
+				}
+				params.onPublication(decoded);
+			},
+			onSubscribed: params.onConnected,
+			onUnsubscribed: params.onDisconnected,
+			onError: params.onError
+		});
+	}
+	/**
+	* Connects to a realtime channel that emits protobuf messages.
+	*/
+	connectProtoChannel(params) {
+		return this.subscribe(params.channel, {
+			onPublication: (data) => {
+				let msg;
+				try {
+					msg = decodeProtoFrame(params.schema, data);
+				} catch (error) {
+					this.#callErrorHandler(params.onError, createSdkSubscriptionErrorContext(params.channel, "decode", error));
+					return;
+				}
+				if (!msg) {
+					this.#callErrorHandler(params.onError, createSdkSubscriptionErrorContext(params.channel, "decode", "Unable to decode protobuf frame"));
+					return;
+				}
+				params.onPublication(msg);
+			},
+			onSubscribed: params.onConnected,
+			onUnsubscribed: params.onDisconnected,
+			onError: params.onError
+		});
+	}
+	/**
+	* Disconnects the realtime client from all active channels.
+	*/
+	disconnect() {
+		this.#disconnect();
+	}
+	/**
+	* Disconnects authenticated realtime state without touching public channels.
+	*/
+	disconnectPrivate() {
+		this.#disconnectPrivate();
+	}
+	get isConnected() {
+		return this.#publicClient !== null || this.#privateClient !== null;
+	}
+	get activeChannels() {
+		return this.#sharedSubs.size;
+	}
+	get totalConsumers() {
+		let total = 0;
+		for (const shared of this.#sharedSubs.values()) total += shared.consumers;
+		return total;
+	}
+};
+//#endregion
+export { RealtimeClient };
+
+//# sourceMappingURL=client.js.map