Here lies the API for Galaxy.

There is a REST HTTP API and WebSocket API. The REST API can be consumed by game developers. The WebSocket API is intended to be consumed by galaxy.js, a simple drop-in JavaScript API for multiplayer, web-based games.

Note: This project is not ready for prime time. Not an official Mozilla project. Pre-alpha everything. Anything and everything at your own risk.

Installation

To install dependencies:

npm install

Other dependencies:

• PostgreSQL (brew install postgresql && brew info postgresql using Homebrew on Mac OS X)

Create a PostgreSQL database (using settings.POSTGRES_URL from settings_dev.js):

npm run refreshdb-dev

Development

Initialise settings, if you haven't already:

cp ./settings_dev.js.dist ./settings_dev.js
cp ./settings_test.js.dist ./settings_test.js

To run the local web server:

npm run dev

To run with a different settings file:

GALAXY_API_SETTINGS=./some_different_settings_dev.js npm run prod

To run linting tools:

gulp lint

Production

Initialise settings if you haven't already:

cp ./settings_prod.js.dist ./settings_prod.js

To run the web server in production:

npm run prod

To run with a different settings file:

GALAXY_API_SETTINGS=./some_different_settings_prod.js npm run prod

Alternatively, without npm:

NODE_ENV=production GALAXY_API_SETTINGS=./settings_prod.js node index.js
NODE_ENV=production GALAXY_API_SETTINGS=./some_different_settings_prod.js node index.js

Testing

Initialise settings:

cp ./settings_test.js.dist ./settings_test.js

To run tests:

npm test

To run a single test:

npm test -- test/lib/db.js

To run tests without destroying the database first:

npm run test-keepdb

To run tests with coverage and linting:

npm run test-verbose

Database

gulp tasks

These are the available gulp tasks for PostgreSQL database and migration operations:

• gulp createdb - create a PostgreSQL database using settings.POSTGRES_URL.
• gulp dropdb - delete the database.
• gulp migratedb - run migrations.
• gulp migratedb-create --name <name> - create a new migration file called <name>.
• gulp migratedb-up - run all up migrations from the current state.
• gulp migratedb-up --num <num> - run <num> up migrations from the current state.
• gulp migratedb-down - run a single down migration.
• gulp migratedb-down --num <num> - run <num> down migrations from the current state.

psql commands

To access the PostgreSQL prompt:

psql -d galaxy-api

These are a few helpful PostgreSQL commands:

• \h - view list of available commands.
• \dt+ - list all tables in the database.
• \d+ <table_name> - show a table's schema.
• drop table <table_name> - delete a table.
• \x on - view a table in "extended display" mode.