Napoleon's Penguin Mascot

    TypeScript icon, indicating that this package has built-in type declarations

    2.4.1 • Public • Published



    Install @wora/offline-first using yarn or npm:

    yarn add @wora/offline-first


    import OfflineFirst, { OfflineFirstOptions, OfflineRecordCache, Request } from "@wora/offline-first";
    const persistOptionsStoreOffline = {
        prefix: 'example-offline',
        serialize: true,
    function execute(offlineRecord) {
        // ... fetch
    function discard(offlineRecord) {
        // ... rollback
        return true;
    function complete(offlineRecord) {
        // ... commit
        return true;
    const options: OfflineFirstOptions<Payload> = {
            execute: (offlineRecord: any) => execute(offlineRecord),
            finish?: (success: boolean, mutations: ReadonlyArray<OfflineRecordCache<T>> ) => void,
            onComplete: (options: { offlineRecord: OfflineRecordCache<T>, response: any }) => complete(options),
            onDiscard: (options: { offlineRecord: OfflineRecordCache<T>, error: any }) => discard(options),
    const offlineFirst = new OfflineFirst(options, persistOptionsStoreOffline);  
    // ...
    offlineFirst.restore().then(isRestored => setState(isRestored))
    // ...
        request : {
            payload: { url: '/api/todo', method: 'POST', json: { todoId } }


    export type OfflineFirstOptions<T> = {
        manualExecution?: boolean;
        execute: (offlineRecord: OfflineRecordCache<T>) => Promise<any>,
        finish?: (success: boolean, mutations: ReadonlyArray<OfflineRecordCache<T>> ) => void,
        onComplete?: (options: { offlineRecord: OfflineRecordCache<T>, response: any }) => boolean;
        onDiscard?: (options: { offlineRecord: OfflineRecordCache<T>, error: any }) => boolean;
        onPublish?: ( offlineRecord: OfflineRecordCache<T>) => OfflineRecordCache<T>,
        compare?: (v1: OfflineRecordCache<T>, v2: OfflineRecordCache<T>) => number;
    • execute: this is the only mandatory parameter. In this function, communications with the server must be implemented.

    • finish: function that is called once the request queue has been processed.

    • manualExecution: if set to true, requests in the queue are no longer performed automatically as soon as you go back online. invoke manually: offlineFirst.process();

    • onPublish: function that is called before saving the mutation in the store

    • onComplete: function that is called once the request has been successfully completed. Only if the function returns the value true, the request is deleted from the queue.

    • onDiscard: function that is called when the request returns an error. Only if the function returns the value true, the mutation is deleted from the queue


    publish(options: {
            id?: string,
            request: Request<T>,
        }): Promise<OfflineRecordCache<T>>
    • This is the method that must be invoked when you want to insert a request in the store.

    request parameter is the only mandatory one and consists of the main information useful for managing the execution of the request.

    requests are executed in parallel, but with the serial parameter it is possible to specify whether you want to execute some or all of the requests sequentially.


    export type Request<T> = {
        payload: T,
        backup?: any,
        sink?: any,
    • it is advisable to use the backup and sink fields when working in contexts with optimistic responses. In order to manage any UI updates.
    export type OfflineRecordCache<T> = {
        id: string,
        request: Request<T>,
        fetchTime: number,
        state?: string,
        retry?: number,
        error?: any,
        serial?: boolean
    • The parameters fetchTime, state,retry and error are managed automatically by the library during the offline process.

    This library depends exclusively on @wora/cache-persist and @wora/network-detect and I recommend using all their features and potential.


    npm i @wora/offline-first

    DownloadsWeekly Downloads






    Unpacked Size

    29 kB

    Total Files


    Last publish


    • morrys