@dankolz/data-service-server
v1.0.0
Published
A server component to allow access over HTTP to any AbstractDataService and client code to call the server side. Allows web clients to treat a server side database is if it were local.
Readme
Data Service Server
A server component to allow access over HTTP to any AbstractDataService and client code to call the server side. Allows web clients to treat a server side database is if it were local.
Install
npm install @dankolz/data-service-server
Server side usage
import ServerDataService from '@dankolz/data-service-server'
let server = new ServerDataService({
dataService: the-underlying-store
})
let serviceRouter = express.Router()
server.addToRouter(serviceRouter)
app.use('/my-data-url', serviceRouter)
There are several storage mechanism that implement AbstractDataService including MongoDB and an in-memory store.
Client side usage
import RemoteDataService from '@dankolz/data-service-server'
// or import RemoteDataService from '@dankolz/data-service-server/client-lib/remote-data-service.mjs'
let serv = new RemoteDataService({
urlPrefix: '/my-data-url'
})
let results = await serv.fetch({name: 'Dan'})
// ...etc
Options
There are a bunch of options for security and transforming the objects sent and received. Check the constructors for documentation of the options.
Notes
See AbstractDataService or MongodbDataService for usage examples.
Data sent over http is transformed when serialized. Dates become strings. IDs become strings.
Complex objects may be lost altogether. Use the presaveTransformer
and postfetchTransformer
options to mitigate that problem.