# datomish-user-agent-service

> A Tofino User Agent Service built on top of Datomish.

Latest version **0.0.10** (published 2016-11-29) · MPL-2.0 license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install datomish-user-agent-service
pnpm add datomish-user-agent-service
yarn add datomish-user-agent-service
bun add datomish-user-agent-service
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 0.0.10 |
| Published | 2016-11-29 |
| First published | 2016-09-28 |
| Weekly downloads | 0 |
| License | MPL-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | 6.x.x |
| Dependencies | 12 |
| Known vulnerabilities | 0 (+11 in 4 direct dependencies) |
| Install scripts | no |
| GitHub stars | 4 |
| Author | Mozilla Corporation |
| Maintainers | joewalker, jsantell, nalexander, rnewman |

## Links

- npm: https://www.npmjs.com/package/datomish-user-agent-service
- Repository: https://github.com/mozilla/datomish-user-agent-service
- Homepage: https://github.com/mozilla/datomish-user-agent-service#readme
- Issues: https://github.com/mozilla/datomish-user-agent-service/issues
- npm.io page: https://npm.io/package/datomish-user-agent-service

## Dependencies (12)

- [ws](https://npm.io/package/ws.md) 1.1.1
- [yargs](https://npm.io/package/yargs.md) 5.0.0
- [morgan](https://npm.io/package/morgan.md) 1.7.0
- [express](https://npm.io/package/express.md) 4.14.0
- [fs-extra](https://npm.io/package/fs-extra.md) 0.30.0
- [body-parser](https://npm.io/package/body-parser.md) 1.15.2
- [appdirectory](https://npm.io/package/appdirectory.md) 0.1.0
- [promise-sqlite](https://npm.io/package/promise-sqlite.md) 1.5.0
- [isomorphic-fetch](https://npm.io/package/isomorphic-fetch.md) 2.2.1
- [express-validator](https://npm.io/package/express-validator.md) 2.20.8
- [express-ws-routes](https://npm.io/package/express-ws-routes.md) 1.1.0
- [source-map-support](https://npm.io/package/source-map-support.md) github:ncalexan/node-source-map-support#fileUrls-plus

## Recent versions

- 0.0.10 (latest) — 2016-11-29
- 0.0.8 — 2016-11-23
- 0.0.7 — 2016-11-22
- 0.0.6 — 2016-11-22
- 0.0.5 — 2016-10-24
- 0.0.4 — 2016-10-21
- 0.0.3 — 2016-10-13
- 0.0.2 — 2016-09-29
- 0.0.1 — 2016-09-28

## README

# datomish-user-agent-service

```
Usage: bin/user-agent-service [options]

Options:
  -p, --port
    The port that the UserAgentService will run on. [number] [required]
  -d, --db
    The path to the directory containing the browser.db. [string] [required]
  -v, --version
    The version of API to use. [string] [choices: "v1"] [default: "v1"]
  -c, --content-service-origin
    The origin of the Content Service so that CORS can be enabled. [string] [default: "tofino://"]
```

[User Agent Service API spec](/docs/api.md)

## Development

Download and install [Datomish](https://github.com/mozilla/datomish/)
with `lein install` in your checkout.

For running the (minimal) tests, `lein doo node test` hot reloads the
test and package code.

For testing with cURL, run `lein figwheel dev` in one terminal, and
then `node target/release-node/datomish_user_agent_service.js` in
another terminal.  That'll hot reload the server code, taking care to
maintain the same HTTP server while swapping out the Express router.
(With a little work we'll be able to preserve the WebSocket
connections across swaps too.)

For testing against Tofino, modify the Tofino `app/packages.json` to
point at your local package directory and run `lein cljsbuild auto
release-node`.  That'll update the
`target/release-node/datomish-user-agent-service.js` in place, which
will get picked up by the bin script used by Tofino.  It works quite
well.

## Changelog

### Version 0.0.3

* Bump to datomish "0.1.2-SNAPSHOT" to serialize transactions
  (https://github.com/mozilla/datomish/issues/80).  Fixes
  https://github.com/mozilla/tofino/issues/1321.

* Fix https://github.com/mozilla/datomish-user-agent-service/issues/5.

---
_Source: https://npm.io/package/datomish-user-agent-service · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
