@c_phillips/ipp-browser/README.md

IPP for the browse and node

# ipp-browser
IPP-browser is a powerful library that brings the power of Internet Printing Protocol (IPP) directly into the browser.
Inspired by the work of [William Kapke](https:///github.com/williamkapke/ipp), this library extends the use of IPP to the browser.
With this library, you can easily integrate printing to IPP-compatible network devices directly from your web applications without having to rely on additional plugins or software.
## Installation
​
#### npm
```sh
$ npm install @cphillips/ipp-browser --save
```
​
#### yarn
```sh
$ yarn add @cphillips/ipp-browser
```
​
## API
​
​
### Printer(url [,options])
To interact with a printer, create a `Printer` object.
​
**options:**
* `charset` - Specifies the value for the 'attributes-charset' attribute of requests. Defaults to `utf-8`.
* `language` - Specifies the value for the 'attributes-natural-language' attribute of requests. Defaults to `en-us`.
* `uri` - Specifies the value for the 'printer-uri' attribute of requests. Defaults to `ipp://+url.host+url.path`.
* `version` - Specifies the value for the 'version' attribute of requests. Defaults to `2.0`.
​
​
### Printer.encodeMsg(operation, msg)
Converts an IPP message object to IPP binary.
​
* 'operation' - There are many operations defined by IPP. See: [/lib/types.ts](https://github.com/digasystems/ipp-browser/blob/main/lib/types.ts#L1).
* 'message - A javascript object to be serealized into an IPP binary message.
​
​
### Printer.getHeaders(headers?)
Returns the heades to be included in your request
​
* 'headers' - The headers you want to add to the request.
​
​
## Usage/Example
#### Create a print request
​
```javascript
import axios from 'axios'
import PDFDocument from 'pdfkit'
import concat from 'concat-stream'
import Printer from './lib/printer'

var doc = new PDFDocument({ margin: 5 });

doc.pipe(concat(function (data: any) {

    let url = "http://192.168.4.62:631/ipp/print"
    let printer = new Printer(url);
    let msg = {
        "operation-attributes-tag": {
            "document-format": "application/pdf",
        },
        data: data,
    };

    axios
        .post(url, printer.encodeMsg("Print-Job", msg), {
            responseType:"arraybuffer",
            headers: printer.getHeaders(),
        })
        .then((response:any) => {
            console.log(printer.decodeMsg(response.data))
        });


}))
​
```
​
## License
​
MIT