Collaboration

Who else is on a record right now, and the sentence that names whoever moved it first.

• RecordPresence(recordId) — a presence topic addressed by any record's id: a ticket, a case, an approval, a lead. Being subscribed IS having the record open, so there is nothing to post and nothing to clean up: the platform adds and removes a seat with the connection, and stamps who sits in it.
• RecordSeat — Who (stamped by the platform; an app cannot write it) and Activity ("viewing", "replying", "assigning", or the app's own word). Never content — what somebody wrote reaches an open page through the row's own rules, not through this topic.
• RecordSeats(id) — the strip for a record's header: each colleague with a lamp, lit while they act and dark while they look. The viewer is left out. RecordSeatsLine(id) folds it into one line for a list row ("Raj is replying").
• MovedFirst(changes) — a [ConcurrencyCheck] refusal, turned into "Ada changed Amount 2 minutes ago" from the facts <Entity>.Changes(id) hands over (field names only, never values). TookFirst(who, at) says the same for an ownership collision ("Ines took this 2 minutes ago").

Use it

// app.osy
use Osysharp.Identity@0;
use Osysharp.Collaboration@0;
use Osysharp.Observability;   // `Changes` — who moved a row

using Osysharp.Collaboration;
using Osysharp.Observability;

// The kit's one question: who sees colleagues on a record (and is seen there). Staff — never a customer.
policy CollaboratesOnRecords => IsStaff;

[ConcurrencyCheck]
entity Case { [MaxLength(40)] string Reference; decimal Amount; security { allow read, update when IsStaff; } }

[Route("/case/{id}")]
component CaseEditor(Guid id) {
  var cases = Case.Where(c => c.Id == id).ToList();
  var message = "";
  action Save(Case c) {
    try { c.Amount = c.Amount + 1; UnitOfWork.Commit(); message = "Saved."; }
    catch (ConflictException e) { message = WhoMovedIt(c.Id) + " — your edit is still here."; }
  }
  render {
    Stack(gap: 3) {
      RecordSeats(id);                                   // who else is here
      if (message != "") { Alert(message, tone: Tone.Warning); }
      foreach (var c in cases) { Button(label: "Add one", onPress: () => Save(c)); }
    }
  }
}

// `Changes` reads the platform's trail, so the sentence is made on the server.
string WhoMovedIt(Guid id) { return MovedFirst(Case.Changes(id)); }

Say what you are doing when it changes — a composer opening, an assign menu:

SeatActivity(ticket.Id, "replying");

What holds whatever the app grants

• Only who the app says. The topic's door is CollaboratesOnRecords; anyone else is refused a seat, and their announcing puts nobody in the set.
• Who is never written by the app. new RecordSeat { Who = … } is refused at compile; the platform stamps the connection's principal.
• A seat carries no words. What is broadcast is who is there and what they are doing, never the content.
• Online is not available. A seat says who is looking. It is not consent to receive work — routing kits read their own explicit availability, never this topic.

Its tests

The kit's test app is a small case desk: presence.test.osy (staff only, who is stamped, an activity and never content), conflicts.test.osy (the refusal through the screen, the sentence from the trail).

Get it

Add the kit to your app’s manifest:

app MyApp {
  use Osysharp.Collaboration@0;
}

Then run osy lock: it downloads the release, verifies it by its content address and pins that version in osyrin.lock. osy kits Osysharp.Collaboration shows what the kit is for, from inside your app.

Reference: osy docs realtime-collaboration-kit.