@fiodos/web-core 0.1.12 → 0.1.15

package/dist/cjs/embed/dynamics.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeDynamicsId = normalizeDynamicsId;
+exports.dynamicsFormSnapshot = dynamicsFormSnapshot;
+exports.connectDynamicsFormContext = connectDynamicsFormContext;
+// ── Value normalization ──────────────────────────────────────────────────────
+const MAX_VALUE_CHARS = 120;
+function clip(text) {
+    const t = text.trim();
+    return t.length > MAX_VALUE_CHARS ? `${t.slice(0, MAX_VALUE_CHARS - 1)}…` : t;
+}
+/** Lookup values arrive as [{ id, name, entityType }] — show the names. */
+function lookupNames(value) {
+    const names = value
+        .map((v) => v && typeof v === 'object' && typeof v.name === 'string'
+        ? (v.name)
+        : null)
+        .filter((n) => !!n);
+    return names.length ? names.join(', ') : null;
+}
+function normalizeAttributeValue(attribute) {
+    // Optionset / lookup / boolean attributes carry a human label — prefer it.
+    try {
+        const text = attribute.getText?.();
+        if (typeof text === 'string' && text.trim())
+            return clip(text);
+        if (Array.isArray(text) && text.length)
+            return clip(text.join(', '));
+    }
+    catch {
+        /* some attribute types throw on getText — fall through to raw value */
+    }
+    let value;
+    try {
+        value = attribute.getValue();
+    }
+    catch {
+        return null;
+    }
+    if (value == null)
+        return null;
+    if (typeof value === 'string')
+        return value.trim() ? clip(value) : null;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return value;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Array.isArray(value)) {
+        const names = lookupNames(value);
+        return names ? clip(names) : null;
+    }
+    return null; // collections / unknown object shapes are skipped, never guessed
+}
+/** "{1D2C…}" → "1d2c…" (Web API URLs want bare lowercase GUIDs). */
+function normalizeDynamicsId(rawId) {
+    return rawId.replace(/[{}]/g, '').trim().toLowerCase();
+}
+// ── Snapshot builder ─────────────────────────────────────────────────────────
+/**
+ * Builds the AgentScreenSnapshot for the current form state, or null when
+ * there is nothing referenceable yet (create form: no record id).
+ */
+function dynamicsFormSnapshot(formContext, options = {}) {
+    const entity = formContext.data?.entity;
+    if (!entity)
+        return null;
+    const entityName = entity.getEntityName();
+    const recordId = normalizeDynamicsId(entity.getId() ?? '');
+    const allowlist = options.attributes?.length
+        ? new Set(options.attributes.map((a) => a.trim().toLowerCase()).filter(Boolean))
+        : null;
+    const maxAttributes = options.maxAttributes ?? 12;
+    const fields = {};
+    let count = 0;
+    entity.attributes?.forEach((attribute) => {
+        let name;
+        try {
+            name = attribute.getName();
+        }
+        catch {
+            return;
+        }
+        if (!name)
+            return;
+        if (allowlist) {
+            if (!allowlist.has(name.toLowerCase()))
+                return;
+        }
+        else if (count >= maxAttributes) {
+            return;
+        }
+        const value = normalizeAttributeValue(attribute);
+        if (value == null)
+            return;
+        fields[name] = value;
+        count += 1;
+    });
+    let title;
+    try {
+        title = entity.getPrimaryAttributeValue?.() ?? undefined;
+    }
+    catch {
+        title = undefined;
+    }
+    // Create forms have no id yet: the agent can still SEE the fields, but there
+    // is no target for execute actions, so we publish text-only context.
+    const item = recordId
+        ? { id: recordId, kind: entityName, title, metadata: fields }
+        : null;
+    const fieldSummary = Object.entries(fields)
+        .map(([k, v]) => `${k}: ${v}`)
+        .join('; ');
+    const textParts = [
+        `Dynamics 365 form — entity "${entityName}"`,
+        recordId ? `record "${title ?? recordId}" (id ${recordId})` : 'new record (not saved yet)',
+    ];
+    if (fieldSummary)
+        textParts.push(`Fields: ${fieldSummary}`);
+    const context = {
+        ...(item ? { visibleContent: { items: [item], focusedIndex: 0 } } : {}),
+        custom: {
+            platform: 'dynamics365',
+            entityName,
+            ...(recordId ? { recordId } : {}),
+            ...(typeof formContext.ui?.getFormType === 'function'
+                ? { formType: formContext.ui.getFormType() }
+                : {}),
+        },
+    };
+    return { kind: `dynamics-form:${entityName}`, text: textParts.join('. '), context };
+}
+/**
+ * Publishes the form snapshot now, republishes after every save (when the
+ * form exposes OnPostSave), and clears the context on disconnect. Call it from
+ * the form's OnLoad handler.
+ */
+function connectDynamicsFormContext(agent, formContext, options = {}) {
+    let disconnected = false;
+    const publish = () => {
+        if (disconnected)
+            return;
+        const snapshot = dynamicsFormSnapshot(formContext, options);
+        if (snapshot)
+            agent.setScreenContext(snapshot);
+        else
+            agent.clearScreenContext();
+    };
+    publish();
+    const entity = formContext.data?.entity;
+    if (entity?.addOnPostSave) {
+        try {
+            entity.addOnPostSave(publish);
+        }
+        catch {
+            /* older clients — the host can still call refresh() manually */
+        }
+    }
+    return {
+        refresh: publish,
+        disconnect() {
+            if (disconnected)
+                return;
+            disconnected = true;
+            try {
+                entity?.removeOnPostSave?.(publish);
+            }
+            catch {
+                /* best-effort unsubscribe */
+            }
+            agent.clearScreenContext();
+        },
+    };
+}

package/dist/cjs/embed/global.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Embed entrypoint — single-file IIFE bundle for CLOSED third-party hosts
+ * where npm/ESM is not available: Dynamics 365 web resources, WinCC Unified
+ * Custom Web Controls, Salesforce LWC iframes, plain <script> tags.
+ *
+ * Built by `npm run build:embed` into dist/embed/fiodos-embed.js and exposed
+ * as the `Fiodos` global:
+ *
+ *   <script src="fiodos-embed.js"></script>
+ *   <script>
+ *     const agent = Fiodos.createFiodosAgent({
+ *       manifest,                                   // e.g. from `fiodos from-odata`
+ *       registries: Fiodos.buildApiActionRegistries(manifest, {
+ *         baseUrl: 'https://org.crm.dynamics.com/api/data/v9.2',
+ *         authProviders: { dataverse: () => ({ Authorization: `Bearer ${token}` }) },
+ *       }),
+ *     });
+ *   </script>
+ *
+ * The bundle is self-contained (core + web-core inlined) and side-effect-free
+ * beyond assigning the global — it never auto-mounts; the host decides when.
+ */
+import { createFiodosAgent } from '../dropin/createFiodosAgent';
+import { mountOrb } from '../orb/mountOrb';
+import { AgentController } from '../controller/AgentController';
+import { createScreenContextStore } from '../context/screenContextStore';
+import { connectDynamicsFormContext, dynamicsFormSnapshot, normalizeDynamicsId } from './dynamics';
+import { buildApiActionRegistries, validateManifest } from '@fiodos/core';
+declare const api: {
+    readonly version: "0.1.15";
+    readonly createFiodosAgent: typeof createFiodosAgent;
+    readonly mountOrb: typeof mountOrb;
+    readonly AgentController: typeof AgentController;
+    readonly createScreenContextStore: typeof createScreenContextStore;
+    readonly buildApiActionRegistries: typeof buildApiActionRegistries;
+    readonly validateManifest: typeof validateManifest;
+    readonly connectDynamicsFormContext: typeof connectDynamicsFormContext;
+    readonly dynamicsFormSnapshot: typeof dynamicsFormSnapshot;
+    readonly normalizeDynamicsId: typeof normalizeDynamicsId;
+};
+declare global {
+    var Fiodos: typeof api | undefined;
+}
+export type FiodosEmbedApi = typeof api;
+export {};

package/dist/cjs/embed/global.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Embed entrypoint — single-file IIFE bundle for CLOSED third-party hosts
+ * where npm/ESM is not available: Dynamics 365 web resources, WinCC Unified
+ * Custom Web Controls, Salesforce LWC iframes, plain <script> tags.
+ *
+ * Built by `npm run build:embed` into dist/embed/fiodos-embed.js and exposed
+ * as the `Fiodos` global:
+ *
+ *   <script src="fiodos-embed.js"></script>
+ *   <script>
+ *     const agent = Fiodos.createFiodosAgent({
+ *       manifest,                                   // e.g. from `fiodos from-odata`
+ *       registries: Fiodos.buildApiActionRegistries(manifest, {
+ *         baseUrl: 'https://org.crm.dynamics.com/api/data/v9.2',
+ *         authProviders: { dataverse: () => ({ Authorization: `Bearer ${token}` }) },
+ *       }),
+ *     });
+ *   </script>
+ *
+ * The bundle is self-contained (core + web-core inlined) and side-effect-free
+ * beyond assigning the global — it never auto-mounts; the host decides when.
+ */
+const createFiodosAgent_1 = require("../dropin/createFiodosAgent");
+const mountOrb_1 = require("../orb/mountOrb");
+const AgentController_1 = require("../controller/AgentController");
+const screenContextStore_1 = require("../context/screenContextStore");
+const dynamics_1 = require("./dynamics");
+const version_1 = require("../version");
+const core_1 = require("@fiodos/core");
+const api = {
+    version: version_1.SDK_VERSION,
+    createFiodosAgent: createFiodosAgent_1.createFiodosAgent,
+    mountOrb: mountOrb_1.mountOrb,
+    AgentController: AgentController_1.AgentController,
+    createScreenContextStore: screenContextStore_1.createScreenContextStore,
+    // Closed-software mode: turn ApiExecutionSpec manifests into live handlers,
+    // and validate hand-written / from-odata manifests before mounting.
+    buildApiActionRegistries: core_1.buildApiActionRegistries,
+    validateManifest: core_1.validateManifest,
+    // Context bridges: tell the orb what the host is showing. Dynamics gets a
+    // dedicated mapper (formContext); any other host calls agent.setScreenContext.
+    connectDynamicsFormContext: dynamics_1.connectDynamicsFormContext,
+    dynamicsFormSnapshot: dynamics_1.dynamicsFormSnapshot,
+    normalizeDynamicsId: dynamics_1.normalizeDynamicsId,
+};
+globalThis.Fiodos = api;

package/dist/cjs/index.d.ts

@@ -26,6 +26,7 @@ export { createWebNavigationAdapter, BACK_ROUTE, } from './adapters/webNavigatio
 export type { WebNavigationAdapter, WebNavigationAdapterOptions, } from './adapters/webNavigationAdapter';
 export { createWebVoiceAdapter } from './adapters/webVoiceAdapter';
 export type { WebVoiceAdapterOptions } from './adapters/webVoiceAdapter';
+export { createWebCredentialAutofillAdapter } from './adapters/webCredentialAutofillAdapter';
 export { createFiodosBackendClient, buildManifestPayload } from './api/backendClient';
 export type { FiodosBackendClientOptions } from './api/backendClient';
 export { createFiodosTelemetry } from './api/backendTelemetry';
@@ -36,6 +37,8 @@ export { createBridge } from './bridge/createBridge';
 export type { Bridge } from './bridge/createBridge';
 export { createScreenContextStore } from './context/screenContextStore';
 export type { ScreenContextStore, AgentScreenSnapshot } from './context/screenContextStore';
+export { connectDynamicsFormContext, dynamicsFormSnapshot, normalizeDynamicsId, } from './embed/dynamics';
+export type { DynamicsFormContextLike, DynamicsSnapshotOptions, DynamicsContextBridge, ScreenContextSink, } from './embed/dynamics';
 export { createSpeechSession } from './speech/speechSession';
 export type { SpeechSession, SpeechSessionOptions, SpeechSessionState, SpeechSessionSnapshot, } from './speech/speechSession';
 export { DEFAULT_AGENT_TIMINGS, DEFAULT_AGENT_CHAINING } from './config/types';

package/dist/cjs/index.js

@@ -9,7 +9,7 @@
  * behaviour and security. No framework imports live here.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.classifyPendingReply = exports.decideAction = exports.resolveUiMessages = exports.DEFAULT_AGENT_CHAINING = exports.DEFAULT_AGENT_TIMINGS = exports.createSpeechSession = exports.createScreenContextStore = exports.createBridge = exports.isAgentApiError = exports.AgentApiError = exports.createFiodosTelemetry = exports.buildManifestPayload = exports.createFiodosBackendClient = exports.createWebVoiceAdapter = exports.BACK_ROUTE = exports.createWebNavigationAdapter = exports.createWebStorageAdapter = exports.watchPublishedConfig = exports.DEFAULT_ORB_APPEARANCE = exports.buildKeyboardChip = exports.createOrbVisual = exports.mountOrb = exports.sendOrbSeen = exports.fetchClientManifest = exports.DEFAULT_WEB_API_URL = exports.createFiodosAgent = exports.AgentController = exports.SDK_PACKAGE = exports.SDK_VERSION = void 0;
+exports.classifyPendingReply = exports.decideAction = exports.resolveUiMessages = exports.DEFAULT_AGENT_CHAINING = exports.DEFAULT_AGENT_TIMINGS = exports.createSpeechSession = exports.normalizeDynamicsId = exports.dynamicsFormSnapshot = exports.connectDynamicsFormContext = exports.createScreenContextStore = exports.createBridge = exports.isAgentApiError = exports.AgentApiError = exports.createFiodosTelemetry = exports.buildManifestPayload = exports.createFiodosBackendClient = exports.createWebCredentialAutofillAdapter = exports.createWebVoiceAdapter = exports.BACK_ROUTE = exports.createWebNavigationAdapter = exports.createWebStorageAdapter = exports.watchPublishedConfig = exports.DEFAULT_ORB_APPEARANCE = exports.buildKeyboardChip = exports.createOrbVisual = exports.mountOrb = exports.sendOrbSeen = exports.fetchClientManifest = exports.DEFAULT_WEB_API_URL = exports.createFiodosAgent = exports.AgentController = exports.SDK_PACKAGE = exports.SDK_VERSION = void 0;
 // ── Version (reported by the orb heartbeat) ───────────────────────────────────
 var version_1 = require("./version");
 Object.defineProperty(exports, "SDK_VERSION", { enumerable: true, get: function () { return version_1.SDK_VERSION; } });
@@ -42,6 +42,8 @@ Object.defineProperty(exports, "createWebNavigationAdapter", { enumerable: true,
 Object.defineProperty(exports, "BACK_ROUTE", { enumerable: true, get: function () { return webNavigationAdapter_1.BACK_ROUTE; } });
 var webVoiceAdapter_1 = require("./adapters/webVoiceAdapter");
 Object.defineProperty(exports, "createWebVoiceAdapter", { enumerable: true, get: function () { return webVoiceAdapter_1.createWebVoiceAdapter; } });
+var webCredentialAutofillAdapter_1 = require("./adapters/webCredentialAutofillAdapter");
+Object.defineProperty(exports, "createWebCredentialAutofillAdapter", { enumerable: true, get: function () { return webCredentialAutofillAdapter_1.createWebCredentialAutofillAdapter; } });
 // ── Backend + telemetry (same wire contract as every platform) ────────────────
 var backendClient_1 = require("./api/backendClient");
 Object.defineProperty(exports, "createFiodosBackendClient", { enumerable: true, get: function () { return backendClient_1.createFiodosBackendClient; } });
@@ -57,6 +59,11 @@ Object.defineProperty(exports, "createBridge", { enumerable: true, get: function
 // ── Screen context ────────────────────────────────────────────────────────────
 var screenContextStore_1 = require("./context/screenContextStore");
 Object.defineProperty(exports, "createScreenContextStore", { enumerable: true, get: function () { return screenContextStore_1.createScreenContextStore; } });
+// ── Closed-host context adapters (embed mode) ─────────────────────────────────
+var dynamics_1 = require("./embed/dynamics");
+Object.defineProperty(exports, "connectDynamicsFormContext", { enumerable: true, get: function () { return dynamics_1.connectDynamicsFormContext; } });
+Object.defineProperty(exports, "dynamicsFormSnapshot", { enumerable: true, get: function () { return dynamics_1.dynamicsFormSnapshot; } });
+Object.defineProperty(exports, "normalizeDynamicsId", { enumerable: true, get: function () { return dynamics_1.normalizeDynamicsId; } });
 // ── Speech session ──────────────────────────────────────────────────────────────
 var speechSession_1 = require("./speech/speechSession");
 Object.defineProperty(exports, "createSpeechSession", { enumerable: true, get: function () { return speechSession_1.createSpeechSession; } });