ephemeral-socket-service v0.1.0

Ephemeral Socket Service

This express middleware allows you to accept incoming HTTP POST requests that will be piped through to later HTTP GET requests.

Why would I want to?

The server acts as a file sharing service but the data is never stored on the server. Instead, the incoming HTTP POST is accepted and then stalled until the HTTP GET request is made. In order to know what URL to use for the HTTP GET request, we write a partial response to the HTTP POST but do not close the stream.

Usage

1. Create an express server.
2. Attach this middleware.
3. Respond to events on middleware to create your service.

Here is how it might look:

# Create express server
express = require 'express'
app     = express()

# Initialize middleware
service = require('ephemeral-socket-service').attach(app)

# Respond to events
service.on 'socket:opened', (socket, socketId, query) ->
  socket.res.writeHead(200)
  socket.res.write("Ephemeral socket open with ID #{socketId}")

service.on 'socket:end', (socket, stats) ->
  socket.res?.write('\n\nUpload complete. Socket deleted.\n')
  socket.res?.end()

service.on 'socket:timeout', (socket) ->
  socket.res?.write('\n\nTimed out. No one requested your socket.\n')
  socket.res?.end()

service.on 'error:not-found', (req, res) ->
  res.status(404).send('Not found')

# Serve
app.set('port', 9000)
server = app.listen(app.get('port'), ->
  console.log('Listening on %s', server.address().port)
)

Options

EphemeralSocketService.attach() takes an option hash as its second argument. The available options are: