@audiotool/nexus 0.0.10 → 0.0.12

package/dist/audiotool-client.d.ts

@@ -29,22 +29,10 @@ export type AudiotoolClient = {
      * @returns Promise resolving to a SyncedDocument instance
      */
     createSyncedDocument: (opts: {
-        /** Run in online mode, which means the document state is synced in real time. */
-        mode: "online";
         /** The project to sync to; this can be anything containing a project's UUID, e.g. the URL of the studio
          * when the project is open in the browser.
          */
         project: string;
-    } | {
-        /** Run in offline mode, i.e. not synced to any particular project.
-         *
-         * All changes are discarded on reload.
-         */
-        mode: "offline";
-        /** Whether transaction validation is on. If off, fewer transaction errors will occur,
-         * but the document might not get accepted by the backend if connecting to a project.
-         */
-        validated: boolean;
     }) => Promise<SyncedDocument>;
     /**
      * Collection of Audiotool API service clients.

package/dist/document/backend/gateway.d.ts

@@ -41,8 +41,12 @@ export interface NexusGateway {
      * This function must indicate that the current document state was loaded by returning at least
      * one transaction. If the document state is empty, that transaction can be empty. The studio
      * will show the loading spinner until the first transaction is received.
+     *
+     * After the first transaction, the gateway can return "done" to indicate that no further transactions
+     * will be returned, which the caller can use as a signal to stop polling. This is useful in situations
+     * where it's known that no synchronization transactions will ever be returned, such as when running in offline mode.
      */
-    synchronize(): ReadonlyTransaction[];
+    synchronize(): ReadonlyTransaction[] | "done";
     /** This becomes true when the gateway is blocked in some way from syncing with upstream state.
      * The document should be locked in this case to prevent data loss.
      */

package/dist/exports/index.d.ts

@@ -28,4 +28,6 @@
  */
 export { createAudiotoolClient, type AudiotoolClient, } from '../audiotool-client';
 export type { SyncedDocument } from '../synced-document';
-export { getLoginStatus, type LoginStatus } from '../login-status';
+export { getLoginStatus, type LoggedInStatus, type LoggedOutStatus, type LoginStatus, } from '../login-status';
+export { createOfflineDocument } from '../synced-document';
+export type { OfflineDocument } from '../synced-document';

package/dist/index.js

@@ -5,7 +5,7 @@ var jt = (i) => {
 var Gt = (i, e, t) => e in i ? Wt(i, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : i[e] = t;
 var a = (i, e, t) => Gt(i, typeof e != "symbol" ? e + "" : e, t), At = (i, e, t) => e.has(i) || jt("Cannot " + t);
 var s = (i, e, t) => (At(i, e, "read from private field"), t ? t.call(i) : e.get(i)), h = (i, e, t) => e.has(i) ? jt("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(i) : e.set(i, t), g = (i, e, t, n) => (At(i, e, "write to private field"), n ? n.call(i, t) : e.set(i, t), t), y = (i, e, t) => (At(i, e, "access private method"), t);
-import { aS as entityMessageToTypeKey, aT as mustUnpackEntity, aU as packEntity, aV as getEntityTypeKeyFromProtoName, aW as unpackEntity, aX as Preset, aY as anyEntityToTypeKey, aZ as createRetryingPromiseClient, a_ as createAuthorizedKeepaliveTransport, aR as createAudiotoolAPI, a$ as extractUuid, n as neverThrowingFetch } from "./audiotool-api-D9u-oGp3.js";
+import { aS as runningInBrowser, aT as entityMessageToTypeKey, aU as mustUnpackEntity, aV as packEntity, aW as getEntityTypeKeyFromProtoName, aX as unpackEntity, aY as Preset, aZ as anyEntityToTypeKey, a_ as createRetryingPromiseClient, a$ as createAuthorizedKeepaliveTransport, aR as createAudiotoolAPI, b0 as extractUuid, n as neverThrowingFetch } from "./audiotool-api-CjHbqgj8.js";
 import { Message, proto3, protoInt64, Any, ScalarType, MethodKind } from "@bufbuild/protobuf";
 import { P as Pointer, E as Empty, e as entityMessageTypes } from "./types-Cztu157p.js";
 import { t as throw_, a as assert, b as asyncInterval, s as sleep } from "./lang-K-8hAzE4.js";
@@ -1276,7 +1276,7 @@ a(dt, "runtime", proto3), a(dt, "typeName", "audiotool.document.v1.GetTimeRespon
   }
 ]));
 let GetTimeResponse = dt;
-const wasmUrl = "/document_validator.wasm", wasmJsUrl = "/wasm_exec.js", runningInNode = typeof process < "u";
+const wasmUrl = "/document_validator.wasm", wasmJsUrl = "/wasm_exec.js";
 let wasmDocumentStateBuilderCache;
 const getWasmDocumentState = async () => {
   if (wasmDocumentStateBuilderCache !== void 0)
@@ -1305,14 +1305,14 @@ const getWasmDocumentState = async () => {
     const d = c();
     let u = !1;
     return {
-      applyTransaction(f) {
+      applyTransaction(m) {
         assert(
           !u,
           "tried applying a transaction after document state was terminated"
         );
-        const m = d.applyTransaction(f.toBinary());
-        return m instanceof Object && "error" in m ? m.error : new Transaction({
-          modifications: m.rollbacks.map((p) => Modification.fromBinary(p))
+        const f = d.applyTransaction(m.toBinary());
+        return f instanceof Object && "error" in f ? f.error : new Transaction({
+          modifications: f.rollbacks.map((p) => Modification.fromBinary(p))
         });
       },
       terminate() {
@@ -1321,7 +1321,7 @@ const getWasmDocumentState = async () => {
     };
   }), (await i)();
 }, executeWrapperJs = async () => {
-  if (!runningInNode)
+  if (runningInBrowser)
     return import("https://cdn.audiotool.com/website-assets/document-service/5b85be5b151fe1c949845fe34b15f24ab059c736//wasm_exec.js");
   const path = await import("node:path"), url = await import("node:url"), fs = await import("node:fs");
   let filePath;
@@ -1339,7 +1339,7 @@ const getWasmDocumentState = async () => {
     )
   ), await promise;
 }, loadWasm = async () => {
-  if (!runningInNode)
+  if (runningInBrowser)
     return await fetch(
       "https://cdn.audiotool.com/website-assets/document-service/5b85be5b151fe1c949845fe34b15f24ab059c736//document_validator.wasm.gz"
     ).then(
@@ -1392,22 +1392,22 @@ class NexusStateConsolidator {
       if (t.size === 0)
         return [];
       const l = s(this, b).findIndex(
-        ([m]) => t.has(m.id)
+        ([f]) => t.has(f.id)
       );
       if (l === -1)
         throw new Error(
           "Invariant violation: expected to find rejected transaction in #pending, but didn't. This is a bug."
         );
-      const d = s(this, b).splice(l), u = d.map(([, m]) => {
-        if (!(s(this, I).applyTransaction(m) instanceof Transaction))
+      const d = s(this, b).splice(l), u = d.map(([, f]) => {
+        if (!(s(this, I).applyTransaction(f) instanceof Transaction))
           throw new Error("error applying reversal of transaction");
-        return m;
-      }).reverse(), f = d.filter(([m]) => !t.has(m.id)).map(([m]) => {
-        const p = s(this, I).applyTransaction(m);
+        return f;
+      }).reverse(), m = d.filter(([f]) => !t.has(f.id)).map(([f]) => {
+        const p = s(this, I).applyTransaction(f);
         if (p instanceof Transaction)
-          return [m, p];
-      }).filter((m) => m !== void 0);
-      return s(this, b).push(...f), [...u, ...f.map(([m]) => m)];
+          return [f, p];
+      }).filter((f) => f !== void 0);
+      return s(this, b).push(...m), [...u, ...m.map(([f]) => f)];
     }
     const c = s(this, b).map((l) => l[1].clone()).reverse();
     return c.forEach((l) => {
@@ -1420,7 +1420,7 @@ class NexusStateConsolidator {
         throw new Error(`Error applying incoming transaction: ${d}`);
     }), g(this, b, s(this, b).filter(([l]) => {
       const d = t.has(l.id), u = e.some(
-        (f) => f.id === l.id
+        (m) => m.id === l.id
       );
       return !d && !u;
     }).map(([l]) => {
@@ -1488,7 +1488,7 @@ const combinedValueNotifiersWithAnd = (...i) => {
     }
   )[Symbol.asyncIterator]());
   let u = d();
-  const f = 1e3;
+  const m = 1e3;
   return {
     nextTransactionIterator: async function* () {
       for (; ; )
@@ -1525,7 +1525,7 @@ const combinedValueNotifiersWithAnd = (...i) => {
             case Code.Unavailable:
             case Code.Unknown: {
               if (n.setValue(!1), await sleep(
-                f + Math.random() * f * 0.1,
+                m + Math.random() * m * 0.1,
                 // pass in master abort controller for early termination
                 r.signal
               ), r.signal.aborted)
@@ -1571,8 +1571,8 @@ const combinedValueNotifiersWithAnd = (...i) => {
       );
       if (d instanceof Error)
         throw new Error("error sending transaction", { cause: d });
-      l.forEach(([u, f]) => {
-        f(d.errors[u.id] ?? void 0);
+      l.forEach(([u, m]) => {
+        m(d.errors[u.id] ?? void 0);
       });
     }
   })(), {
@@ -1629,41 +1629,43 @@ const combinedValueNotifiersWithAnd = (...i) => {
     }
   };
 }, createCollabGateway = (i, e, t, n) => {
-  const o = new ValueNotifier(!1), r = createDocumentServiceConnection(
+  const o = createDocumentServiceConnection(
     i,
     t
-  ), c = new NexusStateConsolidator(e), l = [], d = [], u = /* @__PURE__ */ new Set();
+  ), r = new NexusStateConsolidator(e), c = [], l = [], d = /* @__PURE__ */ new Set();
   (async () => {
-    for await (const p of r.receiveNextTransaction)
-      l.push(p);
-  })(), r.connectionOk.subscribe((p) => {
-    o.setValue(!p);
-  });
-  let m = !1;
+    for await (const p of o.receiveNextTransaction)
+      c.push(p);
+  })();
+  const m = new ValueNotifier(!0);
+  o.connectionOk.subscribe((p) => {
+    m.setValue(!p);
+  }, !0);
+  let f = !1;
   return {
-    blocked: o,
+    blocked: m,
     send: (p) => {
-      if (m)
+      if (f)
         throw new Error(
           "tried sending a transaction after gateway was terminated"
         );
-      p = p.clone(), p.id = crypto.randomUUID(), d.push(p), r.sendNextTransaction(p).then((w) => {
-        w !== void 0 && u.add(p.id);
+      p = p.clone(), p.id = crypto.randomUUID(), l.push(p), o.sendNextTransaction(p).then((w) => {
+        w !== void 0 && d.add(p.id);
       });
     },
     synchronize: () => {
-      if (m)
+      if (f)
         return [];
-      l.length > 0;
-      const p = c.consolidate(
-        l,
-        u,
-        d
+      c.length > 0;
+      const p = r.consolidate(
+        c,
+        d,
+        l
       );
-      return l.length = 0, u.clear(), d.length = 0, p;
+      return c.length = 0, d.clear(), l.length = 0, p;
     },
     terminate: async () => {
-      m = !0, await r.terminate(), l.length = 0, u.clear(), d.length = 0, o.terminate(), e.terminate();
+      f = !0, await o.terminate(), c.length = 0, d.clear(), l.length = 0, m.terminate(), e.terminate();
     }
   };
 }, createWasmNexusValidator = async () => {
@@ -1902,11 +1904,11 @@ const createNexusFields = (i, e, t, n) => {
       );
     else {
       const u = l.map(
-        (f, m) => createField(
+        (m, f) => createField(
           i,
           e,
-          c.withAppendedFieldNumber(m),
-          f,
+          c.withAppendedFieldNumber(f),
+          m,
           r
         )
       );
@@ -2053,50 +2055,50 @@ const createNexusFields = (i, e, t, n) => {
     },
     ...(i == null ? void 0 : i.callbacks) ?? {}
   }, o = /* @__PURE__ */ new Map(), r = (u) => {
-    var f;
-    return ((f = e.get(u)) == null ? void 0 : f.entityType) ?? o.get(u);
+    var m;
+    return ((m = e.get(u)) == null ? void 0 : m.entityType) ?? o.get(u);
   }, c = (u) => {
-    const f = createEntity(
+    const m = createEntity(
       r,
       mustUnpackEntity(
         u.entity ?? throw_("received empty create modification")
       )
     );
-    e.set(f.id, f), visitPointers$1(f, (m, p) => {
-      addSourceTarget(t, m, p), n.onStartPointingTo(m, p);
-    }), n.onCreate(f);
+    e.set(m.id, m), visitPointers$1(m, (f, p) => {
+      addSourceTarget(t, f, p), n.onStartPointingTo(f, p);
+    }), n.onCreate(m);
   }, l = (u) => {
-    const f = u.entityId, m = e.get(f) ?? throw_("can't find deleted entity");
-    e.delete(f), visitPointers$1(m, (p, w) => {
+    const m = u.entityId, f = e.get(m) ?? throw_("can't find deleted entity");
+    e.delete(m), visitPointers$1(f, (p, w) => {
       removeSourceTarget(t, p, w), n.onStopPointingTo(p, w);
-    }), n.onDelete(m);
+    }), n.onDelete(f);
   }, d = (u) => {
-    const f = u.field ?? throw_("received update without pointer"), m = NexusLocation.fromPointerMessage(r, f), p = e.get(m.entityId) ?? throw_("can't find updated entity"), w = extractPbUpdateValue(u.value, r);
-    applyUpdate(p, m, w, {
+    const m = u.field ?? throw_("received update without pointer"), f = NexusLocation.fromPointerMessage(r, m), p = e.get(f.entityId) ?? throw_("can't find updated entity"), w = extractPbUpdateValue(u.value, r);
+    applyUpdate(p, f, w, {
       onStopPointingTo: (x, E) => {
         removeSourceTarget(t, x, E) || throw_(), n.onStopPointingTo(x, E);
       },
       onStartPointingTo: (x, E) => {
         addSourceTarget(t, x, E), n.onStartPointingTo(x, E);
       }
-    }), n.onUpdate(m, w);
+    }), n.onUpdate(f, w);
   };
   return {
     entities: e,
     references: t,
     applyModification(u) {
-      const f = u.modification;
-      switch (f.case) {
+      const m = u.modification;
+      switch (m.case) {
         case "create": {
-          c(f.value);
+          c(m.value);
           break;
         }
         case "delete": {
-          l(f.value);
+          l(m.value);
           break;
         }
         case "update": {
-          d(f.value);
+          d(m.value);
           break;
         }
       }
@@ -2104,11 +2106,11 @@ const createNexusFields = (i, e, t, n) => {
     getStats() {
       return {
         entities: e.size,
-        references: t.values().reduce((u, f) => u + f.length, 0)
+        references: t.values().reduce((u, m) => u + m.length, 0)
       };
     },
-    _addEntityTypeForId(u, f) {
-      o.set(u, f);
+    _addEntityTypeForId(u, m) {
+      o.set(u, m);
     }
   };
 }, TerminableBuilder = {
@@ -2297,7 +2299,7 @@ let NexusEventManager = bt;
 const sizeOf = (i) => i.values().reduce((e, t) => e + t.size, 0), getOrDefault = (i, e) => i.get(e) ?? i.set(e, /* @__PURE__ */ new Set()).get(e) ?? throw_(), mockNexusGateway = () => {
   let i = !1, e = !1;
   return {
-    synchronize: () => e ? [] : (e = !0, [new Transaction()]),
+    synchronize: () => e ? "done" : (e = !0, [new Transaction()]),
     send: () => {
       if (i)
         throw new Error("Gateway terminated");
@@ -2767,15 +2769,15 @@ const filterByType = (i, e) => {
   e.forEach((d) => n.set(d.entity.id, d));
   const o = /* @__PURE__ */ new Map(), r = [];
   [...n.values()].forEach(({ entity: d, overwrites: u }) => {
-    const f = entityToConstructorType(d), m = createDefaultEntityMessage(d.entityType);
-    m.id = t.get(d.id) ?? throw_();
-    const p = mapConstructorLocations(f, (w) => {
+    const m = entityToConstructorType(d), f = createDefaultEntityMessage(d.entityType);
+    f.id = t.get(d.id) ?? throw_();
+    const p = mapConstructorLocations(m, (w) => {
       const x = t.get(w.entityId);
-      return x !== void 0 ? (r.push([m.id, x]), new NexusLocation(x, w.entityType, [
+      return x !== void 0 ? (r.push([f.id, x]), new NexusLocation(x, w.entityType, [
         ...w.fieldIndex
       ])) : w;
     });
-    updateEntityMessageWithConstructor(m, p), u !== void 0 && updateEntityMessageWithConstructor(m, u), o.set(m.id, [d.entityType, m]);
+    updateEntityMessageWithConstructor(f, p), u !== void 0 && updateEntityMessageWithConstructor(f, u), o.set(f.id, [d.entityType, f]);
   });
   const c = toposort(r).reverse(), l = [...o.keys()].filter(
     (d) => !c.includes(d)
@@ -3306,12 +3308,16 @@ class NexusDocument {
       resolve: r
     } = Promise.withResolvers(), c = asyncInterval(async () => {
       const u = (s(this, M) ?? throw_()).synchronize();
+      if (u === "done")
+        throw new Error(
+          "Gateway returned 'done' before returning the initial transaction."
+        );
       if (u.length === 0)
         return;
-      const f = u.flatMap((m) => m.modifications).length;
+      const m = u.flatMap((f) => f.modifications).length;
       await this._applyIncomingTransactions(u, {
         _takeTransactionLock: !1
-      }), c.terminate(), r(f > 0);
+      }), c.terminate(), r(m > 0);
     }, s(this, Nt)), l = await o;
     if ((e == null ? void 0 : e.templateTransaction) !== void 0)
       if (l)
@@ -3319,15 +3325,19 @@ class NexusDocument {
           "Could not apply template transaction to document: Project state from backend is not empty."
         );
       else {
-        const u = await e.templateTransaction, f = await this.createTransaction(void 0, !1);
-        u.modifications.forEach((m) => f._addModification(m)), f.send();
+        const u = await e.templateTransaction, m = await this.createTransaction(void 0, !1);
+        u.modifications.forEach((f) => m._addModification(f)), m.send();
       }
     n.release();
     const d = asyncInterval(async (u) => {
       if (u.aborted)
         return;
-      const f = await s(this, S).acquire(), m = (s(this, M) ?? throw_()).synchronize();
-      await this._applyIncomingTransactions(m, { _takeTransactionLock: !1 }), f.release();
+      const m = await s(this, S).acquire(), f = (s(this, M) ?? throw_()).synchronize();
+      if (f === "done") {
+        d.terminate(), m.release();
+        return;
+      }
+      await this._applyIncomingTransactions(f, { _takeTransactionLock: !1 }), m.release();
     }, s(this, Nt));
     g(this, Bt, () => d.terminate());
   }
@@ -3558,8 +3568,19 @@ const DocumentService = {
       kind: MethodKind.Unary
     }
   }
+}, createSyncedDocument = (i, e, t, n) => ({
+  connected: e,
+  createTransaction: () => i.createTransaction(),
+  modify: (o) => i.modify(o),
+  queryEntities: i.queryEntitiesWithoutLock,
+  events: i.events,
+  start: async () => i.takeTransactions({ validator: t, gateway: n }),
+  stop: async () => i.terminate()
+}), createOfflineDocument = async (i) => {
+  const e = (i == null ? void 0 : i.validated) ?? !0 ? await createWasmNexusValidator() : mockNexusValidator(), t = mockNexusGateway(), n = new NexusDocument(), o = new ValueNotifier(!0), r = createSyncedDocument(n, o, e, t);
+  return await r.start(), r;
 }, createOnlineDocument = async (i, e, t) => {
-  var u;
+  var m;
   let n = createWasmNexusValidator();
   const o = await i.projectService.openSession({
     projectName: e
@@ -3568,31 +3589,18 @@ const DocumentService = {
     throw new Error("Couldn't open session", { cause: o });
   const r = createRetryingPromiseClient(
     DocumentService,
-    createAuthorizedKeepaliveTransport({
-      baseUrl: ((u = o.session) == null ? void 0 : u.documentServiceUrl) ?? throw_("backend returned no document service url"),
+    await createAuthorizedKeepaliveTransport({
+      baseUrl: ((m = o.session) == null ? void 0 : m.documentServiceUrl) ?? throw_("backend returned no document service url"),
       useBinaryFormat: !0,
       getToken: t
     })
-  );
-  await n;
-  const c = createCollabGateway(
+  ), c = await n, l = createCollabGateway(
     r,
     await getWasmDocumentState(),
     e
-  ), l = new NexusDocument(), d = new ValueNotifier(!1);
-  return c.blocked.subscribe((f) => d.setValue(!f)), createSyncedDocument(l, d, await n, c);
-}, createOfflineDocument = async (i) => {
-  const e = i ? await createWasmNexusValidator() : mockNexusValidator(), t = mockNexusGateway(), n = new NexusDocument(), o = new ValueNotifier(!0);
-  return createSyncedDocument(n, o, e, t);
-}, createSyncedDocument = (i, e, t, n) => ({
-  connected: e,
-  createTransaction: () => i.createTransaction(),
-  modify: (o) => i.modify(o),
-  queryEntities: i.queryEntitiesWithoutLock,
-  events: i.events,
-  start: async () => i.takeTransactions({ validator: t, gateway: n }),
-  stop: async () => i.terminate()
-}), createAudiotoolClient = async ({
+  ), d = new NexusDocument(), u = new ValueNotifier(!1);
+  return l.blocked.subscribe((f) => u.setValue(!f), !0), createSyncedDocument(d, u, c, l);
+}, createAudiotoolClient = async ({
   authorization: i
 }) => {
   const e = async () => {
@@ -3607,12 +3615,9 @@ const DocumentService = {
   }, t = await createAudiotoolAPI(e);
   return {
     api: t,
-    createSyncedDocument: async (n) => {
-      if (n.mode === "online") {
-        const o = extractProjectName(n.project);
-        return await createOnlineDocument(t, o, e);
-      } else
-        return await createOfflineDocument(n.validated);
+    createSyncedDocument: async ({ project: n }) => {
+      const o = extractProjectName(n);
+      return await createOnlineDocument(t, o, e);
     }
   };
 }, extractProjectName = (i) => {
@@ -3643,8 +3648,8 @@ const DocumentService = {
     };
   const d = r.get("code");
   if (d != null) {
-    const m = r.get("state"), p = localStorage.getItem(n.state);
-    if (m == null || p == null || m !== p)
+    const f = r.get("state"), p = localStorage.getItem(n.state);
+    if (f == null || p == null || f !== p)
       return {
         loggedIn: !1,
         error: toError(
@@ -3693,26 +3698,26 @@ const DocumentService = {
   }
   localStorage.removeItem(n.state);
   const u = await getOrFetchValidToken(n, i);
-  let f;
+  let m;
   if (typeof u == "string") {
-    const m = async () => {
-      if (f == null) {
-        f = (async () => await getOrFetchValidToken(n, i) ?? new Error("User not logged in."))();
-        const w = await f;
-        return f = void 0, w;
+    const f = async () => {
+      if (m == null) {
+        m = (async () => await getOrFetchValidToken(n, i) ?? new Error("User not logged in."))();
+        const w = await m;
+        return m = void 0, w;
       }
-      return await f;
+      return await m;
     };
     let p;
     return {
       loggedIn: !0,
-      getToken: m,
+      getToken: f,
       getUserName: async () => {
         if (p !== void 0)
           return await p;
         const { promise: w, resolve: x } = Promise.withResolvers();
         p = w;
-        const E = await m();
+        const E = await f();
         if (E instanceof Error)
           return x(E), await p;
         const gt = await neverThrowingFetch(
@@ -3782,8 +3787,8 @@ const DocumentService = {
     return;
   let n = !0;
   {
-    const m = localStorage.getItem(i.expiresAt);
-    n = m == null ? !0 : Date.now() >= parseInt(m) - 6e4;
+    const f = localStorage.getItem(i.expiresAt);
+    n = f == null ? !0 : Date.now() >= parseInt(f) - 6e4;
   }
   if (!n)
     return t;
@@ -3807,13 +3812,14 @@ const DocumentService = {
     return new Error(`Error during refresh token request: ${r.name}`, {
       cause: r.message
     });
-  const { error: c, error_description: l, access_token: d, refresh_token: u, expires_in: f } = await r.json();
+  const { error: c, error_description: l, access_token: d, refresh_token: u, expires_in: m } = await r.json();
   return c ? toError(c, l) : (localStorage.setItem(i.accessToken, d), localStorage.setItem(i.refreshToken, u), localStorage.setItem(
     i.expiresAt,
-    (Date.now() + f * 1e3).toString()
+    (Date.now() + m * 1e3).toString()
   ), d);
 };
 export {
   createAudiotoolClient,
+  createOfflineDocument,
   getLoginStatus
 };

package/dist/login-status.d.ts

@@ -1,23 +1,4 @@
 export type LoggedInStatus = {
-    /** The app is authorized to make actions on a user's behalf. */
-    loggedIn: true;
-    /** Simple utility to get the current user display name / user name. The result of this function is cached. */
-    getUserInfo(): Promise<{
-        name: string;
-        displayName: string;
-    } | Error>;
-    /** Log the current user out and reload the page. */
-    logout: () => void;
-    /** Get the current authentication token. Might refresh the token if need be, but most often
-     * just returns the token.
-     */
-    getToken: () => Promise<string | Error>;
-};
-/**
- * The current authentication status of the user in this tab. Either logged in or logged out.
- * To change the authentication status, call login or logout on this object.
- */
-export type LoginStatus = {
     /** The app is authorized to make actions on a user's behalf. */
     loggedIn: true;
     /** Simple utility to get the current user name. The result of this function is cached. */
@@ -28,7 +9,8 @@ export type LoginStatus = {
      * just returns the token.
      */
     getToken: () => Promise<string | Error>;
-} | {
+};
+export type LoggedOutStatus = {
     /** The app is not authorized to make actions on a user's behalf. Call login to authorize.*/
     loggedIn: false;
     /** If an error is the reason the user is logged out, this is set. Otherwise, the user just hasn't logged in yet. */
@@ -36,6 +18,11 @@ export type LoginStatus = {
     /** start the authorization flow by redirecting the user to the login page of audiotool. */
     login: () => Promise<void>;
 };
+/**
+ * The current authentication status of the user in this tab. Either logged in or logged out.
+ * To change the authentication status, call login or logout on this object.
+ */
+export type LoginStatus = LoggedInStatus | LoggedOutStatus;
 /**
  * This function allows to let arbitrary users use your app by letting them login/logout using the audiotool accounts system.
  *

package/dist/synced-document.d.ts

@@ -1,8 +1,11 @@
+import { AudiotoolAPI } from './api/audiotool-api';
+import { NexusGateway } from './document/backend/gateway';
+import { NexusValidator } from './document/backend/validator';
+import { NexusDocument } from './document/document';
 import { NexusEventManager } from './document/event-manager';
 import { EntityQuery } from './document/query/entity';
 import { SafeTransactionBuilder, TransactionBuilder } from './document/transaction-builder';
 import { ValueNotifier } from './utils/observable-notifier-value';
-import { AudiotoolAPI } from './api/audiotool-api';
 
 /**
  * An Audiotool project document that synchronizes in real-time with the backend.
@@ -150,6 +153,26 @@ export type SyncedDocument = {
      **/
     stop: () => Promise<void>;
 };
-/** Create an online document. */
+/** Create a SyncedDocument wrapper from a NexusDocument. */
+export declare const createSyncedDocument: (document: NexusDocument, connected: ValueNotifier<boolean>, validator: NexusValidator, gateway: NexusGateway) => SyncedDocument;
+/** An offline version of a {@link SyncedDocument} - starts out completely empty,
+ * and all changes are discarded on reload/shutdown.
+ *
+ * Doesn't have start/stop methods since no syncing is happening.
+ *
+ * Can be safely thrown away after usage.
+ */
+export type OfflineDocument = Omit<SyncedDocument, "start" | "stop">;
+/**
+ * Create a nexus document that is not synced to the backend; all changes are discarded on reload/shutdown.
+ *
+ * The returned document is ready to be modified immediately and can be thrown away without calling start/stop.
+ *
+ * To create a document that is synced with a state from the backend/DAW, use {@link AudiotoolClient.createSyncedDocument}.
+ * */
+export declare const createOfflineDocument: (opts?: {
+    /** Whether validation is enabled. Turning that off results in fewer transaction errors, but can lead to invalid states. */
+    validated?: boolean;
+}) => Promise<OfflineDocument>;
+/** Create a SyncedDocument wrapper that's connected to the backend. */
 export declare const createOnlineDocument: (api: AudiotoolAPI, projectName: string, getToken: () => Promise<string>) => Promise<SyncedDocument>;
-export declare const createOfflineDocument: (validated: boolean) => Promise<SyncedDocument>;

package/dist/utils/grpc/keepalive-transport.d.ts

@@ -22,7 +22,7 @@ export declare const createAuthorizedKeepaliveTransport: ({ baseUrl, useBinaryFo
     useBinaryFormat: boolean;
     typeRegistry?: IMessageTypeRegistry;
     getToken: () => Promise<string>;
-}) => KeepaliveTransport;
+}) => Promise<KeepaliveTransport>;
 /** Takes the `keepalive` parameter out of `options`, packs it into the
  * keepalive header.
  */

package/dist/utils/platform.d.ts

@@ -0,0 +1,4 @@
+/** True if we're not in bun, deno, or node.js. */
+export declare const runningInBrowser: boolean;
+/** True if we're in node.js */
+export declare const runningInNodeJs: boolean;