entity-client 1.0.13 → 1.0.15

package/dist/EntityServerApi.d.ts

@@ -56,6 +56,19 @@ declare const EntityServerApi_base: {
         _refreshTimer: ReturnType<typeof setTimeout> | null;
         _healthTickTimer: ReturnType<typeof setInterval> | null;
         _healthTickPromise: Promise<unknown> | null;
+        realtimeEnabled: boolean;
+        realtimePath: string;
+        realtimeAutoConnect: boolean;
+        realtimeAutoReconnect: boolean;
+        realtimeReconnectDelayMs: number;
+        realtimeStatus: import("./types.js").RealtimeConnectionStatus;
+        _realtimeSocket: WebSocket | null;
+        _realtimeConnectPromise: Promise<void> | null;
+        _realtimeReconnectTimer: ReturnType<typeof setTimeout> | null;
+        _realtimeShouldReconnect: boolean;
+        _realtimeMessageListeners: Set<import("./types.js").RealtimeMessageListener>;
+        _realtimeStatusListeners: Set<import("./types.js").RealtimeStatusListener>;
+        _realtimeEventListeners: Map<string, Set<import("./types.js").RealtimeMessageListener>>;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
@@ -63,6 +76,17 @@ declare const EntityServerApi_base: {
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
         setCsrfEnabled(enabled: boolean): void;
+        addRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        addRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        removeRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        addRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        connectRealtime(): Promise<void>;
+        disconnectRealtime(reason?: string): void;
+        sendRealtime(message: import("./types.js").RealtimeEnvelope | Record<string, unknown>): boolean;
+        subscribeRealtime(subscriptions: string[]): boolean;
+        unsubscribeRealtime(subscriptions: string[]): boolean;
         startHealthTick(intervalMs?: number): void;
         stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
@@ -71,6 +95,12 @@ declare const EntityServerApi_base: {
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
+        _applyRealtimeOptions(options?: boolean | import("./types.js").RealtimeClientOptions): void;
+        _buildRealtimeUrl(): string;
+        _handleRealtimeMessage(payload: unknown): void;
+        _scheduleRealtimeReconnect(reason: string): void;
+        _clearRealtimeReconnectTimer(): void;
+        _setRealtimeStatus(status: import("./types.js").RealtimeConnectionStatus, reason?: string, error?: Error): void;
         _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;
@@ -114,6 +144,19 @@ declare const EntityServerApi_base: {
         _refreshTimer: ReturnType<typeof setTimeout> | null;
         _healthTickTimer: ReturnType<typeof setInterval> | null;
         _healthTickPromise: Promise<unknown> | null;
+        realtimeEnabled: boolean;
+        realtimePath: string;
+        realtimeAutoConnect: boolean;
+        realtimeAutoReconnect: boolean;
+        realtimeReconnectDelayMs: number;
+        realtimeStatus: import("./types.js").RealtimeConnectionStatus;
+        _realtimeSocket: WebSocket | null;
+        _realtimeConnectPromise: Promise<void> | null;
+        _realtimeReconnectTimer: ReturnType<typeof setTimeout> | null;
+        _realtimeShouldReconnect: boolean;
+        _realtimeMessageListeners: Set<import("./types.js").RealtimeMessageListener>;
+        _realtimeStatusListeners: Set<import("./types.js").RealtimeStatusListener>;
+        _realtimeEventListeners: Map<string, Set<import("./types.js").RealtimeMessageListener>>;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
@@ -121,6 +164,17 @@ declare const EntityServerApi_base: {
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
         setCsrfEnabled(enabled: boolean): void;
+        addRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        addRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        removeRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        addRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        connectRealtime(): Promise<void>;
+        disconnectRealtime(reason?: string): void;
+        sendRealtime(message: import("./types.js").RealtimeEnvelope | Record<string, unknown>): boolean;
+        subscribeRealtime(subscriptions: string[]): boolean;
+        unsubscribeRealtime(subscriptions: string[]): boolean;
         startHealthTick(intervalMs?: number): void;
         stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
@@ -129,6 +183,12 @@ declare const EntityServerApi_base: {
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
+        _applyRealtimeOptions(options?: boolean | import("./types.js").RealtimeClientOptions): void;
+        _buildRealtimeUrl(): string;
+        _handleRealtimeMessage(payload: unknown): void;
+        _scheduleRealtimeReconnect(reason: string): void;
+        _clearRealtimeReconnectTimer(): void;
+        _setRealtimeStatus(status: import("./types.js").RealtimeConnectionStatus, reason?: string, error?: Error): void;
         _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;
@@ -201,6 +261,19 @@ declare const EntityServerApi_base: {
         _refreshTimer: ReturnType<typeof setTimeout> | null;
         _healthTickTimer: ReturnType<typeof setInterval> | null;
         _healthTickPromise: Promise<unknown> | null;
+        realtimeEnabled: boolean;
+        realtimePath: string;
+        realtimeAutoConnect: boolean;
+        realtimeAutoReconnect: boolean;
+        realtimeReconnectDelayMs: number;
+        realtimeStatus: import("./types.js").RealtimeConnectionStatus;
+        _realtimeSocket: WebSocket | null;
+        _realtimeConnectPromise: Promise<void> | null;
+        _realtimeReconnectTimer: ReturnType<typeof setTimeout> | null;
+        _realtimeShouldReconnect: boolean;
+        _realtimeMessageListeners: Set<import("./types.js").RealtimeMessageListener>;
+        _realtimeStatusListeners: Set<import("./types.js").RealtimeStatusListener>;
+        _realtimeEventListeners: Map<string, Set<import("./types.js").RealtimeMessageListener>>;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
@@ -208,6 +281,17 @@ declare const EntityServerApi_base: {
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
         setCsrfEnabled(enabled: boolean): void;
+        addRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        addRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        removeRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        addRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        connectRealtime(): Promise<void>;
+        disconnectRealtime(reason?: string): void;
+        sendRealtime(message: import("./types.js").RealtimeEnvelope | Record<string, unknown>): boolean;
+        subscribeRealtime(subscriptions: string[]): boolean;
+        unsubscribeRealtime(subscriptions: string[]): boolean;
         startHealthTick(intervalMs?: number): void;
         stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
@@ -216,6 +300,12 @@ declare const EntityServerApi_base: {
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
+        _applyRealtimeOptions(options?: boolean | import("./types.js").RealtimeClientOptions): void;
+        _buildRealtimeUrl(): string;
+        _handleRealtimeMessage(payload: unknown): void;
+        _scheduleRealtimeReconnect(reason: string): void;
+        _clearRealtimeReconnectTimer(): void;
+        _setRealtimeStatus(status: import("./types.js").RealtimeConnectionStatus, reason?: string, error?: Error): void;
         _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;
@@ -265,6 +355,19 @@ declare const EntityServerApi_base: {
         _refreshTimer: ReturnType<typeof setTimeout> | null;
         _healthTickTimer: ReturnType<typeof setInterval> | null;
         _healthTickPromise: Promise<unknown> | null;
+        realtimeEnabled: boolean;
+        realtimePath: string;
+        realtimeAutoConnect: boolean;
+        realtimeAutoReconnect: boolean;
+        realtimeReconnectDelayMs: number;
+        realtimeStatus: import("./types.js").RealtimeConnectionStatus;
+        _realtimeSocket: WebSocket | null;
+        _realtimeConnectPromise: Promise<void> | null;
+        _realtimeReconnectTimer: ReturnType<typeof setTimeout> | null;
+        _realtimeShouldReconnect: boolean;
+        _realtimeMessageListeners: Set<import("./types.js").RealtimeMessageListener>;
+        _realtimeStatusListeners: Set<import("./types.js").RealtimeStatusListener>;
+        _realtimeEventListeners: Map<string, Set<import("./types.js").RealtimeMessageListener>>;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
@@ -272,6 +375,17 @@ declare const EntityServerApi_base: {
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
         setCsrfEnabled(enabled: boolean): void;
+        addRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        addRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        removeRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        addRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        connectRealtime(): Promise<void>;
+        disconnectRealtime(reason?: string): void;
+        sendRealtime(message: import("./types.js").RealtimeEnvelope | Record<string, unknown>): boolean;
+        subscribeRealtime(subscriptions: string[]): boolean;
+        unsubscribeRealtime(subscriptions: string[]): boolean;
         startHealthTick(intervalMs?: number): void;
         stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
@@ -280,6 +394,12 @@ declare const EntityServerApi_base: {
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
+        _applyRealtimeOptions(options?: boolean | import("./types.js").RealtimeClientOptions): void;
+        _buildRealtimeUrl(): string;
+        _handleRealtimeMessage(payload: unknown): void;
+        _scheduleRealtimeReconnect(reason: string): void;
+        _clearRealtimeReconnectTimer(): void;
+        _setRealtimeStatus(status: import("./types.js").RealtimeConnectionStatus, reason?: string, error?: Error): void;
         _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;
@@ -347,6 +467,19 @@ declare const EntityServerApi_base: {
         _refreshTimer: ReturnType<typeof setTimeout> | null;
         _healthTickTimer: ReturnType<typeof setInterval> | null;
         _healthTickPromise: Promise<unknown> | null;
+        realtimeEnabled: boolean;
+        realtimePath: string;
+        realtimeAutoConnect: boolean;
+        realtimeAutoReconnect: boolean;
+        realtimeReconnectDelayMs: number;
+        realtimeStatus: import("./types.js").RealtimeConnectionStatus;
+        _realtimeSocket: WebSocket | null;
+        _realtimeConnectPromise: Promise<void> | null;
+        _realtimeReconnectTimer: ReturnType<typeof setTimeout> | null;
+        _realtimeShouldReconnect: boolean;
+        _realtimeMessageListeners: Set<import("./types.js").RealtimeMessageListener>;
+        _realtimeStatusListeners: Set<import("./types.js").RealtimeStatusListener>;
+        _realtimeEventListeners: Map<string, Set<import("./types.js").RealtimeMessageListener>>;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
@@ -354,6 +487,17 @@ declare const EntityServerApi_base: {
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
         setCsrfEnabled(enabled: boolean): void;
+        addRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        addRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        removeRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        addRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        connectRealtime(): Promise<void>;
+        disconnectRealtime(reason?: string): void;
+        sendRealtime(message: import("./types.js").RealtimeEnvelope | Record<string, unknown>): boolean;
+        subscribeRealtime(subscriptions: string[]): boolean;
+        unsubscribeRealtime(subscriptions: string[]): boolean;
         startHealthTick(intervalMs?: number): void;
         stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
@@ -362,6 +506,12 @@ declare const EntityServerApi_base: {
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
+        _applyRealtimeOptions(options?: boolean | import("./types.js").RealtimeClientOptions): void;
+        _buildRealtimeUrl(): string;
+        _handleRealtimeMessage(payload: unknown): void;
+        _scheduleRealtimeReconnect(reason: string): void;
+        _clearRealtimeReconnectTimer(): void;
+        _setRealtimeStatus(status: import("./types.js").RealtimeConnectionStatus, reason?: string, error?: Error): void;
         _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;
@@ -464,6 +614,19 @@ declare const EntityServerApi_base: {
         _refreshTimer: ReturnType<typeof setTimeout> | null;
         _healthTickTimer: ReturnType<typeof setInterval> | null;
         _healthTickPromise: Promise<unknown> | null;
+        realtimeEnabled: boolean;
+        realtimePath: string;
+        realtimeAutoConnect: boolean;
+        realtimeAutoReconnect: boolean;
+        realtimeReconnectDelayMs: number;
+        realtimeStatus: import("./types.js").RealtimeConnectionStatus;
+        _realtimeSocket: WebSocket | null;
+        _realtimeConnectPromise: Promise<void> | null;
+        _realtimeReconnectTimer: ReturnType<typeof setTimeout> | null;
+        _realtimeShouldReconnect: boolean;
+        _realtimeMessageListeners: Set<import("./types.js").RealtimeMessageListener>;
+        _realtimeStatusListeners: Set<import("./types.js").RealtimeStatusListener>;
+        _realtimeEventListeners: Map<string, Set<import("./types.js").RealtimeMessageListener>>;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
@@ -471,6 +634,17 @@ declare const EntityServerApi_base: {
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
         setCsrfEnabled(enabled: boolean): void;
+        addRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        addRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        removeRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        addRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        connectRealtime(): Promise<void>;
+        disconnectRealtime(reason?: string): void;
+        sendRealtime(message: import("./types.js").RealtimeEnvelope | Record<string, unknown>): boolean;
+        subscribeRealtime(subscriptions: string[]): boolean;
+        unsubscribeRealtime(subscriptions: string[]): boolean;
         startHealthTick(intervalMs?: number): void;
         stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
@@ -479,6 +653,12 @@ declare const EntityServerApi_base: {
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
+        _applyRealtimeOptions(options?: boolean | import("./types.js").RealtimeClientOptions): void;
+        _buildRealtimeUrl(): string;
+        _handleRealtimeMessage(payload: unknown): void;
+        _scheduleRealtimeReconnect(reason: string): void;
+        _clearRealtimeReconnectTimer(): void;
+        _setRealtimeStatus(status: import("./types.js").RealtimeConnectionStatus, reason?: string, error?: Error): void;
         _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;
@@ -585,6 +765,19 @@ declare const EntityServerApi_base: {
         _refreshTimer: ReturnType<typeof setTimeout> | null;
         _healthTickTimer: ReturnType<typeof setInterval> | null;
         _healthTickPromise: Promise<unknown> | null;
+        realtimeEnabled: boolean;
+        realtimePath: string;
+        realtimeAutoConnect: boolean;
+        realtimeAutoReconnect: boolean;
+        realtimeReconnectDelayMs: number;
+        realtimeStatus: import("./types.js").RealtimeConnectionStatus;
+        _realtimeSocket: WebSocket | null;
+        _realtimeConnectPromise: Promise<void> | null;
+        _realtimeReconnectTimer: ReturnType<typeof setTimeout> | null;
+        _realtimeShouldReconnect: boolean;
+        _realtimeMessageListeners: Set<import("./types.js").RealtimeMessageListener>;
+        _realtimeStatusListeners: Set<import("./types.js").RealtimeStatusListener>;
+        _realtimeEventListeners: Map<string, Set<import("./types.js").RealtimeMessageListener>>;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
@@ -592,6 +785,17 @@ declare const EntityServerApi_base: {
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
         setCsrfEnabled(enabled: boolean): void;
+        addRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        addRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        removeRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        addRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        connectRealtime(): Promise<void>;
+        disconnectRealtime(reason?: string): void;
+        sendRealtime(message: import("./types.js").RealtimeEnvelope | Record<string, unknown>): boolean;
+        subscribeRealtime(subscriptions: string[]): boolean;
+        unsubscribeRealtime(subscriptions: string[]): boolean;
         startHealthTick(intervalMs?: number): void;
         stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
@@ -600,6 +804,12 @@ declare const EntityServerApi_base: {
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
+        _applyRealtimeOptions(options?: boolean | import("./types.js").RealtimeClientOptions): void;
+        _buildRealtimeUrl(): string;
+        _handleRealtimeMessage(payload: unknown): void;
+        _scheduleRealtimeReconnect(reason: string): void;
+        _clearRealtimeReconnectTimer(): void;
+        _setRealtimeStatus(status: import("./types.js").RealtimeConnectionStatus, reason?: string, error?: Error): void;
         _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;
@@ -621,23 +831,25 @@ declare const EntityServerApi_base: {
 } & {
     new (...args: any[]): {
         _csrfRefresher: () => Promise<void>;
-        checkHealth(): Promise<{
+        checkHealth(bootstrapAuth?: boolean): Promise<{
             status: string;
+            authenticated?: boolean;
+            packet_encryption?: boolean;
         }>;
         _readCookie(name: string): string | null;
-        login(email: string, password: string): Promise<{
+        _ensurePublicAuthBootstrap(): Promise<void>;
+        login(email: string, password: string): Promise<import("./index.js").AuthLoginResponse>;
+        tokenRefresh(): Promise<{
             access_token: string;
             refresh_token: string;
             expires_in: number;
-            force_password_change?: boolean;
-            password_expired?: boolean;
-            password_expires_in_days?: number;
         }>;
-        refreshToken(refreshToken: string): Promise<{
+        refreshToken(refreshToken?: string): Promise<{
             access_token: string;
+            refresh_token?: string;
             expires_in: number;
         }>;
-        logout(refreshToken: string): Promise<{
+        logout(refreshToken?: string): Promise<{
             ok: boolean;
         }>;
         me<T = Record<string, unknown>>(): Promise<{
@@ -666,6 +878,19 @@ declare const EntityServerApi_base: {
         _refreshTimer: ReturnType<typeof setTimeout> | null;
         _healthTickTimer: ReturnType<typeof setInterval> | null;
         _healthTickPromise: Promise<unknown> | null;
+        realtimeEnabled: boolean;
+        realtimePath: string;
+        realtimeAutoConnect: boolean;
+        realtimeAutoReconnect: boolean;
+        realtimeReconnectDelayMs: number;
+        realtimeStatus: import("./types.js").RealtimeConnectionStatus;
+        _realtimeSocket: WebSocket | null;
+        _realtimeConnectPromise: Promise<void> | null;
+        _realtimeReconnectTimer: ReturnType<typeof setTimeout> | null;
+        _realtimeShouldReconnect: boolean;
+        _realtimeMessageListeners: Set<import("./types.js").RealtimeMessageListener>;
+        _realtimeStatusListeners: Set<import("./types.js").RealtimeStatusListener>;
+        _realtimeEventListeners: Map<string, Set<import("./types.js").RealtimeMessageListener>>;
         configure(options: Partial<import("./types.js").EntityServerClientOptions>): void;
         setToken(token: string): void;
         setAnonymousPacketToken(token: string): void;
@@ -673,6 +898,17 @@ declare const EntityServerApi_base: {
         setHmacSecret(secret: string): void;
         setEncryptRequests(value: boolean): void;
         setCsrfEnabled(enabled: boolean): void;
+        addRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeListener(listener: import("./types.js").RealtimeMessageListener): void;
+        addRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        removeRealtimeStatusListener(listener: import("./types.js").RealtimeStatusListener): void;
+        addRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        removeRealtimeEventListener(eventName: string, listener: import("./types.js").RealtimeMessageListener): void;
+        connectRealtime(): Promise<void>;
+        disconnectRealtime(reason?: string): void;
+        sendRealtime(message: import("./types.js").RealtimeEnvelope | Record<string, unknown>): boolean;
+        subscribeRealtime(subscriptions: string[]): boolean;
+        unsubscribeRealtime(subscriptions: string[]): boolean;
         startHealthTick(intervalMs?: number): void;
         stopHealthTick(): void;
         _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
@@ -681,6 +917,12 @@ declare const EntityServerApi_base: {
         }>): void;
         _clearRefreshTimer(): void;
         stopKeepSession(): void;
+        _applyRealtimeOptions(options?: boolean | import("./types.js").RealtimeClientOptions): void;
+        _buildRealtimeUrl(): string;
+        _handleRealtimeMessage(payload: unknown): void;
+        _scheduleRealtimeReconnect(reason: string): void;
+        _clearRealtimeReconnectTimer(): void;
+        _setRealtimeStatus(status: import("./types.js").RealtimeConnectionStatus, reason?: string, error?: Error): void;
         _applyCsrfHealth(): void;
         readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
         get _reqOpts(): import("./client/request.js").RequestOptions;

package/dist/client/base.d.ts

@@ -1,4 +1,4 @@
-import type { EntityServerClientOptions } from "../types.js";
+import type { EntityServerClientOptions, RealtimeClientOptions, RealtimeConnectionStatus, RealtimeEnvelope, RealtimeMessageListener, RealtimeStatusListener } from "../types.js";
 import { type RequestOptions } from "./request.js";
 export type GConstructor<T = object> = new (...args: any[]) => T;
 export declare class EntityServerClientBase {
@@ -23,6 +23,19 @@ export declare class EntityServerClientBase {
     _refreshTimer: ReturnType<typeof setTimeout> | null;
     _healthTickTimer: ReturnType<typeof setInterval> | null;
     _healthTickPromise: Promise<unknown> | null;
+    realtimeEnabled: boolean;
+    realtimePath: string;
+    realtimeAutoConnect: boolean;
+    realtimeAutoReconnect: boolean;
+    realtimeReconnectDelayMs: number;
+    realtimeStatus: RealtimeConnectionStatus;
+    _realtimeSocket: WebSocket | null;
+    _realtimeConnectPromise: Promise<void> | null;
+    _realtimeReconnectTimer: ReturnType<typeof setTimeout> | null;
+    _realtimeShouldReconnect: boolean;
+    _realtimeMessageListeners: Set<RealtimeMessageListener>;
+    _realtimeStatusListeners: Set<RealtimeStatusListener>;
+    _realtimeEventListeners: Map<string, Set<RealtimeMessageListener>>;
     /**
      * EntityServerClient 인스턴스를 생성합니다.
      *
@@ -43,27 +56,45 @@ export declare class EntityServerClientBase {
     /** 암호화 요청 활성화 여부를 설정합니다. */
     setEncryptRequests(value: boolean): void;
     setCsrfEnabled(enabled: boolean): void;
+    addRealtimeListener(listener: RealtimeMessageListener): void;
+    removeRealtimeListener(listener: RealtimeMessageListener): void;
+    addRealtimeStatusListener(listener: RealtimeStatusListener): void;
+    removeRealtimeStatusListener(listener: RealtimeStatusListener): void;
+    addRealtimeEventListener(eventName: string, listener: RealtimeMessageListener): void;
+    removeRealtimeEventListener(eventName: string, listener: RealtimeMessageListener): void;
+    connectRealtime(): Promise<void>;
+    disconnectRealtime(reason?: string): void;
+    sendRealtime(message: RealtimeEnvelope | Record<string, unknown>): boolean;
+    subscribeRealtime(subscriptions: string[]): boolean;
+    unsubscribeRealtime(subscriptions: string[]): boolean;
     /**
      * 주기적으로 health 체크를 실행합니다.
      * CSRF 쿠키 갱신과 서버 상태 확인을 자동화합니다.
+     * keepSession=true 이면 각 tick에서 세션 부트스트랩도 함께 시도합니다.
      *
      * @param intervalMs 호출 주기(ms). 기본값: 5분
      */
     startHealthTick(intervalMs?: number): void;
     /** health tick 타이머를 중지합니다. */
     stopHealthTick(): void;
-    /** @internal 자동 토큰 갱신 타이머를 시작합니다. */
+    /** @deprecated 세션 연장은 health tick 기반 부트스트랩으로 대체되었습니다. */
     _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
         access_token: string;
         expires_in: number;
     }>): void;
-    /** @internal 자동 갱신 타이머를 정리합니다. */
+    /** @deprecated 세션 연장은 health tick 기반 부트스트랩으로 대체되었습니다. */
     _clearRefreshTimer(): void;
     /**
-     * 세션 유지 타이머를 중지합니다.
+     * 세션 자동 연장을 중지합니다.
      * `logout()` 호출 시 자동으로 중지되며, 직접 호출이 필요한 경우는 드뭅니다.
      */
     stopKeepSession(): void;
+    _applyRealtimeOptions(options?: boolean | RealtimeClientOptions): void;
+    _buildRealtimeUrl(): string;
+    _handleRealtimeMessage(payload: unknown): void;
+    _scheduleRealtimeReconnect(reason: string): void;
+    _clearRealtimeReconnectTimer(): void;
+    _setRealtimeStatus(status: RealtimeConnectionStatus, reason?: string, error?: Error): void;
     _applyCsrfHealth(): void;
     /**
      * 요청 바디를 파싱합니다.

package/dist/client/base.js

@@ -1,2 +1,2 @@
-import{readEnv as c}from"./utils.js";import{derivePacketKey as f,parseRequestBody as l}from"./packet.js";import{entityRequest as h}from"./request.js";class y{baseUrl;token;anonymousPacketToken;apiKey;hmacSecret;encryptRequests;csrfEnabled;csrfHeaderName;csrfCookieName;_csrfRefresher=null;activeTxId=null;keepSession;refreshBuffer;onTokenRefreshed;onSessionExpired;onHealthChange;_sessionRefreshToken=null;_refreshTimer=null;_healthTickTimer=null;_healthTickPromise=null;constructor(e={}){const r=c("VITE_ENTITY_SERVER_URL");this.baseUrl=(e.baseUrl??r??"").replace(/\/$/,""),this.token=e.token??"",this.anonymousPacketToken=e.anonymousPacketToken??"",this.apiKey=e.apiKey??"",this.hmacSecret=e.hmacSecret??"",this.encryptRequests=e.encryptRequests??!1,this.csrfEnabled=e.csrfEnabled??!1,this.csrfHeaderName=e.csrfHeaderName??"x-csrf-token",this.csrfCookieName=e.csrfCookieName??"_csrf",this.keepSession=e.keepSession??!1,this.refreshBuffer=e.refreshBuffer??60,this.onTokenRefreshed=e.onTokenRefreshed,this.onSessionExpired=e.onSessionExpired,this.onHealthChange=e.onHealthChange,typeof e.healthTickInterval=="number"&&e.healthTickInterval>0&&Promise.resolve().then(()=>this.startHealthTick(e.healthTickInterval))}configure(e){typeof e.baseUrl=="string"&&(this.baseUrl=e.baseUrl.replace(/\/$/,"")),typeof e.token=="string"&&(this.token=e.token),typeof e.anonymousPacketToken=="string"&&(this.anonymousPacketToken=e.anonymousPacketToken),typeof e.encryptRequests=="boolean"&&(this.encryptRequests=e.encryptRequests),typeof e.csrfEnabled=="boolean"&&(this.csrfEnabled=e.csrfEnabled),typeof e.csrfHeaderName=="string"&&(this.csrfHeaderName=e.csrfHeaderName),typeof e.csrfCookieName=="string"&&(this.csrfCookieName=e.csrfCookieName),typeof e.apiKey=="string"&&(this.apiKey=e.apiKey),typeof e.hmacSecret=="string"&&(this.hmacSecret=e.hmacSecret),typeof e.keepSession=="boolean"&&(this.keepSession=e.keepSession),typeof e.refreshBuffer=="number"&&(this.refreshBuffer=e.refreshBuffer),e.onTokenRefreshed&&(this.onTokenRefreshed=e.onTokenRefreshed),e.onSessionExpired&&(this.onSessionExpired=e.onSessionExpired),e.onHealthChange&&(this.onHealthChange=e.onHealthChange),typeof e.healthTickInterval=="number"&&e.healthTickInterval>0&&Promise.resolve().then(()=>this.startHealthTick(e.healthTickInterval))}setToken(e){this.token=e}setAnonymousPacketToken(e){this.anonymousPacketToken=e}setApiKey(e){this.apiKey=e}setHmacSecret(e){this.hmacSecret=e}setEncryptRequests(e){this.encryptRequests=e}setCsrfEnabled(e){this.csrfEnabled=e}startHealthTick(e=300*1e3){this.stopHealthTick();const r=()=>{this._healthTickPromise||(this._healthTickPromise=(this._csrfRefresher?this._csrfRefresher():Promise.resolve()).then(()=>{this.onHealthChange?.(!0)}).catch(()=>{this.onHealthChange?.(!1)}).finally(()=>{this._healthTickPromise=null}))};r(),this._healthTickTimer=setInterval(r,e)}stopHealthTick(){this._healthTickTimer!==null&&(clearInterval(this._healthTickTimer),this._healthTickTimer=null),this._healthTickPromise=null}_scheduleKeepSession(e,r,t){this._clearRefreshTimer(),this._sessionRefreshToken=e;const i=Math.max((r-this.refreshBuffer)*1e3,0);this._refreshTimer=setTimeout(async()=>{if(this._sessionRefreshToken)try{const s=await t(this._sessionRefreshToken);this.onTokenRefreshed?.(s.access_token,s.expires_in),this._scheduleKeepSession(this._sessionRefreshToken,s.expires_in,t)}catch(s){this._clearRefreshTimer(),this.onSessionExpired?.(s instanceof Error?s:new Error(String(s)))}},i)}_clearRefreshTimer(){this._refreshTimer!==null&&(clearTimeout(this._refreshTimer),this._refreshTimer=null)}stopKeepSession(){this._clearRefreshTimer(),this._sessionRefreshToken=null}_applyCsrfHealth(){if(!(typeof document>"u")){for(const e of document.cookie.split(";")){const r=e.indexOf("=");if(!(r<0)&&e.substring(0,r).trim()===this.csrfCookieName){this.csrfEnabled=!!e.substring(r+1).trim();return}}this.csrfEnabled=!1}}readRequestBody(e,r="application/json",t=!1){const i=f(this.hmacSecret,this.token||this.anonymousPacketToken);return l(e,r,t,i)}get _reqOpts(){return{baseUrl:this.baseUrl,token:this.token,anonymousPacketToken:this.anonymousPacketToken,apiKey:this.apiKey,hmacSecret:this.hmacSecret,encryptRequests:this.encryptRequests,csrfEnabled:this.csrfEnabled,csrfHeaderName:this.csrfHeaderName,csrfCookieName:this.csrfCookieName,refreshCsrfCookie:this.csrfEnabled?this._csrfRefresher:null}}get http(){const e=this;return{get(r,t=!0,i){return h(e._reqOpts,"GET",r,void 0,t,i,!1)},post(r,t,i=!0,s){return h(e._reqOpts,"POST",r,t,i,s,!1)},put(r,t,i=!0,s){return h(e._reqOpts,"PUT",r,t,i,s,!1)},patch(r,t,i=!0,s){return h(e._reqOpts,"PATCH",r,t,i,s,!1)},delete(r,t,i=!0,s){return h(e._reqOpts,"DELETE",r,t,i,s,!1)}}}requestBinary(e,r,t,i=!0){return this._requestBinary(e,r,t,i)}requestForm(e,r,t,i=!0){return this._requestForm(e,r,t,i)}requestFormBinary(e,r,t,i=!0){return this._requestFormBinary(e,r,t,i)}_request(e,r,t,i=!0,s){return h(this._reqOpts,e,r,t,i,s,!0)}async _requestBinary(e,r,t,i=!0){const s={"Content-Type":"application/json"};i&&this.token&&(s.Authorization=`Bearer ${this.token}`),this.apiKey&&(s["X-API-Key"]=this.apiKey);const n=await fetch(this.baseUrl+r,{method:e,headers:s,...t!=null?{body:JSON.stringify(t)}:{},credentials:"include"});if(!n.ok){const o=await n.text(),a=new Error(`HTTP ${n.status}: ${o}`);throw a.status=n.status,a}return n.arrayBuffer()}async _requestForm(e,r,t,i=!0){const s={};i&&this.token&&(s.Authorization=`Bearer ${this.token}`),this.apiKey&&(s["X-API-Key"]=this.apiKey);const n=await fetch(this.baseUrl+r,{method:e,headers:s,body:t,credentials:"include"}),o=await n.json();if(!o.ok){const a=new Error(o.message??`EntityServer error (HTTP ${n.status})`);throw a.status=n.status,a}return o}async _requestFormBinary(e,r,t,i=!0){const s={};i&&this.token&&(s.Authorization=`Bearer ${this.token}`),this.apiKey&&(s["X-API-Key"]=this.apiKey);const n=await fetch(this.baseUrl+r,{method:e,headers:s,body:t,credentials:"include"});if(!n.ok){const o=await n.text(),a=new Error(`HTTP ${n.status}: ${o}`);throw a.status=n.status,a}return n.arrayBuffer()}}export{y as EntityServerClientBase};
+import{readEnv as m}from"./utils.js";import{derivePacketKey as u,parseRequestBody as f}from"./packet.js";import{entityRequest as l}from"./request.js";const c="/v1/realtime";class T{baseUrl;token;anonymousPacketToken;apiKey;hmacSecret;encryptRequests;csrfEnabled;csrfHeaderName;csrfCookieName;_csrfRefresher=null;activeTxId=null;keepSession;refreshBuffer;onTokenRefreshed;onSessionExpired;onHealthChange;_sessionRefreshToken=null;_refreshTimer=null;_healthTickTimer=null;_healthTickPromise=null;realtimeEnabled;realtimePath;realtimeAutoConnect;realtimeAutoReconnect;realtimeReconnectDelayMs;realtimeStatus;_realtimeSocket=null;_realtimeConnectPromise=null;_realtimeReconnectTimer=null;_realtimeShouldReconnect=!1;_realtimeMessageListeners=new Set;_realtimeStatusListeners=new Set;_realtimeEventListeners=new Map;constructor(e={}){const t=m("VITE_ENTITY_SERVER_URL");this.baseUrl=(e.baseUrl??t??"").replace(/\/$/,""),this.token=e.token??"",this.anonymousPacketToken=e.anonymousPacketToken??"",this.apiKey=e.apiKey??"",this.hmacSecret=e.hmacSecret??"",this.encryptRequests=e.encryptRequests??!1,this.csrfEnabled=e.csrfEnabled??!1,this.csrfHeaderName=e.csrfHeaderName??"x-csrf-token",this.csrfCookieName=e.csrfCookieName??"_csrf",this.keepSession=e.keepSession??!1,this.refreshBuffer=e.refreshBuffer??60,this.onTokenRefreshed=e.onTokenRefreshed,this.onSessionExpired=e.onSessionExpired,this.onHealthChange=e.onHealthChange,this.realtimeEnabled=!1,this.realtimePath=c,this.realtimeAutoConnect=!0,this.realtimeAutoReconnect=!0,this.realtimeReconnectDelayMs=3e3,this.realtimeStatus="idle",this._applyRealtimeOptions(e.realtime),typeof e.healthTickInterval=="number"&&e.healthTickInterval>0&&Promise.resolve().then(()=>this.startHealthTick(e.healthTickInterval))}configure(e){typeof e.baseUrl=="string"&&(this.baseUrl=e.baseUrl.replace(/\/$/,"")),typeof e.token=="string"&&(this.token=e.token),typeof e.anonymousPacketToken=="string"&&(this.anonymousPacketToken=e.anonymousPacketToken),typeof e.encryptRequests=="boolean"&&(this.encryptRequests=e.encryptRequests),typeof e.csrfEnabled=="boolean"&&(this.csrfEnabled=e.csrfEnabled),typeof e.csrfHeaderName=="string"&&(this.csrfHeaderName=e.csrfHeaderName),typeof e.csrfCookieName=="string"&&(this.csrfCookieName=e.csrfCookieName),typeof e.apiKey=="string"&&(this.apiKey=e.apiKey),typeof e.hmacSecret=="string"&&(this.hmacSecret=e.hmacSecret),typeof e.keepSession=="boolean"&&(this.keepSession=e.keepSession),typeof e.refreshBuffer=="number"&&(this.refreshBuffer=e.refreshBuffer),e.onTokenRefreshed&&(this.onTokenRefreshed=e.onTokenRefreshed),e.onSessionExpired&&(this.onSessionExpired=e.onSessionExpired),e.onHealthChange&&(this.onHealthChange=e.onHealthChange),typeof e.realtime<"u"&&this._applyRealtimeOptions(e.realtime),typeof e.healthTickInterval=="number"&&e.healthTickInterval>0&&Promise.resolve().then(()=>this.startHealthTick(e.healthTickInterval))}setToken(e){if(this.token=e,!e){this.disconnectRealtime("token_cleared");return}this.realtimeEnabled&&this.realtimeAutoConnect&&this.connectRealtime().catch(()=>{})}setAnonymousPacketToken(e){this.anonymousPacketToken=e}setApiKey(e){this.apiKey=e}setHmacSecret(e){this.hmacSecret=e}setEncryptRequests(e){this.encryptRequests=e}setCsrfEnabled(e){this.csrfEnabled=e}addRealtimeListener(e){this._realtimeMessageListeners.add(e)}removeRealtimeListener(e){this._realtimeMessageListeners.delete(e)}addRealtimeStatusListener(e){this._realtimeStatusListeners.add(e)}removeRealtimeStatusListener(e){this._realtimeStatusListeners.delete(e)}addRealtimeEventListener(e,t){const s=String(e).trim();s&&(this._realtimeEventListeners.has(s)||this._realtimeEventListeners.set(s,new Set),this._realtimeEventListeners.get(s).add(t))}removeRealtimeEventListener(e,t){const s=String(e).trim();if(!s)return;const i=this._realtimeEventListeners.get(s);i&&(i.delete(t),i.size===0&&this._realtimeEventListeners.delete(s))}async connectRealtime(){if(!this.realtimeEnabled){this._setRealtimeStatus("disabled","realtime_disabled");return}if(!this.token)throw new Error("Cannot open realtime connection without access token.");if(typeof WebSocket>"u")throw new Error("WebSocket is not available in this environment.");if(this._realtimeSocket&&this._realtimeSocket.readyState===WebSocket.OPEN)return;if(this._realtimeSocket&&this._realtimeSocket.readyState===WebSocket.CONNECTING&&this._realtimeConnectPromise)return this._realtimeConnectPromise;this._clearRealtimeReconnectTimer(),this._realtimeShouldReconnect=this.realtimeAutoReconnect,this._setRealtimeStatus("connecting","connect_requested");const e=new WebSocket(this._buildRealtimeUrl());return this._realtimeSocket=e,this._realtimeConnectPromise=new Promise((t,s)=>{let i=!1;const r=()=>{i||(i=!0,this._realtimeConnectPromise=null,t())},n=a=>{i||(i=!0,this._realtimeConnectPromise=null,s(a))};e.addEventListener("open",()=>{this._setRealtimeStatus("open","socket_open"),r()}),e.addEventListener("message",a=>{this._handleRealtimeMessage(a.data)}),e.addEventListener("error",()=>{this._setRealtimeStatus("closed","socket_error",new Error("Realtime socket error."))}),e.addEventListener("close",a=>{this._realtimeSocket===e&&(this._realtimeSocket=null);const o=a.reason||"socket_closed",h=new Error(`Realtime socket closed (${a.code}${a.reason?`: ${a.reason}`:""}).`);this._setRealtimeStatus("closed",o,h),i||n(h),this._realtimeShouldReconnect&&this.realtimeEnabled&&this.realtimeAutoReconnect&&this.token&&this._scheduleRealtimeReconnect(o)})}),this._realtimeConnectPromise}disconnectRealtime(e="client_disconnect"){if(this._realtimeShouldReconnect=!1,this._clearRealtimeReconnectTimer(),this._realtimeSocket){const t=this._realtimeSocket;this._realtimeSocket=null;try{(t.readyState===WebSocket.OPEN||t.readyState===WebSocket.CONNECTING)&&t.close(1e3,e)}catch{}}this._realtimeConnectPromise=null,this._setRealtimeStatus(this.realtimeEnabled?"idle":"disabled",e)}sendRealtime(e){return!this._realtimeSocket||this._realtimeSocket.readyState!==WebSocket.OPEN?!1:(this._realtimeSocket.send(JSON.stringify(e)),!0)}subscribeRealtime(e){return this.sendRealtime({type:"subscribe",channel:"session",event:"session.subscribe",data:{subscriptions:e}})}unsubscribeRealtime(e){return this.sendRealtime({type:"unsubscribe",channel:"session",event:"session.unsubscribe",data:{subscriptions:e}})}startHealthTick(e=300*1e3){this.stopHealthTick();const t=()=>{this._healthTickPromise||(this._healthTickPromise=(this._csrfRefresher?this._csrfRefresher():Promise.resolve()).then(()=>{this.onHealthChange?.(!0)}).catch(()=>{this.onHealthChange?.(!1)}).finally(()=>{this._healthTickPromise=null}))};t(),this._healthTickTimer=setInterval(t,e)}stopHealthTick(){this._healthTickTimer!==null&&(clearInterval(this._healthTickTimer),this._healthTickTimer=null),this._healthTickPromise=null}_scheduleKeepSession(e,t,s){this._clearRefreshTimer(),this._sessionRefreshToken=e;const i=Math.max((t-this.refreshBuffer)*1e3,0);this._refreshTimer=setTimeout(async()=>{if(this._sessionRefreshToken)try{const r=await s(this._sessionRefreshToken);this.onTokenRefreshed?.(r.access_token,r.expires_in),this._scheduleKeepSession(this._sessionRefreshToken,r.expires_in,s)}catch(r){this._clearRefreshTimer(),this.onSessionExpired?.(r instanceof Error?r:new Error(String(r)))}},i)}_clearRefreshTimer(){this._refreshTimer!==null&&(clearTimeout(this._refreshTimer),this._refreshTimer=null)}stopKeepSession(){this._clearRefreshTimer(),this._sessionRefreshToken=null}_applyRealtimeOptions(e){const t=typeof e=="boolean"?{enabled:e}:e??{};if(this.realtimeEnabled=t.enabled??!1,this.realtimePath=String(t.path??c).trim()||c,this.realtimeAutoConnect=t.autoConnect??!0,this.realtimeAutoReconnect=t.autoReconnect??!0,this.realtimeReconnectDelayMs=Math.max(250,t.reconnectDelayMs??3e3),!this.realtimeEnabled){this.disconnectRealtime("realtime_disabled");return}this._setRealtimeStatus("idle","realtime_enabled"),this.token&&this.realtimeAutoConnect&&this.connectRealtime().catch(()=>{})}_buildRealtimeUrl(){const t=this.baseUrl||m("VITE_ENTITY_SERVER_URL")||""||(typeof window<"u"?window.location.origin:"");if(!t)throw new Error("Realtime connection requires baseUrl.");const s=new URL(this.realtimePath,t);return s.protocol=s.protocol==="https:"?"wss:":"ws:",s.searchParams.set("access_token",this.token),s.toString()}_handleRealtimeMessage(e){if(typeof e!="string")return;let t;try{t=JSON.parse(e)}catch{return}for(const i of this._realtimeMessageListeners)i(t);const s=this._realtimeEventListeners.get(t.event);if(s)for(const i of s)i(t)}_scheduleRealtimeReconnect(e){this._clearRealtimeReconnectTimer(),this._realtimeReconnectTimer=setTimeout(()=>{this._realtimeReconnectTimer=null,!(!this.realtimeEnabled||!this.token)&&(this._setRealtimeStatus("connecting",`${e}:reconnect`),this.connectRealtime().catch(()=>{}))},this.realtimeReconnectDelayMs)}_clearRealtimeReconnectTimer(){this._realtimeReconnectTimer!==null&&(clearTimeout(this._realtimeReconnectTimer),this._realtimeReconnectTimer=null)}_setRealtimeStatus(e,t,s){const i=this.realtimeStatus;if(!(i===e&&typeof t>"u"&&typeof s>"u")){this.realtimeStatus=e;for(const r of this._realtimeStatusListeners)r({status:e,previousStatus:i,...t?{reason:t}:{},...s?{error:s}:{}})}}_applyCsrfHealth(){if(!(typeof document>"u")){for(const e of document.cookie.split(";")){const t=e.indexOf("=");if(!(t<0)&&e.substring(0,t).trim()===this.csrfCookieName){this.csrfEnabled=!!e.substring(t+1).trim();return}}this.csrfEnabled=!1}}readRequestBody(e,t="application/json",s=!1){const i=u(this.hmacSecret,this.token||this.anonymousPacketToken);return f(e,t,s,i)}get _reqOpts(){return{baseUrl:this.baseUrl,token:this.token,anonymousPacketToken:this.anonymousPacketToken,apiKey:this.apiKey,hmacSecret:this.hmacSecret,encryptRequests:this.encryptRequests,csrfEnabled:this.csrfEnabled,csrfHeaderName:this.csrfHeaderName,csrfCookieName:this.csrfCookieName,refreshCsrfCookie:this.csrfEnabled?this._csrfRefresher:null,onAccessToken:e=>{this.token=e}}}get http(){const e=this;return{get(t,s=!0,i){return l(e._reqOpts,"GET",t,void 0,s,i,!1)},post(t,s,i=!0,r){return l(e._reqOpts,"POST",t,s,i,r,!1)},put(t,s,i=!0,r){return l(e._reqOpts,"PUT",t,s,i,r,!1)},patch(t,s,i=!0,r){return l(e._reqOpts,"PATCH",t,s,i,r,!1)},delete(t,s,i=!0,r){return l(e._reqOpts,"DELETE",t,s,i,r,!1)}}}requestBinary(e,t,s,i=!0){return this._requestBinary(e,t,s,i)}requestForm(e,t,s,i=!0){return this._requestForm(e,t,s,i)}requestFormBinary(e,t,s,i=!0){return this._requestFormBinary(e,t,s,i)}_request(e,t,s,i=!0,r){return l(this._reqOpts,e,t,s,i,r,!0)}async _requestBinary(e,t,s,i=!0){const r={"Content-Type":"application/json"};i&&this.token&&(r.Authorization=`Bearer ${this.token}`),this.apiKey&&(r["X-API-Key"]=this.apiKey);const n=await fetch(this.baseUrl+t,{method:e,headers:r,...s!=null?{body:JSON.stringify(s)}:{},credentials:"include"});if(!n.ok){const a=await n.text(),o=new Error(`HTTP ${n.status}: ${a}`);throw o.status=n.status,o}return n.arrayBuffer()}async _requestForm(e,t,s,i=!0){const r={};i&&this.token&&(r.Authorization=`Bearer ${this.token}`),this.apiKey&&(r["X-API-Key"]=this.apiKey);const n=await fetch(this.baseUrl+t,{method:e,headers:r,body:s,credentials:"include"}),a=await n.json();if(!a.ok){const o=new Error(a.message??`EntityServer error (HTTP ${n.status})`);throw o.status=n.status,o}return a}async _requestFormBinary(e,t,s,i=!0){const r={};i&&this.token&&(r.Authorization=`Bearer ${this.token}`),this.apiKey&&(r["X-API-Key"]=this.apiKey);const n=await fetch(this.baseUrl+t,{method:e,headers:r,body:s,credentials:"include"});if(!n.ok){const a=await n.text(),o=new Error(`HTTP ${n.status}: ${a}`);throw o.status=n.status,o}return n.arrayBuffer()}}export{T as EntityServerClientBase};
 //# sourceMappingURL=base.js.map