@yorkie-js/sdk 0.7.9 → 0.7.10-rc

package/dist/yorkie-js-sdk.d.ts

@@ -106,9 +106,10 @@ export declare interface AttachChannelOptions {
      */
     syncMode?: SyncMode;
     /**
-     * `channelHeartbeatInterval` overrides the heartbeat interval (ms) for this
-     * attachment. If unset, mode-specific defaults apply: Polling=3000,
-     * Realtime=30000.
+     * `channelHeartbeatInterval` overrides the heartbeat interval (ms) for
+     * this attachment. If unset, the client-level default
+     * (`ClientOptions.channelHeartbeatInterval`, default 5000 ms) applies
+     * to both Realtime and Polling modes.
      */
     channelHeartbeatInterval?: number;
 }
@@ -801,6 +802,12 @@ export declare class Channel implements Observable_2<ChannelEvent>, Attachable {
      * The callback will be called when an authentication error occurs.
      */
     subscribe(type: 'auth-error', next: ChannelEventCallbackMap['auth-error']): Unsubscribe;
+    /**
+     * `subscribe` registers a callback to subscribe to non-recoverable sync
+     * (RefreshChannel) errors. Subsequent successful events on the channel
+     * imply recovery — there is no separate "recovered" event.
+     */
+    subscribe(type: 'sync-error', next: ChannelEventCallbackMap['sync-error']): Unsubscribe;
     /**
      * `subscribe` registers a callback to subscribe to presence events on the channel.
      * The callback will be called when the presence count changes.
@@ -834,7 +841,7 @@ export declare class Channel implements Observable_2<ChannelEvent>, Attachable {
 /**
  * `ChannelEvent` represents an event that occurs in the channel.
  */
-export declare type ChannelEvent = PresenceEvent_3 | BroadcastEvent | LocalBroadcastEvent | AuthErrorEvent_3;
+export declare type ChannelEvent = PresenceEvent_3 | BroadcastEvent | LocalBroadcastEvent | AuthErrorEvent_3 | SyncErrorEvent;
 
 /**
  * `ChannelEventCallbackMap` represents a map of event types to callbacks.
@@ -843,6 +850,7 @@ declare type ChannelEventCallbackMap = {
     broadcast: NextFn<BroadcastEvent>;
     'local-broadcast': NextFn<LocalBroadcastEvent>;
     'auth-error': NextFn<AuthErrorEvent_3>;
+    'sync-error': NextFn<SyncErrorEvent>;
     presence: NextFn<PresenceEvent_3>;
     all: NextFn<ChannelEvent>;
 };
@@ -870,7 +878,15 @@ export declare enum ChannelEventType {
     /**
      * `AuthError` means that an authentication error has occurred.
      */
-    AuthError = "auth-error"
+    AuthError = "auth-error",
+    /**
+     * `SyncError` means that a non-recoverable sync (RefreshChannel) error
+     * occurred. Subscribers can use this to render an error state in the UI
+     * without polling internal SDK state. The SDK still retries via its sync
+     * loop, so subsequent successful events (PresenceChanged/Initialized) can
+     * be treated as recovery.
+     */
+    SyncError = "sync-error"
 }
 
 /**
@@ -1010,8 +1026,9 @@ export declare class Client {
      */
     attach<R, P extends Indexable>(resource: Document_2<R, P>, opts?: AttachOptions<R, P>): Promise<Document_2<R, P>>;
     /**
-     * `attach` attaches the given channel to this client. It tells the server that
-     * this client will track the channel.
+     * `attach` attaches the given channel to this client. The channel is
+     * registered locally and the server is notified on the next RefreshChannel
+     * heartbeat.
      */
     attach(resource: Channel, opts?: AttachChannelOptions): Promise<Channel>;
     /**
@@ -1027,8 +1044,9 @@ export declare class Client {
         keepalive?: boolean;
     }): Promise<Document_2<R, P>>;
     /**
-     * `detach` detaches the given channel from this client.
-     * It tells the server that this client will no longer track the channel.
+     * `detach` detaches the given channel from this client. The detach is a
+     * local cleanup; the server reclaims the session via TTL when heartbeats
+     * stop.
      */
     detach(resource: Channel): Promise<Channel>;
     /**
@@ -1041,13 +1059,15 @@ export declare class Client {
      */
     private detachDocument;
     /**
-     * `attach` attaches the given channel to this client.
-     * It tells the server that this client will track the channel.
+     * `attachChannel` attaches the given channel to this client. The channel is
+     * registered locally and the server is notified on the next RefreshChannel
+     * heartbeat.
      */
     attachChannel(channel: Channel, opts?: AttachChannelOptions): Promise<Channel>;
     /**
-     * `detachChannel` detaches the given channel from this client.
-     * It tells the server that this client will no longer track the channel.
+     * `detachChannel` detaches the given channel from this client. The detach
+     * is a local cleanup; the server reclaims the session via TTL when
+     * heartbeats stop.
      */
     detachChannel(channel: Channel): Promise<Channel>;
     /**
@@ -1241,9 +1261,11 @@ export declare interface ClientOptions {
      */
     reconnectStreamDelay?: number;
     /**
-     * `channelHeartbeatInterval` is the interval of the channel heartbeat.
-     * The client sends a heartbeat to the server to refresh the channel TTL.
-     * The default value is `30000`(ms).
+     * `channelHeartbeatInterval` is the interval of the channel heartbeat (ms).
+     * The client sends a `RefreshChannel` heartbeat to refresh the channel
+     * session TTL. The default value is `5000` (ms) — co-tuned to the server's
+     * `ChannelSessionTTL` (15 s) at TTL/3. Values larger than the server TTL
+     * risk premature session expiry.
      */
     channelHeartbeatInterval?: number;
     /**
@@ -6062,6 +6084,26 @@ declare interface SubscribeFn<T> {
     (observer: Observer<T>): Unsubscribe;
 }
 
+/**
+ * `SyncErrorEvent` represents a non-recoverable sync (RefreshChannel) error.
+ * It carries the underlying error object so subscribers can inspect codes
+ * (e.g. via `isErrorCode`) without losing the original Error.
+ */
+declare interface SyncErrorEvent {
+    /**
+     * `type` is the type of the event.
+     */
+    type: ChannelEventType.SyncError;
+    /**
+     * `error` is the underlying error thrown by the RPC call.
+     */
+    error: unknown;
+    /**
+     * `method` is the RPC method that failed (e.g. `RefreshChannel`).
+     */
+    method: string;
+}
+
 /**
  * `SyncMode` defines synchronization modes for the PushPullChanges API
  * (documents) and the RefreshChannel heartbeat (channels).

package/dist/yorkie-js-sdk.es.js

@@ -5865,7 +5865,7 @@ var DocEventType$1 = /* @__PURE__ */ ((DocEventType2) => {
   DocEventType2[DocEventType2["DOCUMENT_BROADCAST"] = 3] = "DOCUMENT_BROADCAST";
   return DocEventType2;
 })(DocEventType$1 || {});
-const file_yorkie_v1_yorkie = /* @__PURE__ */ fileDesc("ChZ5b3JraWUvdjEveW9ya2llLnByb3RvEgl5b3JraWUudjEingEKFUFjdGl2YXRlQ2xpZW50UmVxdWVzdBISCgpjbGllbnRfa2V5GAEgASgJEkAKCG1ldGFkYXRhGAIgAygLMi4ueW9ya2llLnYxLkFjdGl2YXRlQ2xpZW50UmVxdWVzdC5NZXRhZGF0YUVudHJ5Gi8KDU1ldGFkYXRhRW50cnkSCwoDa2V5GAEgASgJEg0KBXZhbHVlGAIgASgJOgI4ASIrChZBY3RpdmF0ZUNsaWVudFJlc3BvbnNlEhEKCWNsaWVudF9pZBgBIAEoCSJBChdEZWFjdGl2YXRlQ2xpZW50UmVxdWVzdBIRCgljbGllbnRfaWQYASABKAkSEwoLc3luY2hyb25vdXMYAiABKAgiGgoYRGVhY3RpdmF0ZUNsaWVudFJlc3BvbnNlImoKFUF0dGFjaERvY3VtZW50UmVxdWVzdBIRCgljbGllbnRfaWQYASABKAkSKgoLY2hhbmdlX3BhY2sYAiABKAsyFS55b3JraWUudjEuQ2hhbmdlUGFjaxISCgpzY2hlbWFfa2V5GAMgASgJIp8BChZBdHRhY2hEb2N1bWVudFJlc3BvbnNlEhMKC2RvY3VtZW50X2lkGAEgASgJEioKC2NoYW5nZV9wYWNrGAIgASgLMhUueW9ya2llLnYxLkNoYW5nZVBhY2sSHQoVbWF4X3NpemVfcGVyX2RvY3VtZW50GAMgASgFEiUKDHNjaGVtYV9ydWxlcxgEIAMoCzIPLnlvcmtpZS52MS5SdWxlIosBChVEZXRhY2hEb2N1bWVudFJlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2RvY3VtZW50X2lkGAIgASgJEioKC2NoYW5nZV9wYWNrGAMgASgLMhUueW9ya2llLnYxLkNoYW5nZVBhY2sSHgoWcmVtb3ZlX2lmX25vdF9hdHRhY2hlZBgEIAEoCCJEChZEZXRhY2hEb2N1bWVudFJlc3BvbnNlEioKC2NoYW5nZV9wYWNrGAIgASgLMhUueW9ya2llLnYxLkNoYW5nZVBhY2siUwoMV2F0Y2hSZXF1ZXN0EhEKCWNsaWVudF9pZBgBIAEoCRIwCglyZXNvdXJjZXMYAiADKAsyHS55b3JraWUudjEuUmVzb3VyY2VEZXNjcmlwdG9yIoQBChJSZXNvdXJjZURlc2NyaXB0b3ISMQoIZG9jdW1lbnQYASABKAsyHS55b3JraWUudjEuRG9jdW1lbnREZXNjcmlwdG9ySAASLwoHY2hhbm5lbBgCIAEoCzIcLnlvcmtpZS52MS5DaGFubmVsRGVzY3JpcHRvckgAQgoKCHJlc291cmNlIikKEkRvY3VtZW50RGVzY3JpcHRvchITCgtkb2N1bWVudF9pZBgBIAEoCSIoChFDaGFubmVsRGVzY3JpcHRvchITCgtjaGFubmVsX2tleRgBIAEoCSJ5Cg1XYXRjaFJlc3BvbnNlEjgKDmluaXRpYWxpemF0aW9uGAEgASgLMh4ueW9ya2llLnYxLldhdGNoSW5pdGlhbGl6YXRpb25IABImCgVldmVudBgCIAEoCzIVLnlvcmtpZS52MS5XYXRjaEV2ZW50SABCBgoEYm9keSJGChNXYXRjaEluaXRpYWxpemF0aW9uEi8KDnJlc291cmNlX2luaXRzGAEgAygLMhcueW9ya2llLnYxLlJlc291cmNlSW5pdCJ4CgxSZXNvdXJjZUluaXQSMAoNZG9jdW1lbnRfaW5pdBgBIAEoCzIXLnlvcmtpZS52MS5Eb2N1bWVudEluaXRIABIuCgxjaGFubmVsX2luaXQYAiABKAsyFi55b3JraWUudjEuQ2hhbm5lbEluaXRIAEIGCgRpbml0IjcKDERvY3VtZW50SW5pdBITCgtkb2N1bWVudF9pZBgBIAEoCRISCgpjbGllbnRfaWRzGAIgAygJIkYKC0NoYW5uZWxJbml0EhMKC2NoYW5uZWxfa2V5GAEgASgJEhUKDXNlc3Npb25fY291bnQYAiABKAMSCwoDc2VxGAMgASgDInsKCldhdGNoRXZlbnQSLQoJZG9jX2V2ZW50GAEgASgLMhgueW9ya2llLnYxLkRvY1dhdGNoRXZlbnRIABI1Cg1jaGFubmVsX2V2ZW50GAIgASgLMhwueW9ya2llLnYxLkNoYW5uZWxXYXRjaEV2ZW50SABCBwoFZXZlbnQiSAoNRG9jV2F0Y2hFdmVudBITCgtkb2N1bWVudF9pZBgBIAEoCRIiCgVldmVudBgCIAEoCzITLnlvcmtpZS52MS5Eb2NFdmVudCJQChFDaGFubmVsV2F0Y2hFdmVudBITCgtjaGFubmVsX2tleRgBIAEoCRImCgVldmVudBgCIAEoCzIXLnlvcmtpZS52MS5DaGFubmVsRXZlbnQiPgoUV2F0Y2hEb2N1bWVudFJlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2RvY3VtZW50X2lkGAIgASgJIrYBChVXYXRjaERvY3VtZW50UmVzcG9uc2USSQoOaW5pdGlhbGl6YXRpb24YASABKAsyLy55b3JraWUudjEuV2F0Y2hEb2N1bWVudFJlc3BvbnNlLkluaXRpYWxpemF0aW9uSAASJAoFZXZlbnQYAiABKAsyEy55b3JraWUudjEuRG9jRXZlbnRIABokCg5Jbml0aWFsaXphdGlvbhISCgpjbGllbnRfaWRzGAEgAygJQgYKBGJvZHkiPQoTV2F0Y2hDaGFubmVsUmVxdWVzdBIRCgljbGllbnRfaWQYASABKAkSEwoLY2hhbm5lbF9rZXkYAiABKAkigwEKFFdhdGNoQ2hhbm5lbFJlc3BvbnNlEjkKC2luaXRpYWxpemVkGAEgASgLMiIueW9ya2llLnYxLldhdGNoQ2hhbm5lbEluaXRpYWxpemVkSAASKAoFZXZlbnQYAiABKAsyFy55b3JraWUudjEuQ2hhbm5lbEV2ZW50SABCBgoEYm9keSI9ChdXYXRjaENoYW5uZWxJbml0aWFsaXplZBIVCg1zZXNzaW9uX2NvdW50GAEgASgDEgsKA3NlcRgCIAEoAyJrChVSZW1vdmVEb2N1bWVudFJlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2RvY3VtZW50X2lkGAIgASgJEioKC2NoYW5nZV9wYWNrGAMgASgLMhUueW9ya2llLnYxLkNoYW5nZVBhY2siRAoWUmVtb3ZlRG9jdW1lbnRSZXNwb25zZRIqCgtjaGFuZ2VfcGFjaxgBIAEoCzIVLnlvcmtpZS52MS5DaGFuZ2VQYWNrIn8KFlB1c2hQdWxsQ2hhbmdlc1JlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2RvY3VtZW50X2lkGAIgASgJEioKC2NoYW5nZV9wYWNrGAMgASgLMhUueW9ya2llLnYxLkNoYW5nZVBhY2sSEQoJcHVzaF9vbmx5GAQgASgIIkUKF1B1c2hQdWxsQ2hhbmdlc1Jlc3BvbnNlEioKC2NoYW5nZV9wYWNrGAEgASgLMhUueW9ya2llLnYxLkNoYW5nZVBhY2siYwoVQ3JlYXRlUmV2aXNpb25SZXF1ZXN0EhEKCWNsaWVudF9pZBgBIAEoCRITCgtkb2N1bWVudF9pZBgCIAEoCRINCgVsYWJlbBgDIAEoCRITCgtkZXNjcmlwdGlvbhgEIAEoCSJGChZDcmVhdGVSZXZpc2lvblJlc3BvbnNlEiwKCHJldmlzaW9uGAEgASgLMhoueW9ya2llLnYxLlJldmlzaW9uU3VtbWFyeSJRChJHZXRSZXZpc2lvblJlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2RvY3VtZW50X2lkGAIgASgJEhMKC3JldmlzaW9uX2lkGAMgASgJIkMKE0dldFJldmlzaW9uUmVzcG9uc2USLAoIcmV2aXNpb24YASABKAsyGi55b3JraWUudjEuUmV2aXNpb25TdW1tYXJ5InUKFExpc3RSZXZpc2lvbnNSZXF1ZXN0EhEKCWNsaWVudF9pZBgBIAEoCRITCgtkb2N1bWVudF9pZBgCIAEoCRIRCglwYWdlX3NpemUYAyABKAUSDgoGb2Zmc2V0GAQgASgFEhIKCmlzX2ZvcndhcmQYBSABKAgiRgoVTGlzdFJldmlzaW9uc1Jlc3BvbnNlEi0KCXJldmlzaW9ucxgBIAMoCzIaLnlvcmtpZS52MS5SZXZpc2lvblN1bW1hcnkiVQoWUmVzdG9yZVJldmlzaW9uUmVxdWVzdBIRCgljbGllbnRfaWQYASABKAkSEwoLZG9jdW1lbnRfaWQYAiABKAkSEwoLcmV2aXNpb25faWQYBCABKAkiGQoXUmVzdG9yZVJldmlzaW9uUmVzcG9uc2UiPgoUQXR0YWNoQ2hhbm5lbFJlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2NoYW5uZWxfa2V5GAIgASgJIkIKFUF0dGFjaENoYW5uZWxSZXNwb25zZRISCgpzZXNzaW9uX2lkGAEgASgJEhUKDXNlc3Npb25fY291bnQYAiABKAMiUgoURGV0YWNoQ2hhbm5lbFJlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2NoYW5uZWxfa2V5GAIgASgJEhIKCnNlc3Npb25faWQYAyABKAkiLgoVRGV0YWNoQ2hhbm5lbFJlc3BvbnNlEhUKDXNlc3Npb25fY291bnQYASABKAMiUwoVUmVmcmVzaENoYW5uZWxSZXF1ZXN0EhEKCWNsaWVudF9pZBgBIAEoCRITCgtjaGFubmVsX2tleRgCIAEoCRISCgpzZXNzaW9uX2lkGAMgASgJIi8KFlJlZnJlc2hDaGFubmVsUmVzcG9uc2USFQoNc2Vzc2lvbl9jb3VudBgBIAEoAyIpChJQZWVrQ2hhbm5lbFJlcXVlc3QSEwoLY2hhbm5lbF9rZXkYASABKAkiLAoTUGVla0NoYW5uZWxSZXNwb25zZRIVCg1zZXNzaW9uX2NvdW50GAEgASgDIloKEEJyb2FkY2FzdFJlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2NoYW5uZWxfa2V5GAIgASgJEg0KBXRvcGljGAMgASgJEg8KB3BheWxvYWQYBCABKAwiEwoRQnJvYWRjYXN0UmVzcG9uc2UylQwKDVlvcmtpZVNlcnZpY2USVwoOQWN0aXZhdGVDbGllbnQSIC55b3JraWUudjEuQWN0aXZhdGVDbGllbnRSZXF1ZXN0GiEueW9ya2llLnYxLkFjdGl2YXRlQ2xpZW50UmVzcG9uc2UiABJdChBEZWFjdGl2YXRlQ2xpZW50EiIueW9ya2llLnYxLkRlYWN0aXZhdGVDbGllbnRSZXF1ZXN0GiMueW9ya2llLnYxLkRlYWN0aXZhdGVDbGllbnRSZXNwb25zZSIAElcKDkF0dGFjaERvY3VtZW50EiAueW9ya2llLnYxLkF0dGFjaERvY3VtZW50UmVxdWVzdBohLnlvcmtpZS52MS5BdHRhY2hEb2N1bWVudFJlc3BvbnNlIgASVwoORGV0YWNoRG9jdW1lbnQSIC55b3JraWUudjEuRGV0YWNoRG9jdW1lbnRSZXF1ZXN0GiEueW9ya2llLnYxLkRldGFjaERvY3VtZW50UmVzcG9uc2UiABJXCg5SZW1vdmVEb2N1bWVudBIgLnlvcmtpZS52MS5SZW1vdmVEb2N1bWVudFJlcXVlc3QaIS55b3JraWUudjEuUmVtb3ZlRG9jdW1lbnRSZXNwb25zZSIAEloKD1B1c2hQdWxsQ2hhbmdlcxIhLnlvcmtpZS52MS5QdXNoUHVsbENoYW5nZXNSZXF1ZXN0GiIueW9ya2llLnYxLlB1c2hQdWxsQ2hhbmdlc1Jlc3BvbnNlIgASPgoFV2F0Y2gSFy55b3JraWUudjEuV2F0Y2hSZXF1ZXN0GhgueW9ya2llLnYxLldhdGNoUmVzcG9uc2UiADABElYKDVdhdGNoRG9jdW1lbnQSHy55b3JraWUudjEuV2F0Y2hEb2N1bWVudFJlcXVlc3QaIC55b3JraWUudjEuV2F0Y2hEb2N1bWVudFJlc3BvbnNlIgAwARJTCgxXYXRjaENoYW5uZWwSHi55b3JraWUudjEuV2F0Y2hDaGFubmVsUmVxdWVzdBofLnlvcmtpZS52MS5XYXRjaENoYW5uZWxSZXNwb25zZSIAMAESVwoOQ3JlYXRlUmV2aXNpb24SIC55b3JraWUudjEuQ3JlYXRlUmV2aXNpb25SZXF1ZXN0GiEueW9ya2llLnYxLkNyZWF0ZVJldmlzaW9uUmVzcG9uc2UiABJOCgtHZXRSZXZpc2lvbhIdLnlvcmtpZS52MS5HZXRSZXZpc2lvblJlcXVlc3QaHi55b3JraWUudjEuR2V0UmV2aXNpb25SZXNwb25zZSIAElQKDUxpc3RSZXZpc2lvbnMSHy55b3JraWUudjEuTGlzdFJldmlzaW9uc1JlcXVlc3QaIC55b3JraWUudjEuTGlzdFJldmlzaW9uc1Jlc3BvbnNlIgASWgoPUmVzdG9yZVJldmlzaW9uEiEueW9ya2llLnYxLlJlc3RvcmVSZXZpc2lvblJlcXVlc3QaIi55b3JraWUudjEuUmVzdG9yZVJldmlzaW9uUmVzcG9uc2UiABJUCg1BdHRhY2hDaGFubmVsEh8ueW9ya2llLnYxLkF0dGFjaENoYW5uZWxSZXF1ZXN0GiAueW9ya2llLnYxLkF0dGFjaENoYW5uZWxSZXNwb25zZSIAElQKDURldGFjaENoYW5uZWwSHy55b3JraWUudjEuRGV0YWNoQ2hhbm5lbFJlcXVlc3QaIC55b3JraWUudjEuRGV0YWNoQ2hhbm5lbFJlc3BvbnNlIgASVwoOUmVmcmVzaENoYW5uZWwSIC55b3JraWUudjEuUmVmcmVzaENoYW5uZWxSZXF1ZXN0GiEueW9ya2llLnYxLlJlZnJlc2hDaGFubmVsUmVzcG9uc2UiABJOCgtQZWVrQ2hhbm5lbBIdLnlvcmtpZS52MS5QZWVrQ2hhbm5lbFJlcXVlc3QaHi55b3JraWUudjEuUGVla0NoYW5uZWxSZXNwb25zZSIAEkgKCUJyb2FkY2FzdBIbLnlvcmtpZS52MS5Ccm9hZGNhc3RSZXF1ZXN0GhwueW9ya2llLnYxLkJyb2FkY2FzdFJlc3BvbnNlIgBCRQoRZGV2LnlvcmtpZS5hcGkudjFQAVouZ2l0aHViLmNvbS95b3JraWUtdGVhbS95b3JraWUvYXBpL3lvcmtpZS92MTt2MWIGcHJvdG8z", [file_yorkie_v1_resources]);
+const file_yorkie_v1_yorkie = /* @__PURE__ */ fileDesc("ChZ5b3JraWUvdjEveW9ya2llLnByb3RvEgl5b3JraWUudjEingEKFUFjdGl2YXRlQ2xpZW50UmVxdWVzdBISCgpjbGllbnRfa2V5GAEgASgJEkAKCG1ldGFkYXRhGAIgAygLMi4ueW9ya2llLnYxLkFjdGl2YXRlQ2xpZW50UmVxdWVzdC5NZXRhZGF0YUVudHJ5Gi8KDU1ldGFkYXRhRW50cnkSCwoDa2V5GAEgASgJEg0KBXZhbHVlGAIgASgJOgI4ASIrChZBY3RpdmF0ZUNsaWVudFJlc3BvbnNlEhEKCWNsaWVudF9pZBgBIAEoCSJBChdEZWFjdGl2YXRlQ2xpZW50UmVxdWVzdBIRCgljbGllbnRfaWQYASABKAkSEwoLc3luY2hyb25vdXMYAiABKAgiGgoYRGVhY3RpdmF0ZUNsaWVudFJlc3BvbnNlImoKFUF0dGFjaERvY3VtZW50UmVxdWVzdBIRCgljbGllbnRfaWQYASABKAkSKgoLY2hhbmdlX3BhY2sYAiABKAsyFS55b3JraWUudjEuQ2hhbmdlUGFjaxISCgpzY2hlbWFfa2V5GAMgASgJIp8BChZBdHRhY2hEb2N1bWVudFJlc3BvbnNlEhMKC2RvY3VtZW50X2lkGAEgASgJEioKC2NoYW5nZV9wYWNrGAIgASgLMhUueW9ya2llLnYxLkNoYW5nZVBhY2sSHQoVbWF4X3NpemVfcGVyX2RvY3VtZW50GAMgASgFEiUKDHNjaGVtYV9ydWxlcxgEIAMoCzIPLnlvcmtpZS52MS5SdWxlIosBChVEZXRhY2hEb2N1bWVudFJlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2RvY3VtZW50X2lkGAIgASgJEioKC2NoYW5nZV9wYWNrGAMgASgLMhUueW9ya2llLnYxLkNoYW5nZVBhY2sSHgoWcmVtb3ZlX2lmX25vdF9hdHRhY2hlZBgEIAEoCCJEChZEZXRhY2hEb2N1bWVudFJlc3BvbnNlEioKC2NoYW5nZV9wYWNrGAIgASgLMhUueW9ya2llLnYxLkNoYW5nZVBhY2siUwoMV2F0Y2hSZXF1ZXN0EhEKCWNsaWVudF9pZBgBIAEoCRIwCglyZXNvdXJjZXMYAiADKAsyHS55b3JraWUudjEuUmVzb3VyY2VEZXNjcmlwdG9yIoQBChJSZXNvdXJjZURlc2NyaXB0b3ISMQoIZG9jdW1lbnQYASABKAsyHS55b3JraWUudjEuRG9jdW1lbnREZXNjcmlwdG9ySAASLwoHY2hhbm5lbBgCIAEoCzIcLnlvcmtpZS52MS5DaGFubmVsRGVzY3JpcHRvckgAQgoKCHJlc291cmNlIikKEkRvY3VtZW50RGVzY3JpcHRvchITCgtkb2N1bWVudF9pZBgBIAEoCSIoChFDaGFubmVsRGVzY3JpcHRvchITCgtjaGFubmVsX2tleRgBIAEoCSJ5Cg1XYXRjaFJlc3BvbnNlEjgKDmluaXRpYWxpemF0aW9uGAEgASgLMh4ueW9ya2llLnYxLldhdGNoSW5pdGlhbGl6YXRpb25IABImCgVldmVudBgCIAEoCzIVLnlvcmtpZS52MS5XYXRjaEV2ZW50SABCBgoEYm9keSJGChNXYXRjaEluaXRpYWxpemF0aW9uEi8KDnJlc291cmNlX2luaXRzGAEgAygLMhcueW9ya2llLnYxLlJlc291cmNlSW5pdCJ4CgxSZXNvdXJjZUluaXQSMAoNZG9jdW1lbnRfaW5pdBgBIAEoCzIXLnlvcmtpZS52MS5Eb2N1bWVudEluaXRIABIuCgxjaGFubmVsX2luaXQYAiABKAsyFi55b3JraWUudjEuQ2hhbm5lbEluaXRIAEIGCgRpbml0IjcKDERvY3VtZW50SW5pdBITCgtkb2N1bWVudF9pZBgBIAEoCRISCgpjbGllbnRfaWRzGAIgAygJIkYKC0NoYW5uZWxJbml0EhMKC2NoYW5uZWxfa2V5GAEgASgJEhUKDXNlc3Npb25fY291bnQYAiABKAMSCwoDc2VxGAMgASgDInsKCldhdGNoRXZlbnQSLQoJZG9jX2V2ZW50GAEgASgLMhgueW9ya2llLnYxLkRvY1dhdGNoRXZlbnRIABI1Cg1jaGFubmVsX2V2ZW50GAIgASgLMhwueW9ya2llLnYxLkNoYW5uZWxXYXRjaEV2ZW50SABCBwoFZXZlbnQiSAoNRG9jV2F0Y2hFdmVudBITCgtkb2N1bWVudF9pZBgBIAEoCRIiCgVldmVudBgCIAEoCzITLnlvcmtpZS52MS5Eb2NFdmVudCJQChFDaGFubmVsV2F0Y2hFdmVudBITCgtjaGFubmVsX2tleRgBIAEoCRImCgVldmVudBgCIAEoCzIXLnlvcmtpZS52MS5DaGFubmVsRXZlbnQiPgoUV2F0Y2hEb2N1bWVudFJlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2RvY3VtZW50X2lkGAIgASgJIrYBChVXYXRjaERvY3VtZW50UmVzcG9uc2USSQoOaW5pdGlhbGl6YXRpb24YASABKAsyLy55b3JraWUudjEuV2F0Y2hEb2N1bWVudFJlc3BvbnNlLkluaXRpYWxpemF0aW9uSAASJAoFZXZlbnQYAiABKAsyEy55b3JraWUudjEuRG9jRXZlbnRIABokCg5Jbml0aWFsaXphdGlvbhISCgpjbGllbnRfaWRzGAEgAygJQgYKBGJvZHkiPQoTV2F0Y2hDaGFubmVsUmVxdWVzdBIRCgljbGllbnRfaWQYASABKAkSEwoLY2hhbm5lbF9rZXkYAiABKAkigwEKFFdhdGNoQ2hhbm5lbFJlc3BvbnNlEjkKC2luaXRpYWxpemVkGAEgASgLMiIueW9ya2llLnYxLldhdGNoQ2hhbm5lbEluaXRpYWxpemVkSAASKAoFZXZlbnQYAiABKAsyFy55b3JraWUudjEuQ2hhbm5lbEV2ZW50SABCBgoEYm9keSI9ChdXYXRjaENoYW5uZWxJbml0aWFsaXplZBIVCg1zZXNzaW9uX2NvdW50GAEgASgDEgsKA3NlcRgCIAEoAyJrChVSZW1vdmVEb2N1bWVudFJlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2RvY3VtZW50X2lkGAIgASgJEioKC2NoYW5nZV9wYWNrGAMgASgLMhUueW9ya2llLnYxLkNoYW5nZVBhY2siRAoWUmVtb3ZlRG9jdW1lbnRSZXNwb25zZRIqCgtjaGFuZ2VfcGFjaxgBIAEoCzIVLnlvcmtpZS52MS5DaGFuZ2VQYWNrIn8KFlB1c2hQdWxsQ2hhbmdlc1JlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2RvY3VtZW50X2lkGAIgASgJEioKC2NoYW5nZV9wYWNrGAMgASgLMhUueW9ya2llLnYxLkNoYW5nZVBhY2sSEQoJcHVzaF9vbmx5GAQgASgIIkUKF1B1c2hQdWxsQ2hhbmdlc1Jlc3BvbnNlEioKC2NoYW5nZV9wYWNrGAEgASgLMhUueW9ya2llLnYxLkNoYW5nZVBhY2siYwoVQ3JlYXRlUmV2aXNpb25SZXF1ZXN0EhEKCWNsaWVudF9pZBgBIAEoCRITCgtkb2N1bWVudF9pZBgCIAEoCRINCgVsYWJlbBgDIAEoCRITCgtkZXNjcmlwdGlvbhgEIAEoCSJGChZDcmVhdGVSZXZpc2lvblJlc3BvbnNlEiwKCHJldmlzaW9uGAEgASgLMhoueW9ya2llLnYxLlJldmlzaW9uU3VtbWFyeSJRChJHZXRSZXZpc2lvblJlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2RvY3VtZW50X2lkGAIgASgJEhMKC3JldmlzaW9uX2lkGAMgASgJIkMKE0dldFJldmlzaW9uUmVzcG9uc2USLAoIcmV2aXNpb24YASABKAsyGi55b3JraWUudjEuUmV2aXNpb25TdW1tYXJ5InUKFExpc3RSZXZpc2lvbnNSZXF1ZXN0EhEKCWNsaWVudF9pZBgBIAEoCRITCgtkb2N1bWVudF9pZBgCIAEoCRIRCglwYWdlX3NpemUYAyABKAUSDgoGb2Zmc2V0GAQgASgFEhIKCmlzX2ZvcndhcmQYBSABKAgiRgoVTGlzdFJldmlzaW9uc1Jlc3BvbnNlEi0KCXJldmlzaW9ucxgBIAMoCzIaLnlvcmtpZS52MS5SZXZpc2lvblN1bW1hcnkiVQoWUmVzdG9yZVJldmlzaW9uUmVxdWVzdBIRCgljbGllbnRfaWQYASABKAkSEwoLZG9jdW1lbnRfaWQYAiABKAkSEwoLcmV2aXNpb25faWQYBCABKAkiGQoXUmVzdG9yZVJldmlzaW9uUmVzcG9uc2UiPgoUQXR0YWNoQ2hhbm5lbFJlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2NoYW5uZWxfa2V5GAIgASgJIkIKFUF0dGFjaENoYW5uZWxSZXNwb25zZRISCgpzZXNzaW9uX2lkGAEgASgJEhUKDXNlc3Npb25fY291bnQYAiABKAMiUgoURGV0YWNoQ2hhbm5lbFJlcXVlc3QSEQoJY2xpZW50X2lkGAEgASgJEhMKC2NoYW5uZWxfa2V5GAIgASgJEhIKCnNlc3Npb25faWQYAyABKAkiLgoVRGV0YWNoQ2hhbm5lbFJlc3BvbnNlEhUKDXNlc3Npb25fY291bnQYASABKAMi2gEKFVJlZnJlc2hDaGFubmVsUmVxdWVzdBIRCgljbGllbnRfaWQYASABKAkSEwoLY2hhbm5lbF9rZXkYAiABKAkSEgoKc2Vzc2lvbl9pZBgDIAEoCRISCgpjbGllbnRfa2V5GAQgASgJEkAKCG1ldGFkYXRhGAUgAygLMi4ueW9ya2llLnYxLlJlZnJlc2hDaGFubmVsUmVxdWVzdC5NZXRhZGF0YUVudHJ5Gi8KDU1ldGFkYXRhRW50cnkSCwoDa2V5GAEgASgJEg0KBXZhbHVlGAIgASgJOgI4ASJWChZSZWZyZXNoQ2hhbm5lbFJlc3BvbnNlEhUKDXNlc3Npb25fY291bnQYASABKAMSEQoJY2xpZW50X2lkGAIgASgJEhIKCnNlc3Npb25faWQYAyABKAkiKQoSUGVla0NoYW5uZWxSZXF1ZXN0EhMKC2NoYW5uZWxfa2V5GAEgASgJIiwKE1BlZWtDaGFubmVsUmVzcG9uc2USFQoNc2Vzc2lvbl9jb3VudBgBIAEoAyJaChBCcm9hZGNhc3RSZXF1ZXN0EhEKCWNsaWVudF9pZBgBIAEoCRITCgtjaGFubmVsX2tleRgCIAEoCRINCgV0b3BpYxgDIAEoCRIPCgdwYXlsb2FkGAQgASgMIhMKEUJyb2FkY2FzdFJlc3BvbnNlMpUMCg1Zb3JraWVTZXJ2aWNlElcKDkFjdGl2YXRlQ2xpZW50EiAueW9ya2llLnYxLkFjdGl2YXRlQ2xpZW50UmVxdWVzdBohLnlvcmtpZS52MS5BY3RpdmF0ZUNsaWVudFJlc3BvbnNlIgASXQoQRGVhY3RpdmF0ZUNsaWVudBIiLnlvcmtpZS52MS5EZWFjdGl2YXRlQ2xpZW50UmVxdWVzdBojLnlvcmtpZS52MS5EZWFjdGl2YXRlQ2xpZW50UmVzcG9uc2UiABJXCg5BdHRhY2hEb2N1bWVudBIgLnlvcmtpZS52MS5BdHRhY2hEb2N1bWVudFJlcXVlc3QaIS55b3JraWUudjEuQXR0YWNoRG9jdW1lbnRSZXNwb25zZSIAElcKDkRldGFjaERvY3VtZW50EiAueW9ya2llLnYxLkRldGFjaERvY3VtZW50UmVxdWVzdBohLnlvcmtpZS52MS5EZXRhY2hEb2N1bWVudFJlc3BvbnNlIgASVwoOUmVtb3ZlRG9jdW1lbnQSIC55b3JraWUudjEuUmVtb3ZlRG9jdW1lbnRSZXF1ZXN0GiEueW9ya2llLnYxLlJlbW92ZURvY3VtZW50UmVzcG9uc2UiABJaCg9QdXNoUHVsbENoYW5nZXMSIS55b3JraWUudjEuUHVzaFB1bGxDaGFuZ2VzUmVxdWVzdBoiLnlvcmtpZS52MS5QdXNoUHVsbENoYW5nZXNSZXNwb25zZSIAEj4KBVdhdGNoEhcueW9ya2llLnYxLldhdGNoUmVxdWVzdBoYLnlvcmtpZS52MS5XYXRjaFJlc3BvbnNlIgAwARJWCg1XYXRjaERvY3VtZW50Eh8ueW9ya2llLnYxLldhdGNoRG9jdW1lbnRSZXF1ZXN0GiAueW9ya2llLnYxLldhdGNoRG9jdW1lbnRSZXNwb25zZSIAMAESUwoMV2F0Y2hDaGFubmVsEh4ueW9ya2llLnYxLldhdGNoQ2hhbm5lbFJlcXVlc3QaHy55b3JraWUudjEuV2F0Y2hDaGFubmVsUmVzcG9uc2UiADABElcKDkNyZWF0ZVJldmlzaW9uEiAueW9ya2llLnYxLkNyZWF0ZVJldmlzaW9uUmVxdWVzdBohLnlvcmtpZS52MS5DcmVhdGVSZXZpc2lvblJlc3BvbnNlIgASTgoLR2V0UmV2aXNpb24SHS55b3JraWUudjEuR2V0UmV2aXNpb25SZXF1ZXN0Gh4ueW9ya2llLnYxLkdldFJldmlzaW9uUmVzcG9uc2UiABJUCg1MaXN0UmV2aXNpb25zEh8ueW9ya2llLnYxLkxpc3RSZXZpc2lvbnNSZXF1ZXN0GiAueW9ya2llLnYxLkxpc3RSZXZpc2lvbnNSZXNwb25zZSIAEloKD1Jlc3RvcmVSZXZpc2lvbhIhLnlvcmtpZS52MS5SZXN0b3JlUmV2aXNpb25SZXF1ZXN0GiIueW9ya2llLnYxLlJlc3RvcmVSZXZpc2lvblJlc3BvbnNlIgASVAoNQXR0YWNoQ2hhbm5lbBIfLnlvcmtpZS52MS5BdHRhY2hDaGFubmVsUmVxdWVzdBogLnlvcmtpZS52MS5BdHRhY2hDaGFubmVsUmVzcG9uc2UiABJUCg1EZXRhY2hDaGFubmVsEh8ueW9ya2llLnYxLkRldGFjaENoYW5uZWxSZXF1ZXN0GiAueW9ya2llLnYxLkRldGFjaENoYW5uZWxSZXNwb25zZSIAElcKDlJlZnJlc2hDaGFubmVsEiAueW9ya2llLnYxLlJlZnJlc2hDaGFubmVsUmVxdWVzdBohLnlvcmtpZS52MS5SZWZyZXNoQ2hhbm5lbFJlc3BvbnNlIgASTgoLUGVla0NoYW5uZWwSHS55b3JraWUudjEuUGVla0NoYW5uZWxSZXF1ZXN0Gh4ueW9ya2llLnYxLlBlZWtDaGFubmVsUmVzcG9uc2UiABJICglCcm9hZGNhc3QSGy55b3JraWUudjEuQnJvYWRjYXN0UmVxdWVzdBocLnlvcmtpZS52MS5Ccm9hZGNhc3RSZXNwb25zZSIAQkUKEWRldi55b3JraWUuYXBpLnYxUAFaLmdpdGh1Yi5jb20veW9ya2llLXRlYW0veW9ya2llL2FwaS95b3JraWUvdjE7djFiBnByb3RvMw", [file_yorkie_v1_resources]);
 const YorkieService = /* @__PURE__ */ serviceDesc(file_yorkie_v1_yorkie, 0);
 const file_google_rpc_error_details = /* @__PURE__ */ fileDesc("Ch5nb29nbGUvcnBjL2Vycm9yX2RldGFpbHMucHJvdG8SCmdvb2dsZS5ycGMikwEKCUVycm9ySW5mbxIOCgZyZWFzb24YASABKAkSDgoGZG9tYWluGAIgASgJEjUKCG1ldGFkYXRhGAMgAygLMiMuZ29vZ2xlLnJwYy5FcnJvckluZm8uTWV0YWRhdGFFbnRyeRovCg1NZXRhZGF0YUVudHJ5EgsKA2tleRgBIAEoCRINCgV2YWx1ZRgCIAEoCToCOAEiOwoJUmV0cnlJbmZvEi4KC3JldHJ5X2RlbGF5GAEgASgLMhkuZ29vZ2xlLnByb3RvYnVmLkR1cmF0aW9uIjIKCURlYnVnSW5mbxIVCg1zdGFja19lbnRyaWVzGAEgAygJEg4KBmRldGFpbBgCIAEoCSKPAwoMUXVvdGFGYWlsdXJlEjYKCnZpb2xhdGlvbnMYASADKAsyIi5nb29nbGUucnBjLlF1b3RhRmFpbHVyZS5WaW9sYXRpb24axgIKCVZpb2xhdGlvbhIPCgdzdWJqZWN0GAEgASgJEhMKC2Rlc2NyaXB0aW9uGAIgASgJEhMKC2FwaV9zZXJ2aWNlGAMgASgJEhQKDHF1b3RhX21ldHJpYxgEIAEoCRIQCghxdW90YV9pZBgFIAEoCRJRChBxdW90YV9kaW1lbnNpb25zGAYgAygLMjcuZ29vZ2xlLnJwYy5RdW90YUZhaWx1cmUuVmlvbGF0aW9uLlF1b3RhRGltZW5zaW9uc0VudHJ5EhMKC3F1b3RhX3ZhbHVlGAcgASgDEh8KEmZ1dHVyZV9xdW90YV92YWx1ZRgIIAEoA0gAiAEBGjYKFFF1b3RhRGltZW5zaW9uc0VudHJ5EgsKA2tleRgBIAEoCRINCgV2YWx1ZRgCIAEoCToCOAFCFQoTX2Z1dHVyZV9xdW90YV92YWx1ZSKVAQoTUHJlY29uZGl0aW9uRmFpbHVyZRI9Cgp2aW9sYXRpb25zGAEgAygLMikuZ29vZ2xlLnJwYy5QcmVjb25kaXRpb25GYWlsdXJlLlZpb2xhdGlvbho/CglWaW9sYXRpb24SDAoEdHlwZRgBIAEoCRIPCgdzdWJqZWN0GAIgASgJEhMKC2Rlc2NyaXB0aW9uGAMgASgJIswBCgpCYWRSZXF1ZXN0Ej8KEGZpZWxkX3Zpb2xhdGlvbnMYASADKAsyJS5nb29nbGUucnBjLkJhZFJlcXVlc3QuRmllbGRWaW9sYXRpb24afQoORmllbGRWaW9sYXRpb24SDQoFZmllbGQYASABKAkSEwoLZGVzY3JpcHRpb24YAiABKAkSDgoGcmVhc29uGAMgASgJEjcKEWxvY2FsaXplZF9tZXNzYWdlGAQgASgLMhwuZ29vZ2xlLnJwYy5Mb2NhbGl6ZWRNZXNzYWdlIjcKC1JlcXVlc3RJbmZvEhIKCnJlcXVlc3RfaWQYASABKAkSFAoMc2VydmluZ19kYXRhGAIgASgJImAKDFJlc291cmNlSW5mbxIVCg1yZXNvdXJjZV90eXBlGAEgASgJEhUKDXJlc291cmNlX25hbWUYAiABKAkSDQoFb3duZXIYAyABKAkSEwoLZGVzY3JpcHRpb24YBCABKAkiVgoESGVscBIkCgVsaW5rcxgBIAMoCzIVLmdvb2dsZS5ycGMuSGVscC5MaW5rGigKBExpbmsSEwoLZGVzY3JpcHRpb24YASABKAkSCwoDdXJsGAIgASgJIjMKEExvY2FsaXplZE1lc3NhZ2USDgoGbG9jYWxlGAEgASgJEg8KB21lc3NhZ2UYAiABKAlCbAoOY29tLmdvb2dsZS5ycGNCEUVycm9yRGV0YWlsc1Byb3RvUAFaP2dvb2dsZS5nb2xhbmcub3JnL2dlbnByb3RvL2dvb2dsZWFwaXMvcnBjL2VycmRldGFpbHM7ZXJyZGV0YWlsc6ICA1JQQ2IGcHJvdG8z", [file_google_protobuf_duration]);
 const ErrorInfoSchema = /* @__PURE__ */ messageDesc(file_google_rpc_error_details, 0);
@@ -5878,6 +5878,7 @@ var Code = /* @__PURE__ */ ((Code2) => {
   Code2["ErrDummy"] = "ErrDummy";
   Code2["ErrNotAttached"] = "ErrNotAttached";
   Code2["ErrNotDetached"] = "ErrNotDetached";
+  Code2["ErrSessionNotFound"] = "ErrSessionNotFound";
   Code2["ErrDocumentRemoved"] = "ErrDocumentRemoved";
   Code2["ErrDocumentSizeExceedsLimit"] = "ErrDocumentSizeExceedsLimit";
   Code2["ErrDocumentSchemaValidationFailed"] = "ErrDocumentSchemaValidationFailed";
@@ -20781,12 +20782,25 @@ class Document {
 }
 class Attachment {
   resource;
+  /**
+   * For Documents: the document's resourceID, available at attach time.
+   * For Channels: the server-issued session_id. Starts empty and is
+   * populated after the first `RefreshChannel` first-call response.
+   */
   resourceID;
   syncMode;
   changeEventReceived;
   lastHeartbeatTime;
   pollInterval;
   pollIntervalPinned;
+  /**
+   * `unsubscribeLocalBroadcast` is set by `attachChannel` when it forwards
+   * a Channel's `local-broadcast` events to the RPC client, and consumed
+   * by `detachInternal` so the subscription does not survive a detach.
+   * Without this, re-attaching a channel accumulates duplicate handlers
+   * on each attach cycle.
+   */
+  unsubscribeLocalBroadcast;
   reconnectStreamDelay;
   cancelled;
   watchStream;
@@ -20794,13 +20808,13 @@ class Attachment {
   watchAbortController;
   syncPromise;
   _detaching = false;
-  constructor(reconnectStreamDelay, resource, resourceID, syncMode, pollInterval = 0, pollIntervalPinned = false) {
+  constructor(reconnectStreamDelay, resource, resourceID = "", syncMode, pollInterval = 0, pollIntervalPinned = false) {
     this.reconnectStreamDelay = reconnectStreamDelay;
     this.resource = resource;
     this.resourceID = resourceID;
     this.syncMode = syncMode;
     this.changeEventReceived = syncMode !== void 0 ? false : void 0;
-    this.lastHeartbeatTime = Date.now();
+    this.lastHeartbeatTime = 0;
     this.pollInterval = pollInterval;
     this.pollIntervalPinned = pollIntervalPinned;
     this.cancelled = false;
@@ -20962,7 +20976,7 @@ function createAuthInterceptor(apiKey, token) {
   };
 }
 const name = "@yorkie-js/sdk";
-const version = "0.7.9";
+const version = "0.7.10-rc";
 const pkg = {
   name,
   version
@@ -21000,6 +21014,7 @@ var ChannelEventType = /* @__PURE__ */ ((ChannelEventType2) => {
   ChannelEventType2["Broadcast"] = "broadcast";
   ChannelEventType2["LocalBroadcast"] = "local-broadcast";
   ChannelEventType2["AuthError"] = "auth-error";
+  ChannelEventType2["SyncError"] = "sync-error";
   return ChannelEventType2;
 })(ChannelEventType || {});
 const KeyPathSeparator = ".";
@@ -21139,6 +21154,13 @@ class Channel2 {
         }
       });
     }
+    if (typeOrTopic === "sync-error") {
+      return this.eventStream.subscribe((event) => {
+        if (event.type === "sync-error") {
+          callback(event);
+        }
+      });
+    }
     if (typeOrTopic === "presence") {
       return this.eventStream.subscribe((event) => {
         if (event.type === "presence-changed" || event.type === "initialized") {
@@ -21258,13 +21280,14 @@ var ClientCondition = /* @__PURE__ */ ((ClientCondition2) => {
   ClientCondition2["WatchLoop"] = "WatchLoop";
   return ClientCondition2;
 })(ClientCondition || {});
-const DefaultPollingIntervalMs = 3e3;
+const DefaultDocumentPollIntervalMs = 3e3;
+const DefaultChannelHeartbeatMs = 5e3;
 const DefaultClientOptions = {
   rpcAddr: "https://api.yorkie.dev",
   syncLoopDuration: 50,
   retrySyncLoopDelay: 1e3,
   reconnectStreamDelay: 1e3,
-  channelHeartbeatInterval: 3e4
+  channelHeartbeatInterval: DefaultChannelHeartbeatMs
 };
 const DefaultBroadcastOptions = {
   maxRetries: Infinity,
@@ -21461,7 +21484,7 @@ class Client {
       );
     }
     const pollIntervalPinned = opts.documentPollInterval !== void 0;
-    const pollInterval = pollIntervalPinned ? opts.documentPollInterval : syncMode === "polling" ? DefaultPollingIntervalMs : 0;
+    const pollInterval = pollIntervalPinned ? opts.documentPollInterval : syncMode === "polling" ? DefaultDocumentPollIntervalMs : 0;
     return this.enqueueTask(async () => {
       try {
         const res = await this.rpcClient.attachDocument(
@@ -21590,127 +21613,88 @@ class Client {
     return this.enqueueTask(task);
   }
   /**
-   * `attach` attaches the given channel to this client.
-   * It tells the server that this client will track the channel.
+   * `attachChannel` attaches the given channel to this client. The channel is
+   * registered locally and the server is notified on the next RefreshChannel
+   * heartbeat.
    */
   async attachChannel(channel, opts = {}) {
-    if (!this.isActive()) {
-      throw new YorkieError(
-        Code.ErrClientNotActivated,
-        `${this.key} is not active`
-      );
-    }
     if (channel.getStatus() !== ChannelStatus.Detached) {
       throw new YorkieError(
         Code.ErrNotDetached,
         `${channel.getKey()} is not detached`
       );
     }
-    channel.setActor(this.id);
+    const syncMode = opts.syncMode ?? "realtime";
+    this.assertValidChannelSyncMode(syncMode);
+    if (opts.channelHeartbeatInterval !== void 0 && opts.channelHeartbeatInterval <= 0) {
+      throw new YorkieError(
+        Code.ErrInvalidArgument,
+        "channelHeartbeatInterval must be greater than 0"
+      );
+    }
+    const pollIntervalPinned = opts.channelHeartbeatInterval !== void 0;
+    const pollInterval = opts.channelHeartbeatInterval ?? this.channelHeartbeatInterval;
     const task = async () => {
-      try {
-        const res = await this.rpcClient.attachChannel(
-          {
-            clientId: this.id,
-            channelKey: channel.getKey()
-          },
-          {
-            headers: {
-              "x-shard-key": `${this.apiKey}/${channel.getFirstKeyPath()}`
-            }
-          }
-        );
-        channel.setSessionID(res.sessionId);
-        channel.updateSessionCount(Number(res.sessionCount), 0);
-        channel.applyStatus(ChannelStatus.Attached);
-        const syncMode = opts.syncMode ?? "realtime";
-        this.assertValidChannelSyncMode(syncMode);
-        if (opts.channelHeartbeatInterval !== void 0 && opts.channelHeartbeatInterval <= 0) {
-          throw new YorkieError(
-            Code.ErrInvalidArgument,
-            "channelHeartbeatInterval must be greater than 0"
-          );
-        }
-        const pollIntervalPinned = opts.channelHeartbeatInterval !== void 0;
-        const pollInterval = pollIntervalPinned ? opts.channelHeartbeatInterval : syncMode === "polling" ? DefaultPollingIntervalMs : this.channelHeartbeatInterval;
-        const attachment = new Attachment(
-          this.reconnectStreamDelay,
-          channel,
-          res.sessionId,
-          syncMode,
-          pollInterval,
-          pollIntervalPinned
-        );
-        channel.subscribe("local-broadcast", (event) => {
+      if (this.id) {
+        channel.setActor(this.id);
+      }
+      const attachment = new Attachment(
+        this.reconnectStreamDelay,
+        channel,
+        "",
+        // sessionID populated on first refresh response
+        syncMode,
+        pollInterval,
+        pollIntervalPinned
+      );
+      attachment.unsubscribeLocalBroadcast = channel.subscribe(
+        "local-broadcast",
+        (event) => {
           const { topic, payload, options } = event;
           this.broadcast(channel.getKey(), topic, payload, options).catch(
             (error) => {
-              if (options?.error) {
-                options.error(error);
-              }
+              if (options?.error) options.error(error);
               logger.error(`[BC] c:"${this.getKey()}" failed: ${error}`);
             }
           );
-        });
-        this.attachmentMap.set(channel.getKey(), attachment);
-        if (syncMode === "realtime") {
-          await this.runWatchLoop(channel.getKey());
         }
-        logger.info(
-          `[AP] c:"${this.getKey()}" attaches p:"${channel.getKey()}" mode:${syncMode} count:${channel.getSessionCount()}`
-        );
-        return channel;
-      } catch (err) {
-        logger.error(`[AP] c:"${this.getKey()}" err :`, err);
-        await this.handleConnectError(err);
-        throw err;
+      );
+      this.attachmentMap.set(channel.getKey(), attachment);
+      if (!this.conditions[
+        "SyncLoop"
+        /* SyncLoop */
+      ]) {
+        this.runSyncLoop();
       }
+      logger.info(
+        `[AP] c:"${this.getKey()}" attaches p:"${channel.getKey()}" mode:${syncMode}`
+      );
+      return channel;
     };
     return this.enqueueTask(task);
   }
   /**
-   * `detachChannel` detaches the given channel from this client.
-   * It tells the server that this client will no longer track the channel.
+   * `detachChannel` detaches the given channel from this client. The detach
+   * is a local cleanup; the server reclaims the session via TTL when
+   * heartbeats stop.
    */
   async detachChannel(channel) {
-    if (!this.isActive()) {
-      throw new YorkieError(
-        Code.ErrClientNotActivated,
-        `${this.key} is not active`
-      );
-    }
-    if (!this.attachmentMap.has(channel.getKey())) {
+    const attachment = this.attachmentMap.get(channel.getKey());
+    if (!attachment) {
       throw new YorkieError(
         Code.ErrNotAttached,
         `${channel.getKey()} is not attached`
       );
     }
+    attachment.markDetaching();
+    await attachment.waitForSyncComplete();
     const task = async () => {
-      try {
-        const res = await this.rpcClient.detachChannel(
-          {
-            clientId: this.id,
-            channelKey: channel.getKey(),
-            sessionId: channel.getSessionID()
-          },
-          {
-            headers: {
-              "x-shard-key": `${this.apiKey}/${channel.getFirstKeyPath()}`
-            }
-          }
-        );
-        channel.updateSessionCount(Number(res.sessionCount), 0);
-        channel.applyStatus(ChannelStatus.Detached);
-        this.detachInternal(channel.getKey());
-        logger.info(
-          `[DP] c:"${this.getKey()}" detaches p:"${channel.getKey()}" count:${channel.getSessionCount()}`
-        );
-        return channel;
-      } catch (err) {
-        logger.error(`[DP] c:"${this.getKey()}" err :`, err);
-        await this.handleConnectError(err);
-        throw err;
-      }
+      channel.applyStatus(ChannelStatus.Detached);
+      this.detachInternal(channel.getKey());
+      logger.info(
+        `[DP] c:"${this.getKey()}" detaches p:"${channel.getKey()}" (local)`
+      );
+      return channel;
     };
     return this.enqueueTask(task);
   }
@@ -21751,7 +21735,7 @@ class Client {
       attachment.changeEventReceived = true;
     }
     if (!attachment.pollIntervalPinned) {
-      attachment.pollInterval = syncMode === "polling" ? DefaultPollingIntervalMs : 0;
+      attachment.pollInterval = syncMode === "polling" ? DefaultDocumentPollIntervalMs : 0;
     }
     if ((prevSyncMode === "manual" || prevSyncMode === "polling") && syncMode !== "manual" && syncMode !== "polling") {
       attachment.resetCancelled();
@@ -21772,12 +21756,6 @@ class Client {
     }
   }
   async changeChannelSyncMode(channel, syncMode) {
-    if (!this.isActive()) {
-      throw new YorkieError(
-        Code.ErrClientNotActivated,
-        `${this.key} is not active`
-      );
-    }
     const attachment = this.attachmentMap.get(channel.getKey());
     if (!attachment) {
       throw new YorkieError(
@@ -21795,7 +21773,7 @@ class Client {
     }
     attachment.changeSyncMode(syncMode);
     if (!attachment.pollIntervalPinned) {
-      attachment.pollInterval = syncMode === "polling" ? DefaultPollingIntervalMs : syncMode === "realtime" ? this.channelHeartbeatInterval : 0;
+      attachment.pollInterval = syncMode === "manual" ? 0 : this.channelHeartbeatInterval;
     }
     if (syncMode === "realtime") {
       attachment.resetCancelled();
@@ -21807,7 +21785,7 @@ class Client {
    * `sync` implementation that handles both Document and Channel.
    */
   sync(resource) {
-    if (!this.isActive()) {
+    if (!(resource instanceof Channel2) && !this.isActive()) {
       throw new YorkieError(
         Code.ErrClientNotActivated,
         `${this.key} is not active`
@@ -22134,12 +22112,6 @@ class Client {
    * subscribe to channel events. Polling is the caller's responsibility.
    */
   async peekChannel(channelKey) {
-    if (!this.isActive()) {
-      throw new YorkieError(
-        Code.ErrClientNotActivated,
-        `${this.key} is not active`
-      );
-    }
     return this.enqueueTask(async () => {
       const firstKeyPath = channelKey.split(".")[0];
       const res = await this.rpcClient.peekChannel(
@@ -22157,12 +22129,6 @@ class Client {
    * `broadcast` broadcasts the given payload to the given topic.
    */
   async broadcast(key, topic, payload, options) {
-    if (!this.isActive()) {
-      throw new YorkieError(
-        Code.ErrClientNotActivated,
-        `${this.key} is not active`
-      );
-    }
     const attachment = this.attachmentMap.get(key);
     if (!attachment) {
       throw new YorkieError(Code.ErrNotAttached, `${key} is not attached`);
@@ -22239,8 +22205,16 @@ class Client {
    */
   runSyncLoop() {
     const doLoop = async () => {
-      if (!this.isActive() || this.deactivating) {
-        logger.debug(`[SL] c:"${this.getKey()}" exit sync loop`);
+      if (this.deactivating) {
+        logger.debug(`[SL] c:"${this.getKey()}" exit sync loop (deactivating)`);
+        this.conditions[
+          "SyncLoop"
+          /* SyncLoop */
+        ] = false;
+        return;
+      }
+      if (!this.isActive() && this.attachmentMap.size === 0) {
+        logger.debug(`[SL] c:"${this.getKey()}" exit sync loop (idle)`);
         this.conditions[
           "SyncLoop"
           /* SyncLoop */
@@ -22626,6 +22600,10 @@ class Client {
       return;
     }
     attachment.cancelWatchStream();
+    if (attachment.unsubscribeLocalBroadcast) {
+      attachment.unsubscribeLocalBroadcast();
+      attachment.unsubscribeLocalBroadcast = void 0;
+    }
     if (attachment.resource instanceof Document) {
       attachment.resource.resetOnlineClients();
     }
@@ -22634,12 +22612,17 @@ class Client {
   async syncInternal(attachment, syncMode) {
     const { resource } = attachment;
     if (resource instanceof Channel2) {
+      const isFirstCall = !resource.getSessionID();
       try {
         const res = await this.rpcClient.refreshChannel(
           {
-            clientId: this.id,
+            clientId: this.id ?? "",
             channelKey: resource.getKey(),
-            sessionId: resource.getSessionID()
+            sessionId: resource.getSessionID() ?? "",
+            // First-call only — these fields are ignored by the server
+            // once a session_id is established.
+            clientKey: isFirstCall ? this.key : "",
+            metadata: isFirstCall ? this.metadata : {}
           },
           {
             headers: {
@@ -22647,6 +22630,31 @@ class Client {
             }
           }
         );
+        if (isFirstCall) {
+          if (this.deactivating || attachment.isDetaching()) {
+            return resource;
+          }
+          if (res.clientId && !this.id) {
+            this.id = res.clientId;
+            this.status = "activated";
+            resource.setActor(res.clientId);
+          } else if (this.id) {
+            resource.setActor(this.id);
+          }
+          if (res.sessionId) {
+            resource.setSessionID(res.sessionId);
+            attachment.resourceID = res.sessionId;
+            resource.applyStatus(ChannelStatus.Attached);
+          }
+          if (attachment.syncMode === "realtime") {
+            this.runWatchLoop(resource.getKey()).catch((err) => {
+              logger.error(
+                `[WP] c:"${this.getKey()}" failed to start watch for p:"${resource.getKey()}":`,
+                err
+              );
+            });
+          }
+        }
         const prevCount = resource.getSessionCount();
         if (resource.updateSessionCount(Number(res.sessionCount), 0)) {
           if (resource.getSessionCount() !== prevCount) {
@@ -22661,6 +22669,21 @@ class Client {
           `[RP] c:"${this.getKey()}" refreshes p:"${resource.getKey()}" mode:${attachment.syncMode}`
         );
       } catch (err) {
+        if (isErrorCode(err, Code.ErrSessionNotFound)) {
+          logger.info(
+            `[RP] c:"${this.getKey()}" session expired for p:"${resource.getKey()}", re-attaching`
+          );
+          resource.setSessionID("");
+          attachment.resourceID = "";
+          return resource;
+        }
+        if (!this.deactivating && !attachment.isDetaching()) {
+          resource.publish({
+            type: ChannelEventType.SyncError,
+            error: err,
+            method: "RefreshChannel"
+          });
+        }
         logger.error(`[RP] c:"${this.getKey()}" err :`, err);
         throw err;
       }