@internetarchive/promised-singleton NPM

PromisedSingleton

A generic Typescript class for lazy-loading singletons.

PromisedSingleton is a generic wrapper for an asynchronously generated object that you only want one instance of (a singleton).

Background

We often want to generate a single instance of an object, but when that instance is asynchronously generated, you may have many consumers requesting that instance at the same time. The Promises don't automatically chain so you have to do some gatekeeping to make sure only one instance gets created.

PromisedSingleton ensures that no matter how many callers request the object, only one instance gets created.

It gets initialized with a generator Promise that generates the singleton. When get() is first called, it executes the Promise, caches its results and returns it to the caller.

If more callers call it in the interim, it chains the promises and when the singleton is created, it resolves them all.

Installation

npm i @internetarchive/promised-singleton

Usage

// foo-service-provider.ts
import { PromisedSingleton } from '@internetarchive/promised-singleton';

export class FooServiceProvider {

  // Using a Promise
  fooService = new PromisedSingleton<FooService>({
    generator: (): Promise<FooService> => new Promise(resolve => {
      const service = new FooService();
      service.setup().then(service => resolve(service))
    })
  });

  // Using an async function
  barService = new PromisedSingleton<BarService>({
    generator: async (): Promise<BarService> => {
      const service = new BarService();
      await service.setup();
      return service;
    })
  });
}

// consumer.ts
import { FooServiceProvider } from './foo-service-provider';

export class Consumer1 {
  // Passing the same FooServiceProvider into the consumers
  constructor(serviceProvider: FooServiceProvider) {
    this.serviceProvider = serviceProvider
  }

  async setup() {
    // Call `.get()` on the property to fetch an instance of `FooService`
    // Many consumers can call `get()` and they will all receive the same instance
    try {
      const service = await this.serviceProvider.fooService.get();
    } catch (error) {
      console.error('error fetching service singleton', error);
    }
    const result = await service.fetchFoos();
  }
}