@ahmedramez-org/nexus-chat 1.0.0-beta.15 → 1.0.0-beta.17

package/contract/conformance.js

@@ -267,8 +267,13 @@ export async function checkHostContract(options, checkOptions = {}) {
         });
         ensure(new Set(kinds).size === kinds.length, 'a context kind is listed twice (a source replaces its bare kind: list only the source).');
     });
-    await checks.run('chat.triggers', 'each trigger is @ or # with a search', () => {
+    await checks.run('chat.triggers', 'each trigger is a bare @ or #, or one with a search', () => {
         const chars = (chat?.triggers ?? []).map((trigger) => {
+            if (typeof trigger === 'string') {
+                ensure(TRIGGER_CHARS.includes(trigger), `unknown trigger ${JSON.stringify(trigger)}; a bare string is one of: ${TRIGGER_CHARS.join(', ')}.`);
+                ensure(connection?.incortaApi?.type === 'bff', `the bare ${trigger} trigger needs a connection.incortaApi of type 'bff'.`);
+                return trigger;
+            }
             ensure(TRIGGER_CHARS.includes(trigger.char), `unknown trigger ${JSON.stringify(trigger.char)}.`);
             ensure(typeof trigger.search === 'function', `the ${trigger.char} trigger has no search().`);
             return trigger.char;

package/contract/index.d.ts

@@ -133,15 +133,18 @@ export interface ValueMatch {
     dataType?: string;
     complete?: boolean;
 }
+/** The composer trigger characters the chat can serve itself. */
+export declare const BUILT_IN_TRIGGERS: readonly ["@", "#"];
+export type BuiltInTrigger = (typeof BUILT_IN_TRIGGERS)[number];
 /**
- * A composer trigger character. Both search inside the one attached business
- * view (`viewId` is that context's `id`); with none or several attached the
- * character stays plain text.
+ * A composer trigger the host serves. Both search inside the one attached
+ * business view (`viewId` is that context's `id`); with none or several
+ * attached the character stays plain text.
  *
  * - `@` mentions a column. Asked once per view; the chat filters as you type.
  * - `#` searches the view's values for the typed text.
  */
-export type TriggerSpec = {
+export type TriggerSource = {
     char: '@';
     search(request: {
         viewId: string;
@@ -154,6 +157,21 @@ export type TriggerSpec = {
         limit: number;
     }, signal: AbortSignal): Promise<readonly ValueMatch[]>;
 };
+/**
+ * One composer trigger; `chat.triggers` lists them.
+ *
+ * - A bare `'@'` or `'#'`: the chat serves it itself through a BFF
+ *   `connection.incortaApi`, across every attached business view and physical
+ *   table. The user can narrow to one view, then one column, and `#` searches
+ *   text columns only. Without a BFF `incortaApi` the character is left out
+ *   with a console warning.
+ * - A `TriggerSource`: the host serves it, for one attached view.
+ *
+ * List each character once. Migrating: code that read `trigger.char` must
+ * narrow with `typeof trigger === 'string'` first. Pass bare characters only
+ * to a chat that has them (this release or later): an older chat ignores them.
+ */
+export type TriggerSpec = BuiltInTrigger | TriggerSource;
 /** Switches for things the chat builds itself. Each one defaults to `true`. */
 export interface NexusChatFeatures {
     /**

package/contract/index.js

@@ -11,6 +11,8 @@ export const BUILT_IN_CONTEXT_KINDS = [
     'ai-container',
     'knowledge-store',
 ];
+/** The composer trigger characters the chat can serve itself. */
+export const BUILT_IN_TRIGGERS = ['@', '#'];
 /**
  * Reads the namespaced-kind convention. Returns null for bare legacy kinds.
  * Framework-free on purpose: hosts use this inside `canRender` to route by

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahmedramez-org/nexus-chat",
-  "version": "1.0.0-beta.15",
+  "version": "1.0.0-beta.17",
   "description": "NexusChat for any app: a connector and React component that load the prebuilt chat from IncortaCopilot (or a pinned copy), and the host contract types and checks.",
   "license": "UNLICENSED",
   "repository": {

package/react.js

@@ -304,7 +304,7 @@ function EmbeddedChat({ embedUrl, modes, defaultMode, theme = 'light', locale })
           ref: frame,
           title: NAME,
           src,
-          allow: 'storage-access; microphone',
+          allow: 'storage-access; microphone; clipboard-write',
           style: { display: 'block', width: '100%', height: '100%', border: 0 },
         }),
     ),

package/window.js

@@ -357,7 +357,7 @@ export function createEmbeddedChat({
     if (embedded || !win.opened) return;
     const iframe = document.createElement('iframe');
     iframe.title = NAME;
-    iframe.allow = 'storage-access; microphone';
+    iframe.allow = 'storage-access; microphone; clipboard-write';
     iframe.src = embedSrc(embedUrl, theme, locale);
     iframe.style.cssText = 'display:block;width:100%;height:100%;border:0';
     win.panel.prepend(iframe);