@opencxh/domain 1.162.0 → 1.164.0

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

@@ -0,0 +1,94 @@
+/**
+ * Aanwijsbare resources, over app-grenzen heen.
+ *
+ * Eén vraag die in dit platform steeds terugkwam en tot nu toe per geval werd opgelost: *welke
+ * dingen kan ik hier aanwijzen, en hoe heten ze?* Een werkitem koppelen aan een gesprek, een
+ * `resource_ref`-veld invullen, straks een bestand aanhaken — drie keer dezelfde vraag aan drie
+ * verschillende apps.
+ *
+ * Het antwoord is een **contract op de servicebus**, niet een HTTP-providerrol: beide vragen
+ * worden op de client gesteld door een gebruiker die de bron-app toch al open heeft, en die app
+ * heeft zijn gesprekken en bedrijven al in een store staan. Een providerrol zou daar een
+ * round-trip van maken voor gegevens die in het geheugen liggen.
+ *
+ * Drie sleutels, alle drie via `sdk.services.execute` (die de antwoorden van elke geïnstalleerde
+ * app als array teruggeeft):
+ *
+ * | Sleutel | Params | Antwoord |
+ * |---|---|---|
+ * | `resources.describe` | — | {@link ResourceSourceDescribe} |
+ * | `resources.search` | {@link ResourceSearchParams} | {@link ResourceSummary}`[]` |
+ * | `resources.resolve` | {@link ResourceResolveParams} | {@link ResourceSummary}`[]` |
+ *
+ * `describe` is niet cosmetisch: een kiezer tekent zijn soort-filters uit wat er daadwerkelijk
+ * antwoordt. Zonder die call zou hij een vaste lijst tonen met tabbladen die leeg blijven zodra
+ * een app niet geïnstalleerd is — precies de per-provider aanname die dit contract vermijdt.
+ */
+/** De servicebus-sleutels, als constante zodat een typefout niet stil een lege lijst oplevert. */
+export declare const RESOURCE_DESCRIBE_SERVICE = "resources.describe";
+export declare const RESOURCE_SEARCH_SERVICE = "resources.search";
+export declare const RESOURCE_RESOLVE_SERVICE = "resources.resolve";
+/** Eén aanwijsbare resource, zoals de app die hem bezit hem toont. */
+export interface ResourceSummary {
+    /**
+     * `<kind>:<ref>` — dezelfde vorm die `ScopeAuth` autoriseert en `WorkLink.toKey` draagt.
+     *
+     * Dit is de identiteit: twee aanbieders die dezelfde resource kennen (comms federeert
+     * adresboeken, crm heeft eigen contacten) leveren dezelfde sleutel, en een consument
+     * ontdubbelt daarop.
+     */
+    scopeKey: string;
+    /** Het voorvoegsel van {@link ResourceSummary.scopeKey}, apart zodat filteren geen split vraagt. */
+    kind: string;
+    title: string;
+    /** Tweede regel: afzender, e-mailadres, bedrijfsnaam, statuslabel. */
+    subtitle?: string;
+    /** Lucide-icoonnaam, zoals `TimeTarget.icon`. Afwezig = de consument kiest er zelf één bij de soort. */
+    icon?: string;
+    /**
+     * Pad binnen de shell om deze resource te openen.
+     *
+     * Afwezig = de regel is niet aanklikbaar. Dat is bewust een aparte staat en geen gok: een
+     * verzonnen pad levert een doodlopende navigatie op, en dat is erger dan geen link.
+     */
+    href?: string;
+    /** Sorteerhint; recenter staat hoger. Afwezig telt als oudst. */
+    updatedAt?: number;
+    /**
+     * Andere scopeKeys die bij deze resource horen — het contact en het bedrijf achter een
+     * gesprek, de klant achter een zaak.
+     *
+     * **De bron zegt het, de consument raadt het niet.** Comms weet dat een interactie
+     * `partyKeys` heeft; `apps/work` weet dat niet en hoort dat ook niet te weten. Zonder dit
+     * veld zou "neem het contact mee" in de koppel-flow een `if (kind === "interaction")` met
+     * een comms-specifieke veldnaam worden, en dat breekt bij de volgende aanbieder.
+     *
+     * Alleen één hop, en alleen wat de bron zelf al in handen heeft: dit is een hint voor een
+     * kiezer, geen graaf.
+     */
+    related?: string[];
+}
+/** Antwoord op `resources.describe`: welke soorten deze app kan zoeken en oplossen. */
+export interface ResourceSourceDescribe {
+    kinds: string[];
+}
+/** Params voor `resources.search`. */
+export interface ResourceSearchParams {
+    /** Vrije tekst. Leeg = "wat is er recent", niet "alles". */
+    query: string;
+    /** Beperk tot deze soorten. Leeg/afwezig = alles wat de aanbieder heeft. */
+    kinds?: string[];
+    /** Maximum per aanbieder, niet in totaal — de consument kapt zelf af na het ontdubbelen. */
+    limit?: number;
+}
+/** Params voor `resources.resolve`: van sleutel naar leesbare rij. */
+export interface ResourceResolveParams {
+    scopeKeys: string[];
+}
+/**
+ * De soort uit een scopeKey, zonder de rest te hoeven splitsen.
+ *
+ * Losse helper en geen `splitScopeKey`-hergebruik: die zit in `platform-api` (server), en dit
+ * contract wordt vooral op de client gelezen.
+ */
+export declare function resourceKindOf(scopeKey: string): string;

package/dist/platform/sdk.d.ts

@@ -32,6 +32,20 @@ export interface InternalSDK<LocalServices extends ServiceMap = {}, TranslationK
          * that does not exist.
          */
         navigateAbsolute(path: string, options?: any): void;
+        /**
+         * Terug naar de vorige pagina — de echte, inclusief die van een andere app.
+         *
+         * Waarom dit hier hoort en niet per app: elk detailscherm heeft een terugknop, en zonder
+         * gedeelde vorm wordt dat overal een vaste route ("terug" = altijd de lijst) die liegt zodra
+         * je van een bord of uit een gesprek komt.
+         *
+         * `fallback` is app-relatief, net als {@link navigate}, en geldt alleen als er geen vorige
+         * pagina ín deze sessie is — dat is precies het geval bij een koud geopende deeplink. Geef je
+         * er geen, dan gebeurt er niets: uit het product lopen is geen taak van een terugknop.
+         */
+        back(fallback?: string): void;
+        /** Is er een vorige pagina in deze sessie? Voor een knop die zichzelf wil verbergen. */
+        canGoBack(): boolean;
         currentPath(): string;
         path$: Observable<string>;
     };

package/package.json

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