polotno-node 1.1.0 → 2.0.0

package/README.md

@@ -37,6 +37,33 @@ run();
 
 ## API
 
+### `createInstance(options)`
+
+Create working instance of Polotno Node.
+
+```js
+const { createInstance } = require('polotno-node');
+const instance = await createInstance({
+  // this is a demo key just for that project
+  // (!) please don't use it in your projects
+  // to create your own API key please go here: https://polotno.dev/cabinet
+  key: 'nFA5H9elEytDyPyvKL7T',
+  // useParallelPages - use parallel pages to speed up rendering
+  // you can use false only for sequential calls
+  // it may break rendering if you call many parallel requests
+  // default is true
+  useParallelPages: false,
+  // url - url of the Polotno Client Editor
+  // client editor is just simple public html page that have `store` as global variable
+  // by default it will run local build
+  url: 'https://yourappdomain.com/client',
+  // browser - puppeteer browser instance
+  // by default it will use chrome-aws-lambda
+  // useful to set your own rendering props or use browserless
+  browser: browser,
+});
+```
+
 ### `instance.jsonToDataURL(json, attrs)`
 
 Export json into data URL.

package/instance.js

@@ -53,10 +53,22 @@ module.exports.jsonToPDFDataURL = async (page, json, attrs) => {
   );
 };
 
+module.exports.jsonToBlob = async (page, json, attrs) => {
+  return page.evaluate(
+    async (json, attrs) => {
+      store.loadJSON(json);
+      await store.waitLoading();
+      return await store.toBlob(attrs);
+    },
+    json,
+    attrs || {}
+  );
+};
+
 module.exports.createInstance = async ({
   key,
   url,
-  useParallelPages,
+  useParallelPages = true,
   browser,
 } = {}) => {
   const visitPage = url || `${DEFAULT_CLIENT}?key=${key}`;
@@ -69,11 +81,18 @@ module.exports.createInstance = async ({
       ? await module.exports.createPage(browser, visitPage)
       : firstPage;
 
-    const result = await page.evaluate(func, ...args);
-    if (useParallelPages) {
-      page.close();
+    try {
+      const result = await page.evaluate(func, ...args);
+      if (useParallelPages) {
+        page.close();
+      }
+      return result;
+    } catch (e) {
+      if (useParallelPages) {
+        page.close();
+      }
+      throw e;
     }
-    return result;
   };
 
   const jsonToDataURL = async (json, attrs) => {
@@ -107,6 +126,18 @@ module.exports.createInstance = async ({
     );
   };
 
+  const jsonToBlob = async (json, attrs) => {
+    return await run(
+      async (json, attrs) => {
+        store.loadJSON(json);
+        await store.waitLoading();
+        return await store.toBlob(attrs);
+      },
+      json,
+      attrs || {}
+    );
+  };
+
   const jsonToPDFBase64 = async (json, attrs) => {
     const url = await jsonToPDFDataURL(json, attrs);
     return url.split('base64,')[1];
@@ -115,10 +146,12 @@ module.exports.createInstance = async ({
   return {
     close: async () => await browser.close(),
     firstPage,
+    browser,
     run,
     jsonToDataURL,
     jsonToImageBase64,
     jsonToPDFDataURL,
     jsonToPDFBase64,
+    jsonToBlob,
   };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polotno-node",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "description": "Polotno workflow from NodeJS",
   "main": "index.js",
   "scripts": {