@opencxh/domain 1.222.0 → 1.224.0

package/dist/platform/resource-source.d.ts

@@ -161,6 +161,30 @@ export interface Relation {
     createdBy: string;
     createdAt?: number;
 }
+/**
+ * One resource a single person keeps in reach, stored by apps/context.
+ *
+ * **Private by construction.** `userId` comes from the session, never from the body, so a pin is
+ * not an org-wide fact about the resource — which is exactly why it is not a {@link Relation}:
+ * relations are merged into `/resource/related` and would surface everyone's pins in a customer
+ * file. Nothing reads another user's pins.
+ *
+ * `label` and `icon` are **snapshots**, used cold: a pinned conversation from three months ago is
+ * not in any list the screen loaded, so without them the row has no name. Whoever renders it
+ * lets the live value win when the resource is at hand.
+ */
+export interface Pin {
+    id: string;
+    organizationId: string;
+    userId: string;
+    /** `<kind>:<ref>` — the same key vocabulary as {@link ResourceSummary} and {@link Relation}. */
+    scopeKey: string;
+    /** Title snapshot. See the note above. */
+    label: string;
+    /** Icon hint the owning app understands (comms stores the channel scheme). */
+    icon?: string;
+    createdAt?: number;
+}
 /**
  * What the hub asks one app. `scopeKey` is already authorized — the answering app must not
  * re-gate it, but it must filter its own rows for the stamped acting identity.

package/package.json

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