snapreq 0.0.4 → 0.0.8

package/src/websocket/websocket-channel.js

@@ -1,176 +0,0 @@
-// @ts-check
-
-/**
- * Client-side handle for a channel subscription opened via
- * `SnapReqWebSocketClient.subscribeChannel()`. Mirrors the server's
- * subscription lifecycle — `subscribed` (resolves `ready`) / `onMessage` /
- * `onClose`.
- */
-export default class SnapReqWebSocketChannel {
-  /**
-   * @param {object} args - Channel arguments.
-   * @param {import("./websocket-client.js").default} args.client - Owning client.
-   * @param {string} args.subscriptionId - Generated id unique within the session.
-   * @param {string} args.channelType - Name the server registered the channel under.
-   * @param {Record<string, any>} [args.params] - Opaque params forwarded to the server.
-   * @param {string} [args.lastEventId] - Resume replay from this event id.
-   * @param {(body: any) => void} [args.onMessage] - Fired on each `channel-message` from the server.
-   * @param {() => void} [args.onDisconnect] - Fired when the socket drops.
-   * @param {() => void} [args.onResume] - Fired when the session resumes after a drop.
-   * @param {(reason: string) => void} [args.onClose] - Fired exactly once when the subscription closes permanently.
-   */
-  constructor({client, subscriptionId, channelType, params, lastEventId, onMessage, onDisconnect, onResume, onClose}) {
-    this.client = client
-    this.subscriptionId = subscriptionId
-    this.channelType = channelType
-    this.params = params || {}
-    this.lastEventId = lastEventId
-    this._onMessage = onMessage
-    this._onDisconnect = onDisconnect
-    this._onResume = onResume
-    this._onClose = onClose
-    this._ready = false
-    this._resumeReadyOnResume = false
-    this._subscribed = false
-    this._subscribeSent = false
-    this._closed = false
-  }
-
-  /** @returns {Promise<void>} - Resolves once the subscription is acknowledged. */
-  _ensureReadyPromise() {
-    if (!this._readyPromise || !this._resolveReady || !this._rejectReady) {
-      /** @type {Promise<void>} */
-      this._readyPromise = new Promise((resolve, reject) => {
-        this._resolveReady = resolve
-        this._rejectReady = reject
-      })
-    }
-
-    return this._readyPromise
-  }
-
-  /** @returns {Promise<void>} - Resolves once the subscription is acknowledged. */
-  get ready() {
-    return this._ensureReadyPromise()
-  }
-
-  /** @returns {void} */
-  _resolveReadyState() {
-    this._ready = true
-    this._resolveReady?.()
-    this._resolveReady = null
-    this._rejectReady = null
-  }
-
-  /** @returns {void} */
-  _markNotReady() {
-    this._ready = false
-  }
-
-  /** @returns {void} */
-  _handleSubscribed() {
-    if (this._closed || this._subscribed) return
-    this._subscribed = true
-    this._resolveReadyState()
-  }
-
-  /** @returns {void} */
-  _markSubscribeSent() {
-    this._subscribeSent = true
-  }
-
-  /** @returns {boolean} - Whether the subscription still needs to be sent. */
-  _needsSubscribe() {
-    return !this._closed && !this._subscribeSent
-  }
-
-  /**
-   * @param {any} body - Message payload.
-   * @returns {void}
-   */
-  _handleMessage(body) {
-    if (this._closed) return
-    this._onMessage?.(body)
-  }
-
-  /** @returns {void} */
-  _handleDisconnected() {
-    if (this._closed) return
-    this._resumeReadyOnResume ||= this._subscribed
-    this._subscribed = false
-    this._markNotReady()
-    this._onDisconnect?.()
-  }
-
-  /** @returns {void} */
-  _handleResumed() {
-    if (this._closed) return
-    if (this._resumeReadyOnResume) {
-      this._subscribed = true
-      this._resolveReadyState()
-    }
-    this._resumeReadyOnResume = false
-    this._onResume?.()
-  }
-
-  /**
-   * @param {string} reason - Why the subscription closed.
-   * @returns {void}
-   */
-  _handleClosed(reason) {
-    if (this._closed) return
-    this._closed = true
-
-    try {
-      this._onClose?.(reason)
-    } finally {
-      this._resumeReadyOnResume = false
-      if (!this._ready) {
-        this._rejectReady?.(new Error(`Subscription closed before acknowledgement: ${reason}`))
-      }
-
-      this._resolveReady = null
-      this._rejectReady = null
-    }
-  }
-
-  /**
-   * @param {{timeoutMs?: number}} [params] - Options.
-   * @returns {Promise<void>} - Resolves once ready or rejects on timeout.
-   */
-  async waitForReady({timeoutMs = 5000} = {}) {
-    if (this._ready) return
-
-    const readyPromise = this._ensureReadyPromise()
-    const timeoutPromise = new Promise((_, reject) => {
-      setTimeout(() => reject(new Error(`Subscription not ready after ${timeoutMs}ms`)), timeoutMs)
-    })
-
-    await Promise.race([readyPromise, timeoutPromise])
-  }
-
-  /** @returns {void} */
-  close() {
-    if (this._closed) return
-
-    try {
-      if (this.client.isOpen()) {
-        this.client._sendMessage({type: "channel-unsubscribe", subscriptionId: this.subscriptionId})
-      }
-    } catch {
-      // Socket already gone; server will clean up on session teardown.
-    }
-
-    this.client._removeChannelSubscription(this.subscriptionId)
-    this._handleClosed("client_unsubscribe")
-  }
-
-  /** @returns {boolean} - Whether the subscription is closed. */
-  isClosed() { return this._closed }
-
-  /** @returns {boolean} - Whether the subscription is acknowledged and ready. */
-  isReady() { return this._ready }
-
-  /** @returns {boolean} - Whether the subscription is active. */
-  isSubscribed() { return this._subscribed && !this._closed }
-}