This package will help you make your app compatible with Cantoo Scribe.

Add the package to your project:

npm install cantoo@cantoo-client

Alternatively, you can download the latest version here, but you will have to manually update it when needed.

Then, you will have to create a CantooClient instance:

const CantooClient = require('cantoo@cantoo-client')
const cantoo = new CantooClient()

Now, here are the main instructions that you will have to handle:

The methods that you should call:

When the app is ready, you must call this method.

initMyApp().then(() => cantoo.loaded())

Cantoo Scribe needs to be aware when a change is available in your app. Call this method each time a change occurs that the user might want to save. Be aware that an internal debounce will happen to avoid flood, so don't worry about it.

doSomethingThatWillUpdateTheState()
cantoo.updated()

When you want to clear all listeners set and free the memory hold by the CantooClient object, call the destroy() method.

cantoo.destroy()

Cantoo Scribe sometimes needs the current document. You need to register a listener to that event, and it should return a string containing the data you would need to recreate the document, and an image (svg or png) that can best represent the current work of the user.

const generateDocument = async () => {
  return {
    doc: await gatherTheDataOfMyApp()
    svg: await generatePicture()
  }
}
cantoo.onDocumentRequest(generateDocument)

Cantoo Scribe might ask your app to clean up and be ready to generate a new document. Don't worry, the user would have had the chance to save the data if they needed to. There is nothing else to do but to clear the current document state.

const clearAll = async () => {
  // Don't forget to await, or to return a promise so Cantoo Scribe knows when the document is ready
  await flush()
}
cantoo.onClearRequest(clearAll)

Cantoo Scribe might ask your app to load a new document. You will receive, as a string, the document data you provided in the onDocumentRequest method. This is your responsability to maintain retro-compatibility of those data accross versions of your app.

const loadDocument = async (data: string) => {
  // Don't forget to await, or to return a promise so Cantoo Scribe knows when the document is ready
  await loadTheDataInTheApp(data)
}
cantoo.onLoadDocumentRequest(loadDocument)