File: CHANGELOG.md

package info (click to toggle)
ruby-faye 1.4.0-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye
  • size: 1,792 kB
  • sloc: javascript: 14,833; ruby: 5,068; makefile: 30
file content (542 lines) | stat: -rw-r--r-- 20,109 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
### 1.4.0 / 2020-07-31

- Implement TLS certificate verification and enable it by default in the Ruby
  client class `Faye::Client`
- Add a `:tls` option to the Ruby client with sub-field `:verify_peer` for
  configuring TLS verification
- Officially support the `tls` option in the Node.js client, whose contents are
  forward to the `https` and `tls` modules as appropriate

### 1.3.0 / 2020-06-08

- Support `user:pass@` authorization in URIs and send `Authorization` headers
  from the Node HTTP transport
- Support IPv6 hostnames in URIs
- Allow credentials (cookies and `Authorization` headers) in cross-origin
  requests, by:
  - setting `Access-Control-Allow-Origin` to the value of the `Origin` header
    (not `*`)
  - enabling `Access-Control-Allow-Credentials`
- Enable credentials when sending cross-origin requests
- Don't disconnect WebSocket on page unload if `autodisconnect` is turned off
- Catch errors when creating a WebSocket, which happens when Content Security
  Policy blocks it, allowing other transports to be tried
- Fix a bug in the client where it handles messages from other clients as though
  they're the server's response to its own messages, based on the `id` field;
  now we only treat messages as server responses if they contain `successful:
  true`
- Stop sending an empty message list `[]` from the WebSocket client as a
  keep-alive mechanism since CometD does not accept this message
- Fix deprecation warnings for using the `new Buffer()` constructor
- Switch to the Apache 2.0 license


### 1.2.5 / 2020-04-28

- Fix `/meta/*` channel recognition bug in the server that enables
  authentication bypass
  - https://blog.jcoglan.com/2020/04/28/authentication-bypass-in-faye/


### 1.2.4 / 2017-01-28

- Fix `RackAdapter#get_client` that was failing due to a URI error
- Define `Promise#catch` in a safe way for old browsers
- Log errors in the Node HTTP transport


### 1.2.3 / 2016-10-11

- Return an error if the `data` field is missing on published messages
- Fix errors that occur in the new `websocket` util when the browser does not
  support WebSocket


### 1.2.2 / 2016-07-18

- Mitigate the HTTPoxy vulnerability: https://httpoxy.org/


### 1.2.1 / 2016-06-29

- Fix a missing variable error in `NodeAdapter`


### 1.2.0 / 2016-06-26

- Add `client.subscribe().withChannel()` to yield the message channel for
  wildcard subscriptions
- Restructure the JavaScript codebase around Node modules (require/exports)
  rather than globals
- Update the Promise shim to reflect the standard API, including `catch()` and
  `all()`
- Support connecting to servers that use SNI in the Ruby client
- Make the JavaScript client work inside React Native and Web Workers
- Remove JSON2; you should import a JSON shim yourself if necessary
- Handle errors that occur when a message is partially delivered via EventSource
- Reject requests with invalid (non-array or -object) top-level JSON values
- Make local client requests asynchronous to avoid re-entrant request handling
  errors
- Remove `Connection: Close` from HTTP responses to allow use of keep-alive
- Use `XMLHttpRequest` in preference to the ActiveX API in IE10
- Fix bug where flushing large message batches puts promises in an invalid state


### 1.1.3 / 2020-04-28

- Fix `/meta/*` channel recognition bug in the server that enables
  authentication bypass
  - https://blog.jcoglan.com/2020/04/28/authentication-bypass-in-faye/


### 1.1.2 / 2015-07-19

- Allow the `Authorization` header to be used on CORS requests
- Disallow unused methods like PUT and DELETE on CORS requests
- Stop IE prematurely garbage-collecting `XDomainRequest` objects
- Make sure messages can be sent if they overflow the request size limit and the
  outbox is empty
- Don't send messages over WebSockets unless they are in the 'open' ready-state
- Fix a bug preventing use of the in-process transport in Ruby


### 1.1.1 / 2015-02-25

- Make sure the client ID associated with a WebSocket is not dropped, so the
  socket can be closed properly
- Handle cases where a JSON-P endpoint returns no response argument
- Stop trying to retry messages after the client has been disconnected
- Remove duplication of the client ID in EventSource URLs


### 1.1.0 / 2014-12-22

- Allow the server and client to use WebSocket extensions, for example
  permessage-deflate
- Support the `HTTP_PROXY` and `HTTPS_PROXY` environment variables to send all
  client connections through an HTTP proxy
- Introduce the `Scheduler` API to allow the user to control message retries
- Add the `attempts` and `deadline` options to `Client#publish()`
- Let `RackAdapter` take a block that yields the instance, so extensions can be
  added to middleware
- Allow monitoring listeners to see the `clientId` on publishd messages but
  still avoid sending it to subscribers
- Return a promise from `Client#disconnect()`
- Fix client-side retry bugs causing the client to flood the server with
  duplicate messages
- Send all transport types in the `supportedConnectionTypes` handshake parameter
- Don't close WebSockets when the client recovers from an error and sends a new
  `clientId`
- Replace `cookiejar` with `tough-cookie` to avoid global variable leaks


### 1.0.4 / 2020-04-28

- Fix `/meta/*` channel recognition bug in the server that enables
  authentication bypass
  - https://blog.jcoglan.com/2020/04/28/authentication-bypass-in-faye/


### 1.0.3 / 2014-07-08

- Make some changes to JSON-P responses to mitigate the Rosetta Flash attack
- http://miki.it/blog/2014/7/8/abusing-jsonp-with-rosetta-flash/


### 1.0.2 -- removed due to error while publishing


### 1.0.1 / 2013-12-10

- Add `Adapter#close()` method for gracefully shutting down the server
- Fix error recover bug in WebSocket that made transport cycle through
  `up`/`down` state
- Update Promise implementation to pass `promises-aplus-tests 2.0`
- Correct some incorrect variable names in the Ruby transports
- Make logging methods public to fix a problem on Ruby 2.1


### 1.0.0 / 2013-10-01

- Client changes:
  - Allow clients to be instantiated with URI objects rather than strings
  - Add a `ca` option to the Node `Client` class for passing in trusted server
    certificates
  - Objects supporting the `callback()` method in JavaScript are now Promises
  - Fix protocol-relative URI parsing in the client
  - Remove the `getClientId()` and `getState()` methods from the `Client` class
- Transport changes:
  - Add request-size limiting to all batching transports
  - Make the WebSocket transport more robust against quiet network periods and
    clients going to sleep
  - Support cookies across all transports when using the client on Node.js or
    Ruby
  - Support custom headers in the `cross-origin-long-polling` and server-side
    `websocket` transports
- Adapter changes:
  - Support the `rack.hijack` streaming API
  - Migrate to MultiJson for JSON handling on Ruby, allowing use of JRuby
  - Escape U+2028 and U+2029 in JSON-P output
  - Fix a bug stopping requests being routed when the mount point is `/`
  - Fix various bugs that cause errors to be thrown if we try to send a message
    over a closed socket
  - Remove the `listen()` method from `Adapter` in favour of using
    server-specific APIs
- Server changes:
  - Use cryptographically secure random number generators to create client IDs
  - Allow extensions to access request properties by using 3-ary methods
  - Objects supporting the `bind()` method now implement the full `EventEmitter`
    API
  - Stop the server from forwarding the `clientId` property of published
    messages
- Miscellaneous:
  - Support Browserify by returning the client module
  - `Faye.logger` can now be a logger object rather than a function


### 0.8.11 / 2014-07-08

- Make some changes to JSON-P responses to mitigate the Rosetta Flash attack
- http://miki.it/blog/2014/7/8/abusing-jsonp-with-rosetta-flash/


### 0.8.10 -- removed due to error while publishing


### 0.8.9 / 2013-02-26

- Specify ciphers for SSL on Node to mitigate the BEAST attack
- Mitigate increased risk of socket hang-up errors in Node v0.8.20
- Fix race condition when processing outgoing extensions in the Node server
- Fix problem loading the client script when using `{mount: '/'}`
- Clean up connection objects when a WebSocket is re-used with a new clientId
- All JavaScript code now runs in strict mode
- Select transport on handshake, instead of on client creation to allow time for
  `disable()` calls
- Do not speculatively open WebSocket/EventSource connections if they are
  disabled
- Gracefully handle WebSocket messages with no data on the client side
- Close and reconnect WebSocket when onerror is fired, not just when onclose is
  fired
- Fix problem with caching of EventSource connections with stale clientIds
- Don't parse query strings when checking if a URL is same-origin or not


### 0.8.8 / 2013-01-10

- Patch security hole allowing remote execution of arbitrary Server methods


### 0.8.7 -- removed due to error while publishing


### 0.8.6 / 2012-10-07

- Make sure messages pushed to the client over a socket pass through outgoing
  extensions


### 0.8.5 / 2012-09-30

- Fix a bug in `URI.parse()` that caused Faye endpoints to inherit search and
  hash from `window.location`


### 0.8.4 / 2012-09-29

- Optimise upgrade process so that WebSocket is tested earlier and the
  connection is cached
- Check that EventSource actually works to work around broken Opera
  implementation
- Emit `connection:open` and `connection:close` events from the Engine proxy
- Increase size of client IDs from 128 to 160 bits
- Fix bug with relative URL resolution in IE
- Limit the JSON-P transport's message buffer so it doesn't create over-long
  URLs
- Send `Pragma: no-cache` with XHR requests to guard against iOS 6 POST caching
- Add `charset=utf-8` to response Content-Type headers


### 0.8.3 / 2012-07-15

- `Client#subscribe` returns an array of Subscriptions if given an array of
  channels
- Allow different endpoints to be specified per-transport
- Only use IE's `XDomainRequest` for same-protocol requests
- Replace URL parser with one that treats relative URLs the same as the browser
- Improve logging of malformed requests and detect problems earlier
- Make sure socket connections are closed when a client session is timed out
- Stop WebSocket reconnecting after `window.onbeforeunload`


### 0.8.2 / 2012-04-12

- Fix replacement of `null` with `{}` in `copyObject()`
- Make EventSource transport trigger `transport:up/down` events
- Supply source map for minified JavaScript client, and include source in gem
- Return `Content-Length: 0` for 304 responses
- Handle pre-flight CORS requests from old versions of Safari


### 0.8.1 / 2012-03-15

- Make `Publisher#trigger` safe for event listeners that modify the listener
  list
- Make `Server#subscribe` return a response if the incoming message has an error
- Fix edge case in code that identifies the `clientId` of socket connections
- Return `Content-Length` headers for HTTP responses
- Don't send empty lists of messages from the WebSocket transport
- Stop client sending multiple `/meta/subscribe` messages for subscriptions made
  before handshaking
- Stop client treating incoming published messages as responses to `/meta/*`
  messages


### 0.8.0 / 2012-02-26

- Extract the Redis engine into a separate library, `faye-redis`
- Stabilize and document the Engine API so others can write backends
- Extract WebSocket and EventSource tools into a separate library,
  `faye-websocket`
- Improve use of WebSocket so messages are immediately pushed rather than
  polling
- Introduce new EventSource-based transport, for proxies that block WebSocket
- Support the Rainbows and Goliath web servers for Ruby, same as
  `faye-websocket`
- Improve detection of network errors and switch to fixed-interval for
  reconnecting
- Add `setHeader()` method to Client (e.g. for connecting to Salesforce API)
- Add `timeout()` method to `Faye.Deferrable` to match
  `EventMachine::Deferrable`
- Fix some bugs in client-side message handlers created with `subscribe()`
- Improve speed and memory consumption of `copyObject()`
- Switch from JSON to Yajl for JSON parsing in Ruby


### 0.7.2 / 2013-01-10

- Patch security hole allowing remote execution of arbitrary Server methods


### 0.7.1 / 2011-12-22

- Extension `added()` and `removed()` methods now receive the extended object
- Detection of WebSockets in RackAdapter is more strict


### 0.7.0 / 2011-11-22

- Provide an event API for monitoring engine events on the server side
- Implement server-side WebSocket connections for improved latency
- Fix WebSocket protocol bugs and expose APIs for developers to use
- Make server-side HTTP transports support SSL and cookies
- Allow clients to disable selected transports and autodisconnection
- Add callback/errback API to `Client#publish()` interface
- Add `socket` setting for the Redis engine for connecting through a Unix socket


### 0.6.8 / 2013-01-10

- Patch security hole allowing remote execution of arbitrary Server methods


### 0.6.7 / 2011-10-20

- Cache client script in memory and add `ETag` and `Last-Modified` headers
- Fix bug in Node Redis engine where `undefined` was used if no namespace given
- Flush Redis message queues using a transaction to avoid re-delivery of
  messages
- Fix race condition and timing errors present in Redis locking code
- Use `Cache-Control: no-cache, no-store` on JSON-P responses
- Improvements to the CORS and JSON-P transports
- Prevent retry handlers in transports from being invoked multiple times
- Use the current page protocol by default when parsing relative URIs


### 0.6.6 / 2011-09-12

- Add `:key` and `:cert` options to the `Adapter#listen` methods for setting up
  SSL
- Fix error detection of CORS transport in IE9 running IE8 compatibility mode
- Fix dependency versions so that Rubygems lets Faye install


### 0.6.5 / 2011-08-29

- Fix UTF-8 encoding bugs in draft-75/76 and protocol-8 WebSocket parsers
- Switch to streaming parser for WebSocket protocol-8
- Remove an `SREM` operation that shouldn't have been in the Redis engine
- Move `thin_extensions.rb` so it's not on the Rubygems load path


### 0.6.4 / 2011-08-18

- Support WebSocket protocol used by Chrome 14 and Firefox 6
- Fix handling of multibyte characters in WebSocket messages on Node
- Improve message routing in Node memory engine to avoid false duplicates


### 0.6.3 / 2011-07-10

- Use sequential message IDs to reduce memory usage on the client side
- Only send advice with handshake and connect responses
- Stop trying to publish `/meta/*` messages - no-one is listening and it breaks
  `/**`
- Fix bug causing invalid listeners to appear after a client reconnection
- Stop loading `rubygems` within our library code
- Make sure we only queue a message for each client once in the Redis engine
- Use lists instead of sets for message queues in Redis
- Improve clean-up of expired clients in Redis engine


### 0.6.2 / 2011-06-19

- Add authentication, database selection and namespacing to Redis engine
- Clean up all client data when removing clients from Redis
- Fix `cross-origin-long-polling` for `OPTIONS`-aware browsers
- Update secure WebSocket detection for recent Node versions
- Reinstate `faye.client` field in Rack environment


### 0.6.1 / 2011-06-06

- Fix `cross-origin-long-polling` support in `RackAdapter`
- Plug some potential memory leaks in `Memory` engine


### 0.6.0 / 2011-05-21

- Extract core logic into the `Engine` class to support swappable backends
- Introduce a Redis-backed engine to support clustered web front-ends
- Use CORS for `cross-domain long-polling`
- Make server more resilient against bad requests, including empty message lists
- Perform subscription validation on the server and use errbacks to signal
  errors
- Prohibit publishing to wildcard channels
- Unsubscribing from a channel is now O(1) instead of O(N)
- Much more thorough and consistent unit test coverage of both versions
- Automatic integration tests using Terminus and TestSwarm


### 0.5.5 / 2011-01-16

- Open a real socket to check for WebSocket usability, not just object detection
- Catch server-side errors when handshaking with WebSockets


### 0.5.4 / 2010-12-19

- Add a `#callback` method to `Subscriptions` to detect when they become active
- Add `:extensions` option to `RackAdapter` to make it easier to extend
  middleware
- Detect secure WebSocket requests through the `HTTP_X_FORWARDED_PROTO` header
- Handle socket errors when sending WebSocket messages from `NodeAdapter`
- Use exponential backoff to reconnect client-side WebSockets to reduce CPU load


### 0.5.3 / 2010-10-21

- Improve detection of `wss:` requirement for secure WebSocket connections
- Correctly use default ports (80,443) for server-side HTTP connections
- Support legacy `application/x-www-form-urlencoded` POST requests
- Delete unused Channel objects that have all their subscribers removed
- Fix resend/reconnect logic in WebSocket transport
- Keep client script in memory rather than reading it from disk every time
- Prevent error-adding extensions from breaking the core protocol


### 0.5.2 / 2010-08-12

- Support draft-76 of the WebSocket protocol (FF4, Chrome 6)
- Reduce `Connection::MAX_DELAY` to improve latency


### 0.5.1 / 2010-07-21

- Fix a publishing problem in Ruby `LocalTransport`


### 0.5.0 / 2010-07-17 

- Handle multiple event listeners bound to a channel
- Add extension system for adding domain-specific logic to the protocol
- Improve handling of client reconnections if the server goes down
- Change default polling interval to 0 (immediate reconnect)
- Add support for WebSockets (draft75 only) as a network transport
- Remove support for Ruby servers other than Thin
- Make client and server compatible with CometD (1.x and 2.0) components
- Improve clean-up of unused server-side connections
- Change Node API for adding Faye service to an HTTP server


### 0.3.4 / 2010-06-20

- Stop local clients going into an infinite loop if a subscription block causes
  a reconnect


### 0.3.3 / 2010-06-07

- Bring Node APIs up to date with 0.1.97
- Catch `ECONNREFUSED` errors in Node clients to withstand server outages
- Refactor the `Server` internals


### 0.3.2 / 2010-04-04

- Fix problems with JSON serialization when Prototype, MooTools present
- Make the client reconnect if it doesn't hear from the server after a timeout
- Stop JavaScript server returning `NaN` for `advice.interval`
- Make Ruby server return an integer for `advice.interval`
- Ensure EventMachine is running before handling messages
- Handle `data` and `end` events properly in Node HTTP API
- Switch to `application/json` for content types and stop using querystring
  format in POST bodies
- Respond to any URL path under the mount point, not just the exact match


### 0.3.1 / 2010-03-09

- Pass client down through Rack stack as `env['faye.client']`
- Refactor some JavaScript internals to mirror Ruby codebase


### 0.3.0 / 2010-03-01

- Add server-side clients for Node.js and Ruby environments
- Clients support both HTTP and in-process transports
- Fix ID generation in JavaScript version to 128-bit IDs
- Fix bug in interpretation of `**` channel wildcard
- Users don't have to call `#connect()` on clients any more
- Fix timeout race conditions that were killing active connections
- Support new Node APIs from 0.1.29.


### 0.2.2 / 2010-02-10

- Kick out requests with malformed JSON as 400s


### 0.2.1 / 2010-02-04

- Fix server-side flushing of callback-polling connections
- Backend can be used cross-domain if running on Node or Thin


### 0.2.0 / 2010-02-02

- Port server to JavaScript with an adapter for Node.js
- Support Thin's async responses in the Ruby version for complete non-blocking
- Fix some minor client-side bugs in transport choice


### 0.1.1 / 2009-07-26

- Fix a broken client build


### 0.1.0 / 2009-06-15

- Ruby Bayeux server and Rack adapter
- Internally evented using EventMachine, web frontend blocks
- JavaScript client with `long-polling` and `callback-polling`