@myscheme/voice-navigation-sdk 0.1.0

package/dist/services/vector-search.js

@@ -0,0 +1,181 @@
+import { DEFAULT_VECTOR_SEARCH_API_PATH } from "../constants.js";
+export class VectorSearchService {
+    constructor(config) {
+        const size = typeof config.size === "number" && config.size > 0 ? config.size : 5;
+        const minScore = typeof config.minScore === "number" && Number.isFinite(config.minScore)
+            ? config.minScore
+            : 0;
+        const numCandidates = typeof config.numCandidates === "number" && config.numCandidates >= size
+            ? config.numCandidates
+            : Math.max(size * 4, 20);
+        const requestTimeoutMs = typeof config.requestTimeoutMs === "number" && config.requestTimeoutMs > 0
+            ? Math.floor(config.requestTimeoutMs)
+            : 15000;
+        this.config = {
+            ...config,
+            vectorField: config.vectorField || "embedding",
+            size,
+            minScore,
+            numCandidates,
+            requestTimeoutMs,
+            sourceFields: config.sourceFields,
+            apiPath: config.apiPath || DEFAULT_VECTOR_SEARCH_API_PATH,
+        };
+        this.endpoint = this.resolveEndpoint(this.config.apiPath);
+    }
+    async search(vector, queryText) {
+        if (!Array.isArray(vector) || vector.length === 0) {
+            return [];
+        }
+        if (typeof fetch !== "function") {
+            throw new Error("Vector search requires Fetch API support in this environment");
+        }
+        const payload = this.buildRequestPayload(vector, queryText);
+        const timeoutMs = this.config.requestTimeoutMs;
+        const abortController = typeof AbortController !== "undefined" ? new AbortController() : null;
+        const timeoutId = abortController
+            ? setTimeout(() => abortController.abort(), timeoutMs)
+            : null;
+        let response;
+        try {
+            response = await fetch(this.endpoint, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(payload),
+                credentials: "include",
+                signal: abortController?.signal,
+            });
+        }
+        catch (error) {
+            if (abortController?.signal.aborted ||
+                (error.name === "AbortError" && timeoutMs > 0)) {
+                throw new Error(`Vector search request timed out after ${timeoutMs}ms while calling ${this.endpoint}.`);
+            }
+            throw error;
+        }
+        finally {
+            if (timeoutId !== null) {
+                clearTimeout(timeoutId);
+            }
+        }
+        if (!response.ok) {
+            const errorText = await this.safeReadText(response);
+            if (response.status === 404) {
+                throw new Error("OpenSearch proxy endpoint not found. Please mount createOpenSearchProxyHandler at the configured apiPath.");
+            }
+            throw new Error(`OpenSearch proxy request failed with status ${response.status}: ${errorText || "no response body"}`);
+        }
+        const data = (await response.json());
+        const hits = Array.isArray(data.hits) ? data.hits : [];
+        return hits.map((hit) => {
+            const id = typeof hit.id === "string"
+                ? hit.id
+                : typeof hit._id === "string"
+                    ? hit._id
+                    : "";
+            const score = typeof hit.score === "number"
+                ? hit.score
+                : typeof hit._score === "number"
+                    ? hit._score
+                    : 0;
+            const source = hit.source ??
+                hit._source ??
+                {};
+            return {
+                id,
+                score,
+                source,
+            };
+        });
+    }
+    getSourceUrl(hit) {
+        const source = hit.source;
+        if (!source || typeof source !== "object") {
+            return null;
+        }
+        const metadata = source.metadata;
+        if (metadata) {
+            const candidates = [
+                metadata.source_url,
+                metadata.sourceUrl,
+                metadata.url,
+            ];
+            for (const candidate of candidates) {
+                if (typeof candidate === "string" && candidate.trim().length > 0) {
+                    return candidate.trim();
+                }
+            }
+        }
+        const candidates = [
+            source.source_url,
+            source.sourceUrl,
+            source.url,
+        ];
+        for (const candidate of candidates) {
+            if (typeof candidate === "string" && candidate.trim().length > 0) {
+                return candidate.trim();
+            }
+        }
+        return null;
+    }
+    findBestMatchWithUrl(hits) {
+        for (const hit of hits) {
+            if (typeof hit.score === "number" && hit.score < this.config.minScore) {
+                continue;
+            }
+            const url = this.getSourceUrl(hit);
+            if (url) {
+                return { hit, url };
+            }
+        }
+        return null;
+    }
+    buildRequestPayload(vector, queryText) {
+        return {
+            vector,
+            queryText,
+            params: {
+                index: this.config.index,
+                vectorField: this.config.vectorField,
+                size: this.config.size,
+                numCandidates: this.config.numCandidates,
+                minScore: this.config.minScore,
+                sourceFields: this.config.sourceFields,
+                queryText,
+            },
+            credentials: {
+                node: this.config.node,
+                username: this.config.username,
+                password: this.config.password,
+                ssl: this.config.ssl,
+            },
+        };
+    }
+    resolveEndpoint(path) {
+        if (!path) {
+            return DEFAULT_VECTOR_SEARCH_API_PATH;
+        }
+        if (typeof window === "undefined") {
+            return path;
+        }
+        try {
+            const url = new URL(path, window.location.origin);
+            return url.toString();
+        }
+        catch (error) {
+            console.warn("Failed to resolve OpenSearch proxy path, using as-is", error);
+            return path;
+        }
+    }
+    async safeReadText(response) {
+        try {
+            return await response.text();
+        }
+        catch (error) {
+            console.warn("Failed to read error response body:", error);
+            return "";
+        }
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,107 @@
+export type NavigationAction = "zoom_in" | "zoom_out" | "scroll_up" | "scroll_down" | "scroll_left" | "scroll_right" | "page_up" | "page_down" | "scroll_top" | "scroll_bottom" | "go_back" | "go_forward" | "reload_page" | "print_page" | "copy_url" | "open_menu" | "close_menu" | "focus_search" | "toggle_fullscreen" | "exit_fullscreen" | "play_media" | "pause_media" | "mute_media" | "unmute_media" | "navigate_home" | "search_content" | "navigate_search" | "navigate_faqs" | "navigate_help" | "navigate_contact" | "navigate_about" | "navigate_screen_reader" | "navigate_accessibility" | "navigate_disclaimer" | "navigate_terms_conditions" | "stop" | "unknown";
+export interface NavigationConfig {
+    aws?: {
+        region?: string;
+        accessKeyId?: string;
+        secretAccessKey?: string;
+        modelId?: string;
+        embeddingModelId?: string | null;
+    };
+    azure?: {
+        subscriptionKey?: string;
+        region?: string;
+    };
+    language?: string;
+    autoStart?: boolean;
+    actionHandlers?: Partial<Record<NavigationAction, (context?: ActionContext) => void>>;
+    opensearch?: OpenSearchConfig;
+    openSearch?: OpenSearchConfig;
+}
+export interface OpenSearchConfig {
+    node: string;
+    username: string;
+    password: string;
+    index: string;
+    vectorField?: string;
+    size?: number;
+    minScore?: number;
+    numCandidates?: number;
+    requestTimeoutMs?: number;
+    sourceFields?: string[];
+    ssl?: {
+        rejectUnauthorized?: boolean;
+    };
+    apiPath?: string;
+}
+export interface ActionContext {
+    controller?: any;
+    handler?: any;
+    onStop?: () => void;
+    transcript?: string;
+    timestamp?: number;
+    actionResult?: ActionResult;
+    [key: string]: any;
+}
+export interface ActionResult {
+    performed: boolean;
+    info: {
+        newZoom?: number;
+        scrolled?: boolean;
+        direction?: string;
+        navigated?: boolean;
+        reloaded?: boolean;
+        printed?: boolean;
+        copied?: boolean;
+        fullscreen?: boolean;
+        mediaState?: "playing" | "paused";
+        muted?: boolean;
+        [key: string]: any;
+        url?: string;
+        query?: string;
+        score?: number;
+        external?: boolean;
+        message?: string;
+        reason?: string;
+    };
+}
+export interface AgentActionResponse {
+    action: NavigationAction;
+    query?: string;
+}
+export interface BedrockResponse {
+    content?: Array<{
+        text?: string;
+    }>;
+    stop_reason?: string;
+}
+export interface AzureTokenResponse {
+    token: string;
+    region: string;
+}
+export interface NavigationCallbacks {
+    onPartial?: (text: string) => void;
+    onSegment?: (text: string, info?: any) => void;
+    onSilence?: () => void;
+    onAction?: (action: NavigationAction, performed: boolean, info?: any) => void;
+    onError?: (error: Error) => void;
+    onStateChange?: (state: NavigationState) => void;
+}
+export type NavigationState = "idle" | "loading" | "listening" | "thinking" | "error";
+export interface UIElements {
+    root: HTMLElement;
+    button: HTMLButtonElement;
+    label: HTMLElement;
+    status: HTMLElement;
+    transcript: HTMLElement;
+    action: HTMLElement;
+}
+export interface NavigationEvent extends CustomEvent {
+    detail: {
+        state?: NavigationState;
+        action?: NavigationAction;
+        transcript?: string;
+        error?: Error;
+        [key: string]: any;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/ui.d.ts

@@ -0,0 +1,10 @@
+import type { UIElements, NavigationState } from "./types.js";
+export declare const injectFloatingControlStyles: () => void;
+export declare const createFloatingControl: () => UIElements;
+export declare const updateStatus: (ui: UIElements, text: string) => void;
+export declare const setState: (ui: UIElements, state: NavigationState) => void;
+export declare const updateTranscript: (ui: UIElements, text: string) => void;
+export declare const updateActionIndicator: (ui: UIElements, actionName: string, performed: boolean, info?: any) => void;
+export declare const showError: (ui: UIElements, error: Error) => void;
+export declare const emitEvent: (type: string, detail?: any) => void;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAK9D,eAAO,MAAM,2BAA2B,QAAO,IAmH9C,CAAC;AAKF,eAAO,MAAM,qBAAqB,QAAO,UAqDxC,CAAC;AAKF,eAAO,MAAM,YAAY,GAAI,IAAI,UAAU,EAAE,MAAM,MAAM,KAAG,IAE3D,CAAC;AAKF,eAAO,MAAM,QAAQ,GAAI,IAAI,UAAU,EAAE,OAAO,eAAe,KAAG,IA+BjE,CAAC;AAKF,eAAO,MAAM,gBAAgB,GAAI,IAAI,UAAU,EAAE,MAAM,MAAM,KAAG,IAE/D,CAAC;AAKF,eAAO,MAAM,qBAAqB,GAChC,IAAI,UAAU,EACd,YAAY,MAAM,EAClB,WAAW,OAAO,EAClB,OAAM,GAAQ,KACb,IAkBF,CAAC;AAKF,eAAO,MAAM,SAAS,GAAI,IAAI,UAAU,EAAE,OAAO,KAAK,KAAG,IAGxD,CAAC;AAKF,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,SAAQ,GAAQ,KAAG,IAU1D,CAAC"}

package/dist/ui.js

@@ -0,0 +1,225 @@
+export const injectFloatingControlStyles = () => {
+    if (document.getElementById("navigate-control-styles")) {
+        return;
+    }
+    const style = document.createElement("style");
+    style.id = "navigate-control-styles";
+    style.textContent = `
+    .navigate-control {
+      position: fixed;
+      bottom: 24px;
+      right: 24px;
+      display: flex;
+      gap: 12px;
+      align-items: flex-end;
+      z-index: 2147483647;
+      font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+      color: #0f172a;
+      pointer-events: auto;
+    }
+
+    .navigate-control__button {
+      width: 60px;
+      height: 60px;
+      border-radius: 50%;
+      border: none;
+      background: #1d4ed8;
+      color: #fff;
+      font-weight: 600;
+      cursor: pointer;
+      box-shadow: 0 14px 24px rgba(15, 23, 42, 0.25);
+      transition: transform 0.2s ease, background 0.2s ease, box-shadow 0.2s ease;
+    }
+
+    .navigate-control__button:hover {
+      transform: translateY(-2px);
+    }
+
+    .navigate-control__button:focus {
+      outline: 2px solid #38bdf8;
+      outline-offset: 3px;
+    }
+
+    .navigate-control__panel {
+      min-width: 220px;
+      max-width: 320px;
+      padding: 12px 16px;
+      border-radius: 14px;
+      background: rgba(15, 23, 42, 0.92);
+      color: #f8fafc;
+      box-shadow: 0 18px 30px rgba(15, 23, 42, 0.35);
+      display: flex;
+      flex-direction: column;
+      gap: 6px;
+      backdrop-filter: blur(6px);
+    }
+
+    .navigate-control__status {
+      font-size: 0.85rem;
+      letter-spacing: 0.02em;
+      text-transform: uppercase;
+      color: #bae6fd;
+    }
+
+    .navigate-control__transcript {
+      font-size: 0.95rem;
+      line-height: 1.4;
+      color: #e2e8f0;
+      max-height: 120px;
+      overflow-y: auto;
+    }
+
+    .navigate-control__transcript:empty,
+    .navigate-control__action:empty {
+      display: none;
+    }
+
+    .navigate-control__action {
+      font-size: 0.85rem;
+      color: #a5f3fc;
+    }
+
+    .navigate-control[data-state="loading"] .navigate-control__button,
+    .navigate-control[data-state="thinking"] .navigate-control__button {
+      cursor: progress;
+      box-shadow: 0 12px 20px rgba(15, 23, 42, 0.2);
+    }
+
+    .navigate-control[data-state="loading"] .navigate-control__button {
+      background: #64748b;
+      width: 200px;
+      border-radius: 14px;
+    }
+
+    .navigate-control[data-state="listening"] .navigate-control__button {
+      background: #dc2626;
+    }
+
+    .navigate-control[data-state="thinking"] .navigate-control__button {
+      background: #7c3aed;
+    }
+
+    @media (max-width: 640px) {
+      .navigate-control {
+        right: 16px;
+        bottom: 16px;
+      }
+
+      .navigate-control__panel {
+        min-width: 180px;
+      }
+    }
+  `;
+    document.head.appendChild(style);
+};
+export const createFloatingControl = () => {
+    injectFloatingControlStyles();
+    let root = document.getElementById("navigate-control");
+    if (!root) {
+        root = document.createElement("div");
+        root.id = "navigate-control";
+        root.className = "navigate-control";
+    }
+    root.dataset.state = root.dataset.state || "idle";
+    root.innerHTML = `
+    <button type="button" class="navigate-control__button" aria-pressed="false" aria-label="Start voice control">
+      <span class="navigate-control__label">Start</span>
+    </button>
+    <div class="navigate-control__panel">
+      <div class="navigate-control__status">Tap to start voice control</div>
+      <div class="navigate-control__transcript" role="status" aria-live="polite"></div>
+      <div class="navigate-control__action" aria-live="polite"></div>
+    </div>
+  `;
+    const appendToBody = () => {
+        if (!document.body) {
+            return;
+        }
+        if (!document.body.contains(root)) {
+            document.body.appendChild(root);
+        }
+    };
+    appendToBody();
+    if (document.readyState === "loading") {
+        document.addEventListener("DOMContentLoaded", appendToBody, {
+            once: true,
+        });
+    }
+    return {
+        root,
+        button: root.querySelector(".navigate-control__button"),
+        label: root.querySelector(".navigate-control__label"),
+        status: root.querySelector(".navigate-control__status"),
+        transcript: root.querySelector(".navigate-control__transcript"),
+        action: root.querySelector(".navigate-control__action"),
+    };
+};
+export const updateStatus = (ui, text) => {
+    ui.status.textContent = text;
+};
+export const setState = (ui, state) => {
+    ui.root.dataset.state = state;
+    switch (state) {
+        case "idle":
+            ui.label.textContent = "Start";
+            ui.button.setAttribute("aria-pressed", "false");
+            ui.button.setAttribute("aria-label", "Start voice control");
+            updateStatus(ui, "Tap to start voice control");
+            break;
+        case "loading":
+            ui.label.textContent = "Loading...";
+            ui.button.setAttribute("aria-label", "Loading voice control");
+            updateStatus(ui, "Loading...");
+            break;
+        case "listening":
+            ui.label.textContent = "Stop";
+            ui.button.setAttribute("aria-pressed", "true");
+            ui.button.setAttribute("aria-label", "Stop voice control");
+            updateStatus(ui, "Listening...");
+            break;
+        case "thinking":
+            ui.label.textContent = "Stop";
+            ui.button.setAttribute("aria-label", "Processing");
+            updateStatus(ui, "Processing...");
+            break;
+        case "error":
+            ui.label.textContent = "Error";
+            ui.button.setAttribute("aria-label", "Error occurred");
+            break;
+    }
+};
+export const updateTranscript = (ui, text) => {
+    ui.transcript.textContent = text;
+};
+export const updateActionIndicator = (ui, actionName, performed, info = {}) => {
+    let message = `Action: ${actionName}`;
+    if (performed) {
+        message += " ✓";
+        if (info.newZoom) {
+            message += ` (zoom: ${info.newZoom.toFixed(1)}x)`;
+        }
+        if (info.scrolled && info.direction) {
+            message += ` (${info.direction})`;
+        }
+    }
+    else {
+        message += " ✗";
+    }
+    ui.action.textContent = message;
+    ui.action.style.color = performed ? "#a5f3fc" : "#fca5a5";
+    ui.action.setAttribute("aria-live", "polite");
+};
+export const showError = (ui, error) => {
+    ui.action.textContent = `Error: ${error.message}`;
+    ui.action.style.color = "#fca5a5";
+};
+export const emitEvent = (type, detail = {}) => {
+    if (typeof window === "undefined")
+        return;
+    const event = new CustomEvent(`navigate:${type}`, {
+        detail,
+        bubbles: true,
+        cancelable: true,
+    });
+    window.dispatchEvent(event);
+};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@myscheme/voice-navigation-sdk",
+  "version": "0.1.0",
+  "description": "Voice navigation SDK using Azure Speech and AWS Bedrock",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -w -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@opensearch-project/opensearch": "^2.12.0",
+    "@aws-sdk/client-bedrock-runtime": "^3.705.0",
+    "@azure/core-auth": "^1.10.0",
+    "microsoft-cognitiveservices-speech-sdk": "^1.47.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.10",
+    "typescript": "^5.7.2"
+  },
+  "peerDependencies": {},
+  "keywords": [
+    "voice",
+    "navigation",
+    "accessibility",
+    "azure",
+    "speech",
+    "bedrock",
+    "aws",
+    "typescript"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  }
+}