@wix/realtime 1.0.34 → 1.0.35

package/es/build/publisher/publisher.context.d.ts

@@ -1,41 +1,41 @@
 import { publish as publicPublish } from './publisher.public.js';
 import type { BuildRESTFunction, MaybeContext } from '@wix/sdk-types';
 /**
- * Publishes a message to a channel or channel resource.
+ * Publishes a message to a channel or resource.
  *
- * All subscribers currently listening to the specified channel receive the
- * message. Subscribers to a channel don't receive messages published to a
- * resource on that channel, and vice versa.
+ * The method publishes a message to all subscriptions on the specified channel or resource. Channels and resources are isolated, so subscribers to a channel don't receive messages published to a resource. Similarly, subscribers to a resource don't receive messages published to the parent channel.
  *
- * This method is backend-only and requires elevated permissions.
+ * > **Authentication**
+ * >
+ * > This method may require higher-level permissions than the caller has, based on their [identity](https://dev.wix.com/docs/api-reference/articles/authentication/about-identities) and [roles and permissions](https://support.wix.com/en/article/roles-permissions-overview). In these cases, you can ensure the method is called with the required level of authorization by using [elevated permissions](https://dev.wix.com/docs/api-reference/articles/authentication/about-elevated-permissions).
  *
  * <!-- TODO: Check whether this API is relevant for headless projects. -->
  *
- * > **Note:** This function requires elevated permissions and runs only on the backend.
- * > You can also call this method from the frontend using `elevate()`.
- * > Elevated permissions are only available for apps and service accounts.
- *
- * @example Manual client (self-hosted / explicit auth)
+ * @example Publish a message to the specified channel
  * ```ts
  * import { publisher } from '@wix/realtime';
- * import { createClient, AppStrategy } from '@wix/sdk';
+ * import { elevate } from '@wix/sdk/context';
  *
- * const client = createClient({
- *   modules: { publisher },
- *   auth: AppStrategy({ appId, appSecret, instanceId }),
- * });
- * await client.publisher.publish({ name: 'my-channel' }, { message: 'hello' });
+ * await elevate(publisher.publish)({ name: 'my-channel' }, { message: 'hello' });
  * ```
  *
- * @example Contextual client (Wix-hosted)
+ * @example Publish a message to the specified channel: Self-hosted
  * ```ts
  * import { publisher } from '@wix/realtime';
- * import { elevate } from '@wix/sdk/context';
+ * import { createClient } from '@wix/sdk';
  *
- * await elevate(publisher.publish)({ name: 'my-channel' }, { message: 'hello' });
+ * // Import the auth strategy for the relevant access type
+ * // Import the relevant host module if needed
+ *
+ * const client = createClient({
+ *   modules: { publisher },
+ *   // Include the auth strategy and host as relevant
+ * });
+ *
+ * await client.publisher.publish({ name: 'my-channel' }, { message: 'hello' });
  * ```
  *
- * @param channel - Channel, and optionally resource, to publish to.
+ * @param channel - Channel or resource to publish to.
  * @param payload - Message payload. Max: 10 KB.
  */
 export declare const publish: MaybeContext<BuildRESTFunction<typeof publicPublish> & typeof publicPublish>;

package/es/build/publisher/publisher.context.js

@@ -1,41 +1,41 @@
 import { publish as publicPublish } from './publisher.public.js';
 import { createRESTModule } from '@wix/sdk-runtime/rest-modules';
 /**
- * Publishes a message to a channel or channel resource.
+ * Publishes a message to a channel or resource.
  *
- * All subscribers currently listening to the specified channel receive the
- * message. Subscribers to a channel don't receive messages published to a
- * resource on that channel, and vice versa.
+ * The method publishes a message to all subscriptions on the specified channel or resource. Channels and resources are isolated, so subscribers to a channel don't receive messages published to a resource. Similarly, subscribers to a resource don't receive messages published to the parent channel.
  *
- * This method is backend-only and requires elevated permissions.
+ * > **Authentication**
+ * >
+ * > This method may require higher-level permissions than the caller has, based on their [identity](https://dev.wix.com/docs/api-reference/articles/authentication/about-identities) and [roles and permissions](https://support.wix.com/en/article/roles-permissions-overview). In these cases, you can ensure the method is called with the required level of authorization by using [elevated permissions](https://dev.wix.com/docs/api-reference/articles/authentication/about-elevated-permissions).
  *
  * <!-- TODO: Check whether this API is relevant for headless projects. -->
  *
- * > **Note:** This function requires elevated permissions and runs only on the backend.
- * > You can also call this method from the frontend using `elevate()`.
- * > Elevated permissions are only available for apps and service accounts.
- *
- * @example Manual client (self-hosted / explicit auth)
+ * @example Publish a message to the specified channel
  * ```ts
  * import { publisher } from '@wix/realtime';
- * import { createClient, AppStrategy } from '@wix/sdk';
+ * import { elevate } from '@wix/sdk/context';
  *
- * const client = createClient({
- *   modules: { publisher },
- *   auth: AppStrategy({ appId, appSecret, instanceId }),
- * });
- * await client.publisher.publish({ name: 'my-channel' }, { message: 'hello' });
+ * await elevate(publisher.publish)({ name: 'my-channel' }, { message: 'hello' });
  * ```
  *
- * @example Contextual client (Wix-hosted)
+ * @example Publish a message to the specified channel: Self-hosted
  * ```ts
  * import { publisher } from '@wix/realtime';
- * import { elevate } from '@wix/sdk/context';
+ * import { createClient } from '@wix/sdk';
  *
- * await elevate(publisher.publish)({ name: 'my-channel' }, { message: 'hello' });
+ * // Import the auth strategy for the relevant access type
+ * // Import the relevant host module if needed
+ *
+ * const client = createClient({
+ *   modules: { publisher },
+ *   // Include the auth strategy and host as relevant
+ * });
+ *
+ * await client.publisher.publish({ name: 'my-channel' }, { message: 'hello' });
  * ```
  *
- * @param channel - Channel, and optionally resource, to publish to.
+ * @param channel - Channel or resource to publish to.
  * @param payload - Message payload. Max: 10 KB.
  */
 export const publish = /*#__PURE__*/ createRESTModule(publicPublish);

package/es/build/subscriber/subscriber.context.d.ts

@@ -1,48 +1,46 @@
 import { subscribe as publicSubscribe, unsubscribe as publicUnsubscribe } from './subscriber.public.js';
 import type { BuildRESTFunction, MaybeContext } from '@wix/sdk-types';
 /**
- * Subscribes to a channel or channel resource.
+ * Subscribes to a channel or resource.
  *
- * The method returns a subscription ID immediately. The connection is
- * established asynchronously in the background. Use the `options` parameter
- * to register lifecycle handlers that notify you when the subscription
- * succeeds or encounters an error.
+ * The method attempts to establish a subscription to the specified channel or resource. While the subscription is attempted asynchronously, the method returns the subscription ID immediately.
  *
- * If the connection drops, the client automatically attempts to reconnect
- * and re-subscribe. The `onSubscribed` handler fires again on each
- * successful re-subscription.
+ * Use the `options` parameter to register handlers that run whenever the subscription succeeds or generates an error. For some errors, the subscription is re-attempted automatically. The `onSubscribed()` handler runs on every successful re-subscription.
  *
- * @example Manual client (self-hosted / explicit auth)
+ * @example Subscribe to a channel
  * ```ts
  * import { subscriber } from '@wix/realtime';
- * import { createClient, AppStrategy } from '@wix/sdk';
  *
- * const client = createClient({
- *   modules: { subscriber },
- *   auth: AppStrategy({ appId, appSecret, instanceId }),
- * });
- *
- * const subscriptionId = client.subscriber.subscribe(
+ * const subscriptionId = subscriber.subscribe(
  *   { name: 'my-channel' },
  *   (message, channel) => {
  *     console.log('Received:', message.payload);
  *   },
- *   {
- *     onSubscribed: (id, isSynced) => console.log('Subscribed', id),
- *     onSubscriptionError: (error, id) => console.error('Error', error),
- *   },
  * );
  * ```
  *
- * @example Contextual client (Wix-hosted)
+ * @example Subscribe to a channel: Self-hosted
  * ```ts
+ * import { createClient } from '@wix/sdk';
  * import { subscriber } from '@wix/realtime';
  *
- * const subscriptionId = subscriber.subscribe(
+ * // Import the auth strategy for the relevant access type
+ * // Import the relevant host module if needed
+ *
+ * const client = createClient({
+ *   modules: { subscriber },
+ *   // Include the auth strategy and host as relevant
+ * });
+ *
+ * const subscriptionId = client.subscriber.subscribe(
  *   { name: 'my-channel' },
  *   (message, channel) => {
  *     console.log('Received:', message.payload);
  *   },
+ *   {
+ *     onSubscribed: (id, isSynced) => console.log('Subscribed', id),
+ *     onSubscriptionError: (error, id) => console.error('Error', error),
+ *   },
  * );
  * ```
  *
@@ -52,40 +50,43 @@ import type { BuildRESTFunction, MaybeContext } from '@wix/sdk-types';
  */
 export declare const subscribe: MaybeContext<BuildRESTFunction<typeof publicSubscribe> & typeof publicSubscribe>;
 /**
- * Removes one or more subscriptions.
+ * Removes 1 or more subscriptions.
  *
- * You can unsubscribe in three ways:
+ * You can unsubscribe in 3 ways:
  * - By `subscriptionId`: removes a single subscription.
- * - By `channel`: removes all subscriptions to that channel or channel resource.
+ * - By `channel`: removes all subscriptions to that channel or resource.
  * - By both: removes the specific subscription, verifying it matches the channel.
  *
  * When the last subscription on a connection is removed, the connection
  * closes automatically.
  *
- * @example Manual client (self-hosted / explicit auth)
+ * @example Remove the specified subscription.
  * ```ts
  * import { subscriber } from '@wix/realtime';
- * import { createClient, AppStrategy } from '@wix/sdk';
+ *
+ * subscriber.unsubscribe({ subscriptionId });
+ * ```
+ *
+ * @example Remove the specified subscription: Self-hosted
+ * ```ts
+ * import { subscriber } from '@wix/realtime';
+ * import { createClient } from '@wix/sdk';
+ *
+ * // Import the auth strategy for the relevant access type
+ * // Import the relevant host module if needed
  *
  * const client = createClient({
  *   modules: { subscriber },
- *   auth: AppStrategy({ appId, appSecret, instanceId }),
+ *   // Include the auth strategy and host as relevant
  * });
  *
- * // Unsubscribe by subscription ID
+ * // Remove the specified subscription
  * client.subscriber.unsubscribe({ subscriptionId });
  *
- * // Unsubscribe from all subscriptions to a channel
+ * // Remove all subscriptions from the specified channel
  * client.subscriber.unsubscribe({ channel: { name: 'my-channel' } });
  * ```
  *
- * @example Contextual client (Wix-hosted)
- * ```ts
- * import { subscriber } from '@wix/realtime';
- *
- * subscriber.unsubscribe({ subscriptionId });
- * ```
- *
- * @param options - Specifies what to unsubscribe from. At least one of `channel` or `subscriptionId` is required.
+ * @param options - Unsubscribe information. You must specify `channel`, `subscriptionId`, or both.
  */
 export declare const unsubscribe: MaybeContext<BuildRESTFunction<typeof publicUnsubscribe> & typeof publicUnsubscribe>;

package/es/build/subscriber/subscriber.context.js

@@ -1,48 +1,46 @@
 import { subscribe as publicSubscribe, unsubscribe as publicUnsubscribe, } from './subscriber.public.js';
 import { createRESTModule } from '@wix/sdk-runtime/rest-modules';
 /**
- * Subscribes to a channel or channel resource.
+ * Subscribes to a channel or resource.
  *
- * The method returns a subscription ID immediately. The connection is
- * established asynchronously in the background. Use the `options` parameter
- * to register lifecycle handlers that notify you when the subscription
- * succeeds or encounters an error.
+ * The method attempts to establish a subscription to the specified channel or resource. While the subscription is attempted asynchronously, the method returns the subscription ID immediately.
  *
- * If the connection drops, the client automatically attempts to reconnect
- * and re-subscribe. The `onSubscribed` handler fires again on each
- * successful re-subscription.
+ * Use the `options` parameter to register handlers that run whenever the subscription succeeds or generates an error. For some errors, the subscription is re-attempted automatically. The `onSubscribed()` handler runs on every successful re-subscription.
  *
- * @example Manual client (self-hosted / explicit auth)
+ * @example Subscribe to a channel
  * ```ts
  * import { subscriber } from '@wix/realtime';
- * import { createClient, AppStrategy } from '@wix/sdk';
  *
- * const client = createClient({
- *   modules: { subscriber },
- *   auth: AppStrategy({ appId, appSecret, instanceId }),
- * });
- *
- * const subscriptionId = client.subscriber.subscribe(
+ * const subscriptionId = subscriber.subscribe(
  *   { name: 'my-channel' },
  *   (message, channel) => {
  *     console.log('Received:', message.payload);
  *   },
- *   {
- *     onSubscribed: (id, isSynced) => console.log('Subscribed', id),
- *     onSubscriptionError: (error, id) => console.error('Error', error),
- *   },
  * );
  * ```
  *
- * @example Contextual client (Wix-hosted)
+ * @example Subscribe to a channel: Self-hosted
  * ```ts
+ * import { createClient } from '@wix/sdk';
  * import { subscriber } from '@wix/realtime';
  *
- * const subscriptionId = subscriber.subscribe(
+ * // Import the auth strategy for the relevant access type
+ * // Import the relevant host module if needed
+ *
+ * const client = createClient({
+ *   modules: { subscriber },
+ *   // Include the auth strategy and host as relevant
+ * });
+ *
+ * const subscriptionId = client.subscriber.subscribe(
  *   { name: 'my-channel' },
  *   (message, channel) => {
  *     console.log('Received:', message.payload);
  *   },
+ *   {
+ *     onSubscribed: (id, isSynced) => console.log('Subscribed', id),
+ *     onSubscriptionError: (error, id) => console.error('Error', error),
+ *   },
  * );
  * ```
  *
@@ -52,40 +50,43 @@ import { createRESTModule } from '@wix/sdk-runtime/rest-modules';
  */
 export const subscribe = /*#__PURE__*/ createRESTModule(publicSubscribe);
 /**
- * Removes one or more subscriptions.
+ * Removes 1 or more subscriptions.
  *
- * You can unsubscribe in three ways:
+ * You can unsubscribe in 3 ways:
  * - By `subscriptionId`: removes a single subscription.
- * - By `channel`: removes all subscriptions to that channel or channel resource.
+ * - By `channel`: removes all subscriptions to that channel or resource.
  * - By both: removes the specific subscription, verifying it matches the channel.
  *
  * When the last subscription on a connection is removed, the connection
  * closes automatically.
  *
- * @example Manual client (self-hosted / explicit auth)
+ * @example Remove the specified subscription.
  * ```ts
  * import { subscriber } from '@wix/realtime';
- * import { createClient, AppStrategy } from '@wix/sdk';
+ *
+ * subscriber.unsubscribe({ subscriptionId });
+ * ```
+ *
+ * @example Remove the specified subscription: Self-hosted
+ * ```ts
+ * import { subscriber } from '@wix/realtime';
+ * import { createClient } from '@wix/sdk';
+ *
+ * // Import the auth strategy for the relevant access type
+ * // Import the relevant host module if needed
  *
  * const client = createClient({
  *   modules: { subscriber },
- *   auth: AppStrategy({ appId, appSecret, instanceId }),
+ *   // Include the auth strategy and host as relevant
  * });
  *
- * // Unsubscribe by subscription ID
+ * // Remove the specified subscription
  * client.subscriber.unsubscribe({ subscriptionId });
  *
- * // Unsubscribe from all subscriptions to a channel
+ * // Remove all subscriptions from the specified channel
  * client.subscriber.unsubscribe({ channel: { name: 'my-channel' } });
  * ```
  *
- * @example Contextual client (Wix-hosted)
- * ```ts
- * import { subscriber } from '@wix/realtime';
- *
- * subscriber.unsubscribe({ subscriptionId });
- * ```
- *
- * @param options - Specifies what to unsubscribe from. At least one of `channel` or `subscriptionId` is required.
+ * @param options - Unsubscribe information. You must specify `channel`, `subscriptionId`, or both.
  */
 export const unsubscribe = /*#__PURE__*/ createRESTModule(publicUnsubscribe);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/realtime",
-  "version": "1.0.34",
+  "version": "1.0.35",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -37,11 +37,11 @@
   "dependencies": {
     "@wix/auto_sdk_duplexer_publisher": "^1.0.10",
     "@wix/duplexer-js": "^2.0.6",
-    "@wix/realtime-common": "1.0.13",
+    "@wix/realtime-common": "1.0.14",
     "@wix/sdk": "^1.21.4",
     "@wix/sdk-runtime": "^1.0.9",
     "@wix/sdk-types": "^1.17.5",
-    "@wix/sdk_realtime_site": "1.0.29",
+    "@wix/sdk_realtime_site": "1.0.30",
     "uuid": "^11.1.0"
   },
   "devDependencies": {
@@ -65,5 +65,5 @@
       "isRootPublicSdk": true
     }
   },
-  "falconPackageHash": "90b2dac8512fe6d53c9783658589fba10ec676575cd1a491d6974748"
+  "falconPackageHash": "ebbe942c0c0c816ccc4f8831a2dfb124127eb2fc4b59fdb863d4e34b"
 }