@formio/offline-plugin 5.4.1 → 5.4.2

package/README.md

@@ -10,10 +10,10 @@ The offline plugin uses IndexedDB to store records so the browser must support i
 
 Offline mode is using features supported in the following browsers and later:
 
-	- Chrome v38
-	- Safari 7.1
-	- IE 11
-	- Firefox 13
+    - Chrome v38
+    - Safari 7.1
+    - IE 11
+    - Firefox 13
 
 ## Installing the plugin
 
@@ -23,10 +23,10 @@ This module is now distributed via NPM and will require a premium license for us
 
 `yarn add @formio/offline-plugin`
 
-For more details please see our [help docs](https://help.form.io/deployments/maintenance-and-migration/premium-libraries). 
-
+For more details please see our [help docs](https://help.form.io/deployments/maintenance-and-migration/premium-libraries).
 
 ## Using the offline mode module in your project
+
 To use this module, you will use the same process described @ https://help.form.io/developers/modules#using-a-module but for this module. This will
 look like the following in your application.
 
@@ -37,92 +37,115 @@ import { OfflinePlugin } from '@formio/offline-plugin';
 // You need to have a valid Library License key to use this package.
 // If you don't have one yet, please contact sales@form.io.
 Formio.license = 'yourLibraryLicenseKey';
-Formio.use(OfflinePlugin(
-  'myproject-offline', // The name of this offline instance.
-  'https://myproject.form.io', // Your project URL
-  'path/to/project.json' // OPTIONAL: the exported project.json file.
-));
+Formio.use(
+  OfflinePlugin(
+    'myproject-offline', // The name of this offline instance.
+    'https://myproject.form.io', // Your project URL
+    'path/to/project.json', // OPTIONAL: the exported project.json file.
+  ),
+);
 ```
 
-The arguments that you provide to the ```OfflinePlugin``` method are found below in the SDK section.
+The arguments that you provide to the `OfflinePlugin` method are found below in the SDK section.
 
-If you are using any of the Angular or React, wrappers, you may need to import the ```Formio``` instance from those modules instead as follows.
+If you are using any of the Angular or React, wrappers, you may need to import the `Formio` instance from those modules instead as follows.
 
 ```javascript
 import { Formio } from '@formio/angular';
 ```
 
 ## Accessing the module
-Once the module has been intialized, you can access the instance of this plugin anywhere in your application using the ```getPlugin``` API as follows.
+
+Once the module has been intialized, you can access the instance of this plugin anywhere in your application using the `getPlugin` API as follows.
 
 ```javascript
 const OfflinePlugin = Formio.getPlugin('myproject-offline');
 ```
 
-If you want to use a <script> tag directly in your HTML file instead*:
+If you want to use a <script> tag directly in your HTML file instead\*:
 
 ```html
 <script src="node_modules/@formio/offline-plugin/offline.full.min.js"></script>
 ```
 
-*Once you do this, the offline module will introduce a new global called ```FormioOfflinePlugin```, which you can now use to register the OfflinePlugin as you did above using the following script.
+\*Once you do this, the offline module will introduce a new global called `FormioOfflinePlugin`, which you can now use to register the OfflinePlugin as you did above using the following script.
 
 ```html
 <script type="application/javascript">
-  Formio.use(FormioOfflinePlugin.OfflinePlugin('myproject-offline', 'https://myproject.form.io', 'path/to/project.json'));
+  Formio.use(
+    FormioOfflinePlugin.OfflinePlugin(
+      'myproject-offline',
+      'https://myproject.form.io',
+      'path/to/project.json',
+    ),
+  );
 </script>
 ```
 
 You can now embed your form as you normally would and it will use the offline mode system.
 
 #### Deployed Servers
+
 Deployed installations may also need to provide baseUrl and projectUrl. These tell the renderer the Base URL as well as the project URL being used when embedding the offline script.
 
 ```html
 <script type="application/javascript">
   Formio.setBaseUrl('https://forms.yourdomain.com');
   Formio.setProjectUrl('https://forms.yourdomain.com/yourproject');
-  Formio.use(FormioOfflinePlugin.OfflinePlugin('myproject-offline', 'https://forms.yourdomain.com/yourproject', 'path/to/project.json'));
+  Formio.use(
+    FormioOfflinePlugin.OfflinePlugin(
+      'myproject-offline',
+      'https://forms.yourdomain.com/yourproject',
+      'path/to/project.json',
+    ),
+  );
 </script>
 ```
 
 ## SDK
 
 ### OfflinePlugin(name, projectUrl, [projectJsonPath], [options])
+
 Factory method that returns a Form.io Module which contains a new instance of the FormioOfflinePlugin class, which controls the offline mode for this project.
 
- - **name**: This is a name you come up with to contexualize your offline mode for this project.
- - **projectUrl**: This is the URL of the project this offline mode plugin is attached to.
- - **projectJson** (optional): Providing this will provide the default project.json of your project. You can get this by exporting your project. If you do not provide this, then your application will need to request the Form online before it will cache that form to be used offline. By providing the url to this file, the offline mode will use the offline form by default and not have to send a request to the api.
- - **options** (optional): Optional configurations to control how the offline module plugin behaves. The following options are allowed.
-   - **dequeueOnReconnect** - Set to true if you wish for the plugin to automatically dequeue the saved offline submissions as soon as an internet connection has been made.
-   - **queryFiltersTypes** - Default query arguments to add to the search queries for the submission index for caching purposes.
-   - **notToShowDeletedOfflineSubmissions** - Set to true if you do not wish to show deleted offline submissions in the submission index.
-   - **deleteErrorSubmissions** - Set to true if you wish to automatically delete submission errors.
+- **name**: This is a name you come up with to contexualize your offline mode for this project.
+- **projectUrl**: This is the URL of the project this offline mode plugin is attached to.
+- **projectJson** (optional): Providing this will provide the default project.json of your project. You can get this by exporting your project. If you do not provide this, then your application will need to request the Form online before it will cache that form to be used offline. By providing the url to this file, the offline mode will use the offline form by default and not have to send a request to the api.
+- **options** (optional): Optional configurations to control how the offline module plugin behaves. The following options are allowed.
+  - **dequeueOnReconnect** - Set to true if you wish for the plugin to automatically dequeue the saved offline submissions as soon as an internet connection has been made.
+  - **queryFiltersTypes** - Default query arguments to add to the search queries for the submission index for caching purposes.
+  - **notToShowDeletedOfflineSubmissions** - Set to true if you do not wish to show deleted offline submissions in the submission index.
+  - **deleteErrorSubmissions** - Set to true if you wish to automatically delete submission errors.
 
 ### new FormioOfflinePlugin(projectUrl, [projectJsonPath])
+
 Creates a new offline module instance for a project.
 
- - **projectUrl**: This is the URL of the project this offline mode plugin is attached to.
- - **projectJson** (optional): Providing this will provide the default project.json of your project. You can get this by exporting your project. If you do not provide this, then your application will need to request the Form online before it will cache that form to be used offline. By providing the url to this file, the offline mode will use the offline form by default and not have to send a request to the api.
+- **projectUrl**: This is the URL of the project this offline mode plugin is attached to.
+- **projectJson** (optional): Providing this will provide the default project.json of your project. You can get this by exporting your project. If you do not provide this, then your application will need to request the Form online before it will cache that form to be used offline. By providing the url to this file, the offline mode will use the offline form by default and not have to send a request to the api.
 
 ## Saving forms and submissions offline
+
 Once you register a plugin for a particular project, all load requests for forms and submissions in that project will automatically save and update in an offline browser data store.
 
 For example, you can have all submissions for a form available offline if you call `formio.loadSubmissions()` at some point in your app while online.
 
 ## Loading forms and submissions offline
+
 When your app goes offline, requests to load a form or submission will automatically return the data cached offline, if available.
 
 ## Submitting forms offline
+
 Form submissions work a little bit differently when this plugin is registered. All form submissions, submission edits, and submission deletions are added to a queue. If the app is online, the queue will be emptied immediately and behave like normal. But when the app is offline, the submissions stay in the queue until the app goes back online. Until then, Formio.js will behave as if the submission was successful.
 
 The queue will automatically start to empty when a submission is successfully made online, or you may [manually start](#plugindequeuesubmissions) it.
 
 ## Deleting submissions offline
-When you delete a submission offline, this won't be deleted from the local DB, it will be just marked as '_deleted'. The submission will be deleted from the local DB only in online, when the 'DELETE' request is sent. You can prevent showing deleted submissions in offline by setting the 'notToShowDeletedOfflineSubmissions' flag in the plugin's config to 'true'.
+
+When you delete a submission offline, this won't be deleted from the local DB, it will be just marked as '\_deleted'. The submission will be deleted from the local DB only in online, when the 'DELETE' request is sent. You can prevent showing deleted submissions in offline by setting the 'notToShowDeletedOfflineSubmissions' flag in the plugin's config to 'true'.
 
 ## Handling submission queue errors
+
 Some queued submissions may fail when they are sent online (ex: unique validation fails on the server). In the event a queued submission fails, the queue is stopped and events are triggered to allow your app to resolve the bad submission before continuing. It's up to your app to decide how to handle these errors. Your app may decide to prompt the user to [fix the form submission](#pluginsetnextqueuedsubmissionrequest) or simply [ignore the submission](#pluginskipnextqueuedsubmission), and [restart the queue](#plugindequeuesubmissions).
 
 ## Plugin methods
@@ -163,7 +186,6 @@ Discards the next request in the submission queue.
 
 You can use this to ignore a failed submission and then call [`dequeueSubmissions()`](#plugindequeuesubmissions) to continue to the next queued request.
 
-
 ## Events
 
 You can listen for these events by adding listeners to the `Formio.events` EventEmitter.
@@ -201,7 +223,7 @@ Triggered when the queue becomes empty after dequeuing.
 You may set `skipQueue` to save a submission immediately, skipping the queue. This will disable offline queuing for that submission. For example:
 
 ```javascript
-formio.saveSubmission(submission, {skipQueue: true});
+formio.saveSubmission(submission, { skipQueue: true });
 ```
 
 If you are using the Angular ngFormio library, you can set the skipQueue option with formio-options:
@@ -212,8 +234,8 @@ If you are using the Angular ngFormio library, you can set the skipQueue option
 
 ## Build Commands
 
-* `npm run build` - build for production
-* `npm run watch` - automatically recompile during development
+- `npm run build` - build for production
+- `npm run watch` - automatically recompile during development
 
 ## FAQs
 

package/lib/index.d.ts

@@ -1,3 +1,3 @@
-import { FormioOfflinePlugin } from "./FormioOfflinePlugin";
+import { FormioOfflinePlugin } from './FormioOfflinePlugin';
 export default FormioOfflinePlugin;
 export declare const OfflinePlugin: typeof FormioOfflinePlugin.OfflinePlugin;