feat: add project.close()

src/datastore/index.js

@@ -197,7 +197,7 @@ export class DataStore extends TypedEmitter {
     return decode(block, { coreDiscoveryKey, index })
   }
 
-  /** @param {Buffer} buf} */
+  /** @param {Buffer} buf */
   async writeRaw(buf) {
     const { length } = await this.#writerCore.append(buf)
     const index = length - 1
@@ -219,6 +219,9 @@ export class DataStore extends TypedEmitter {
     return block
   }
 
+  async close() {
+    await this.#coreIndexer.close()
+  }
   #handleIndexerIdle = () => {
     for (const eventName of this.eventNames()) {
       if (!(eventName in this.#pendingEmits)) continue

src/mapeo-manager.js

@@ -314,6 +314,10 @@ export class MapeoManager extends TypedEmitter {
       projectSecretKey: projectKeypair.secretKey,
     })
 
+    project.once('close', () => {
+      this.#activeProjects.delete(projectPublicId)
+    })
+
     // 5. Write project name and any other relevant metadata to project instance
     await project.$setProjectSettings(settings)
 
@@ -369,6 +373,10 @@ export class MapeoManager extends TypedEmitter {
 
     const project = this.#createProjectInstance(projectKeys)
 
+    project.once('close', () => {
+      this.#activeProjects.delete(projectPublicId)
+    })
+
     // 3. Keep track of project instance as we know it's a properly existing project
     this.#activeProjects.set(projectPublicId, project)
 

src/mapeo-project.js

@@ -5,6 +5,7 @@ import { decodeBlockPrefix } from '@mapeo/schema'
 import { drizzle } from 'drizzle-orm/better-sqlite3'
 import { migrate } from 'drizzle-orm/better-sqlite3/migrator'
 import { discoveryKey } from 'hypercore-crypto'
+import { TypedEmitter } from 'tiny-typed-emitter'
 
 import { CoreManager, NAMESPACES } from './core-manager/index.js'
 import { DataStore } from './datastore/index.js'
@@ -51,7 +52,10 @@ export const kBlobStore = Symbol('blobStore')
 export const kProjectReplicate = Symbol('replicate project')
 const EMPTY_PROJECT_SETTINGS = Object.freeze({})
 
-export class MapeoProject {
+/**
+ * @extends {TypedEmitter<{ close: () => void }>}
+ */
+export class MapeoProject extends TypedEmitter {
   #projectId
   #deviceId
   #coreManager
@@ -60,6 +64,9 @@ export class MapeoProject {
   #blobStore
   #coreOwnership
   #capabilities
+  /** @ts-ignore */
+  #ownershipWriteDone
+  #sqlite
   #memberApi
   #iconApi
   #syncApi
@@ -97,13 +104,15 @@ export class MapeoProject {
     localPeers,
     logger,
   }) {
+    super()
+
     this.#l = Logger.create('project', logger)
     this.#deviceId = getDeviceId(keyManager)
     this.#projectId = projectKeyToId(projectKey)
 
     ///////// 1. Setup database
-    const sqlite = new Database(dbPath)
-    const db = drizzle(sqlite)
+    this.#sqlite = new Database(dbPath)
+    const db = drizzle(this.#sqlite)
     migrate(db, { migrationsFolder: projectMigrationsFolder })
 
     ///////// 2. Setup random-access-storage functions
@@ -124,7 +133,7 @@ export class MapeoProject {
       projectKey,
       keyManager,
       storage: coreManagerStorage,
-      sqlite,
+      sqlite: this.#sqlite,
       logger: this.#l,
     })
 
@@ -138,7 +147,7 @@ export class MapeoProject {
         deviceInfoTable,
         iconTable,
       ],
-      sqlite,
+      sqlite: this.#sqlite,
       getWinner,
       mapDoc: (doc, version) => {
         switch (doc.schemaName) {
@@ -294,17 +303,32 @@ export class MapeoProject {
       this.#coreManager.creatorCore.replicate(peer.protomux)
     }
 
+    /**
+     * @type {import('./local-peers.js').LocalPeersEvents['peer-add']}
+     */
+    const onPeerAdd = (peer) => {
+      this.#coreManager.creatorCore.replicate(peer.protomux)
+    }
+
+    /**
+     * @type {import('./local-peers.js').LocalPeersEvents['discovery-key']}
+     */
+    const onDiscoverykey = (discoveryKey, stream) => {
+      this.#syncApi[kHandleDiscoveryKey](discoveryKey, stream)
+    }
+
     // When a new peer is found, try to replicate (if it is not a member of the
     // project it will fail the capability check and be ignored)
-    localPeers.on('peer-add', (peer) => {
-      this.#coreManager.creatorCore.replicate(peer.protomux)
-    })
+    localPeers.on('peer-add', onPeerAdd)
 
     // This happens whenever a peer replicates a core to the stream. SyncApi
     // handles replicating this core if we also have it, or requesting the key
     // for the core.
-    localPeers.on('discovery-key', (discoveryKey, stream) => {
-      this.#syncApi[kHandleDiscoveryKey](discoveryKey, stream)
+    localPeers.on('discovery-key', onDiscoverykey)
+
+    this.once('close', () => {
+      localPeers.off('peer-add', onPeerAdd)
+      localPeers.off('discovery-key', onDiscoverykey)
     })
 
     this.#l.log('Created project instance %h', projectKey)
@@ -339,6 +363,29 @@ export class MapeoProject {
     return this.#deviceId
   }
 
+  /**
+   * Resolves when hypercores have all loaded
+   */
+  async ready() {
+    await Promise.all([this.#coreManager.ready(), this.#ownershipWriteDone])
+  }
+
+  /**
+   */
+  async close() {
+    this.#l.log('closing project %h', this.#projectId)
+    const dataStorePromises = []
+    for (const dataStore of Object.values(this.#dataStores)) {
+      dataStorePromises.push(dataStore.close())
+    }
+    await Promise.all(dataStorePromises)
+    await this.#coreManager.close()
+
+    this.#sqlite.close()
+
+    this.emit('close')
+  }
+
   /**
    * @param {import('multi-core-indexer').Entry[]} entries
    * @param {{projectIndexWriter: IndexWriter, sharedIndexWriter: IndexWriter}} indexWriters

test-e2e/project-crud.js

@@ -141,5 +141,71 @@ test('CRUD operations', async (t) => {
         'expected values returns from getMany()'
       )
     })
+
+    t.test('create, close and then create, update', async (st) => {
+      const projectId = await manager.createProject()
+      const project = await manager.getProject(projectId)
+      const values = new Array(5).fill(null).map(() => {
+        return getUpdateFixture(value)
+      })
+      for (const value of values) {
+        // @ts-ignore
+        await project[schemaName].create(value)
+      }
+      // @ts-ignore
+      const written = await project[schemaName].create(value)
+      await project.close()
+
+      await st.exception(async () => {
+        const updateValue = getUpdateFixture(value)
+        // @ts-ignore
+        await project[schemaName].update(written.versionId, updateValue)
+      }, 'should fail updating since the project is already closed')
+
+      await st.exception(async () => {
+        for (const value of values) {
+          // @ts-ignore
+          await project[schemaName].create(value)
+        }
+      }, 'should fail creating since the project is already closed')
+
+      // @ts-ignore
+      await st.exception.all(async () => {
+        await project[schemaName].getMany()
+      }, 'should fail getting since the project is already closed')
+    })
+
+    t.test('create, read, close, re-open, read', async (st) => {
+      const projectId = await manager.createProject()
+
+      let project = await manager.getProject(projectId)
+
+      const values = new Array(5).fill(null).map(() => {
+        return getUpdateFixture(value)
+      })
+
+      for (const value of values) {
+        // @ts-ignore
+        await project[schemaName].create(value)
+      }
+
+      const many1 = await project[schemaName].getMany()
+      const manyValues1 = many1.map((doc) => valueOf(doc))
+
+      // close it
+      await project.close()
+
+      // re-open project
+      project = await manager.getProject(projectId)
+
+      const many2 = await project[schemaName].getMany()
+      const manyValues2 = many2.map((doc) => valueOf(doc))
+
+      st.alike(
+        stripUndef(manyValues1),
+        stripUndef(manyValues2),
+        'expected values returned before closing and after re-opening'
+      )
+    })
   }
 })

test-e2e/sync.js

@@ -254,7 +254,5 @@ test('no sync capabilities === no namespaces sync apart from auth', async (t) =>
 
   await disconnect1()
 
-  // Temp fix until we have .close() method - waits for indexing idle to ensure
-  // we don't close storage in teardown while index is still being written.
-  await Promise.all(projects.map((p) => p.$getProjectSettings()))
+  await Promise.all(projects.map((p) => p.close()))
 })