@opencxh/domain 1.152.0 → 1.154.0

package/dist/platform/presence.d.ts

@@ -9,7 +9,8 @@
 export declare const PRESENCE_ONLINE_WINDOW_MS = 90000;
 /**
  * Effective presence status. `offline` is derived from connectivity (stale
- * `lastSeenAt`) and always wins; the rest are set by the user or a provider.
+ * `lastSeenAt`) and wins over anything you set — except the statuses in
+ * {@link PRESENCE_SURVIVES_OFFLINE}; the rest are set by the user or a provider.
  */
 export type PresenceStatus = "available" | "away" | "busy" | "dnd" | "out_of_office" | "offline";
 /** Statuses a user (or provider) can set — `offline` is derived, not settable. */
@@ -43,3 +44,56 @@ export interface PresenceStatusInput {
     /** Unix ms after which the status auto-clears (falls back to derived). */
     expiresAt?: number;
 }
+/**
+ * A user's stored availability, as the server persists it. Connectivity is not
+ * in here — that stays derived from `lastSeenAt` on an installation.
+ */
+export interface StoredPresenceStatus {
+    status?: string;
+    message?: string;
+    /** Unix ms after which the status no longer applies. */
+    expiresAt?: number;
+    /** `"manual"` or a providerId (e.g. `"microsoft"`). */
+    source?: string;
+}
+/**
+ * Statuses that mean "I am not at my desk" rather than "I am here, in this
+ * state". Those two behave differently when connectivity goes stale: `busy`
+ * describes right now, so a closed laptop makes it meaningless and `offline` is
+ * the more honest answer. `out_of_office` is a statement about a period, and it
+ * is at its most useful precisely when the person is *not* reachable — so it
+ * outlives the connection instead of being overwritten by it.
+ */
+export declare const PRESENCE_SURVIVES_OFFLINE: readonly PresenceStatus[];
+/**
+ * The one place that turns "when was this user last seen" plus "what did they
+ * set" into an effective presence. Every read (the tenant list, your own row)
+ * and every broadcast goes through it, so the dot never depends on which route
+ * answered.
+ *
+ * `online` is connectivity and nothing else — call routing leans on it. The
+ * status layers on top: an expired one falls back, and a stale connection turns
+ * the rest into `offline` unless it survives (see
+ * {@link PRESENCE_SURVIVES_OFFLINE}). The message travels with the status it
+ * belongs to, so it disappears together with it.
+ */
+export declare function derivePresence(lastSeenAt: number, stored: StoredPresenceStatus | undefined, now: number): {
+    online: boolean;
+    status: PresenceStatus;
+    message?: string;
+};
+/** The shape a client holds per user; the stored status is already folded in. */
+export interface AgeablePresence {
+    lastSeenAt: number;
+    online: boolean;
+    status: PresenceStatus;
+}
+/**
+ * Age a client-held entry: peers who go silent expire without a round-trip.
+ *
+ * Clients only have the *effective* status, not the stored row, so this is the
+ * connectivity half of {@link derivePresence} — same rule about what survives.
+ * Returns the entry unchanged when nothing moved, so a re-render only happens
+ * on a real transition.
+ */
+export declare function agePresenceEntry<T extends AgeablePresence>(entry: T, now: number): T;

package/dist/platform/presence.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/platform/provider.d.ts

@@ -181,6 +181,20 @@ export interface ListFilesPayload {
     mountId?: string;
     path?: string;
 }
+/**
+ * Kijken over mappen heen in plaats van in één map (`POST storage/file/browse`).
+ *
+ * Geen `mountId` en geen `path`: de vraag is juist "waar dan ook waar ik mag
+ * kijken". De server bepaalt zelf welke mappen dat zijn — zie `readableMounts`.
+ */
+export interface BrowseFilesPayload {
+    /** Vrije tekst op de bestandsnaam; hoofdletterongevoelig, deelreeks. */
+    name?: string;
+    /** `mine` beperkt tot wat je zelf hebt toegevoegd; standaard alles. */
+    scope?: "all" | "mine";
+    /** Plafond op het aantal rijen; de server kapt hem af op zijn eigen maximum. */
+    limit?: number;
+}
 export interface DownloadAttachmentPayload {
     attachmentId: string;
     accountId?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencxh/domain",
-  "version": "1.152.0",
+  "version": "1.154.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",