@fireproof/core 0.3.22 → 0.4.1

package/dist/src/{index.mjs → fireproof.mjs}

@@ -37225,7 +37225,10 @@ class TransactionBlockstore {
   inflightTransactions = new Set()
 
   constructor (name, encryptionKey) {
-    this.valet = new Valet(name, encryptionKey);
+    if (name) {
+      this.valet = new Valet(name, encryptionKey);
+    }
+    this.remoteBlockFunction = null;
   }
 
   /**
@@ -37258,6 +37261,7 @@ class TransactionBlockstore {
   async committedGet (key) {
     const old = this.committedBlocks.get(key);
     if (old) return old
+    if (!this.valet) throw new Error('Missing block: ' + key)
     const got = await this.valet.getBlock(key);
     // console.log('committedGet: ' + key)
     this.committedBlocks.set(key, got);
@@ -37269,9 +37273,9 @@ class TransactionBlockstore {
   }
 
   async networkGet (key) {
-    if (this.valet.remoteBlockFunction) {
+    if (this.remoteBlockFunction) {
       // todo why is this on valet?
-      const value = await husher(key, async () => await this.valet.remoteBlockFunction(key));
+      const value = await husher(key, async () => await this.remoteBlockFunction(key));
       if (value) {
         // console.log('networkGot: ' + key, value.length)
         doTransaction('networkGot: ' + key, this, async innerBlockstore => {
@@ -37349,7 +37353,7 @@ class TransactionBlockstore {
         cids.add(stringCid);
       }
     }
-    if (cids.size > 0) {
+    if (cids.size > 0 && this.valet) {
       // console.log(innerBlockstore.label, 'committing', cids.size, 'blocks')
       await this.valet.writeTransaction(innerBlockstore, cids);
     }
@@ -37440,6 +37444,10 @@ class InnerBlockstore {
 
 const blockOpts = { cache: nocache, chunker: bf(3), codec: codec$1, hasher: sha256$2, compare: simpleCompare };
 
+/**
+ * @typedef {import('./blockstore.js').TransactionBlockstore} TransactionBlockstore
+ */
+
 const withLog = async (label, fn) => {
   const resp = await fn();
   // console.log('withLog', label, !!resp)
@@ -37660,7 +37668,7 @@ async function put (inBlocks, head, event, options) {
 /**
  * Determine the effective prolly root given the current merkle clock head.
  *
- * @param {import('./blockstore.js').TransactionBlockstore} inBlocks Bucket block storage.
+ * @param {TransactionBlockstore} inBlocks Bucket block storage.
  * @param {import('./clock').EventLink<import('./clock').EventData>[]} head Merkle clock head.
  */
 async function root (inBlocks, head) {
@@ -37669,8 +37677,8 @@ async function root (inBlocks, head) {
   }
   const { root: newProllyRootNode, blocks: newBlocks, cids } = await doProllyBulk(inBlocks, head);
   // todo maybe these should go to a temp blockstore?
-  await doTransaction('root', inBlocks, async (transactionBlockstore) => {
-    const { bigPut } = makeGetAndPutBlock(transactionBlockstore);
+  await doTransaction('root', inBlocks, async (transactionBlocks) => {
+    const { bigPut } = makeGetAndPutBlock(transactionBlocks);
     for (const nb of newBlocks) {
       bigPut(nb);
     }
@@ -37680,7 +37688,7 @@ async function root (inBlocks, head) {
 
 /**
  * Get the list of events not known by the `since` event
- * @param {import('./blockstore.js').TransactionBlockstore} blocks Bucket block storage.
+ * @param {TransactionBlockstore} blocks Bucket block storage.
  * @param {import('./clock').EventLink<import('./clock').EventData>[]} head Merkle clock head.
  * @param {import('./clock').EventLink<import('./clock').EventData>} since Event to compare against.
  * @returns {Promise<{clockCIDs: CIDCounter, result: import('./clock').EventData[]}>}
@@ -37697,7 +37705,7 @@ async function eventsSince (blocks, head, since) {
 
 /**
  *
- * @param {import('./blockstore.js').TransactionBlockstore} blocks Bucket block storage.
+ * @param {TransactionBlockstore} blocks Bucket block storage.
  * @param {import('./clock').EventLink<import('./clock').EventData>[]} head Merkle clock head.
  *
  * @returns {Promise<{cids: CIDCounter, clockCIDs: CIDCounter, result: import('./clock').EventData[]}>}
@@ -37718,7 +37726,7 @@ async function getAll (blocks, head) {
 }
 
 /**
- * @param {import('./blockstore.js').TransactionBlockstore} blocks Bucket block storage.
+ * @param {TransactionBlockstore} blocks Bucket block storage.
  * @param {import('./clock').EventLink<import('./clock').EventData>[]} head Merkle clock head.
  * @param {string} key The key of the value to retrieve.
  */
@@ -38000,6 +38008,22 @@ object.factory = function (codec) {
 	exports.type = 'charwise';
 } (charwise));
 
+/* global localStorage */
+let storageSupported = false;
+try {
+  storageSupported = window.localStorage && true;
+} catch (e) {}
+function localGet (key) {
+  if (storageSupported) {
+    return localStorage && localStorage.getItem(key)
+  }
+}
+function localSet (key, value) {
+  if (storageSupported) {
+    return localStorage && localStorage.setItem(key, value)
+  }
+}
+
 // @ts-nocheck
 
 /**
@@ -38014,31 +38038,16 @@ object.factory = function (codec) {
  * @param {object} [authCtx] - Optional authorization context object to use for any authentication checks.
  *
  */
-class Fireproof {
+class Database {
   listeners = new Set()
 
-  /**
-   * @function storage
-   * @memberof Fireproof
-   * Creates a new Fireproof instance with default storage settings
-   * Most apps should use this and not worry about the details.
-   * @static
-   * @returns {Fireproof} - a new Fireproof instance
-   */
-  static storage = (name = 'global') => {
-    const instanceKey = browserExports(32).toString('hex'); // pass null to disable encryption
-    // pick a random key from const validatedKeys
-    // const instanceKey = validatedKeys[Math.floor(Math.random() * validatedKeys.length)]
-    return new Fireproof(new TransactionBlockstore(name, instanceKey), [], { name })
-  }
-
-  constructor (blocks, clock, config, authCtx = {}) {
-    this.name = config?.name || 'global';
+  // todo refactor this for the next version
+  constructor (blocks, clock, config = {}) {
+    this.name = config.name;
     this.instanceId = `fp.${this.name}.${Math.random().toString(36).substring(2, 7)}`;
     this.blocks = blocks;
     this.clock = clock;
     this.config = config;
-    this.authCtx = authCtx;
     this.indexes = new Map();
   }
 
@@ -38053,7 +38062,7 @@ class Fireproof {
     return {
       clock: this.clockToJSON(),
       name: this.name,
-      key: this.blocks.valet.getKeyMaterial(),
+      key: this.blocks.valet?.getKeyMaterial(),
       indexes: [...this.indexes.values()].map(index => index.toJSON())
     }
   }
@@ -38071,10 +38080,16 @@ class Fireproof {
   hydrate ({ clock, name, key }) {
     this.name = name;
     this.clock = clock;
-    this.blocks.valet.setKeyMaterial(key);
+    this.blocks.valet?.setKeyMaterial(key);
     this.indexBlocks = null;
   }
 
+  maybeSaveClock () {
+    if (this.name && this.blocks.valet) {
+      localSet('fp.' + this.name, JSON.stringify(this));
+    }
+  }
+
   /**
    * Triggers a notification to all listeners
    * of the Fireproof instance so they can repaint UI, etc.
@@ -38185,14 +38200,19 @@ class Fireproof {
     doc._id = key;
     return doc
   }
+  /**
+ * @typedef {Object} Document
+ * @property {string} _id - The ID of the document (required)
+ * @property {string} [_proof] - The proof of the document (optional)
+ * @property {string} [_clock] - The clock of the document (optional)
+ * @property {any} [key: string] - Index signature notation to allow any other unknown fields
+ *  * @property {Object.<string, any>} [otherProperties] - Any other unknown properties (optional)
+ */
 
   /**
    * Adds a new document to the database, or updates an existing document. Returns the ID of the document and the new clock head.
    *
-   * @param {Object} doc - the document to be added
-   * @param {string} doc._id - the document ID. If not provided, a random ID will be generated.
-   * @param {CID[]} doc._clock - the document ID. If not provided, a random ID will be generated.
-   * @param {Proof} doc._proof - CIDs referenced by the update
+   * @param {Document} doc - the document to be added
    * @returns {Promise<{ id: string, clock: CID[]  }>} - The result of adding the document to the database
    * @memberof Fireproof
    * @instance
@@ -38300,6 +38320,7 @@ class Fireproof {
 
   async notifyListeners (changes) {
     // await sleep(10)
+    await this.maybeSaveClock();
     for (const listener of this.listeners) {
       await listener(changes);
     }
@@ -38312,8 +38333,7 @@ class Fireproof {
   }
 
   setRemoteBlockReader (remoteBlockReaderFn) {
-    // console.log('registering remote block reader')
-    this.blocks.valet.remoteBlockFunction = remoteBlockReaderFn;
+    this.blocks.remoteBlockFunction = remoteBlockReaderFn;
   }
 }
 
@@ -38334,6 +38354,124 @@ function encodeEvent (event) {
   return { ...event, key: encodedKey }
 }
 
+/**
+ * A Fireproof database Listener allows you to react to events in the database.
+ *
+ * @class Listener
+ * @classdesc An listener attaches to a Fireproof database and runs a routing function on each change, sending the results to subscribers.
+ *
+ * @param {import('./database.js').Database} database - The Database database instance to index.
+ * @param {Function} routingFn - The routing function to apply to each entry in the database.
+ */
+// import { ChangeEvent } from './db-index'
+
+class Listener {
+  subcribers = new Map()
+  doStopListening = null
+
+  /**
+   * @param {import('./database.js').Database} database
+   * @param {(_: any, emit: any) => void} routingFn
+   */
+  constructor (
+    database,
+    routingFn = function (/** @type {any} */ _, /** @type {(arg0: string) => void} */ emit) {
+      emit('*');
+    }
+  ) {
+    this.database = database;
+    this.doStopListening = database.registerListener((/** @type {any} */ changes) => this.onChanges(changes));
+    /**
+     * The map function to apply to each entry in the database.
+     * @type {Function}
+     */
+    this.routingFn = routingFn;
+
+    this.dbHead = null;
+  }
+
+  /**
+   * Subscribe to a topic emitted by the event function.
+   * @param {string} topic - The topic to subscribe to.
+   * @param {Function} subscriber - The function to call when the topic is emitted.
+   * @returns {Function} A function to unsubscribe from the topic.
+   * @memberof Listener
+   * @instance
+   * @param {any} since
+   */
+  on (topic, subscriber, since) {
+    const listOfTopicSubscribers = getTopicList(this.subcribers, topic);
+    listOfTopicSubscribers.push(subscriber);
+    if (typeof since !== 'undefined') {
+      this.database.changesSince(since).then(({ rows: changes }) => {
+        const keys = topicsForChanges(changes, this.routingFn).get(topic);
+        if (keys) keys.forEach((/** @type {any} */ key) => subscriber(key));
+      });
+    }
+    return () => {
+      const index = listOfTopicSubscribers.indexOf(subscriber);
+      if (index > -1) listOfTopicSubscribers.splice(index, 1);
+    }
+  }
+
+  /**
+   * @typedef {import('./db-index').ChangeEvent} ChangeEvent
+   */
+
+  /**
+   * @param {ChangeEvent[]} changes
+   */
+  onChanges (changes) {
+    if (Array.isArray(changes)) {
+      const seenTopics = topicsForChanges(changes, this.routingFn);
+      for (const [topic, keys] of seenTopics) {
+        const listOfTopicSubscribers = getTopicList(this.subcribers, topic);
+        listOfTopicSubscribers.forEach((/** @type {(arg0: any) => any} */ subscriber) =>
+          keys.forEach((/** @type {any} */ key) => subscriber(key))
+        );
+      }
+    } else {
+      // non-arrays go to all subscribers
+      for (const [, listOfTopicSubscribers] of this.subcribers) {
+        listOfTopicSubscribers.forEach((/** @type {(arg0: any) => any} */ subscriber) => subscriber(changes));
+      }
+    }
+  }
+}
+
+/**
+ * @param {Map<any, any>} subscribersMap
+ * @param {string} name
+ */
+function getTopicList (subscribersMap, name) {
+  let topicList = subscribersMap.get(name);
+  if (!topicList) {
+    topicList = [];
+    subscribersMap.set(name, topicList);
+  }
+  return topicList
+}
+
+/**
+ * Transforms a set of changes to events using an emitter function.
+ *
+ * @param {ChangeEvent[]} changes
+ * @param {Function} routingFn
+ * @returns {Map<string,string[]>} The topics emmitted by the event function.
+ * @private
+ */
+const topicsForChanges = (changes, routingFn) => {
+  const seenTopics = new Map();
+  changes.forEach(({ key, value, del }) => {
+    if (del || !value) value = { _deleted: true };
+    routingFn({ _id: key, ...value }, (/** @type {any} */ t) => {
+      const topicList = getTopicList(seenTopics, t);
+      topicList.push(key);
+    });
+  });
+  return seenTopics
+};
+
 const compare$1 = (a, b) => {
   const [aKey, aRef] = a;
   const [bKey, bRef] = b;
@@ -38528,7 +38666,7 @@ const indexEntriesForChanges = (changes, mapFn) => {
  * @class DbIndex
  * @classdesc An DbIndex can be used to order and filter the documents in a Fireproof database.
  *
- * @param {Fireproof} database - The Fireproof database instance to DbIndex.
+ * @param {Database} database - The Fireproof database instance to DbIndex.
  * @param {Function} mapFn - The map function to apply to each entry in the database.
  *
  */
@@ -38536,7 +38674,7 @@ class DbIndex {
   constructor (database, mapFn, clock, opts = {}) {
     this.database = database;
     if (!database.indexBlocks) {
-      database.indexBlocks = new TransactionBlockstore(database.name + '.indexes', database.blocks.valet.getKeyMaterial());
+      database.indexBlocks = new TransactionBlockstore(database?.name + '.indexes', database.blocks.valet?.getKeyMaterial());
     }
     /**
      * The map function to apply to each entry in the database.
@@ -38755,125 +38893,34 @@ async function doIndexQuery (blocks, indexByKey, query = {}) {
   }
 }
 
-/**
- * A Fireproof database Listener allows you to react to events in the database.
- *
- * @class Listener
- * @classdesc An listener attaches to a Fireproof database and runs a routing function on each change, sending the results to subscribers.
- *
- * @param {import('./fireproof.js').Fireproof} database - The Fireproof database instance to index.
- * @param {Function} routingFn - The routing function to apply to each entry in the database.
- */
-// import { ChangeEvent } from './db-index'
-
-class Listener {
-  subcribers = new Map()
-  doStopListening = null
-
-  /**
-   * @param {import('./fireproof.js').Fireproof} database
-   * @param {(_: any, emit: any) => void} routingFn
-   */
-  constructor (database, routingFn) {
-    this.database = database;
-    this.doStopListening = database.registerListener((/** @type {any} */ changes) => this.onChanges(changes));
-    /**
-     * The map function to apply to each entry in the database.
-     * @type {Function}
-     */
-    this.routingFn =
-      routingFn ||
-      function (/** @type {any} */ _, /** @type {(arg0: string) => void} */ emit) {
-        emit('*');
-      };
-    this.dbHead = null;
-  }
-
-  /**
-   * Subscribe to a topic emitted by the event function.
-   * @param {string} topic - The topic to subscribe to.
-   * @param {Function} subscriber - The function to call when the topic is emitted.
-   * @returns {Function} A function to unsubscribe from the topic.
-   * @memberof Listener
-   * @instance
-   * @param {any} since
-   */
-  on (topic, subscriber, since) {
-    const listOfTopicSubscribers = getTopicList(this.subcribers, topic);
-    listOfTopicSubscribers.push(subscriber);
-    if (typeof since !== 'undefined') {
-      this.database.changesSince(since).then(({ rows: changes }) => {
-        const keys = topicsForChanges(changes, this.routingFn).get(topic);
-        if (keys) keys.forEach((/** @type {any} */ key) => subscriber(key));
-      });
-    }
-    return () => {
-      const index = listOfTopicSubscribers.indexOf(subscriber);
-      if (index > -1) listOfTopicSubscribers.splice(index, 1);
-    }
-  }
-
-  /**
-   * @typedef {import('./db-index').ChangeEvent} ChangeEvent
-   */
+const parseCID = cid => typeof cid === 'string' ? CID$1.parse(cid) : cid;
 
+class Fireproof {
   /**
-   * @param {ChangeEvent[]} changes
+   * @function storage
+   * @memberof Fireproof
+   * Creates a new Fireproof instance with default storage settings
+   * Most apps should use this and not worry about the details.
+   * @static
+   * @returns {Database} - a new Fireproof instance
    */
-  onChanges (changes) {
-    if (Array.isArray(changes)) {
-      const seenTopics = topicsForChanges(changes, this.routingFn);
-      for (const [topic, keys] of seenTopics) {
-        const listOfTopicSubscribers = getTopicList(this.subcribers, topic);
-        listOfTopicSubscribers.forEach((/** @type {(arg0: any) => any} */ subscriber) =>
-          keys.forEach((/** @type {any} */ key) => subscriber(key))
-        );
+  static storage = (name = null, opts = {}) => {
+    if (name) {
+      opts.name = name;
+      const existing = localGet('fp.' + name);
+      if (existing) {
+        const existingConfig = JSON.parse(existing);
+        const fp = new Database(new TransactionBlockstore(name, existingConfig.key), [], opts);
+        return this.fromJSON(existingConfig, fp)
+      } else {
+        const instanceKey = browserExports(32).toString('hex'); // pass null to disable encryption
+        return new Database(new TransactionBlockstore(name, instanceKey), [], opts)
       }
     } else {
-      // non-arrays go to all subscribers
-      for (const [, listOfTopicSubscribers] of this.subcribers) {
-        listOfTopicSubscribers.forEach((/** @type {(arg0: any) => any} */ subscriber) => subscriber(changes));
-      }
+      return new Database(new TransactionBlockstore(), [], opts)
     }
   }
-}
-
-/**
- * @param {Map<any, any>} subscribersMap
- * @param {string} name
- */
-function getTopicList (subscribersMap, name) {
-  let topicList = subscribersMap.get(name);
-  if (!topicList) {
-    topicList = [];
-    subscribersMap.set(name, topicList);
-  }
-  return topicList
-}
-
-/**
- * Transforms a set of changes to events using an emitter function.
- *
- * @param {ChangeEvent[]} changes
- * @param {Function} routingFn
- * @returns {Map<string,string[]>} The topics emmitted by the event function.
- * @private
- */
-const topicsForChanges = (changes, routingFn) => {
-  const seenTopics = new Map();
-  changes.forEach(({ key, value, del }) => {
-    if (del || !value) value = { _deleted: true };
-    routingFn({ _id: key, ...value }, (/** @type {any} */ t) => {
-      const topicList = getTopicList(seenTopics, t);
-      topicList.push(key);
-    });
-  });
-  return seenTopics
-};
-
-const parseCID = cid => typeof cid === 'string' ? CID$1.parse(cid) : cid;
 
-class Hydrator {
   static fromJSON (json, database) {
     database.hydrate({ clock: json.clock.map(c => parseCID(c)), name: json.name, key: json.key });
     if (json.indexes) {
@@ -38894,7 +38941,7 @@ class Hydrator {
 
   static snapshot (database, clock) {
     const definition = database.toJSON();
-    const withBlocks = new Fireproof(database.blocks);
+    const withBlocks = new Database(database.blocks);
     if (clock) {
       definition.clock = clock.map(c => parseCID(c));
       definition.indexes.forEach(index => {
@@ -38922,5 +38969,5 @@ class Hydrator {
   }
 }
 
-export { Fireproof, Hydrator, DbIndex as Index, Listener };
-//# sourceMappingURL=index.mjs.map
+export { Fireproof, DbIndex as Index, Listener };
+//# sourceMappingURL=fireproof.mjs.map