123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143 |
- "use strict";
- var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
- var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
- _Object$defineProperty(exports, "__esModule", {
- value: true
- });
- exports.default = void 0;
- var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/defineProperty"));
- var _CoreManager = _interopRequireDefault(require("./CoreManager"));
- var _promiseUtils = require("./promiseUtils");
- /**
- * Creates a new LiveQuery Subscription.
- * <a href="https://nodejs.org/api/events.html#events_class_eventemitter">cloud functions</a>.
- *
- * <p>Response Object - Contains data from the client that made the request
- * <ul>
- * <li>clientId</li>
- * <li>installationId - requires Parse Server 4.0.0+</li>
- * </ul>
- * </p>
- *
- * <p>Open Event - When you call query.subscribe(), we send a subscribe request to
- * the LiveQuery server, when we get the confirmation from the LiveQuery server,
- * this event will be emitted. When the client loses WebSocket connection to the
- * LiveQuery server, we will try to auto reconnect the LiveQuery server. If we
- * reconnect the LiveQuery server and successfully resubscribe the ParseQuery,
- * you'll also get this event.
- *
- * <pre>
- * subscription.on('open', (response) => {
- *
- * });</pre></p>
- *
- * <p>Create Event - When a new ParseObject is created and it fulfills the ParseQuery you subscribe,
- * you'll get this event. The object is the ParseObject which is created.
- *
- * <pre>
- * subscription.on('create', (object, response) => {
- *
- * });</pre></p>
- *
- * <p>Update Event - When an existing ParseObject (original) which fulfills the ParseQuery you subscribe
- * is updated (The ParseObject fulfills the ParseQuery before and after changes),
- * you'll get this event. The object is the ParseObject which is updated.
- * Its content is the latest value of the ParseObject.
- *
- * Parse-Server 3.1.3+ Required for original object parameter
- *
- * <pre>
- * subscription.on('update', (object, original, response) => {
- *
- * });</pre></p>
- *
- * <p>Enter Event - When an existing ParseObject's (original) old value doesn't fulfill the ParseQuery
- * but its new value fulfills the ParseQuery, you'll get this event. The object is the
- * ParseObject which enters the ParseQuery. Its content is the latest value of the ParseObject.
- *
- * Parse-Server 3.1.3+ Required for original object parameter
- *
- * <pre>
- * subscription.on('enter', (object, original, response) => {
- *
- * });</pre></p>
- *
- *
- * <p>Update Event - When an existing ParseObject's old value fulfills the ParseQuery but its new value
- * doesn't fulfill the ParseQuery, you'll get this event. The object is the ParseObject
- * which leaves the ParseQuery. Its content is the latest value of the ParseObject.
- *
- * <pre>
- * subscription.on('leave', (object, response) => {
- *
- * });</pre></p>
- *
- *
- * <p>Delete Event - When an existing ParseObject which fulfills the ParseQuery is deleted, you'll
- * get this event. The object is the ParseObject which is deleted.
- *
- * <pre>
- * subscription.on('delete', (object, response) => {
- *
- * });</pre></p>
- *
- *
- * <p>Close Event - When the client loses the WebSocket connection to the LiveQuery
- * server and we stop receiving events, you'll get this event.
- *
- * <pre>
- * subscription.on('close', () => {
- *
- * });</pre></p>
- */
- class Subscription {
- /*
- * @param {string | number} id - subscription id
- * @param {string} query - query to subscribe to
- * @param {string} sessionToken - optional session token
- */
- constructor(id, query, sessionToken) {
- var _this = this;
- (0, _defineProperty2.default)(this, "id", void 0);
- (0, _defineProperty2.default)(this, "query", void 0);
- (0, _defineProperty2.default)(this, "sessionToken", void 0);
- (0, _defineProperty2.default)(this, "subscribePromise", void 0);
- (0, _defineProperty2.default)(this, "unsubscribePromise", void 0);
- (0, _defineProperty2.default)(this, "subscribed", void 0);
- (0, _defineProperty2.default)(this, "emitter", void 0);
- (0, _defineProperty2.default)(this, "on", void 0);
- (0, _defineProperty2.default)(this, "emit", void 0);
- this.id = id;
- this.query = query;
- this.sessionToken = sessionToken;
- this.subscribePromise = (0, _promiseUtils.resolvingPromise)();
- this.unsubscribePromise = (0, _promiseUtils.resolvingPromise)();
- this.subscribed = false;
- const EventEmitter = _CoreManager.default.getEventEmitter();
- this.emitter = new EventEmitter();
- this.on = (eventName, listener) => this.emitter.on(eventName, listener);
- this.emit = function (eventName) {
- for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
- args[_key - 1] = arguments[_key];
- }
- return _this.emitter.emit(eventName, ...args);
- };
- // adding listener so process does not crash
- // best practice is for developer to register their own listener
- this.on('error', () => {});
- }
- /**
- * Close the subscription
- *
- * @returns {Promise}
- */
- unsubscribe() {
- return _CoreManager.default.getLiveQueryController().getDefaultLiveQueryClient().then(liveQueryClient => {
- this.emit('close');
- return liveQueryClient.unsubscribe(this);
- });
- }
- }
- var _default = exports.default = Subscription;
|