# @linguala/marketplace-api

This Package contains GraphQL utilities for the Linguala marketplace API endpoint.

## Purpose

> Sharing schema data & transparency on our API. If you want to interact with our marketplace you can do so with this package. We will eventually run an API for translators and a corresponding frontend for the public.

## Security

> Since all data on this API is currently open, we think it makes sense to keep the schema open as well. Once we have users & authentication we need to think about how to keep that safe, keeping it public would be prefered if we can guarantee it, since security by obscurity has been proven not to work. ;-)

## Prerequisites

- `node@14`

## Peer Dependencies

Install those packages in your project if npm does not install them automatically (some newer versions do)

- `graphql-tag`
- `ramda`

Copy & Paste: `npm i graphql-tag ramda`

## Installation

`npm i @linguala/marketplace-api`

## Files

```tree
.
├── package.json
├── queries.js
├── README.md
├── resolvers.mjs
├── schema.graphql
└── schema.mjs
```

### package.json

Used for dependency tracking & npm distribution

### query.js

Example GraphQL queries (Query & Mutation)

### README.md

This README.md file, required for a nice help text visible on NPM

### resolvers.mjs

Resolver functions for GraphQL server & client

### schema.graphql

The GraphQL schema

> Here are the type definitions for marketplace-api

### schema.mjs

Javascript code for loading `schema.graphql` since not all projects can import `.graphql` files out of the box.

## Development

This package resides in a closed repo of linguala, it will eventually move to a public repo if that makes sense.

## Authors

Linguala <npm@linguala.com>