⚠ This may only be useful when connecting to users' remote-storage instances through a non-null remoteStorage constructor parameter.

List of lucchetto providing servers for production: these are shown as options in the RS widget dropdown, when the Lucchetto class is constructed with !isTest:

• @rs.overhide.io

⚠ This may only be useful when connecting to users' remote-storage instances through a non-null remoteStorage constructor parameter.

List of lucchetto providing servers for testnets: these are shown as options in the RS widget dropdown, when the Lucchetto class is constructed with isTest:

• @test.rs.overhide.io
• @localhost:8000

This class provides utility functions to fetch in-app purchase data from the app-developer's RS (+Lucchetto) connection. The in-app purchase data must first be onboarded onto a Lucchetto extended RS server.

A typical usage of this class with pay2my.app widgets might look like:

  var lucchetto = new Lucchetto({
      overhideIsTest: true, 
      pay2myAppHub: document.getElementById('hub-id-in-dom'),
      overhideApiKey: '0x42..cb'});
  ...
  window.addEventListener('pay2myapp-appsell-sku-clicked', async (e) => { 
    ...
    const result = await lucchetto.getSku(`https://test.rs.overhide.io`, e.detail);
    console.log(`got SKU results`, { sku: e.detail.sku , result });
    ...
 }, false);

• Above, we're passing in the overhideApiKey for our use — get an API key for the right network, either testnet or mainnet. This is not a secret.

⚠ In the context of being connected to your users' remote-storage instances through a non-null remoteStorage constructor (first) parameter:

Reacts to remotestorage.js onConnected events to parse metadata out of newly available RS tokens.

If the connected RS server is Lucchetto extended, the token will provide metadata useful to pay2my.app in-app purchase widgets — making for a nicer end-user experience.

This class enriches the dropdown of the RS widget, if any, embedded in the DOM. The enrichment provides server hints as per LUCCHETTO_PROVIDERS and LUCCHETTO_PROVIDERS_4_TEST.

A typical usage of this class along with remotestorage.js and pay2my.app widgets might look like:

  var rsClient = new RemoteStorage();
  var lucchetto = new Lucchetto({
      remoteStorage: rsClient,
      overhideIsTest: true, 
      pay2myAppHub: document.getElementById('hub-id-in-dom'),
      overhideApiKey: '0x42..cb'});
  ...
  window.addEventListener('pay2myapp-appsell-sku-clicked', async (e) => { 
    ...
    const result = await lucchetto.getSku(`https://test.rs.overhide.io`, e.detail);
    console.log(`got SKU results`, { sku: e.detail.sku , result });
    ...
 }, false);

• Above, we're also passing in the overhideApiKey for our use — get an API key for the right network, either testnet or mainnet. The overhideApiKey is optional since we'll usually leverage an overhide token from remoteStorage. But if the remoteStorage connected to our application is not to a Lucchetto extended RS server, it won't have the overhide token, and we need to fail back to this default key. This is not a secret.