@opencxh/domain 1.185.0 → 1.187.0

package/dist/platform/notification.d.ts

@@ -0,0 +1,114 @@
+import { LocaleBundle } from '../entities/analytics/dashboard';
+/**
+ * Role group of an app that declares its own notification kinds.
+ *
+ * A constant and not a literal at both ends: `Bridge.providers.list` answers an unknown group
+ * with an empty list, so a typo would read as "no app sends notifications". Same reason
+ * `ONBOARDING_SOURCE_PROVIDER_GROUP` is a constant.
+ */
+export declare const NOTIFICATION_SOURCE_PROVIDER_GROUP = "notification-source";
+/**
+ * Text a reader renders without the sender knowing what it says: an i18n key from the declaring
+ * app's own bundle, plus values for `{name}` placeholders.
+ *
+ * Not a rendered string, because one notification is read on a laptop in Dutch and pushed to a
+ * phone in English. Not a bare key either: half of these lines carry data ("Vincent mentioned you")
+ * and a key per person does not exist.
+ *
+ * Sources write **bare** keys; the hub stamps the namespace (see `qualifyText` in platform-api).
+ */
+export interface NotificationText {
+    key: string;
+    vars?: Record<string, string | number>;
+}
+/**
+ * One switchable kind of notification, declared by the app that sends it.
+ *
+ * Declared rather than listed centrally, because only the owning app knows that "you were
+ * mentioned" and "a task was assigned to you" are different questions to a reader. A hard-coded
+ * list breaks at app N+1 — the map it replaces is `DEFAULT_KIND_ENABLED` in comms' push dispatch.
+ */
+export interface NotificationKindDef {
+    /** Bare in the describe (`"mentioned"`); the hub stamps it to `"communication:mentioned"`. */
+    id: string;
+    title: NotificationText;
+    description?: NotificationText;
+    /** What holds until the user touches a switch. Per transport, because they differ in practice. */
+    defaults: {
+        inApp: boolean;
+        push: boolean;
+    };
+    /** `true` = the user may not switch it off (an incoming call). Absent = they may. */
+    mandatory?: boolean;
+    /** Sort hint within an app. Ties break on id, so the settings screen stays stable. */
+    order?: number;
+}
+/**
+ * Payload of `GET /provider/notification/describe`.
+ *
+ * Bare, not wrapped in `ResponseFactory` — that is how the fan-out reads it, same as
+ * `analytics-source` and `onboarding-source`.
+ */
+export interface NotificationSourceDescribe {
+    /** The declaring app (== manifest name == `req.source.app`). */
+    source: string;
+    kinds: NotificationKindDef[];
+    /** Texts for every key above, in every language this app ships. `flattenLocales()` helps. */
+    locales?: LocaleBundle;
+}
+/** Where clicking a notification takes you. App-relative, like an onboarding route link. */
+export interface NotificationLink {
+    app: string;
+    path: string;
+}
+export interface Notification {
+    id: string;
+    organizationId: string;
+    userId: string;
+    /** The app that sent it. Derived from the caller, never from the body. */
+    source: string;
+    /** Namespaced: `"communication:mentioned"`. */
+    kind: string;
+    title: NotificationText;
+    body?: NotificationText;
+    link?: NotificationLink;
+    /** Free-form; travels untouched into the push payload. */
+    data?: Record<string, unknown>;
+    createdAt: number;
+    readAt?: number;
+}
+/** Body of `POST notification/send`. The only thing that crosses an app boundary. */
+export interface NotifyRequest {
+    to: {
+        userIds: string[];
+    } | {
+        userId: string;
+    };
+    /** Bare; stamped with the calling app's name server-side. */
+    kind: string;
+    title: NotificationText;
+    body?: NotificationText;
+    link?: NotificationLink;
+    data?: Record<string, unknown>;
+    /**
+     * Wake the devices without leaving a row behind. For a signal that is meaningless once it is
+     * over — an incoming call you already missed is not something to catch up on. Default `false`.
+     */
+    transient?: boolean;
+    /** Passed straight to push; a newer envelope with the same key replaces an undelivered one. */
+    collapseKey?: string;
+}
+export interface NotifyResult {
+    /** Rows written. `0` for a transient notification, and for a send nobody had switched on. */
+    created: number;
+}
+/** Result of the kinds fan-out, as the settings screen reads it. */
+export interface NotificationCatalog {
+    kinds: NotificationKindDef[];
+    locales: LocaleBundle;
+    /** Sources that did not answer, so the screen can say who is missing instead of silently thinning. */
+    degradedApps: string[];
+}
+/** Per-device preference keys. Two transports, two keys — see `docs/` and the settings screen. */
+export type NotificationPrefTransport = "inapp" | "push";
+export declare const notificationPrefKey: (transport: NotificationPrefTransport, kind: string) => string;

package/dist/platform/permission.d.ts

@@ -17,7 +17,7 @@ export declare const APP_PERMISSIONS: {
     readonly analytics: readonly ["report.read"];
     readonly "app-store": readonly ["app.publish", "app.read", "app.write", "setting.read", "setting.write"];
     readonly automations: readonly ["sync.read", "sync.write", "webhook.read", "webhook.write"];
-    readonly communication: readonly ["account.read", "account.write", "activity-type.read", "activity.read", "activity.write", "attachment.read", "attribute.read", "attribute.write", "calendar.read", "calendar.write", "channel.read", "channel.write", "custom-field.read", "custom-field.write", "folder.read", "folder.write", "inbox.read", "inbox.write", "interaction.read", "interaction.write", "reminder.read", "task.read", "task.write", "template.read", "template.write", "topic.read", "topic.write"];
+    readonly communication: readonly ["account.read", "account.write", "activity-type.read", "activity.read", "activity.write", "attachment.read", "attribute.read", "attribute.write", "calendar.read", "calendar.write", "channel.read", "channel.write", "custom-field.read", "custom-field.write", "folder.read", "folder.write", "inbox.read", "inbox.write", "interaction.read", "interaction.write", "reminder.read", "template.read", "template.write", "topic.read", "topic.write"];
     readonly context: readonly ["kind.read", "kind.write", "memory.read", "memory.write"];
     readonly crm: readonly ["company.read", "company.write", "contact.read", "contact.write"];
     readonly "eylo-voip": readonly ["account.read", "account.write", "callflow.read", "callflow.write", "channel.read", "channel.write", "contact.read", "contact.write", "device.read", "device.write", "group.read", "group.write", "interaction.read", "interaction.write", "media.read", "media.write", "menu.read", "menu.write", "phone-number.read", "phone-number.write", "recording.read", "recording.write", "sip.read", "temporal-rule.read", "temporal-rule.write", "user.read", "user.write", "vmbox.read", "vmbox.write", "webhook.read", "webhook.write"];

package/dist/platform/push.d.ts

@@ -16,7 +16,13 @@ export interface PushSubscription {
     createdAt: number;
     lastSeenAt: number;
 }
-export type PushKind = "wake" | "incoming-call" | "message" | "presence" | "notification" | "custom";
+/**
+ * The platform's own kinds, plus whatever a `notification-source` app declares
+ * (`"communication:mentioned"`). Open like {@link ExtensionContext}: the closed union kept
+ * autocomplete but made an app-declared kind unexpressible, and per-kind device preferences
+ * are exactly what apps must be able to declare.
+ */
+export type PushKind = "wake" | "incoming-call" | "message" | "presence" | "notification" | "custom" | (string & {});
 export interface PushDisplay {
     title: string;
     body?: string;

package/package.json

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

package/dist/entities/task/index.d.ts

@@ -1 +0,0 @@
-export * from './types';

package/dist/entities/task/types.d.ts

@@ -1,39 +0,0 @@
-import { OwnerScope } from '../scope/types';
-export type TaskStatus = "open" | "in_progress" | "done" | "cancelled";
-export type TaskPriority = "low" | "normal" | "high" | "urgent";
-export type TaskInitiator = "user" | "system";
-export interface TaskSource {
-    initiator: TaskInitiator;
-    /** Free-form reason when initiator is "system" (e.g. "missed_call", "stale_interaction"). */
-    systemReason?: string;
-}
-export interface Task {
-    id: string;
-    organizationId: string;
-    ownerScope: OwnerScope;
-    /** Parent task id when this is a subtask. Subtasks are exactly one level deep. */
-    parentId?: string;
-    title: string;
-    description?: string;
-    status: TaskStatus;
-    priority?: TaskPriority;
-    /** Epoch ms. */
-    dueDate?: number;
-    /** Epoch ms — set when status moves to "done". */
-    completedAt?: number;
-    /** Link to a communication Interaction (follow-up on a call/message). */
-    interactionId?: string;
-    /** Link to a contact. */
-    contactId?: string;
-    /** UserIds assigned to act on this task. Empty = team pool. */
-    assignees?: string[];
-    /** Origin of the task — user-created or system-generated. */
-    source: TaskSource;
-    /** Channel used for external sync (provider-resolved). */
-    channelId?: string;
-    /** Provider-side IDs for dedupe (Google Tasks id, MS To Do id, …). */
-    externalIds?: string[];
-    createdBy: string;
-    createdAt?: number;
-    updatedAt?: number;
-}