@phosphorco/bb-identity 0.3.0 → 0.4.0

package/dist/client-entry-runtime.js

@@ -1584,6 +1584,9 @@ function sameVersion(a, b) {
   return a.status === b.status && version(a).epoch === version(b).epoch && version(a).sequence === version(b).sequence;
 }
 function createIdentityState(options) {
+  return createStateController(options);
+}
+function createStateController(options, editing = false) {
   const address = frozen({ ...options.address });
   const expected = frozen({ ...options.expected });
   const definition = options.definition;
@@ -1617,6 +1620,12 @@ function createIdentityState(options) {
   let closing = false;
   let checkpoint = null;
   let recoverySource = null;
+  let checkpointError = null;
+  let checkpointWriting = 0;
+  let lastRejection = null;
+  let rejectedGeneration = -1;
+  let ownerFenced = false;
+  let loadFailed = false;
   let automaticSuspensions = 0;
   let automaticEpoch = 0;
   let persistQueue = Promise.resolve();
@@ -1632,7 +1641,7 @@ function createIdentityState(options) {
     timer?.();
     timer = null;
   };
-  const draft = () => base === null || desired === null ? null : frozen({ formatVersion: 1, key: { address, actor: expected.actor, ownerSession: options.ownerSession }, schemaVersion: definition.schemaVersion, acknowledged: base, desired: desired.value, localGeneration, inFlight: pending?.mutation ?? null });
+  const draft = () => base === null || desired === null ? null : frozen({ formatVersion: 1, key: { address, actor: expected.actor, ownerSession: options.ownerSession }, schemaVersion: definition.schemaVersion, acknowledged: base, desired: desired.value, localGeneration, inFlight: pending?.mutation ?? null, ...editing ? { rejection: lastRejection, rejectedGeneration } : {} });
   function emit() {
     if (lifecycle === "detached" || lifecycle === "disposed")
       snapshot = { status: "detached", address, draft: draft() };
@@ -1656,6 +1665,8 @@ function createIdentityState(options) {
   function sessionCheck() {
     if (!active())
       return err("disposed", "This state controller is no longer active.");
+    if (editing && ownerFenced)
+      return err("stale-context", "This editing owner was retired.");
     const result = options.currentSession();
     if (!result.ok) {
       block("identity-unavailable", result.error.message);
@@ -1667,6 +1678,8 @@ function createIdentityState(options) {
       return { ok: false, error: session.error };
     }
     if (session.instanceId !== address.instanceId || session.actor.identity.key !== expected.actor || session.stamp !== expected.session) {
+      if (editing)
+        ownerFenced = true;
       block("owner-changed", "The identity session changed.");
       return err("stale-context", "The identity session changed.", "after-refresh");
     }
@@ -1687,11 +1700,23 @@ function createIdentityState(options) {
     const capturedEpoch = epoch;
     const serial = ++persistSerial;
     const work = persistQueue.then(async () => {
+      checkpointWriting++;
+      if (editing)
+        emit();
       const result = await safe(() => drafts.write(captured, checkpoint?.revision ?? null));
-      if (result.ok)
+      checkpointWriting--;
+      if (result.ok) {
         checkpoint = result.value;
-      else if (active(capturedEpoch) && serial === persistSerial)
-        block("storage-error", result.error.message);
+        if (editing)
+          checkpointError = null;
+      } else if (active(capturedEpoch) && serial === persistSerial) {
+        if (editing)
+          checkpointError = result.error;
+        else
+          block("storage-error", result.error.message);
+      }
+      if (editing)
+        emit();
       return result;
     });
     persistQueue = work.then(() => {
@@ -1701,7 +1726,7 @@ function createIdentityState(options) {
   }
   function schedule() {
     clearTimer();
-    if (!active() || automaticSuspensions || closing || blocked || pending || !needsSave())
+    if (editing || !active() || automaticSuspensions || closing || blocked || pending || !needsSave())
       return;
     timer = scheduler.schedule(debounce, () => {
       timer = null;
@@ -1770,7 +1795,7 @@ function createIdentityState(options) {
       return ok(undefined);
     if (base && dirty()) {
       if (sameVersion(base, read)) {
-        if (!blocked?.conflict)
+        if (!blocked?.conflict && (!editing || blocked?.reason !== "rejected"))
           blocked = null;
         emit();
         schedule();
@@ -1780,7 +1805,8 @@ function createIdentityState(options) {
     }
     base = read;
     desired = { value: valueClone(codec, currentValue(read)) };
-    blocked = null;
+    if (!editing || blocked?.reason !== "rejected")
+      blocked = null;
     emit();
     schedule();
     return ok(undefined);
@@ -1806,14 +1832,17 @@ function createIdentityState(options) {
       if (!live.ok)
         return live;
       if (!loaded.ok) {
+        loadFailed = true;
         block("storage-error", loaded.error.message);
         return loaded;
       }
       const parsed = readClone(loaded.value);
       if (!parsed.ok) {
+        loadFailed = true;
         block("storage-error", parsed.error.message);
         return parsed;
       }
+      loadFailed = false;
       return applyRemote(parsed.value, cause);
     })();
     activeLoad = work;
@@ -1827,6 +1856,10 @@ function createIdentityState(options) {
     return work;
   }
   function outcomeCheck(outcome, operationId) {
+    if (editing && outcome.status === "rejected")
+      return outcome.operationId === operationId ? ok(frozen(outcome)) : err("incompatible", "Rejected receipt has another operation.");
+    if (outcome.status === "rejected")
+      return err("incompatible", "Rejection is not a legacy state outcome.");
     const parsed = codecs.save.decode(structuredClone(codecs.save.encode(outcome)));
     if (!parsed.ok)
       return parsed;
@@ -1846,6 +1879,17 @@ function createIdentityState(options) {
     pending = null;
     loadId++;
     blocked = null;
+    if (outcome.status === "rejected") {
+      lastRejection = outcome.evidence;
+      rejectedGeneration = captured.generation;
+      block("rejected", "The submitted edit was definitively rejected.");
+      const saved2 = await persist();
+      return saved2.ok ? err("invalid-input", "The submitted edit was definitively rejected.") : saved2;
+    }
+    if (editing && (outcome.status === "saved" || outcome.status === "unchanged")) {
+      lastRejection = null;
+      rejectedGeneration = -1;
+    }
     if (outcome.status === "saved" || outcome.status === "unchanged") {
       base = { status: "present", envelope: outcome.envelope };
       acknowledgedGeneration = Math.max(acknowledgedGeneration, captured.generation);
@@ -1877,6 +1921,8 @@ function createIdentityState(options) {
         return reload("reconnect");
       schedule();
     }
+    if (editing && snapshot.status === "blocked" && snapshot.reason === "conflict")
+      return err("conflict", snapshot.message);
     return ok(undefined);
   }
   function transmit(captured, automatic = false) {
@@ -1945,7 +1991,9 @@ function createIdentityState(options) {
     const valid = sessionCheck();
     if (!valid.ok)
       return Promise.resolve(valid);
-    if (blocked)
+    if (editing && lastRejection && localGeneration <= rejectedGeneration)
+      return Promise.resolve(err("invalid-input", "Correct the rejected draft before submitting a new operation."));
+    if (blocked && !(editing && blocked.reason === "rejected" && localGeneration > rejectedGeneration))
       return Promise.resolve(err("conflict", blocked.message));
     if (activeSave)
       return activeSave;
@@ -1954,6 +2002,8 @@ function createIdentityState(options) {
     if (!base || !desired || !needsSave())
       return Promise.resolve(ok(undefined));
     const mutation = frozen({ kind: base.status === "empty" ? "initialize" : "replace", address, expectedVersion: { ...version(base) }, expected, ownerSession: options.ownerSession, localGeneration, operationId: newOperationId(), schemaVersion: definition.schemaVersion, value: valueClone(codec, desired.value) });
+    if (editing && blocked?.reason === "rejected")
+      blocked = null;
     pending = { mutation, base, generation: localGeneration };
     return transmit(pending, automatic);
   }
@@ -1978,7 +2028,7 @@ function createIdentityState(options) {
     const valid = sessionCheck();
     if (!valid.ok)
       return valid;
-    const result = await safe(() => options.transport.reconcile({ address, expected, operationId: captured.mutation.operationId }, { signal: abort.signal }));
+    const result = await safe(() => options.transport.reconcile({ address, expected, operationId: captured.mutation.operationId, mutation: captured.mutation }, { signal: abort.signal }));
     if (!active(capturedEpoch) || pending !== captured)
       return err("cancelled", "State reconciliation was superseded.");
     const live = sessionCheck();
@@ -1990,7 +2040,7 @@ function createIdentityState(options) {
     }
     if (result.value.status === "final")
       return applyOutcome(captured, result.value.outcome);
-    if (result.value.status === "absent-final" && allowReplay) {
+    if (result.value.status === "absent-final" && allowReplay && !editing) {
       if (captured.mutation.expected.actor !== expected.actor || captured.mutation.expected.session !== expected.session) {
         block("draft-recovery", "The original operation cannot be re-authored under a new session.");
         return err("stale-context", "The original operation requires its original session.");
@@ -2006,6 +2056,13 @@ function createIdentityState(options) {
     const valid = sessionCheck();
     if (!valid.ok)
       return valid;
+    if (editing) {
+      if (activeSave)
+        return activeSave;
+      if (pending)
+        return reconcile(false);
+      return sendNew();
+    }
     const goal = localGeneration;
     let retries = 0;
     if (activeSave) {
@@ -2059,6 +2116,27 @@ function createIdentityState(options) {
   }
   return {
     getSnapshot: () => snapshot,
+    inspect() {
+      const retained = draft();
+      const checkpointMatches = checkpoint !== null && retained !== null && checkpoint.draft.localGeneration === retained.localGeneration && JSON.stringify(checkpoint.draft.inFlight ? codecs.mutation.encode(checkpoint.draft.inFlight) : null) === JSON.stringify(retained.inFlight ? codecs.mutation.encode(retained.inFlight) : null) && JSON.stringify(checkpoint.draft.rejection ?? null) === JSON.stringify(retained.rejection ?? null) && JSON.stringify(codecs.read.encode(checkpoint.draft.acknowledged)) === JSON.stringify(codecs.read.encode(retained.acknowledged));
+      return {
+        draft: retained,
+        base,
+        desired: desired?.value,
+        generation: localGeneration,
+        pending: pending?.mutation ?? null,
+        saving: networkActive,
+        dirty: dirty(),
+        saveEligible: needsSave() && (!lastRejection || localGeneration > rejectedGeneration),
+        editable: active() && !closing && !ownerFenced && !loadFailed && base !== null && desired !== null && (!blocked || ["conflict", "indeterminate", "rejected", "draft-recovery"].includes(blocked.reason)),
+        checkpoint: {
+          status: !drafts ? "disabled" : checkpointWriting ? "writing" : checkpointError ? "failed" : checkpointMatches ? "backed-up" : "local-only",
+          generation: checkpoint?.draft.localGeneration ?? null,
+          revision: checkpoint?.revision ?? null,
+          error: checkpointError
+        }
+      };
+    },
     subscribe(listener) {
       if (lifecycle === "disposed")
         return () => {};
@@ -2094,7 +2172,7 @@ function createIdentityState(options) {
       const valid = sessionCheck();
       if (!valid.ok)
         return valid;
-      if (closing || blocked || snapshot.status !== "ready")
+      if (closing || (editing ? ownerFenced || loadFailed || !base || !desired || !!blocked && !["conflict", "indeterminate", "rejected", "draft-recovery"].includes(blocked.reason) : blocked || snapshot.status !== "ready"))
         return err("unavailable", "State is not editable.");
       try {
         desired = { value: valueClone(codec, value) };
@@ -2102,6 +2180,8 @@ function createIdentityState(options) {
         return err("invalid-input", error instanceof Error ? error.message : "Invalid state.");
       }
       localGeneration++;
+      if (editing && blocked?.conflict)
+        blocked = { ...blocked, conflict: frozen({ ...blocked.conflict, token: newConflictToken(), local: desired.value }) };
       emit();
       schedule();
       return ok(undefined);
@@ -2170,6 +2250,10 @@ function createIdentityState(options) {
           return err("invalid-input", "Draft operation does not match its owner or generation.");
         mutation = frozen(result.value);
       }
+      if (editing) {
+        lastRejection = source.rejection ?? null;
+        rejectedGeneration = source.rejectedGeneration ?? -1;
+      }
       clearTimer();
       base = parsed.value;
       desired = { value: valueClone(codec, source.desired) };
@@ -2345,6 +2429,35 @@ function createStateTransport(options) {
 // client-state-binding-runtime.ts
 var waiting = Object.freeze({ status: "waiting-for-identity" });
 function bindIdentityState(options, retirementOwner) {
+  return bindOwnedIdentityController({
+    ...options,
+    hasPending: (state) => state.status === "ready" ? state.dirty || state.saving : (state.status === "blocked" || state.status === "detached") && state.draft !== null,
+    create: (input) => options.create ? options.create(input) : createIdentityState({
+      address: {
+        instanceId: input.session.instanceId,
+        pluginId: options.resource.pluginId,
+        collection: options.resource.definition.collection,
+        recordId: options.recordId,
+        owner: input.subject.key
+      },
+      expected: { actor: input.session.actor.identity.key, session: input.session.stamp },
+      ownerSession: input.ownerSession,
+      definition: options.resource.definition,
+      transport: createStateTransport({ connection: options.client.connection, resource: options.resource }),
+      ...options.drafts ? { drafts: options.drafts } : {},
+      onConflict: options.onConflict,
+      initializeEmpty: options.initializeEmpty && (options.editPolicy === "collaborators" || input.subject.key === input.session.actor.identity.key),
+      ...options.scheduler ? { scheduler: options.scheduler } : {},
+      currentSession: () => options.client.currentSession()
+    }),
+    preservation: (controller, session) => options.resource && options.drafts ? { storage: options.drafts, scope: {
+      address: controller.getSnapshot().address,
+      actor: session.actor.identity.key,
+      schemaVersion: options.resource.definition.schemaVersion
+    } } : null
+  }, retirementOwner);
+}
+function bindOwnedIdentityController(options, retirementOwner) {
   let disposed = false;
   let viewDisposed = false;
   let current = null;
@@ -2360,7 +2473,7 @@ function bindIdentityState(options, retirementOwner) {
       } catch {}
     }
   };
-  const hasPending = (state) => state.status === "ready" ? state.dirty || state.saving : (state.status === "blocked" || state.status === "detached") && state.draft !== null;
+  const hasPending = options.hasPending;
   const live = () => {
     if (disposed || viewDisposed)
       return null;
@@ -2454,34 +2567,13 @@ function bindIdentityState(options, retirementOwner) {
         const owner = idCodec("owner-session").decode(`owner-${newOperationId()}`);
         if (!owner.ok)
           throw new Error(owner.error.message);
-        const controller = options.create ? options.create({ session: next.session, subject: next.subject, ownerSession: owner.value }) : createIdentityState({
-          address: {
-            instanceId: next.session.instanceId,
-            pluginId: options.resource.pluginId,
-            collection: options.resource.definition.collection,
-            recordId: options.recordId,
-            owner: next.subject.key
-          },
-          expected: { actor: next.session.actor.identity.key, session: next.session.stamp },
-          ownerSession: owner.value,
-          definition: options.resource.definition,
-          transport: createStateTransport({ connection: options.client.connection, resource: options.resource }),
-          ...options.drafts ? { drafts: options.drafts } : {},
-          onConflict: options.onConflict,
-          initializeEmpty: next.writable && options.initializeEmpty,
-          ...options.scheduler ? { scheduler: options.scheduler } : {},
-          currentSession: () => options.client.currentSession()
-        });
+        const controller = options.create({ session: next.session, subject: next.subject, ownerSession: owner.value });
         if (live()?.key !== next.key) {
           controller.dispose();
           observeAgain = true;
           continue;
         }
-        const preservation = options.resource && options.drafts ? { storage: options.drafts, scope: {
-          address: controller.getSnapshot().address,
-          actor: next.session.actor.identity.key,
-          schemaVersion: options.resource.definition.schemaVersion
-        } } : null;
+        const preservation = options.preservation?.(controller, next.session) ?? null;
         const entry = { key: next.key, recoveryKey: JSON.stringify([next.session.instanceId, next.session.actor.identity.key, next.subject.key]), owner: owner.value, controller, stop: () => {}, writable: next.writable, reconnect: null, preservation };
         current = entry;
         const update = () => {
@@ -2573,7 +2665,7 @@ function bindIdentityState(options, retirementOwner) {
           if (!valid(entry) || transition.signal.aborted)
             return err("stale-context", "View transition expired.");
           pause = token;
-          resume = entry.controller.suspendAutomaticDispatch();
+          resume = entry.controller.suspendAutomaticDispatch?.() ?? (() => {});
           if (transition.pending === "block" && hasPending(entry.controller.getSnapshot()))
             return err("conflict", "New edits arrived before the view transition.");
           const result = transition.pending === "flush" ? await entry.controller.flush() : transition.pending === "preserve" ? await entry.controller.checkpoint() : ok(undefined);