@forward-software/react-auth 1.1.0 → 2.0.1

package/dist/react-auth.esm.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"react-auth.esm.js","sources":["../src/types/deferred.ts","../src/types/eventEmitter.ts","../src/types/index.ts","../src/index.tsx"],"sourcesContent":["export class Deferred<T> {\n  private promise: Promise<T>;\n\n  public resolve!: (value: T | PromiseLike<T>) => void;\n\n  public reject!: (reason?: any) => void;\n\n  constructor() {\n    this.promise = new Promise<T>((resolve, reject) => {\n      this.reject = reject;\n      this.resolve = resolve;\n    });\n  }\n\n  public getPromise(): Promise<T> {\n    return this.promise;\n  }\n}\n","type EventsMap = Record<string, any>;\n\nexport type EventKey<T extends EventsMap> = string & keyof T;\n\nexport type EventReceiver<T> = (params: T) => void;\n\ninterface Emitter<T extends EventsMap> {\n  on<K extends EventKey<T>>(eventName: K, fn: EventReceiver<T[K]>): void;\n  off<K extends EventKey<T>>(eventName: K, fn: EventReceiver<T[K]>): void;\n  emit<K extends EventKey<T>>(eventName: K, params: T[K]): void;\n}\n\n// TODO: Improve -> `listeners` are unbounded -- don't use this in practice!\nexport function createEventEmitter<T extends EventsMap>(): Emitter<T> {\n  const listeners: {\n    [K in keyof EventsMap]?: Array<(p: EventsMap[K]) => void>;\n  } = {};\n\n  return {\n    on(key, fn) {\n      listeners[key] = (listeners[key] || []).concat(fn);\n    },\n    off(key, fn) {\n      listeners[key] = (listeners[key] || []).filter(f => f !== fn);\n    },\n    emit(key, data) {\n      (listeners[key] || []).forEach(function(fn) {\n        try {\n          fn(data);\n        } catch {}\n      });\n    },\n  };\n}\n","import { Deferred } from './deferred';\nimport { createEventEmitter, EventKey, EventReceiver } from './eventEmitter';\n\ntype AuthTokens = {};\n\ntype AuthCredentials = {};\n\ntype AuthEventsMap<E extends Error> = {\n  initSuccess: undefined;\n\n  initFailed: E;\n\n  loginStarted: undefined;\n\n  loginSuccess: undefined;\n\n  loginFailed: E;\n\n  refreshStarted: undefined;\n\n  refreshSuccess: undefined;\n\n  refreshFailed: E;\n\n  logoutStarted: undefined;\n\n  logoutSuccess: undefined;\n\n  logoutFailed: E;\n};\n\ntype SubscribeFn = () => void;\n\ntype UnsubscribeFn = () => boolean;\n\ntype AuthClientState<T> = {\n  isAuthenticated: boolean;\n\n  isInitialized: boolean;\n\n  tokens: Partial<T>;\n};\n\nexport abstract class BaseAuthClient<\n  T = AuthTokens,\n  C = AuthCredentials,\n  E extends Error = Error\n> {\n  private _state: Readonly<AuthClientState<T>> = {\n    isAuthenticated: false,\n    isInitialized: false,\n    tokens: {},\n  };\n\n  // refresh queue - used to avoid concurrency issue during Token refresh\n  private refreshQ: Array<Deferred<boolean>> = [];\n\n  private eventEmitter = createEventEmitter<AuthEventsMap<E>>();\n\n  private subscribers: Set<SubscribeFn> = new Set();\n\n  //\n  // Getters\n  //\n\n  public get isInitialized() {\n    return this._state.isInitialized;\n  }\n\n  public get isAuthenticated() {\n    return this._state.isAuthenticated;\n  }\n\n  public get tokens() {\n    return this._state.tokens;\n  }\n\n  //\n  // Public methods\n  //\n\n  public async init(): Promise<boolean> {\n    try {\n      await this.onInit();\n\n      this.setState({\n        isInitialized: true,\n      });\n\n      this.emit('initSuccess', undefined);\n    } catch (error) {\n      this.setState({\n        isInitialized: false,\n      });\n\n      this.emit('initFailed', error as E);\n    }\n\n    await this.onPostInit?.();\n\n    return this.isInitialized;\n  }\n\n  public async login(credentials?: C): Promise<boolean> {\n    this.emit('loginStarted', undefined);\n\n    await this.onPreLogin?.();\n\n    let isSuccess: boolean = false;\n\n    try {\n      const tokens = await this.onLogin(credentials);\n\n      this.setState({\n        isAuthenticated: true,\n        tokens,\n      });\n\n      this.emit('loginSuccess', undefined);\n\n      isSuccess = true;\n    } catch (err) {\n      this.setState({\n        isAuthenticated: false,\n        tokens: {},\n      });\n\n      this.emit('loginFailed', err as E);\n\n      isSuccess = false;\n    }\n\n    await this.onPostLogin?.(isSuccess);\n\n    return this.isAuthenticated;\n  }\n\n  public async refresh(minValidity?: number): Promise<boolean> {\n    const deferred = new Deferred<boolean>();\n\n    this.runRefresh(deferred, minValidity);\n\n    return deferred.getPromise();\n  }\n\n  public async logout(): Promise<void> {\n    this.emit('logoutStarted', undefined);\n\n    await this.onPreLogout?.();\n\n    let isSuccess: boolean = false;\n\n    try {\n      await this.onLogout();\n\n      this.setState({\n        isAuthenticated: false,\n        tokens: {},\n      });\n\n      this.emit('logoutSuccess', undefined);\n\n      isSuccess = true;\n    } catch (err) {\n      this.emit('logoutFailed', err as E);\n\n      isSuccess = false;\n    }\n\n    await this.onPostLogout?.(isSuccess);\n  }\n\n  public on<K extends EventKey<AuthEventsMap<E>>>(\n    eventName: K,\n    listener: EventReceiver<AuthEventsMap<E>[K]>\n  ): void {\n    this.eventEmitter.on(eventName, listener);\n  }\n\n  public off<K extends EventKey<AuthEventsMap<E>>>(\n    eventName: K,\n    listener: EventReceiver<AuthEventsMap<E>[K]>\n  ): void {\n    this.eventEmitter.off(eventName, listener);\n  }\n\n  // Should be declared like this to avoid binding issues when used by useSyncExternalStore\n  public subscribe = (subscription: SubscribeFn): UnsubscribeFn => {\n    this.subscribers.add(subscription);\n\n    return () => this.subscribers.delete(subscription);\n  };\n\n  // Should be declared like this to avoid binding issues when used by useSyncExternalStore\n  public getSnapshot = (): AuthClientState<T> => {\n    return this._state;\n  };\n\n  //\n  // Protected methods\n  //\n\n  protected setState(stateUpdate: Partial<AuthClientState<T>>): void {\n    this._state = {\n      ...this._state,\n      ...stateUpdate,\n    };\n\n    this.notifySubscribers();\n  }\n\n  //\n  // Private methods\n  //\n\n  private async runRefresh(\n    deferred: Deferred<boolean>,\n    minValidity?: number\n  ): Promise<void> {\n    // Add deferred Promise to refresh queue\n    this.refreshQ.push(deferred);\n\n    // If refresh queue already has promises enqueued do not attempt a new refresh - one is already in progress\n    if (this.refreshQ.length !== 1) {\n      return;\n    }\n\n    this.emit('refreshStarted', undefined);\n\n    await this.onPreRefresh?.();\n\n    let isAuthenticated: boolean = false;\n    let tokens: Partial<T> = {};\n\n    try {\n      tokens = await this.onRefresh(minValidity);\n      isAuthenticated = true;\n\n      this.emit('refreshSuccess', undefined);\n    } catch (err) {\n      isAuthenticated = false;\n\n      this.emit('refreshFailed', err as E);\n    }\n\n    this.setState({\n      isAuthenticated,\n      tokens,\n    });\n\n    await this.onPostRefresh?.(isAuthenticated);\n\n    for (let p = this.refreshQ.pop(); p != null; p = this.refreshQ.pop()) {\n      p.resolve(isAuthenticated);\n    }\n  }\n\n  private emit<K extends EventKey<AuthEventsMap<E>>>(\n    eventName: K,\n    error: AuthEventsMap<E>[K]\n  ): void {\n    this.eventEmitter.emit(eventName, error);\n  }\n\n  private notifySubscribers() {\n    this.subscribers.forEach(s => {\n      try {\n        s();\n      } catch {}\n    });\n  }\n\n  //\n  // Abstract methods\n  //\n\n  protected abstract onInit(): Promise<void>;\n\n  protected onPostInit?(): Promise<void>;\n\n  protected onPreLogin?(): Promise<void>;\n\n  protected abstract onLogin(credentials?: C): Promise<T>;\n\n  protected onPostLogin?(isSuccess: boolean): Promise<void>;\n\n  protected onPreRefresh?(): Promise<void>;\n\n  protected abstract onRefresh(minValidity?: number): Promise<T>;\n\n  protected onPostRefresh?(isSuccess: boolean): Promise<void>;\n\n  protected onPreLogout?(): Promise<void>;\n\n  protected abstract onLogout(): Promise<void>;\n\n  protected onPostLogout?(isSuccess: boolean): Promise<void>;\n}\n","import React, { createContext, useContext, useEffect, useState } from 'react';\nimport { useSyncExternalStore } from 'use-sync-external-store/shim';\n\nimport { BaseAuthClient } from './types';\n\n/**\n * Props that can be passed to AuthProvider\n */\nexport type AuthProviderProps = {\n  children?: React.ReactNode;\n\n  /**\n   * An optional component to display if AuthClient initialization failed.\n   */\n  ErrorComponent?: JSX.Element;\n\n  /**\n   * An optional component to display while AuthClient instance is being initialized.\n   */\n  LoadingComponent?: JSX.Element;\n};\n\ntype AuthProviderState = {\n  isAuthenticated: boolean;\n\n  isInitialized: boolean;\n};\n\ntype AuthContext<C extends BaseAuthClient> = AuthProviderState & {\n  authClient: C;\n};\n\nexport function createAuth<C extends BaseAuthClient>(authClient: C) {\n  // Create a React context containing a BaseAuthClient instance.\n  const authContext = createContext<AuthContext<C> | null>(null);\n\n  // Create the React Context Provider for the BaseAuthClient instance.\n  const AuthProvider: React.FC<AuthProviderProps> = ({\n    children,\n    ErrorComponent,\n    LoadingComponent,\n  }) => {\n    const [isInitFailed, setInitFailed] = useState(false);\n    const { isAuthenticated, isInitialized } = useSyncExternalStore(\n      authClient.subscribe,\n      authClient.getSnapshot\n    );\n\n    useEffect(() => {\n      async function initAuthClient() {\n        // Call init function\n        const initSuccess = await authClient.init();\n        setInitFailed(!initSuccess);\n      }\n\n      // Init AuthClient\n      initAuthClient();\n    }, []);\n\n    if (!!ErrorComponent && isInitFailed) {\n      return ErrorComponent;\n    }\n\n    if (!!LoadingComponent && !isInitialized) {\n      return LoadingComponent;\n    }\n\n    return (\n      <authContext.Provider\n        value={{\n          authClient,\n          isAuthenticated,\n          isInitialized,\n        }}\n      >\n        {children}\n      </authContext.Provider>\n    );\n  };\n\n  // Retrieve the AuthClient from the current context\n  const useAuthClient = function(): C {\n    const ctx = useContext(authContext);\n\n    if (!ctx) {\n      throw new Error('useAuthClient hook should be used inside AuthProvider');\n    }\n\n    return ctx.authClient;\n  };\n\n  return {\n    AuthProvider,\n    useAuthClient,\n  };\n}\n\nexport { BaseAuthClient };\n"],"names":["Deferred","promise","Promise","resolve","reject","getPromise","createEventEmitter","listeners","on","key","fn","concat","off","filter","f","emit","data","forEach","BaseAuthClient","isAuthenticated","isInitialized","tokens","Set","subscription","subscribers","add","_state","init","onInit","setState","undefined","onPostInit","login","credentials","onPreLogin","isSuccess","onLogin","onPostLogin","refresh","minValidity","deferred","runRefresh","logout","onPreLogout","onLogout","onPostLogout","eventName","listener","eventEmitter","stateUpdate","notifySubscribers","refreshQ","push","length","onPreRefresh","onRefresh","onPostRefresh","p","pop","error","s","createAuth","authClient","authContext","createContext","AuthProvider","children","ErrorComponent","LoadingComponent","useState","isInitFailed","setInitFailed","useSyncExternalStore","subscribe","getSnapshot","useEffect","initAuthClient","initSuccess","React","Provider","value","useAuthClient","ctx","useContext","Error"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAaA,QAAQ;EAOnB;;IACE,IAAI,CAACC,OAAO,GAAG,IAAIC,OAAO,CAAI,UAACC,OAAO,EAAEC,MAAM;MAC5C,KAAI,CAACA,MAAM,GAAGA,MAAM;MACpB,KAAI,CAACD,OAAO,GAAGA,OAAO;KACvB,CAAC;;EACH;EAAA,OAEME,UAAU,GAAV;IACL,OAAO,IAAI,CAACJ,OAAO;GACpB;EAAA;AAAA;;ACJH;AACA,SAAgBK,kBAAkB;EAChC,IAAMC,SAAS,GAEX,EAAE;EAEN,OAAO;IACLC,EAAE,cAACC,GAAG,EAAEC,EAAE;MACRH,SAAS,CAACE,GAAG,CAAC,GAAG,CAACF,SAAS,CAACE,GAAG,CAAC,IAAI,EAAE,EAAEE,MAAM,CAACD,EAAE,CAAC;KACnD;IACDE,GAAG,eAACH,GAAG,EAAEC,EAAE;MACTH,SAAS,CAACE,GAAG,CAAC,GAAG,CAACF,SAAS,CAACE,GAAG,CAAC,IAAI,EAAE,EAAEI,MAAM,CAAC,UAAAC,CAAC;QAAA,OAAIA,CAAC,KAAKJ,EAAE;QAAC;KAC9D;IACDK,IAAI,gBAACN,GAAG,EAAEO,IAAI;MACZ,CAACT,SAAS,CAACE,GAAG,CAAC,IAAI,EAAE,EAAEQ,OAAO,CAAC,UAASP,EAAE;QACxC,IAAI;UACFA,EAAE,CAACM,IAAI,CAAC;SACT,CAAC,gBAAM;OACT,CAAC;;GAEL;AACH;;ICUsBE,cAAc;EAApC;;IAKU,WAAM,GAAiC;MAC7CC,eAAe,EAAE,KAAK;MACtBC,aAAa,EAAE,KAAK;MACpBC,MAAM,EAAE;KACT;;IAGO,aAAQ,GAA6B,EAAE;IAEvC,iBAAY,GAAGf,kBAAkB,EAAoB;IAErD,gBAAW,GAAqB,IAAIgB,GAAG,EAAE;;IAgI1C,cAAS,GAAG,UAACC,YAAyB;MAC3C,KAAI,CAACC,WAAW,CAACC,GAAG,CAACF,YAAY,CAAC;MAElC,OAAO;QAAA,OAAM,KAAI,CAACC,WAAW,UAAO,CAACD,YAAY,CAAC;;KACnD;;IAGM,gBAAW,GAAG;MACnB,OAAO,KAAI,CAACG,MAAM;KACnB;;;;;EArID;;;;EAgBA,OAEaC,IAAI;;EAAA;IAAA,oFAAV;MAAA;MAAA;QAAA;UAAA;YAAA;cAAA;cAAA;cAAA,OAEG,IAAI,CAACC,MAAM,EAAE;YAAA;cAEnB,IAAI,CAACC,QAAQ,CAAC;gBACZT,aAAa,EAAE;eAChB,CAAC;cAEF,IAAI,CAACL,IAAI,CAAC,aAAa,EAAEe,SAAS,CAAC;cAAC;cAAA;YAAA;cAAA;cAAA;cAEpC,IAAI,CAACD,QAAQ,CAAC;gBACZT,aAAa,EAAE;eAChB,CAAC;cAEF,IAAI,CAACL,IAAI,CAAC,YAAY,cAAa;YAAC;cAAA;cAAA,2BAGhC,IAAI,CAACgB,UAAU,qBAAf,0BAAI,CAAe;YAAA;cAAA,iCAElB,IAAI,CAACX,aAAa;YAAA;YAAA;cAAA;;;;KAC1B;IAAA;MAAA;;IAAA;;EAAA,OAEYY,KAAK;IAAA,qFAAX,kBAAYC,WAAe;MAAA;MAAA;MAAA;QAAA;UAAA;YAAA;cAChC,IAAI,CAAClB,IAAI,CAAC,cAAc,EAAEe,SAAS,CAAC;cAAC;cAAA,2BAE/B,IAAI,CAACI,UAAU,qBAAf,0BAAI,CAAe;YAAA;cAErBC,SAAS,GAAY,KAAK;cAAA;cAAA;cAAA,OAGP,IAAI,CAACC,OAAO,CAACH,WAAW,CAAC;YAAA;cAAxCZ,MAAM;cAEZ,IAAI,CAACQ,QAAQ,CAAC;gBACZV,eAAe,EAAE,IAAI;gBACrBE,MAAM,EAANA;eACD,CAAC;cAEF,IAAI,CAACN,IAAI,CAAC,cAAc,EAAEe,SAAS,CAAC;cAEpCK,SAAS,GAAG,IAAI;cAAC;cAAA;YAAA;cAAA;cAAA;cAEjB,IAAI,CAACN,QAAQ,CAAC;gBACZV,eAAe,EAAE,KAAK;gBACtBE,MAAM,EAAE;eACT,CAAC;cAEF,IAAI,CAACN,IAAI,CAAC,aAAa,eAAW;cAElCoB,SAAS,GAAG,KAAK;YAAC;cAAA;cAAA,4BAGd,IAAI,CAACE,WAAW,qBAAhB,2BAAI,EAAeF,SAAS,CAAC;YAAA;cAAA,kCAE5B,IAAI,CAAChB,eAAe;YAAA;YAAA;cAAA;;;;KAC5B;IAAA;MAAA;;IAAA;;EAAA,OAEYmB,OAAO;IAAA,uFAAb,kBAAcC,WAAoB;MAAA;MAAA;QAAA;UAAA;YAAA;cACjCC,QAAQ,GAAG,IAAIxC,QAAQ,EAAW;cAExC,IAAI,CAACyC,UAAU,CAACD,QAAQ,EAAED,WAAW,CAAC;cAAC,kCAEhCC,QAAQ,CAACnC,UAAU,EAAE;YAAA;YAAA;cAAA;;;;KAC7B;IAAA;MAAA;;IAAA;;EAAA,OAEYqC,MAAM;IAAA,sFAAZ;MAAA;MAAA;MAAA;QAAA;UAAA;YAAA;cACL,IAAI,CAAC3B,IAAI,CAAC,eAAe,EAAEe,SAAS,CAAC;cAAC;cAAA,4BAEhC,IAAI,CAACa,WAAW,qBAAhB,2BAAI,CAAgB;YAAA;cAEtBR,SAAS,GAAY,KAAK;cAAA;cAAA;cAAA,OAGtB,IAAI,CAACS,QAAQ,EAAE;YAAA;cAErB,IAAI,CAACf,QAAQ,CAAC;gBACZV,eAAe,EAAE,KAAK;gBACtBE,MAAM,EAAE;eACT,CAAC;cAEF,IAAI,CAACN,IAAI,CAAC,eAAe,EAAEe,SAAS,CAAC;cAErCK,SAAS,GAAG,IAAI;cAAC;cAAA;YAAA;cAAA;cAAA;cAEjB,IAAI,CAACpB,IAAI,CAAC,cAAc,eAAW;cAEnCoB,SAAS,GAAG,KAAK;YAAC;cAAA;cAAA,6BAGd,IAAI,CAACU,YAAY,qBAAjB,4BAAI,EAAgBV,SAAS,CAAC;YAAA;YAAA;cAAA;;;;KACrC;IAAA;MAAA;;IAAA;;EAAA,OAEM3B,EAAE,GAAF,YACLsC,SAAY,EACZC,QAA4C;IAE5C,IAAI,CAACC,YAAY,CAACxC,EAAE,CAACsC,SAAS,EAAEC,QAAQ,CAAC;GAC1C;EAAA,OAEMnC,GAAG,GAAH,aACLkC,SAAY,EACZC,QAA4C;IAE5C,IAAI,CAACC,YAAY,CAACpC,GAAG,CAACkC,SAAS,EAAEC,QAAQ,CAAC;;;;;;EAiB5C,OAEUlB,QAAQ,GAAR,kBAASoB,WAAwC;IACzD,IAAI,CAACvB,MAAM,gBACN,IAAI,CAACA,MAAM,EACXuB,WAAW,CACf;IAED,IAAI,CAACC,iBAAiB,EAAE;;;;;;EAK1B,OAEcT,UAAU;;EAAA;IAAA,0FAAhB,kBACND,QAA2B,EAC3BD,WAAoB;MAAA;MAAA;MAAA;QAAA;UAAA;YAAA;;cAGpB,IAAI,CAACY,QAAQ,CAACC,IAAI,CAACZ,QAAQ,CAAC;;cAE5B,MACI,IAAI,CAACW,QAAQ,CAACE,MAAM,KAAK,CAAC;gBAAA;gBAAA;;cAAA;YAAA;cAI9B,IAAI,CAACtC,IAAI,CAAC,gBAAgB,EAAEe,SAAS,CAAC;cAAC;cAAA,6BAEjC,IAAI,CAACwB,YAAY,qBAAjB,4BAAI,CAAiB;YAAA;cAEvBnC,eAAe,GAAY,KAAK;cAChCE,MAAM,GAAe,EAAE;cAAA;cAAA;cAAA,OAGV,IAAI,CAACkC,SAAS,CAAChB,WAAW,CAAC;YAAA;cAA1ClB,MAAM;cACNF,eAAe,GAAG,IAAI;cAEtB,IAAI,CAACJ,IAAI,CAAC,gBAAgB,EAAEe,SAAS,CAAC;cAAC;cAAA;YAAA;cAAA;cAAA;cAEvCX,eAAe,GAAG,KAAK;cAEvB,IAAI,CAACJ,IAAI,CAAC,eAAe,eAAW;YAAC;cAGvC,IAAI,CAACc,QAAQ,CAAC;gBACZV,eAAe,EAAfA,eAAe;gBACfE,MAAM,EAANA;eACD,CAAC;cAAC;cAAA,8BAEG,IAAI,CAACmC,aAAa,qBAAlB,6BAAI,EAAiBrC,eAAe,CAAC;YAAA;cAE3C,KAASsC,CAAC,GAAG,IAAI,CAACN,QAAQ,CAACO,GAAG,EAAE,EAAED,CAAC,IAAI,IAAI,EAAEA,CAAC,GAAG,IAAI,CAACN,QAAQ,CAACO,GAAG,EAAE,EAAE;gBACpED,CAAC,CAACtD,OAAO,CAACgB,eAAe,CAAC;;YAC3B;YAAA;cAAA;;;;KACF;IAAA;MAAA;;IAAA;;EAAA,OAEOJ,IAAI,GAAJ,cACN+B,SAAY,EACZa,KAA0B;IAE1B,IAAI,CAACX,YAAY,CAACjC,IAAI,CAAC+B,SAAS,EAAEa,KAAK,CAAC;GACzC;EAAA,OAEOT,iBAAiB,GAAjB;IACN,IAAI,CAAC1B,WAAW,CAACP,OAAO,CAAC,UAAA2C,CAAC;MACxB,IAAI;QACFA,CAAC,EAAE;OACJ,CAAC,gBAAM;KACT,CAAC;GACH;EAAA;IAAA;IAAA,KA7MD;MACE,OAAO,IAAI,CAAClC,MAAM,CAACN,aAAa;;;IACjC;IAAA,KAED;MACE,OAAO,IAAI,CAACM,MAAM,CAACP,eAAe;;;IACnC;IAAA,KAED;MACE,OAAO,IAAI,CAACO,MAAM,CAACL,MAAM;;;EAC1B;AAAA;;SC3CawC,UAAU,CAA2BC,UAAa;;EAEhE,IAAMC,WAAW,GAAGC,aAAa,CAAwB,IAAI,CAAC;;EAG9D,IAAMC,YAAY,GAAgC,SAA5CA,YAAY;QAChBC,QAAQ,QAARA,QAAQ;MACRC,cAAc,QAAdA,cAAc;MACdC,gBAAgB,QAAhBA,gBAAgB;IAEhB,gBAAsCC,QAAQ,CAAC,KAAK,CAAC;MAA9CC,YAAY;MAAEC,aAAa;IAClC,4BAA2CC,oBAAoB,CAC7DV,UAAU,CAACW,SAAS,EACpBX,UAAU,CAACY,WAAW,CACvB;MAHOvD,eAAe,yBAAfA,eAAe;MAAEC,aAAa,yBAAbA,aAAa;IAKtCuD,SAAS,CAAC;eACOC,cAAc;QAAA;;MAM7B;QAAA,6EANA;UAAA;UAAA;YAAA;cAAA;gBAAA;kBAAA;kBAAA,OAE4Bd,UAAU,CAACnC,IAAI,EAAE;gBAAA;kBAArCkD,WAAW;kBACjBN,aAAa,CAAC,CAACM,WAAW,CAAC;gBAAC;gBAAA;kBAAA;;;;SAC7B;QAAA;;MAGDD,cAAc,EAAE;KACjB,EAAE,EAAE,CAAC;IAEN,IAAI,CAAC,CAACT,cAAc,IAAIG,YAAY,EAAE;MACpC,OAAOH,cAAc;;IAGvB,IAAI,CAAC,CAACC,gBAAgB,IAAI,CAAChD,aAAa,EAAE;MACxC,OAAOgD,gBAAgB;;IAGzB,OACEU,oBAACf,WAAW,CAACgB,QAAQ;MACnBC,KAAK,EAAE;QACLlB,UAAU,EAAVA,UAAU;QACV3C,eAAe,EAAfA,eAAe;QACfC,aAAa,EAAbA;;OAGD8C,QAAQ,CACY;GAE1B;;EAGD,IAAMe,aAAa,GAAG,SAAhBA,aAAa;IACjB,IAAMC,GAAG,GAAGC,UAAU,CAACpB,WAAW,CAAC;IAEnC,IAAI,CAACmB,GAAG,EAAE;MACR,MAAM,IAAIE,KAAK,CAAC,uDAAuD,CAAC;;IAG1E,OAAOF,GAAG,CAACpB,UAAU;GACtB;EAED,OAAO;IACLG,YAAY,EAAZA,YAAY;IACZgB,aAAa,EAAbA;GACD;AACH;;;;"}

package/dist/types/deferred.d.ts

@@ -1,7 +0,0 @@
-export declare class Deferred<T> {
-    private promise;
-    resolve: (value: T | PromiseLike<T>) => void;
-    reject: (reason?: any) => void;
-    constructor();
-    getPromise(): Promise<T>;
-}

package/dist/types/index.d.ts

@@ -1,56 +0,0 @@
-import { EventKey, EventReceiver } from './eventEmitter';
-declare type AuthTokens = {};
-declare type AuthCredentials = {};
-declare type AuthEventsMap<E extends Error> = {
-    initSuccess: undefined;
-    initFailed: E;
-    loginStarted: undefined;
-    loginSuccess: undefined;
-    loginFailed: E;
-    refreshStarted: undefined;
-    refreshSuccess: undefined;
-    refreshFailed: E;
-    logoutStarted: undefined;
-    logoutSuccess: undefined;
-    logoutFailed: E;
-};
-declare type SubscribeFn = () => void;
-declare type UnsubscribeFn = () => boolean;
-declare type AuthClientState<T> = {
-    isAuthenticated: boolean;
-    isInitialized: boolean;
-    tokens: Partial<T>;
-};
-export declare abstract class BaseAuthClient<T = AuthTokens, C = AuthCredentials, E extends Error = Error> {
-    private _state;
-    private refreshQ;
-    private eventEmitter;
-    private subscribers;
-    get isInitialized(): boolean;
-    get isAuthenticated(): boolean;
-    get tokens(): Partial<T>;
-    init(): Promise<boolean>;
-    login(credentials?: C): Promise<boolean>;
-    refresh(minValidity?: number): Promise<boolean>;
-    logout(): Promise<void>;
-    on<K extends EventKey<AuthEventsMap<E>>>(eventName: K, listener: EventReceiver<AuthEventsMap<E>[K]>): void;
-    off<K extends EventKey<AuthEventsMap<E>>>(eventName: K, listener: EventReceiver<AuthEventsMap<E>[K]>): void;
-    subscribe: (subscription: SubscribeFn) => UnsubscribeFn;
-    getSnapshot: () => AuthClientState<T>;
-    protected setState(stateUpdate: Partial<AuthClientState<T>>): void;
-    private runRefresh;
-    private emit;
-    private notifySubscribers;
-    protected abstract onInit(): Promise<void>;
-    protected onPostInit?(): Promise<void>;
-    protected onPreLogin?(): Promise<void>;
-    protected abstract onLogin(credentials?: C): Promise<T>;
-    protected onPostLogin?(isSuccess: boolean): Promise<void>;
-    protected onPreRefresh?(): Promise<void>;
-    protected abstract onRefresh(minValidity?: number): Promise<T>;
-    protected onPostRefresh?(isSuccess: boolean): Promise<void>;
-    protected onPreLogout?(): Promise<void>;
-    protected abstract onLogout(): Promise<void>;
-    protected onPostLogout?(isSuccess: boolean): Promise<void>;
-}
-export {};

package/src/index.tsx

@@ -1,98 +0,0 @@
-import React, { createContext, useContext, useEffect, useState } from 'react';
-import { useSyncExternalStore } from 'use-sync-external-store/shim';
-
-import { BaseAuthClient } from './types';
-
-/**
- * Props that can be passed to AuthProvider
- */
-export type AuthProviderProps = {
-  children?: React.ReactNode;
-
-  /**
-   * An optional component to display if AuthClient initialization failed.
-   */
-  ErrorComponent?: JSX.Element;
-
-  /**
-   * An optional component to display while AuthClient instance is being initialized.
-   */
-  LoadingComponent?: JSX.Element;
-};
-
-type AuthProviderState = {
-  isAuthenticated: boolean;
-
-  isInitialized: boolean;
-};
-
-type AuthContext<C extends BaseAuthClient> = AuthProviderState & {
-  authClient: C;
-};
-
-export function createAuth<C extends BaseAuthClient>(authClient: C) {
-  // Create a React context containing a BaseAuthClient instance.
-  const authContext = createContext<AuthContext<C> | null>(null);
-
-  // Create the React Context Provider for the BaseAuthClient instance.
-  const AuthProvider: React.FC<AuthProviderProps> = ({
-    children,
-    ErrorComponent,
-    LoadingComponent,
-  }) => {
-    const [isInitFailed, setInitFailed] = useState(false);
-    const { isAuthenticated, isInitialized } = useSyncExternalStore(
-      authClient.subscribe,
-      authClient.getSnapshot
-    );
-
-    useEffect(() => {
-      async function initAuthClient() {
-        // Call init function
-        const initSuccess = await authClient.init();
-        setInitFailed(!initSuccess);
-      }
-
-      // Init AuthClient
-      initAuthClient();
-    }, []);
-
-    if (!!ErrorComponent && isInitFailed) {
-      return ErrorComponent;
-    }
-
-    if (!!LoadingComponent && !isInitialized) {
-      return LoadingComponent;
-    }
-
-    return (
-      <authContext.Provider
-        value={{
-          authClient,
-          isAuthenticated,
-          isInitialized,
-        }}
-      >
-        {children}
-      </authContext.Provider>
-    );
-  };
-
-  // Retrieve the AuthClient from the current context
-  const useAuthClient = function(): C {
-    const ctx = useContext(authContext);
-
-    if (!ctx) {
-      throw new Error('useAuthClient hook should be used inside AuthProvider');
-    }
-
-    return ctx.authClient;
-  };
-
-  return {
-    AuthProvider,
-    useAuthClient,
-  };
-}
-
-export { BaseAuthClient };

package/src/types/deferred.ts

@@ -1,18 +0,0 @@
-export class Deferred<T> {
-  private promise: Promise<T>;
-
-  public resolve!: (value: T | PromiseLike<T>) => void;
-
-  public reject!: (reason?: any) => void;
-
-  constructor() {
-    this.promise = new Promise<T>((resolve, reject) => {
-      this.reject = reject;
-      this.resolve = resolve;
-    });
-  }
-
-  public getPromise(): Promise<T> {
-    return this.promise;
-  }
-}

package/src/types/index.ts

@@ -1,298 +0,0 @@
-import { Deferred } from './deferred';
-import { createEventEmitter, EventKey, EventReceiver } from './eventEmitter';
-
-type AuthTokens = {};
-
-type AuthCredentials = {};
-
-type AuthEventsMap<E extends Error> = {
-  initSuccess: undefined;
-
-  initFailed: E;
-
-  loginStarted: undefined;
-
-  loginSuccess: undefined;
-
-  loginFailed: E;
-
-  refreshStarted: undefined;
-
-  refreshSuccess: undefined;
-
-  refreshFailed: E;
-
-  logoutStarted: undefined;
-
-  logoutSuccess: undefined;
-
-  logoutFailed: E;
-};
-
-type SubscribeFn = () => void;
-
-type UnsubscribeFn = () => boolean;
-
-type AuthClientState<T> = {
-  isAuthenticated: boolean;
-
-  isInitialized: boolean;
-
-  tokens: Partial<T>;
-};
-
-export abstract class BaseAuthClient<
-  T = AuthTokens,
-  C = AuthCredentials,
-  E extends Error = Error
-> {
-  private _state: Readonly<AuthClientState<T>> = {
-    isAuthenticated: false,
-    isInitialized: false,
-    tokens: {},
-  };
-
-  // refresh queue - used to avoid concurrency issue during Token refresh
-  private refreshQ: Array<Deferred<boolean>> = [];
-
-  private eventEmitter = createEventEmitter<AuthEventsMap<E>>();
-
-  private subscribers: Set<SubscribeFn> = new Set();
-
-  //
-  // Getters
-  //
-
-  public get isInitialized() {
-    return this._state.isInitialized;
-  }
-
-  public get isAuthenticated() {
-    return this._state.isAuthenticated;
-  }
-
-  public get tokens() {
-    return this._state.tokens;
-  }
-
-  //
-  // Public methods
-  //
-
-  public async init(): Promise<boolean> {
-    try {
-      await this.onInit();
-
-      this.setState({
-        isInitialized: true,
-      });
-
-      this.emit('initSuccess', undefined);
-    } catch (error) {
-      this.setState({
-        isInitialized: false,
-      });
-
-      this.emit('initFailed', error as E);
-    }
-
-    await this.onPostInit?.();
-
-    return this.isInitialized;
-  }
-
-  public async login(credentials?: C): Promise<boolean> {
-    this.emit('loginStarted', undefined);
-
-    await this.onPreLogin?.();
-
-    let isSuccess: boolean = false;
-
-    try {
-      const tokens = await this.onLogin(credentials);
-
-      this.setState({
-        isAuthenticated: true,
-        tokens,
-      });
-
-      this.emit('loginSuccess', undefined);
-
-      isSuccess = true;
-    } catch (err) {
-      this.setState({
-        isAuthenticated: false,
-        tokens: {},
-      });
-
-      this.emit('loginFailed', err as E);
-
-      isSuccess = false;
-    }
-
-    await this.onPostLogin?.(isSuccess);
-
-    return this.isAuthenticated;
-  }
-
-  public async refresh(minValidity?: number): Promise<boolean> {
-    const deferred = new Deferred<boolean>();
-
-    this.runRefresh(deferred, minValidity);
-
-    return deferred.getPromise();
-  }
-
-  public async logout(): Promise<void> {
-    this.emit('logoutStarted', undefined);
-
-    await this.onPreLogout?.();
-
-    let isSuccess: boolean = false;
-
-    try {
-      await this.onLogout();
-
-      this.setState({
-        isAuthenticated: false,
-        tokens: {},
-      });
-
-      this.emit('logoutSuccess', undefined);
-
-      isSuccess = true;
-    } catch (err) {
-      this.emit('logoutFailed', err as E);
-
-      isSuccess = false;
-    }
-
-    await this.onPostLogout?.(isSuccess);
-  }
-
-  public on<K extends EventKey<AuthEventsMap<E>>>(
-    eventName: K,
-    listener: EventReceiver<AuthEventsMap<E>[K]>
-  ): void {
-    this.eventEmitter.on(eventName, listener);
-  }
-
-  public off<K extends EventKey<AuthEventsMap<E>>>(
-    eventName: K,
-    listener: EventReceiver<AuthEventsMap<E>[K]>
-  ): void {
-    this.eventEmitter.off(eventName, listener);
-  }
-
-  // Should be declared like this to avoid binding issues when used by useSyncExternalStore
-  public subscribe = (subscription: SubscribeFn): UnsubscribeFn => {
-    this.subscribers.add(subscription);
-
-    return () => this.subscribers.delete(subscription);
-  };
-
-  // Should be declared like this to avoid binding issues when used by useSyncExternalStore
-  public getSnapshot = (): AuthClientState<T> => {
-    return this._state;
-  };
-
-  //
-  // Protected methods
-  //
-
-  protected setState(stateUpdate: Partial<AuthClientState<T>>): void {
-    this._state = {
-      ...this._state,
-      ...stateUpdate,
-    };
-
-    this.notifySubscribers();
-  }
-
-  //
-  // Private methods
-  //
-
-  private async runRefresh(
-    deferred: Deferred<boolean>,
-    minValidity?: number
-  ): Promise<void> {
-    // Add deferred Promise to refresh queue
-    this.refreshQ.push(deferred);
-
-    // If refresh queue already has promises enqueued do not attempt a new refresh - one is already in progress
-    if (this.refreshQ.length !== 1) {
-      return;
-    }
-
-    this.emit('refreshStarted', undefined);
-
-    await this.onPreRefresh?.();
-
-    let isAuthenticated: boolean = false;
-    let tokens: Partial<T> = {};
-
-    try {
-      tokens = await this.onRefresh(minValidity);
-      isAuthenticated = true;
-
-      this.emit('refreshSuccess', undefined);
-    } catch (err) {
-      isAuthenticated = false;
-
-      this.emit('refreshFailed', err as E);
-    }
-
-    this.setState({
-      isAuthenticated,
-      tokens,
-    });
-
-    await this.onPostRefresh?.(isAuthenticated);
-
-    for (let p = this.refreshQ.pop(); p != null; p = this.refreshQ.pop()) {
-      p.resolve(isAuthenticated);
-    }
-  }
-
-  private emit<K extends EventKey<AuthEventsMap<E>>>(
-    eventName: K,
-    error: AuthEventsMap<E>[K]
-  ): void {
-    this.eventEmitter.emit(eventName, error);
-  }
-
-  private notifySubscribers() {
-    this.subscribers.forEach(s => {
-      try {
-        s();
-      } catch {}
-    });
-  }
-
-  //
-  // Abstract methods
-  //
-
-  protected abstract onInit(): Promise<void>;
-
-  protected onPostInit?(): Promise<void>;
-
-  protected onPreLogin?(): Promise<void>;
-
-  protected abstract onLogin(credentials?: C): Promise<T>;
-
-  protected onPostLogin?(isSuccess: boolean): Promise<void>;
-
-  protected onPreRefresh?(): Promise<void>;
-
-  protected abstract onRefresh(minValidity?: number): Promise<T>;
-
-  protected onPostRefresh?(isSuccess: boolean): Promise<void>;
-
-  protected onPreLogout?(): Promise<void>;
-
-  protected abstract onLogout(): Promise<void>;
-
-  protected onPostLogout?(isSuccess: boolean): Promise<void>;
-}