@jupyterlite/settings 0.1.0-beta.2 → 0.1.0-beta.3

package/lib/settings.d.ts

@@ -1,9 +1,30 @@
-import { IPlugin } from './tokens';
+import type localforage from 'localforage';
+import { IPlugin, ISettings } from './tokens';
 /**
  * A class to handle requests to /api/settings
  */
-export declare class Settings {
-    constructor(options?: Settings.IOptions);
+export declare class Settings implements ISettings {
+    constructor(options: Settings.IOptions);
+    /**
+     * A promise that resolves when the settings storage is fully initialized
+     */
+    get ready(): Promise<void>;
+    /**
+     * A lazy reference to initialized storage
+     */
+    protected get storage(): Promise<LocalForage>;
+    /**
+     * Finish any initialization after server has started and all extensions are applied.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Prepare the storage
+     */
+    protected initStorage(): Promise<void>;
+    /**
+     * Get default options for localForage instances
+     */
+    protected get defaultStorageOptions(): LocalForageOptions;
     /**
      * Create a settings store.
      */
@@ -35,8 +56,11 @@ export declare class Settings {
      * @param pluginId The id of a plugin
      */
     private _getFederated;
-    private _settingsStorageName;
+    private _storageName;
+    private _storageDrivers;
     private _storage;
+    private _localforage;
+    private _ready;
 }
 /**
  * A namespaces for settings metadata.
@@ -46,7 +70,9 @@ declare namespace Settings {
      * Initialization options for settings.
      */
     interface IOptions {
-        settingsStorageName?: string | null;
+        localforage: typeof localforage;
+        storageName?: string | null;
+        storageDrivers?: string[] | null;
     }
 }
 export {};

package/lib/settings.js

@@ -1,6 +1,6 @@
 import { PageConfig, URLExt } from '@jupyterlab/coreutils';
 import * as json5 from 'json5';
-import localforage from 'localforage';
+import { PromiseDelegate } from '@lumino/coreutils';
 /**
  * The name of the local storage.
  */
@@ -10,20 +10,58 @@ const DEFAULT_STORAGE_NAME = 'JupyterLite Storage';
  */
 export class Settings {
     constructor(options) {
-        this._settingsStorageName = DEFAULT_STORAGE_NAME;
-        this._settingsStorageName =
-            (options || {}).settingsStorageName || DEFAULT_STORAGE_NAME;
+        this._storageName = DEFAULT_STORAGE_NAME;
+        this._storageDrivers = null;
+        this._localforage = options.localforage;
+        this._storageName = options.storageName || DEFAULT_STORAGE_NAME;
+        this._storageDrivers = options.storageDrivers || null;
+        this._ready = new PromiseDelegate();
+    }
+    /**
+     * A promise that resolves when the settings storage is fully initialized
+     */
+    get ready() {
+        return this._ready.promise;
+    }
+    /**
+     * A lazy reference to initialized storage
+     */
+    get storage() {
+        return this.ready.then(() => this._storage);
+    }
+    /**
+     * Finish any initialization after server has started and all extensions are applied.
+     */
+    async initialize() {
+        await this.initStorage();
+        this._ready.resolve(void 0);
+    }
+    /**
+     * Prepare the storage
+     */
+    async initStorage() {
         this._storage = this.defaultSettingsStorage();
     }
+    /**
+     * Get default options for localForage instances
+     */
+    get defaultStorageOptions() {
+        var _a;
+        const driver = ((_a = this._storageDrivers) === null || _a === void 0 ? void 0 : _a.length) ? this._storageDrivers : null;
+        return {
+            version: 1,
+            name: this._storageName,
+            ...(driver ? { driver } : {}),
+        };
+    }
     /**
      * Create a settings store.
      */
     defaultSettingsStorage() {
-        return localforage.createInstance({
-            name: this._settingsStorageName,
+        return this._localforage.createInstance({
             description: 'Offline Storage for Settings',
             storeName: 'settings',
-            version: 1,
+            ...this.defaultStorageOptions,
         });
     }
     /**
@@ -49,11 +87,12 @@ export class Settings {
     async getAll() {
         var _a;
         const settingsUrl = (_a = PageConfig.getOption('settingsUrl')) !== null && _a !== void 0 ? _a : '/';
+        const storage = await this.storage;
         const all = (await (await fetch(URLExt.join(settingsUrl, 'all.json'))).json());
         const settings = await Promise.all(all.map(async (plugin) => {
             var _a;
             const { id } = plugin;
-            const raw = (_a = (await this._storage.getItem(id))) !== null && _a !== void 0 ? _a : plugin.raw;
+            const raw = (_a = (await storage.getItem(id))) !== null && _a !== void 0 ? _a : plugin.raw;
             return {
                 ...Private.override(plugin),
                 raw,
@@ -70,7 +109,7 @@ export class Settings {
      *
      */
     async save(pluginId, raw) {
-        await this._storage.setItem(pluginId, raw);
+        await (await this.storage).setItem(pluginId, raw);
     }
     /**
      * Get the settings for a federated extension
@@ -88,7 +127,7 @@ export class Settings {
         const packageUrl = URLExt.join(labExtensionsUrl, packageName, 'package.json');
         const schema = await (await fetch(schemaUrl)).json();
         const packageJson = await (await fetch(packageUrl)).json();
-        const raw = (_a = (await this._storage.getItem(pluginId))) !== null && _a !== void 0 ? _a : '{}';
+        const raw = (_a = (await (await this.storage).getItem(pluginId))) !== null && _a !== void 0 ? _a : '{}';
         const settings = json5.parse(raw) || {};
         return Private.override({
             id: pluginId,

package/lib/tokens.d.ts

@@ -33,6 +33,10 @@ export interface IPlugin extends PartialJSONObject {
  * The interface for the Settings service.
  */
 export interface ISettings {
+    /**
+     * A promise that resolves after the settings have been full initialized
+     */
+    ready: Promise<void>;
     /**
      * Get settings by plugin id
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jupyterlite/settings",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.3",
   "description": "JupyterLite - Settings",
   "homepage": "https://github.com/jupyterlite/jupyterlite",
   "bugs": {
@@ -42,8 +42,9 @@
     "watch": "tsc -b --watch"
   },
   "dependencies": {
-    "@jupyterlab/coreutils": "~5.3.0",
-    "@jupyterlab/settingregistry": "~3.3.0",
+    "@jupyterlab/coreutils": "~5.3.2",
+    "@jupyterlab/settingregistry": "~3.3.2",
+    "@jupyterlite/localforage": "^0.1.0-beta.3",
     "@lumino/coreutils": "^1.12.0",
     "json5": "^2.2.0",
     "localforage": "^1.9.0"
@@ -51,7 +52,7 @@
   "devDependencies": {
     "@babel/core": "^7.11.6",
     "@babel/preset-env": "^7.12.1",
-    "@jupyterlab/testutils": "~3.3.0",
+    "@jupyterlab/testutils": "~3.3.2",
     "@types/jest": "^26.0.10",
     "jest": "^26.4.2",
     "rimraf": "~3.0.0",