@comapeo/core 2.3.2 → 3.0.0-0

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -10,10 +10,10 @@ export function keyToId(key: Buffer | string): string;
 export function noop(): void;
 /**
  * @param {unknown} condition
- * @param {string} message
+ * @param {string | Error} messageOrError
  * @returns {asserts condition}
  */
-export function assert(condition: unknown, message: string): asserts condition;
+export function assert(condition: unknown, messageOrError: string | Error): asserts condition;
 /**
  * Return a function that itself returns whether a value is part of the set.
  *

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.js"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,6BAHW,MAAM,SAAO,UASvB;AAUD;;GAEG;AACH,wBAFa,IAAI,CAEQ;AAEzB;;;;GAIG;AACH,kCAJW,OAAO,WACP,MAAM,GACJ,QAAQ,SAAS,CAI7B;AAED;;;;;;;;;;;;;GAaG;AACH,uBATa,CAAC,OACH,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAUd,OAAO,KACL,KAAK,IAAI,CAAC,CAGxB;AAED;;;;GAIG;AACH,0BAJa,CAAC,SACH,SAAS,GAAG,CAAC,GACX,KAAK,IAAI,CAAC,CAItB;AAED;;;;;;;GAOG;AAEH,0BALkB,CAAC,SAAN,EAAI,OACN,CAAC,GACC,OAAO,YAAY,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAUtD;AAED;;;;GAIG;AACH,wBAJyE,CAAC,SAA5D,OAAO,iBAAiB,EAAE,QAAQ,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAG,OAC7D,CAAC,GACC,IAAI,CAAC,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,mBAAmB,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC,CAa5H;AAED;;;;GAIG;AACH,2CAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;GAIG;AACH,iDAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;GAIG;AACH,wDAHW,QAAQ,CAAC,MAAM,CAAC,GACd,MAAM,CAMlB;AAED;;;GAGG;AACH,4CAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;GAGG;AACH,wCAHW,2CAAkC,GAChC,MAAM,CAIlB;AAED;;;;;;;2DAO2D;AAC3D,0BALsB,CAAC,SAAV,MAAQ,EACF,CAAC,wBACT,aAAa,CAAC,CAAC,CAAC,SAChB,CAAC,GACC,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAOtD;AAED;;;;GAIG;AACH,gCAHW,MAAM,UAQhB;AAhKD;IACE,2BAA2B;IAC3B,mBADY,KAAK,EAIhB;CACF"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.js"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,6BAHW,MAAM,SAAO,UASvB;AAUD;;GAEG;AACH,wBAFa,IAAI,CAEQ;AAEzB;;;;GAIG;AACH,kCAJW,OAAO,kBACP,MAAM,GAAG,KAAK,GACZ,QAAQ,SAAS,CAS7B;AAED;;;;;;;;;;;;;GAaG;AACH,uBATa,CAAC,OACH,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAUd,OAAO,KACL,KAAK,IAAI,CAAC,CAGxB;AAED;;;;GAIG;AACH,0BAJa,CAAC,SACH,SAAS,GAAG,CAAC,GACX,KAAK,IAAI,CAAC,CAItB;AAED;;;;;;;GAOG;AAEH,0BALkB,CAAC,SAAN,EAAI,OACN,CAAC,GACC,OAAO,YAAY,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAUtD;AAED;;;;GAIG;AACH,wBAJyE,CAAC,SAA5D,OAAO,iBAAiB,EAAE,QAAQ,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAG,OAC7D,CAAC,GACC,IAAI,CAAC,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,mBAAmB,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC,CAa5H;AAED;;;;GAIG;AACH,2CAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;GAIG;AACH,iDAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;GAIG;AACH,wDAHW,QAAQ,CAAC,MAAM,CAAC,GACd,MAAM,CAMlB;AAED;;;GAGG;AACH,4CAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;GAGG;AACH,wCAHW,2CAAkC,GAChC,MAAM,CAIlB;AAED;;;;;;;2DAO2D;AAC3D,0BALsB,CAAC,SAAV,MAAQ,EACF,CAAC,wBACT,aAAa,CAAC,CAAC,CAAC,SAChB,CAAC,GACC,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAOtD;AAED;;;;GAIG;AACH,gCAHW,MAAM,UAQhB;AArKD;IACE,2BAA2B;IAC3B,mBADY,KAAK,EAIhB;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comapeo/core",
-  "version": "2.3.2",
+  "version": "3.0.0-0",
   "description": "Offline p2p mapping library",
   "main": "src/index.js",
   "types": "dist/index.d.ts",
@@ -209,6 +209,7 @@
     "unix-path-resolve": "^1.0.2",
     "varint": "^6.0.0",
     "ws": "^8.18.0",
+    "xstate": "^5.19.2",
     "yauzl-promise": "^4.0.0"
   }
 }

package/src/errors.js

@@ -1,6 +1,39 @@
 export class NotFoundError extends Error {
   constructor(message = 'Not found') {
     super(message)
+    this.name = 'NotFoundError'
+  }
+}
+
+export class AlreadyJoinedError extends Error {
+  /** @param {string} [message] */
+  constructor(message = 'AlreadyJoinedError') {
+    super(message)
+    this.name = 'AlreadyJoinedError'
+  }
+}
+
+export class InviteSendError extends Error {
+  /** @param {string} [message] */
+  constructor(message = 'Invite Send Error') {
+    super(message)
+    this.name = 'InviteSendError'
+  }
+}
+
+export class InviteAbortedError extends Error {
+  /** @param {string} [message] */
+  constructor(message = 'Invite Aborted') {
+    super(message)
+    this.name = 'InviteAbortedError'
+  }
+}
+
+export class TimeoutError extends Error {
+  /** @param {string} [message] */
+  constructor(message = 'TimeoutError') {
+    super(message)
+    this.name = 'TimeoutError'
   }
 }
 

package/src/invite/StateDiagram.md

@@ -0,0 +1,47 @@
+```mermaid
+---
+title: Invite Receive State Diagram
+---
+stateDiagram-v2
+  state "invite" as invite {
+    [*] --> invite.pending
+    invite.pending --> invite.canceled : CANCEL_INVITE
+    invite.pending --> invite.responding.accept : ACCEPT_INVITE
+    invite.pending --> invite.responding.already : ALREADY_IN_PROJECT
+    invite.pending --> invite.responding.reject : REJECT_INVITE
+    invite.responding.default --> invite.error
+    invite.responding.accept --> invite.joining.addingProject : RECEIVE_PROJECT_DETAILS
+    invite.responding.accept --> invite.joining : Responded Accept
+    invite.responding.accept --> invite.error : Error responding
+    invite.responding.reject --> invite.rejected : Responded Reject
+    invite.responding.reject --> invite.error : Error responding
+    invite.responding.already --> invite.respondedAlready : Responded Already
+    invite.responding.already --> invite.error : Error responding
+    invite.responding --> invite.canceled : CANCEL_INVITE
+    invite.joining.awaitingDetails --> invite.canceled : CANCEL_INVITE
+    invite.joining.awaitingDetails --> invite.error : projectDetailsTimeout
+    invite.joining.addingProject --> invite.error : addProject Timeout
+    invite.joining.addingProject --> invite.joined :  Project Added
+    invite.joining.addingProject --> invite.error : addProject Error
+    state "Pending invite awaiting response" as invite.pending
+        state "Responding to invite" as invite.responding {
+            [*] --> invite.responding.default
+            state "default" as invite.responding.default
+            state "accept" as invite.responding.accept
+            state "reject" as invite.responding.reject
+            state "already" as invite.responding.already
+        }
+        state "Joining project from invite" as invite.joining {
+            [*] --> invite.joining.awaitingDetails
+            invite.joining.awaitingDetails --> invite.joining.addingProject : RECEIVE_PROJECT_DETAILS
+            state "Awaiting project details" as invite.joining.awaitingDetails
+          state "Adding project" as invite.joining.addingProject
+        }
+    state "Invite Canceled" as invite.canceled
+    state "Invite Rejected" as invite.rejected
+    state "Responded already in project" as invite.respondedAlready
+    state "Joined project" as invite.joined
+    state "Invite Error" as invite.error
+  }
+
+```

package/src/invite/invite-api.js

@@ -0,0 +1,387 @@
+import { TypedEmitter } from 'tiny-typed-emitter'
+import { InviteResponse_Decision } from '../generated/rpc.js'
+import { assert, keyToId, noop } from '../utils.js'
+import HashMap from '../lib/hashmap.js'
+import timingSafeEqual from 'string-timing-safe-equal'
+import { Logger } from '../logger.js'
+import { createActor, fromPromise, toPromise } from 'xstate'
+import { inviteStateMachine } from './invite-state-machine.js'
+import {
+  NotFoundError,
+  AlreadyJoinedError,
+  InviteSendError,
+} from '../errors.js'
+
+/** @import { MapBuffers } from '../types.js' */
+/**
+ * @import {
+ *   Invite as InviteRpcMessage,
+ *   InviteCancel,
+ *   ProjectJoinDetails
+ * } from '../generated/rpc.js'
+ */
+
+// There are three slightly different invite types:
+//
+// - InviteRpcMessage comes from the protobuf.
+// - InviteInternal adds a locally-generated receive timestamp.
+// - Invite is the externally-facing type.
+
+/**
+ * @internal
+ * @typedef {InviteRpcMessage & { receivedAt: number }} InviteInternal
+ */
+/** @typedef {ExtractStateString<import('xstate').StateValueFrom<typeof inviteStateMachine>>} InviteState */
+/** @typedef {import('type-fest').Simplify<MapBuffers<InviteInternal> & { invitorDeviceId: string } & ({ state: Exclude<InviteState, 'error'> } | { state: 'error', error: Error })>} Invite */
+
+/**
+ * @typedef {import('xstate').ActorRefFrom<typeof inviteStateMachine>} invite.actor
+ */
+
+/**
+ * @typedef {Object} InviteApiEvents
+ * @property {(invite: Invite) => void} invite-received
+ * @property {(invite: Invite) => void} invite-updated
+ */
+
+/**
+ * @typedef {(projectDetails: Pick<ProjectJoinDetails, 'projectKey' | 'encryptionKeys'> & { projectName: string }) => Promise<string>} AddProjectQuery
+ */
+
+/**
+ * @extends {TypedEmitter<InviteApiEvents>}
+ */
+export class InviteApi extends TypedEmitter {
+  #getProjectByInviteId
+  #addProject
+  /** @type {HashMap<string | Buffer, { value: InviteInternal, actor: invite.actor, peerId: string }>} */
+  #invites = new HashMap(keyToId)
+  #l
+
+  /**
+   * @param {Object} options
+   * @param {import('../local-peers.js').LocalPeers} options.rpc
+   * @param {object} options.queries
+   * @param {(projectInviteId: Readonly<Buffer>) => undefined | { projectPublicId: string }} options.queries.getProjectByInviteId
+   * @param {AddProjectQuery} options.queries.addProject
+   * @param {Logger} [options.logger]
+   */
+  constructor({ rpc, queries, logger }) {
+    super()
+
+    this.#l = Logger.create('InviteApi', logger)
+
+    this.rpc = rpc
+    this.#getProjectByInviteId = queries.getProjectByInviteId
+    this.#addProject = queries.addProject
+
+    this.rpc.on('invite', (...args) => {
+      try {
+        this.#handleNewInvite(...args)
+      } catch (err) {
+        console.error('Error handling invite', err)
+      }
+    })
+
+    this.rpc.on('invite-cancel', (_peerId, inviteCancel) => {
+      try {
+        this.#handleInviteCancel(inviteCancel)
+      } catch (err) {
+        console.error('Error handling invite cancel', err)
+      }
+    })
+
+    this.rpc.on('got-project-details', (peerId, projectJoinDetails) => {
+      try {
+        this.#handleGotProjectDetails(peerId, projectJoinDetails)
+      } catch (err) {
+        console.error('Error handling got-project-details', err)
+      }
+    })
+  }
+
+  /** @param {Buffer} projectInviteId */
+  #isJoiningProject(projectInviteId) {
+    for (const { value, actor } of this.#invites.values()) {
+      const state = actor.getSnapshot()
+      if (
+        state.matches('joining') &&
+        value.projectInviteId.equals(projectInviteId)
+      ) {
+        return true
+      }
+    }
+    return false
+  }
+
+  /**
+   * @param {string} peerId
+   * @param {InviteRpcMessage} inviteRpcMessage
+   */
+  #handleNewInvite(peerId, inviteRpcMessage) {
+    const { inviteId, projectInviteId, projectName } = inviteRpcMessage
+    const invite = { ...inviteRpcMessage, receivedAt: Date.now() }
+
+    this.#l.log('Received invite %h from %S', inviteId, peerId)
+
+    const hasAlreadyReceivedThisInvite = this.#invites.has(inviteId)
+    if (hasAlreadyReceivedThisInvite) {
+      this.#l.log('Invite %h: already received this invite', inviteId)
+      return
+    }
+
+    const isAlreadyMember = Boolean(this.#getProjectByInviteId(projectInviteId))
+    if (isAlreadyMember) {
+      this.#l.log('Invite %h: already in project', inviteId)
+      this.rpc
+        .sendInviteResponse(peerId, {
+          decision: InviteResponse_Decision.ALREADY,
+          inviteId,
+        })
+        .catch(noop)
+      return
+    }
+
+    const actor = createActor(
+      inviteStateMachine.provide({
+        actors: {
+          sendInviteResponse: fromPromise(async ({ input: { decision } }) => {
+            return this.rpc.sendInviteResponse(peerId, { decision, inviteId })
+          }),
+          addProject: fromPromise(async ({ input: projectDetails }) => {
+            return this.#addProject({ ...projectDetails, projectName })
+          }),
+        },
+        guards: {
+          isNotAlreadyJoiningOrInProject: () => {
+            const isJoining = this.#isJoiningProject(projectInviteId)
+            const isAlreadyMember = Boolean(
+              this.#getProjectByInviteId(projectInviteId)
+            )
+            return !isJoining && !isAlreadyMember
+          },
+        },
+      })
+    )
+
+    this.#invites.set(inviteId, { value: invite, actor, peerId })
+
+    this.emit('invite-received', toInvite(invite, actor.getSnapshot(), peerId))
+    actor.start()
+    // Subscribe after start so that initial state (invite-received) is not emitted twice
+    actor.subscribe((snapshot) => {
+      this.emit('invite-updated', toInvite(invite, snapshot, peerId))
+    })
+  }
+
+  /**
+   * @param {InviteCancel} inviteCancel
+   */
+  #handleInviteCancel(inviteCancel) {
+    const { inviteId } = inviteCancel
+
+    this.#l.log('Received invite cancel for invite ID %h', inviteId)
+
+    const invite = this.#invites.get(inviteId)
+    assert(!!invite, `Cannot find invite ${inviteId.toString('hex')}`)
+
+    // TODO: Move this logging to the state machine
+    const state = invite.actor.getSnapshot()
+    if (!state.can({ type: 'CANCEL_INVITE' })) {
+      this.#l.log(
+        'Received invite cancel for %h but invite is already in state %o',
+        inviteId,
+        state.value
+      )
+      return
+    }
+
+    invite.actor.send({ type: 'CANCEL_INVITE' })
+  }
+
+  /**
+   * @param {string} peerId
+   * @param {ProjectJoinDetails} projectJoinDetails
+   */
+  #handleGotProjectDetails(peerId, projectJoinDetails) {
+    const invite = this.#invites.get(projectJoinDetails.inviteId)
+    if (!invite) {
+      this.#l.log(
+        'Received project details for %h but invite is not found',
+        projectJoinDetails.inviteId
+      )
+      return
+    }
+    if (!timingSafeEqual(peerId, invite.peerId)) {
+      this.#l.log(
+        'Received project details for %h but peer ID does not match',
+        projectJoinDetails.inviteId
+      )
+      return
+    }
+    invite.actor.send({
+      type: 'RECEIVE_PROJECT_DETAILS',
+      ...projectJoinDetails,
+    })
+  }
+
+  /**
+   * Get all invites (in all)
+   *
+   * @returns {Array<Invite>}
+   */
+  getMany() {
+    /** @type {Array<Invite>} */
+    const invites = []
+    for (const { value, actor, peerId } of this.#invites.values()) {
+      const snapshot = actor.getSnapshot()
+      invites.push(toInvite(value, snapshot, peerId))
+    }
+    return invites
+  }
+
+  /**
+   * Get an invite by inviteId
+   *
+   * @param {string} inviteIdString
+   * @returns {Invite}
+   */
+  getById(inviteIdString) {
+    const inviteId = Buffer.from(inviteIdString, 'hex')
+    const invite = this.#invites.get(inviteId)
+    if (!invite) {
+      throw new NotFoundError(`Cannot find invite ${inviteIdString}`)
+    }
+    return toInvite(invite.value, invite.actor.getSnapshot(), invite.peerId)
+  }
+
+  /**
+   * Attempt to accept the invite.
+   *
+   * This can fail if the invitor has canceled the invite or if you cannot
+   * connect to the invitor's device.
+   *
+   * If the invite is accepted and you had other invites to the same project,
+   * those invites are removed, and the invitors are told that you're already
+   * part of this project.
+   *
+   * @param {Pick<Invite, 'inviteId'>} invite
+   * @returns {Promise<string>}
+   */
+  async accept({ inviteId: inviteIdString }) {
+    const inviteId = Buffer.from(inviteIdString, 'hex')
+
+    const invite = this.#invites.get(inviteId)
+    assert(!!invite, new NotFoundError(`Cannot find invite ${inviteIdString}`))
+    assertCanSend(invite.actor, { type: 'ACCEPT_INVITE' })
+
+    this.#l.log('Accepting invite %h', inviteId)
+    invite.actor.send({ type: 'ACCEPT_INVITE' })
+
+    for (const { value, actor } of this.#invites.values()) {
+      if (value.inviteId.equals(inviteId)) continue
+      const inviteIsForSameProject = value.projectInviteId.equals(
+        invite.value.projectInviteId
+      )
+      if (inviteIsForSameProject) {
+        actor.send({ type: 'ALREADY_IN_PROJECT' })
+      }
+    }
+
+    const { projectPublicId } = await toPromise(invite.actor)
+
+    if (!projectPublicId) {
+      const { context, value } = invite.actor.getSnapshot()
+      throw value === 'respondedAlready'
+        ? new AlreadyJoinedError('Already joining or in project')
+        : context.error || new Error('Unknown error')
+    }
+
+    return projectPublicId
+  }
+
+  /**
+   * @param {Pick<Invite, 'inviteId'>} invite
+   * @returns {void}
+   */
+  reject({ inviteId: inviteIdString }) {
+    const inviteId = Buffer.from(inviteIdString, 'hex')
+
+    const invite = this.#invites.get(inviteId)
+    assert(!!invite, `Cannot find invite ${inviteIdString}`)
+    assertCanSend(invite.actor, { type: 'REJECT_INVITE' })
+
+    this.#l.log('Rejecting invite %h', inviteId)
+    invite.actor.send({ type: 'REJECT_INVITE' })
+  }
+}
+
+/**
+ * @param {InviteInternal} internal
+ * @param {import('xstate').SnapshotFrom<invite.actor>} snapshot
+ * @param {string} invitorDeviceId
+ * @returns {Invite}
+ */
+function toInvite(internal, snapshot, invitorDeviceId) {
+  const state = toStateString(snapshot.value)
+  if (state === 'error') {
+    return {
+      ...internal,
+      invitorDeviceId,
+      inviteId: internal.inviteId.toString('hex'),
+      projectInviteId: internal.projectInviteId.toString('hex'),
+      state,
+      error: snapshot.context.error || new Error('Unknown error'),
+    }
+  } else {
+    return {
+      ...internal,
+      invitorDeviceId,
+      inviteId: internal.inviteId.toString('hex'),
+      projectInviteId: internal.projectInviteId.toString('hex'),
+      state,
+    }
+  }
+}
+
+/**
+ * Assert that a given event type can be sent to the state machine (will throw
+ * if there is no transition defined for this event type for the current state
+ * of the machine)
+ *
+ * @param {invite.actor} actor
+ * @param {import('xstate').EventFrom<invite.actor>} eventType
+ */
+function assertCanSend(actor, eventType) {
+  const state = actor.getSnapshot()
+  assert(
+    state.can(eventType),
+    new InviteSendError(
+      `Cannot send ${JSON.stringify(eventType)} in state ${toStateString(
+        state.value
+      )}`
+    )
+  )
+}
+
+/**
+ * @template {import('xstate').StateValue} T
+ * @typedef {T extends string ? T : T extends import('xstate').StateValueMap ? keyof T : never} ExtractStateString
+ */
+
+/**
+ * "Flatten" nested states into a top-level string, e.g. in our case the state
+ * `{ joining: 'awaitingDetails' }` will be flattened to `'joining'`.
+ *
+ * @template {import('xstate').StateValue} T
+ * @param {T} stateValue
+ * @returns {ExtractStateString<T>}
+ */
+function toStateString(stateValue) {
+  if (typeof stateValue === 'string') {
+    // @ts-expect-error - typescript limitation
+    return stateValue
+  }
+  // @ts-expect-error - typescript limitation
+  return Object.keys(stateValue)[0]
+}