docs: first version

.github/workflows/docs.yml

@@ -0,0 +1,25 @@
+name: Update documentation
+on:
+  push:
+    branches:
+      - main
+      - develop
+    paths:
+      - docs/**
+
+concurrency:
+  group: wiki
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Update documentation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: spenserblack/[email protected]
+        with:
+          path: docs

README.md

@@ -4,8 +4,18 @@
 [![Build Status][build-img]][build-url]
 [![Issues][issues-img]][issues-url]
 [![Semantic Release][semantic-release-img]][semantic-release-url]
-[![TypeScript][typescript-img]][typescript-url]
 
+[npm-img]:https://img.shields.io/npm/v/@print-one/print-one-js
+[npm-url]:https://www.npmjs.com/package/@print-one/print-one-js
+
+[build-img]:https://github.com/Print-one/print-one-js/actions/workflows/release.yml/badge.svg
+[build-url]:https://github.com/Print-one/print-one-js/actions/workflows/release.yml
+
+[issues-img]:https://img.shields.io/github/issues/Print-one/print-one-js
+[issues-url]:https://github.com/Print-one/print-one-js/issues
+
+[semantic-release-img]:https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg
+[semantic-release-url]:https://github.com/semantic-release/semantic-release
 
 > The official javascript client for [Print.one](https://print.one)
 
@@ -15,22 +25,51 @@
 npm install @print-one/print-one-js
 ```
 
-[npm-img]:https://img.shields.io/npm/v/@print-one/print-one-js
+## Example
 
-[npm-url]:https://www.npmjs.com/package/@print-one/print-one-js
+```js
+import { PrintOne } from '@print-one/print-one-js'
 
-[build-img]:https://github.com/Print-one/print-one-js/actions/workflows/release.yml/badge.svg
+const client = new PrintOne("<YOUR API TOKEN>");
 
-[build-url]:https://github.com/Print-one/print-one-js/actions/workflows/release.yml
+const templates = await client.getTemplates();
+const template = templates[0];
 
-[issues-img]:https://img.shields.io/github/issues/Print-one/print-one-js
+const order = await client.createOrder({
+    recipient: {
+        name: "John Doe",
+        address: "Example Street 2",
+        city: "Anytown",
+        postalCode: "1234AB",
+        country: "NL",
+    },
+    template: template,
+    // All other options are optional
+    sender: {
+        name: "Jane Doe",
+        address: "Example Street 1",
+        addressLine2: "Apt 1",
+        city: "Anytown",
+        postalCode: "1234AB",
+        country: "NL",
+    },
+    finish: Finish.GLOSSY,
+    mergeVariables: {
+        couponCode: "ABC123"
+    },
+    billingId: "8073",
+    sendDate: "2021-01-01",
+});
 
-[issues-url]:https://github.com/ryansonshine/Print-one/print-one-js/issues
+const download = await order.download();
 
-[semantic-release-img]:https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg
+fs.writeFileSync("order.pdf", download);
+```
 
-[semantic-release-url]:https://github.com/semantic-release/semantic-release
+## Help
+
+- For documentation and more examples, see the [documentation](https://github.com/Print-one/print-one-js/wiki).
+- With problems, questions or suggestions, please file an [issue](https://github.com/Print-one/print-one-js/issues).
+- For other questions, feel free to contact us at [our support page](https://printone.atlassian.net/servicedesk/customer/portals).
 
-[typescript-img]:https://img.shields.io/github/languages/top/print-one/print-one-js?logo=typescript&logoColor=white
 
-[typescript-url]:https://www.typescriptlang.org/

docs/Filtering.md

@@ -0,0 +1,125 @@
+# Sorting
+
+The sorting options for the API. Are defined using the following format:
+
+```js
+const sortBy = "<field>:<order>";
+```
+
+Or:
+
+```js
+const sortBy = {
+  order: "<order>",
+  field: "<field>"
+};
+```
+
+Where `<field>` is the field to sort by and `<order>` is the order to sort in.
+It can also be an array of the above formats.
+
+## Examples
+
+```js
+// Simplest form
+const sortBy = "<field>:ASC";
+const sortBy = "<field>:DESC";
+```
+
+```js
+// Multiple fields
+const sortBy = ["<field1>:ASC", "<field2>:DESC"];
+```
+
+```js
+// Object form
+const sortBy = {
+  order: "ASC",
+  field: "<field>"
+};
+```
+
+```js
+// Multiple fields in object form
+const sortBy = [
+  {
+    order: "ASC",
+    field: "<field1>"
+  },
+  {
+    order: "DESC",
+    field: "<field2>"
+  }
+];
+```
+
+# Filtering
+
+## Contains
+
+Filtering a field which is a list of strings can be done using the `contains` filter. It is defined using the following format:
+
+```js
+const contains = "<value>";
+```
+
+Or if all field values must be contained:
+
+```js
+const contains = {
+  all: ["<value1>", "<value2>"]
+};
+```
+
+Or if any field value must be contained:
+
+```js
+const contains = {
+  some: ["<value1>", "<value2>"]
+};
+```
+
+Where `<value>` is the value to filter by.
+
+## Date
+
+Filtering a field which is a date can be done using the `date` filter. It is defined using the following format:
+
+```js
+const date = {
+  from?: "<date>",
+  to?: "<date>"
+};
+```
+
+Where `<date>` is the date to filter by.
+
+## Examples
+
+```js
+// Between two dates
+const filter = {
+  date: {
+    from: "2019-01-01",
+    to: "2019-12-31"
+  }
+};
+```
+
+```js
+// After a date
+const filter = {
+  date: {
+    from: "2019-01-01"
+  }
+};
+```
+
+```js
+// Before a date
+const filter = {
+  date: {
+    to: "2019-12-31"
+  }
+};
+```

docs/Home.md

@@ -0,0 +1,32 @@
+# Print-one-js
+
+> The official javascript client for [Print.one](https://print.one)
+
+## Installation
+
+```bash
+npm install @print-one/print-one-js
+```
+
+## Getting started
+
+1. Get your API token from [Print.one](https://portal.print.one/devs/apikeys)
+2. Create a new client with your API token
+
+    ```js
+    import { PrintOne } from '@print-one/print-one-js'
+
+    const client = new PrintOne('<YOUR API TOKEN>');
+    ```
+3. Start using the client
+    - See examples [here](./Examples.md)
+    - See all available methods [here](./PrintOne.md)
+    - See all available models [here](./Models.md)
+
+## Help
+
+- For documentation and more examples, see the [documentation](https://github.com/Print-one/print-one-js/wiki).
+- With problems, questions or suggestions, please file an [issue](https://github.com/Print-one/print-one-js/issues).
+- For other questions, feel free to contact us
+  at [our support page](https://printone.atlassian.net/servicedesk/customer/portals).
+